2 * Scanning implementation
4 * Copyright 2003, Jouni Malinen <jkmaline@cc.hut.fi>
5 * Copyright 2004, Instant802 Networks, Inc.
6 * Copyright 2005, Devicescape Software, Inc.
7 * Copyright 2006-2007 Jiri Benc <jbenc@suse.cz>
8 * Copyright 2007, Michael Wu <flamingice@sourmilk.net>
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License version 2 as
12 * published by the Free Software Foundation.
16 * figure out how to avoid that the "current BSS" expires
17 * use cfg80211's BSS handling
20 #include <linux/wireless.h>
21 #include <linux/if_arp.h>
22 #include <linux/rtnetlink.h>
23 #include <net/mac80211.h>
24 #include <net/iw_handler.h>
26 #include "ieee80211_i.h"
29 #define IEEE80211_PROBE_DELAY (HZ / 33)
30 #define IEEE80211_CHANNEL_TIME (HZ / 33)
31 #define IEEE80211_PASSIVE_CHANNEL_TIME (HZ / 5)
33 void ieee80211_rx_bss_list_init(struct ieee80211_local *local)
35 spin_lock_init(&local->bss_lock);
36 INIT_LIST_HEAD(&local->bss_list);
39 void ieee80211_rx_bss_list_deinit(struct ieee80211_local *local)
41 struct ieee80211_bss *bss, *tmp;
43 list_for_each_entry_safe(bss, tmp, &local->bss_list, list)
44 ieee80211_rx_bss_put(local, bss);
47 struct ieee80211_bss *
48 ieee80211_rx_bss_get(struct ieee80211_local *local, u8 *bssid, int freq,
49 u8 *ssid, u8 ssid_len)
51 struct ieee80211_bss *bss;
53 spin_lock_bh(&local->bss_lock);
54 bss = local->bss_hash[STA_HASH(bssid)];
56 if (!bss_mesh_cfg(bss) &&
57 !memcmp(bss->bssid, bssid, ETH_ALEN) &&
59 bss->ssid_len == ssid_len &&
60 (ssid_len == 0 || !memcmp(bss->ssid, ssid, ssid_len))) {
61 atomic_inc(&bss->users);
66 spin_unlock_bh(&local->bss_lock);
70 /* Caller must hold local->bss_lock */
71 static void __ieee80211_rx_bss_hash_add(struct ieee80211_local *local,
72 struct ieee80211_bss *bss)
76 if (bss_mesh_cfg(bss))
77 hash_idx = mesh_id_hash(bss_mesh_id(bss),
78 bss_mesh_id_len(bss));
80 hash_idx = STA_HASH(bss->bssid);
82 bss->hnext = local->bss_hash[hash_idx];
83 local->bss_hash[hash_idx] = bss;
86 /* Caller must hold local->bss_lock */
87 static void __ieee80211_rx_bss_hash_del(struct ieee80211_local *local,
88 struct ieee80211_bss *bss)
90 struct ieee80211_bss *b, *prev = NULL;
91 b = local->bss_hash[STA_HASH(bss->bssid)];
95 local->bss_hash[STA_HASH(bss->bssid)] =
98 prev->hnext = bss->hnext;
106 static struct ieee80211_bss *
107 ieee80211_rx_bss_add(struct ieee80211_local *local, u8 *bssid, int freq,
108 u8 *ssid, u8 ssid_len)
110 struct ieee80211_bss *bss;
112 bss = kzalloc(sizeof(*bss), GFP_ATOMIC);
115 atomic_set(&bss->users, 2);
116 memcpy(bss->bssid, bssid, ETH_ALEN);
118 if (ssid && ssid_len <= IEEE80211_MAX_SSID_LEN) {
119 memcpy(bss->ssid, ssid, ssid_len);
120 bss->ssid_len = ssid_len;
123 spin_lock_bh(&local->bss_lock);
124 /* TODO: order by RSSI? */
125 list_add_tail(&bss->list, &local->bss_list);
126 __ieee80211_rx_bss_hash_add(local, bss);
127 spin_unlock_bh(&local->bss_lock);
131 #ifdef CONFIG_MAC80211_MESH
132 static struct ieee80211_bss *
133 ieee80211_rx_mesh_bss_get(struct ieee80211_local *local, u8 *mesh_id, int mesh_id_len,
134 u8 *mesh_cfg, int freq)
136 struct ieee80211_bss *bss;
138 spin_lock_bh(&local->bss_lock);
139 bss = local->bss_hash[mesh_id_hash(mesh_id, mesh_id_len)];
141 if (bss_mesh_cfg(bss) &&
142 !memcmp(bss_mesh_cfg(bss), mesh_cfg, MESH_CFG_CMP_LEN) &&
144 mesh_id_len == bss->mesh_id_len &&
145 (mesh_id_len == 0 || !memcmp(bss->mesh_id, mesh_id,
147 atomic_inc(&bss->users);
152 spin_unlock_bh(&local->bss_lock);
156 static struct ieee80211_bss *
157 ieee80211_rx_mesh_bss_add(struct ieee80211_local *local, u8 *mesh_id, int mesh_id_len,
158 u8 *mesh_cfg, int mesh_config_len, int freq)
160 struct ieee80211_bss *bss;
162 if (mesh_config_len != IEEE80211_MESH_CONFIG_LEN)
165 bss = kzalloc(sizeof(*bss), GFP_ATOMIC);
169 bss->mesh_cfg = kmalloc(MESH_CFG_CMP_LEN, GFP_ATOMIC);
170 if (!bss->mesh_cfg) {
175 if (mesh_id_len && mesh_id_len <= IEEE80211_MAX_MESH_ID_LEN) {
176 bss->mesh_id = kmalloc(mesh_id_len, GFP_ATOMIC);
178 kfree(bss->mesh_cfg);
182 memcpy(bss->mesh_id, mesh_id, mesh_id_len);
185 atomic_set(&bss->users, 2);
186 memcpy(bss->mesh_cfg, mesh_cfg, MESH_CFG_CMP_LEN);
187 bss->mesh_id_len = mesh_id_len;
189 spin_lock_bh(&local->bss_lock);
190 /* TODO: order by RSSI? */
191 list_add_tail(&bss->list, &local->bss_list);
192 __ieee80211_rx_bss_hash_add(local, bss);
193 spin_unlock_bh(&local->bss_lock);
198 static void ieee80211_rx_bss_free(struct ieee80211_bss *bss)
201 kfree(bss_mesh_id(bss));
202 kfree(bss_mesh_cfg(bss));
206 void ieee80211_rx_bss_put(struct ieee80211_local *local,
207 struct ieee80211_bss *bss)
210 if (!atomic_dec_and_lock(&bss->users, &local->bss_lock)) {
215 __ieee80211_rx_bss_hash_del(local, bss);
216 list_del(&bss->list);
217 spin_unlock_bh(&local->bss_lock);
218 ieee80211_rx_bss_free(bss);
221 struct ieee80211_bss *
222 ieee80211_bss_info_update(struct ieee80211_local *local,
223 struct ieee80211_rx_status *rx_status,
224 struct ieee80211_mgmt *mgmt,
226 struct ieee802_11_elems *elems,
227 struct ieee80211_channel *channel,
230 struct ieee80211_bss *bss;
231 int clen, freq = channel->center_freq;
232 enum cfg80211_signal_type sigtype = CFG80211_SIGNAL_TYPE_NONE;
235 if (local->hw.flags & IEEE80211_HW_SIGNAL_DBM) {
236 sigtype = CFG80211_SIGNAL_TYPE_MBM;
237 signal = rx_status->signal * 100;
238 } else if (local->hw.flags & IEEE80211_HW_SIGNAL_UNSPEC) {
239 sigtype = CFG80211_SIGNAL_TYPE_UNSPEC;
240 signal = (rx_status->signal * 100) / local->hw.max_signal;
244 cfg80211_inform_bss_frame(local->hw.wiphy, channel,
245 mgmt, len, signal, sigtype,
248 #ifdef CONFIG_MAC80211_MESH
249 if (elems->mesh_config)
250 bss = ieee80211_rx_mesh_bss_get(local, elems->mesh_id,
251 elems->mesh_id_len, elems->mesh_config, freq);
254 bss = ieee80211_rx_bss_get(local, mgmt->bssid, freq,
255 elems->ssid, elems->ssid_len);
257 #ifdef CONFIG_MAC80211_MESH
258 if (elems->mesh_config)
259 bss = ieee80211_rx_mesh_bss_add(local, elems->mesh_id,
260 elems->mesh_id_len, elems->mesh_config,
261 elems->mesh_config_len, freq);
264 bss = ieee80211_rx_bss_add(local, mgmt->bssid, freq,
265 elems->ssid, elems->ssid_len);
270 /* TODO: order by RSSI? */
271 spin_lock_bh(&local->bss_lock);
272 list_move_tail(&bss->list, &local->bss_list);
273 spin_unlock_bh(&local->bss_lock);
277 /* save the ERP value so that it is available at association time */
278 if (elems->erp_info && elems->erp_info_len >= 1) {
279 bss->erp_value = elems->erp_info[0];
280 bss->has_erp_value = 1;
283 bss->beacon_int = le16_to_cpu(mgmt->u.beacon.beacon_int);
284 bss->capability = le16_to_cpu(mgmt->u.beacon.capab_info);
287 struct ieee80211_tim_ie *tim_ie =
288 (struct ieee80211_tim_ie *)elems->tim;
289 bss->dtim_period = tim_ie->dtim_period;
292 /* set default value for buggy APs */
293 if (!elems->tim || bss->dtim_period == 0)
294 bss->dtim_period = 1;
296 bss->supp_rates_len = 0;
297 if (elems->supp_rates) {
298 clen = IEEE80211_MAX_SUPP_RATES - bss->supp_rates_len;
299 if (clen > elems->supp_rates_len)
300 clen = elems->supp_rates_len;
301 memcpy(&bss->supp_rates[bss->supp_rates_len], elems->supp_rates,
303 bss->supp_rates_len += clen;
305 if (elems->ext_supp_rates) {
306 clen = IEEE80211_MAX_SUPP_RATES - bss->supp_rates_len;
307 if (clen > elems->ext_supp_rates_len)
308 clen = elems->ext_supp_rates_len;
309 memcpy(&bss->supp_rates[bss->supp_rates_len],
310 elems->ext_supp_rates, clen);
311 bss->supp_rates_len += clen;
314 bss->band = rx_status->band;
316 bss->timestamp = le64_to_cpu(mgmt->u.beacon.timestamp);
317 bss->last_update = jiffies;
318 bss->signal = rx_status->signal;
319 bss->noise = rx_status->noise;
320 bss->qual = rx_status->qual;
321 bss->wmm_used = elems->wmm_param || elems->wmm_info;
324 bss->last_probe_resp = jiffies;
327 * For probe responses, or if we don't have any information yet,
328 * use the IEs from the beacon.
330 if (!bss->ies || !beacon) {
331 if (bss->ies == NULL || bss->ies_len < elems->total_len) {
333 bss->ies = kmalloc(elems->total_len, GFP_ATOMIC);
336 memcpy(bss->ies, elems->ie_start, elems->total_len);
337 bss->ies_len = elems->total_len;
345 void ieee80211_rx_bss_remove(struct ieee80211_sub_if_data *sdata, u8 *bssid,
346 int freq, u8 *ssid, u8 ssid_len)
348 struct ieee80211_bss *bss;
349 struct ieee80211_local *local = sdata->local;
351 bss = ieee80211_rx_bss_get(local, bssid, freq, ssid, ssid_len);
353 atomic_dec(&bss->users);
354 ieee80211_rx_bss_put(local, bss);
359 ieee80211_scan_rx(struct ieee80211_sub_if_data *sdata, struct sk_buff *skb,
360 struct ieee80211_rx_status *rx_status)
362 struct ieee80211_mgmt *mgmt;
363 struct ieee80211_bss *bss;
365 struct ieee80211_channel *channel;
369 bool presp, beacon = false;
370 struct ieee802_11_elems elems;
373 return RX_DROP_UNUSABLE;
375 mgmt = (struct ieee80211_mgmt *) skb->data;
376 fc = mgmt->frame_control;
378 if (ieee80211_is_ctl(fc))
382 return RX_DROP_MONITOR;
384 presp = ieee80211_is_probe_resp(fc);
386 /* ignore ProbeResp to foreign address */
387 if (memcmp(mgmt->da, sdata->dev->dev_addr, ETH_ALEN))
388 return RX_DROP_MONITOR;
391 elements = mgmt->u.probe_resp.variable;
392 baselen = offsetof(struct ieee80211_mgmt, u.probe_resp.variable);
394 beacon = ieee80211_is_beacon(fc);
395 baselen = offsetof(struct ieee80211_mgmt, u.beacon.variable);
396 elements = mgmt->u.beacon.variable;
399 if (!presp && !beacon)
402 if (baselen > skb->len)
403 return RX_DROP_MONITOR;
405 ieee802_11_parse_elems(elements, skb->len - baselen, &elems);
407 if (elems.ds_params && elems.ds_params_len == 1)
408 freq = ieee80211_channel_to_frequency(elems.ds_params[0]);
410 freq = rx_status->freq;
412 channel = ieee80211_get_channel(sdata->local->hw.wiphy, freq);
414 if (!channel || channel->flags & IEEE80211_CHAN_DISABLED)
415 return RX_DROP_MONITOR;
417 bss = ieee80211_bss_info_update(sdata->local, rx_status,
418 mgmt, skb->len, &elems,
421 ieee80211_rx_bss_put(sdata->local, bss);
427 void ieee80211_send_nullfunc(struct ieee80211_local *local,
428 struct ieee80211_sub_if_data *sdata,
432 struct ieee80211_hdr *nullfunc;
435 skb = dev_alloc_skb(local->hw.extra_tx_headroom + 24);
437 printk(KERN_DEBUG "%s: failed to allocate buffer for nullfunc "
438 "frame\n", sdata->dev->name);
441 skb_reserve(skb, local->hw.extra_tx_headroom);
443 nullfunc = (struct ieee80211_hdr *) skb_put(skb, 24);
444 memset(nullfunc, 0, 24);
445 fc = cpu_to_le16(IEEE80211_FTYPE_DATA | IEEE80211_STYPE_NULLFUNC |
446 IEEE80211_FCTL_TODS);
448 fc |= cpu_to_le16(IEEE80211_FCTL_PM);
449 nullfunc->frame_control = fc;
450 memcpy(nullfunc->addr1, sdata->u.sta.bssid, ETH_ALEN);
451 memcpy(nullfunc->addr2, sdata->dev->dev_addr, ETH_ALEN);
452 memcpy(nullfunc->addr3, sdata->u.sta.bssid, ETH_ALEN);
454 ieee80211_tx_skb(sdata, skb, 0);
457 void ieee80211_scan_completed(struct ieee80211_hw *hw, bool aborted)
459 struct ieee80211_local *local = hw_to_local(hw);
460 struct ieee80211_sub_if_data *sdata;
462 if (WARN_ON(!local->hw_scanning && !local->sw_scanning))
465 if (WARN_ON(!local->scan_req))
468 if (local->scan_req != &local->int_scan_req)
469 cfg80211_scan_done(local->scan_req, aborted);
470 local->scan_req = NULL;
472 local->last_scan_completed = jiffies;
474 if (local->hw_scanning) {
475 local->hw_scanning = false;
477 * Somebody might have requested channel change during scan
478 * that we won't have acted upon, try now. ieee80211_hw_config
479 * will set the flag based on actual changes.
481 ieee80211_hw_config(local, 0);
485 local->sw_scanning = false;
486 ieee80211_hw_config(local, IEEE80211_CONF_CHANGE_CHANNEL);
488 netif_tx_lock_bh(local->mdev);
489 netif_addr_lock(local->mdev);
490 local->filter_flags &= ~FIF_BCN_PRBRESP_PROMISC;
491 local->ops->configure_filter(local_to_hw(local),
492 FIF_BCN_PRBRESP_PROMISC,
493 &local->filter_flags,
494 local->mdev->mc_count,
495 local->mdev->mc_list);
497 netif_addr_unlock(local->mdev);
498 netif_tx_unlock_bh(local->mdev);
500 mutex_lock(&local->iflist_mtx);
501 list_for_each_entry(sdata, &local->interfaces, list) {
502 if (!netif_running(sdata->dev))
505 /* Tell AP we're back */
506 if (sdata->vif.type == NL80211_IFTYPE_STATION) {
507 if (sdata->u.sta.flags & IEEE80211_STA_ASSOCIATED) {
508 ieee80211_send_nullfunc(local, sdata, 0);
509 netif_tx_wake_all_queues(sdata->dev);
512 netif_tx_wake_all_queues(sdata->dev);
514 /* re-enable beaconing */
515 if (sdata->vif.type == NL80211_IFTYPE_AP ||
516 sdata->vif.type == NL80211_IFTYPE_ADHOC ||
517 sdata->vif.type == NL80211_IFTYPE_MESH_POINT)
518 ieee80211_if_config(sdata,
519 IEEE80211_IFCC_BEACON_ENABLED);
521 mutex_unlock(&local->iflist_mtx);
524 ieee80211_mlme_notify_scan_completed(local);
525 ieee80211_mesh_notify_scan_completed(local);
527 EXPORT_SYMBOL(ieee80211_scan_completed);
529 void ieee80211_scan_work(struct work_struct *work)
531 struct ieee80211_local *local =
532 container_of(work, struct ieee80211_local, scan_work.work);
533 struct ieee80211_sub_if_data *sdata = local->scan_sdata;
534 struct ieee80211_channel *chan;
536 unsigned long next_delay = 0;
539 * Avoid re-scheduling when the sdata is going away.
541 if (!netif_running(sdata->dev))
544 switch (local->scan_state) {
545 case SCAN_SET_CHANNEL:
546 /* if no more bands/channels left, complete scan */
547 if (local->scan_channel_idx >= local->scan_req->n_channels) {
548 ieee80211_scan_completed(local_to_hw(local), false);
552 chan = local->scan_req->channels[local->scan_channel_idx];
554 if (chan->flags & IEEE80211_CHAN_DISABLED ||
555 (sdata->vif.type == NL80211_IFTYPE_ADHOC &&
556 chan->flags & IEEE80211_CHAN_NO_IBSS))
560 local->scan_channel = chan;
561 if (ieee80211_hw_config(local,
562 IEEE80211_CONF_CHANGE_CHANNEL))
566 /* advance state machine to next channel/band */
567 local->scan_channel_idx++;
572 next_delay = IEEE80211_PROBE_DELAY +
573 usecs_to_jiffies(local->hw.channel_change_time);
574 local->scan_state = SCAN_SEND_PROBE;
576 case SCAN_SEND_PROBE:
577 next_delay = IEEE80211_PASSIVE_CHANNEL_TIME;
578 local->scan_state = SCAN_SET_CHANNEL;
580 if (local->scan_channel->flags & IEEE80211_CHAN_PASSIVE_SCAN ||
581 !local->scan_req->n_ssids)
583 for (i = 0; i < local->scan_req->n_ssids; i++)
584 ieee80211_send_probe_req(
586 local->scan_req->ssids[i].ssid,
587 local->scan_req->ssids[i].ssid_len);
588 next_delay = IEEE80211_CHANNEL_TIME;
592 queue_delayed_work(local->hw.workqueue, &local->scan_work,
597 int ieee80211_start_scan(struct ieee80211_sub_if_data *scan_sdata,
598 struct cfg80211_scan_request *req)
600 struct ieee80211_local *local = scan_sdata->local;
601 struct ieee80211_sub_if_data *sdata;
606 if (local->scan_req && local->scan_req != req)
609 local->scan_req = req;
611 /* MLME-SCAN.request (page 118) page 144 (11.1.3.1)
612 * BSSType: INFRASTRUCTURE, INDEPENDENT, ANY_BSS
615 * ScanType: ACTIVE, PASSIVE
616 * ProbeDelay: delay (in microseconds) to be used prior to transmitting
617 * a Probe frame during active scanning
619 * MinChannelTime (>= ProbeDelay), in TU
620 * MaxChannelTime: (>= MinChannelTime), in TU
625 * ResultCode: SUCCESS, INVALID_PARAMETERS
628 if (local->sw_scanning || local->hw_scanning) {
629 if (local->scan_sdata == scan_sdata)
634 if (local->ops->hw_scan) {
637 local->hw_scanning = true;
638 rc = local->ops->hw_scan(local_to_hw(local), req);
640 local->hw_scanning = false;
643 local->scan_sdata = scan_sdata;
647 local->sw_scanning = true;
649 mutex_lock(&local->iflist_mtx);
650 list_for_each_entry(sdata, &local->interfaces, list) {
651 if (!netif_running(sdata->dev))
654 /* disable beaconing */
655 if (sdata->vif.type == NL80211_IFTYPE_AP ||
656 sdata->vif.type == NL80211_IFTYPE_ADHOC ||
657 sdata->vif.type == NL80211_IFTYPE_MESH_POINT)
658 ieee80211_if_config(sdata,
659 IEEE80211_IFCC_BEACON_ENABLED);
661 if (sdata->vif.type == NL80211_IFTYPE_STATION) {
662 if (sdata->u.sta.flags & IEEE80211_STA_ASSOCIATED) {
663 netif_tx_stop_all_queues(sdata->dev);
664 ieee80211_send_nullfunc(local, sdata, 1);
667 netif_tx_stop_all_queues(sdata->dev);
669 mutex_unlock(&local->iflist_mtx);
671 local->scan_state = SCAN_SET_CHANNEL;
672 local->scan_channel_idx = 0;
673 local->scan_sdata = scan_sdata;
674 local->scan_req = req;
676 netif_addr_lock_bh(local->mdev);
677 local->filter_flags |= FIF_BCN_PRBRESP_PROMISC;
678 local->ops->configure_filter(local_to_hw(local),
679 FIF_BCN_PRBRESP_PROMISC,
680 &local->filter_flags,
681 local->mdev->mc_count,
682 local->mdev->mc_list);
683 netif_addr_unlock_bh(local->mdev);
685 /* TODO: start scan as soon as all nullfunc frames are ACKed */
686 queue_delayed_work(local->hw.workqueue, &local->scan_work,
687 IEEE80211_CHANNEL_TIME);
693 int ieee80211_request_scan(struct ieee80211_sub_if_data *sdata,
694 struct cfg80211_scan_request *req)
696 struct ieee80211_local *local = sdata->local;
697 struct ieee80211_if_sta *ifsta;
702 if (local->scan_req && local->scan_req != req)
705 local->scan_req = req;
707 if (sdata->vif.type != NL80211_IFTYPE_STATION)
708 return ieee80211_start_scan(sdata, req);
711 * STA has a state machine that might need to defer scanning
712 * while it's trying to associate/authenticate, therefore we
713 * queue it up to the state machine in that case.
716 if (local->sw_scanning || local->hw_scanning) {
717 if (local->scan_sdata == sdata)
722 ifsta = &sdata->u.sta;
723 set_bit(IEEE80211_STA_REQ_SCAN, &ifsta->request);
724 queue_work(local->hw.workqueue, &ifsta->work);