2 * WPA Supplicant - Scanning
3 * Copyright (c) 2003-2010, Jouni Malinen <j@w1.fi>
5 * This software may be distributed under the terms of the BSD license.
6 * See README for more details.
9 #include "utils/includes.h"
11 #include "utils/common.h"
12 #include "utils/eloop.h"
13 #include "common/ieee802_11_defs.h"
15 #include "wpa_supplicant_i.h"
17 #include "wps_supplicant.h"
18 #include "p2p_supplicant.h"
20 #include "hs20_supplicant.h"
26 static void wpa_supplicant_gen_assoc_event(struct wpa_supplicant *wpa_s)
28 struct wpa_ssid *ssid;
29 union wpa_event_data data;
31 ssid = wpa_supplicant_get_ssid(wpa_s);
35 if (wpa_s->current_ssid == NULL) {
36 wpa_s->current_ssid = ssid;
37 if (wpa_s->current_ssid != NULL)
38 wpas_notify_network_changed(wpa_s);
40 wpa_supplicant_initiate_eapol(wpa_s);
41 wpa_dbg(wpa_s, MSG_DEBUG, "Already associated with a configured "
42 "network - generating associated event");
43 os_memset(&data, 0, sizeof(data));
44 wpa_supplicant_event(wpa_s, EVENT_ASSOC, &data);
49 static int wpas_wps_in_use(struct wpa_supplicant *wpa_s,
50 enum wps_request_type *req_type)
52 struct wpa_ssid *ssid;
55 for (ssid = wpa_s->conf->ssid; ssid; ssid = ssid->next) {
56 if (!(ssid->key_mgmt & WPA_KEY_MGMT_WPS))
60 *req_type = wpas_wps_get_req_type(ssid);
61 if (!ssid->eap.phase1)
64 if (os_strstr(ssid->eap.phase1, "pbc=1"))
69 if (!wpa_s->global->p2p_disabled && wpa_s->global->p2p &&
70 !wpa_s->conf->p2p_disabled) {
71 wpa_s->wps->dev.p2p = 1;
74 *req_type = WPS_REQ_ENROLLEE_INFO;
77 #endif /* CONFIG_P2P */
81 #endif /* CONFIG_WPS */
84 int wpa_supplicant_enabled_networks(struct wpa_supplicant *wpa_s)
86 struct wpa_ssid *ssid = wpa_s->conf->ssid;
87 int count = 0, disabled = 0;
89 if (!wpas_network_disabled(wpa_s, ssid))
95 if (wpa_s->conf->cred && wpa_s->conf->interworking &&
96 wpa_s->conf->auto_interworking)
98 if (count == 0 && disabled > 0) {
99 wpa_dbg(wpa_s, MSG_DEBUG, "No enabled networks (%d disabled "
100 "networks)", disabled);
106 static void wpa_supplicant_assoc_try(struct wpa_supplicant *wpa_s,
107 struct wpa_ssid *ssid)
110 if (!wpas_network_disabled(wpa_s, ssid))
115 /* ap_scan=2 mode - try to associate with each SSID. */
117 wpa_dbg(wpa_s, MSG_DEBUG, "wpa_supplicant_assoc_try: Reached "
118 "end of scan list - go back to beginning");
119 wpa_s->prev_scan_ssid = WILDCARD_SSID_SCAN;
120 wpa_supplicant_req_scan(wpa_s, 0, 0);
124 /* Continue from the next SSID on the next attempt. */
125 wpa_s->prev_scan_ssid = ssid;
127 /* Start from the beginning of the SSID list. */
128 wpa_s->prev_scan_ssid = WILDCARD_SSID_SCAN;
130 wpa_supplicant_associate(wpa_s, NULL, ssid);
134 static int int_array_len(const int *a)
137 for (i = 0; a && a[i]; i++)
143 static void int_array_concat(int **res, const int *a)
148 reslen = int_array_len(*res);
149 alen = int_array_len(a);
151 n = os_realloc_array(*res, reslen + alen + 1, sizeof(int));
157 for (i = 0; i <= alen; i++)
158 n[reslen + i] = a[i];
163 static int freq_cmp(const void *a, const void *b)
176 static void int_array_sort_unique(int *a)
184 alen = int_array_len(a);
185 qsort(a, alen, sizeof(int), freq_cmp);
189 while (a[i] && a[j]) {
202 int wpa_supplicant_trigger_scan(struct wpa_supplicant *wpa_s,
203 struct wpa_driver_scan_params *params)
207 wpa_supplicant_notify_scanning(wpa_s, 1);
209 ret = wpa_drv_scan(wpa_s, params);
211 wpa_supplicant_notify_scanning(wpa_s, 0);
212 wpas_notify_scan_done(wpa_s, 0);
215 wpa_s->normal_scans++;
223 wpa_supplicant_delayed_sched_scan_timeout(void *eloop_ctx, void *timeout_ctx)
225 struct wpa_supplicant *wpa_s = eloop_ctx;
227 wpa_dbg(wpa_s, MSG_DEBUG, "Starting delayed sched scan");
229 if (wpa_supplicant_req_sched_scan(wpa_s))
230 wpa_supplicant_req_scan(wpa_s, 0, 0);
235 wpa_supplicant_sched_scan_timeout(void *eloop_ctx, void *timeout_ctx)
237 struct wpa_supplicant *wpa_s = eloop_ctx;
239 wpa_dbg(wpa_s, MSG_DEBUG, "Sched scan timeout - stopping it");
241 wpa_s->sched_scan_timed_out = 1;
242 wpa_supplicant_cancel_sched_scan(wpa_s);
247 wpa_supplicant_start_sched_scan(struct wpa_supplicant *wpa_s,
248 struct wpa_driver_scan_params *params,
253 wpa_supplicant_notify_scanning(wpa_s, 1);
255 ret = wpa_drv_sched_scan(wpa_s, params, interval * 1000);
257 wpa_supplicant_notify_scanning(wpa_s, 0);
259 wpa_s->sched_scanning = 1;
261 wpa_supplicant_notify_scanning(wpa_s, 1);
269 static int wpa_supplicant_stop_sched_scan(struct wpa_supplicant *wpa_s)
273 ret = wpa_drv_stop_sched_scan(wpa_s);
275 wpa_dbg(wpa_s, MSG_DEBUG, "stopping sched_scan failed!");
276 /* TODO: what to do if stopping fails? */
284 static struct wpa_driver_scan_filter *
285 wpa_supplicant_build_filter_ssids(struct wpa_config *conf, size_t *num_ssids)
287 struct wpa_driver_scan_filter *ssids;
288 struct wpa_ssid *ssid;
292 if (!conf->filter_ssids)
295 for (count = 0, ssid = conf->ssid; ssid; ssid = ssid->next) {
296 if (ssid->ssid && ssid->ssid_len)
301 ssids = os_zalloc(count * sizeof(struct wpa_driver_scan_filter));
305 for (ssid = conf->ssid; ssid; ssid = ssid->next) {
306 if (!ssid->ssid || !ssid->ssid_len)
308 os_memcpy(ssids[*num_ssids].ssid, ssid->ssid, ssid->ssid_len);
309 ssids[*num_ssids].ssid_len = ssid->ssid_len;
317 static void wpa_supplicant_optimize_freqs(
318 struct wpa_supplicant *wpa_s, struct wpa_driver_scan_params *params)
321 if (params->freqs == NULL && wpa_s->p2p_in_provisioning &&
323 /* Optimize provisioning state scan based on GO information */
324 if (wpa_s->p2p_in_provisioning < 5 &&
325 wpa_s->go_params->freq > 0) {
326 wpa_dbg(wpa_s, MSG_DEBUG, "P2P: Scan only GO "
327 "preferred frequency %d MHz",
328 wpa_s->go_params->freq);
329 params->freqs = os_zalloc(2 * sizeof(int));
331 params->freqs[0] = wpa_s->go_params->freq;
332 } else if (wpa_s->p2p_in_provisioning < 8 &&
333 wpa_s->go_params->freq_list[0]) {
334 wpa_dbg(wpa_s, MSG_DEBUG, "P2P: Scan only common "
336 int_array_concat(¶ms->freqs,
337 wpa_s->go_params->freq_list);
339 int_array_sort_unique(params->freqs);
341 wpa_s->p2p_in_provisioning++;
343 #endif /* CONFIG_P2P */
346 if (params->freqs == NULL && wpa_s->after_wps && wpa_s->wps_freq) {
348 * Optimize post-provisioning scan based on channel used
349 * during provisioning.
351 wpa_dbg(wpa_s, MSG_DEBUG, "WPS: Scan only frequency %u MHz "
352 "that was used during provisioning", wpa_s->wps_freq);
353 params->freqs = os_zalloc(2 * sizeof(int));
355 params->freqs[0] = wpa_s->wps_freq;
359 if (params->freqs == NULL && wpa_s->known_wps_freq && wpa_s->wps_freq)
361 /* Optimize provisioning scan based on already known channel */
362 wpa_dbg(wpa_s, MSG_DEBUG, "WPS: Scan only frequency %u MHz",
364 params->freqs = os_zalloc(2 * sizeof(int));
366 params->freqs[0] = wpa_s->wps_freq;
367 wpa_s->known_wps_freq = 0; /* only do this once */
369 #endif /* CONFIG_WPS */
373 #ifdef CONFIG_INTERWORKING
374 static void wpas_add_interworking_elements(struct wpa_supplicant *wpa_s,
377 if (wpa_s->conf->interworking == 0)
380 wpabuf_put_u8(buf, WLAN_EID_EXT_CAPAB);
381 wpabuf_put_u8(buf, 4);
382 wpabuf_put_u8(buf, 0x00);
383 wpabuf_put_u8(buf, 0x00);
384 wpabuf_put_u8(buf, 0x00);
385 wpabuf_put_u8(buf, 0x80); /* Bit 31 - Interworking */
387 wpabuf_put_u8(buf, WLAN_EID_INTERWORKING);
388 wpabuf_put_u8(buf, is_zero_ether_addr(wpa_s->conf->hessid) ? 1 :
390 wpabuf_put_u8(buf, wpa_s->conf->access_network_type);
392 if (!is_zero_ether_addr(wpa_s->conf->hessid))
393 wpabuf_put_data(buf, wpa_s->conf->hessid, ETH_ALEN);
395 #endif /* CONFIG_INTERWORKING */
398 static struct wpabuf * wpa_supplicant_extra_ies(struct wpa_supplicant *wpa_s)
400 struct wpabuf *extra_ie = NULL;
403 enum wps_request_type req_type = WPS_REQ_ENROLLEE_INFO;
404 #endif /* CONFIG_WPS */
406 #ifdef CONFIG_INTERWORKING
407 if (wpa_s->conf->interworking &&
408 wpabuf_resize(&extra_ie, 100) == 0)
409 wpas_add_interworking_elements(wpa_s, extra_ie);
410 #endif /* CONFIG_INTERWORKING */
413 wps = wpas_wps_in_use(wpa_s, &req_type);
416 struct wpabuf *wps_ie;
417 wps_ie = wps_build_probe_req_ie(wps == 2 ? DEV_PW_PUSHBUTTON :
420 wpa_s->wps->uuid, req_type,
423 if (wpabuf_resize(&extra_ie, wpabuf_len(wps_ie)) == 0)
424 wpabuf_put_buf(extra_ie, wps_ie);
431 size_t ielen = p2p_scan_ie_buf_len(wpa_s->global->p2p);
432 if (wpabuf_resize(&extra_ie, ielen) == 0)
433 wpas_p2p_scan_ie(wpa_s, extra_ie);
435 #endif /* CONFIG_P2P */
437 #endif /* CONFIG_WPS */
446 * Check whether there are any enabled networks or credentials that could be
447 * used for a non-P2P connection.
449 static int non_p2p_network_enabled(struct wpa_supplicant *wpa_s)
451 struct wpa_ssid *ssid;
453 for (ssid = wpa_s->conf->ssid; ssid; ssid = ssid->next) {
454 if (wpas_network_disabled(wpa_s, ssid))
456 if (!ssid->p2p_group)
460 if (wpa_s->conf->cred && wpa_s->conf->interworking &&
461 wpa_s->conf->auto_interworking)
469 * Find the operating frequency of any other virtual interface that is using
470 * the same radio concurrently.
472 static int shared_vif_oper_freq(struct wpa_supplicant *wpa_s)
474 const char *rn, *rn2;
475 struct wpa_supplicant *ifs;
478 if (!wpa_s->driver->get_radio_name)
481 rn = wpa_s->driver->get_radio_name(wpa_s->drv_priv);
482 if (rn == NULL || rn[0] == '\0')
485 for (ifs = wpa_s->global->ifaces; ifs; ifs = ifs->next) {
486 if (ifs == wpa_s || !ifs->driver->get_radio_name)
489 rn2 = ifs->driver->get_radio_name(ifs->drv_priv);
490 if (!rn2 || os_strcmp(rn, rn2) != 0)
493 if (ifs->current_ssid == NULL || ifs->assoc_freq == 0)
496 if (ifs->current_ssid->mode == WPAS_MODE_AP ||
497 ifs->current_ssid->mode == WPAS_MODE_P2P_GO)
498 return ifs->current_ssid->frequency;
499 if (wpa_drv_get_bssid(ifs, bssid) == 0)
500 return ifs->assoc_freq;
506 #endif /* CONFIG_P2P */
509 static void wpa_supplicant_scan(void *eloop_ctx, void *timeout_ctx)
511 struct wpa_supplicant *wpa_s = eloop_ctx;
512 struct wpa_ssid *ssid;
513 enum scan_req_type scan_req = NORMAL_SCAN_REQ;
515 struct wpabuf *extra_ie = NULL;
516 struct wpa_driver_scan_params params;
517 struct wpa_driver_scan_params *scan_params;
519 enum wpa_states prev_state;
521 if (wpa_s->wpa_state == WPA_INTERFACE_DISABLED) {
522 wpa_dbg(wpa_s, MSG_DEBUG, "Skip scan - interface disabled");
526 if (wpa_s->disconnected && wpa_s->scan_req == NORMAL_SCAN_REQ) {
527 wpa_dbg(wpa_s, MSG_DEBUG, "Disconnected - do not scan");
528 wpa_supplicant_set_state(wpa_s, WPA_DISCONNECTED);
532 if (wpa_s->scanning) {
533 /* If we are already in scanning state, we shall ignore this new scan request*/
534 wpa_dbg(wpa_s, MSG_DEBUG, "Skip scan - already scanning");
538 if (!wpa_supplicant_enabled_networks(wpa_s) &&
539 wpa_s->scan_req == NORMAL_SCAN_REQ) {
540 wpa_dbg(wpa_s, MSG_DEBUG, "No enabled networks - do not scan");
541 wpa_supplicant_set_state(wpa_s, WPA_INACTIVE);
543 wpa_s->sta_scan_pending = 0;
544 #endif /* CONFIG_P2P */
548 if (wpa_s->conf->ap_scan != 0 &&
549 (wpa_s->drv_flags & WPA_DRIVER_FLAGS_WIRED)) {
550 wpa_dbg(wpa_s, MSG_DEBUG, "Using wired authentication - "
551 "overriding ap_scan configuration");
552 wpa_s->conf->ap_scan = 0;
553 wpas_notify_ap_scan_changed(wpa_s);
556 if (wpa_s->conf->ap_scan == 0) {
557 wpa_supplicant_gen_assoc_event(wpa_s);
562 if (wpas_p2p_in_progress(wpa_s)) {
563 if (wpa_s->sta_scan_pending &&
564 wpas_p2p_in_progress(wpa_s) == 2 &&
565 wpa_s->global->p2p_cb_on_scan_complete) {
566 wpa_dbg(wpa_s, MSG_DEBUG, "Process pending station "
567 "mode scan during P2P search");
569 wpa_dbg(wpa_s, MSG_DEBUG, "Delay station mode scan "
570 "while P2P operation is in progress");
571 wpa_s->sta_scan_pending = 1;
572 wpa_supplicant_req_scan(wpa_s, 5, 0);
576 #endif /* CONFIG_P2P */
578 if (wpa_s->conf->ap_scan == 2)
581 max_ssids = wpa_s->max_scan_ssids;
582 if (max_ssids > WPAS_MAX_SCAN_SSIDS)
583 max_ssids = WPAS_MAX_SCAN_SSIDS;
586 scan_req = wpa_s->scan_req;
587 wpa_s->scan_req = NORMAL_SCAN_REQ;
589 os_memset(¶ms, 0, sizeof(params));
591 prev_state = wpa_s->wpa_state;
592 if (wpa_s->wpa_state == WPA_DISCONNECTED ||
593 wpa_s->wpa_state == WPA_INACTIVE)
594 wpa_supplicant_set_state(wpa_s, WPA_SCANNING);
597 * If autoscan has set its own scanning parameters
599 if (wpa_s->autoscan_params != NULL) {
600 scan_params = wpa_s->autoscan_params;
604 if (scan_req != MANUAL_SCAN_REQ && wpa_s->connect_without_scan) {
605 for (ssid = wpa_s->conf->ssid; ssid; ssid = ssid->next) {
606 if (ssid == wpa_s->connect_without_scan)
609 wpa_s->connect_without_scan = NULL;
611 wpa_printf(MSG_DEBUG, "Start a pre-selected network "
612 "without scan step");
613 wpa_supplicant_associate(wpa_s, NULL, ssid);
619 if ((wpa_s->p2p_in_provisioning || wpa_s->show_group_started) &&
621 wpa_printf(MSG_DEBUG, "P2P: Use specific SSID for scan during "
622 "P2P group formation");
623 params.ssids[0].ssid = wpa_s->go_params->ssid;
624 params.ssids[0].ssid_len = wpa_s->go_params->ssid_len;
625 params.num_ssids = 1;
628 #endif /* CONFIG_P2P */
630 /* Find the starting point from which to continue scanning */
631 ssid = wpa_s->conf->ssid;
632 if (wpa_s->prev_scan_ssid != WILDCARD_SSID_SCAN) {
634 if (ssid == wpa_s->prev_scan_ssid) {
642 if (scan_req != MANUAL_SCAN_REQ && wpa_s->conf->ap_scan == 2) {
643 wpa_s->connect_without_scan = NULL;
644 wpa_s->prev_scan_wildcard = 0;
645 wpa_supplicant_assoc_try(wpa_s, ssid);
648 } else if (wpa_s->conf->ap_scan == 2) {
650 * User-initiated scan request in ap_scan == 2; scan with
656 struct wpa_ssid *start = ssid, *tssid;
658 if (ssid == NULL && max_ssids > 1)
659 ssid = wpa_s->conf->ssid;
661 if (!wpas_network_disabled(wpa_s, ssid) &&
663 wpa_hexdump_ascii(MSG_DEBUG, "Scan SSID",
664 ssid->ssid, ssid->ssid_len);
665 params.ssids[params.num_ssids].ssid =
667 params.ssids[params.num_ssids].ssid_len =
670 if (params.num_ssids + 1 >= max_ssids)
676 if (ssid == NULL && max_ssids > 1 &&
677 start != wpa_s->conf->ssid)
678 ssid = wpa_s->conf->ssid;
681 for (tssid = wpa_s->conf->ssid; tssid; tssid = tssid->next) {
682 if (wpas_network_disabled(wpa_s, tssid))
684 if ((params.freqs || !freqs_set) && tssid->scan_freq) {
685 int_array_concat(¶ms.freqs,
688 os_free(params.freqs);
693 int_array_sort_unique(params.freqs);
696 if (ssid && max_ssids == 1) {
698 * If the driver is limited to 1 SSID at a time interleave
699 * wildcard SSID scans with specific SSID scans to avoid
700 * waiting a long time for a wildcard scan.
702 if (!wpa_s->prev_scan_wildcard) {
703 params.ssids[0].ssid = NULL;
704 params.ssids[0].ssid_len = 0;
705 wpa_s->prev_scan_wildcard = 1;
706 wpa_dbg(wpa_s, MSG_DEBUG, "Starting AP scan for "
707 "wildcard SSID (Interleave with specific)");
709 wpa_s->prev_scan_ssid = ssid;
710 wpa_s->prev_scan_wildcard = 0;
711 wpa_dbg(wpa_s, MSG_DEBUG,
712 "Starting AP scan for specific SSID: %s",
713 wpa_ssid_txt(ssid->ssid, ssid->ssid_len));
718 wpa_s->prev_scan_ssid = ssid;
719 wpa_dbg(wpa_s, MSG_DEBUG, "Include wildcard SSID in "
723 wpa_s->prev_scan_ssid = WILDCARD_SSID_SCAN;
725 wpa_dbg(wpa_s, MSG_DEBUG, "Starting AP scan for wildcard "
730 #endif /* CONFIG_P2P */
732 wpa_supplicant_optimize_freqs(wpa_s, ¶ms);
733 extra_ie = wpa_supplicant_extra_ies(wpa_s);
736 if (wpa_s->conf->hs20 && wpabuf_resize(&extra_ie, 6) == 0)
737 wpas_hs20_add_indication(extra_ie);
738 #endif /* CONFIG_HS20 */
740 if (params.freqs == NULL && wpa_s->next_scan_freqs) {
741 wpa_dbg(wpa_s, MSG_DEBUG, "Optimize scan based on previously "
742 "generated frequency list");
743 params.freqs = wpa_s->next_scan_freqs;
745 os_free(wpa_s->next_scan_freqs);
746 wpa_s->next_scan_freqs = NULL;
748 params.filter_ssids = wpa_supplicant_build_filter_ssids(
749 wpa_s->conf, ¶ms.num_filter_ssids);
751 params.extra_ies = wpabuf_head(extra_ie);
752 params.extra_ies_len = wpabuf_len(extra_ie);
756 if (wpa_s->p2p_in_provisioning ||
757 (wpa_s->show_group_started && wpa_s->go_params)) {
759 * The interface may not yet be in P2P mode, so we have to
760 * explicitly request P2P probe to disable CCK rates.
762 params.p2p_probe = 1;
764 #endif /* CONFIG_P2P */
766 scan_params = ¶ms;
771 * If the driver does not support multi-channel concurrency and a
772 * virtual interface that shares the same radio with the wpa_s interface
773 * is operating there may not be need to scan other channels apart from
774 * the current operating channel on the other virtual interface. Filter
775 * out other channels in case we are trying to find a connection for a
776 * station interface when we are not configured to prefer station
777 * connection and a concurrent operation is already in process.
779 if (wpa_s->scan_for_connection && scan_req == NORMAL_SCAN_REQ &&
780 !scan_params->freqs && !params.freqs &&
781 wpas_is_p2p_prioritized(wpa_s) &&
782 !(wpa_s->drv_flags & WPA_DRIVER_FLAGS_MULTI_CHANNEL_CONCURRENT) &&
783 wpa_s->p2p_group_interface == NOT_P2P_GROUP_INTERFACE &&
784 non_p2p_network_enabled(wpa_s)) {
785 int freq = shared_vif_oper_freq(wpa_s);
787 wpa_dbg(wpa_s, MSG_DEBUG, "P2P: Scan only the current "
788 "operating channel (%d MHz) since driver does "
789 "not support multi-channel concurrency", freq);
790 params.freqs = os_zalloc(sizeof(int) * 2);
792 params.freqs[0] = freq;
793 scan_params->freqs = params.freqs;
796 #endif /* CONFIG_P2P */
798 ret = wpa_supplicant_trigger_scan(wpa_s, scan_params);
800 wpabuf_free(extra_ie);
801 os_free(params.freqs);
802 os_free(params.filter_ssids);
805 wpa_msg(wpa_s, MSG_WARNING, "Failed to initiate AP scan");
806 if (prev_state != wpa_s->wpa_state)
807 wpa_supplicant_set_state(wpa_s, prev_state);
808 /* Restore scan_req since we will try to scan again */
809 wpa_s->scan_req = scan_req;
810 wpa_supplicant_req_scan(wpa_s, 1, 0);
812 wpa_s->scan_for_connection = 0;
818 * wpa_supplicant_req_scan - Schedule a scan for neighboring access points
819 * @wpa_s: Pointer to wpa_supplicant data
820 * @sec: Number of seconds after which to scan
821 * @usec: Number of microseconds after which to scan
823 * This function is used to schedule a scan for neighboring access points after
824 * the specified time.
826 void wpa_supplicant_req_scan(struct wpa_supplicant *wpa_s, int sec, int usec)
829 /* If there's at least one network that should be specifically scanned
830 * then don't cancel the scan and reschedule. Some drivers do
831 * background scanning which generates frequent scan results, and that
832 * causes the specific SSID scan to get continually pushed back and
833 * never happen, which causes hidden APs to never get probe-scanned.
835 if (eloop_is_timeout_registered(wpa_supplicant_scan, wpa_s, NULL) &&
836 wpa_s->conf->ap_scan == 1) {
837 struct wpa_ssid *ssid = wpa_s->conf->ssid;
840 if (!wpas_network_disabled(wpa_s, ssid) &&
846 wpa_dbg(wpa_s, MSG_DEBUG, "Not rescheduling scan to "
847 "ensure that specific SSID scans occur");
852 wpa_dbg(wpa_s, MSG_DEBUG, "Setting scan request: %d sec %d usec",
854 eloop_cancel_timeout(wpa_supplicant_scan, wpa_s, NULL);
855 eloop_register_timeout(sec, usec, wpa_supplicant_scan, wpa_s, NULL);
860 * wpa_supplicant_delayed_sched_scan - Request a delayed scheduled scan
861 * @wpa_s: Pointer to wpa_supplicant data
862 * @sec: Number of seconds after which to scan
863 * @usec: Number of microseconds after which to scan
865 * This function is used to schedule periodic scans for neighboring
866 * access points after the specified time.
868 int wpa_supplicant_delayed_sched_scan(struct wpa_supplicant *wpa_s,
871 if (!wpa_s->sched_scan_supported)
874 eloop_register_timeout(sec, usec,
875 wpa_supplicant_delayed_sched_scan_timeout,
883 * wpa_supplicant_req_sched_scan - Start a periodic scheduled scan
884 * @wpa_s: Pointer to wpa_supplicant data
886 * This function is used to schedule periodic scans for neighboring
887 * access points repeating the scan continuously.
889 int wpa_supplicant_req_sched_scan(struct wpa_supplicant *wpa_s)
891 struct wpa_driver_scan_params params;
892 struct wpa_driver_scan_params *scan_params;
893 enum wpa_states prev_state;
894 struct wpa_ssid *ssid = NULL;
895 struct wpabuf *extra_ie = NULL;
897 unsigned int max_sched_scan_ssids;
901 if (!wpa_s->sched_scan_supported)
904 if (wpa_s->max_sched_scan_ssids > WPAS_MAX_SCAN_SSIDS)
905 max_sched_scan_ssids = WPAS_MAX_SCAN_SSIDS;
907 max_sched_scan_ssids = wpa_s->max_sched_scan_ssids;
908 if (max_sched_scan_ssids < 1 || wpa_s->conf->disable_scan_offload)
911 if (wpa_s->sched_scanning) {
912 wpa_dbg(wpa_s, MSG_DEBUG, "Already sched scanning");
917 for (ssid = wpa_s->conf->ssid; ssid; ssid = ssid->next) {
918 if (!wpas_network_disabled(wpa_s, ssid) && !ssid->scan_ssid) {
919 /* Use wildcard SSID to find this network */
921 } else if (!wpas_network_disabled(wpa_s, ssid) &&
926 if (!wpas_network_disabled(wpa_s, ssid) &&
927 ssid->key_mgmt == WPA_KEY_MGMT_WPS) {
929 * Normal scan is more reliable and faster for WPS
930 * operations and since these are for short periods of
931 * time, the benefit of trying to use sched_scan would
934 wpa_dbg(wpa_s, MSG_DEBUG, "Use normal scan instead of "
935 "sched_scan for WPS");
938 #endif /* CONFIG_WPS */
943 if (wpa_s->normal_scans < 3 &&
944 (need_ssids <= wpa_s->max_scan_ssids ||
945 wpa_s->max_scan_ssids >= (int) max_sched_scan_ssids)) {
947 * When normal scan can speed up operations, use that for the
948 * first operations before starting the sched_scan to allow
949 * user space sleep more. We do this only if the normal scan
950 * has functionality that is suitable for this or if the
951 * sched_scan does not have better support for multiple SSIDs.
953 wpa_dbg(wpa_s, MSG_DEBUG, "Use normal scan instead of "
954 "sched_scan for initial scans (normal_scans=%d)",
955 wpa_s->normal_scans);
959 os_memset(¶ms, 0, sizeof(params));
961 /* If we can't allocate space for the filters, we just don't filter */
962 params.filter_ssids = os_zalloc(wpa_s->max_match_sets *
963 sizeof(struct wpa_driver_scan_filter));
965 prev_state = wpa_s->wpa_state;
967 if (wpa_s->wpa_state == WPA_DISCONNECTED ||
968 wpa_s->wpa_state == WPA_INACTIVE)
969 wpa_supplicant_set_state(wpa_s, WPA_SCANNING);
972 if (wpa_s->autoscan_params != NULL) {
973 scan_params = wpa_s->autoscan_params;
977 /* Find the starting point from which to continue scanning */
978 ssid = wpa_s->conf->ssid;
979 if (wpa_s->prev_sched_ssid) {
981 if (ssid == wpa_s->prev_sched_ssid) {
989 if (!ssid || !wpa_s->prev_sched_ssid) {
990 wpa_dbg(wpa_s, MSG_DEBUG, "Beginning of SSID list");
992 if (wpa_s->sched_scan_interval == 0)
993 wpa_s->sched_scan_interval = 10;
994 wpa_s->sched_scan_timeout = max_sched_scan_ssids * 2;
995 wpa_s->first_sched_scan = 1;
996 ssid = wpa_s->conf->ssid;
997 wpa_s->prev_sched_ssid = ssid;
1001 wpa_dbg(wpa_s, MSG_DEBUG, "Add wildcard SSID to sched_scan");
1006 if (wpas_network_disabled(wpa_s, ssid))
1009 if (params.num_filter_ssids < wpa_s->max_match_sets &&
1010 params.filter_ssids && ssid->ssid && ssid->ssid_len) {
1011 wpa_dbg(wpa_s, MSG_DEBUG, "add to filter ssid: %s",
1012 wpa_ssid_txt(ssid->ssid, ssid->ssid_len));
1013 os_memcpy(params.filter_ssids[params.num_filter_ssids].ssid,
1014 ssid->ssid, ssid->ssid_len);
1015 params.filter_ssids[params.num_filter_ssids].ssid_len =
1017 params.num_filter_ssids++;
1018 } else if (params.filter_ssids && ssid->ssid && ssid->ssid_len)
1020 wpa_dbg(wpa_s, MSG_DEBUG, "Not enough room for SSID "
1021 "filter for sched_scan - drop filter");
1022 os_free(params.filter_ssids);
1023 params.filter_ssids = NULL;
1024 params.num_filter_ssids = 0;
1027 if (ssid->scan_ssid && ssid->ssid && ssid->ssid_len) {
1028 if (params.num_ssids == max_sched_scan_ssids)
1029 break; /* only room for broadcast SSID */
1030 wpa_dbg(wpa_s, MSG_DEBUG,
1031 "add to active scan ssid: %s",
1032 wpa_ssid_txt(ssid->ssid, ssid->ssid_len));
1033 params.ssids[params.num_ssids].ssid =
1035 params.ssids[params.num_ssids].ssid_len =
1038 if (params.num_ssids >= max_sched_scan_ssids) {
1039 wpa_s->prev_sched_ssid = ssid;
1043 (wpas_network_disabled(wpa_s, ssid) ||
1050 wpa_s->prev_sched_ssid = ssid;
1054 if (params.num_filter_ssids == 0) {
1055 os_free(params.filter_ssids);
1056 params.filter_ssids = NULL;
1059 extra_ie = wpa_supplicant_extra_ies(wpa_s);
1061 params.extra_ies = wpabuf_head(extra_ie);
1062 params.extra_ies_len = wpabuf_len(extra_ie);
1065 scan_params = ¶ms;
1068 if (ssid || !wpa_s->first_sched_scan) {
1069 wpa_dbg(wpa_s, MSG_DEBUG,
1070 "Starting sched scan: interval %d timeout %d",
1071 wpa_s->sched_scan_interval, wpa_s->sched_scan_timeout);
1073 wpa_dbg(wpa_s, MSG_DEBUG,
1074 "Starting sched scan: interval %d (no timeout)",
1075 wpa_s->sched_scan_interval);
1078 ret = wpa_supplicant_start_sched_scan(wpa_s, scan_params,
1079 wpa_s->sched_scan_interval);
1080 wpabuf_free(extra_ie);
1081 os_free(params.filter_ssids);
1083 wpa_msg(wpa_s, MSG_WARNING, "Failed to initiate sched scan");
1084 if (prev_state != wpa_s->wpa_state)
1085 wpa_supplicant_set_state(wpa_s, prev_state);
1089 /* If we have more SSIDs to scan, add a timeout so we scan them too */
1090 if (ssid || !wpa_s->first_sched_scan) {
1091 wpa_s->sched_scan_timed_out = 0;
1092 eloop_register_timeout(wpa_s->sched_scan_timeout, 0,
1093 wpa_supplicant_sched_scan_timeout,
1095 wpa_s->first_sched_scan = 0;
1096 wpa_s->sched_scan_timeout /= 2;
1097 wpa_s->sched_scan_interval *= 2;
1105 * wpa_supplicant_cancel_scan - Cancel a scheduled scan request
1106 * @wpa_s: Pointer to wpa_supplicant data
1108 * This function is used to cancel a scan request scheduled with
1109 * wpa_supplicant_req_scan().
1111 void wpa_supplicant_cancel_scan(struct wpa_supplicant *wpa_s)
1113 wpa_dbg(wpa_s, MSG_DEBUG, "Cancelling scan request");
1114 eloop_cancel_timeout(wpa_supplicant_scan, wpa_s, NULL);
1116 wpa_supplicant_notify_scanning(wpa_s, 0);
1122 * wpa_supplicant_cancel_sched_scan - Stop running scheduled scans
1123 * @wpa_s: Pointer to wpa_supplicant data
1125 * This function is used to stop a periodic scheduled scan.
1127 void wpa_supplicant_cancel_sched_scan(struct wpa_supplicant *wpa_s)
1129 if (!wpa_s->sched_scanning)
1132 wpa_dbg(wpa_s, MSG_DEBUG, "Cancelling sched scan");
1133 eloop_cancel_timeout(wpa_supplicant_sched_scan_timeout, wpa_s, NULL);
1134 wpa_supplicant_stop_sched_scan(wpa_s);
1138 void wpa_supplicant_notify_scanning(struct wpa_supplicant *wpa_s,
1141 if (wpa_s->scanning != scanning) {
1143 if(!wpa_s->sched_scanning)
1144 wpa_s->scanning = scanning;
1146 wpa_s->scanning = scanning;
1148 wpas_notify_scanning(wpa_s);
1153 static int wpa_scan_get_max_rate(const struct wpa_scan_res *res)
1159 ie = wpa_scan_get_ie(res, WLAN_EID_SUPP_RATES);
1160 for (i = 0; ie && i < ie[1]; i++) {
1161 if ((ie[i + 2] & 0x7f) > rate)
1162 rate = ie[i + 2] & 0x7f;
1165 ie = wpa_scan_get_ie(res, WLAN_EID_EXT_SUPP_RATES);
1166 for (i = 0; ie && i < ie[1]; i++) {
1167 if ((ie[i + 2] & 0x7f) > rate)
1168 rate = ie[i + 2] & 0x7f;
1175 const u8 * wpa_scan_get_ie(const struct wpa_scan_res *res, u8 ie)
1177 const u8 *end, *pos;
1179 pos = (const u8 *) (res + 1);
1180 end = pos + res->ie_len;
1182 while (pos + 1 < end) {
1183 if (pos + 2 + pos[1] > end)
1194 const u8 * wpa_scan_get_vendor_ie(const struct wpa_scan_res *res,
1197 const u8 *end, *pos;
1199 pos = (const u8 *) (res + 1);
1200 end = pos + res->ie_len;
1202 while (pos + 1 < end) {
1203 if (pos + 2 + pos[1] > end)
1205 if (pos[0] == WLAN_EID_VENDOR_SPECIFIC && pos[1] >= 4 &&
1206 vendor_type == WPA_GET_BE32(&pos[2]))
1215 struct wpabuf * wpa_scan_get_vendor_ie_multi(const struct wpa_scan_res *res,
1219 const u8 *end, *pos;
1221 buf = wpabuf_alloc(res->ie_len);
1225 pos = (const u8 *) (res + 1);
1226 end = pos + res->ie_len;
1228 while (pos + 1 < end) {
1229 if (pos + 2 + pos[1] > end)
1231 if (pos[0] == WLAN_EID_VENDOR_SPECIFIC && pos[1] >= 4 &&
1232 vendor_type == WPA_GET_BE32(&pos[2]))
1233 wpabuf_put_data(buf, pos + 2 + 4, pos[1] - 4);
1237 if (wpabuf_len(buf) == 0) {
1246 struct wpabuf * wpa_scan_get_vendor_ie_multi_beacon(
1247 const struct wpa_scan_res *res, u32 vendor_type)
1250 const u8 *end, *pos;
1252 if (res->beacon_ie_len == 0)
1254 buf = wpabuf_alloc(res->beacon_ie_len);
1258 pos = (const u8 *) (res + 1);
1260 end = pos + res->beacon_ie_len;
1262 while (pos + 1 < end) {
1263 if (pos + 2 + pos[1] > end)
1265 if (pos[0] == WLAN_EID_VENDOR_SPECIFIC && pos[1] >= 4 &&
1266 vendor_type == WPA_GET_BE32(&pos[2]))
1267 wpabuf_put_data(buf, pos + 2 + 4, pos[1] - 4);
1271 if (wpabuf_len(buf) == 0) {
1281 * Channels with a great SNR can operate at full rate. What is a great SNR?
1282 * This doc https://supportforums.cisco.com/docs/DOC-12954 says, "the general
1283 * rule of thumb is that any SNR above 20 is good." This one
1284 * http://www.cisco.com/en/US/tech/tk722/tk809/technologies_q_and_a_item09186a00805e9a96.shtml#qa23
1285 * recommends 25 as a minimum SNR for 54 Mbps data rate. 30 is chosen here as a
1286 * conservative value.
1288 #define GREAT_SNR 30
1290 /* Compare function for sorting scan results. Return >0 if @b is considered
1292 static int wpa_scan_result_compar(const void *a, const void *b)
1294 #define IS_5GHZ(n) (n > 4000)
1295 #define MIN(a,b) a < b ? a : b
1296 struct wpa_scan_res **_wa = (void *) a;
1297 struct wpa_scan_res **_wb = (void *) b;
1298 struct wpa_scan_res *wa = *_wa;
1299 struct wpa_scan_res *wb = *_wb;
1300 int wpa_a, wpa_b, maxrate_a, maxrate_b;
1303 /* WPA/WPA2 support preferred */
1304 wpa_a = wpa_scan_get_vendor_ie(wa, WPA_IE_VENDOR_TYPE) != NULL ||
1305 wpa_scan_get_ie(wa, WLAN_EID_RSN) != NULL;
1306 wpa_b = wpa_scan_get_vendor_ie(wb, WPA_IE_VENDOR_TYPE) != NULL ||
1307 wpa_scan_get_ie(wb, WLAN_EID_RSN) != NULL;
1309 if (wpa_b && !wpa_a)
1311 if (!wpa_b && wpa_a)
1314 /* privacy support preferred */
1315 if ((wa->caps & IEEE80211_CAP_PRIVACY) == 0 &&
1316 (wb->caps & IEEE80211_CAP_PRIVACY))
1318 if ((wa->caps & IEEE80211_CAP_PRIVACY) &&
1319 (wb->caps & IEEE80211_CAP_PRIVACY) == 0)
1322 if ((wa->flags & wb->flags & WPA_SCAN_LEVEL_DBM) &&
1323 !((wa->flags | wb->flags) & WPA_SCAN_NOISE_INVALID)) {
1324 snr_a = MIN(wa->level - wa->noise, GREAT_SNR);
1325 snr_b = MIN(wb->level - wb->noise, GREAT_SNR);
1327 /* Not suitable information to calculate SNR, so use level */
1332 /* best/max rate preferred if SNR close enough */
1333 if ((snr_a && snr_b && abs(snr_b - snr_a) < 5) ||
1334 (wa->qual && wb->qual && abs(wb->qual - wa->qual) < 10)) {
1335 maxrate_a = wpa_scan_get_max_rate(wa);
1336 maxrate_b = wpa_scan_get_max_rate(wb);
1337 if (maxrate_a != maxrate_b)
1338 return maxrate_b - maxrate_a;
1339 if (IS_5GHZ(wa->freq) ^ IS_5GHZ(wb->freq))
1340 return IS_5GHZ(wa->freq) ? -1 : 1;
1343 /* use freq for channel preference */
1345 /* all things being equal, use SNR; if SNRs are
1346 * identical, use quality values since some drivers may only report
1347 * that value and leave the signal level zero */
1349 return wb->qual - wa->qual;
1350 return snr_b - snr_a;
1357 /* Compare function for sorting scan results when searching a WPS AP for
1358 * provisioning. Return >0 if @b is considered better. */
1359 static int wpa_scan_result_wps_compar(const void *a, const void *b)
1361 struct wpa_scan_res **_wa = (void *) a;
1362 struct wpa_scan_res **_wb = (void *) b;
1363 struct wpa_scan_res *wa = *_wa;
1364 struct wpa_scan_res *wb = *_wb;
1365 int uses_wps_a, uses_wps_b;
1366 struct wpabuf *wps_a, *wps_b;
1369 /* Optimization - check WPS IE existence before allocated memory and
1370 * doing full reassembly. */
1371 uses_wps_a = wpa_scan_get_vendor_ie(wa, WPS_IE_VENDOR_TYPE) != NULL;
1372 uses_wps_b = wpa_scan_get_vendor_ie(wb, WPS_IE_VENDOR_TYPE) != NULL;
1373 if (uses_wps_a && !uses_wps_b)
1375 if (!uses_wps_a && uses_wps_b)
1378 if (uses_wps_a && uses_wps_b) {
1379 wps_a = wpa_scan_get_vendor_ie_multi(wa, WPS_IE_VENDOR_TYPE);
1380 wps_b = wpa_scan_get_vendor_ie_multi(wb, WPS_IE_VENDOR_TYPE);
1381 res = wps_ap_priority_compar(wps_a, wps_b);
1389 * Do not use current AP security policy as a sorting criteria during
1390 * WPS provisioning step since the AP may get reconfigured at the
1391 * completion of provisioning.
1394 /* all things being equal, use signal level; if signal levels are
1395 * identical, use quality values since some drivers may only report
1396 * that value and leave the signal level zero */
1397 if (wb->level == wa->level)
1398 return wb->qual - wa->qual;
1399 return wb->level - wa->level;
1401 #endif /* CONFIG_WPS */
1404 static void dump_scan_res(struct wpa_scan_results *scan_res)
1406 #ifndef CONFIG_NO_STDOUT_DEBUG
1409 if (scan_res->res == NULL || scan_res->num == 0)
1412 wpa_printf(MSG_EXCESSIVE, "Sorted scan results");
1414 for (i = 0; i < scan_res->num; i++) {
1415 struct wpa_scan_res *r = scan_res->res[i];
1417 if ((r->flags & (WPA_SCAN_LEVEL_DBM | WPA_SCAN_NOISE_INVALID))
1418 == WPA_SCAN_LEVEL_DBM) {
1419 int snr = r->level - r->noise;
1420 wpa_printf(MSG_EXCESSIVE, MACSTR " freq=%d qual=%d "
1421 "noise=%d level=%d snr=%d%s flags=0x%x",
1422 MAC2STR(r->bssid), r->freq, r->qual,
1423 r->noise, r->level, snr,
1424 snr >= GREAT_SNR ? "*" : "", r->flags);
1426 wpa_printf(MSG_EXCESSIVE, MACSTR " freq=%d qual=%d "
1427 "noise=%d level=%d flags=0x%x",
1428 MAC2STR(r->bssid), r->freq, r->qual,
1429 r->noise, r->level, r->flags);
1431 pos = (u8 *) (r + 1);
1433 wpa_hexdump(MSG_EXCESSIVE, "IEs", pos, r->ie_len);
1435 if (r->beacon_ie_len)
1436 wpa_hexdump(MSG_EXCESSIVE, "Beacon IEs",
1437 pos, r->beacon_ie_len);
1439 #endif /* CONFIG_NO_STDOUT_DEBUG */
1443 int wpa_supplicant_filter_bssid_match(struct wpa_supplicant *wpa_s,
1448 if (wpa_s->bssid_filter == NULL)
1451 for (i = 0; i < wpa_s->bssid_filter_count; i++) {
1452 if (os_memcmp(wpa_s->bssid_filter + i * ETH_ALEN, bssid,
1461 static void filter_scan_res(struct wpa_supplicant *wpa_s,
1462 struct wpa_scan_results *res)
1466 if (wpa_s->bssid_filter == NULL)
1469 for (i = 0, j = 0; i < res->num; i++) {
1470 if (wpa_supplicant_filter_bssid_match(wpa_s,
1471 res->res[i]->bssid)) {
1472 res->res[j++] = res->res[i];
1474 os_free(res->res[i]);
1479 if (res->num != j) {
1480 wpa_printf(MSG_DEBUG, "Filtered out %d scan results",
1481 (int) (res->num - j));
1488 * wpa_supplicant_get_scan_results - Get scan results
1489 * @wpa_s: Pointer to wpa_supplicant data
1490 * @info: Information about what was scanned or %NULL if not available
1491 * @new_scan: Whether a new scan was performed
1492 * Returns: Scan results, %NULL on failure
1494 * This function request the current scan results from the driver and updates
1495 * the local BSS list wpa_s->bss. The caller is responsible for freeing the
1496 * results with wpa_scan_results_free().
1498 struct wpa_scan_results *
1499 wpa_supplicant_get_scan_results(struct wpa_supplicant *wpa_s,
1500 struct scan_info *info, int new_scan)
1502 struct wpa_scan_results *scan_res;
1504 int (*compar)(const void *, const void *) = wpa_scan_result_compar;
1506 scan_res = wpa_drv_get_scan_results2(wpa_s);
1507 if (scan_res == NULL) {
1508 wpa_dbg(wpa_s, MSG_DEBUG, "Failed to get scan results");
1511 filter_scan_res(wpa_s, scan_res);
1514 if (wpas_wps_in_progress(wpa_s)) {
1515 wpa_dbg(wpa_s, MSG_DEBUG, "WPS: Order scan results with WPS "
1516 "provisioning rules");
1517 compar = wpa_scan_result_wps_compar;
1519 #endif /* CONFIG_WPS */
1521 qsort(scan_res->res, scan_res->num, sizeof(struct wpa_scan_res *),
1523 dump_scan_res(scan_res);
1525 wpa_bss_update_start(wpa_s);
1526 for (i = 0; i < scan_res->num; i++)
1527 wpa_bss_update_scan_res(wpa_s, scan_res->res[i]);
1528 wpa_bss_update_end(wpa_s, info, new_scan);
1534 int wpa_supplicant_update_scan_results(struct wpa_supplicant *wpa_s)
1536 struct wpa_scan_results *scan_res;
1537 scan_res = wpa_supplicant_get_scan_results(wpa_s, NULL, 0);
1538 if (scan_res == NULL)
1540 wpa_scan_results_free(scan_res);