net/mac80211/agg-tx.c

   1 /*
   2  * HT handling
   3  *
   4  * Copyright 2003, Jouni Malinen <jkmaline@cc.hut.fi>
   5  * Copyright 2002-2005, Instant802 Networks, Inc.
   6  * Copyright 2005-2006, Devicescape Software, Inc.
   7  * Copyright 2006-2007  Jiri Benc <jbenc@suse.cz>
   8  * Copyright 2007, Michael Wu <flamingice@sourmilk.net>
   9  * Copyright 2007-2010, Intel Corporation
  10  *
  11  * This program is free software; you can redistribute it and/or modify
  12  * it under the terms of the GNU General Public License version 2 as
  13  * published by the Free Software Foundation.
  14  */
  15
  16 #include <linux/ieee80211.h>
  17 #include <linux/slab.h>
  18 #include <linux/export.h>
  19 #include <net/mac80211.h>
  20 #include "ieee80211_i.h"
  21 #include "driver-ops.h"
  22 #include "wme.h"
  23
  24 /**
  25  * DOC: TX A-MPDU aggregation
  26  *
  27  * Aggregation on the TX side requires setting the hardware flag
  28  * %IEEE80211_HW_AMPDU_AGGREGATION. The driver will then be handed
  29  * packets with a flag indicating A-MPDU aggregation. The driver
  30  * or device is responsible for actually aggregating the frames,
  31  * as well as deciding how many and which to aggregate.
  32  *
  33  * When TX aggregation is started by some subsystem (usually the rate
  34  * control algorithm would be appropriate) by calling the
  35  * ieee80211_start_tx_ba_session() function, the driver will be
  36  * notified via its @ampdu_action function, with the
  37  * %IEEE80211_AMPDU_TX_START action.
  38  *
  39  * In response to that, the driver is later required to call the
  40  * ieee80211_start_tx_ba_cb_irqsafe() function, which will really
  41  * start the aggregation session after the peer has also responded.
  42  * If the peer responds negatively, the session will be stopped
  43  * again right away. Note that it is possible for the aggregation
  44  * session to be stopped before the driver has indicated that it
  45  * is done setting it up, in which case it must not indicate the
  46  * setup completion.
  47  *
  48  * Also note that, since we also need to wait for a response from
  49  * the peer, the driver is notified of the completion of the
  50  * handshake by the %IEEE80211_AMPDU_TX_OPERATIONAL action to the
  51  * @ampdu_action callback.
  52  *
  53  * Similarly, when the aggregation session is stopped by the peer
  54  * or something calling ieee80211_stop_tx_ba_session(), the driver's
  55  * @ampdu_action function will be called with the action
  56  * %IEEE80211_AMPDU_TX_STOP. In this case, the call must not fail,
  57  * and the driver must later call ieee80211_stop_tx_ba_cb_irqsafe().
  58  * Note that the sta can get destroyed before the BA tear down is
  59  * complete.
  60  */
  61
  62 static void ieee80211_send_addba_request(struct ieee80211_sub_if_data *sdata,
  63                                          const u8 *da, u16 tid,
  64                                          u8 dialog_token, u16 start_seq_num,
  65                                          u16 agg_size, u16 timeout)
  66 {
  67         struct ieee80211_local *local = sdata->local;
  68         struct sk_buff *skb;
  69         struct ieee80211_mgmt *mgmt;
  70         u16 capab;
  71
  72         skb = dev_alloc_skb(sizeof(*mgmt) + local->hw.extra_tx_headroom);
  73
  74         if (!skb)
  75                 return;
  76
  77         skb_reserve(skb, local->hw.extra_tx_headroom);
  78         mgmt = (struct ieee80211_mgmt *) skb_put(skb, 24);
  79         memset(mgmt, 0, 24);
  80         memcpy(mgmt->da, da, ETH_ALEN);
  81         memcpy(mgmt->sa, sdata->vif.addr, ETH_ALEN);
  82         if (sdata->vif.type == NL80211_IFTYPE_AP ||
  83             sdata->vif.type == NL80211_IFTYPE_AP_VLAN ||
  84             sdata->vif.type == NL80211_IFTYPE_MESH_POINT)
  85                 memcpy(mgmt->bssid, sdata->vif.addr, ETH_ALEN);
  86         else if (sdata->vif.type == NL80211_IFTYPE_STATION)
  87                 memcpy(mgmt->bssid, sdata->u.mgd.bssid, ETH_ALEN);
  88         else if (sdata->vif.type == NL80211_IFTYPE_ADHOC)
  89                 memcpy(mgmt->bssid, sdata->u.ibss.bssid, ETH_ALEN);
  90
  91         mgmt->frame_control = cpu_to_le16(IEEE80211_FTYPE_MGMT |
  92                                           IEEE80211_STYPE_ACTION);
  93
  94         skb_put(skb, 1 + sizeof(mgmt->u.action.u.addba_req));
  95
  96         mgmt->u.action.category = WLAN_CATEGORY_BACK;
  97         mgmt->u.action.u.addba_req.action_code = WLAN_ACTION_ADDBA_REQ;
  98
  99         mgmt->u.action.u.addba_req.dialog_token = dialog_token;
 100         capab = (u16)(1 << 1);          /* bit 1 aggregation policy */
 101         capab |= (u16)(tid << 2);       /* bit 5:2 TID number */
 102         capab |= (u16)(agg_size << 6);  /* bit 15:6 max size of aggergation */
 103
 104         mgmt->u.action.u.addba_req.capab = cpu_to_le16(capab);
 105
 106         mgmt->u.action.u.addba_req.timeout = cpu_to_le16(timeout);
 107         mgmt->u.action.u.addba_req.start_seq_num =
 108                                         cpu_to_le16(start_seq_num << 4);
 109
 110         ieee80211_tx_skb_tid(sdata, skb, tid);
 111 }
 112
 113 void ieee80211_send_bar(struct ieee80211_vif *vif, u8 *ra, u16 tid, u16 ssn)
 114 {
 115         struct ieee80211_sub_if_data *sdata = vif_to_sdata(vif);
 116         struct ieee80211_local *local = sdata->local;
 117         struct sk_buff *skb;
 118         struct ieee80211_bar *bar;
 119         u16 bar_control = 0;
 120
 121         skb = dev_alloc_skb(sizeof(*bar) + local->hw.extra_tx_headroom);
 122         if (!skb)
 123                 return;
 124
 125         skb_reserve(skb, local->hw.extra_tx_headroom);
 126         bar = (struct ieee80211_bar *)skb_put(skb, sizeof(*bar));
 127         memset(bar, 0, sizeof(*bar));
 128         bar->frame_control = cpu_to_le16(IEEE80211_FTYPE_CTL |
 129                                          IEEE80211_STYPE_BACK_REQ);
 130         memcpy(bar->ra, ra, ETH_ALEN);
 131         memcpy(bar->ta, sdata->vif.addr, ETH_ALEN);
 132         bar_control |= (u16)IEEE80211_BAR_CTRL_ACK_POLICY_NORMAL;
 133         bar_control |= (u16)IEEE80211_BAR_CTRL_CBMTID_COMPRESSED_BA;
 134         bar_control |= (u16)(tid << IEEE80211_BAR_CTRL_TID_INFO_SHIFT);
 135         bar->control = cpu_to_le16(bar_control);
 136         bar->start_seq_num = cpu_to_le16(ssn);
 137
 138         IEEE80211_SKB_CB(skb)->flags |= IEEE80211_TX_INTFL_DONT_ENCRYPT;
 139         ieee80211_tx_skb_tid(sdata, skb, tid);
 140 }
 141 EXPORT_SYMBOL(ieee80211_send_bar);
 142
 143 void ieee80211_assign_tid_tx(struct sta_info *sta, int tid,
 144                              struct tid_ampdu_tx *tid_tx)
 145 {
 146         lockdep_assert_held(&sta->ampdu_mlme.mtx);
 147         lockdep_assert_held(&sta->lock);
 148         rcu_assign_pointer(sta->ampdu_mlme.tid_tx[tid], tid_tx);
 149 }
 150
 151 int ___ieee80211_stop_tx_ba_session(struct sta_info *sta, u16 tid,
 152                                     enum ieee80211_back_parties initiator,
 153                                     bool tx)
 154 {
 155         struct ieee80211_local *local = sta->local;
 156         struct tid_ampdu_tx *tid_tx;
 157         int ret;
 158
 159         lockdep_assert_held(&sta->ampdu_mlme.mtx);
 160
 161         spin_lock_bh(&sta->lock);
 162
 163         tid_tx = rcu_dereference_protected_tid_tx(sta, tid);
 164         if (!tid_tx) {
 165                 spin_unlock_bh(&sta->lock);
 166                 return -ENOENT;
 167         }
 168
 169         /* if we're already stopping ignore any new requests to stop */
 170         if (test_bit(HT_AGG_STATE_STOPPING, &tid_tx->state)) {
 171                 spin_unlock_bh(&sta->lock);
 172                 return -EALREADY;
 173         }
 174
 175         if (test_bit(HT_AGG_STATE_WANT_START, &tid_tx->state)) {
 176                 /* not even started yet! */
 177                 ieee80211_assign_tid_tx(sta, tid, NULL);
 178                 spin_unlock_bh(&sta->lock);
 179                 kfree_rcu(tid_tx, rcu_head);
 180                 return 0;
 181         }
 182
 183         set_bit(HT_AGG_STATE_STOPPING, &tid_tx->state);
 184
 185         spin_unlock_bh(&sta->lock);
 186
 187 #ifdef CONFIG_MAC80211_HT_DEBUG
 188         printk(KERN_DEBUG "Tx BA session stop requested for %pM tid %u\n",
 189                sta->sta.addr, tid);
 190 #endif /* CONFIG_MAC80211_HT_DEBUG */
 191
 192         del_timer_sync(&tid_tx->addba_resp_timer);
 193         del_timer_sync(&tid_tx->session_timer);
 194
 195         /*
 196          * After this packets are no longer handed right through
 197          * to the driver but are put onto tid_tx->pending instead,
 198          * with locking to ensure proper access.
 199          */
 200         clear_bit(HT_AGG_STATE_OPERATIONAL, &tid_tx->state);
 201
 202         /*
 203          * There might be a few packets being processed right now (on
 204          * another CPU) that have already gotten past the aggregation
 205          * check when it was still OPERATIONAL and consequently have
 206          * IEEE80211_TX_CTL_AMPDU set. In that case, this code might
 207          * call into the driver at the same time or even before the
 208          * TX paths calls into it, which could confuse the driver.
 209          *
 210          * Wait for all currently running TX paths to finish before
 211          * telling the driver. New packets will not go through since
 212          * the aggregation session is no longer OPERATIONAL.
 213          */
 214         synchronize_net();
 215
 216         tid_tx->stop_initiator = initiator;
 217         tid_tx->tx_stop = tx;
 218
 219         ret = drv_ampdu_action(local, sta->sdata,
 220                                IEEE80211_AMPDU_TX_STOP,
 221                                &sta->sta, tid, NULL, 0);
 222
 223         /* HW shall not deny going back to legacy */
 224         if (WARN_ON(ret)) {
 225                 /*
 226                  * We may have pending packets get stuck in this case...
 227                  * Not bothering with a workaround for now.
 228                  */
 229         }
 230
 231         return ret;
 232 }
 233
 234 /*
 235  * After sending add Block Ack request we activated a timer until
 236  * add Block Ack response will arrive from the recipient.
 237  * If this timer expires sta_addba_resp_timer_expired will be executed.
 238  */
 239 static void sta_addba_resp_timer_expired(unsigned long data)
 240 {
 241         /* not an elegant detour, but there is no choice as the timer passes
 242          * only one argument, and both sta_info and TID are needed, so init
 243          * flow in sta_info_create gives the TID as data, while the timer_to_id
 244          * array gives the sta through container_of */
 245         u16 tid = *(u8 *)data;
 246         struct sta_info *sta = container_of((void *)data,
 247                 struct sta_info, timer_to_tid[tid]);
 248         struct tid_ampdu_tx *tid_tx;
 249
 250         /* check if the TID waits for addBA response */
 251         rcu_read_lock();
 252         tid_tx = rcu_dereference(sta->ampdu_mlme.tid_tx[tid]);
 253         if (!tid_tx ||
 254             test_bit(HT_AGG_STATE_RESPONSE_RECEIVED, &tid_tx->state)) {
 255                 rcu_read_unlock();
 256 #ifdef CONFIG_MAC80211_HT_DEBUG
 257                 printk(KERN_DEBUG "timer expired on tid %d but we are not "
 258                                 "(or no longer) expecting addBA response there\n",
 259                         tid);
 260 #endif
 261                 return;
 262         }
 263
 264 #ifdef CONFIG_MAC80211_HT_DEBUG
 265         printk(KERN_DEBUG "addBA response timer expired on tid %d\n", tid);
 266 #endif
 267
 268         ieee80211_stop_tx_ba_session(&sta->sta, tid);
 269         rcu_read_unlock();
 270 }
 271
 272 static inline int ieee80211_ac_from_tid(int tid)
 273 {
 274         return ieee802_1d_to_ac[tid & 7];
 275 }
 276
 277 /*
 278  * When multiple aggregation sessions on multiple stations
 279  * are being created/destroyed simultaneously, we need to
 280  * refcount the global queue stop caused by that in order
 281  * to not get into a situation where one of the aggregation
 282  * setup or teardown re-enables queues before the other is
 283  * ready to handle that.
 284  *
 285  * These two functions take care of this issue by keeping
 286  * a global "agg_queue_stop" refcount.
 287  */
 288 static void __acquires(agg_queue)
 289 ieee80211_stop_queue_agg(struct ieee80211_sub_if_data *sdata, int tid)
 290 {
 291         int queue = sdata->vif.hw_queue[ieee80211_ac_from_tid(tid)];
 292
 293         if (atomic_inc_return(&sdata->local->agg_queue_stop[queue]) == 1)
 294                 ieee80211_stop_queue_by_reason(
 295                         &sdata->local->hw, queue,
 296                         IEEE80211_QUEUE_STOP_REASON_AGGREGATION);
 297         __acquire(agg_queue);
 298 }
 299
 300 static void __releases(agg_queue)
 301 ieee80211_wake_queue_agg(struct ieee80211_sub_if_data *sdata, int tid)
 302 {
 303         int queue = sdata->vif.hw_queue[ieee80211_ac_from_tid(tid)];
 304
 305         if (atomic_dec_return(&sdata->local->agg_queue_stop[queue]) == 0)
 306                 ieee80211_wake_queue_by_reason(
 307                         &sdata->local->hw, queue,
 308                         IEEE80211_QUEUE_STOP_REASON_AGGREGATION);
 309         __release(agg_queue);
 310 }
 311
 312 /*
 313  * splice packets from the STA's pending to the local pending,
 314  * requires a call to ieee80211_agg_splice_finish later
 315  */
 316 static void __acquires(agg_queue)
 317 ieee80211_agg_splice_packets(struct ieee80211_sub_if_data *sdata,
 318                              struct tid_ampdu_tx *tid_tx, u16 tid)
 319 {
 320         struct ieee80211_local *local = sdata->local;
 321         int queue = sdata->vif.hw_queue[ieee80211_ac_from_tid(tid)];
 322         unsigned long flags;
 323
 324         ieee80211_stop_queue_agg(sdata, tid);
 325
 326         if (WARN(!tid_tx, "TID %d gone but expected when splicing aggregates"
 327                           " from the pending queue\n", tid))
 328                 return;
 329
 330         if (!skb_queue_empty(&tid_tx->pending)) {
 331                 spin_lock_irqsave(&local->queue_stop_reason_lock, flags);
 332                 /* copy over remaining packets */
 333                 skb_queue_splice_tail_init(&tid_tx->pending,
 334                                            &local->pending[queue]);
 335                 spin_unlock_irqrestore(&local->queue_stop_reason_lock, flags);
 336         }
 337 }
 338
 339 static void __releases(agg_queue)
 340 ieee80211_agg_splice_finish(struct ieee80211_sub_if_data *sdata, u16 tid)
 341 {
 342         ieee80211_wake_queue_agg(sdata, tid);
 343 }
 344
 345 void ieee80211_tx_ba_session_handle_start(struct sta_info *sta, int tid)
 346 {
 347         struct tid_ampdu_tx *tid_tx;
 348         struct ieee80211_local *local = sta->local;
 349         struct ieee80211_sub_if_data *sdata = sta->sdata;
 350         u16 start_seq_num;
 351         int ret;
 352
 353         tid_tx = rcu_dereference_protected_tid_tx(sta, tid);
 354
 355         /*
 356          * Start queuing up packets for this aggregation session.
 357          * We're going to release them once the driver is OK with
 358          * that.
 359          */
 360         clear_bit(HT_AGG_STATE_WANT_START, &tid_tx->state);
 361
 362         /*
 363          * Make sure no packets are being processed. This ensures that
 364          * we have a valid starting sequence number and that in-flight
 365          * packets have been flushed out and no packets for this TID
 366          * will go into the driver during the ampdu_action call.
 367          */
 368         synchronize_net();
 369
 370         start_seq_num = sta->tid_seq[tid] >> 4;
 371
 372         ret = drv_ampdu_action(local, sdata, IEEE80211_AMPDU_TX_START,
 373                                &sta->sta, tid, &start_seq_num, 0);
 374         if (ret) {
 375 #ifdef CONFIG_MAC80211_HT_DEBUG
 376                 printk(KERN_DEBUG "BA request denied - HW unavailable for"
 377                                         " tid %d\n", tid);
 378 #endif
 379                 spin_lock_bh(&sta->lock);
 380                 ieee80211_agg_splice_packets(sdata, tid_tx, tid);
 381                 ieee80211_assign_tid_tx(sta, tid, NULL);
 382                 ieee80211_agg_splice_finish(sdata, tid);
 383                 spin_unlock_bh(&sta->lock);
 384
 385                 kfree_rcu(tid_tx, rcu_head);
 386                 return;
 387         }
 388
 389         /* activate the timer for the recipient's addBA response */
 390         mod_timer(&tid_tx->addba_resp_timer, jiffies + ADDBA_RESP_INTERVAL);
 391 #ifdef CONFIG_MAC80211_HT_DEBUG
 392         printk(KERN_DEBUG "activated addBA response timer on tid %d\n", tid);
 393 #endif
 394
 395         spin_lock_bh(&sta->lock);
 396         sta->ampdu_mlme.last_addba_req_time[tid] = jiffies;
 397         sta->ampdu_mlme.addba_req_num[tid]++;
 398         spin_unlock_bh(&sta->lock);
 399
 400         /* send AddBA request */
 401         ieee80211_send_addba_request(sdata, sta->sta.addr, tid,
 402                                      tid_tx->dialog_token, start_seq_num,
 403                                      local->hw.max_tx_aggregation_subframes,
 404                                      tid_tx->timeout);
 405 }
 406
 407 /*
 408  * After accepting the AddBA Response we activated a timer,
 409  * resetting it after each frame that we send.
 410  */
 411 static void sta_tx_agg_session_timer_expired(unsigned long data)
 412 {
 413         /* not an elegant detour, but there is no choice as the timer passes
 414          * only one argument, and various sta_info are needed here, so init
 415          * flow in sta_info_create gives the TID as data, while the timer_to_id
 416          * array gives the sta through container_of */
 417         u8 *ptid = (u8 *)data;
 418         u8 *timer_to_id = ptid - *ptid;
 419         struct sta_info *sta = container_of(timer_to_id, struct sta_info,
 420                                          timer_to_tid[0]);
 421         struct tid_ampdu_tx *tid_tx;
 422         unsigned long timeout;
 423
 424         tid_tx = rcu_dereference_protected_tid_tx(sta, *ptid);
 425         if (!tid_tx)
 426                 return;
 427
 428         timeout = tid_tx->last_tx + TU_TO_JIFFIES(tid_tx->timeout);
 429         if (time_is_after_jiffies(timeout)) {
 430                 mod_timer(&tid_tx->session_timer, timeout);
 431                 return;
 432         }
 433
 434 #ifdef CONFIG_MAC80211_HT_DEBUG
 435         printk(KERN_DEBUG "tx session timer expired on tid %d\n", (u16)*ptid);
 436 #endif
 437
 438         ieee80211_stop_tx_ba_session(&sta->sta, *ptid);
 439 }
 440
 441 int ieee80211_start_tx_ba_session(struct ieee80211_sta *pubsta, u16 tid,
 442                                   u16 timeout)
 443 {
 444         struct sta_info *sta = container_of(pubsta, struct sta_info, sta);
 445         struct ieee80211_sub_if_data *sdata = sta->sdata;
 446         struct ieee80211_local *local = sdata->local;
 447         struct tid_ampdu_tx *tid_tx;
 448         int ret = 0;
 449
 450         trace_api_start_tx_ba_session(pubsta, tid);
 451
 452         if (WARN_ON(!local->ops->ampdu_action))
 453                 return -EINVAL;
 454
 455         if ((tid >= STA_TID_NUM) ||
 456             !(local->hw.flags & IEEE80211_HW_AMPDU_AGGREGATION) ||
 457             (local->hw.flags & IEEE80211_HW_TX_AMPDU_SETUP_IN_HW))
 458                 return -EINVAL;
 459
 460 #ifdef CONFIG_MAC80211_HT_DEBUG
 461         printk(KERN_DEBUG "Open BA session requested for %pM tid %u\n",
 462                pubsta->addr, tid);
 463 #endif /* CONFIG_MAC80211_HT_DEBUG */
 464
 465         if (sdata->vif.type != NL80211_IFTYPE_STATION &&
 466             sdata->vif.type != NL80211_IFTYPE_MESH_POINT &&
 467             sdata->vif.type != NL80211_IFTYPE_AP_VLAN &&
 468             sdata->vif.type != NL80211_IFTYPE_AP &&
 469             sdata->vif.type != NL80211_IFTYPE_ADHOC)
 470                 return -EINVAL;
 471
 472         if (test_sta_flag(sta, WLAN_STA_BLOCK_BA)) {
 473 #ifdef CONFIG_MAC80211_HT_DEBUG
 474                 printk(KERN_DEBUG "BA sessions blocked. "
 475                        "Denying BA session request\n");
 476 #endif
 477                 return -EINVAL;
 478         }
 479
 480         /*
 481          * 802.11n-2009 11.5.1.1: If the initiating STA is an HT STA, is a
 482          * member of an IBSS, and has no other existing Block Ack agreement
 483          * with the recipient STA, then the initiating STA shall transmit a
 484          * Probe Request frame to the recipient STA and shall not transmit an
 485          * ADDBA Request frame unless it receives a Probe Response frame
 486          * from the recipient within dot11ADDBAFailureTimeout.
 487          *
 488          * The probe request mechanism for ADDBA is currently not implemented,
 489          * but we only build up Block Ack session with HT STAs. This information
 490          * is set when we receive a bss info from a probe response or a beacon.
 491          */
 492         if (sta->sdata->vif.type == NL80211_IFTYPE_ADHOC &&
 493             !sta->sta.ht_cap.ht_supported) {
 494 #ifdef CONFIG_MAC80211_HT_DEBUG
 495                 printk(KERN_DEBUG "BA request denied - IBSS STA %pM"
 496                        "does not advertise HT support\n", pubsta->addr);
 497 #endif /* CONFIG_MAC80211_HT_DEBUG */
 498                 return -EINVAL;
 499         }
 500
 501         spin_lock_bh(&sta->lock);
 502
 503         /* we have tried too many times, receiver does not want A-MPDU */
 504         if (sta->ampdu_mlme.addba_req_num[tid] > HT_AGG_MAX_RETRIES) {
 505                 ret = -EBUSY;
 506                 goto err_unlock_sta;
 507         }
 508
 509         /*
 510          * if we have tried more than HT_AGG_BURST_RETRIES times we
 511          * will spread our requests in time to avoid stalling connection
 512          * for too long
 513          */
 514         if (sta->ampdu_mlme.addba_req_num[tid] > HT_AGG_BURST_RETRIES &&
 515             time_before(jiffies, sta->ampdu_mlme.last_addba_req_time[tid] +
 516                         HT_AGG_RETRIES_PERIOD)) {
 517 #ifdef CONFIG_MAC80211_HT_DEBUG
 518                 printk(KERN_DEBUG "BA request denied - "
 519                        "waiting a grace period after %d failed requests "
 520                        "on tid %u\n",
 521                        sta->ampdu_mlme.addba_req_num[tid], tid);
 522 #endif /* CONFIG_MAC80211_HT_DEBUG */
 523                 ret = -EBUSY;
 524                 goto err_unlock_sta;
 525         }
 526
 527         tid_tx = rcu_dereference_protected_tid_tx(sta, tid);
 528         /* check if the TID is not in aggregation flow already */
 529         if (tid_tx || sta->ampdu_mlme.tid_start_tx[tid]) {
 530 #ifdef CONFIG_MAC80211_HT_DEBUG
 531                 printk(KERN_DEBUG "BA request denied - session is not "
 532                                  "idle on tid %u\n", tid);
 533 #endif /* CONFIG_MAC80211_HT_DEBUG */
 534                 ret = -EAGAIN;
 535                 goto err_unlock_sta;
 536         }
 537
 538         /* prepare A-MPDU MLME for Tx aggregation */
 539         tid_tx = kzalloc(sizeof(struct tid_ampdu_tx), GFP_ATOMIC);
 540         if (!tid_tx) {
 541                 ret = -ENOMEM;
 542                 goto err_unlock_sta;
 543         }
 544
 545         skb_queue_head_init(&tid_tx->pending);
 546         __set_bit(HT_AGG_STATE_WANT_START, &tid_tx->state);
 547
 548         tid_tx->timeout = timeout;
 549
 550         /* response timer */
 551         tid_tx->addba_resp_timer.function = sta_addba_resp_timer_expired;
 552         tid_tx->addba_resp_timer.data = (unsigned long)&sta->timer_to_tid[tid];
 553         init_timer(&tid_tx->addba_resp_timer);
 554
 555         /* tx timer */
 556         tid_tx->session_timer.function = sta_tx_agg_session_timer_expired;
 557         tid_tx->session_timer.data = (unsigned long)&sta->timer_to_tid[tid];
 558         init_timer_deferrable(&tid_tx->session_timer);
 559
 560         /* assign a dialog token */
 561         sta->ampdu_mlme.dialog_token_allocator++;
 562         tid_tx->dialog_token = sta->ampdu_mlme.dialog_token_allocator;
 563
 564         /*
 565          * Finally, assign it to the start array; the work item will
 566          * collect it and move it to the normal array.
 567          */
 568         sta->ampdu_mlme.tid_start_tx[tid] = tid_tx;
 569
 570         ieee80211_queue_work(&local->hw, &sta->ampdu_mlme.work);
 571
 572         /* this flow continues off the work */
 573  err_unlock_sta:
 574         spin_unlock_bh(&sta->lock);
 575         return ret;
 576 }
 577 EXPORT_SYMBOL(ieee80211_start_tx_ba_session);
 578
 579 static void ieee80211_agg_tx_operational(struct ieee80211_local *local,
 580                                          struct sta_info *sta, u16 tid)
 581 {
 582         struct tid_ampdu_tx *tid_tx;
 583
 584         lockdep_assert_held(&sta->ampdu_mlme.mtx);
 585
 586         tid_tx = rcu_dereference_protected_tid_tx(sta, tid);
 587
 588 #ifdef CONFIG_MAC80211_HT_DEBUG
 589         printk(KERN_DEBUG "Aggregation is on for tid %d\n", tid);
 590 #endif
 591
 592         drv_ampdu_action(local, sta->sdata,
 593                          IEEE80211_AMPDU_TX_OPERATIONAL,
 594                          &sta->sta, tid, NULL, tid_tx->buf_size);
 595
 596         /*
 597          * synchronize with TX path, while splicing the TX path
 598          * should block so it won't put more packets onto pending.
 599          */
 600         spin_lock_bh(&sta->lock);
 601
 602         ieee80211_agg_splice_packets(sta->sdata, tid_tx, tid);
 603         /*
 604          * Now mark as operational. This will be visible
 605          * in the TX path, and lets it go lock-free in
 606          * the common case.
 607          */
 608         set_bit(HT_AGG_STATE_OPERATIONAL, &tid_tx->state);
 609         ieee80211_agg_splice_finish(sta->sdata, tid);
 610
 611         spin_unlock_bh(&sta->lock);
 612 }
 613
 614 void ieee80211_start_tx_ba_cb(struct ieee80211_vif *vif, u8 *ra, u16 tid)
 615 {
 616         struct ieee80211_sub_if_data *sdata = vif_to_sdata(vif);
 617         struct ieee80211_local *local = sdata->local;
 618         struct sta_info *sta;
 619         struct tid_ampdu_tx *tid_tx;
 620
 621         trace_api_start_tx_ba_cb(sdata, ra, tid);
 622
 623         if (tid >= STA_TID_NUM) {
 624 #ifdef CONFIG_MAC80211_HT_DEBUG
 625                 printk(KERN_DEBUG "Bad TID value: tid = %d (>= %d)\n",
 626                                 tid, STA_TID_NUM);
 627 #endif
 628                 return;
 629         }
 630
 631         mutex_lock(&local->sta_mtx);
 632         sta = sta_info_get_bss(sdata, ra);
 633         if (!sta) {
 634                 mutex_unlock(&local->sta_mtx);
 635 #ifdef CONFIG_MAC80211_HT_DEBUG
 636                 printk(KERN_DEBUG "Could not find station: %pM\n", ra);
 637 #endif
 638                 return;
 639         }
 640
 641         mutex_lock(&sta->ampdu_mlme.mtx);
 642         tid_tx = rcu_dereference_protected_tid_tx(sta, tid);
 643
 644         if (WARN_ON(!tid_tx)) {
 645 #ifdef CONFIG_MAC80211_HT_DEBUG
 646                 printk(KERN_DEBUG "addBA was not requested!\n");
 647 #endif
 648                 goto unlock;
 649         }
 650
 651         if (WARN_ON(test_and_set_bit(HT_AGG_STATE_DRV_READY, &tid_tx->state)))
 652                 goto unlock;
 653
 654         if (test_bit(HT_AGG_STATE_RESPONSE_RECEIVED, &tid_tx->state))
 655                 ieee80211_agg_tx_operational(local, sta, tid);
 656
 657  unlock:
 658         mutex_unlock(&sta->ampdu_mlme.mtx);
 659         mutex_unlock(&local->sta_mtx);
 660 }
 661
 662 void ieee80211_start_tx_ba_cb_irqsafe(struct ieee80211_vif *vif,
 663                                       const u8 *ra, u16 tid)
 664 {
 665         struct ieee80211_sub_if_data *sdata = vif_to_sdata(vif);
 666         struct ieee80211_local *local = sdata->local;
 667         struct ieee80211_ra_tid *ra_tid;
 668         struct sk_buff *skb = dev_alloc_skb(0);
 669
 670         if (unlikely(!skb))
 671                 return;
 672
 673         ra_tid = (struct ieee80211_ra_tid *) &skb->cb;
 674         memcpy(&ra_tid->ra, ra, ETH_ALEN);
 675         ra_tid->tid = tid;
 676
 677         skb->pkt_type = IEEE80211_SDATA_QUEUE_AGG_START;
 678         skb_queue_tail(&sdata->skb_queue, skb);
 679         ieee80211_queue_work(&local->hw, &sdata->work);
 680 }
 681 EXPORT_SYMBOL(ieee80211_start_tx_ba_cb_irqsafe);
 682
 683 int __ieee80211_stop_tx_ba_session(struct sta_info *sta, u16 tid,
 684                                    enum ieee80211_back_parties initiator,
 685                                    bool tx)
 686 {
 687         int ret;
 688
 689         mutex_lock(&sta->ampdu_mlme.mtx);
 690
 691         ret = ___ieee80211_stop_tx_ba_session(sta, tid, initiator, tx);
 692
 693         mutex_unlock(&sta->ampdu_mlme.mtx);
 694
 695         return ret;
 696 }
 697
 698 int ieee80211_stop_tx_ba_session(struct ieee80211_sta *pubsta, u16 tid)
 699 {
 700         struct sta_info *sta = container_of(pubsta, struct sta_info, sta);
 701         struct ieee80211_sub_if_data *sdata = sta->sdata;
 702         struct ieee80211_local *local = sdata->local;
 703         struct tid_ampdu_tx *tid_tx;
 704         int ret = 0;
 705
 706         trace_api_stop_tx_ba_session(pubsta, tid);
 707
 708         if (!local->ops->ampdu_action)
 709                 return -EINVAL;
 710
 711         if (tid >= STA_TID_NUM)
 712                 return -EINVAL;
 713
 714         spin_lock_bh(&sta->lock);
 715         tid_tx = rcu_dereference_protected_tid_tx(sta, tid);
 716
 717         if (!tid_tx) {
 718                 ret = -ENOENT;
 719                 goto unlock;
 720         }
 721
 722         if (test_bit(HT_AGG_STATE_STOPPING, &tid_tx->state)) {
 723                 /* already in progress stopping it */
 724                 ret = 0;
 725                 goto unlock;
 726         }
 727
 728         set_bit(HT_AGG_STATE_WANT_STOP, &tid_tx->state);
 729         ieee80211_queue_work(&local->hw, &sta->ampdu_mlme.work);
 730
 731  unlock:
 732         spin_unlock_bh(&sta->lock);
 733         return ret;
 734 }
 735 EXPORT_SYMBOL(ieee80211_stop_tx_ba_session);
 736
 737 void ieee80211_stop_tx_ba_cb(struct ieee80211_vif *vif, u8 *ra, u8 tid)
 738 {
 739         struct ieee80211_sub_if_data *sdata = vif_to_sdata(vif);
 740         struct ieee80211_local *local = sdata->local;
 741         struct sta_info *sta;
 742         struct tid_ampdu_tx *tid_tx;
 743
 744         trace_api_stop_tx_ba_cb(sdata, ra, tid);
 745
 746         if (tid >= STA_TID_NUM) {
 747 #ifdef CONFIG_MAC80211_HT_DEBUG
 748                 printk(KERN_DEBUG "Bad TID value: tid = %d (>= %d)\n",
 749                                 tid, STA_TID_NUM);
 750 #endif
 751                 return;
 752         }
 753
 754 #ifdef CONFIG_MAC80211_HT_DEBUG
 755         printk(KERN_DEBUG "Stopping Tx BA session for %pM tid %d\n",
 756                ra, tid);
 757 #endif /* CONFIG_MAC80211_HT_DEBUG */
 758
 759         mutex_lock(&local->sta_mtx);
 760
 761         sta = sta_info_get_bss(sdata, ra);
 762         if (!sta) {
 763 #ifdef CONFIG_MAC80211_HT_DEBUG
 764                 printk(KERN_DEBUG "Could not find station: %pM\n", ra);
 765 #endif
 766                 goto unlock;
 767         }
 768
 769         mutex_lock(&sta->ampdu_mlme.mtx);
 770         spin_lock_bh(&sta->lock);
 771         tid_tx = rcu_dereference_protected_tid_tx(sta, tid);
 772
 773         if (!tid_tx || !test_bit(HT_AGG_STATE_STOPPING, &tid_tx->state)) {
 774 #ifdef CONFIG_MAC80211_HT_DEBUG
 775                 printk(KERN_DEBUG "unexpected callback to A-MPDU stop\n");
 776 #endif
 777                 goto unlock_sta;
 778         }
 779
 780         if (tid_tx->stop_initiator == WLAN_BACK_INITIATOR && tid_tx->tx_stop)
 781                 ieee80211_send_delba(sta->sdata, ra, tid,
 782                         WLAN_BACK_INITIATOR, WLAN_REASON_QSTA_NOT_USE);
 783
 784         /*
 785          * When we get here, the TX path will not be lockless any more wrt.
 786          * aggregation, since the OPERATIONAL bit has long been cleared.
 787          * Thus it will block on getting the lock, if it occurs. So if we
 788          * stop the queue now, we will not get any more packets, and any
 789          * that might be being processed will wait for us here, thereby
 790          * guaranteeing that no packets go to the tid_tx pending queue any
 791          * more.
 792          */
 793
 794         ieee80211_agg_splice_packets(sta->sdata, tid_tx, tid);
 795
 796         /* future packets must not find the tid_tx struct any more */
 797         ieee80211_assign_tid_tx(sta, tid, NULL);
 798
 799         ieee80211_agg_splice_finish(sta->sdata, tid);
 800
 801         kfree_rcu(tid_tx, rcu_head);
 802
 803  unlock_sta:
 804         spin_unlock_bh(&sta->lock);
 805         mutex_unlock(&sta->ampdu_mlme.mtx);
 806  unlock:
 807         mutex_unlock(&local->sta_mtx);
 808 }
 809
 810 void ieee80211_stop_tx_ba_cb_irqsafe(struct ieee80211_vif *vif,
 811                                      const u8 *ra, u16 tid)
 812 {
 813         struct ieee80211_sub_if_data *sdata = vif_to_sdata(vif);
 814         struct ieee80211_local *local = sdata->local;
 815         struct ieee80211_ra_tid *ra_tid;
 816         struct sk_buff *skb = dev_alloc_skb(0);
 817
 818         if (unlikely(!skb))
 819                 return;
 820
 821         ra_tid = (struct ieee80211_ra_tid *) &skb->cb;
 822         memcpy(&ra_tid->ra, ra, ETH_ALEN);
 823         ra_tid->tid = tid;
 824
 825         skb->pkt_type = IEEE80211_SDATA_QUEUE_AGG_STOP;
 826         skb_queue_tail(&sdata->skb_queue, skb);
 827         ieee80211_queue_work(&local->hw, &sdata->work);
 828 }
 829 EXPORT_SYMBOL(ieee80211_stop_tx_ba_cb_irqsafe);
 830
 831
 832 void ieee80211_process_addba_resp(struct ieee80211_local *local,
 833                                   struct sta_info *sta,
 834                                   struct ieee80211_mgmt *mgmt,
 835                                   size_t len)
 836 {
 837         struct tid_ampdu_tx *tid_tx;
 838         u16 capab, tid;
 839         u8 buf_size;
 840
 841         capab = le16_to_cpu(mgmt->u.action.u.addba_resp.capab);
 842         tid = (capab & IEEE80211_ADDBA_PARAM_TID_MASK) >> 2;
 843         buf_size = (capab & IEEE80211_ADDBA_PARAM_BUF_SIZE_MASK) >> 6;
 844
 845         mutex_lock(&sta->ampdu_mlme.mtx);
 846
 847         tid_tx = rcu_dereference_protected_tid_tx(sta, tid);
 848         if (!tid_tx)
 849                 goto out;
 850
 851         if (mgmt->u.action.u.addba_resp.dialog_token != tid_tx->dialog_token) {
 852 #ifdef CONFIG_MAC80211_HT_DEBUG
 853                 printk(KERN_DEBUG "wrong addBA response token, tid %d\n", tid);
 854 #endif
 855                 goto out;
 856         }
 857
 858         del_timer_sync(&tid_tx->addba_resp_timer);
 859
 860 #ifdef CONFIG_MAC80211_HT_DEBUG
 861         printk(KERN_DEBUG "switched off addBA timer for tid %d\n", tid);
 862 #endif
 863
 864         /*
 865          * addba_resp_timer may have fired before we got here, and
 866          * caused WANT_STOP to be set. If the stop then was already
 867          * processed further, STOPPING might be set.
 868          */
 869         if (test_bit(HT_AGG_STATE_WANT_STOP, &tid_tx->state) ||
 870             test_bit(HT_AGG_STATE_STOPPING, &tid_tx->state)) {
 871 #ifdef CONFIG_MAC80211_HT_DEBUG
 872                 printk(KERN_DEBUG
 873                        "got addBA resp for tid %d but we already gave up\n",
 874                        tid);
 875 #endif
 876                 goto out;
 877         }
 878
 879         /*
 880          * IEEE 802.11-2007 7.3.1.14:
 881          * In an ADDBA Response frame, when the Status Code field
 882          * is set to 0, the Buffer Size subfield is set to a value
 883          * of at least 1.
 884          */
 885         if (le16_to_cpu(mgmt->u.action.u.addba_resp.status)
 886                         == WLAN_STATUS_SUCCESS && buf_size) {
 887                 if (test_and_set_bit(HT_AGG_STATE_RESPONSE_RECEIVED,
 888                                      &tid_tx->state)) {
 889                         /* ignore duplicate response */
 890                         goto out;
 891                 }
 892
 893                 tid_tx->buf_size = buf_size;
 894
 895                 if (test_bit(HT_AGG_STATE_DRV_READY, &tid_tx->state))
 896                         ieee80211_agg_tx_operational(local, sta, tid);
 897
 898                 sta->ampdu_mlme.addba_req_num[tid] = 0;
 899
 900                 if (tid_tx->timeout) {
 901                         mod_timer(&tid_tx->session_timer,
 902                                   TU_TO_EXP_TIME(tid_tx->timeout));
 903                         tid_tx->last_tx = jiffies;
 904                 }
 905
 906         } else {
 907                 ___ieee80211_stop_tx_ba_session(sta, tid, WLAN_BACK_INITIATOR,
 908                                                 true);
 909         }
 910
 911  out:
 912         mutex_unlock(&sta->ampdu_mlme.mtx);
 913 }