1IEEE80211_STA_BLOCK_(9)    Advanced driver interface   IEEE80211_STA_BLOCK_(9)
2
3
4

NAME

6       ieee80211_sta_block_awake - block station from waking up
7

SYNOPSIS

9       void ieee80211_sta_block_awake(struct ieee80211_hw * hw,
10                                      struct ieee80211_sta * pubsta,
11                                      bool block);
12

ARGUMENTS

14       hw
15           the hardware
16
17       pubsta
18           the station
19
20       block
21           whether to block or unblock
22

DESCRIPTION

24       Some devices require that all frames that are on the queues for a
25       specific station that went to sleep are flushed before a poll response
26       or frames after the station woke up can be delivered to that it. Note
27       that such frames must be rejected by the driver as filtered, with the
28       appropriate status flag.
29
30       This function allows implementing this mode in a race-free manner.
31
32       To do this, a driver must keep track of the number of frames still
33       enqueued for a specific station. If this number is not zero when the
34       station goes to sleep, the driver must call this function to force
35       mac80211 to consider the station to be asleep regardless of the
36       station's actual state. Once the number of outstanding frames reaches
37       zero, the driver must call this function again to unblock the station.
38       That will cause mac80211 to be able to send ps-poll responses, and if
39       the station queried in the meantime then frames will also be sent out
40       as a result of this. Additionally, the driver will be notified that the
41       station woke up some time after it is unblocked, regardless of whether
42       the station actually woke up while blocked or not.
43

AUTHOR

45       Johannes Berg <johannes@sipsolutions.net>
46           Author.
47

49Kernel Hackers Manual 3.10         June 2019           IEEE80211_STA_BLOCK_(9)
Impressum