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
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
44 * When the insertion fails (sta_info_insert()) returns non-zero), the
45 * structure will have been freed by sta_info_insert()!
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 association 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 immediately upon device open. When using AP mode we add stations
53 * for each respective station upon request from userspace through nl80211.
55 * In order to remove a STA info structure, various sta_info_destroy_*()
56 * calls are available.
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.
64 /* Caller must hold local->sta_lock */
65 static int sta_info_hash_del(struct ieee80211_local
*local
,
70 s
= rcu_dereference_protected(local
->sta_hash
[STA_HASH(sta
->sta
.addr
)],
71 lockdep_is_held(&local
->sta_lock
));
75 rcu_assign_pointer(local
->sta_hash
[STA_HASH(sta
->sta
.addr
)],
80 while (rcu_access_pointer(s
->hnext
) &&
81 rcu_access_pointer(s
->hnext
) != sta
)
82 s
= rcu_dereference_protected(s
->hnext
,
83 lockdep_is_held(&local
->sta_lock
));
84 if (rcu_access_pointer(s
->hnext
)) {
85 rcu_assign_pointer(s
->hnext
, sta
->hnext
);
92 /* protected by RCU */
93 struct sta_info
*sta_info_get(struct ieee80211_sub_if_data
*sdata
,
96 struct ieee80211_local
*local
= sdata
->local
;
99 sta
= rcu_dereference_check(local
->sta_hash
[STA_HASH(addr
)],
100 rcu_read_lock_held() ||
101 lockdep_is_held(&local
->sta_lock
) ||
102 lockdep_is_held(&local
->sta_mtx
));
104 if (sta
->sdata
== sdata
&&
105 memcmp(sta
->sta
.addr
, addr
, ETH_ALEN
) == 0)
107 sta
= rcu_dereference_check(sta
->hnext
,
108 rcu_read_lock_held() ||
109 lockdep_is_held(&local
->sta_lock
) ||
110 lockdep_is_held(&local
->sta_mtx
));
116 * Get sta info either from the specified interface
117 * or from one of its vlans
119 struct sta_info
*sta_info_get_bss(struct ieee80211_sub_if_data
*sdata
,
122 struct ieee80211_local
*local
= sdata
->local
;
123 struct sta_info
*sta
;
125 sta
= rcu_dereference_check(local
->sta_hash
[STA_HASH(addr
)],
126 rcu_read_lock_held() ||
127 lockdep_is_held(&local
->sta_lock
) ||
128 lockdep_is_held(&local
->sta_mtx
));
130 if ((sta
->sdata
== sdata
||
131 (sta
->sdata
->bss
&& sta
->sdata
->bss
== sdata
->bss
)) &&
132 memcmp(sta
->sta
.addr
, addr
, ETH_ALEN
) == 0)
134 sta
= rcu_dereference_check(sta
->hnext
,
135 rcu_read_lock_held() ||
136 lockdep_is_held(&local
->sta_lock
) ||
137 lockdep_is_held(&local
->sta_mtx
));
142 struct sta_info
*sta_info_get_by_idx(struct ieee80211_sub_if_data
*sdata
,
145 struct ieee80211_local
*local
= sdata
->local
;
146 struct sta_info
*sta
;
149 list_for_each_entry_rcu(sta
, &local
->sta_list
, list
) {
150 if (sdata
!= sta
->sdata
)
163 * __sta_info_free - internal STA free helper
165 * @local: pointer to the global information
166 * @sta: STA info to free
168 * This function must undo everything done by sta_info_alloc()
169 * that may happen before sta_info_insert().
171 static void __sta_info_free(struct ieee80211_local
*local
,
172 struct sta_info
*sta
)
174 if (sta
->rate_ctrl
) {
175 rate_control_free_sta(sta
);
176 rate_control_put(sta
->rate_ctrl
);
179 #ifdef CONFIG_MAC80211_VERBOSE_DEBUG
180 wiphy_debug(local
->hw
.wiphy
, "Destroyed STA %pM\n", sta
->sta
.addr
);
181 #endif /* CONFIG_MAC80211_VERBOSE_DEBUG */
186 /* Caller must hold local->sta_lock */
187 static void sta_info_hash_add(struct ieee80211_local
*local
,
188 struct sta_info
*sta
)
190 sta
->hnext
= local
->sta_hash
[STA_HASH(sta
->sta
.addr
)];
191 rcu_assign_pointer(local
->sta_hash
[STA_HASH(sta
->sta
.addr
)], sta
);
194 static void sta_unblock(struct work_struct
*wk
)
196 struct sta_info
*sta
;
198 sta
= container_of(wk
, struct sta_info
, drv_unblock_wk
);
203 if (!test_sta_flags(sta
, WLAN_STA_PS_STA
))
204 ieee80211_sta_ps_deliver_wakeup(sta
);
205 else if (test_and_clear_sta_flags(sta
, WLAN_STA_PSPOLL
)) {
206 clear_sta_flags(sta
, WLAN_STA_PS_DRIVER
);
207 ieee80211_sta_ps_deliver_poll_response(sta
);
209 clear_sta_flags(sta
, WLAN_STA_PS_DRIVER
);
212 static int sta_prepare_rate_control(struct ieee80211_local
*local
,
213 struct sta_info
*sta
, gfp_t gfp
)
215 if (local
->hw
.flags
& IEEE80211_HW_HAS_RATE_CONTROL
)
218 sta
->rate_ctrl
= rate_control_get(local
->rate_ctrl
);
219 sta
->rate_ctrl_priv
= rate_control_alloc_sta(sta
->rate_ctrl
,
221 if (!sta
->rate_ctrl_priv
) {
222 rate_control_put(sta
->rate_ctrl
);
229 struct sta_info
*sta_info_alloc(struct ieee80211_sub_if_data
*sdata
,
232 struct ieee80211_local
*local
= sdata
->local
;
233 struct sta_info
*sta
;
234 struct timespec uptime
;
237 sta
= kzalloc(sizeof(*sta
) + local
->hw
.sta_data_size
, gfp
);
241 spin_lock_init(&sta
->lock
);
242 spin_lock_init(&sta
->flaglock
);
243 INIT_WORK(&sta
->drv_unblock_wk
, sta_unblock
);
244 INIT_WORK(&sta
->ampdu_mlme
.work
, ieee80211_ba_session_work
);
245 mutex_init(&sta
->ampdu_mlme
.mtx
);
247 memcpy(sta
->sta
.addr
, addr
, ETH_ALEN
);
250 sta
->last_rx
= jiffies
;
252 do_posix_clock_monotonic_gettime(&uptime
);
253 sta
->last_connected
= uptime
.tv_sec
;
254 ewma_init(&sta
->avg_signal
, 1024, 8);
256 if (sta_prepare_rate_control(local
, sta
, gfp
)) {
261 for (i
= 0; i
< STA_TID_NUM
; i
++) {
263 * timer_to_tid must be initialized with identity mapping
264 * to enable session_timer's data differentiation. See
265 * sta_rx_agg_session_timer_expired for usage.
267 sta
->timer_to_tid
[i
] = i
;
269 skb_queue_head_init(&sta
->ps_tx_buf
);
270 skb_queue_head_init(&sta
->tx_filtered
);
272 for (i
= 0; i
< NUM_RX_DATA_QUEUES
; i
++)
273 sta
->last_seq_ctrl
[i
] = cpu_to_le16(USHRT_MAX
);
275 #ifdef CONFIG_MAC80211_VERBOSE_DEBUG
276 wiphy_debug(local
->hw
.wiphy
, "Allocated STA %pM\n", sta
->sta
.addr
);
277 #endif /* CONFIG_MAC80211_VERBOSE_DEBUG */
279 #ifdef CONFIG_MAC80211_MESH
280 sta
->plink_state
= NL80211_PLINK_LISTEN
;
281 init_timer(&sta
->plink_timer
);
287 static int sta_info_finish_insert(struct sta_info
*sta
, bool async
)
289 struct ieee80211_local
*local
= sta
->local
;
290 struct ieee80211_sub_if_data
*sdata
= sta
->sdata
;
291 struct station_info sinfo
;
295 lockdep_assert_held(&local
->sta_mtx
);
298 if (sdata
->vif
.type
== NL80211_IFTYPE_AP_VLAN
)
299 sdata
= container_of(sdata
->bss
,
300 struct ieee80211_sub_if_data
,
302 err
= drv_sta_add(local
, sdata
, &sta
->sta
);
306 printk(KERN_DEBUG
"%s: failed to add IBSS STA %pM to driver (%d)"
307 " - keeping it anyway.\n",
308 sdata
->name
, sta
->sta
.addr
, err
);
310 sta
->uploaded
= true;
311 #ifdef CONFIG_MAC80211_VERBOSE_DEBUG
313 wiphy_debug(local
->hw
.wiphy
,
314 "Finished adding IBSS STA %pM\n",
323 local
->sta_generation
++;
326 /* make the station visible */
327 spin_lock_irqsave(&local
->sta_lock
, flags
);
328 sta_info_hash_add(local
, sta
);
329 spin_unlock_irqrestore(&local
->sta_lock
, flags
);
332 list_add(&sta
->list
, &local
->sta_list
);
334 ieee80211_sta_debugfs_add(sta
);
335 rate_control_add_sta_debugfs(sta
);
338 sinfo
.generation
= local
->sta_generation
;
339 cfg80211_new_sta(sdata
->dev
, sta
->sta
.addr
, &sinfo
, GFP_KERNEL
);
345 static void sta_info_finish_pending(struct ieee80211_local
*local
)
347 struct sta_info
*sta
;
350 spin_lock_irqsave(&local
->sta_lock
, flags
);
351 while (!list_empty(&local
->sta_pending_list
)) {
352 sta
= list_first_entry(&local
->sta_pending_list
,
353 struct sta_info
, list
);
354 list_del(&sta
->list
);
355 spin_unlock_irqrestore(&local
->sta_lock
, flags
);
357 sta_info_finish_insert(sta
, true);
359 spin_lock_irqsave(&local
->sta_lock
, flags
);
361 spin_unlock_irqrestore(&local
->sta_lock
, flags
);
364 static void sta_info_finish_work(struct work_struct
*work
)
366 struct ieee80211_local
*local
=
367 container_of(work
, struct ieee80211_local
, sta_finish_work
);
369 mutex_lock(&local
->sta_mtx
);
370 sta_info_finish_pending(local
);
371 mutex_unlock(&local
->sta_mtx
);
374 int sta_info_insert_rcu(struct sta_info
*sta
) __acquires(RCU
)
376 struct ieee80211_local
*local
= sta
->local
;
377 struct ieee80211_sub_if_data
*sdata
= sta
->sdata
;
382 * Can't be a WARN_ON because it can be triggered through a race:
383 * something inserts a STA (on one CPU) without holding the RTNL
384 * and another CPU turns off the net device.
386 if (unlikely(!ieee80211_sdata_running(sdata
))) {
392 if (WARN_ON(compare_ether_addr(sta
->sta
.addr
, sdata
->vif
.addr
) == 0 ||
393 is_multicast_ether_addr(sta
->sta
.addr
))) {
400 * In ad-hoc mode, we sometimes need to insert stations
401 * from tasklet context from the RX path. To avoid races,
402 * always do so in that case -- see the comment below.
404 if (sdata
->vif
.type
== NL80211_IFTYPE_ADHOC
) {
405 spin_lock_irqsave(&local
->sta_lock
, flags
);
406 /* check if STA exists already */
407 if (sta_info_get_bss(sdata
, sta
->sta
.addr
)) {
408 spin_unlock_irqrestore(&local
->sta_lock
, flags
);
415 local
->sta_generation
++;
417 sta_info_hash_add(local
, sta
);
419 list_add_tail(&sta
->list
, &local
->sta_pending_list
);
422 spin_unlock_irqrestore(&local
->sta_lock
, flags
);
424 #ifdef CONFIG_MAC80211_VERBOSE_DEBUG
425 wiphy_debug(local
->hw
.wiphy
, "Added IBSS STA %pM\n",
427 #endif /* CONFIG_MAC80211_VERBOSE_DEBUG */
429 ieee80211_queue_work(&local
->hw
, &local
->sta_finish_work
);
435 * On first glance, this will look racy, because the code
436 * below this point, which inserts a station with sleeping,
437 * unlocks the sta_lock between checking existence in the
438 * hash table and inserting into it.
440 * However, it is not racy against itself because it keeps
441 * the mutex locked. It still seems to race against the
442 * above code that atomically inserts the station... That,
443 * however, is not true because the above code can only
444 * be invoked for IBSS interfaces, and the below code will
445 * not be -- and the two do not race against each other as
446 * the hash table also keys off the interface.
451 mutex_lock(&local
->sta_mtx
);
453 spin_lock_irqsave(&local
->sta_lock
, flags
);
454 /* check if STA exists already */
455 if (sta_info_get_bss(sdata
, sta
->sta
.addr
)) {
456 spin_unlock_irqrestore(&local
->sta_lock
, flags
);
457 mutex_unlock(&local
->sta_mtx
);
463 spin_unlock_irqrestore(&local
->sta_lock
, flags
);
465 err
= sta_info_finish_insert(sta
, false);
467 mutex_unlock(&local
->sta_mtx
);
472 #ifdef CONFIG_MAC80211_VERBOSE_DEBUG
473 wiphy_debug(local
->hw
.wiphy
, "Inserted STA %pM\n", sta
->sta
.addr
);
474 #endif /* CONFIG_MAC80211_VERBOSE_DEBUG */
476 /* move reference to rcu-protected */
478 mutex_unlock(&local
->sta_mtx
);
480 if (ieee80211_vif_is_mesh(&sdata
->vif
))
481 mesh_accept_plinks_update(sdata
);
486 __sta_info_free(local
, sta
);
490 int sta_info_insert(struct sta_info
*sta
)
492 int err
= sta_info_insert_rcu(sta
);
499 static inline void __bss_tim_set(struct ieee80211_if_ap
*bss
, u16 aid
)
502 * This format has been mandated by the IEEE specifications,
503 * so this line may not be changed to use the __set_bit() format.
505 bss
->tim
[aid
/ 8] |= (1 << (aid
% 8));
508 static inline void __bss_tim_clear(struct ieee80211_if_ap
*bss
, u16 aid
)
511 * This format has been mandated by the IEEE specifications,
512 * so this line may not be changed to use the __clear_bit() format.
514 bss
->tim
[aid
/ 8] &= ~(1 << (aid
% 8));
517 static void __sta_info_set_tim_bit(struct ieee80211_if_ap
*bss
,
518 struct sta_info
*sta
)
522 __bss_tim_set(bss
, sta
->sta
.aid
);
524 if (sta
->local
->ops
->set_tim
) {
525 sta
->local
->tim_in_locked_section
= true;
526 drv_set_tim(sta
->local
, &sta
->sta
, true);
527 sta
->local
->tim_in_locked_section
= false;
531 void sta_info_set_tim_bit(struct sta_info
*sta
)
535 BUG_ON(!sta
->sdata
->bss
);
537 spin_lock_irqsave(&sta
->local
->sta_lock
, flags
);
538 __sta_info_set_tim_bit(sta
->sdata
->bss
, sta
);
539 spin_unlock_irqrestore(&sta
->local
->sta_lock
, flags
);
542 static void __sta_info_clear_tim_bit(struct ieee80211_if_ap
*bss
,
543 struct sta_info
*sta
)
547 __bss_tim_clear(bss
, sta
->sta
.aid
);
549 if (sta
->local
->ops
->set_tim
) {
550 sta
->local
->tim_in_locked_section
= true;
551 drv_set_tim(sta
->local
, &sta
->sta
, false);
552 sta
->local
->tim_in_locked_section
= false;
556 void sta_info_clear_tim_bit(struct sta_info
*sta
)
560 BUG_ON(!sta
->sdata
->bss
);
562 spin_lock_irqsave(&sta
->local
->sta_lock
, flags
);
563 __sta_info_clear_tim_bit(sta
->sdata
->bss
, sta
);
564 spin_unlock_irqrestore(&sta
->local
->sta_lock
, flags
);
567 static int sta_info_buffer_expired(struct sta_info
*sta
,
570 struct ieee80211_tx_info
*info
;
576 info
= IEEE80211_SKB_CB(skb
);
578 /* Timeout: (2 * listen_interval * beacon_int * 1024 / 1000000) sec */
579 timeout
= (sta
->listen_interval
*
580 sta
->sdata
->vif
.bss_conf
.beacon_int
*
582 if (timeout
< STA_TX_BUFFER_EXPIRE
)
583 timeout
= STA_TX_BUFFER_EXPIRE
;
584 return time_after(jiffies
, info
->control
.jiffies
+ timeout
);
588 static bool sta_info_cleanup_expire_buffered(struct ieee80211_local
*local
,
589 struct sta_info
*sta
)
594 if (skb_queue_empty(&sta
->ps_tx_buf
))
598 spin_lock_irqsave(&sta
->ps_tx_buf
.lock
, flags
);
599 skb
= skb_peek(&sta
->ps_tx_buf
);
600 if (sta_info_buffer_expired(sta
, skb
))
601 skb
= __skb_dequeue(&sta
->ps_tx_buf
);
604 spin_unlock_irqrestore(&sta
->ps_tx_buf
.lock
, flags
);
609 local
->total_ps_buffered
--;
610 #ifdef CONFIG_MAC80211_VERBOSE_PS_DEBUG
611 printk(KERN_DEBUG
"Buffered frame expired (STA %pM)\n",
616 if (skb_queue_empty(&sta
->ps_tx_buf
) &&
617 !test_sta_flags(sta
, WLAN_STA_PS_DRIVER_BUF
))
618 sta_info_clear_tim_bit(sta
);
624 static int __must_check
__sta_info_destroy(struct sta_info
*sta
)
626 struct ieee80211_local
*local
;
627 struct ieee80211_sub_if_data
*sdata
;
641 * Before removing the station from the driver and
642 * rate control, it might still start new aggregation
643 * sessions -- block that to make sure the tear-down
644 * will be sufficient.
646 set_sta_flags(sta
, WLAN_STA_BLOCK_BA
);
647 ieee80211_sta_tear_down_BA_sessions(sta
, true);
649 spin_lock_irqsave(&local
->sta_lock
, flags
);
650 ret
= sta_info_hash_del(local
, sta
);
651 /* this might still be the pending list ... which is fine */
653 list_del(&sta
->list
);
654 spin_unlock_irqrestore(&local
->sta_lock
, flags
);
658 mutex_lock(&local
->key_mtx
);
659 for (i
= 0; i
< NUM_DEFAULT_KEYS
; i
++)
660 __ieee80211_key_free(key_mtx_dereference(local
, sta
->gtk
[i
]));
662 __ieee80211_key_free(key_mtx_dereference(local
, sta
->ptk
));
663 mutex_unlock(&local
->key_mtx
);
667 if (test_and_clear_sta_flags(sta
,
668 WLAN_STA_PS_STA
| WLAN_STA_PS_DRIVER
)) {
671 atomic_dec(&sdata
->bss
->num_sta_ps
);
672 __sta_info_clear_tim_bit(sdata
->bss
, sta
);
676 local
->sta_generation
++;
678 if (sdata
->vif
.type
== NL80211_IFTYPE_AP_VLAN
)
679 rcu_assign_pointer(sdata
->u
.vlan
.sta
, NULL
);
682 if (sdata
->vif
.type
== NL80211_IFTYPE_AP_VLAN
)
683 sdata
= container_of(sdata
->bss
,
684 struct ieee80211_sub_if_data
,
686 drv_sta_remove(local
, sdata
, &sta
->sta
);
691 * At this point, after we wait for an RCU grace period,
692 * neither mac80211 nor the driver can reference this
693 * sta struct any more except by still existing timers
694 * associated with this station that we clean up below.
698 #ifdef CONFIG_MAC80211_MESH
699 if (ieee80211_vif_is_mesh(&sdata
->vif
))
700 mesh_accept_plinks_update(sdata
);
703 #ifdef CONFIG_MAC80211_VERBOSE_DEBUG
704 wiphy_debug(local
->hw
.wiphy
, "Removed STA %pM\n", sta
->sta
.addr
);
705 #endif /* CONFIG_MAC80211_VERBOSE_DEBUG */
706 cancel_work_sync(&sta
->drv_unblock_wk
);
708 cfg80211_del_sta(sdata
->dev
, sta
->sta
.addr
, GFP_KERNEL
);
710 rate_control_remove_sta_debugfs(sta
);
711 ieee80211_sta_debugfs_remove(sta
);
713 #ifdef CONFIG_MAC80211_MESH
714 if (ieee80211_vif_is_mesh(&sta
->sdata
->vif
)) {
715 mesh_plink_deactivate(sta
);
716 del_timer_sync(&sta
->plink_timer
);
720 while ((skb
= skb_dequeue(&sta
->ps_tx_buf
)) != NULL
) {
721 local
->total_ps_buffered
--;
722 dev_kfree_skb_any(skb
);
725 while ((skb
= skb_dequeue(&sta
->tx_filtered
)) != NULL
)
726 dev_kfree_skb_any(skb
);
728 __sta_info_free(local
, sta
);
733 int sta_info_destroy_addr(struct ieee80211_sub_if_data
*sdata
, const u8
*addr
)
735 struct sta_info
*sta
;
738 mutex_lock(&sdata
->local
->sta_mtx
);
739 sta
= sta_info_get(sdata
, addr
);
740 ret
= __sta_info_destroy(sta
);
741 mutex_unlock(&sdata
->local
->sta_mtx
);
746 int sta_info_destroy_addr_bss(struct ieee80211_sub_if_data
*sdata
,
749 struct sta_info
*sta
;
752 mutex_lock(&sdata
->local
->sta_mtx
);
753 sta
= sta_info_get_bss(sdata
, addr
);
754 ret
= __sta_info_destroy(sta
);
755 mutex_unlock(&sdata
->local
->sta_mtx
);
760 static void sta_info_cleanup(unsigned long data
)
762 struct ieee80211_local
*local
= (struct ieee80211_local
*) data
;
763 struct sta_info
*sta
;
764 bool timer_needed
= false;
767 list_for_each_entry_rcu(sta
, &local
->sta_list
, list
)
768 if (sta_info_cleanup_expire_buffered(local
, sta
))
772 if (local
->quiescing
)
778 mod_timer(&local
->sta_cleanup
,
779 round_jiffies(jiffies
+ STA_INFO_CLEANUP_INTERVAL
));
782 void sta_info_init(struct ieee80211_local
*local
)
784 spin_lock_init(&local
->sta_lock
);
785 mutex_init(&local
->sta_mtx
);
786 INIT_LIST_HEAD(&local
->sta_list
);
787 INIT_LIST_HEAD(&local
->sta_pending_list
);
788 INIT_WORK(&local
->sta_finish_work
, sta_info_finish_work
);
790 setup_timer(&local
->sta_cleanup
, sta_info_cleanup
,
791 (unsigned long)local
);
794 void sta_info_stop(struct ieee80211_local
*local
)
796 del_timer(&local
->sta_cleanup
);
797 sta_info_flush(local
, NULL
);
801 * sta_info_flush - flush matching STA entries from the STA table
803 * Returns the number of removed STA entries.
805 * @local: local interface data
806 * @sdata: matching rule for the net device (sta->dev) or %NULL to match all STAs
808 int sta_info_flush(struct ieee80211_local
*local
,
809 struct ieee80211_sub_if_data
*sdata
)
811 struct sta_info
*sta
, *tmp
;
816 mutex_lock(&local
->sta_mtx
);
818 sta_info_finish_pending(local
);
820 list_for_each_entry_safe(sta
, tmp
, &local
->sta_list
, list
) {
821 if (!sdata
|| sdata
== sta
->sdata
)
822 WARN_ON(__sta_info_destroy(sta
));
824 mutex_unlock(&local
->sta_mtx
);
829 void ieee80211_sta_expire(struct ieee80211_sub_if_data
*sdata
,
830 unsigned long exp_time
)
832 struct ieee80211_local
*local
= sdata
->local
;
833 struct sta_info
*sta
, *tmp
;
835 mutex_lock(&local
->sta_mtx
);
836 list_for_each_entry_safe(sta
, tmp
, &local
->sta_list
, list
)
837 if (time_after(jiffies
, sta
->last_rx
+ exp_time
)) {
838 #ifdef CONFIG_MAC80211_IBSS_DEBUG
839 printk(KERN_DEBUG
"%s: expiring inactive STA %pM\n",
840 sdata
->name
, sta
->sta
.addr
);
842 WARN_ON(__sta_info_destroy(sta
));
844 mutex_unlock(&local
->sta_mtx
);
847 struct ieee80211_sta
*ieee80211_find_sta_by_ifaddr(struct ieee80211_hw
*hw
,
851 struct sta_info
*sta
, *nxt
;
854 * Just return a random station if localaddr is NULL
857 for_each_sta_info(hw_to_local(hw
), addr
, sta
, nxt
) {
859 compare_ether_addr(sta
->sdata
->vif
.addr
, localaddr
) != 0)
868 EXPORT_SYMBOL_GPL(ieee80211_find_sta_by_ifaddr
);
870 struct ieee80211_sta
*ieee80211_find_sta(struct ieee80211_vif
*vif
,
873 struct sta_info
*sta
;
878 sta
= sta_info_get_bss(vif_to_sdata(vif
), addr
);
887 EXPORT_SYMBOL(ieee80211_find_sta
);
889 static void clear_sta_ps_flags(void *_sta
)
891 struct sta_info
*sta
= _sta
;
893 clear_sta_flags(sta
, WLAN_STA_PS_DRIVER
| WLAN_STA_PS_STA
);
896 /* powersave support code */
897 void ieee80211_sta_ps_deliver_wakeup(struct sta_info
*sta
)
899 struct ieee80211_sub_if_data
*sdata
= sta
->sdata
;
900 struct ieee80211_local
*local
= sdata
->local
;
903 clear_sta_flags(sta
, WLAN_STA_PS_DRIVER_BUF
);
904 if (!(local
->hw
.flags
& IEEE80211_HW_AP_LINK_PS
))
905 drv_sta_notify(local
, sdata
, STA_NOTIFY_AWAKE
, &sta
->sta
);
907 if (!skb_queue_empty(&sta
->ps_tx_buf
))
908 sta_info_clear_tim_bit(sta
);
910 /* Send all buffered frames to the station */
911 sent
= ieee80211_add_pending_skbs(local
, &sta
->tx_filtered
);
912 buffered
= ieee80211_add_pending_skbs_fn(local
, &sta
->ps_tx_buf
,
913 clear_sta_ps_flags
, sta
);
915 local
->total_ps_buffered
-= buffered
;
917 #ifdef CONFIG_MAC80211_VERBOSE_PS_DEBUG
918 printk(KERN_DEBUG
"%s: STA %pM aid %d sending %d filtered/%d PS frames "
919 "since STA not sleeping anymore\n", sdata
->name
,
920 sta
->sta
.addr
, sta
->sta
.aid
, sent
- buffered
, buffered
);
921 #endif /* CONFIG_MAC80211_VERBOSE_PS_DEBUG */
924 void ieee80211_sta_ps_deliver_poll_response(struct sta_info
*sta
)
926 struct ieee80211_sub_if_data
*sdata
= sta
->sdata
;
927 struct ieee80211_local
*local
= sdata
->local
;
931 skb
= skb_dequeue(&sta
->tx_filtered
);
933 skb
= skb_dequeue(&sta
->ps_tx_buf
);
935 local
->total_ps_buffered
--;
937 no_pending_pkts
= skb_queue_empty(&sta
->tx_filtered
) &&
938 skb_queue_empty(&sta
->ps_tx_buf
);
941 struct ieee80211_tx_info
*info
= IEEE80211_SKB_CB(skb
);
942 struct ieee80211_hdr
*hdr
=
943 (struct ieee80211_hdr
*) skb
->data
;
946 * Tell TX path to send this frame even though the STA may
947 * still remain is PS mode after this frame exchange.
949 info
->flags
|= IEEE80211_TX_CTL_PSPOLL_RESPONSE
;
951 #ifdef CONFIG_MAC80211_VERBOSE_PS_DEBUG
952 printk(KERN_DEBUG
"STA %pM aid %d: PS Poll (entries after %d)\n",
953 sta
->sta
.addr
, sta
->sta
.aid
,
954 skb_queue_len(&sta
->ps_tx_buf
));
955 #endif /* CONFIG_MAC80211_VERBOSE_PS_DEBUG */
957 /* Use MoreData flag to indicate whether there are more
958 * buffered frames for this STA */
960 hdr
->frame_control
&= cpu_to_le16(~IEEE80211_FCTL_MOREDATA
);
962 hdr
->frame_control
|= cpu_to_le16(IEEE80211_FCTL_MOREDATA
);
964 ieee80211_add_pending_skb(local
, skb
);
967 sta_info_clear_tim_bit(sta
);
968 #ifdef CONFIG_MAC80211_VERBOSE_PS_DEBUG
971 * FIXME: This can be the result of a race condition between
972 * us expiring a frame and the station polling for it.
973 * Should we send it a null-func frame indicating we
974 * have nothing buffered for it?
976 printk(KERN_DEBUG
"%s: STA %pM sent PS Poll even "
977 "though there are no buffered frames for it\n",
978 sdata
->name
, sta
->sta
.addr
);
979 #endif /* CONFIG_MAC80211_VERBOSE_PS_DEBUG */
983 void ieee80211_sta_block_awake(struct ieee80211_hw
*hw
,
984 struct ieee80211_sta
*pubsta
, bool block
)
986 struct sta_info
*sta
= container_of(pubsta
, struct sta_info
, sta
);
988 trace_api_sta_block_awake(sta
->local
, pubsta
, block
);
991 set_sta_flags(sta
, WLAN_STA_PS_DRIVER
);
992 else if (test_sta_flags(sta
, WLAN_STA_PS_DRIVER
))
993 ieee80211_queue_work(hw
, &sta
->drv_unblock_wk
);
995 EXPORT_SYMBOL(ieee80211_sta_block_awake
);
997 void ieee80211_sta_set_tim(struct ieee80211_sta
*pubsta
)
999 struct sta_info
*sta
= container_of(pubsta
, struct sta_info
, sta
);
1001 set_sta_flags(sta
, WLAN_STA_PS_DRIVER_BUF
);
1002 sta_info_set_tim_bit(sta
);
1004 EXPORT_SYMBOL(ieee80211_sta_set_tim
);