Sophie: kernel-doc-3.11.10-100.fc18 noarch

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_clear_halt</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-get-status.html" title="usb_get_status" /><link rel="next" href="API-usb-reset-endpoint.html" title="usb_reset_endpoint" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">usb_clear_halt</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-usb-get-status.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-reset-endpoint.html">Next</a></td></tr></table><hr /></div><div class="refentry"><a id="API-usb-clear-halt"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>usb_clear_halt &#8212; 
     tells device to clear endpoint halt/stall condition
 </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_clear_halt </strong>(</code></td><td>struct usb_device * <var class="pdparam">dev</var>, </td></tr><tr><td>&#160;</td><td>int <var class="pdparam">pipe</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div></div><div class="refsect1"><a id="idm140259812007728"></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>
     device whose endpoint is halted
    </p></dd><dt><span class="term"><em class="parameter"><code>pipe</code></em></span></dt><dd><p>
     endpoint <span class="quote">&#8220;<span class="quote">pipe</span>&#8221;</span> being cleared
    </p></dd></dl></div></div><div class="refsect1"><a id="idm140259812002384"></a><h2>Context</h2><p>
   !in_interrupt ()
</p></div><div class="refsect1"><a id="idm140259812001232"></a><h2>Description</h2><p>
   This is used to clear halt conditions for bulk and interrupt endpoints,
   as reported by URB completion status.  Endpoints that are halted are
   sometimes referred to as being <span class="quote">&#8220;<span class="quote">stalled</span>&#8221;</span>.  Such endpoints are unable
   to transmit or receive data until the halt status is cleared.  Any URBs
   queued for such an endpoint should normally be unlinked by the driver
   before clearing the halt condition, as described in sections 5.7.5
   and 5.8.5 of the USB 2.0 spec.
   </p><p>

   Note that control and isochronous endpoints don't halt, although control
   endpoints report <span class="quote">&#8220;<span class="quote">protocol stall</span>&#8221;</span> (for unsupported requests) using the
   same status code used to report a true stall.
   </p><p>

   This call is synchronous, and may not be used in an interrupt context.
   </p><p>

   Returns zero on success, or else the status code returned by the
   underlying <code class="function">usb_control_msg</code> call.
</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-get-status.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-reset-endpoint.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">usb_get_status</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_reset_endpoint</span></td></tr></table></div></body></html>