aboutsummaryrefslogtreecommitdiffstats
path: root/net/mac80211/agg-tx.c
diff options
context:
space:
mode:
authorJohannes Berg <johannes@sipsolutions.net>2009-02-10 15:25:49 -0500
committerJohn W. Linville <linville@tuxdriver.com>2009-02-13 13:45:39 -0500
commit86ab6c5a6c5204f6c25281b9039330b8f5e9b692 (patch)
treeb9b5471d84a0f9212927c34a99a9e334ffefff95 /net/mac80211/agg-tx.c
parent955d3fe3e8b38de19761e4ac7afdb9d7a33b9566 (diff)
mac80211: document TX aggregation (and small cleanup)
Add documentation and move ieee80211_start_tx_ba_cb_irqsafe to right after ieee80211_start_tx_ba_cb. Signed-off-by: Johannes Berg <johannes@sipsolutions.net> Signed-off-by: John W. Linville <linville@tuxdriver.com>
Diffstat (limited to 'net/mac80211/agg-tx.c')
-rw-r--r--net/mac80211/agg-tx.c76
1 files changed, 51 insertions, 25 deletions
diff --git a/net/mac80211/agg-tx.c b/net/mac80211/agg-tx.c
index 73abff95654..61bb7db0480 100644
--- a/net/mac80211/agg-tx.c
+++ b/net/mac80211/agg-tx.c
@@ -18,6 +18,31 @@
18#include "ieee80211_i.h" 18#include "ieee80211_i.h"
19#include "wme.h" 19#include "wme.h"
20 20
21/**
22 * DOC: TX aggregation
23 *
24 * Aggregation on the TX side requires setting the hardware flag
25 * %IEEE80211_HW_AMPDU_AGGREGATION as well as, if present, the @ampdu_queues
26 * hardware parameter to the number of hardware AMPDU queues. If there are no
27 * hardware queues then the driver will (currently) have to do all frame
28 * buffering.
29 *
30 * When TX aggregation is started by some subsystem (usually the rate control
31 * algorithm would be appropriate) by calling the
32 * ieee80211_start_tx_ba_session() function, the driver will be notified via
33 * its @ampdu_action function, with the %IEEE80211_AMPDU_TX_START action.
34 *
35 * In response to that, the driver is later required to call the
36 * ieee80211_start_tx_ba_cb() (or ieee80211_start_tx_ba_cb_irqsafe())
37 * function, which will start the aggregation session.
38 *
39 * Similarly, when the aggregation session is stopped by
40 * ieee80211_stop_tx_ba_session(), the driver's @ampdu_action function will
41 * be called with the action %IEEE80211_AMPDU_TX_STOP. In this case, the
42 * call must not fail, and the driver must later call ieee80211_stop_tx_ba_cb()
43 * (or ieee80211_stop_tx_ba_cb_irqsafe()).
44 */
45
21static void ieee80211_send_addba_request(struct ieee80211_sub_if_data *sdata, 46static void ieee80211_send_addba_request(struct ieee80211_sub_if_data *sdata,
22 const u8 *da, u16 tid, 47 const u8 *da, u16 tid,
23 u8 dialog_token, u16 start_seq_num, 48 u8 dialog_token, u16 start_seq_num,
@@ -363,6 +388,31 @@ void ieee80211_start_tx_ba_cb(struct ieee80211_hw *hw, u8 *ra, u16 tid)
363} 388}
364EXPORT_SYMBOL(ieee80211_start_tx_ba_cb); 389EXPORT_SYMBOL(ieee80211_start_tx_ba_cb);
365 390
391void ieee80211_start_tx_ba_cb_irqsafe(struct ieee80211_hw *hw,
392 const u8 *ra, u16 tid)
393{
394 struct ieee80211_local *local = hw_to_local(hw);
395 struct ieee80211_ra_tid *ra_tid;
396 struct sk_buff *skb = dev_alloc_skb(0);
397
398 if (unlikely(!skb)) {
399#ifdef CONFIG_MAC80211_HT_DEBUG
400 if (net_ratelimit())
401 printk(KERN_WARNING "%s: Not enough memory, "
402 "dropping start BA session", skb->dev->name);
403#endif
404 return;
405 }
406 ra_tid = (struct ieee80211_ra_tid *) &skb->cb;
407 memcpy(&ra_tid->ra, ra, ETH_ALEN);
408 ra_tid->tid = tid;
409
410 skb->pkt_type = IEEE80211_ADDBA_MSG;
411 skb_queue_tail(&local->skb_queue, skb);
412 tasklet_schedule(&local->tasklet);
413}
414EXPORT_SYMBOL(ieee80211_start_tx_ba_cb_irqsafe);
415
366 416
367int ieee80211_stop_tx_ba_session(struct ieee80211_hw *hw, 417int ieee80211_stop_tx_ba_session(struct ieee80211_hw *hw,
368 u8 *ra, u16 tid, 418 u8 *ra, u16 tid,
@@ -492,31 +542,6 @@ void ieee80211_stop_tx_ba_cb(struct ieee80211_hw *hw, u8 *ra, u8 tid)
492} 542}
493EXPORT_SYMBOL(ieee80211_stop_tx_ba_cb); 543EXPORT_SYMBOL(ieee80211_stop_tx_ba_cb);
494 544
495void ieee80211_start_tx_ba_cb_irqsafe(struct ieee80211_hw *hw,
496 const u8 *ra, u16 tid)
497{
498 struct ieee80211_local *local = hw_to_local(hw);
499 struct ieee80211_ra_tid *ra_tid;
500 struct sk_buff *skb = dev_alloc_skb(0);
501
502 if (unlikely(!skb)) {
503#ifdef CONFIG_MAC80211_HT_DEBUG
504 if (net_ratelimit())
505 printk(KERN_WARNING "%s: Not enough memory, "
506 "dropping start BA session", skb->dev->name);
507#endif
508 return;
509 }
510 ra_tid = (struct ieee80211_ra_tid *) &skb->cb;
511 memcpy(&ra_tid->ra, ra, ETH_ALEN);
512 ra_tid->tid = tid;
513
514 skb->pkt_type = IEEE80211_ADDBA_MSG;
515 skb_queue_tail(&local->skb_queue, skb);
516 tasklet_schedule(&local->tasklet);
517}
518EXPORT_SYMBOL(ieee80211_start_tx_ba_cb_irqsafe);
519
520void ieee80211_stop_tx_ba_cb_irqsafe(struct ieee80211_hw *hw, 545void ieee80211_stop_tx_ba_cb_irqsafe(struct ieee80211_hw *hw,
521 const u8 *ra, u16 tid) 546 const u8 *ra, u16 tid)
522{ 547{
@@ -542,6 +567,7 @@ void ieee80211_stop_tx_ba_cb_irqsafe(struct ieee80211_hw *hw,
542} 567}
543EXPORT_SYMBOL(ieee80211_stop_tx_ba_cb_irqsafe); 568EXPORT_SYMBOL(ieee80211_stop_tx_ba_cb_irqsafe);
544 569
570
545void ieee80211_process_addba_resp(struct ieee80211_local *local, 571void ieee80211_process_addba_resp(struct ieee80211_local *local,
546 struct sta_info *sta, 572 struct sta_info *sta,
547 struct ieee80211_mgmt *mgmt, 573 struct ieee80211_mgmt *mgmt,