1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>regulator_get_optional</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1"><link rel="home" href="index.html" title="Voltage and current regulator API"><link rel="up" href="api.html" title="Chapter&#160;5.&#160;API reference"><link rel="prev" href="API-regulator-get-exclusive.html" title="regulator_get_exclusive"><link rel="next" href="API-regulator-put.html" title="regulator_put"></head><body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF"><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">regulator_get_optional</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-regulator-get-exclusive.html">Prev</a>&#160;</td><th width="60%" align="center">Chapter&#160;5.&#160;API reference</th><td width="20%" align="right">&#160;<a accesskey="n" href="API-regulator-put.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-regulator-get-optional"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>regulator_get_optional &#8212; 
2     obtain optional access to a regulator.
3 </p></div><div class="refsynopsisdiv"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" class="funcprototype-table" summary="Function synopsis" style="cellspacing: 0; cellpadding: 0;"><tr><td><code class="funcdef">struct regulator * <b class="fsfunc">regulator_get_optional </b>(</code></td><td>struct device * <var class="pdparam">dev</var>, </td></tr><tr><td>&#160;</td><td>const char * <var class="pdparam">id</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div></div><div class="refsect1"><a name="idp1124929820"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p>
4     device for regulator <span class="quote">&#8220;<span class="quote">consumer</span>&#8221;</span>
5    </p></dd><dt><span class="term"><em class="parameter"><code>id</code></em></span></dt><dd><p>
6     Supply name or regulator ID.
7    </p></dd></dl></div></div><div class="refsect1"><a name="idp1124932540"></a><h2>Description</h2><p>
8   Returns a struct regulator corresponding to the regulator producer,
9   or <code class="function">IS_ERR</code> condition containing errno.
10   </p><p>
11
12   This is intended for use by consumers for devices which can have
13   some supplies unconnected in normal use, such as some MMC devices.
14   It can allow the regulator core to provide stub supplies for other
15   supplies requested using normal <code class="function">regulator_get</code> calls without
16   disrupting the operation of drivers that can handle absent
17   supplies.
18   </p><p>
19
20   Use of supply names configured via <code class="function">regulator_set_device_supply</code> is
21   strongly encouraged.  It is recommended that the supply name used
22   should match the name used for the supply and/or the relevant
23   device pins in the datasheet.
24</p></div></div><div class="navfooter"><hr><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-regulator-get-exclusive.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="api.html">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="API-regulator-put.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">regulator_get_exclusive</span>&#160;</td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top">&#160;<span class="phrase">regulator_put</span></td></tr></table></div></body></html>
25