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         bool indicate_tim = false;
 575         u8 ignore_for_tim = sta->sta.uapsd_queues;
 576         int ac;
 577         u16 id;
 578
 579         if (sta->sdata->vif.type == NL80211_IFTYPE_AP ||
 580             sta->sdata->vif.type == NL80211_IFTYPE_AP_VLAN) {
 581                 if (WARN_ON_ONCE(!sta->sdata->bss))
 582                         return;
 583
 584                 ps = &sta->sdata->bss->ps;
 585                 id = sta->sta.aid;
 586 #ifdef CONFIG_MAC80211_MESH
 587         } else if (ieee80211_vif_is_mesh(&sta->sdata->vif)) {
 588                 ps = &sta->sdata->u.mesh.ps;
 589                 /* TIM map only for PLID <= IEEE80211_MAX_AID */
 590                 id = le16_to_cpu(sta->plid) % IEEE80211_MAX_AID;
 591 #endif
 592         } else {
 593                 return;
 594         }
 595
 596         /* No need to do anything if the driver does all */
 597         if (local->hw.flags & IEEE80211_HW_AP_LINK_PS)
 598                 return;
 599
 600         if (sta->dead)
 601                 goto done;
 602
 603         /*
 604          * If all ACs are delivery-enabled then we should build
 605          * the TIM bit for all ACs anyway; if only some are then
 606          * we ignore those and build the TIM bit using only the
 607          * non-enabled ones.
 608          */
 609         if (ignore_for_tim == BIT(IEEE80211_NUM_ACS) - 1)
 610                 ignore_for_tim = 0;
 611
 612         for (ac = 0; ac < IEEE80211_NUM_ACS; ac++) {
 613                 unsigned long tids;
 614
 615                 if (ignore_for_tim & BIT(ac))
 616                         continue;
 617
 618                 indicate_tim |= !skb_queue_empty(&sta->tx_filtered[ac]) ||
 619                                 !skb_queue_empty(&sta->ps_tx_buf[ac]);
 620                 if (indicate_tim)
 621                         break;
 622
 623                 tids = ieee80211_tids_for_ac(ac);
 624
 625                 indicate_tim |=
 626                         sta->driver_buffered_tids & tids;
 627         }
 628
 629  done:
 630         spin_lock_bh(&local->tim_lock);
 631
 632         if (indicate_tim)
 633                 __bss_tim_set(ps->tim, id);
 634         else
 635                 __bss_tim_clear(ps->tim, id);
 636
 637         if (local->ops->set_tim) {
 638                 local->tim_in_locked_section = true;
 639                 drv_set_tim(local, &sta->sta, indicate_tim);
 640                 local->tim_in_locked_section = false;
 641         }
 642
 643         spin_unlock_bh(&local->tim_lock);
 644 }
 645
 646 static bool sta_info_buffer_expired(struct sta_info *sta, struct sk_buff *skb)
 647 {
 648         struct ieee80211_tx_info *info;
 649         int timeout;
 650
 651         if (!skb)
 652                 return false;
 653
 654         info = IEEE80211_SKB_CB(skb);
 655
 656         /* Timeout: (2 * listen_interval * beacon_int * 1024 / 1000000) sec */
 657         timeout = (sta->listen_interval *
 658                    sta->sdata->vif.bss_conf.beacon_int *
 659                    32 / 15625) * HZ;
 660         if (timeout < STA_TX_BUFFER_EXPIRE)
 661                 timeout = STA_TX_BUFFER_EXPIRE;
 662         return time_after(jiffies, info->control.jiffies + timeout);
 663 }
 664
 665
 666 static bool sta_info_cleanup_expire_buffered_ac(struct ieee80211_local *local,
 667                                                 struct sta_info *sta, int ac)
 668 {
 669         unsigned long flags;
 670         struct sk_buff *skb;
 671
 672         /*
 673          * First check for frames that should expire on the filtered
 674          * queue. Frames here were rejected by the driver and are on
 675          * a separate queue to avoid reordering with normal PS-buffered
 676          * frames. They also aren't accounted for right now in the
 677          * total_ps_buffered counter.
 678          */
 679         for (;;) {
 680                 spin_lock_irqsave(&sta->tx_filtered[ac].lock, flags);
 681                 skb = skb_peek(&sta->tx_filtered[ac]);
 682                 if (sta_info_buffer_expired(sta, skb))
 683                         skb = __skb_dequeue(&sta->tx_filtered[ac]);
 684                 else
 685                         skb = NULL;
 686                 spin_unlock_irqrestore(&sta->tx_filtered[ac].lock, flags);
 687
 688                 /*
 689                  * Frames are queued in order, so if this one
 690                  * hasn't expired yet we can stop testing. If
 691                  * we actually reached the end of the queue we
 692                  * also need to stop, of course.
 693                  */
 694                 if (!skb)
 695                         break;
 696                 ieee80211_free_txskb(&local->hw, skb);
 697         }
 698
 699         /*
 700          * Now also check the normal PS-buffered queue, this will
 701          * only find something if the filtered queue was emptied
 702          * since the filtered frames are all before the normal PS
 703          * buffered frames.
 704          */
 705         for (;;) {
 706                 spin_lock_irqsave(&sta->ps_tx_buf[ac].lock, flags);
 707                 skb = skb_peek(&sta->ps_tx_buf[ac]);
 708                 if (sta_info_buffer_expired(sta, skb))
 709                         skb = __skb_dequeue(&sta->ps_tx_buf[ac]);
 710                 else
 711                         skb = NULL;
 712                 spin_unlock_irqrestore(&sta->ps_tx_buf[ac].lock, flags);
 713
 714                 /*
 715                  * frames are queued in order, so if this one
 716                  * hasn't expired yet (or we reached the end of
 717                  * the queue) we can stop testing
 718                  */
 719                 if (!skb)
 720                         break;
 721
 722                 local->total_ps_buffered--;
 723                 ps_dbg(sta->sdata, "Buffered frame expired (STA %pM)\n",
 724                        sta->sta.addr);
 725                 ieee80211_free_txskb(&local->hw, skb);
 726         }
 727
 728         /*
 729          * Finally, recalculate the TIM bit for this station -- it might
 730          * now be clear because the station was too slow to retrieve its
 731          * frames.
 732          */
 733         sta_info_recalc_tim(sta);
 734
 735         /*
 736          * Return whether there are any frames still buffered, this is
 737          * used to check whether the cleanup timer still needs to run,
 738          * if there are no frames we don't need to rearm the timer.
 739          */
 740         return !(skb_queue_empty(&sta->ps_tx_buf[ac]) &&
 741                  skb_queue_empty(&sta->tx_filtered[ac]));
 742 }
 743
 744 static bool sta_info_cleanup_expire_buffered(struct ieee80211_local *local,
 745                                              struct sta_info *sta)
 746 {
 747         bool have_buffered = false;
 748         int ac;
 749
 750         /* This is only necessary for stations on BSS/MBSS interfaces */
 751         if (!sta->sdata->bss &&
 752             !ieee80211_vif_is_mesh(&sta->sdata->vif))
 753                 return false;
 754
 755         for (ac = 0; ac < IEEE80211_NUM_ACS; ac++)
 756                 have_buffered |=
 757                         sta_info_cleanup_expire_buffered_ac(local, sta, ac);
 758
 759         return have_buffered;
 760 }
 761
 762 int __must_check __sta_info_destroy(struct sta_info *sta)
 763 {
 764         struct ieee80211_local *local;
 765         struct ieee80211_sub_if_data *sdata;
 766         int ret, i;
 767
 768         might_sleep();
 769
 770         if (!sta)
 771                 return -ENOENT;
 772
 773         local = sta->local;
 774         sdata = sta->sdata;
 775
 776         lockdep_assert_held(&local->sta_mtx);
 777
 778         /*
 779          * Before removing the station from the driver and
 780          * rate control, it might still start new aggregation
 781          * sessions -- block that to make sure the tear-down
 782          * will be sufficient.
 783          */
 784         set_sta_flag(sta, WLAN_STA_BLOCK_BA);
 785         ieee80211_sta_tear_down_BA_sessions(sta, AGG_STOP_DESTROY_STA);
 786
 787         ret = sta_info_hash_del(local, sta);
 788         if (ret)
 789                 return ret;
 790
 791         list_del_rcu(&sta->list);
 792
 793         mutex_lock(&local->key_mtx);
 794         for (i = 0; i < NUM_DEFAULT_KEYS; i++)
 795                 __ieee80211_key_free(key_mtx_dereference(local, sta->gtk[i]));
 796         if (sta->ptk)
 797                 __ieee80211_key_free(key_mtx_dereference(local, sta->ptk));
 798         mutex_unlock(&local->key_mtx);
 799
 800         sta->dead = true;
 801
 802         local->num_sta--;
 803         local->sta_generation++;
 804
 805         if (sdata->vif.type == NL80211_IFTYPE_AP_VLAN)
 806                 RCU_INIT_POINTER(sdata->u.vlan.sta, NULL);
 807
 808         while (sta->sta_state > IEEE80211_STA_NONE) {
 809                 ret = sta_info_move_state(sta, sta->sta_state - 1);
 810                 if (ret) {
 811                         WARN_ON_ONCE(1);
 812                         break;
 813                 }
 814         }
 815
 816         if (sta->uploaded) {
 817                 ret = drv_sta_state(local, sdata, sta, IEEE80211_STA_NONE,
 818                                     IEEE80211_STA_NOTEXIST);
 819                 WARN_ON_ONCE(ret != 0);
 820         }
 821
 822         sta_dbg(sdata, "Removed STA %pM\n", sta->sta.addr);
 823
 824         cfg80211_del_sta(sdata->dev, sta->sta.addr, GFP_KERNEL);
 825
 826         rate_control_remove_sta_debugfs(sta);
 827         ieee80211_sta_debugfs_remove(sta);
 828
 829         call_rcu(&sta->rcu_head, free_sta_rcu);
 830
 831         return 0;
 832 }
 833
 834 int sta_info_destroy_addr(struct ieee80211_sub_if_data *sdata, const u8 *addr)
 835 {
 836         struct sta_info *sta;
 837         int ret;
 838
 839         mutex_lock(&sdata->local->sta_mtx);
 840         sta = sta_info_get(sdata, addr);
 841         ret = __sta_info_destroy(sta);
 842         mutex_unlock(&sdata->local->sta_mtx);
 843
 844         return ret;
 845 }
 846
 847 int sta_info_destroy_addr_bss(struct ieee80211_sub_if_data *sdata,
 848                               const u8 *addr)
 849 {
 850         struct sta_info *sta;
 851         int ret;
 852
 853         mutex_lock(&sdata->local->sta_mtx);
 854         sta = sta_info_get_bss(sdata, addr);
 855         ret = __sta_info_destroy(sta);
 856         mutex_unlock(&sdata->local->sta_mtx);
 857
 858         return ret;
 859 }
 860
 861 static void sta_info_cleanup(unsigned long data)
 862 {
 863         struct ieee80211_local *local = (struct ieee80211_local *) data;
 864         struct sta_info *sta;
 865         bool timer_needed = false;
 866
 867         rcu_read_lock();
 868         list_for_each_entry_rcu(sta, &local->sta_list, list)
 869                 if (sta_info_cleanup_expire_buffered(local, sta))
 870                         timer_needed = true;
 871         rcu_read_unlock();
 872
 873         if (local->quiescing)
 874                 return;
 875
 876         if (!timer_needed)
 877                 return;
 878
 879         mod_timer(&local->sta_cleanup,
 880                   round_jiffies(jiffies + STA_INFO_CLEANUP_INTERVAL));
 881 }
 882
 883 void sta_info_init(struct ieee80211_local *local)
 884 {
 885         spin_lock_init(&local->tim_lock);
 886         mutex_init(&local->sta_mtx);
 887         INIT_LIST_HEAD(&local->sta_list);
 888
 889         setup_timer(&local->sta_cleanup, sta_info_cleanup,
 890                     (unsigned long)local);
 891 }
 892
 893 void sta_info_stop(struct ieee80211_local *local)
 894 {
 895         del_timer_sync(&local->sta_cleanup);
 896 }
 897
 898
 899 int sta_info_flush_defer(struct ieee80211_sub_if_data *sdata)
 900 {
 901         struct ieee80211_local *local = sdata->local;
 902         struct sta_info *sta, *tmp;
 903         int ret = 0;
 904
 905         might_sleep();
 906
 907         mutex_lock(&local->sta_mtx);
 908         list_for_each_entry_safe(sta, tmp, &local->sta_list, list) {
 909                 if (sdata == sta->sdata) {
 910                         WARN_ON(__sta_info_destroy(sta));
 911                         ret++;
 912                 }
 913         }
 914         mutex_unlock(&local->sta_mtx);
 915
 916         return ret;
 917 }
 918
 919 void sta_info_flush_cleanup(struct ieee80211_sub_if_data *sdata)
 920 {
 921         ieee80211_cleanup_sdata_stas(sdata);
 922         cancel_work_sync(&sdata->cleanup_stations_wk);
 923 }
 924
 925 void ieee80211_sta_expire(struct ieee80211_sub_if_data *sdata,
 926                           unsigned long exp_time)
 927 {
 928         struct ieee80211_local *local = sdata->local;
 929         struct sta_info *sta, *tmp;
 930
 931         mutex_lock(&local->sta_mtx);
 932
 933         list_for_each_entry_safe(sta, tmp, &local->sta_list, list) {
 934                 if (sdata != sta->sdata)
 935                         continue;
 936
 937                 if (time_after(jiffies, sta->last_rx + exp_time)) {
 938                         sta_dbg(sta->sdata, "expiring inactive STA %pM\n",
 939                                 sta->sta.addr);
 940
 941                         if (ieee80211_vif_is_mesh(&sdata->vif) &&
 942                             test_sta_flag(sta, WLAN_STA_PS_STA))
 943                                 atomic_dec(&sdata->u.mesh.ps.num_sta_ps);
 944
 945                         WARN_ON(__sta_info_destroy(sta));
 946                 }
 947         }
 948
 949         mutex_unlock(&local->sta_mtx);
 950 }
 951
 952 struct ieee80211_sta *ieee80211_find_sta_by_ifaddr(struct ieee80211_hw *hw,
 953                                                const u8 *addr,
 954                                                const u8 *localaddr)
 955 {
 956         struct sta_info *sta, *nxt;
 957
 958         /*
 959          * Just return a random station if localaddr is NULL
 960          * ... first in list.
 961          */
 962         for_each_sta_info(hw_to_local(hw), addr, sta, nxt) {
 963                 if (localaddr &&
 964                     !ether_addr_equal(sta->sdata->vif.addr, localaddr))
 965                         continue;
 966                 if (!sta->uploaded)
 967                         return NULL;
 968                 return &sta->sta;
 969         }
 970
 971         return NULL;
 972 }
 973 EXPORT_SYMBOL_GPL(ieee80211_find_sta_by_ifaddr);
 974
 975 struct ieee80211_sta *ieee80211_find_sta(struct ieee80211_vif *vif,
 976                                          const u8 *addr)
 977 {
 978         struct sta_info *sta;
 979
 980         if (!vif)
 981                 return NULL;
 982
 983         sta = sta_info_get_bss(vif_to_sdata(vif), addr);
 984         if (!sta)
 985                 return NULL;
 986
 987         if (!sta->uploaded)
 988                 return NULL;
 989
 990         return &sta->sta;
 991 }
 992 EXPORT_SYMBOL(ieee80211_find_sta);
 993
 994 static void clear_sta_ps_flags(void *_sta)
 995 {
 996         struct sta_info *sta = _sta;
 997         struct ieee80211_sub_if_data *sdata = sta->sdata;
 998         struct ps_data *ps;
 999
1000         if (sdata->vif.type == NL80211_IFTYPE_AP ||
1001             sdata->vif.type == NL80211_IFTYPE_AP_VLAN)
1002                 ps = &sdata->bss->ps;
1003         else if (ieee80211_vif_is_mesh(&sdata->vif))
1004                 ps = &sdata->u.mesh.ps;
1005         else
1006                 return;
1007
1008         clear_sta_flag(sta, WLAN_STA_PS_DRIVER);
1009         if (test_and_clear_sta_flag(sta, WLAN_STA_PS_STA))
1010                 atomic_dec(&ps->num_sta_ps);
1011 }
1012
1013 /* powersave support code */
1014 void ieee80211_sta_ps_deliver_wakeup(struct sta_info *sta)
1015 {
1016         struct ieee80211_sub_if_data *sdata = sta->sdata;
1017         struct ieee80211_local *local = sdata->local;
1018         struct sk_buff_head pending;
1019         int filtered = 0, buffered = 0, ac;
1020         unsigned long flags;
1021
1022         clear_sta_flag(sta, WLAN_STA_SP);
1023
1024         BUILD_BUG_ON(BITS_TO_LONGS(IEEE80211_NUM_TIDS) > 1);
1025         sta->driver_buffered_tids = 0;
1026
1027         if (!(local->hw.flags & IEEE80211_HW_AP_LINK_PS))
1028                 drv_sta_notify(local, sdata, STA_NOTIFY_AWAKE, &sta->sta);
1029
1030         skb_queue_head_init(&pending);
1031
1032         /* Send all buffered frames to the station */
1033         for (ac = 0; ac < IEEE80211_NUM_ACS; ac++) {
1034                 int count = skb_queue_len(&pending), tmp;
1035
1036                 spin_lock_irqsave(&sta->tx_filtered[ac].lock, flags);
1037                 skb_queue_splice_tail_init(&sta->tx_filtered[ac], &pending);
1038                 spin_unlock_irqrestore(&sta->tx_filtered[ac].lock, flags);
1039                 tmp = skb_queue_len(&pending);
1040                 filtered += tmp - count;
1041                 count = tmp;
1042
1043                 spin_lock_irqsave(&sta->ps_tx_buf[ac].lock, flags);
1044                 skb_queue_splice_tail_init(&sta->ps_tx_buf[ac], &pending);
1045                 spin_unlock_irqrestore(&sta->ps_tx_buf[ac].lock, flags);
1046                 tmp = skb_queue_len(&pending);
1047                 buffered += tmp - count;
1048         }
1049
1050         ieee80211_add_pending_skbs_fn(local, &pending, clear_sta_ps_flags, sta);
1051
1052         local->total_ps_buffered -= buffered;
1053
1054         sta_info_recalc_tim(sta);
1055
1056         ps_dbg(sdata,
1057                "STA %pM aid %d sending %d filtered/%d PS frames since STA not sleeping anymore\n",
1058                sta->sta.addr, sta->sta.aid, filtered, buffered);
1059 }
1060
1061 static void ieee80211_send_null_response(struct ieee80211_sub_if_data *sdata,
1062                                          struct sta_info *sta, int tid,
1063                                          enum ieee80211_frame_release_type reason)
1064 {
1065         struct ieee80211_local *local = sdata->local;
1066         struct ieee80211_qos_hdr *nullfunc;
1067         struct sk_buff *skb;
1068         int size = sizeof(*nullfunc);
1069         __le16 fc;
1070         bool qos = test_sta_flag(sta, WLAN_STA_WME);
1071         struct ieee80211_tx_info *info;
1072         struct ieee80211_chanctx_conf *chanctx_conf;
1073
1074         if (qos) {
1075                 fc = cpu_to_le16(IEEE80211_FTYPE_DATA |
1076                                  IEEE80211_STYPE_QOS_NULLFUNC |
1077                                  IEEE80211_FCTL_FROMDS);
1078         } else {
1079                 size -= 2;
1080                 fc = cpu_to_le16(IEEE80211_FTYPE_DATA |
1081                                  IEEE80211_STYPE_NULLFUNC |
1082                                  IEEE80211_FCTL_FROMDS);
1083         }
1084
1085         skb = dev_alloc_skb(local->hw.extra_tx_headroom + size);
1086         if (!skb)
1087                 return;
1088
1089         skb_reserve(skb, local->hw.extra_tx_headroom);
1090
1091         nullfunc = (void *) skb_put(skb, size);
1092         nullfunc->frame_control = fc;
1093         nullfunc->duration_id = 0;
1094         memcpy(nullfunc->addr1, sta->sta.addr, ETH_ALEN);
1095         memcpy(nullfunc->addr2, sdata->vif.addr, ETH_ALEN);
1096         memcpy(nullfunc->addr3, sdata->vif.addr, ETH_ALEN);
1097
1098         skb->priority = tid;
1099         skb_set_queue_mapping(skb, ieee802_1d_to_ac[tid]);
1100         if (qos) {
1101                 nullfunc->qos_ctrl = cpu_to_le16(tid);
1102
1103                 if (reason == IEEE80211_FRAME_RELEASE_UAPSD)
1104                         nullfunc->qos_ctrl |=
1105                                 cpu_to_le16(IEEE80211_QOS_CTL_EOSP);
1106         }
1107
1108         info = IEEE80211_SKB_CB(skb);
1109
1110         /*
1111          * Tell TX path to send this frame even though the
1112          * STA may still remain is PS mode after this frame
1113          * exchange. Also set EOSP to indicate this packet
1114          * ends the poll/service period.
1115          */
1116         info->flags |= IEEE80211_TX_CTL_NO_PS_BUFFER |
1117                        IEEE80211_TX_STATUS_EOSP |
1118                        IEEE80211_TX_CTL_REQ_TX_STATUS;
1119
1120         drv_allow_buffered_frames(local, sta, BIT(tid), 1, reason, false);
1121
1122         skb->dev = sdata->dev;
1123
1124         rcu_read_lock();
1125         chanctx_conf = rcu_dereference(sdata->vif.chanctx_conf);
1126         if (WARN_ON(!chanctx_conf)) {
1127                 rcu_read_unlock();
1128                 kfree_skb(skb);
1129                 return;
1130         }
1131
1132         ieee80211_xmit(sdata, skb, chanctx_conf->def.chan->band);
1133         rcu_read_unlock();
1134 }
1135
1136 static void
1137 ieee80211_sta_ps_deliver_response(struct sta_info *sta,
1138                                   int n_frames, u8 ignored_acs,
1139                                   enum ieee80211_frame_release_type reason)
1140 {
1141         struct ieee80211_sub_if_data *sdata = sta->sdata;
1142         struct ieee80211_local *local = sdata->local;
1143         bool found = false;
1144         bool more_data = false;
1145         int ac;
1146         unsigned long driver_release_tids = 0;
1147         struct sk_buff_head frames;
1148
1149         /* Service or PS-Poll period starts */
1150         set_sta_flag(sta, WLAN_STA_SP);
1151
1152         __skb_queue_head_init(&frames);
1153
1154         /*
1155          * Get response frame(s) and more data bit for it.
1156          */
1157         for (ac = 0; ac < IEEE80211_NUM_ACS; ac++) {
1158                 unsigned long tids;
1159
1160                 if (ignored_acs & BIT(ac))
1161                         continue;
1162
1163                 tids = ieee80211_tids_for_ac(ac);
1164
1165                 if (!found) {
1166                         driver_release_tids = sta->driver_buffered_tids & tids;
1167                         if (driver_release_tids) {
1168                                 found = true;
1169                         } else {
1170                                 struct sk_buff *skb;
1171
1172                                 while (n_frames > 0) {
1173                                         skb = skb_dequeue(&sta->tx_filtered[ac]);
1174                                         if (!skb) {
1175                                                 skb = skb_dequeue(
1176                                                         &sta->ps_tx_buf[ac]);
1177                                                 if (skb)
1178                                                         local->total_ps_buffered--;
1179                                         }
1180                                         if (!skb)
1181                                                 break;
1182                                         n_frames--;
1183                                         found = true;
1184                                         __skb_queue_tail(&frames, skb);
1185                                 }
1186                         }
1187
1188                         /*
1189                          * If the driver has data on more than one TID then
1190                          * certainly there's more data if we release just a
1191                          * single frame now (from a single TID).
1192                          */
1193                         if (reason == IEEE80211_FRAME_RELEASE_PSPOLL &&
1194                             hweight16(driver_release_tids) > 1) {
1195                                 more_data = true;
1196                                 driver_release_tids =
1197                                         BIT(ffs(driver_release_tids) - 1);
1198                                 break;
1199                         }
1200                 }
1201
1202                 if (!skb_queue_empty(&sta->tx_filtered[ac]) ||
1203                     !skb_queue_empty(&sta->ps_tx_buf[ac])) {
1204                         more_data = true;
1205                         break;
1206                 }
1207         }
1208
1209         if (!found) {
1210                 int tid;
1211
1212                 /*
1213                  * For PS-Poll, this can only happen due to a race condition
1214                  * when we set the TIM bit and the station notices it, but
1215                  * before it can poll for the frame we expire it.
1216                  *
1217                  * For uAPSD, this is said in the standard (11.2.1.5 h):
1218                  *      At each unscheduled SP for a non-AP STA, the AP shall
1219                  *      attempt to transmit at least one MSDU or MMPDU, but no
1220                  *      more than the value specified in the Max SP Length field
1221                  *      in the QoS Capability element from delivery-enabled ACs,
1222                  *      that are destined for the non-AP STA.
1223                  *
1224                  * Since we have no other MSDU/MMPDU, transmit a QoS null frame.
1225                  */
1226
1227                 /* This will evaluate to 1, 3, 5 or 7. */
1228                 tid = 7 - ((ffs(~ignored_acs) - 1) << 1);
1229
1230                 ieee80211_send_null_response(sdata, sta, tid, reason);
1231                 return;
1232         }
1233
1234         if (!driver_release_tids) {
1235                 struct sk_buff_head pending;
1236                 struct sk_buff *skb;
1237                 int num = 0;
1238                 u16 tids = 0;
1239
1240                 skb_queue_head_init(&pending);
1241
1242                 while ((skb = __skb_dequeue(&frames))) {
1243                         struct ieee80211_tx_info *info = IEEE80211_SKB_CB(skb);
1244                         struct ieee80211_hdr *hdr = (void *) skb->data;
1245                         u8 *qoshdr = NULL;
1246
1247                         num++;
1248
1249                         /*
1250                          * Tell TX path to send this frame even though the
1251                          * STA may still remain is PS mode after this frame
1252                          * exchange.
1253                          */
1254                         info->flags |= IEEE80211_TX_CTL_NO_PS_BUFFER;
1255
1256                         /*
1257                          * Use MoreData flag to indicate whether there are
1258                          * more buffered frames for this STA
1259                          */
1260                         if (more_data || !skb_queue_empty(&frames))
1261                                 hdr->frame_control |=
1262                                         cpu_to_le16(IEEE80211_FCTL_MOREDATA);
1263                         else
1264                                 hdr->frame_control &=
1265                                         cpu_to_le16(~IEEE80211_FCTL_MOREDATA);
1266
1267                         if (ieee80211_is_data_qos(hdr->frame_control) ||
1268                             ieee80211_is_qos_nullfunc(hdr->frame_control))
1269                                 qoshdr = ieee80211_get_qos_ctl(hdr);
1270
1271                         /* end service period after last frame */
1272                         if (skb_queue_empty(&frames)) {
1273                                 if (reason == IEEE80211_FRAME_RELEASE_UAPSD &&
1274                                     qoshdr)
1275                                         *qoshdr |= IEEE80211_QOS_CTL_EOSP;
1276
1277                                 info->flags |= IEEE80211_TX_STATUS_EOSP |
1278                                                IEEE80211_TX_CTL_REQ_TX_STATUS;
1279                         }
1280
1281                         if (qoshdr)
1282                                 tids |= BIT(*qoshdr & IEEE80211_QOS_CTL_TID_MASK);
1283                         else
1284                                 tids |= BIT(0);
1285
1286                         __skb_queue_tail(&pending, skb);
1287                 }
1288
1289                 drv_allow_buffered_frames(local, sta, tids, num,
1290                                           reason, more_data);
1291
1292                 ieee80211_add_pending_skbs(local, &pending);
1293
1294                 sta_info_recalc_tim(sta);
1295         } else {
1296                 /*
1297                  * We need to release a frame that is buffered somewhere in the
1298                  * driver ... it'll have to handle that.
1299                  * Note that, as per the comment above, it'll also have to see
1300                  * if there is more than just one frame on the specific TID that
1301                  * we're releasing from, and it needs to set the more-data bit
1302                  * accordingly if we tell it that there's no more data. If we do
1303                  * tell it there's more data, then of course the more-data bit
1304                  * needs to be set anyway.
1305                  */
1306                 drv_release_buffered_frames(local, sta, driver_release_tids,
1307                                             n_frames, reason, more_data);
1308
1309                 /*
1310                  * Note that we don't recalculate the TIM bit here as it would
1311                  * most likely have no effect at all unless the driver told us
1312                  * that the TID became empty before returning here from the
1313                  * release function.
1314                  * Either way, however, when the driver tells us that the TID
1315                  * became empty we'll do the TIM recalculation.
1316                  */
1317         }
1318 }
1319
1320 void ieee80211_sta_ps_deliver_poll_response(struct sta_info *sta)
1321 {
1322         u8 ignore_for_response = sta->sta.uapsd_queues;
1323
1324         /*
1325          * If all ACs are delivery-enabled then we should reply
1326          * from any of them, if only some are enabled we reply
1327          * only from the non-enabled ones.
1328          */
1329         if (ignore_for_response == BIT(IEEE80211_NUM_ACS) - 1)
1330                 ignore_for_response = 0;
1331
1332         ieee80211_sta_ps_deliver_response(sta, 1, ignore_for_response,
1333                                           IEEE80211_FRAME_RELEASE_PSPOLL);
1334 }
1335
1336 void ieee80211_sta_ps_deliver_uapsd(struct sta_info *sta)
1337 {
1338         int n_frames = sta->sta.max_sp;
1339         u8 delivery_enabled = sta->sta.uapsd_queues;
1340
1341         /*
1342          * If we ever grow support for TSPEC this might happen if
1343          * the TSPEC update from hostapd comes in between a trigger
1344          * frame setting WLAN_STA_UAPSD in the RX path and this
1345          * actually getting called.
1346          */
1347         if (!delivery_enabled)
1348                 return;
1349
1350         switch (sta->sta.max_sp) {
1351         case 1:
1352                 n_frames = 2;
1353                 break;
1354         case 2:
1355                 n_frames = 4;
1356                 break;
1357         case 3:
1358                 n_frames = 6;
1359                 break;
1360         case 0:
1361                 /* XXX: what is a good value? */
1362                 n_frames = 8;
1363                 break;
1364         }
1365
1366         ieee80211_sta_ps_deliver_response(sta, n_frames, ~delivery_enabled,
1367                                           IEEE80211_FRAME_RELEASE_UAPSD);
1368 }
1369
1370 void ieee80211_sta_block_awake(struct ieee80211_hw *hw,
1371                                struct ieee80211_sta *pubsta, bool block)
1372 {
1373         struct sta_info *sta = container_of(pubsta, struct sta_info, sta);
1374
1375         trace_api_sta_block_awake(sta->local, pubsta, block);
1376
1377         if (block)
1378                 set_sta_flag(sta, WLAN_STA_PS_DRIVER);
1379         else if (test_sta_flag(sta, WLAN_STA_PS_DRIVER))
1380                 ieee80211_queue_work(hw, &sta->drv_unblock_wk);
1381 }
1382 EXPORT_SYMBOL(ieee80211_sta_block_awake);
1383
1384 void ieee80211_sta_eosp_irqsafe(struct ieee80211_sta *pubsta)
1385 {
1386         struct sta_info *sta = container_of(pubsta, struct sta_info, sta);
1387         struct ieee80211_local *local = sta->local;
1388         struct sk_buff *skb;
1389         struct skb_eosp_msg_data *data;
1390
1391         trace_api_eosp(local, pubsta);
1392
1393         skb = alloc_skb(0, GFP_ATOMIC);
1394         if (!skb) {
1395                 /* too bad ... but race is better than loss */
1396                 clear_sta_flag(sta, WLAN_STA_SP);
1397                 return;
1398         }
1399
1400         data = (void *)skb->cb;
1401         memcpy(data->sta, pubsta->addr, ETH_ALEN);
1402         memcpy(data->iface, sta->sdata->vif.addr, ETH_ALEN);
1403         skb->pkt_type = IEEE80211_EOSP_MSG;
1404         skb_queue_tail(&local->skb_queue, skb);
1405         tasklet_schedule(&local->tasklet);
1406 }
1407 EXPORT_SYMBOL(ieee80211_sta_eosp_irqsafe);
1408
1409 void ieee80211_sta_set_buffered(struct ieee80211_sta *pubsta,
1410                                 u8 tid, bool buffered)
1411 {
1412         struct sta_info *sta = container_of(pubsta, struct sta_info, sta);
1413
1414         if (WARN_ON(tid >= IEEE80211_NUM_TIDS))
1415                 return;
1416
1417         if (buffered)
1418                 set_bit(tid, &sta->driver_buffered_tids);
1419         else
1420                 clear_bit(tid, &sta->driver_buffered_tids);
1421
1422         sta_info_recalc_tim(sta);
1423 }
1424 EXPORT_SYMBOL(ieee80211_sta_set_buffered);
1425
1426 int sta_info_move_state(struct sta_info *sta,
1427                         enum ieee80211_sta_state new_state)
1428 {
1429         might_sleep();
1430
1431         if (sta->sta_state == new_state)
1432                 return 0;
1433
1434         /* check allowed transitions first */
1435
1436         switch (new_state) {
1437         case IEEE80211_STA_NONE:
1438                 if (sta->sta_state != IEEE80211_STA_AUTH)
1439                         return -EINVAL;
1440                 break;
1441         case IEEE80211_STA_AUTH:
1442                 if (sta->sta_state != IEEE80211_STA_NONE &&
1443                     sta->sta_state != IEEE80211_STA_ASSOC)
1444                         return -EINVAL;
1445                 break;
1446         case IEEE80211_STA_ASSOC:
1447                 if (sta->sta_state != IEEE80211_STA_AUTH &&
1448                     sta->sta_state != IEEE80211_STA_AUTHORIZED)
1449                         return -EINVAL;
1450                 break;
1451         case IEEE80211_STA_AUTHORIZED:
1452                 if (sta->sta_state != IEEE80211_STA_ASSOC)
1453                         return -EINVAL;
1454                 break;
1455         default:
1456                 WARN(1, "invalid state %d", new_state);
1457                 return -EINVAL;
1458         }
1459
1460         sta_dbg(sta->sdata, "moving STA %pM to state %d\n",
1461                 sta->sta.addr, new_state);
1462
1463         /*
1464          * notify the driver before the actual changes so it can
1465          * fail the transition
1466          */
1467         if (test_sta_flag(sta, WLAN_STA_INSERTED)) {
1468                 int err = drv_sta_state(sta->local, sta->sdata, sta,
1469                                         sta->sta_state, new_state);
1470                 if (err)
1471                         return err;
1472         }
1473
1474         /* reflect the change in all state variables */
1475
1476         switch (new_state) {
1477         case IEEE80211_STA_NONE:
1478                 if (sta->sta_state == IEEE80211_STA_AUTH)
1479                         clear_bit(WLAN_STA_AUTH, &sta->_flags);
1480                 break;
1481         case IEEE80211_STA_AUTH:
1482                 if (sta->sta_state == IEEE80211_STA_NONE)
1483                         set_bit(WLAN_STA_AUTH, &sta->_flags);
1484                 else if (sta->sta_state == IEEE80211_STA_ASSOC)
1485                         clear_bit(WLAN_STA_ASSOC, &sta->_flags);
1486                 break;
1487         case IEEE80211_STA_ASSOC:
1488                 if (sta->sta_state == IEEE80211_STA_AUTH) {
1489                         set_bit(WLAN_STA_ASSOC, &sta->_flags);
1490                 } else if (sta->sta_state == IEEE80211_STA_AUTHORIZED) {
1491                         if (sta->sdata->vif.type == NL80211_IFTYPE_AP ||
1492                             (sta->sdata->vif.type == NL80211_IFTYPE_AP_VLAN &&
1493                              !sta->sdata->u.vlan.sta))
1494                                 atomic_dec(&sta->sdata->bss->num_mcast_sta);
1495                         clear_bit(WLAN_STA_AUTHORIZED, &sta->_flags);
1496                 }
1497                 break;
1498         case IEEE80211_STA_AUTHORIZED:
1499                 if (sta->sta_state == IEEE80211_STA_ASSOC) {
1500                         if (sta->sdata->vif.type == NL80211_IFTYPE_AP ||
1501                             (sta->sdata->vif.type == NL80211_IFTYPE_AP_VLAN &&
1502                              !sta->sdata->u.vlan.sta))
1503                                 atomic_inc(&sta->sdata->bss->num_mcast_sta);
1504                         set_bit(WLAN_STA_AUTHORIZED, &sta->_flags);
1505                 }
1506                 break;
1507         default:
1508                 break;
1509         }
1510
1511         sta->sta_state = new_state;
1512
1513         return 0;
1514 }