aboutsummaryrefslogtreecommitdiffstats
path: root/include/net/mac80211.h
diff options
context:
space:
mode:
authorJohannes Berg <johannes@sipsolutions.net>2009-08-07 10:23:43 -0400
committerJohn W. Linville <linville@tuxdriver.com>2009-08-14 09:13:43 -0400
commitc555b9b3713e05586fabe85f4e46f28859e72930 (patch)
treec94e3ab08a99e5ffba369304ca790318ab093cab /include/net/mac80211.h
parentf5ea9120be2e5d5c846243416cfdce01d02f5836 (diff)
mac80211: explain TX retry and status
Add some more documentation including an example so that it's clearer what should be done for TX retries. Signed-off-by: Johannes Berg <johannes@sipsolutions.net> Signed-off-by: John W. Linville <linville@tuxdriver.com>
Diffstat (limited to 'include/net/mac80211.h')
-rw-r--r--include/net/mac80211.h15
1 files changed, 15 insertions, 0 deletions
diff --git a/include/net/mac80211.h b/include/net/mac80211.h
index e2fb5767e1fa..467eed71be22 100644
--- a/include/net/mac80211.h
+++ b/include/net/mac80211.h
@@ -338,6 +338,21 @@ enum mac80211_rate_control_flags {
338 * 338 *
339 * When used for transmit status reporting, the driver should 339 * When used for transmit status reporting, the driver should
340 * always report the rate along with the flags it used. 340 * always report the rate along with the flags it used.
341 *
342 * &struct ieee80211_tx_info contains an array of these structs
343 * in the control information, and it will be filled by the rate
344 * control algorithm according to what should be sent. For example,
345 * if this array contains, in the format { <idx>, <count> } the
346 * information
347 * { 3, 2 }, { 2, 2 }, { 1, 4 }, { -1, 0 }, { -1, 0 }
348 * then this means that the frame should be transmitted
349 * up to twice at rate 3, up to twice at rate 2, and up to four
350 * times at rate 1 if it doesn't get acknowledged. Say it gets
351 * acknowledged by the peer after the fifth attempt, the status
352 * information should then contain
353 * { 3, 2 }, { 2, 2 }, { 1, 1 }, { -1, 0 } ...
354 * since it was transmitted twice at rate 3, twice at rate 2
355 * and once at rate 1 after which we received an acknowledgement.
341 */ 356 */
342struct ieee80211_tx_rate { 357struct ieee80211_tx_rate {
343 s8 idx; 358 s8 idx;