net/mac80211/sta_info.c

   1 /*
   2  * Copyright 2002-2005, Instant802 Networks, Inc.
   3  * Copyright 2006-2007  Jiri Benc <jbenc@suse.cz>
   4  *
   5  * This program is free software; you can redistribute it and/or modify
   6  * it under the terms of the GNU General Public License version 2 as
   7  * published by the Free Software Foundation.
   8  */
   9
  10 #include <linux/module.h>
  11 #include <linux/init.h>
  12 #include <linux/etherdevice.h>
  13 #include <linux/netdevice.h>
  14 #include <linux/types.h>
  15 #include <linux/slab.h>
  16 #include <linux/skbuff.h>
  17 #include <linux/if_arp.h>
  18 #include <linux/timer.h>
  19 #include <linux/rtnetlink.h>
  20
  21 #include <net/mac80211.h>
  22 #include "ieee80211_i.h"
  23 #include "driver-ops.h"
  24 #include "rate.h"
  25 #include "sta_info.h"
  26 #include "debugfs_sta.h"
  27 #include "mesh.h"
  28 #include "wme.h"
  29
  30 /**
  31  * DOC: STA information lifetime rules
  32  *
  33  * STA info structures (&struct sta_info) are managed in a hash table
  34  * for faster lookup and a list for iteration. They are managed using
  35  * RCU, i.e. access to the list and hash table is protected by RCU.
  36  *
  37  * Upon allocating a STA info structure with sta_info_alloc(), the caller
  38  * owns that structure. It must then insert it into the hash table using
  39  * either sta_info_insert() or sta_info_insert_rcu(); only in the latter
  40  * case (which acquires an rcu read section but must not be called from
  41  * within one) will the pointer still be valid after the call. Note that
  42  * the caller may not do much with the STA info before inserting it, in
  43  * particular, it may not start any mesh peer link management or add
  44  * encryption keys.
  45  *
  46  * When the insertion fails (sta_info_insert()) returns non-zero), the
  47  * structure will have been freed by sta_info_insert()!
  48  *
  49  * Station entries are added by mac80211 when you establish a link with a
  50  * peer. This means different things for the different type of interfaces
  51  * we support. For a regular station this mean we add the AP sta when we
  52  * receive an association response from the AP. For IBSS this occurs when
  53  * get to know about a peer on the same IBSS. For WDS we add the sta for
  54  * the peer immediately upon device open. When using AP mode we add stations
  55  * for each respective station upon request from userspace through nl80211.
  56  *
  57  * In order to remove a STA info structure, various sta_info_destroy_*()
  58  * calls are available.
  59  *
  60  * There is no concept of ownership on a STA entry, each structure is
  61  * owned by the global hash table/list until it is removed. All users of
  62  * the structure need to be RCU protected so that the structure won't be
  63  * freed before they are done using it.
  64  */
  65
  66 /* Caller must hold local->sta_mtx */
  67 static int sta_info_hash_del(struct ieee80211_local *local,
  68                              struct sta_info *sta)
  69 {
  70         struct sta_info *s;
  71
  72         s = rcu_dereference_protected(local->sta_hash[STA_HASH(sta->sta.addr)],
  73                                       lockdep_is_held(&local->sta_mtx));
  74         if (!s)
  75                 return -ENOENT;
  76         if (s == sta) {
  77                 rcu_assign_pointer(local->sta_hash[STA_HASH(sta->sta.addr)],
  78                                    s->hnext);
  79                 return 0;
  80         }
  81
  82         while (rcu_access_pointer(s->hnext) &&
  83                rcu_access_pointer(s->hnext) != sta)
  84                 s = rcu_dereference_protected(s->hnext,
  85                                         lockdep_is_held(&local->sta_mtx));
  86         if (rcu_access_pointer(s->hnext)) {
  87                 rcu_assign_pointer(s->hnext, sta->hnext);
  88                 return 0;
  89         }
  90
  91         return -ENOENT;
  92 }
  93
  94 static void cleanup_single_sta(struct sta_info *sta)
  95 {
  96         int ac, i;
  97         struct tid_ampdu_tx *tid_tx;
  98         struct ieee80211_sub_if_data *sdata = sta->sdata;
  99         struct ieee80211_local *local = sdata->local;
 100         struct ps_data *ps;
 101
 102         /*
 103          * At this point, when being called as call_rcu callback,
 104          * neither mac80211 nor the driver can reference this
 105          * sta struct any more except by still existing timers
 106          * associated with this station that we clean up below.
 107          *
 108          * Note though that this still uses the sdata and even
 109          * calls the driver in AP and mesh mode, so interfaces
 110          * of those types mush use call sta_info_flush_cleanup()
 111          * (typically via sta_info_flush()) before deconfiguring
 112          * the driver.
 113          *
 114          * In station mode, nothing happens here so it doesn't
 115          * have to (and doesn't) do that, this is intentional to
 116          * speed up roaming.
 117          */
 118
 119         if (test_sta_flag(sta, WLAN_STA_PS_STA)) {
 120                 if (sta->sdata->vif.type == NL80211_IFTYPE_AP ||
 121                     sta->sdata->vif.type == NL80211_IFTYPE_AP_VLAN)
 122                         ps = &sdata->bss->ps;
 123                 else if (ieee80211_vif_is_mesh(&sdata->vif))
 124                         ps = &sdata->u.mesh.ps;
 125                 else
 126                         return;
 127
 128                 clear_sta_flag(sta, WLAN_STA_PS_STA);
 129
 130                 atomic_dec(&ps->num_sta_ps);
 131                 sta_info_recalc_tim(sta);
 132         }
 133
 134         for (ac = 0; ac < IEEE80211_NUM_ACS; ac++) {
 135                 local->total_ps_buffered -= skb_queue_len(&sta->ps_tx_buf[ac]);
 136                 ieee80211_purge_tx_queue(&local->hw, &sta->ps_tx_buf[ac]);
 137                 ieee80211_purge_tx_queue(&local->hw, &sta->tx_filtered[ac]);
 138         }
 139
 140         if (ieee80211_vif_is_mesh(&sdata->vif))
 141                 mesh_sta_cleanup(sta);
 142
 143         cancel_work_sync(&sta->drv_unblock_wk);
 144
 145         /*
 146          * Destroy aggregation state here. It would be nice to wait for the
 147          * driver to finish aggregation stop and then clean up, but for now
 148          * drivers have to handle aggregation stop being requested, followed
 149          * directly by station destruction.
 150          */
 151         for (i = 0; i < IEEE80211_NUM_TIDS; i++) {
 152                 tid_tx = rcu_dereference_raw(sta->ampdu_mlme.tid_tx[i]);
 153                 if (!tid_tx)
 154                         continue;
 155                 ieee80211_purge_tx_queue(&local->hw, &tid_tx->pending);
 156                 kfree(tid_tx);
 157         }
 158
 159         sta_info_free(local, sta);
 160 }
 161
 162 void ieee80211_cleanup_sdata_stas(struct ieee80211_sub_if_data *sdata)
 163 {
 164         struct sta_info *sta;
 165
 166         spin_lock_bh(&sdata->cleanup_stations_lock);
 167         while (!list_empty(&sdata->cleanup_stations)) {
 168                 sta = list_first_entry(&sdata->cleanup_stations,
 169                                        struct sta_info, list);
 170                 list_del(&sta->list);
 171                 spin_unlock_bh(&sdata->cleanup_stations_lock);
 172
 173                 cleanup_single_sta(sta);
 174
 175                 spin_lock_bh(&sdata->cleanup_stations_lock);
 176         }
 177
 178         spin_unlock_bh(&sdata->cleanup_stations_lock);
 179 }
 180
 181 static void free_sta_rcu(struct rcu_head *h)
 182 {
 183         struct sta_info *sta = container_of(h, struct sta_info, rcu_head);
 184         struct ieee80211_sub_if_data *sdata = sta->sdata;
 185
 186         spin_lock(&sdata->cleanup_stations_lock);
 187         list_add_tail(&sta->list, &sdata->cleanup_stations);
 188         spin_unlock(&sdata->cleanup_stations_lock);
 189
 190         ieee80211_queue_work(&sdata->local->hw, &sdata->cleanup_stations_wk);
 191 }
 192
 193 /* protected by RCU */
 194 struct sta_info *sta_info_get(struct ieee80211_sub_if_data *sdata,
 195                               const u8 *addr)
 196 {
 197         struct ieee80211_local *local = sdata->local;
 198         struct sta_info *sta;
 199
 200         sta = rcu_dereference_check(local->sta_hash[STA_HASH(addr)],
 201                                     lockdep_is_held(&local->sta_mtx));
 202         while (sta) {
 203                 if (sta->sdata == sdata &&
 204                     ether_addr_equal(sta->sta.addr, addr))
 205                         break;
 206                 sta = rcu_dereference_check(sta->hnext,
 207                                             lockdep_is_held(&local->sta_mtx));
 208         }
 209         return sta;
 210 }
 211
 212 /*
 213  * Get sta info either from the specified interface
 214  * or from one of its vlans
 215  */
 216 struct sta_info *sta_info_get_bss(struct ieee80211_sub_if_data *sdata,
 217                                   const u8 *addr)
 218 {
 219         struct ieee80211_local *local = sdata->local;
 220         struct sta_info *sta;
 221
 222         sta = rcu_dereference_check(local->sta_hash[STA_HASH(addr)],
 223                                     lockdep_is_held(&local->sta_mtx));
 224         while (sta) {
 225                 if ((sta->sdata == sdata ||
 226                      (sta->sdata->bss && sta->sdata->bss == sdata->bss)) &&
 227                     ether_addr_equal(sta->sta.addr, addr))
 228                         break;
 229                 sta = rcu_dereference_check(sta->hnext,
 230                                             lockdep_is_held(&local->sta_mtx));
 231         }
 232         return sta;
 233 }
 234
 235 struct sta_info *sta_info_get_by_idx(struct ieee80211_sub_if_data *sdata,
 236                                      int idx)
 237 {
 238         struct ieee80211_local *local = sdata->local;
 239         struct sta_info *sta;
 240         int i = 0;
 241
 242         list_for_each_entry_rcu(sta, &local->sta_list, list) {
 243                 if (sdata != sta->sdata)
 244                         continue;
 245                 if (i < idx) {
 246                         ++i;
 247                         continue;
 248                 }
 249                 return sta;
 250         }
 251
 252         return NULL;
 253 }
 254
 255 /**
 256  * sta_info_free - free STA
 257  *
 258  * @local: pointer to the global information
 259  * @sta: STA info to free
 260  *
 261  * This function must undo everything done by sta_info_alloc()
 262  * that may happen before sta_info_insert(). It may only be
 263  * called when sta_info_insert() has not been attempted (and
 264  * if that fails, the station is freed anyway.)
 265  */
 266 void sta_info_free(struct ieee80211_local *local, struct sta_info *sta)
 267 {
 268         if (sta->rate_ctrl)
 269                 rate_control_free_sta(sta);
 270
 271         sta_dbg(sta->sdata, "Destroyed STA %pM\n", sta->sta.addr);
 272
 273         kfree(sta);
 274 }
 275
 276 /* Caller must hold local->sta_mtx */
 277 static void sta_info_hash_add(struct ieee80211_local *local,
 278                               struct sta_info *sta)
 279 {
 280         lockdep_assert_held(&local->sta_mtx);
 281         sta->hnext = local->sta_hash[STA_HASH(sta->sta.addr)];
 282         rcu_assign_pointer(local->sta_hash[STA_HASH(sta->sta.addr)], sta);
 283 }
 284
 285 static void sta_unblock(struct work_struct *wk)
 286 {
 287         struct sta_info *sta;
 288
 289         sta = container_of(wk, struct sta_info, drv_unblock_wk);
 290
 291         if (sta->dead)
 292                 return;
 293
 294         if (!test_sta_flag(sta, WLAN_STA_PS_STA)) {
 295                 local_bh_disable();
 296                 ieee80211_sta_ps_deliver_wakeup(sta);
 297                 local_bh_enable();
 298         } else if (test_and_clear_sta_flag(sta, WLAN_STA_PSPOLL)) {
 299                 clear_sta_flag(sta, WLAN_STA_PS_DRIVER);
 300
 301                 local_bh_disable();
 302                 ieee80211_sta_ps_deliver_poll_response(sta);
 303                 local_bh_enable();
 304         } else if (test_and_clear_sta_flag(sta, WLAN_STA_UAPSD)) {
 305                 clear_sta_flag(sta, WLAN_STA_PS_DRIVER);
 306
 307                 local_bh_disable();
 308                 ieee80211_sta_ps_deliver_uapsd(sta);
 309                 local_bh_enable();
 310         } else
 311                 clear_sta_flag(sta, WLAN_STA_PS_DRIVER);
 312 }
 313
 314 static int sta_prepare_rate_control(struct ieee80211_local *local,
 315                                     struct sta_info *sta, gfp_t gfp)
 316 {
 317         if (local->hw.flags & IEEE80211_HW_HAS_RATE_CONTROL)
 318                 return 0;
 319
 320         sta->rate_ctrl = local->rate_ctrl;
 321         sta->rate_ctrl_priv = rate_control_alloc_sta(sta->rate_ctrl,
 322                                                      &sta->sta, gfp);
 323         if (!sta->rate_ctrl_priv)
 324                 return -ENOMEM;
 325
 326         return 0;
 327 }
 328
 329 struct sta_info *sta_info_alloc(struct ieee80211_sub_if_data *sdata,
 330                                 const u8 *addr, gfp_t gfp)
 331 {
 332         struct ieee80211_local *local = sdata->local;
 333         struct sta_info *sta;
 334         struct timespec uptime;
 335         int i;
 336
 337         sta = kzalloc(sizeof(*sta) + local->hw.sta_data_size, gfp);
 338         if (!sta)
 339                 return NULL;
 340
 341         spin_lock_init(&sta->lock);
 342         INIT_WORK(&sta->drv_unblock_wk, sta_unblock);
 343         INIT_WORK(&sta->ampdu_mlme.work, ieee80211_ba_session_work);
 344         mutex_init(&sta->ampdu_mlme.mtx);
 345
 346         memcpy(sta->sta.addr, addr, ETH_ALEN);
 347         sta->local = local;
 348         sta->sdata = sdata;
 349         sta->last_rx = jiffies;
 350
 351         sta->sta_state = IEEE80211_STA_NONE;
 352
 353         do_posix_clock_monotonic_gettime(&uptime);
 354         sta->last_connected = uptime.tv_sec;
 355         ewma_init(&sta->avg_signal, 1024, 8);
 356
 357         if (sta_prepare_rate_control(local, sta, gfp)) {
 358                 kfree(sta);
 359                 return NULL;
 360         }
 361
 362         for (i = 0; i < IEEE80211_NUM_TIDS; i++) {
 363                 /*
 364                  * timer_to_tid must be initialized with identity mapping
 365                  * to enable session_timer's data differentiation. See
 366                  * sta_rx_agg_session_timer_expired for usage.
 367                  */
 368                 sta->timer_to_tid[i] = i;
 369         }
 370         for (i = 0; i < IEEE80211_NUM_ACS; i++) {
 371                 skb_queue_head_init(&sta->ps_tx_buf[i]);
 372                 skb_queue_head_init(&sta->tx_filtered[i]);
 373         }
 374
 375         for (i = 0; i < IEEE80211_NUM_TIDS; i++)
 376                 sta->last_seq_ctrl[i] = cpu_to_le16(USHRT_MAX);
 377
 378         sta_dbg(sdata, "Allocated STA %pM\n", sta->sta.addr);
 379
 380         return sta;
 381 }
 382
 383 static int sta_info_insert_check(struct sta_info *sta)
 384 {
 385         struct ieee80211_sub_if_data *sdata = sta->sdata;
 386
 387         /*
 388          * Can't be a WARN_ON because it can be triggered through a race:
 389          * something inserts a STA (on one CPU) without holding the RTNL
 390          * and another CPU turns off the net device.
 391          */
 392         if (unlikely(!ieee80211_sdata_running(sdata)))
 393                 return -ENETDOWN;
 394
 395         if (WARN_ON(ether_addr_equal(sta->sta.addr, sdata->vif.addr) ||
 396                     is_multicast_ether_addr(sta->sta.addr)))
 397                 return -EINVAL;
 398
 399         return 0;
 400 }
 401
 402 static int sta_info_insert_drv_state(struct ieee80211_local *local,
 403                                      struct ieee80211_sub_if_data *sdata,
 404                                      struct sta_info *sta)
 405 {
 406         enum ieee80211_sta_state state;
 407         int err = 0;
 408
 409         for (state = IEEE80211_STA_NOTEXIST; state < sta->sta_state; state++) {
 410                 err = drv_sta_state(local, sdata, sta, state, state + 1);
 411                 if (err)
 412                         break;
 413         }
 414
 415         if (!err) {
 416                 /*
 417                  * Drivers using legacy sta_add/sta_remove callbacks only
 418                  * get uploaded set to true after sta_add is called.
 419                  */
 420                 if (!local->ops->sta_add)
 421                         sta->uploaded = true;
 422                 return 0;
 423         }
 424
 425         if (sdata->vif.type == NL80211_IFTYPE_ADHOC) {
 426                 sdata_info(sdata,
 427                            "failed to move IBSS STA %pM to state %d (%d) - keeping it anyway\n",
 428                            sta->sta.addr, state + 1, err);
 429                 err = 0;
 430         }
 431
 432         /* unwind on error */
 433         for (; state > IEEE80211_STA_NOTEXIST; state--)
 434                 WARN_ON(drv_sta_state(local, sdata, sta, state, state - 1));
 435
 436         return err;
 437 }
 438
 439 /*
 440  * should be called with sta_mtx locked
 441  * this function replaces the mutex lock
 442  * with a RCU lock
 443  */
 444 static int sta_info_insert_finish(struct sta_info *sta) __acquires(RCU)
 445 {
 446         struct ieee80211_local *local = sta->local;
 447         struct ieee80211_sub_if_data *sdata = sta->sdata;
 448         struct station_info sinfo;
 449         int err = 0;
 450
 451         lockdep_assert_held(&local->sta_mtx);
 452
 453         /* check if STA exists already */
 454         if (sta_info_get_bss(sdata, sta->sta.addr)) {
 455                 err = -EEXIST;
 456                 goto out_err;
 457         }
 458
 459         /* notify driver */
 460         err = sta_info_insert_drv_state(local, sdata, sta);
 461         if (err)
 462                 goto out_err;
 463
 464         local->num_sta++;
 465         local->sta_generation++;
 466         smp_mb();
 467
 468         /* make the station visible */
 469         sta_info_hash_add(local, sta);
 470
 471         list_add_rcu(&sta->list, &local->sta_list);
 472
 473         set_sta_flag(sta, WLAN_STA_INSERTED);
 474
 475         ieee80211_sta_debugfs_add(sta);
 476         rate_control_add_sta_debugfs(sta);
 477
 478         memset(&sinfo, 0, sizeof(sinfo));
 479         sinfo.filled = 0;
 480         sinfo.generation = local->sta_generation;
 481         cfg80211_new_sta(sdata->dev, sta->sta.addr, &sinfo, GFP_KERNEL);
 482
 483         sta_dbg(sdata, "Inserted STA %pM\n", sta->sta.addr);
 484
 485         /* move reference to rcu-protected */
 486         rcu_read_lock();
 487         mutex_unlock(&local->sta_mtx);
 488
 489         if (ieee80211_vif_is_mesh(&sdata->vif))
 490                 mesh_accept_plinks_update(sdata);
 491
 492         return 0;
 493  out_err:
 494         mutex_unlock(&local->sta_mtx);
 495         rcu_read_lock();
 496         return err;
 497 }
 498
 499 int sta_info_insert_rcu(struct sta_info *sta) __acquires(RCU)
 500 {
 501         struct ieee80211_local *local = sta->local;
 502         int err = 0;
 503
 504         might_sleep();
 505
 506         err = sta_info_insert_check(sta);
 507         if (err) {
 508                 rcu_read_lock();
 509                 goto out_free;
 510         }
 511
 512         mutex_lock(&local->sta_mtx);
 513
 514         err = sta_info_insert_finish(sta);
 515         if (err)
 516                 goto out_free;
 517
 518         return 0;
 519  out_free:
 520         BUG_ON(!err);
 521         sta_info_free(local, sta);
 522         return err;
 523 }
 524
 525 int sta_info_insert(struct sta_info *sta)
 526 {
 527         int err = sta_info_insert_rcu(sta);
 528
 529         rcu_read_unlock();
 530
 531         return err;
 532 }
 533
 534 static inline void __bss_tim_set(u8 *tim, u16 id)
 535 {
 536         /*
 537          * This format has been mandated by the IEEE specifications,
 538          * so this line may not be changed to use the __set_bit() format.
 539          */
 540         tim[id / 8] |= (1 << (id % 8));
 541 }
 542
 543 static inline void __bss_tim_clear(u8 *tim, u16 id)
 544 {
 545         /*
 546          * This format has been mandated by the IEEE specifications,
 547          * so this line may not be changed to use the __clear_bit() format.
 548          */
 549         tim[id / 8] &= ~(1 << (id % 8));
 550 }
 551
 552 static unsigned long ieee80211_tids_for_ac(int ac)
 553 {
 554         /* If we ever support TIDs > 7, this obviously needs to be adjusted */
 555         switch (ac) {
 556         case IEEE80211_AC_VO:
 557                 return BIT(6) | BIT(7);
 558         case IEEE80211_AC_VI:
 559                 return BIT(4) | BIT(5);
 560         case IEEE80211_AC_BE:
 561                 return BIT(0) | BIT(3);
 562         case IEEE80211_AC_BK:
 563                 return BIT(1) | BIT(2);
 564         default:
 565                 WARN_ON(1);
 566                 return 0;
 567         }
 568 }
 569
 570 void sta_info_recalc_tim(struct sta_info *sta)
 571 {
 572         struct ieee80211_local *local = sta->local;
 573         struct ps_data *ps;
 574         unsigned long flags;
 575         bool indicate_tim = false;
 576         u8 ignore_for_tim = sta->sta.uapsd_queues;
 577         int ac;
 578         u16 id;
 579
 580         if (sta->sdata->vif.type == NL80211_IFTYPE_AP ||
 581             sta->sdata->vif.type == NL80211_IFTYPE_AP_VLAN) {
 582                 if (WARN_ON_ONCE(!sta->sdata->bss))
 583                         return;
 584
 585                 ps = &sta->sdata->bss->ps;
 586                 id = sta->sta.aid;
 587 #ifdef CONFIG_MAC80211_MESH
 588         } else if (ieee80211_vif_is_mesh(&sta->sdata->vif)) {
 589                 ps = &sta->sdata->u.mesh.ps;
 590                 /* TIM map only for PLID <= IEEE80211_MAX_AID */
 591                 id = le16_to_cpu(sta->plid) % IEEE80211_MAX_AID;
 592 #endif
 593         } else {
 594                 return;
 595         }
 596
 597         /* No need to do anything if the driver does all */
 598         if (local->hw.flags & IEEE80211_HW_AP_LINK_PS)
 599                 return;
 600
 601         if (sta->dead)
 602                 goto done;
 603
 604         /*
 605          * If all ACs are delivery-enabled then we should build
 606          * the TIM bit for all ACs anyway; if only some are then
 607          * we ignore those and build the TIM bit using only the
 608          * non-enabled ones.
 609          */
 610         if (ignore_for_tim == BIT(IEEE80211_NUM_ACS) - 1)
 611                 ignore_for_tim = 0;
 612
 613         for (ac = 0; ac < IEEE80211_NUM_ACS; ac++) {
 614                 unsigned long tids;
 615
 616                 if (ignore_for_tim & BIT(ac))
 617                         continue;
 618
 619                 indicate_tim |= !skb_queue_empty(&sta->tx_filtered[ac]) ||
 620                                 !skb_queue_empty(&sta->ps_tx_buf[ac]);
 621                 if (indicate_tim)
 622                         break;
 623
 624                 tids = ieee80211_tids_for_ac(ac);
 625
 626                 indicate_tim |=
 627                         sta->driver_buffered_tids & tids;
 628         }
 629
 630  done:
 631         spin_lock_irqsave(&local->tim_lock, flags);
 632
 633         if (indicate_tim)
 634                 __bss_tim_set(ps->tim, id);
 635         else
 636                 __bss_tim_clear(ps->tim, id);
 637
 638         if (local->ops->set_tim) {
 639                 local->tim_in_locked_section = true;
 640                 drv_set_tim(local, &sta->sta, indicate_tim);
 641                 local->tim_in_locked_section = false;
 642         }
 643
 644         spin_unlock_irqrestore(&local->tim_lock, flags);
 645 }
 646
 647 static bool sta_info_buffer_expired(struct sta_info *sta, struct sk_buff *skb)
 648 {
 649         struct ieee80211_tx_info *info;
 650         int timeout;
 651
 652         if (!skb)
 653                 return false;
 654
 655         info = IEEE80211_SKB_CB(skb);
 656
 657         /* Timeout: (2 * listen_interval * beacon_int * 1024 / 1000000) sec */
 658         timeout = (sta->listen_interval *
 659                    sta->sdata->vif.bss_conf.beacon_int *
 660                    32 / 15625) * HZ;
 661         if (timeout < STA_TX_BUFFER_EXPIRE)
 662                 timeout = STA_TX_BUFFER_EXPIRE;
 663         return time_after(jiffies, info->control.jiffies + timeout);
 664 }
 665
 666
 667 static bool sta_info_cleanup_expire_buffered_ac(struct ieee80211_local *local,
 668                                                 struct sta_info *sta, int ac)
 669 {
 670         unsigned long flags;
 671         struct sk_buff *skb;
 672
 673         /*
 674          * First check for frames that should expire on the filtered
 675          * queue. Frames here were rejected by the driver and are on
 676          * a separate queue to avoid reordering with normal PS-buffered
 677          * frames. They also aren't accounted for right now in the
 678          * total_ps_buffered counter.
 679          */
 680         for (;;) {
 681                 spin_lock_irqsave(&sta->tx_filtered[ac].lock, flags);
 682                 skb = skb_peek(&sta->tx_filtered[ac]);
 683                 if (sta_info_buffer_expired(sta, skb))
 684                         skb = __skb_dequeue(&sta->tx_filtered[ac]);
 685                 else
 686                         skb = NULL;
 687                 spin_unlock_irqrestore(&sta->tx_filtered[ac].lock, flags);
 688
 689                 /*
 690                  * Frames are queued in order, so if this one
 691                  * hasn't expired yet we can stop testing. If
 692                  * we actually reached the end of the queue we
 693                  * also need to stop, of course.
 694                  */
 695                 if (!skb)
 696                         break;
 697                 ieee80211_free_txskb(&local->hw, skb);
 698         }
 699
 700         /*
 701          * Now also check the normal PS-buffered queue, this will
 702          * only find something if the filtered queue was emptied
 703          * since the filtered frames are all before the normal PS
 704          * buffered frames.
 705          */
 706         for (;;) {
 707                 spin_lock_irqsave(&sta->ps_tx_buf[ac].lock, flags);
 708                 skb = skb_peek(&sta->ps_tx_buf[ac]);
 709                 if (sta_info_buffer_expired(sta, skb))
 710                         skb = __skb_dequeue(&sta->ps_tx_buf[ac]);
 711                 else
 712                         skb = NULL;
 713                 spin_unlock_irqrestore(&sta->ps_tx_buf[ac].lock, flags);
 714
 715                 /*
 716                  * frames are queued in order, so if this one
 717                  * hasn't expired yet (or we reached the end of
 718                  * the queue) we can stop testing
 719                  */
 720                 if (!skb)
 721                         break;
 722
 723                 local->total_ps_buffered--;
 724                 ps_dbg(sta->sdata, "Buffered frame expired (STA %pM)\n",
 725                        sta->sta.addr);
 726                 ieee80211_free_txskb(&local->hw, skb);
 727         }
 728
 729         /*
 730          * Finally, recalculate the TIM bit for this station -- it might
 731          * now be clear because the station was too slow to retrieve its
 732          * frames.
 733          */
 734         sta_info_recalc_tim(sta);
 735
 736         /*
 737          * Return whether there are any frames still buffered, this is
 738          * used to check whether the cleanup timer still needs to run,
 739          * if there are no frames we don't need to rearm the timer.
 740          */
 741         return !(skb_queue_empty(&sta->ps_tx_buf[ac]) &&
 742                  skb_queue_empty(&sta->tx_filtered[ac]));
 743 }
 744
 745 static bool sta_info_cleanup_expire_buffered(struct ieee80211_local *local,
 746                                              struct sta_info *sta)
 747 {
 748         bool have_buffered = false;
 749         int ac;
 750
 751         /* This is only necessary for stations on BSS/MBSS interfaces */
 752         if (!sta->sdata->bss &&
 753             !ieee80211_vif_is_mesh(&sta->sdata->vif))
 754                 return false;
 755
 756         for (ac = 0; ac < IEEE80211_NUM_ACS; ac++)
 757                 have_buffered |=
 758                         sta_info_cleanup_expire_buffered_ac(local, sta, ac);
 759
 760         return have_buffered;
 761 }
 762
 763 int __must_check __sta_info_destroy(struct sta_info *sta)
 764 {
 765         struct ieee80211_local *local;
 766         struct ieee80211_sub_if_data *sdata;
 767         int ret, i;
 768
 769         might_sleep();
 770
 771         if (!sta)
 772                 return -ENOENT;
 773
 774         local = sta->local;
 775         sdata = sta->sdata;
 776
 777         lockdep_assert_held(&local->sta_mtx);
 778
 779         /*
 780          * Before removing the station from the driver and
 781          * rate control, it might still start new aggregation
 782          * sessions -- block that to make sure the tear-down
 783          * will be sufficient.
 784          */
 785         set_sta_flag(sta, WLAN_STA_BLOCK_BA);
 786         ieee80211_sta_tear_down_BA_sessions(sta, AGG_STOP_DESTROY_STA);
 787
 788         ret = sta_info_hash_del(local, sta);
 789         if (ret)
 790                 return ret;
 791
 792         list_del_rcu(&sta->list);
 793
 794         mutex_lock(&local->key_mtx);
 795         for (i = 0; i < NUM_DEFAULT_KEYS; i++)
 796                 __ieee80211_key_free(key_mtx_dereference(local, sta->gtk[i]));
 797         if (sta->ptk)
 798                 __ieee80211_key_free(key_mtx_dereference(local, sta->ptk));
 799         mutex_unlock(&local->key_mtx);
 800
 801         sta->dead = true;
 802
 803         local->num_sta--;
 804         local->sta_generation++;
 805
 806         if (sdata->vif.type == NL80211_IFTYPE_AP_VLAN)
 807                 RCU_INIT_POINTER(sdata->u.vlan.sta, NULL);
 808
 809         while (sta->sta_state > IEEE80211_STA_NONE) {
 810                 ret = sta_info_move_state(sta, sta->sta_state - 1);
 811                 if (ret) {
 812                         WARN_ON_ONCE(1);
 813                         break;
 814                 }
 815         }
 816
 817         if (sta->uploaded) {
 818                 ret = drv_sta_state(local, sdata, sta, IEEE80211_STA_NONE,
 819                                     IEEE80211_STA_NOTEXIST);
 820                 WARN_ON_ONCE(ret != 0);
 821         }
 822
 823         sta_dbg(sdata, "Removed STA %pM\n", sta->sta.addr);
 824
 825         cfg80211_del_sta(sdata->dev, sta->sta.addr, GFP_KERNEL);
 826
 827         rate_control_remove_sta_debugfs(sta);
 828         ieee80211_sta_debugfs_remove(sta);
 829
 830         call_rcu(&sta->rcu_head, free_sta_rcu);
 831
 832         return 0;
 833 }
 834
 835 int sta_info_destroy_addr(struct ieee80211_sub_if_data *sdata, const u8 *addr)
 836 {
 837         struct sta_info *sta;
 838         int ret;
 839
 840         mutex_lock(&sdata->local->sta_mtx);
 841         sta = sta_info_get(sdata, addr);
 842         ret = __sta_info_destroy(sta);
 843         mutex_unlock(&sdata->local->sta_mtx);
 844
 845         return ret;
 846 }
 847
 848 int sta_info_destroy_addr_bss(struct ieee80211_sub_if_data *sdata,
 849                               const u8 *addr)
 850 {
 851         struct sta_info *sta;
 852         int ret;
 853
 854         mutex_lock(&sdata->local->sta_mtx);
 855         sta = sta_info_get_bss(sdata, addr);
 856         ret = __sta_info_destroy(sta);
 857         mutex_unlock(&sdata->local->sta_mtx);
 858
 859         return ret;
 860 }
 861
 862 static void sta_info_cleanup(unsigned long data)
 863 {
 864         struct ieee80211_local *local = (struct ieee80211_local *) data;
 865         struct sta_info *sta;
 866         bool timer_needed = false;
 867
 868         rcu_read_lock();
 869         list_for_each_entry_rcu(sta, &local->sta_list, list)
 870                 if (sta_info_cleanup_expire_buffered(local, sta))
 871                         timer_needed = true;
 872         rcu_read_unlock();
 873
 874         if (local->quiescing)
 875                 return;
 876
 877         if (!timer_needed)
 878                 return;
 879
 880         mod_timer(&local->sta_cleanup,
 881                   round_jiffies(jiffies + STA_INFO_CLEANUP_INTERVAL));
 882 }
 883
 884 void sta_info_init(struct ieee80211_local *local)
 885 {
 886         spin_lock_init(&local->tim_lock);
 887         mutex_init(&local->sta_mtx);
 888         INIT_LIST_HEAD(&local->sta_list);
 889
 890         setup_timer(&local->sta_cleanup, sta_info_cleanup,
 891                     (unsigned long)local);
 892 }
 893
 894 void sta_info_stop(struct ieee80211_local *local)
 895 {
 896         del_timer_sync(&local->sta_cleanup);
 897 }
 898
 899
 900 int sta_info_flush_defer(struct ieee80211_sub_if_data *sdata)
 901 {
 902         struct ieee80211_local *local = sdata->local;
 903         struct sta_info *sta, *tmp;
 904         int ret = 0;
 905
 906         might_sleep();
 907
 908         mutex_lock(&local->sta_mtx);
 909         list_for_each_entry_safe(sta, tmp, &local->sta_list, list) {
 910                 if (sdata == sta->sdata) {
 911                         WARN_ON(__sta_info_destroy(sta));
 912                         ret++;
 913                 }
 914         }
 915         mutex_unlock(&local->sta_mtx);
 916
 917         return ret;
 918 }
 919
 920 void sta_info_flush_cleanup(struct ieee80211_sub_if_data *sdata)
 921 {
 922         ieee80211_cleanup_sdata_stas(sdata);
 923         cancel_work_sync(&sdata->cleanup_stations_wk);
 924 }
 925
 926 void ieee80211_sta_expire(struct ieee80211_sub_if_data *sdata,
 927                           unsigned long exp_time)
 928 {
 929         struct ieee80211_local *local = sdata->local;
 930         struct sta_info *sta, *tmp;
 931
 932         mutex_lock(&local->sta_mtx);
 933
 934         list_for_each_entry_safe(sta, tmp, &local->sta_list, list) {
 935                 if (sdata != sta->sdata)
 936                         continue;
 937
 938                 if (time_after(jiffies, sta->last_rx + exp_time)) {
 939                         sta_dbg(sta->sdata, "expiring inactive STA %pM\n",
 940                                 sta->sta.addr);
 941
 942                         if (ieee80211_vif_is_mesh(&sdata->vif) &&
 943                             test_sta_flag(sta, WLAN_STA_PS_STA))
 944                                 atomic_dec(&sdata->u.mesh.ps.num_sta_ps);
 945
 946                         WARN_ON(__sta_info_destroy(sta));
 947                 }
 948         }
 949
 950         mutex_unlock(&local->sta_mtx);
 951 }
 952
 953 struct ieee80211_sta *ieee80211_find_sta_by_ifaddr(struct ieee80211_hw *hw,
 954                                                const u8 *addr,
 955                                                const u8 *localaddr)
 956 {
 957         struct sta_info *sta, *nxt;
 958
 959         /*
 960          * Just return a random station if localaddr is NULL
 961          * ... first in list.
 962          */
 963         for_each_sta_info(hw_to_local(hw), addr, sta, nxt) {
 964                 if (localaddr &&
 965                     !ether_addr_equal(sta->sdata->vif.addr, localaddr))
 966                         continue;
 967                 if (!sta->uploaded)
 968                         return NULL;
 969                 return &sta->sta;
 970         }
 971
 972         return NULL;
 973 }
 974 EXPORT_SYMBOL_GPL(ieee80211_find_sta_by_ifaddr);
 975
 976 struct ieee80211_sta *ieee80211_find_sta(struct ieee80211_vif *vif,
 977                                          const u8 *addr)
 978 {
 979         struct sta_info *sta;
 980
 981         if (!vif)
 982                 return NULL;
 983
 984         sta = sta_info_get_bss(vif_to_sdata(vif), addr);
 985         if (!sta)
 986                 return NULL;
 987
 988         if (!sta->uploaded)
 989                 return NULL;
 990
 991         return &sta->sta;
 992 }
 993 EXPORT_SYMBOL(ieee80211_find_sta);
 994
 995 static void clear_sta_ps_flags(void *_sta)
 996 {
 997         struct sta_info *sta = _sta;
 998         struct ieee80211_sub_if_data *sdata = sta->sdata;
 999         struct ps_data *ps;
1000
1001         if (sdata->vif.type == NL80211_IFTYPE_AP ||
1002             sdata->vif.type == NL80211_IFTYPE_AP_VLAN)
1003                 ps = &sdata->bss->ps;
1004         else if (ieee80211_vif_is_mesh(&sdata->vif))
1005                 ps = &sdata->u.mesh.ps;
1006         else
1007                 return;
1008
1009         clear_sta_flag(sta, WLAN_STA_PS_DRIVER);
1010         if (test_and_clear_sta_flag(sta, WLAN_STA_PS_STA))
1011                 atomic_dec(&ps->num_sta_ps);
1012 }
1013
1014 /* powersave support code */
1015 void ieee80211_sta_ps_deliver_wakeup(struct sta_info *sta)
1016 {
1017         struct ieee80211_sub_if_data *sdata = sta->sdata;
1018         struct ieee80211_local *local = sdata->local;
1019         struct sk_buff_head pending;
1020         int filtered = 0, buffered = 0, ac;
1021         unsigned long flags;
1022
1023         clear_sta_flag(sta, WLAN_STA_SP);
1024
1025         BUILD_BUG_ON(BITS_TO_LONGS(IEEE80211_NUM_TIDS) > 1);
1026         sta->driver_buffered_tids = 0;
1027
1028         if (!(local->hw.flags & IEEE80211_HW_AP_LINK_PS))
1029                 drv_sta_notify(local, sdata, STA_NOTIFY_AWAKE, &sta->sta);
1030
1031         skb_queue_head_init(&pending);
1032
1033         /* Send all buffered frames to the station */
1034         for (ac = 0; ac < IEEE80211_NUM_ACS; ac++) {
1035                 int count = skb_queue_len(&pending), tmp;
1036
1037                 spin_lock_irqsave(&sta->tx_filtered[ac].lock, flags);
1038                 skb_queue_splice_tail_init(&sta->tx_filtered[ac], &pending);
1039                 spin_unlock_irqrestore(&sta->tx_filtered[ac].lock, flags);
1040                 tmp = skb_queue_len(&pending);
1041                 filtered += tmp - count;
1042                 count = tmp;
1043
1044                 spin_lock_irqsave(&sta->ps_tx_buf[ac].lock, flags);
1045                 skb_queue_splice_tail_init(&sta->ps_tx_buf[ac], &pending);
1046                 spin_unlock_irqrestore(&sta->ps_tx_buf[ac].lock, flags);
1047                 tmp = skb_queue_len(&pending);
1048                 buffered += tmp - count;
1049         }
1050
1051         ieee80211_add_pending_skbs_fn(local, &pending, clear_sta_ps_flags, sta);
1052
1053         local->total_ps_buffered -= buffered;
1054
1055         sta_info_recalc_tim(sta);
1056
1057         ps_dbg(sdata,
1058                "STA %pM aid %d sending %d filtered/%d PS frames since STA not sleeping anymore\n",
1059                sta->sta.addr, sta->sta.aid, filtered, buffered);
1060 }
1061
1062 static void ieee80211_send_null_response(struct ieee80211_sub_if_data *sdata,
1063                                          struct sta_info *sta, int tid,
1064                                          enum ieee80211_frame_release_type reason)
1065 {
1066         struct ieee80211_local *local = sdata->local;
1067         struct ieee80211_qos_hdr *nullfunc;
1068         struct sk_buff *skb;
1069         int size = sizeof(*nullfunc);
1070         __le16 fc;
1071         bool qos = test_sta_flag(sta, WLAN_STA_WME);
1072         struct ieee80211_tx_info *info;
1073         struct ieee80211_chanctx_conf *chanctx_conf;
1074
1075         if (qos) {
1076                 fc = cpu_to_le16(IEEE80211_FTYPE_DATA |
1077                                  IEEE80211_STYPE_QOS_NULLFUNC |
1078                                  IEEE80211_FCTL_FROMDS);
1079         } else {
1080                 size -= 2;
1081                 fc = cpu_to_le16(IEEE80211_FTYPE_DATA |
1082                                  IEEE80211_STYPE_NULLFUNC |
1083                                  IEEE80211_FCTL_FROMDS);
1084         }
1085
1086         skb = dev_alloc_skb(local->hw.extra_tx_headroom + size);
1087         if (!skb)
1088                 return;
1089
1090         skb_reserve(skb, local->hw.extra_tx_headroom);
1091
1092         nullfunc = (void *) skb_put(skb, size);
1093         nullfunc->frame_control = fc;
1094         nullfunc->duration_id = 0;
1095         memcpy(nullfunc->addr1, sta->sta.addr, ETH_ALEN);
1096         memcpy(nullfunc->addr2, sdata->vif.addr, ETH_ALEN);
1097         memcpy(nullfunc->addr3, sdata->vif.addr, ETH_ALEN);
1098
1099         skb->priority = tid;
1100         skb_set_queue_mapping(skb, ieee802_1d_to_ac[tid]);
1101         if (qos) {
1102                 nullfunc->qos_ctrl = cpu_to_le16(tid);
1103
1104                 if (reason == IEEE80211_FRAME_RELEASE_UAPSD)
1105                         nullfunc->qos_ctrl |=
1106                                 cpu_to_le16(IEEE80211_QOS_CTL_EOSP);
1107         }
1108
1109         info = IEEE80211_SKB_CB(skb);
1110
1111         /*
1112          * Tell TX path to send this frame even though the
1113          * STA may still remain is PS mode after this frame
1114          * exchange. Also set EOSP to indicate this packet
1115          * ends the poll/service period.
1116          */
1117         info->flags |= IEEE80211_TX_CTL_NO_PS_BUFFER |
1118                        IEEE80211_TX_STATUS_EOSP |
1119                        IEEE80211_TX_CTL_REQ_TX_STATUS;
1120
1121         drv_allow_buffered_frames(local, sta, BIT(tid), 1, reason, false);
1122
1123         skb->dev = sdata->dev;
1124
1125         rcu_read_lock();
1126         chanctx_conf = rcu_dereference(sdata->vif.chanctx_conf);
1127         if (WARN_ON(!chanctx_conf)) {
1128                 rcu_read_unlock();
1129                 kfree_skb(skb);
1130                 return;
1131         }
1132
1133         ieee80211_xmit(sdata, skb, chanctx_conf->def.chan->band);
1134         rcu_read_unlock();
1135 }
1136
1137 static void
1138 ieee80211_sta_ps_deliver_response(struct sta_info *sta,
1139                                   int n_frames, u8 ignored_acs,
1140                                   enum ieee80211_frame_release_type reason)
1141 {
1142         struct ieee80211_sub_if_data *sdata = sta->sdata;
1143         struct ieee80211_local *local = sdata->local;
1144         bool found = false;
1145         bool more_data = false;
1146         int ac;
1147         unsigned long driver_release_tids = 0;
1148         struct sk_buff_head frames;
1149
1150         /* Service or PS-Poll period starts */
1151         set_sta_flag(sta, WLAN_STA_SP);
1152
1153         __skb_queue_head_init(&frames);
1154
1155         /*
1156          * Get response frame(s) and more data bit for it.
1157          */
1158         for (ac = 0; ac < IEEE80211_NUM_ACS; ac++) {
1159                 unsigned long tids;
1160
1161                 if (ignored_acs & BIT(ac))
1162                         continue;
1163
1164                 tids = ieee80211_tids_for_ac(ac);
1165
1166                 if (!found) {
1167                         driver_release_tids = sta->driver_buffered_tids & tids;
1168                         if (driver_release_tids) {
1169                                 found = true;
1170                         } else {
1171                                 struct sk_buff *skb;
1172
1173                                 while (n_frames > 0) {
1174                                         skb = skb_dequeue(&sta->tx_filtered[ac]);
1175                                         if (!skb) {
1176                                                 skb = skb_dequeue(
1177                                                         &sta->ps_tx_buf[ac]);
1178                                                 if (skb)
1179                                                         local->total_ps_buffered--;
1180                                         }
1181                                         if (!skb)
1182                                                 break;
1183                                         n_frames--;
1184                                         found = true;
1185                                         __skb_queue_tail(&frames, skb);
1186                                 }
1187                         }
1188
1189                         /*
1190                          * If the driver has data on more than one TID then
1191                          * certainly there's more data if we release just a
1192                          * single frame now (from a single TID).
1193                          */
1194                         if (reason == IEEE80211_FRAME_RELEASE_PSPOLL &&
1195                             hweight16(driver_release_tids) > 1) {
1196                                 more_data = true;
1197                                 driver_release_tids =
1198                                         BIT(ffs(driver_release_tids) - 1);
1199                                 break;
1200                         }
1201                 }
1202
1203                 if (!skb_queue_empty(&sta->tx_filtered[ac]) ||
1204                     !skb_queue_empty(&sta->ps_tx_buf[ac])) {
1205                         more_data = true;
1206                         break;
1207                 }
1208         }
1209
1210         if (!found) {
1211                 int tid;
1212
1213                 /*
1214                  * For PS-Poll, this can only happen due to a race condition
1215                  * when we set the TIM bit and the station notices it, but
1216                  * before it can poll for the frame we expire it.
1217                  *
1218                  * For uAPSD, this is said in the standard (11.2.1.5 h):
1219                  *      At each unscheduled SP for a non-AP STA, the AP shall
1220                  *      attempt to transmit at least one MSDU or MMPDU, but no
1221                  *      more than the value specified in the Max SP Length field
1222                  *      in the QoS Capability element from delivery-enabled ACs,
1223                  *      that are destined for the non-AP STA.
1224                  *
1225                  * Since we have no other MSDU/MMPDU, transmit a QoS null frame.
1226                  */
1227
1228                 /* This will evaluate to 1, 3, 5 or 7. */
1229                 tid = 7 - ((ffs(~ignored_acs) - 1) << 1);
1230
1231                 ieee80211_send_null_response(sdata, sta, tid, reason);
1232                 return;
1233         }
1234
1235         if (!driver_release_tids) {
1236                 struct sk_buff_head pending;
1237                 struct sk_buff *skb;
1238                 int num = 0;
1239                 u16 tids = 0;
1240
1241                 skb_queue_head_init(&pending);
1242
1243                 while ((skb = __skb_dequeue(&frames))) {
1244                         struct ieee80211_tx_info *info = IEEE80211_SKB_CB(skb);
1245                         struct ieee80211_hdr *hdr = (void *) skb->data;
1246                         u8 *qoshdr = NULL;
1247
1248                         num++;
1249
1250                         /*
1251                          * Tell TX path to send this frame even though the
1252                          * STA may still remain is PS mode after this frame
1253                          * exchange.
1254                          */
1255                         info->flags |= IEEE80211_TX_CTL_NO_PS_BUFFER;
1256
1257                         /*
1258                          * Use MoreData flag to indicate whether there are
1259                          * more buffered frames for this STA
1260                          */
1261                         if (more_data || !skb_queue_empty(&frames))
1262                                 hdr->frame_control |=
1263                                         cpu_to_le16(IEEE80211_FCTL_MOREDATA);
1264                         else
1265                                 hdr->frame_control &=
1266                                         cpu_to_le16(~IEEE80211_FCTL_MOREDATA);
1267
1268                         if (ieee80211_is_data_qos(hdr->frame_control) ||
1269                             ieee80211_is_qos_nullfunc(hdr->frame_control))
1270                                 qoshdr = ieee80211_get_qos_ctl(hdr);
1271
1272                         /* end service period after last frame */
1273                         if (skb_queue_empty(&frames)) {
1274                                 if (reason == IEEE80211_FRAME_RELEASE_UAPSD &&
1275                                     qoshdr)
1276                                         *qoshdr |= IEEE80211_QOS_CTL_EOSP;
1277
1278                                 info->flags |= IEEE80211_TX_STATUS_EOSP |
1279                                                IEEE80211_TX_CTL_REQ_TX_STATUS;
1280                         }
1281
1282                         if (qoshdr)
1283                                 tids |= BIT(*qoshdr & IEEE80211_QOS_CTL_TID_MASK);
1284                         else
1285                                 tids |= BIT(0);
1286
1287                         __skb_queue_tail(&pending, skb);
1288                 }
1289
1290                 drv_allow_buffered_frames(local, sta, tids, num,
1291                                           reason, more_data);
1292
1293                 ieee80211_add_pending_skbs(local, &pending);
1294
1295                 sta_info_recalc_tim(sta);
1296         } else {
1297                 /*
1298                  * We need to release a frame that is buffered somewhere in the
1299                  * driver ... it'll have to handle that.
1300                  * Note that, as per the comment above, it'll also have to see
1301                  * if there is more than just one frame on the specific TID that
1302                  * we're releasing from, and it needs to set the more-data bit
1303                  * accordingly if we tell it that there's no more data. If we do
1304                  * tell it there's more data, then of course the more-data bit
1305                  * needs to be set anyway.
1306                  */
1307                 drv_release_buffered_frames(local, sta, driver_release_tids,
1308                                             n_frames, reason, more_data);
1309
1310                 /*
1311                  * Note that we don't recalculate the TIM bit here as it would
1312                  * most likely have no effect at all unless the driver told us
1313                  * that the TID became empty before returning here from the
1314                  * release function.
1315                  * Either way, however, when the driver tells us that the TID
1316                  * became empty we'll do the TIM recalculation.
1317                  */
1318         }
1319 }
1320
1321 void ieee80211_sta_ps_deliver_poll_response(struct sta_info *sta)
1322 {
1323         u8 ignore_for_response = sta->sta.uapsd_queues;
1324
1325         /*
1326          * If all ACs are delivery-enabled then we should reply
1327          * from any of them, if only some are enabled we reply
1328          * only from the non-enabled ones.
1329          */
1330         if (ignore_for_response == BIT(IEEE80211_NUM_ACS) - 1)
1331                 ignore_for_response = 0;
1332
1333         ieee80211_sta_ps_deliver_response(sta, 1, ignore_for_response,
1334                                           IEEE80211_FRAME_RELEASE_PSPOLL);
1335 }
1336
1337 void ieee80211_sta_ps_deliver_uapsd(struct sta_info *sta)
1338 {
1339         int n_frames = sta->sta.max_sp;
1340         u8 delivery_enabled = sta->sta.uapsd_queues;
1341
1342         /*
1343          * If we ever grow support for TSPEC this might happen if
1344          * the TSPEC update from hostapd comes in between a trigger
1345          * frame setting WLAN_STA_UAPSD in the RX path and this
1346          * actually getting called.
1347          */
1348         if (!delivery_enabled)
1349                 return;
1350
1351         switch (sta->sta.max_sp) {
1352         case 1:
1353                 n_frames = 2;
1354                 break;
1355         case 2:
1356                 n_frames = 4;
1357                 break;
1358         case 3:
1359                 n_frames = 6;
1360                 break;
1361         case 0:
1362                 /* XXX: what is a good value? */
1363                 n_frames = 8;
1364                 break;
1365         }
1366
1367         ieee80211_sta_ps_deliver_response(sta, n_frames, ~delivery_enabled,
1368                                           IEEE80211_FRAME_RELEASE_UAPSD);
1369 }
1370
1371 void ieee80211_sta_block_awake(struct ieee80211_hw *hw,
1372                                struct ieee80211_sta *pubsta, bool block)
1373 {
1374         struct sta_info *sta = container_of(pubsta, struct sta_info, sta);
1375
1376         trace_api_sta_block_awake(sta->local, pubsta, block);
1377
1378         if (block)
1379                 set_sta_flag(sta, WLAN_STA_PS_DRIVER);
1380         else if (test_sta_flag(sta, WLAN_STA_PS_DRIVER))
1381                 ieee80211_queue_work(hw, &sta->drv_unblock_wk);
1382 }
1383 EXPORT_SYMBOL(ieee80211_sta_block_awake);
1384
1385 void ieee80211_sta_eosp_irqsafe(struct ieee80211_sta *pubsta)
1386 {
1387         struct sta_info *sta = container_of(pubsta, struct sta_info, sta);
1388         struct ieee80211_local *local = sta->local;
1389         struct sk_buff *skb;
1390         struct skb_eosp_msg_data *data;
1391
1392         trace_api_eosp(local, pubsta);
1393
1394         skb = alloc_skb(0, GFP_ATOMIC);
1395         if (!skb) {
1396                 /* too bad ... but race is better than loss */
1397                 clear_sta_flag(sta, WLAN_STA_SP);
1398                 return;
1399         }
1400
1401         data = (void *)skb->cb;
1402         memcpy(data->sta, pubsta->addr, ETH_ALEN);
1403         memcpy(data->iface, sta->sdata->vif.addr, ETH_ALEN);
1404         skb->pkt_type = IEEE80211_EOSP_MSG;
1405         skb_queue_tail(&local->skb_queue, skb);
1406         tasklet_schedule(&local->tasklet);
1407 }
1408 EXPORT_SYMBOL(ieee80211_sta_eosp_irqsafe);
1409
1410 void ieee80211_sta_set_buffered(struct ieee80211_sta *pubsta,
1411                                 u8 tid, bool buffered)
1412 {
1413         struct sta_info *sta = container_of(pubsta, struct sta_info, sta);
1414
1415         if (WARN_ON(tid >= IEEE80211_NUM_TIDS))
1416                 return;
1417
1418         if (buffered)
1419                 set_bit(tid, &sta->driver_buffered_tids);
1420         else
1421                 clear_bit(tid, &sta->driver_buffered_tids);
1422
1423         sta_info_recalc_tim(sta);
1424 }
1425 EXPORT_SYMBOL(ieee80211_sta_set_buffered);
1426
1427 int sta_info_move_state(struct sta_info *sta,
1428                         enum ieee80211_sta_state new_state)
1429 {
1430         might_sleep();
1431
1432         if (sta->sta_state == new_state)
1433                 return 0;
1434
1435         /* check allowed transitions first */
1436
1437         switch (new_state) {
1438         case IEEE80211_STA_NONE:
1439                 if (sta->sta_state != IEEE80211_STA_AUTH)
1440                         return -EINVAL;
1441                 break;
1442         case IEEE80211_STA_AUTH:
1443                 if (sta->sta_state != IEEE80211_STA_NONE &&
1444                     sta->sta_state != IEEE80211_STA_ASSOC)
1445                         return -EINVAL;
1446                 break;
1447         case IEEE80211_STA_ASSOC:
1448                 if (sta->sta_state != IEEE80211_STA_AUTH &&
1449                     sta->sta_state != IEEE80211_STA_AUTHORIZED)
1450                         return -EINVAL;
1451                 break;
1452         case IEEE80211_STA_AUTHORIZED:
1453                 if (sta->sta_state != IEEE80211_STA_ASSOC)
1454                         return -EINVAL;
1455                 break;
1456         default:
1457                 WARN(1, "invalid state %d", new_state);
1458                 return -EINVAL;
1459         }
1460
1461         sta_dbg(sta->sdata, "moving STA %pM to state %d\n",
1462                 sta->sta.addr, new_state);
1463
1464         /*
1465          * notify the driver before the actual changes so it can
1466          * fail the transition
1467          */
1468         if (test_sta_flag(sta, WLAN_STA_INSERTED)) {
1469                 int err = drv_sta_state(sta->local, sta->sdata, sta,
1470                                         sta->sta_state, new_state);
1471                 if (err)
1472                         return err;
1473         }
1474
1475         /* reflect the change in all state variables */
1476
1477         switch (new_state) {
1478         case IEEE80211_STA_NONE:
1479                 if (sta->sta_state == IEEE80211_STA_AUTH)
1480                         clear_bit(WLAN_STA_AUTH, &sta->_flags);
1481                 break;
1482         case IEEE80211_STA_AUTH:
1483                 if (sta->sta_state == IEEE80211_STA_NONE)
1484                         set_bit(WLAN_STA_AUTH, &sta->_flags);
1485                 else if (sta->sta_state == IEEE80211_STA_ASSOC)
1486                         clear_bit(WLAN_STA_ASSOC, &sta->_flags);
1487                 break;
1488         case IEEE80211_STA_ASSOC:
1489                 if (sta->sta_state == IEEE80211_STA_AUTH) {
1490                         set_bit(WLAN_STA_ASSOC, &sta->_flags);
1491                 } else if (sta->sta_state == IEEE80211_STA_AUTHORIZED) {
1492                         if (sta->sdata->vif.type == NL80211_IFTYPE_AP ||
1493                             (sta->sdata->vif.type == NL80211_IFTYPE_AP_VLAN &&
1494                              !sta->sdata->u.vlan.sta))
1495                                 atomic_dec(&sta->sdata->bss->num_mcast_sta);
1496                         clear_bit(WLAN_STA_AUTHORIZED, &sta->_flags);
1497                 }
1498                 break;
1499         case IEEE80211_STA_AUTHORIZED:
1500                 if (sta->sta_state == IEEE80211_STA_ASSOC) {
1501                         if (sta->sdata->vif.type == NL80211_IFTYPE_AP ||
1502                             (sta->sdata->vif.type == NL80211_IFTYPE_AP_VLAN &&
1503                              !sta->sdata->u.vlan.sta))
1504                                 atomic_inc(&sta->sdata->bss->num_mcast_sta);
1505                         set_bit(WLAN_STA_AUTHORIZED, &sta->_flags);
1506                 }
1507                 break;
1508         default:
1509                 break;
1510         }
1511
1512         sta->sta_state = new_state;
1513
1514         return 0;
1515 }