1<html><head><meta http-equiv="Content-Type" content="text/html; charset=ANSI_X3.4-1968"><title>regulator_get_exclusive</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.html" title="regulator_get"><link rel="next" href="API-regulator-get-optional.html" title="regulator_get_optional"></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_exclusive</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-regulator-get.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-get-optional.html">Next</a></td></tr></table><hr></div><div class="refentry"><a name="API-regulator-get-exclusive"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>regulator_get_exclusive &#8212; 
2     obtain exclusive 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_exclusive </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="idp1124920124"></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="idp1124922844"></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.  Other consumers will be
10   unable to obtain this regulator while this reference is held and the
11   use count for the regulator will be initialised to reflect the current
12   state of the regulator.
13   </p><p>
14
15   This is intended for use by consumers which cannot tolerate shared
16   use of the regulator such as those which need to force the
17   regulator off for correct operation of the hardware they are
18   controlling.
19   </p><p>
20
21   Use of supply names configured via <code class="function">regulator_set_device_supply</code> is
22   strongly encouraged.  It is recommended that the supply name used
23   should match the name used for the supply and/or the relevant
24   device pins in the datasheet.
25</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.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-get-optional.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">regulator_get</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_get_optional</span></td></tr></table></div></body></html>
26