Sophie

Sophie

distrib > Fedora > 18 > x86_64 > media > updates > by-pkgid > 1a595394b241504ff370a8d12ebfcea7 > files > 5153

kernel-doc-3.11.10-100.fc18.noarch.rpm

<?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>usb_lock_device_for_reset</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><link rel="home" href="index.html" title="The Linux-USB Host Side API" /><link rel="up" href="usbcore.html" title="Chapter&#160;5.&#160;USB Core APIs" /><link rel="prev" href="API-usb-put-intf.html" title="usb_put_intf" /><link rel="next" href="API-usb-get-current-frame-number.html" title="usb_get_current_frame_number" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">usb_lock_device_for_reset</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-usb-put-intf.html">Prev</a>&#160;</td><th width="60%" align="center">Chapter&#160;5.&#160;USB Core APIs</th><td width="20%" align="right">&#160;<a accesskey="n" href="API-usb-get-current-frame-number.html">Next</a></td></tr></table><hr /></div><div class="refentry"><a id="API-usb-lock-device-for-reset"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>usb_lock_device_for_reset &#8212; 
     cautiously acquire the lock for a usb device structure
 </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">int <strong class="fsfunc">usb_lock_device_for_reset </strong>(</code></td><td>struct usb_device * <var class="pdparam">udev</var>, </td></tr><tr><td>&#160;</td><td>const struct usb_interface * <var class="pdparam">iface</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div></div><div class="refsect1"><a id="idm140259811485856"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>udev</code></em></span></dt><dd><p>
     device that's being locked
    </p></dd><dt><span class="term"><em class="parameter"><code>iface</code></em></span></dt><dd><p>
     interface bound to the driver making the request (optional)
    </p></dd></dl></div></div><div class="refsect1"><a id="idm140259811480640"></a><h2>Description</h2><p>
   Attempts to acquire the device lock, but fails if the device is
   NOTATTACHED or SUSPENDED, or if iface is specified and the interface
   is neither BINDING nor BOUND.  Rather than sleeping to wait for the
   lock, the routine polls repeatedly.  This is to prevent deadlock with
   disconnect; in some drivers (such as usb-storage) the <code class="function">disconnect</code>
   or <code class="function">suspend</code> method will block waiting for a device reset to complete.
   </p><p>

   Returns a negative error code for failure, otherwise 0.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-usb-put-intf.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="usbcore.html">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="API-usb-get-current-frame-number.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">usb_put_intf</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">usb_get_current_frame_number</span></td></tr></table></div></body></html>