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         rcu_read_lock();
 425         tid_tx = rcu_dereference(sta->ampdu_mlme.tid_tx[*ptid]);
 426         if (!tid_tx || test_bit(HT_AGG_STATE_STOPPING, &tid_tx->state)) {
 427                 rcu_read_unlock();
 428                 return;
 429         }
 430
 431         timeout = tid_tx->last_tx + TU_TO_JIFFIES(tid_tx->timeout);
 432         if (time_is_after_jiffies(timeout)) {
 433                 mod_timer(&tid_tx->session_timer, timeout);
 434                 rcu_read_unlock();
 435                 return;
 436         }
 437
 438         rcu_read_unlock();
 439
 440 #ifdef CONFIG_MAC80211_HT_DEBUG
 441         printk(KERN_DEBUG "tx session timer expired on tid %d\n", (u16)*ptid);
 442 #endif
 443
 444         ieee80211_stop_tx_ba_session(&sta->sta, *ptid);
 445 }
 446
 447 int ieee80211_start_tx_ba_session(struct ieee80211_sta *pubsta, u16 tid,
 448                                   u16 timeout)
 449 {
 450         struct sta_info *sta = container_of(pubsta, struct sta_info, sta);
 451         struct ieee80211_sub_if_data *sdata = sta->sdata;
 452         struct ieee80211_local *local = sdata->local;
 453         struct tid_ampdu_tx *tid_tx;
 454         int ret = 0;
 455
 456         trace_api_start_tx_ba_session(pubsta, tid);
 457
 458         if (WARN_ON(!local->ops->ampdu_action))
 459                 return -EINVAL;
 460
 461         if ((tid >= STA_TID_NUM) ||
 462             !(local->hw.flags & IEEE80211_HW_AMPDU_AGGREGATION) ||
 463             (local->hw.flags & IEEE80211_HW_TX_AMPDU_SETUP_IN_HW))
 464                 return -EINVAL;
 465
 466 #ifdef CONFIG_MAC80211_HT_DEBUG
 467         printk(KERN_DEBUG "Open BA session requested for %pM tid %u\n",
 468                pubsta->addr, tid);
 469 #endif /* CONFIG_MAC80211_HT_DEBUG */
 470
 471         if (sdata->vif.type != NL80211_IFTYPE_STATION &&
 472             sdata->vif.type != NL80211_IFTYPE_MESH_POINT &&
 473             sdata->vif.type != NL80211_IFTYPE_AP_VLAN &&
 474             sdata->vif.type != NL80211_IFTYPE_AP &&
 475             sdata->vif.type != NL80211_IFTYPE_ADHOC)
 476                 return -EINVAL;
 477
 478         if (test_sta_flag(sta, WLAN_STA_BLOCK_BA)) {
 479 #ifdef CONFIG_MAC80211_HT_DEBUG
 480                 printk(KERN_DEBUG "BA sessions blocked. "
 481                        "Denying BA session request\n");
 482 #endif
 483                 return -EINVAL;
 484         }
 485
 486         /*
 487          * 802.11n-2009 11.5.1.1: If the initiating STA is an HT STA, is a
 488          * member of an IBSS, and has no other existing Block Ack agreement
 489          * with the recipient STA, then the initiating STA shall transmit a
 490          * Probe Request frame to the recipient STA and shall not transmit an
 491          * ADDBA Request frame unless it receives a Probe Response frame
 492          * from the recipient within dot11ADDBAFailureTimeout.
 493          *
 494          * The probe request mechanism for ADDBA is currently not implemented,
 495          * but we only build up Block Ack session with HT STAs. This information
 496          * is set when we receive a bss info from a probe response or a beacon.
 497          */
 498         if (sta->sdata->vif.type == NL80211_IFTYPE_ADHOC &&
 499             !sta->sta.ht_cap.ht_supported) {
 500 #ifdef CONFIG_MAC80211_HT_DEBUG
 501                 printk(KERN_DEBUG "BA request denied - IBSS STA %pM"
 502                        "does not advertise HT support\n", pubsta->addr);
 503 #endif /* CONFIG_MAC80211_HT_DEBUG */
 504                 return -EINVAL;
 505         }
 506
 507         spin_lock_bh(&sta->lock);
 508
 509         /* we have tried too many times, receiver does not want A-MPDU */
 510         if (sta->ampdu_mlme.addba_req_num[tid] > HT_AGG_MAX_RETRIES) {
 511                 ret = -EBUSY;
 512                 goto err_unlock_sta;
 513         }
 514
 515         /*
 516          * if we have tried more than HT_AGG_BURST_RETRIES times we
 517          * will spread our requests in time to avoid stalling connection
 518          * for too long
 519          */
 520         if (sta->ampdu_mlme.addba_req_num[tid] > HT_AGG_BURST_RETRIES &&
 521             time_before(jiffies, sta->ampdu_mlme.last_addba_req_time[tid] +
 522                         HT_AGG_RETRIES_PERIOD)) {
 523 #ifdef CONFIG_MAC80211_HT_DEBUG
 524                 printk(KERN_DEBUG "BA request denied - "
 525                        "waiting a grace period after %d failed requests "
 526                        "on tid %u\n",
 527                        sta->ampdu_mlme.addba_req_num[tid], tid);
 528 #endif /* CONFIG_MAC80211_HT_DEBUG */
 529                 ret = -EBUSY;
 530                 goto err_unlock_sta;
 531         }
 532
 533         tid_tx = rcu_dereference_protected_tid_tx(sta, tid);
 534         /* check if the TID is not in aggregation flow already */
 535         if (tid_tx || sta->ampdu_mlme.tid_start_tx[tid]) {
 536 #ifdef CONFIG_MAC80211_HT_DEBUG
 537                 printk(KERN_DEBUG "BA request denied - session is not "
 538                                  "idle on tid %u\n", tid);
 539 #endif /* CONFIG_MAC80211_HT_DEBUG */
 540                 ret = -EAGAIN;
 541                 goto err_unlock_sta;
 542         }
 543
 544         /* prepare A-MPDU MLME for Tx aggregation */
 545         tid_tx = kzalloc(sizeof(struct tid_ampdu_tx), GFP_ATOMIC);
 546         if (!tid_tx) {
 547                 ret = -ENOMEM;
 548                 goto err_unlock_sta;
 549         }
 550
 551         skb_queue_head_init(&tid_tx->pending);
 552         __set_bit(HT_AGG_STATE_WANT_START, &tid_tx->state);
 553
 554         tid_tx->timeout = timeout;
 555
 556         /* response timer */
 557         tid_tx->addba_resp_timer.function = sta_addba_resp_timer_expired;
 558         tid_tx->addba_resp_timer.data = (unsigned long)&sta->timer_to_tid[tid];
 559         init_timer(&tid_tx->addba_resp_timer);
 560
 561         /* tx timer */
 562         tid_tx->session_timer.function = sta_tx_agg_session_timer_expired;
 563         tid_tx->session_timer.data = (unsigned long)&sta->timer_to_tid[tid];
 564         init_timer_deferrable(&tid_tx->session_timer);
 565
 566         /* assign a dialog token */
 567         sta->ampdu_mlme.dialog_token_allocator++;
 568         tid_tx->dialog_token = sta->ampdu_mlme.dialog_token_allocator;
 569
 570         /*
 571          * Finally, assign it to the start array; the work item will
 572          * collect it and move it to the normal array.
 573          */
 574         sta->ampdu_mlme.tid_start_tx[tid] = tid_tx;
 575
 576         ieee80211_queue_work(&local->hw, &sta->ampdu_mlme.work);
 577
 578         /* this flow continues off the work */
 579  err_unlock_sta:
 580         spin_unlock_bh(&sta->lock);
 581         return ret;
 582 }
 583 EXPORT_SYMBOL(ieee80211_start_tx_ba_session);
 584
 585 static void ieee80211_agg_tx_operational(struct ieee80211_local *local,
 586                                          struct sta_info *sta, u16 tid)
 587 {
 588         struct tid_ampdu_tx *tid_tx;
 589
 590         lockdep_assert_held(&sta->ampdu_mlme.mtx);
 591
 592         tid_tx = rcu_dereference_protected_tid_tx(sta, tid);
 593
 594 #ifdef CONFIG_MAC80211_HT_DEBUG
 595         printk(KERN_DEBUG "Aggregation is on for tid %d\n", tid);
 596 #endif
 597
 598         drv_ampdu_action(local, sta->sdata,
 599                          IEEE80211_AMPDU_TX_OPERATIONAL,
 600                          &sta->sta, tid, NULL, tid_tx->buf_size);
 601
 602         /*
 603          * synchronize with TX path, while splicing the TX path
 604          * should block so it won't put more packets onto pending.
 605          */
 606         spin_lock_bh(&sta->lock);
 607
 608         ieee80211_agg_splice_packets(sta->sdata, tid_tx, tid);
 609         /*
 610          * Now mark as operational. This will be visible
 611          * in the TX path, and lets it go lock-free in
 612          * the common case.
 613          */
 614         set_bit(HT_AGG_STATE_OPERATIONAL, &tid_tx->state);
 615         ieee80211_agg_splice_finish(sta->sdata, tid);
 616
 617         spin_unlock_bh(&sta->lock);
 618 }
 619
 620 void ieee80211_start_tx_ba_cb(struct ieee80211_vif *vif, u8 *ra, u16 tid)
 621 {
 622         struct ieee80211_sub_if_data *sdata = vif_to_sdata(vif);
 623         struct ieee80211_local *local = sdata->local;
 624         struct sta_info *sta;
 625         struct tid_ampdu_tx *tid_tx;
 626
 627         trace_api_start_tx_ba_cb(sdata, ra, tid);
 628
 629         if (tid >= STA_TID_NUM) {
 630 #ifdef CONFIG_MAC80211_HT_DEBUG
 631                 printk(KERN_DEBUG "Bad TID value: tid = %d (>= %d)\n",
 632                                 tid, STA_TID_NUM);
 633 #endif
 634                 return;
 635         }
 636
 637         mutex_lock(&local->sta_mtx);
 638         sta = sta_info_get_bss(sdata, ra);
 639         if (!sta) {
 640                 mutex_unlock(&local->sta_mtx);
 641 #ifdef CONFIG_MAC80211_HT_DEBUG
 642                 printk(KERN_DEBUG "Could not find station: %pM\n", ra);
 643 #endif
 644                 return;
 645         }
 646
 647         mutex_lock(&sta->ampdu_mlme.mtx);
 648         tid_tx = rcu_dereference_protected_tid_tx(sta, tid);
 649
 650         if (WARN_ON(!tid_tx)) {
 651 #ifdef CONFIG_MAC80211_HT_DEBUG
 652                 printk(KERN_DEBUG "addBA was not requested!\n");
 653 #endif
 654                 goto unlock;
 655         }
 656
 657         if (WARN_ON(test_and_set_bit(HT_AGG_STATE_DRV_READY, &tid_tx->state)))
 658                 goto unlock;
 659
 660         if (test_bit(HT_AGG_STATE_RESPONSE_RECEIVED, &tid_tx->state))
 661                 ieee80211_agg_tx_operational(local, sta, tid);
 662
 663  unlock:
 664         mutex_unlock(&sta->ampdu_mlme.mtx);
 665         mutex_unlock(&local->sta_mtx);
 666 }
 667
 668 void ieee80211_start_tx_ba_cb_irqsafe(struct ieee80211_vif *vif,
 669                                       const u8 *ra, u16 tid)
 670 {
 671         struct ieee80211_sub_if_data *sdata = vif_to_sdata(vif);
 672         struct ieee80211_local *local = sdata->local;
 673         struct ieee80211_ra_tid *ra_tid;
 674         struct sk_buff *skb = dev_alloc_skb(0);
 675
 676         if (unlikely(!skb))
 677                 return;
 678
 679         ra_tid = (struct ieee80211_ra_tid *) &skb->cb;
 680         memcpy(&ra_tid->ra, ra, ETH_ALEN);
 681         ra_tid->tid = tid;
 682
 683         skb->pkt_type = IEEE80211_SDATA_QUEUE_AGG_START;
 684         skb_queue_tail(&sdata->skb_queue, skb);
 685         ieee80211_queue_work(&local->hw, &sdata->work);
 686 }
 687 EXPORT_SYMBOL(ieee80211_start_tx_ba_cb_irqsafe);
 688
 689 int __ieee80211_stop_tx_ba_session(struct sta_info *sta, u16 tid,
 690                                    enum ieee80211_back_parties initiator,
 691                                    bool tx)
 692 {
 693         int ret;
 694
 695         mutex_lock(&sta->ampdu_mlme.mtx);
 696
 697         ret = ___ieee80211_stop_tx_ba_session(sta, tid, initiator, tx);
 698
 699         mutex_unlock(&sta->ampdu_mlme.mtx);
 700
 701         return ret;
 702 }
 703
 704 int ieee80211_stop_tx_ba_session(struct ieee80211_sta *pubsta, u16 tid)
 705 {
 706         struct sta_info *sta = container_of(pubsta, struct sta_info, sta);
 707         struct ieee80211_sub_if_data *sdata = sta->sdata;
 708         struct ieee80211_local *local = sdata->local;
 709         struct tid_ampdu_tx *tid_tx;
 710         int ret = 0;
 711
 712         trace_api_stop_tx_ba_session(pubsta, tid);
 713
 714         if (!local->ops->ampdu_action)
 715                 return -EINVAL;
 716
 717         if (tid >= STA_TID_NUM)
 718                 return -EINVAL;
 719
 720         spin_lock_bh(&sta->lock);
 721         tid_tx = rcu_dereference_protected_tid_tx(sta, tid);
 722
 723         if (!tid_tx) {
 724                 ret = -ENOENT;
 725                 goto unlock;
 726         }
 727
 728         if (test_bit(HT_AGG_STATE_STOPPING, &tid_tx->state)) {
 729                 /* already in progress stopping it */
 730                 ret = 0;
 731                 goto unlock;
 732         }
 733
 734         set_bit(HT_AGG_STATE_WANT_STOP, &tid_tx->state);
 735         ieee80211_queue_work(&local->hw, &sta->ampdu_mlme.work);
 736
 737  unlock:
 738         spin_unlock_bh(&sta->lock);
 739         return ret;
 740 }
 741 EXPORT_SYMBOL(ieee80211_stop_tx_ba_session);
 742
 743 void ieee80211_stop_tx_ba_cb(struct ieee80211_vif *vif, u8 *ra, u8 tid)
 744 {
 745         struct ieee80211_sub_if_data *sdata = vif_to_sdata(vif);
 746         struct ieee80211_local *local = sdata->local;
 747         struct sta_info *sta;
 748         struct tid_ampdu_tx *tid_tx;
 749
 750         trace_api_stop_tx_ba_cb(sdata, ra, tid);
 751
 752         if (tid >= STA_TID_NUM) {
 753 #ifdef CONFIG_MAC80211_HT_DEBUG
 754                 printk(KERN_DEBUG "Bad TID value: tid = %d (>= %d)\n",
 755                                 tid, STA_TID_NUM);
 756 #endif
 757                 return;
 758         }
 759
 760 #ifdef CONFIG_MAC80211_HT_DEBUG
 761         printk(KERN_DEBUG "Stopping Tx BA session for %pM tid %d\n",
 762                ra, tid);
 763 #endif /* CONFIG_MAC80211_HT_DEBUG */
 764
 765         mutex_lock(&local->sta_mtx);
 766
 767         sta = sta_info_get_bss(sdata, ra);
 768         if (!sta) {
 769 #ifdef CONFIG_MAC80211_HT_DEBUG
 770                 printk(KERN_DEBUG "Could not find station: %pM\n", ra);
 771 #endif
 772                 goto unlock;
 773         }
 774
 775         mutex_lock(&sta->ampdu_mlme.mtx);
 776         spin_lock_bh(&sta->lock);
 777         tid_tx = rcu_dereference_protected_tid_tx(sta, tid);
 778
 779         if (!tid_tx || !test_bit(HT_AGG_STATE_STOPPING, &tid_tx->state)) {
 780 #ifdef CONFIG_MAC80211_HT_DEBUG
 781                 printk(KERN_DEBUG "unexpected callback to A-MPDU stop\n");
 782 #endif
 783                 goto unlock_sta;
 784         }
 785
 786         if (tid_tx->stop_initiator == WLAN_BACK_INITIATOR && tid_tx->tx_stop)
 787                 ieee80211_send_delba(sta->sdata, ra, tid,
 788                         WLAN_BACK_INITIATOR, WLAN_REASON_QSTA_NOT_USE);
 789
 790         /*
 791          * When we get here, the TX path will not be lockless any more wrt.
 792          * aggregation, since the OPERATIONAL bit has long been cleared.
 793          * Thus it will block on getting the lock, if it occurs. So if we
 794          * stop the queue now, we will not get any more packets, and any
 795          * that might be being processed will wait for us here, thereby
 796          * guaranteeing that no packets go to the tid_tx pending queue any
 797          * more.
 798          */
 799
 800         ieee80211_agg_splice_packets(sta->sdata, tid_tx, tid);
 801
 802         /* future packets must not find the tid_tx struct any more */
 803         ieee80211_assign_tid_tx(sta, tid, NULL);
 804
 805         ieee80211_agg_splice_finish(sta->sdata, tid);
 806
 807         kfree_rcu(tid_tx, rcu_head);
 808
 809  unlock_sta:
 810         spin_unlock_bh(&sta->lock);
 811         mutex_unlock(&sta->ampdu_mlme.mtx);
 812  unlock:
 813         mutex_unlock(&local->sta_mtx);
 814 }
 815
 816 void ieee80211_stop_tx_ba_cb_irqsafe(struct ieee80211_vif *vif,
 817                                      const u8 *ra, u16 tid)
 818 {
 819         struct ieee80211_sub_if_data *sdata = vif_to_sdata(vif);
 820         struct ieee80211_local *local = sdata->local;
 821         struct ieee80211_ra_tid *ra_tid;
 822         struct sk_buff *skb = dev_alloc_skb(0);
 823
 824         if (unlikely(!skb))
 825                 return;
 826
 827         ra_tid = (struct ieee80211_ra_tid *) &skb->cb;
 828         memcpy(&ra_tid->ra, ra, ETH_ALEN);
 829         ra_tid->tid = tid;
 830
 831         skb->pkt_type = IEEE80211_SDATA_QUEUE_AGG_STOP;
 832         skb_queue_tail(&sdata->skb_queue, skb);
 833         ieee80211_queue_work(&local->hw, &sdata->work);
 834 }
 835 EXPORT_SYMBOL(ieee80211_stop_tx_ba_cb_irqsafe);
 836
 837
 838 void ieee80211_process_addba_resp(struct ieee80211_local *local,
 839                                   struct sta_info *sta,
 840                                   struct ieee80211_mgmt *mgmt,
 841                                   size_t len)
 842 {
 843         struct tid_ampdu_tx *tid_tx;
 844         u16 capab, tid;
 845         u8 buf_size;
 846
 847         capab = le16_to_cpu(mgmt->u.action.u.addba_resp.capab);
 848         tid = (capab & IEEE80211_ADDBA_PARAM_TID_MASK) >> 2;
 849         buf_size = (capab & IEEE80211_ADDBA_PARAM_BUF_SIZE_MASK) >> 6;
 850
 851         mutex_lock(&sta->ampdu_mlme.mtx);
 852
 853         tid_tx = rcu_dereference_protected_tid_tx(sta, tid);
 854         if (!tid_tx)
 855                 goto out;
 856
 857         if (mgmt->u.action.u.addba_resp.dialog_token != tid_tx->dialog_token) {
 858 #ifdef CONFIG_MAC80211_HT_DEBUG
 859                 printk(KERN_DEBUG "wrong addBA response token, tid %d\n", tid);
 860 #endif
 861                 goto out;
 862         }
 863
 864         del_timer_sync(&tid_tx->addba_resp_timer);
 865
 866 #ifdef CONFIG_MAC80211_HT_DEBUG
 867         printk(KERN_DEBUG "switched off addBA timer for tid %d\n", tid);
 868 #endif
 869
 870         /*
 871          * addba_resp_timer may have fired before we got here, and
 872          * caused WANT_STOP to be set. If the stop then was already
 873          * processed further, STOPPING might be set.
 874          */
 875         if (test_bit(HT_AGG_STATE_WANT_STOP, &tid_tx->state) ||
 876             test_bit(HT_AGG_STATE_STOPPING, &tid_tx->state)) {
 877 #ifdef CONFIG_MAC80211_HT_DEBUG
 878                 printk(KERN_DEBUG
 879                        "got addBA resp for tid %d but we already gave up\n",
 880                        tid);
 881 #endif
 882                 goto out;
 883         }
 884
 885         /*
 886          * IEEE 802.11-2007 7.3.1.14:
 887          * In an ADDBA Response frame, when the Status Code field
 888          * is set to 0, the Buffer Size subfield is set to a value
 889          * of at least 1.
 890          */
 891         if (le16_to_cpu(mgmt->u.action.u.addba_resp.status)
 892                         == WLAN_STATUS_SUCCESS && buf_size) {
 893                 if (test_and_set_bit(HT_AGG_STATE_RESPONSE_RECEIVED,
 894                                      &tid_tx->state)) {
 895                         /* ignore duplicate response */
 896                         goto out;
 897                 }
 898
 899                 tid_tx->buf_size = buf_size;
 900
 901                 if (test_bit(HT_AGG_STATE_DRV_READY, &tid_tx->state))
 902                         ieee80211_agg_tx_operational(local, sta, tid);
 903
 904                 sta->ampdu_mlme.addba_req_num[tid] = 0;
 905
 906                 if (tid_tx->timeout) {
 907                         mod_timer(&tid_tx->session_timer,
 908                                   TU_TO_EXP_TIME(tid_tx->timeout));
 909                         tid_tx->last_tx = jiffies;
 910                 }
 911
 912         } else {
 913                 ___ieee80211_stop_tx_ba_session(sta, tid, WLAN_BACK_INITIATOR,
 914                                                 true);
 915         }
 916
 917  out:
 918         mutex_unlock(&sta->ampdu_mlme.mtx);
 919 }