2 * Copyright 2002-2005, Instant802 Networks, Inc.
3 * Copyright 2006-2007 Jiri Benc <jbenc@suse.cz>
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.
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>
20 #include <net/mac80211.h>
21 #include "ieee80211_i.h"
22 #include "driver-ops.h"
25 #include "debugfs_sta.h"
29 * DOC: STA information lifetime rules
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.
35 * Upon allocating a STA info structure with sta_info_alloc(), the caller owns
36 * that structure. It must then either destroy it using sta_info_destroy()
37 * (which is pretty useless) or insert it into the hash table using
38 * sta_info_insert() which demotes the reference from ownership to a regular
39 * RCU-protected reference; if the function is called without protection by an
40 * RCU critical section the reference is instantly invalidated. Note that the
41 * caller may not do much with the STA info before inserting it, in particular,
42 * it may not start any mesh peer link management or add encryption keys.
44 * When the insertion fails (sta_info_insert()) returns non-zero), the
45 * structure will have been freed by sta_info_insert()!
47 * sta 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 * we receive a probe response or a beacon from target IBSS network. For
52 * WDS we add the sta for the peer imediately upon device open. When using
53 * AP mode we add stations for each respective station upon request from
54 * userspace through nl80211.
56 * Because there are debugfs entries for each station, and adding those
57 * must be able to sleep, it is also possible to "pin" a station entry,
58 * that means it can be removed from the hash table but not be freed.
59 * See the comment in __sta_info_unlink() for more information, this is
60 * an internal capability only.
62 * In order to remove a STA info structure, the caller needs to first
63 * unlink it (sta_info_unlink()) from the list and hash tables and
64 * then destroy it; sta_info_destroy() will wait for an RCU grace period
65 * to elapse before actually freeing it. Due to the pinning and the
66 * possibility of multiple callers trying to remove the same STA info at
67 * the same time, sta_info_unlink() can clear the STA info pointer it is
68 * passed to indicate that the STA info is owned by somebody else now.
70 * If sta_info_unlink() did not clear the pointer then the caller owns
71 * the STA info structure now and is responsible of destroying it with
72 * a call to sta_info_destroy().
74 * In all other cases, there is no concept of ownership on a STA entry,
75 * each structure is owned by the global hash table/list until it is
76 * removed. All users of the structure need to be RCU protected so that
77 * the structure won't be freed before they are done using it.
80 /* Caller must hold local->sta_lock */
81 static int sta_info_hash_del(struct ieee80211_local
*local
,
86 s
= local
->sta_hash
[STA_HASH(sta
->sta
.addr
)];
90 rcu_assign_pointer(local
->sta_hash
[STA_HASH(sta
->sta
.addr
)],
95 while (s
->hnext
&& s
->hnext
!= sta
)
98 rcu_assign_pointer(s
->hnext
, sta
->hnext
);
105 /* protected by RCU */
106 struct sta_info
*sta_info_get(struct ieee80211_local
*local
, const u8
*addr
)
108 struct sta_info
*sta
;
110 sta
= rcu_dereference(local
->sta_hash
[STA_HASH(addr
)]);
112 if (memcmp(sta
->sta
.addr
, addr
, ETH_ALEN
) == 0)
114 sta
= rcu_dereference(sta
->hnext
);
119 struct sta_info
*sta_info_get_by_idx(struct ieee80211_sub_if_data
*sdata
,
122 struct ieee80211_local
*local
= sdata
->local
;
123 struct sta_info
*sta
;
126 list_for_each_entry_rcu(sta
, &local
->sta_list
, list
) {
127 if (sdata
!= sta
->sdata
)
140 * __sta_info_free - internal STA free helper
142 * @local: pointer to the global information
143 * @sta: STA info to free
145 * This function must undo everything done by sta_info_alloc()
146 * that may happen before sta_info_insert().
148 static void __sta_info_free(struct ieee80211_local
*local
,
149 struct sta_info
*sta
)
151 if (sta
->rate_ctrl
) {
152 rate_control_free_sta(sta
);
153 rate_control_put(sta
->rate_ctrl
);
156 #ifdef CONFIG_MAC80211_VERBOSE_DEBUG
157 printk(KERN_DEBUG
"%s: Destroyed STA %pM\n",
158 wiphy_name(local
->hw
.wiphy
), sta
->sta
.addr
);
159 #endif /* CONFIG_MAC80211_VERBOSE_DEBUG */
164 void sta_info_destroy(struct sta_info
*sta
)
166 struct ieee80211_local
*local
;
177 cancel_work_sync(&sta
->drv_unblock_wk
);
179 rate_control_remove_sta_debugfs(sta
);
180 ieee80211_sta_debugfs_remove(sta
);
182 #ifdef CONFIG_MAC80211_MESH
183 if (ieee80211_vif_is_mesh(&sta
->sdata
->vif
))
184 mesh_plink_deactivate(sta
);
188 * We have only unlinked the key, and actually destroying it
189 * may mean it is removed from hardware which requires that
190 * the key->sta pointer is still valid, so flush the key todo
193 * ieee80211_key_todo() will synchronize_rcu() so after this
194 * nothing can reference this sta struct any more.
196 ieee80211_key_todo();
198 #ifdef CONFIG_MAC80211_MESH
199 if (ieee80211_vif_is_mesh(&sta
->sdata
->vif
))
200 del_timer_sync(&sta
->plink_timer
);
203 while ((skb
= skb_dequeue(&sta
->ps_tx_buf
)) != NULL
) {
204 local
->total_ps_buffered
--;
205 dev_kfree_skb_any(skb
);
208 while ((skb
= skb_dequeue(&sta
->tx_filtered
)) != NULL
)
209 dev_kfree_skb_any(skb
);
211 for (i
= 0; i
< STA_TID_NUM
; i
++) {
212 struct tid_ampdu_rx
*tid_rx
;
213 struct tid_ampdu_tx
*tid_tx
;
215 spin_lock_bh(&sta
->lock
);
216 tid_rx
= sta
->ampdu_mlme
.tid_rx
[i
];
217 /* Make sure timer won't free the tid_rx struct, see below */
219 tid_rx
->shutdown
= true;
221 spin_unlock_bh(&sta
->lock
);
224 * Outside spinlock - shutdown is true now so that the timer
225 * won't free tid_rx, we have to do that now. Can't let the
226 * timer do it because we have to sync the timer outside the
227 * lock that it takes itself.
230 del_timer_sync(&tid_rx
->session_timer
);
235 * No need to do such complications for TX agg sessions, the
236 * path leading to freeing the tid_tx struct goes via a call
237 * from the driver, and thus needs to look up the sta struct
238 * again, which cannot be found when we get here. Hence, we
239 * just need to delete the timer and free the aggregation
240 * info; we won't be telling the peer about it then but that
241 * doesn't matter if we're not talking to it again anyway.
243 tid_tx
= sta
->ampdu_mlme
.tid_tx
[i
];
245 del_timer_sync(&tid_tx
->addba_resp_timer
);
247 * STA removed while aggregation session being
248 * started? Bit odd, but purge frames anyway.
250 skb_queue_purge(&tid_tx
->pending
);
255 __sta_info_free(local
, sta
);
259 /* Caller must hold local->sta_lock */
260 static void sta_info_hash_add(struct ieee80211_local
*local
,
261 struct sta_info
*sta
)
263 sta
->hnext
= local
->sta_hash
[STA_HASH(sta
->sta
.addr
)];
264 rcu_assign_pointer(local
->sta_hash
[STA_HASH(sta
->sta
.addr
)], sta
);
267 static void sta_unblock(struct work_struct
*wk
)
269 struct sta_info
*sta
;
271 sta
= container_of(wk
, struct sta_info
, drv_unblock_wk
);
276 if (!test_sta_flags(sta
, WLAN_STA_PS_STA
))
277 ieee80211_sta_ps_deliver_wakeup(sta
);
278 else if (test_and_clear_sta_flags(sta
, WLAN_STA_PSPOLL
))
279 ieee80211_sta_ps_deliver_poll_response(sta
);
282 static int sta_prepare_rate_control(struct ieee80211_local
*local
,
283 struct sta_info
*sta
, gfp_t gfp
)
285 if (local
->hw
.flags
& IEEE80211_HW_HAS_RATE_CONTROL
)
288 sta
->rate_ctrl
= rate_control_get(local
->rate_ctrl
);
289 sta
->rate_ctrl_priv
= rate_control_alloc_sta(sta
->rate_ctrl
,
291 if (!sta
->rate_ctrl_priv
) {
292 rate_control_put(sta
->rate_ctrl
);
299 struct sta_info
*sta_info_alloc(struct ieee80211_sub_if_data
*sdata
,
302 struct ieee80211_local
*local
= sdata
->local
;
303 struct sta_info
*sta
;
306 sta
= kzalloc(sizeof(*sta
) + local
->hw
.sta_data_size
, gfp
);
310 spin_lock_init(&sta
->lock
);
311 spin_lock_init(&sta
->flaglock
);
312 INIT_WORK(&sta
->drv_unblock_wk
, sta_unblock
);
314 memcpy(sta
->sta
.addr
, addr
, ETH_ALEN
);
317 sta
->last_rx
= jiffies
;
319 if (sta_prepare_rate_control(local
, sta
, gfp
)) {
324 for (i
= 0; i
< STA_TID_NUM
; i
++) {
325 /* timer_to_tid must be initialized with identity mapping to
326 * enable session_timer's data differentiation. refer to
327 * sta_rx_agg_session_timer_expired for useage */
328 sta
->timer_to_tid
[i
] = i
;
330 sta
->ampdu_mlme
.tid_state_rx
[i
] = HT_AGG_STATE_IDLE
;
331 sta
->ampdu_mlme
.tid_rx
[i
] = NULL
;
333 sta
->ampdu_mlme
.tid_state_tx
[i
] = HT_AGG_STATE_IDLE
;
334 sta
->ampdu_mlme
.tid_tx
[i
] = NULL
;
335 sta
->ampdu_mlme
.addba_req_num
[i
] = 0;
337 skb_queue_head_init(&sta
->ps_tx_buf
);
338 skb_queue_head_init(&sta
->tx_filtered
);
340 for (i
= 0; i
< NUM_RX_DATA_QUEUES
; i
++)
341 sta
->last_seq_ctrl
[i
] = cpu_to_le16(USHORT_MAX
);
343 #ifdef CONFIG_MAC80211_VERBOSE_DEBUG
344 printk(KERN_DEBUG
"%s: Allocated STA %pM\n",
345 wiphy_name(local
->hw
.wiphy
), sta
->sta
.addr
);
346 #endif /* CONFIG_MAC80211_VERBOSE_DEBUG */
348 #ifdef CONFIG_MAC80211_MESH
349 sta
->plink_state
= PLINK_LISTEN
;
350 init_timer(&sta
->plink_timer
);
356 int sta_info_insert(struct sta_info
*sta
)
358 struct ieee80211_local
*local
= sta
->local
;
359 struct ieee80211_sub_if_data
*sdata
= sta
->sdata
;
364 * Can't be a WARN_ON because it can be triggered through a race:
365 * something inserts a STA (on one CPU) without holding the RTNL
366 * and another CPU turns off the net device.
368 if (unlikely(!netif_running(sdata
->dev
))) {
373 if (WARN_ON(compare_ether_addr(sta
->sta
.addr
, sdata
->dev
->dev_addr
) == 0 ||
374 is_multicast_ether_addr(sta
->sta
.addr
))) {
379 spin_lock_irqsave(&local
->sta_lock
, flags
);
380 /* check if STA exists already */
381 if (sta_info_get(local
, sta
->sta
.addr
)) {
382 spin_unlock_irqrestore(&local
->sta_lock
, flags
);
386 list_add(&sta
->list
, &local
->sta_list
);
387 local
->sta_generation
++;
389 sta_info_hash_add(local
, sta
);
392 if (local
->ops
->sta_notify
) {
393 if (sdata
->vif
.type
== NL80211_IFTYPE_AP_VLAN
)
394 sdata
= container_of(sdata
->bss
,
395 struct ieee80211_sub_if_data
,
398 drv_sta_notify(local
, &sdata
->vif
, STA_NOTIFY_ADD
, &sta
->sta
);
402 #ifdef CONFIG_MAC80211_VERBOSE_DEBUG
403 printk(KERN_DEBUG
"%s: Inserted STA %pM\n",
404 wiphy_name(local
->hw
.wiphy
), sta
->sta
.addr
);
405 #endif /* CONFIG_MAC80211_VERBOSE_DEBUG */
407 spin_unlock_irqrestore(&local
->sta_lock
, flags
);
409 #ifdef CONFIG_MAC80211_DEBUGFS
411 * Debugfs entry adding might sleep, so schedule process
412 * context task for adding entry for STAs that do not yet
414 * NOTE: due to auto-freeing semantics this may only be done
415 * if the insertion is successful!
417 schedule_work(&local
->sta_debugfs_add
);
420 if (ieee80211_vif_is_mesh(&sdata
->vif
))
421 mesh_accept_plinks_update(sdata
);
426 __sta_info_free(local
, sta
);
430 static inline void __bss_tim_set(struct ieee80211_if_ap
*bss
, u16 aid
)
433 * This format has been mandated by the IEEE specifications,
434 * so this line may not be changed to use the __set_bit() format.
436 bss
->tim
[aid
/ 8] |= (1 << (aid
% 8));
439 static inline void __bss_tim_clear(struct ieee80211_if_ap
*bss
, u16 aid
)
442 * This format has been mandated by the IEEE specifications,
443 * so this line may not be changed to use the __clear_bit() format.
445 bss
->tim
[aid
/ 8] &= ~(1 << (aid
% 8));
448 static void __sta_info_set_tim_bit(struct ieee80211_if_ap
*bss
,
449 struct sta_info
*sta
)
453 __bss_tim_set(bss
, sta
->sta
.aid
);
455 if (sta
->local
->ops
->set_tim
) {
456 sta
->local
->tim_in_locked_section
= true;
457 drv_set_tim(sta
->local
, &sta
->sta
, true);
458 sta
->local
->tim_in_locked_section
= false;
462 void sta_info_set_tim_bit(struct sta_info
*sta
)
466 BUG_ON(!sta
->sdata
->bss
);
468 spin_lock_irqsave(&sta
->local
->sta_lock
, flags
);
469 __sta_info_set_tim_bit(sta
->sdata
->bss
, sta
);
470 spin_unlock_irqrestore(&sta
->local
->sta_lock
, flags
);
473 static void __sta_info_clear_tim_bit(struct ieee80211_if_ap
*bss
,
474 struct sta_info
*sta
)
478 __bss_tim_clear(bss
, sta
->sta
.aid
);
480 if (sta
->local
->ops
->set_tim
) {
481 sta
->local
->tim_in_locked_section
= true;
482 drv_set_tim(sta
->local
, &sta
->sta
, false);
483 sta
->local
->tim_in_locked_section
= false;
487 void sta_info_clear_tim_bit(struct sta_info
*sta
)
491 BUG_ON(!sta
->sdata
->bss
);
493 spin_lock_irqsave(&sta
->local
->sta_lock
, flags
);
494 __sta_info_clear_tim_bit(sta
->sdata
->bss
, sta
);
495 spin_unlock_irqrestore(&sta
->local
->sta_lock
, flags
);
498 static void __sta_info_unlink(struct sta_info
**sta
)
500 struct ieee80211_local
*local
= (*sta
)->local
;
501 struct ieee80211_sub_if_data
*sdata
= (*sta
)->sdata
;
503 * pull caller's reference if we're already gone.
505 if (sta_info_hash_del(local
, *sta
)) {
511 ieee80211_key_free((*sta
)->key
);
512 WARN_ON((*sta
)->key
);
515 list_del(&(*sta
)->list
);
518 if (test_and_clear_sta_flags(*sta
,
519 WLAN_STA_PS_STA
| WLAN_STA_PS_DRIVER
)) {
522 atomic_dec(&sdata
->bss
->num_sta_ps
);
523 __sta_info_clear_tim_bit(sdata
->bss
, *sta
);
527 local
->sta_generation
++;
529 if (sdata
->vif
.type
== NL80211_IFTYPE_AP_VLAN
)
530 rcu_assign_pointer(sdata
->u
.vlan
.sta
, NULL
);
532 if (local
->ops
->sta_notify
) {
533 if (sdata
->vif
.type
== NL80211_IFTYPE_AP_VLAN
)
534 sdata
= container_of(sdata
->bss
,
535 struct ieee80211_sub_if_data
,
538 drv_sta_notify(local
, &sdata
->vif
, STA_NOTIFY_REMOVE
,
540 sdata
= (*sta
)->sdata
;
543 if (ieee80211_vif_is_mesh(&sdata
->vif
)) {
544 mesh_accept_plinks_update(sdata
);
545 #ifdef CONFIG_MAC80211_MESH
546 del_timer(&(*sta
)->plink_timer
);
550 #ifdef CONFIG_MAC80211_VERBOSE_DEBUG
551 printk(KERN_DEBUG
"%s: Removed STA %pM\n",
552 wiphy_name(local
->hw
.wiphy
), (*sta
)->sta
.addr
);
553 #endif /* CONFIG_MAC80211_VERBOSE_DEBUG */
556 * Finally, pull caller's reference if the STA is pinned by the
557 * task that is adding the debugfs entries. In that case, we
558 * leave the STA "to be freed".
560 * The rules are not trivial, but not too complex either:
561 * (1) pin_status is only modified under the sta_lock
562 * (2) STAs may only be pinned under the RTNL so that
563 * sta_info_flush() is guaranteed to actually destroy
564 * all STAs that are active for a given interface, this
565 * is required for correctness because otherwise we
566 * could notify a driver that an interface is going
567 * away and only after that (!) notify it about a STA
568 * on that interface going away.
569 * (3) sta_info_debugfs_add_work() will set the status
570 * to PINNED when it found an item that needs a new
571 * debugfs directory created. In that case, that item
572 * must not be freed although all *RCU* users are done
573 * with it. Hence, we tell the caller of _unlink()
574 * that the item is already gone (as can happen when
575 * two tasks try to unlink/destroy at the same time)
576 * (4) We set the pin_status to DESTROY here when we
578 * (5) sta_info_debugfs_add_work() will reset the pin_status
579 * from PINNED to NORMAL when it is done with the item,
580 * but will check for DESTROY before resetting it in
581 * which case it will free the item.
583 if ((*sta
)->pin_status
== STA_INFO_PIN_STAT_PINNED
) {
584 (*sta
)->pin_status
= STA_INFO_PIN_STAT_DESTROY
;
590 void sta_info_unlink(struct sta_info
**sta
)
592 struct ieee80211_local
*local
= (*sta
)->local
;
595 spin_lock_irqsave(&local
->sta_lock
, flags
);
596 __sta_info_unlink(sta
);
597 spin_unlock_irqrestore(&local
->sta_lock
, flags
);
600 static int sta_info_buffer_expired(struct sta_info
*sta
,
603 struct ieee80211_tx_info
*info
;
609 info
= IEEE80211_SKB_CB(skb
);
611 /* Timeout: (2 * listen_interval * beacon_int * 1024 / 1000000) sec */
612 timeout
= (sta
->listen_interval
*
613 sta
->sdata
->vif
.bss_conf
.beacon_int
*
615 if (timeout
< STA_TX_BUFFER_EXPIRE
)
616 timeout
= STA_TX_BUFFER_EXPIRE
;
617 return time_after(jiffies
, info
->control
.jiffies
+ timeout
);
621 static void sta_info_cleanup_expire_buffered(struct ieee80211_local
*local
,
622 struct sta_info
*sta
)
626 struct ieee80211_sub_if_data
*sdata
;
628 if (skb_queue_empty(&sta
->ps_tx_buf
))
632 spin_lock_irqsave(&sta
->ps_tx_buf
.lock
, flags
);
633 skb
= skb_peek(&sta
->ps_tx_buf
);
634 if (sta_info_buffer_expired(sta
, skb
))
635 skb
= __skb_dequeue(&sta
->ps_tx_buf
);
638 spin_unlock_irqrestore(&sta
->ps_tx_buf
.lock
, flags
);
644 local
->total_ps_buffered
--;
645 #ifdef CONFIG_MAC80211_VERBOSE_PS_DEBUG
646 printk(KERN_DEBUG
"Buffered frame expired (STA %pM)\n",
651 if (skb_queue_empty(&sta
->ps_tx_buf
))
652 sta_info_clear_tim_bit(sta
);
657 static void sta_info_cleanup(unsigned long data
)
659 struct ieee80211_local
*local
= (struct ieee80211_local
*) data
;
660 struct sta_info
*sta
;
663 list_for_each_entry_rcu(sta
, &local
->sta_list
, list
)
664 sta_info_cleanup_expire_buffered(local
, sta
);
667 if (local
->quiescing
)
670 local
->sta_cleanup
.expires
=
671 round_jiffies(jiffies
+ STA_INFO_CLEANUP_INTERVAL
);
672 add_timer(&local
->sta_cleanup
);
675 #ifdef CONFIG_MAC80211_DEBUGFS
677 * See comment in __sta_info_unlink,
678 * caller must hold local->sta_lock.
680 static void __sta_info_pin(struct sta_info
*sta
)
682 WARN_ON(sta
->pin_status
!= STA_INFO_PIN_STAT_NORMAL
);
683 sta
->pin_status
= STA_INFO_PIN_STAT_PINNED
;
687 * See comment in __sta_info_unlink, returns sta if it
688 * needs to be destroyed.
690 static struct sta_info
*__sta_info_unpin(struct sta_info
*sta
)
692 struct sta_info
*ret
= NULL
;
695 spin_lock_irqsave(&sta
->local
->sta_lock
, flags
);
696 WARN_ON(sta
->pin_status
!= STA_INFO_PIN_STAT_DESTROY
&&
697 sta
->pin_status
!= STA_INFO_PIN_STAT_PINNED
);
698 if (sta
->pin_status
== STA_INFO_PIN_STAT_DESTROY
)
700 sta
->pin_status
= STA_INFO_PIN_STAT_NORMAL
;
701 spin_unlock_irqrestore(&sta
->local
->sta_lock
, flags
);
706 static void sta_info_debugfs_add_work(struct work_struct
*work
)
708 struct ieee80211_local
*local
=
709 container_of(work
, struct ieee80211_local
, sta_debugfs_add
);
710 struct sta_info
*sta
, *tmp
;
713 /* We need to keep the RTNL across the whole pinned status. */
718 spin_lock_irqsave(&local
->sta_lock
, flags
);
719 list_for_each_entry(tmp
, &local
->sta_list
, list
) {
721 * debugfs.add_has_run will be set by
722 * ieee80211_sta_debugfs_add regardless
723 * of what else it does.
725 if (!tmp
->debugfs
.add_has_run
) {
731 spin_unlock_irqrestore(&local
->sta_lock
, flags
);
736 ieee80211_sta_debugfs_add(sta
);
737 rate_control_add_sta_debugfs(sta
);
739 sta
= __sta_info_unpin(sta
);
740 sta_info_destroy(sta
);
746 void sta_info_init(struct ieee80211_local
*local
)
748 spin_lock_init(&local
->sta_lock
);
749 INIT_LIST_HEAD(&local
->sta_list
);
751 setup_timer(&local
->sta_cleanup
, sta_info_cleanup
,
752 (unsigned long)local
);
753 local
->sta_cleanup
.expires
=
754 round_jiffies(jiffies
+ STA_INFO_CLEANUP_INTERVAL
);
756 #ifdef CONFIG_MAC80211_DEBUGFS
757 INIT_WORK(&local
->sta_debugfs_add
, sta_info_debugfs_add_work
);
761 int sta_info_start(struct ieee80211_local
*local
)
763 add_timer(&local
->sta_cleanup
);
767 void sta_info_stop(struct ieee80211_local
*local
)
769 del_timer(&local
->sta_cleanup
);
770 #ifdef CONFIG_MAC80211_DEBUGFS
772 * Make sure the debugfs adding work isn't pending after this
773 * because we're about to be destroyed. It doesn't matter
774 * whether it ran or not since we're going to flush all STAs
777 cancel_work_sync(&local
->sta_debugfs_add
);
780 sta_info_flush(local
, NULL
);
784 * sta_info_flush - flush matching STA entries from the STA table
786 * Returns the number of removed STA entries.
788 * @local: local interface data
789 * @sdata: matching rule for the net device (sta->dev) or %NULL to match all STAs
791 int sta_info_flush(struct ieee80211_local
*local
,
792 struct ieee80211_sub_if_data
*sdata
)
794 struct sta_info
*sta
, *tmp
;
801 spin_lock_irqsave(&local
->sta_lock
, flags
);
802 list_for_each_entry_safe(sta
, tmp
, &local
->sta_list
, list
) {
803 if (!sdata
|| sdata
== sta
->sdata
) {
804 __sta_info_unlink(&sta
);
806 list_add_tail(&sta
->list
, &tmp_list
);
811 spin_unlock_irqrestore(&local
->sta_lock
, flags
);
813 list_for_each_entry_safe(sta
, tmp
, &tmp_list
, list
)
814 sta_info_destroy(sta
);
819 void ieee80211_sta_expire(struct ieee80211_sub_if_data
*sdata
,
820 unsigned long exp_time
)
822 struct ieee80211_local
*local
= sdata
->local
;
823 struct sta_info
*sta
, *tmp
;
827 spin_lock_irqsave(&local
->sta_lock
, flags
);
828 list_for_each_entry_safe(sta
, tmp
, &local
->sta_list
, list
)
829 if (time_after(jiffies
, sta
->last_rx
+ exp_time
)) {
830 #ifdef CONFIG_MAC80211_IBSS_DEBUG
831 printk(KERN_DEBUG
"%s: expiring inactive STA %pM\n",
832 sdata
->dev
->name
, sta
->sta
.addr
);
834 __sta_info_unlink(&sta
);
836 list_add(&sta
->list
, &tmp_list
);
838 spin_unlock_irqrestore(&local
->sta_lock
, flags
);
840 list_for_each_entry_safe(sta
, tmp
, &tmp_list
, list
)
841 sta_info_destroy(sta
);
844 struct ieee80211_sta
*ieee80211_find_sta_by_hw(struct ieee80211_hw
*hw
,
847 struct sta_info
*sta
= sta_info_get(hw_to_local(hw
), addr
);
853 EXPORT_SYMBOL_GPL(ieee80211_find_sta_by_hw
);
855 struct ieee80211_sta
*ieee80211_find_sta(struct ieee80211_vif
*vif
,
858 struct ieee80211_sub_if_data
*sdata
;
863 sdata
= vif_to_sdata(vif
);
865 return ieee80211_find_sta_by_hw(&sdata
->local
->hw
, addr
);
867 EXPORT_SYMBOL(ieee80211_find_sta
);
869 /* powersave support code */
870 void ieee80211_sta_ps_deliver_wakeup(struct sta_info
*sta
)
872 struct ieee80211_sub_if_data
*sdata
= sta
->sdata
;
873 struct ieee80211_local
*local
= sdata
->local
;
876 drv_sta_notify(local
, &sdata
->vif
, STA_NOTIFY_AWAKE
, &sta
->sta
);
878 if (!skb_queue_empty(&sta
->ps_tx_buf
))
879 sta_info_clear_tim_bit(sta
);
881 /* Send all buffered frames to the station */
882 sent
= ieee80211_add_pending_skbs(local
, &sta
->tx_filtered
);
883 buffered
= ieee80211_add_pending_skbs(local
, &sta
->ps_tx_buf
);
885 local
->total_ps_buffered
-= buffered
;
887 #ifdef CONFIG_MAC80211_VERBOSE_PS_DEBUG
888 printk(KERN_DEBUG
"%s: STA %pM aid %d sending %d filtered/%d PS frames "
889 "since STA not sleeping anymore\n", sdata
->dev
->name
,
890 sta
->sta
.addr
, sta
->sta
.aid
, sent
- buffered
, buffered
);
891 #endif /* CONFIG_MAC80211_VERBOSE_PS_DEBUG */
894 void ieee80211_sta_ps_deliver_poll_response(struct sta_info
*sta
)
896 struct ieee80211_sub_if_data
*sdata
= sta
->sdata
;
897 struct ieee80211_local
*local
= sdata
->local
;
901 skb
= skb_dequeue(&sta
->tx_filtered
);
903 skb
= skb_dequeue(&sta
->ps_tx_buf
);
905 local
->total_ps_buffered
--;
907 no_pending_pkts
= skb_queue_empty(&sta
->tx_filtered
) &&
908 skb_queue_empty(&sta
->ps_tx_buf
);
911 struct ieee80211_tx_info
*info
= IEEE80211_SKB_CB(skb
);
912 struct ieee80211_hdr
*hdr
=
913 (struct ieee80211_hdr
*) skb
->data
;
916 * Tell TX path to send this frame even though the STA may
917 * still remain is PS mode after this frame exchange.
919 info
->flags
|= IEEE80211_TX_CTL_PSPOLL_RESPONSE
;
921 #ifdef CONFIG_MAC80211_VERBOSE_PS_DEBUG
922 printk(KERN_DEBUG
"STA %pM aid %d: PS Poll (entries after %d)\n",
923 sta
->sta
.addr
, sta
->sta
.aid
,
924 skb_queue_len(&sta
->ps_tx_buf
));
925 #endif /* CONFIG_MAC80211_VERBOSE_PS_DEBUG */
927 /* Use MoreData flag to indicate whether there are more
928 * buffered frames for this STA */
930 hdr
->frame_control
&= cpu_to_le16(~IEEE80211_FCTL_MOREDATA
);
932 hdr
->frame_control
|= cpu_to_le16(IEEE80211_FCTL_MOREDATA
);
934 ieee80211_add_pending_skb(local
, skb
);
937 sta_info_clear_tim_bit(sta
);
938 #ifdef CONFIG_MAC80211_VERBOSE_PS_DEBUG
941 * FIXME: This can be the result of a race condition between
942 * us expiring a frame and the station polling for it.
943 * Should we send it a null-func frame indicating we
944 * have nothing buffered for it?
946 printk(KERN_DEBUG
"%s: STA %pM sent PS Poll even "
947 "though there are no buffered frames for it\n",
948 sdata
->dev
->name
, sta
->sta
.addr
);
949 #endif /* CONFIG_MAC80211_VERBOSE_PS_DEBUG */
953 void ieee80211_sta_block_awake(struct ieee80211_hw
*hw
,
954 struct ieee80211_sta
*pubsta
, bool block
)
956 struct sta_info
*sta
= container_of(pubsta
, struct sta_info
, sta
);
959 set_sta_flags(sta
, WLAN_STA_PS_DRIVER
);
961 ieee80211_queue_work(hw
, &sta
->drv_unblock_wk
);
963 EXPORT_SYMBOL(ieee80211_sta_block_awake
);