kernel-wide: replace USHORT_MAX, SHORT_MAX and SHORT_MIN with USHRT_MAX, SHRT_MAX...
[safe/jmp/linux-2.6] / 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/netdevice.h>
13 #include <linux/types.h>
14 #include <linux/slab.h>
15 #include <linux/skbuff.h>
16 #include <linux/if_arp.h>
17 #include <linux/timer.h>
18 #include <linux/rtnetlink.h>
19
20 #include <net/mac80211.h>
21 #include "ieee80211_i.h"
22 #include "driver-ops.h"
23 #include "rate.h"
24 #include "sta_info.h"
25 #include "debugfs_sta.h"
26 #include "mesh.h"
27
28 /**
29  * DOC: STA information lifetime rules
30  *
31  * STA info structures (&struct sta_info) are managed in a hash table
32  * for faster lookup and a list for iteration. They are managed using
33  * RCU, i.e. access to the list and hash table is protected by RCU.
34  *
35  * Upon allocating a STA info structure with sta_info_alloc(), the caller
36  * owns that structure. It must then insert it into the hash table using
37  * either sta_info_insert() or sta_info_insert_rcu(); only in the latter
38  * case (which acquires an rcu read section but must not be called from
39  * within one) will the pointer still be valid after the call. Note that
40  * the caller may not do much with the STA info before inserting it, in
41  * particular, it may not start any mesh peer link management or add
42  * encryption keys.
43  *
44  * When the insertion fails (sta_info_insert()) returns non-zero), the
45  * structure will have been freed by sta_info_insert()!
46  *
47  * Station entries are added by mac80211 when you establish a link with a
48  * peer. This means different things for the different type of interfaces
49  * we support. For a regular station this mean we add the AP sta when we
50  * receive an assocation response from the AP. For IBSS this occurs when
51  * get to know about a peer on the same IBSS. For WDS we add the sta for
52  * the peer imediately upon device open. When using AP mode we add stations
53  * for each respective station upon request from userspace through nl80211.
54  *
55  * In order to remove a STA info structure, various sta_info_destroy_*()
56  * calls are available.
57  *
58  * There is no concept of ownership on a STA entry, each structure is
59  * owned by the global hash table/list until it is removed. All users of
60  * the structure need to be RCU protected so that the structure won't be
61  * freed before they are done using it.
62  */
63
64 /* Caller must hold local->sta_lock */
65 static int sta_info_hash_del(struct ieee80211_local *local,
66                              struct sta_info *sta)
67 {
68         struct sta_info *s;
69
70         s = local->sta_hash[STA_HASH(sta->sta.addr)];
71         if (!s)
72                 return -ENOENT;
73         if (s == sta) {
74                 rcu_assign_pointer(local->sta_hash[STA_HASH(sta->sta.addr)],
75                                    s->hnext);
76                 return 0;
77         }
78
79         while (s->hnext && s->hnext != sta)
80                 s = s->hnext;
81         if (s->hnext) {
82                 rcu_assign_pointer(s->hnext, sta->hnext);
83                 return 0;
84         }
85
86         return -ENOENT;
87 }
88
89 /* protected by RCU */
90 struct sta_info *sta_info_get(struct ieee80211_sub_if_data *sdata,
91                               const u8 *addr)
92 {
93         struct ieee80211_local *local = sdata->local;
94         struct sta_info *sta;
95
96         sta = rcu_dereference_check(local->sta_hash[STA_HASH(addr)],
97                                     rcu_read_lock_held() ||
98                                     lockdep_is_held(&local->sta_lock) ||
99                                     lockdep_is_held(&local->sta_mtx));
100         while (sta) {
101                 if (sta->sdata == sdata &&
102                     memcmp(sta->sta.addr, addr, ETH_ALEN) == 0)
103                         break;
104                 sta = rcu_dereference_check(sta->hnext,
105                                             rcu_read_lock_held() ||
106                                             lockdep_is_held(&local->sta_lock) ||
107                                             lockdep_is_held(&local->sta_mtx));
108         }
109         return sta;
110 }
111
112 /*
113  * Get sta info either from the specified interface
114  * or from one of its vlans
115  */
116 struct sta_info *sta_info_get_bss(struct ieee80211_sub_if_data *sdata,
117                                   const u8 *addr)
118 {
119         struct ieee80211_local *local = sdata->local;
120         struct sta_info *sta;
121
122         sta = rcu_dereference_check(local->sta_hash[STA_HASH(addr)],
123                                     rcu_read_lock_held() ||
124                                     lockdep_is_held(&local->sta_lock) ||
125                                     lockdep_is_held(&local->sta_mtx));
126         while (sta) {
127                 if ((sta->sdata == sdata ||
128                      sta->sdata->bss == sdata->bss) &&
129                     memcmp(sta->sta.addr, addr, ETH_ALEN) == 0)
130                         break;
131                 sta = rcu_dereference_check(sta->hnext,
132                                             rcu_read_lock_held() ||
133                                             lockdep_is_held(&local->sta_lock) ||
134                                             lockdep_is_held(&local->sta_mtx));
135         }
136         return sta;
137 }
138
139 struct sta_info *sta_info_get_by_idx(struct ieee80211_sub_if_data *sdata,
140                                      int idx)
141 {
142         struct ieee80211_local *local = sdata->local;
143         struct sta_info *sta;
144         int i = 0;
145
146         list_for_each_entry_rcu(sta, &local->sta_list, list) {
147                 if (sdata != sta->sdata)
148                         continue;
149                 if (i < idx) {
150                         ++i;
151                         continue;
152                 }
153                 return sta;
154         }
155
156         return NULL;
157 }
158
159 /**
160  * __sta_info_free - internal STA free helper
161  *
162  * @local: pointer to the global information
163  * @sta: STA info to free
164  *
165  * This function must undo everything done by sta_info_alloc()
166  * that may happen before sta_info_insert().
167  */
168 static void __sta_info_free(struct ieee80211_local *local,
169                             struct sta_info *sta)
170 {
171         if (sta->rate_ctrl) {
172                 rate_control_free_sta(sta);
173                 rate_control_put(sta->rate_ctrl);
174         }
175
176 #ifdef CONFIG_MAC80211_VERBOSE_DEBUG
177         printk(KERN_DEBUG "%s: Destroyed STA %pM\n",
178                wiphy_name(local->hw.wiphy), sta->sta.addr);
179 #endif /* CONFIG_MAC80211_VERBOSE_DEBUG */
180
181         kfree(sta);
182 }
183
184 /* Caller must hold local->sta_lock */
185 static void sta_info_hash_add(struct ieee80211_local *local,
186                               struct sta_info *sta)
187 {
188         sta->hnext = local->sta_hash[STA_HASH(sta->sta.addr)];
189         rcu_assign_pointer(local->sta_hash[STA_HASH(sta->sta.addr)], sta);
190 }
191
192 static void sta_unblock(struct work_struct *wk)
193 {
194         struct sta_info *sta;
195
196         sta = container_of(wk, struct sta_info, drv_unblock_wk);
197
198         if (sta->dead)
199                 return;
200
201         if (!test_sta_flags(sta, WLAN_STA_PS_STA))
202                 ieee80211_sta_ps_deliver_wakeup(sta);
203         else if (test_and_clear_sta_flags(sta, WLAN_STA_PSPOLL))
204                 ieee80211_sta_ps_deliver_poll_response(sta);
205 }
206
207 static int sta_prepare_rate_control(struct ieee80211_local *local,
208                                     struct sta_info *sta, gfp_t gfp)
209 {
210         if (local->hw.flags & IEEE80211_HW_HAS_RATE_CONTROL)
211                 return 0;
212
213         sta->rate_ctrl = rate_control_get(local->rate_ctrl);
214         sta->rate_ctrl_priv = rate_control_alloc_sta(sta->rate_ctrl,
215                                                      &sta->sta, gfp);
216         if (!sta->rate_ctrl_priv) {
217                 rate_control_put(sta->rate_ctrl);
218                 return -ENOMEM;
219         }
220
221         return 0;
222 }
223
224 struct sta_info *sta_info_alloc(struct ieee80211_sub_if_data *sdata,
225                                 u8 *addr, gfp_t gfp)
226 {
227         struct ieee80211_local *local = sdata->local;
228         struct sta_info *sta;
229         int i;
230
231         sta = kzalloc(sizeof(*sta) + local->hw.sta_data_size, gfp);
232         if (!sta)
233                 return NULL;
234
235         spin_lock_init(&sta->lock);
236         spin_lock_init(&sta->flaglock);
237         INIT_WORK(&sta->drv_unblock_wk, sta_unblock);
238
239         memcpy(sta->sta.addr, addr, ETH_ALEN);
240         sta->local = local;
241         sta->sdata = sdata;
242
243         if (sta_prepare_rate_control(local, sta, gfp)) {
244                 kfree(sta);
245                 return NULL;
246         }
247
248         for (i = 0; i < STA_TID_NUM; i++) {
249                 /* timer_to_tid must be initialized with identity mapping to
250                  * enable session_timer's data differentiation. refer to
251                  * sta_rx_agg_session_timer_expired for useage */
252                 sta->timer_to_tid[i] = i;
253                 /* tx */
254                 sta->ampdu_mlme.tid_state_tx[i] = HT_AGG_STATE_IDLE;
255                 sta->ampdu_mlme.tid_tx[i] = NULL;
256                 sta->ampdu_mlme.addba_req_num[i] = 0;
257         }
258         skb_queue_head_init(&sta->ps_tx_buf);
259         skb_queue_head_init(&sta->tx_filtered);
260
261         for (i = 0; i < NUM_RX_DATA_QUEUES; i++)
262                 sta->last_seq_ctrl[i] = cpu_to_le16(USHRT_MAX);
263
264 #ifdef CONFIG_MAC80211_VERBOSE_DEBUG
265         printk(KERN_DEBUG "%s: Allocated STA %pM\n",
266                wiphy_name(local->hw.wiphy), sta->sta.addr);
267 #endif /* CONFIG_MAC80211_VERBOSE_DEBUG */
268
269 #ifdef CONFIG_MAC80211_MESH
270         sta->plink_state = PLINK_LISTEN;
271         init_timer(&sta->plink_timer);
272 #endif
273
274         return sta;
275 }
276
277 static int sta_info_finish_insert(struct sta_info *sta, bool async)
278 {
279         struct ieee80211_local *local = sta->local;
280         struct ieee80211_sub_if_data *sdata = sta->sdata;
281         struct station_info sinfo;
282         unsigned long flags;
283         int err = 0;
284
285         WARN_ON(!mutex_is_locked(&local->sta_mtx));
286
287         /* notify driver */
288         if (sdata->vif.type == NL80211_IFTYPE_AP_VLAN)
289                 sdata = container_of(sdata->bss,
290                                      struct ieee80211_sub_if_data,
291                                      u.ap);
292         err = drv_sta_add(local, sdata, &sta->sta);
293         if (err) {
294                 if (!async)
295                         return err;
296                 printk(KERN_DEBUG "%s: failed to add IBSS STA %pM to driver (%d)"
297                                   " - keeping it anyway.\n",
298                        sdata->name, sta->sta.addr, err);
299         } else {
300                 sta->uploaded = true;
301 #ifdef CONFIG_MAC80211_VERBOSE_DEBUG
302                 if (async)
303                         printk(KERN_DEBUG "%s: Finished adding IBSS STA %pM\n",
304                                wiphy_name(local->hw.wiphy), sta->sta.addr);
305 #endif
306         }
307
308         sdata = sta->sdata;
309
310         if (!async) {
311                 local->num_sta++;
312                 local->sta_generation++;
313                 smp_mb();
314
315                 /* make the station visible */
316                 spin_lock_irqsave(&local->sta_lock, flags);
317                 sta_info_hash_add(local, sta);
318                 spin_unlock_irqrestore(&local->sta_lock, flags);
319         }
320
321         list_add(&sta->list, &local->sta_list);
322
323         ieee80211_sta_debugfs_add(sta);
324         rate_control_add_sta_debugfs(sta);
325
326         sinfo.filled = 0;
327         sinfo.generation = local->sta_generation;
328         cfg80211_new_sta(sdata->dev, sta->sta.addr, &sinfo, GFP_KERNEL);
329
330
331         return 0;
332 }
333
334 static void sta_info_finish_pending(struct ieee80211_local *local)
335 {
336         struct sta_info *sta;
337         unsigned long flags;
338
339         spin_lock_irqsave(&local->sta_lock, flags);
340         while (!list_empty(&local->sta_pending_list)) {
341                 sta = list_first_entry(&local->sta_pending_list,
342                                        struct sta_info, list);
343                 list_del(&sta->list);
344                 spin_unlock_irqrestore(&local->sta_lock, flags);
345
346                 sta_info_finish_insert(sta, true);
347
348                 spin_lock_irqsave(&local->sta_lock, flags);
349         }
350         spin_unlock_irqrestore(&local->sta_lock, flags);
351 }
352
353 static void sta_info_finish_work(struct work_struct *work)
354 {
355         struct ieee80211_local *local =
356                 container_of(work, struct ieee80211_local, sta_finish_work);
357
358         mutex_lock(&local->sta_mtx);
359         sta_info_finish_pending(local);
360         mutex_unlock(&local->sta_mtx);
361 }
362
363 int sta_info_insert_rcu(struct sta_info *sta) __acquires(RCU)
364 {
365         struct ieee80211_local *local = sta->local;
366         struct ieee80211_sub_if_data *sdata = sta->sdata;
367         unsigned long flags;
368         int err = 0;
369
370         /*
371          * Can't be a WARN_ON because it can be triggered through a race:
372          * something inserts a STA (on one CPU) without holding the RTNL
373          * and another CPU turns off the net device.
374          */
375         if (unlikely(!ieee80211_sdata_running(sdata))) {
376                 err = -ENETDOWN;
377                 rcu_read_lock();
378                 goto out_free;
379         }
380
381         if (WARN_ON(compare_ether_addr(sta->sta.addr, sdata->vif.addr) == 0 ||
382                     is_multicast_ether_addr(sta->sta.addr))) {
383                 err = -EINVAL;
384                 rcu_read_lock();
385                 goto out_free;
386         }
387
388         /*
389          * In ad-hoc mode, we sometimes need to insert stations
390          * from tasklet context from the RX path. To avoid races,
391          * always do so in that case -- see the comment below.
392          */
393         if (sdata->vif.type == NL80211_IFTYPE_ADHOC) {
394                 spin_lock_irqsave(&local->sta_lock, flags);
395                 /* check if STA exists already */
396                 if (sta_info_get_bss(sdata, sta->sta.addr)) {
397                         spin_unlock_irqrestore(&local->sta_lock, flags);
398                         rcu_read_lock();
399                         err = -EEXIST;
400                         goto out_free;
401                 }
402
403                 local->num_sta++;
404                 local->sta_generation++;
405                 smp_mb();
406                 sta_info_hash_add(local, sta);
407
408                 list_add_tail(&sta->list, &local->sta_pending_list);
409
410                 rcu_read_lock();
411                 spin_unlock_irqrestore(&local->sta_lock, flags);
412
413 #ifdef CONFIG_MAC80211_VERBOSE_DEBUG
414                 printk(KERN_DEBUG "%s: Added IBSS STA %pM\n",
415                        wiphy_name(local->hw.wiphy), sta->sta.addr);
416 #endif /* CONFIG_MAC80211_VERBOSE_DEBUG */
417
418                 ieee80211_queue_work(&local->hw, &local->sta_finish_work);
419
420                 return 0;
421         }
422
423         /*
424          * On first glance, this will look racy, because the code
425          * below this point, which inserts a station with sleeping,
426          * unlocks the sta_lock between checking existence in the
427          * hash table and inserting into it.
428          *
429          * However, it is not racy against itself because it keeps
430          * the mutex locked. It still seems to race against the
431          * above code that atomically inserts the station... That,
432          * however, is not true because the above code can only
433          * be invoked for IBSS interfaces, and the below code will
434          * not be -- and the two do not race against each other as
435          * the hash table also keys off the interface.
436          */
437
438         might_sleep();
439
440         mutex_lock(&local->sta_mtx);
441
442         spin_lock_irqsave(&local->sta_lock, flags);
443         /* check if STA exists already */
444         if (sta_info_get_bss(sdata, sta->sta.addr)) {
445                 spin_unlock_irqrestore(&local->sta_lock, flags);
446                 mutex_unlock(&local->sta_mtx);
447                 rcu_read_lock();
448                 err = -EEXIST;
449                 goto out_free;
450         }
451
452         spin_unlock_irqrestore(&local->sta_lock, flags);
453
454         err = sta_info_finish_insert(sta, false);
455         if (err) {
456                 mutex_unlock(&local->sta_mtx);
457                 rcu_read_lock();
458                 goto out_free;
459         }
460
461 #ifdef CONFIG_MAC80211_VERBOSE_DEBUG
462         printk(KERN_DEBUG "%s: Inserted STA %pM\n",
463                wiphy_name(local->hw.wiphy), sta->sta.addr);
464 #endif /* CONFIG_MAC80211_VERBOSE_DEBUG */
465
466         /* move reference to rcu-protected */
467         rcu_read_lock();
468         mutex_unlock(&local->sta_mtx);
469
470         if (ieee80211_vif_is_mesh(&sdata->vif))
471                 mesh_accept_plinks_update(sdata);
472
473         return 0;
474  out_free:
475         BUG_ON(!err);
476         __sta_info_free(local, sta);
477         return err;
478 }
479
480 int sta_info_insert(struct sta_info *sta)
481 {
482         int err = sta_info_insert_rcu(sta);
483
484         rcu_read_unlock();
485
486         return err;
487 }
488
489 static inline void __bss_tim_set(struct ieee80211_if_ap *bss, u16 aid)
490 {
491         /*
492          * This format has been mandated by the IEEE specifications,
493          * so this line may not be changed to use the __set_bit() format.
494          */
495         bss->tim[aid / 8] |= (1 << (aid % 8));
496 }
497
498 static inline void __bss_tim_clear(struct ieee80211_if_ap *bss, u16 aid)
499 {
500         /*
501          * This format has been mandated by the IEEE specifications,
502          * so this line may not be changed to use the __clear_bit() format.
503          */
504         bss->tim[aid / 8] &= ~(1 << (aid % 8));
505 }
506
507 static void __sta_info_set_tim_bit(struct ieee80211_if_ap *bss,
508                                    struct sta_info *sta)
509 {
510         BUG_ON(!bss);
511
512         __bss_tim_set(bss, sta->sta.aid);
513
514         if (sta->local->ops->set_tim) {
515                 sta->local->tim_in_locked_section = true;
516                 drv_set_tim(sta->local, &sta->sta, true);
517                 sta->local->tim_in_locked_section = false;
518         }
519 }
520
521 void sta_info_set_tim_bit(struct sta_info *sta)
522 {
523         unsigned long flags;
524
525         BUG_ON(!sta->sdata->bss);
526
527         spin_lock_irqsave(&sta->local->sta_lock, flags);
528         __sta_info_set_tim_bit(sta->sdata->bss, sta);
529         spin_unlock_irqrestore(&sta->local->sta_lock, flags);
530 }
531
532 static void __sta_info_clear_tim_bit(struct ieee80211_if_ap *bss,
533                                      struct sta_info *sta)
534 {
535         BUG_ON(!bss);
536
537         __bss_tim_clear(bss, sta->sta.aid);
538
539         if (sta->local->ops->set_tim) {
540                 sta->local->tim_in_locked_section = true;
541                 drv_set_tim(sta->local, &sta->sta, false);
542                 sta->local->tim_in_locked_section = false;
543         }
544 }
545
546 void sta_info_clear_tim_bit(struct sta_info *sta)
547 {
548         unsigned long flags;
549
550         BUG_ON(!sta->sdata->bss);
551
552         spin_lock_irqsave(&sta->local->sta_lock, flags);
553         __sta_info_clear_tim_bit(sta->sdata->bss, sta);
554         spin_unlock_irqrestore(&sta->local->sta_lock, flags);
555 }
556
557 static int sta_info_buffer_expired(struct sta_info *sta,
558                                    struct sk_buff *skb)
559 {
560         struct ieee80211_tx_info *info;
561         int timeout;
562
563         if (!skb)
564                 return 0;
565
566         info = IEEE80211_SKB_CB(skb);
567
568         /* Timeout: (2 * listen_interval * beacon_int * 1024 / 1000000) sec */
569         timeout = (sta->listen_interval *
570                    sta->sdata->vif.bss_conf.beacon_int *
571                    32 / 15625) * HZ;
572         if (timeout < STA_TX_BUFFER_EXPIRE)
573                 timeout = STA_TX_BUFFER_EXPIRE;
574         return time_after(jiffies, info->control.jiffies + timeout);
575 }
576
577
578 static bool sta_info_cleanup_expire_buffered(struct ieee80211_local *local,
579                                              struct sta_info *sta)
580 {
581         unsigned long flags;
582         struct sk_buff *skb;
583         struct ieee80211_sub_if_data *sdata;
584
585         if (skb_queue_empty(&sta->ps_tx_buf))
586                 return false;
587
588         for (;;) {
589                 spin_lock_irqsave(&sta->ps_tx_buf.lock, flags);
590                 skb = skb_peek(&sta->ps_tx_buf);
591                 if (sta_info_buffer_expired(sta, skb))
592                         skb = __skb_dequeue(&sta->ps_tx_buf);
593                 else
594                         skb = NULL;
595                 spin_unlock_irqrestore(&sta->ps_tx_buf.lock, flags);
596
597                 if (!skb)
598                         break;
599
600                 sdata = sta->sdata;
601                 local->total_ps_buffered--;
602 #ifdef CONFIG_MAC80211_VERBOSE_PS_DEBUG
603                 printk(KERN_DEBUG "Buffered frame expired (STA %pM)\n",
604                        sta->sta.addr);
605 #endif
606                 dev_kfree_skb(skb);
607
608                 if (skb_queue_empty(&sta->ps_tx_buf))
609                         sta_info_clear_tim_bit(sta);
610         }
611
612         return true;
613 }
614
615 static int __must_check __sta_info_destroy(struct sta_info *sta)
616 {
617         struct ieee80211_local *local;
618         struct ieee80211_sub_if_data *sdata;
619         struct sk_buff *skb;
620         unsigned long flags;
621         int ret;
622
623         might_sleep();
624
625         if (!sta)
626                 return -ENOENT;
627
628         local = sta->local;
629         sdata = sta->sdata;
630
631         /*
632          * Before removing the station from the driver and
633          * rate control, it might still start new aggregation
634          * sessions -- block that to make sure the tear-down
635          * will be sufficient.
636          */
637         set_sta_flags(sta, WLAN_STA_BLOCK_BA);
638         ieee80211_sta_tear_down_BA_sessions(sta);
639
640         spin_lock_irqsave(&local->sta_lock, flags);
641         ret = sta_info_hash_del(local, sta);
642         /* this might still be the pending list ... which is fine */
643         if (!ret)
644                 list_del(&sta->list);
645         spin_unlock_irqrestore(&local->sta_lock, flags);
646         if (ret)
647                 return ret;
648
649         if (sta->key) {
650                 ieee80211_key_free(sta->key);
651                 /*
652                  * We have only unlinked the key, and actually destroying it
653                  * may mean it is removed from hardware which requires that
654                  * the key->sta pointer is still valid, so flush the key todo
655                  * list here.
656                  */
657                 ieee80211_key_todo();
658
659                 WARN_ON(sta->key);
660         }
661
662         sta->dead = true;
663
664         if (test_and_clear_sta_flags(sta,
665                                 WLAN_STA_PS_STA | WLAN_STA_PS_DRIVER)) {
666                 BUG_ON(!sdata->bss);
667
668                 atomic_dec(&sdata->bss->num_sta_ps);
669                 __sta_info_clear_tim_bit(sdata->bss, sta);
670         }
671
672         local->num_sta--;
673         local->sta_generation++;
674
675         if (sdata->vif.type == NL80211_IFTYPE_AP_VLAN)
676                 rcu_assign_pointer(sdata->u.vlan.sta, NULL);
677
678         if (sta->uploaded) {
679                 if (sdata->vif.type == NL80211_IFTYPE_AP_VLAN)
680                         sdata = container_of(sdata->bss,
681                                              struct ieee80211_sub_if_data,
682                                              u.ap);
683                 drv_sta_remove(local, sdata, &sta->sta);
684                 sdata = sta->sdata;
685         }
686
687         /*
688          * At this point, after we wait for an RCU grace period,
689          * neither mac80211 nor the driver can reference this
690          * sta struct any more except by still existing timers
691          * associated with this station that we clean up below.
692          */
693         synchronize_rcu();
694
695 #ifdef CONFIG_MAC80211_MESH
696         if (ieee80211_vif_is_mesh(&sdata->vif))
697                 mesh_accept_plinks_update(sdata);
698 #endif
699
700 #ifdef CONFIG_MAC80211_VERBOSE_DEBUG
701         printk(KERN_DEBUG "%s: Removed STA %pM\n",
702                wiphy_name(local->hw.wiphy), sta->sta.addr);
703 #endif /* CONFIG_MAC80211_VERBOSE_DEBUG */
704         cancel_work_sync(&sta->drv_unblock_wk);
705
706         rate_control_remove_sta_debugfs(sta);
707         ieee80211_sta_debugfs_remove(sta);
708
709 #ifdef CONFIG_MAC80211_MESH
710         if (ieee80211_vif_is_mesh(&sta->sdata->vif)) {
711                 mesh_plink_deactivate(sta);
712                 del_timer_sync(&sta->plink_timer);
713         }
714 #endif
715
716         while ((skb = skb_dequeue(&sta->ps_tx_buf)) != NULL) {
717                 local->total_ps_buffered--;
718                 dev_kfree_skb_any(skb);
719         }
720
721         while ((skb = skb_dequeue(&sta->tx_filtered)) != NULL)
722                 dev_kfree_skb_any(skb);
723
724         __sta_info_free(local, sta);
725
726         return 0;
727 }
728
729 int sta_info_destroy_addr(struct ieee80211_sub_if_data *sdata, const u8 *addr)
730 {
731         struct sta_info *sta;
732         int ret;
733
734         mutex_lock(&sdata->local->sta_mtx);
735         sta = sta_info_get(sdata, addr);
736         ret = __sta_info_destroy(sta);
737         mutex_unlock(&sdata->local->sta_mtx);
738
739         return ret;
740 }
741
742 int sta_info_destroy_addr_bss(struct ieee80211_sub_if_data *sdata,
743                               const u8 *addr)
744 {
745         struct sta_info *sta;
746         int ret;
747
748         mutex_lock(&sdata->local->sta_mtx);
749         sta = sta_info_get_bss(sdata, addr);
750         ret = __sta_info_destroy(sta);
751         mutex_unlock(&sdata->local->sta_mtx);
752
753         return ret;
754 }
755
756 static void sta_info_cleanup(unsigned long data)
757 {
758         struct ieee80211_local *local = (struct ieee80211_local *) data;
759         struct sta_info *sta;
760         bool timer_needed = false;
761
762         rcu_read_lock();
763         list_for_each_entry_rcu(sta, &local->sta_list, list)
764                 if (sta_info_cleanup_expire_buffered(local, sta))
765                         timer_needed = true;
766         rcu_read_unlock();
767
768         if (local->quiescing)
769                 return;
770
771         if (!timer_needed)
772                 return;
773
774         local->sta_cleanup.expires =
775                 round_jiffies(jiffies + STA_INFO_CLEANUP_INTERVAL);
776         add_timer(&local->sta_cleanup);
777 }
778
779 void sta_info_init(struct ieee80211_local *local)
780 {
781         spin_lock_init(&local->sta_lock);
782         mutex_init(&local->sta_mtx);
783         INIT_LIST_HEAD(&local->sta_list);
784         INIT_LIST_HEAD(&local->sta_pending_list);
785         INIT_WORK(&local->sta_finish_work, sta_info_finish_work);
786
787         setup_timer(&local->sta_cleanup, sta_info_cleanup,
788                     (unsigned long)local);
789         local->sta_cleanup.expires =
790                 round_jiffies(jiffies + STA_INFO_CLEANUP_INTERVAL);
791 }
792
793 int sta_info_start(struct ieee80211_local *local)
794 {
795         add_timer(&local->sta_cleanup);
796         return 0;
797 }
798
799 void sta_info_stop(struct ieee80211_local *local)
800 {
801         del_timer(&local->sta_cleanup);
802         sta_info_flush(local, NULL);
803 }
804
805 /**
806  * sta_info_flush - flush matching STA entries from the STA table
807  *
808  * Returns the number of removed STA entries.
809  *
810  * @local: local interface data
811  * @sdata: matching rule for the net device (sta->dev) or %NULL to match all STAs
812  */
813 int sta_info_flush(struct ieee80211_local *local,
814                    struct ieee80211_sub_if_data *sdata)
815 {
816         struct sta_info *sta, *tmp;
817         int ret = 0;
818
819         might_sleep();
820
821         mutex_lock(&local->sta_mtx);
822
823         sta_info_finish_pending(local);
824
825         list_for_each_entry_safe(sta, tmp, &local->sta_list, list) {
826                 if (!sdata || sdata == sta->sdata)
827                         WARN_ON(__sta_info_destroy(sta));
828         }
829         mutex_unlock(&local->sta_mtx);
830
831         return ret;
832 }
833
834 void ieee80211_sta_expire(struct ieee80211_sub_if_data *sdata,
835                           unsigned long exp_time)
836 {
837         struct ieee80211_local *local = sdata->local;
838         struct sta_info *sta, *tmp;
839
840         mutex_lock(&local->sta_mtx);
841         list_for_each_entry_safe(sta, tmp, &local->sta_list, list)
842                 if (time_after(jiffies, sta->last_rx + exp_time)) {
843 #ifdef CONFIG_MAC80211_IBSS_DEBUG
844                         printk(KERN_DEBUG "%s: expiring inactive STA %pM\n",
845                                sdata->name, sta->sta.addr);
846 #endif
847                         WARN_ON(__sta_info_destroy(sta));
848                 }
849         mutex_unlock(&local->sta_mtx);
850 }
851
852 struct ieee80211_sta *ieee80211_find_sta_by_hw(struct ieee80211_hw *hw,
853                                                const u8 *addr)
854 {
855         struct sta_info *sta, *nxt;
856
857         /* Just return a random station ... first in list ... */
858         for_each_sta_info(hw_to_local(hw), addr, sta, nxt) {
859                 if (!sta->uploaded)
860                         return NULL;
861                 return &sta->sta;
862         }
863
864         return NULL;
865 }
866 EXPORT_SYMBOL_GPL(ieee80211_find_sta_by_hw);
867
868 struct ieee80211_sta *ieee80211_find_sta(struct ieee80211_vif *vif,
869                                          const u8 *addr)
870 {
871         struct sta_info *sta;
872
873         if (!vif)
874                 return NULL;
875
876         sta = sta_info_get_bss(vif_to_sdata(vif), addr);
877         if (!sta)
878                 return NULL;
879
880         if (!sta->uploaded)
881                 return NULL;
882
883         return &sta->sta;
884 }
885 EXPORT_SYMBOL(ieee80211_find_sta);
886
887 /* powersave support code */
888 void ieee80211_sta_ps_deliver_wakeup(struct sta_info *sta)
889 {
890         struct ieee80211_sub_if_data *sdata = sta->sdata;
891         struct ieee80211_local *local = sdata->local;
892         int sent, buffered;
893
894         drv_sta_notify(local, sdata, STA_NOTIFY_AWAKE, &sta->sta);
895
896         if (!skb_queue_empty(&sta->ps_tx_buf))
897                 sta_info_clear_tim_bit(sta);
898
899         /* Send all buffered frames to the station */
900         sent = ieee80211_add_pending_skbs(local, &sta->tx_filtered);
901         buffered = ieee80211_add_pending_skbs(local, &sta->ps_tx_buf);
902         sent += buffered;
903         local->total_ps_buffered -= buffered;
904
905 #ifdef CONFIG_MAC80211_VERBOSE_PS_DEBUG
906         printk(KERN_DEBUG "%s: STA %pM aid %d sending %d filtered/%d PS frames "
907                "since STA not sleeping anymore\n", sdata->name,
908                sta->sta.addr, sta->sta.aid, sent - buffered, buffered);
909 #endif /* CONFIG_MAC80211_VERBOSE_PS_DEBUG */
910 }
911
912 void ieee80211_sta_ps_deliver_poll_response(struct sta_info *sta)
913 {
914         struct ieee80211_sub_if_data *sdata = sta->sdata;
915         struct ieee80211_local *local = sdata->local;
916         struct sk_buff *skb;
917         int no_pending_pkts;
918
919         skb = skb_dequeue(&sta->tx_filtered);
920         if (!skb) {
921                 skb = skb_dequeue(&sta->ps_tx_buf);
922                 if (skb)
923                         local->total_ps_buffered--;
924         }
925         no_pending_pkts = skb_queue_empty(&sta->tx_filtered) &&
926                 skb_queue_empty(&sta->ps_tx_buf);
927
928         if (skb) {
929                 struct ieee80211_tx_info *info = IEEE80211_SKB_CB(skb);
930                 struct ieee80211_hdr *hdr =
931                         (struct ieee80211_hdr *) skb->data;
932
933                 /*
934                  * Tell TX path to send this frame even though the STA may
935                  * still remain is PS mode after this frame exchange.
936                  */
937                 info->flags |= IEEE80211_TX_CTL_PSPOLL_RESPONSE;
938
939 #ifdef CONFIG_MAC80211_VERBOSE_PS_DEBUG
940                 printk(KERN_DEBUG "STA %pM aid %d: PS Poll (entries after %d)\n",
941                        sta->sta.addr, sta->sta.aid,
942                        skb_queue_len(&sta->ps_tx_buf));
943 #endif /* CONFIG_MAC80211_VERBOSE_PS_DEBUG */
944
945                 /* Use MoreData flag to indicate whether there are more
946                  * buffered frames for this STA */
947                 if (no_pending_pkts)
948                         hdr->frame_control &= cpu_to_le16(~IEEE80211_FCTL_MOREDATA);
949                 else
950                         hdr->frame_control |= cpu_to_le16(IEEE80211_FCTL_MOREDATA);
951
952                 ieee80211_add_pending_skb(local, skb);
953
954                 if (no_pending_pkts)
955                         sta_info_clear_tim_bit(sta);
956 #ifdef CONFIG_MAC80211_VERBOSE_PS_DEBUG
957         } else {
958                 /*
959                  * FIXME: This can be the result of a race condition between
960                  *        us expiring a frame and the station polling for it.
961                  *        Should we send it a null-func frame indicating we
962                  *        have nothing buffered for it?
963                  */
964                 printk(KERN_DEBUG "%s: STA %pM sent PS Poll even "
965                        "though there are no buffered frames for it\n",
966                        sdata->name, sta->sta.addr);
967 #endif /* CONFIG_MAC80211_VERBOSE_PS_DEBUG */
968         }
969 }
970
971 void ieee80211_sta_block_awake(struct ieee80211_hw *hw,
972                                struct ieee80211_sta *pubsta, bool block)
973 {
974         struct sta_info *sta = container_of(pubsta, struct sta_info, sta);
975
976         trace_api_sta_block_awake(sta->local, pubsta, block);
977
978         if (block)
979                 set_sta_flags(sta, WLAN_STA_PS_DRIVER);
980         else
981                 ieee80211_queue_work(hw, &sta->drv_unblock_wk);
982 }
983 EXPORT_SYMBOL(ieee80211_sta_block_awake);