<?xml version="1.0" encoding="ANSI_X3.4-1968" standalone="no"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"><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.75.2" /><link rel="home" href="index.html" title="Voltage and current regulator API" /><link rel="up" href="ch05.html" title="Chapter 5. API reference" /><link rel="prev" href="re08.html" title="regulator_get" /><link rel="next" href="re10.html" title="regulator_put" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span>regulator_get_exclusive</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="re08.html">Prev</a> </td><th width="60%" align="center">Chapter 5. API reference</th><td width="20%" align="right"> <a accesskey="n" href="re10.html">Next</a></td></tr></table><hr /></div><div class="refentry" title="regulator_get_exclusive"><a id="API-regulator-get-exclusive"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>regulator_get_exclusive — obtain exclusive access to a regulator. </p></div><div class="refsynopsisdiv" title="Synopsis"><h2>Synopsis</h2><div class="funcsynopsis"><table border="0" summary="Function synopsis" cellspacing="0" cellpadding="0" class="funcprototype-table"><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> </td><td>const char * <var class="pdparam">id</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer"> </div></div></div><div class="refsect1" title="Arguments"><a id="id2928718"></a><h2>Arguments</h2><div class="variablelist"><dl><dt><span class="term"><em class="parameter"><code>dev</code></em></span></dt><dd><p> device for regulator <span class="quote">“<span class="quote">consumer</span>”</span> </p></dd><dt><span class="term"><em class="parameter"><code>id</code></em></span></dt><dd><p> Supply name or regulator ID. </p></dd></dl></div></div><div class="refsect1" title="Description"><a id="id2928764"></a><h2>Description</h2><p> Returns a struct regulator corresponding to the regulator producer, or <code class="function">IS_ERR</code> condition containing errno. Other consumers will be unable to obtain this reference is held and the use count for the regulator will be initialised to reflect the current state of the regulator. </p><p> This is intended for use by consumers which cannot tolerate shared use of the regulator such as those which need to force the regulator off for correct operation of the hardware they are controlling. </p><p> Use of supply names configured via <code class="function">regulator_set_device_supply</code> is strongly encouraged. It is recommended that the supply name used should match the name used for the supply and/or the relevant device pins in the datasheet. </p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="re08.html">Prev</a> </td><td width="20%" align="center"><a accesskey="u" href="ch05.html">Up</a></td><td width="40%" align="right"> <a accesskey="n" href="re10.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span>regulator_get</span> </td><td width="20%" align="center"><a accesskey="h" href="index.html">Home</a></td><td width="40%" align="right" valign="top"> <span>regulator_put</span></td></tr></table></div></body></html>