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>ieee80211_sta_block_awake</title><meta name="generator" content="DocBook XSL Stylesheets V1.78.1" /><link rel="home" href="index.html" title="The 802.11 subsystems &#8211; for kernel developers" /><link rel="up" href="AP.html" title="Chapter&#160;12.&#160;Access point mode support" /><link rel="prev" href="API-ieee80211-sta-set-buffered.html" title="ieee80211_sta_set_buffered" /><link rel="next" href="multi-iface.html" title="Chapter&#160;13.&#160;Supporting multiple virtual interfaces" /></head><body><div class="navheader"><table width="100%" summary="Navigation header"><tr><th colspan="3" align="center"><span class="phrase">ieee80211_sta_block_awake</span></th></tr><tr><td width="20%" align="left"><a accesskey="p" href="API-ieee80211-sta-set-buffered.html">Prev</a>&#160;</td><th width="60%" align="center">Chapter&#160;12.&#160;Access point mode support</th><td width="20%" align="right">&#160;<a accesskey="n" href="multi-iface.html">Next</a></td></tr></table><hr /></div><div class="refentry"><a id="API-ieee80211-sta-block-awake"></a><div class="titlepage"></div><div class="refnamediv"><h2>Name</h2><p>ieee80211_sta_block_awake &#8212; 
  block station from waking up
 </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">void <strong class="fsfunc">ieee80211_sta_block_awake </strong>(</code></td><td>struct ieee80211_hw * <var class="pdparam">hw</var>, </td></tr><tr><td>&#160;</td><td>struct ieee80211_sta * <var class="pdparam">pubsta</var>, </td></tr><tr><td>&#160;</td><td>bool <var class="pdparam">block</var><code>)</code>;</td></tr></table><div class="funcprototype-spacer">&#160;</div></div></div><div class="refsect1"><a id="idm139754516776592"></a><h2>Arguments</h2><div class="variablelist"><dl class="variablelist"><dt><span class="term"><em class="parameter"><code>hw</code></em></span></dt><dd><p>
     the hardware
    </p></dd><dt><span class="term"><em class="parameter"><code>pubsta</code></em></span></dt><dd><p>
     the station
    </p></dd><dt><span class="term"><em class="parameter"><code>block</code></em></span></dt><dd><p>
     whether to block or unblock
    </p></dd></dl></div></div><div class="refsect1"><a id="idm139754516769424"></a><h2>Description</h2><p>
   Some devices require that all frames that are on the queues
   for a specific station that went to sleep are flushed before
   a poll response or frames after the station woke up can be
   delivered to that it. Note that such frames must be rejected
   by the driver as filtered, with the appropriate status flag.
   </p><p>

   This function allows implementing this mode in a race-free
   manner.
   </p><p>

   To do this, a driver must keep track of the number of frames
   still enqueued for a specific station. If this number is not
   zero when the station goes to sleep, the driver must call
   this function to force mac80211 to consider the station to
   be asleep regardless of the station's actual state. Once the
   number of outstanding frames reaches zero, the driver must
   call this function again to unblock the station. That will
   cause mac80211 to be able to send ps-poll responses, and if
   the station queried in the meantime then frames will also
   be sent out as a result of this. Additionally, the driver
   will be notified that the station woke up some time after
   it is unblocked, regardless of whether the station actually
   woke up while blocked or not.
</p></div></div><div class="navfooter"><hr /><table width="100%" summary="Navigation footer"><tr><td width="40%" align="left"><a accesskey="p" href="API-ieee80211-sta-set-buffered.html">Prev</a>&#160;</td><td width="20%" align="center"><a accesskey="u" href="AP.html">Up</a></td><td width="40%" align="right">&#160;<a accesskey="n" href="multi-iface.html">Next</a></td></tr><tr><td width="40%" align="left" valign="top"><span class="phrase">ieee80211_sta_set_buffered</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;Chapter&#160;13.&#160;Supporting multiple virtual interfaces</td></tr></table></div></body></html>