'\" t
.\"     Title: ieee80211_sta_block_awake
.\"    Author: 
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: January 2017
.\"    Manual: Advanced driver interface
.\"    Source: Kernel Hackers Manual 4.8.15
.\"  Language: English
.\"
.TH "IEEE80211_STA_BLOCK_" "9" "January 2017" "Kernel Hackers Manual 4\&.8\&." "Advanced driver interface"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ieee80211_sta_block_awake \- block station from waking up
.SH "SYNOPSIS"
.HP \w'void\ ieee80211_sta_block_awake('u
.BI "void ieee80211_sta_block_awake(struct\ ieee80211_hw\ *\ " "hw" ", struct\ ieee80211_sta\ *\ " "pubsta" ", bool\ " "block" ");"
.SH "ARGUMENTS"
.PP
\fIhw\fR
.RS 4
the hardware
.RE
.PP
\fIpubsta\fR
.RS 4
the station
.RE
.PP
\fIblock\fR
.RS 4
whether to block or unblock
.RE
.SH "DESCRIPTION"
.PP
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\&.
.PP
This function allows implementing this mode in a race\-free manner\&.
.PP
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\*(Aqs 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\&.
.SH "AUTHOR"
.PP
\fBJohannes Berg\fR <\&johannes@sipsolutions.net\&>
.RS 4
Author.
.RE
.SH "COPYRIGHT"
.br