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"
25 static void wpa_supplicant_gen_assoc_event(struct wpa_supplicant *wpa_s)
27 struct wpa_ssid *ssid;
28 union wpa_event_data data;
30 ssid = wpa_supplicant_get_ssid(wpa_s);
34 if (wpa_s->current_ssid == NULL) {
35 wpa_s->current_ssid = ssid;
36 if (wpa_s->current_ssid != NULL)
37 wpas_notify_network_changed(wpa_s);
39 wpa_supplicant_initiate_eapol(wpa_s);
40 wpa_dbg(wpa_s, MSG_DEBUG, "Already associated with a configured "
41 "network - generating associated event");
42 os_memset(&data, 0, sizeof(data));
43 wpa_supplicant_event(wpa_s, EVENT_ASSOC, &data);
48 static int wpas_wps_in_use(struct wpa_supplicant *wpa_s,
49 enum wps_request_type *req_type)
51 struct wpa_ssid *ssid;
54 for (ssid = wpa_s->conf->ssid; ssid; ssid = ssid->next) {
55 if (!(ssid->key_mgmt & WPA_KEY_MGMT_WPS))
59 *req_type = wpas_wps_get_req_type(ssid);
60 if (!ssid->eap.phase1)
63 if (os_strstr(ssid->eap.phase1, "pbc=1"))
68 if (!wpa_s->global->p2p_disabled && wpa_s->global->p2p) {
69 wpa_s->wps->dev.p2p = 1;
72 *req_type = WPS_REQ_ENROLLEE_INFO;
75 #endif /* CONFIG_P2P */
79 #endif /* CONFIG_WPS */
82 int wpa_supplicant_enabled_networks(struct wpa_config *conf)
84 struct wpa_ssid *ssid = conf->ssid;
95 static void wpa_supplicant_assoc_try(struct wpa_supplicant *wpa_s,
96 struct wpa_ssid *ssid)
104 /* ap_scan=2 mode - try to associate with each SSID. */
106 wpa_dbg(wpa_s, MSG_DEBUG, "wpa_supplicant_assoc_try: Reached "
107 "end of scan list - go back to beginning");
108 wpa_s->prev_scan_ssid = WILDCARD_SSID_SCAN;
109 wpa_supplicant_req_scan(wpa_s, 0, 0);
113 /* Continue from the next SSID on the next attempt. */
114 wpa_s->prev_scan_ssid = ssid;
116 /* Start from the beginning of the SSID list. */
117 wpa_s->prev_scan_ssid = WILDCARD_SSID_SCAN;
119 wpa_supplicant_associate(wpa_s, NULL, ssid);
123 static int int_array_len(const int *a)
126 for (i = 0; a && a[i]; i++)
132 static void int_array_concat(int **res, const int *a)
137 reslen = int_array_len(*res);
138 alen = int_array_len(a);
140 n = os_realloc(*res, (reslen + alen + 1) * sizeof(int));
146 for (i = 0; i <= alen; i++)
147 n[reslen + i] = a[i];
152 static int freq_cmp(const void *a, const void *b)
165 static void int_array_sort_unique(int *a)
173 alen = int_array_len(a);
174 qsort(a, alen, sizeof(int), freq_cmp);
178 while (a[i] && a[j]) {
191 int wpa_supplicant_trigger_scan(struct wpa_supplicant *wpa_s,
192 struct wpa_driver_scan_params *params)
196 wpa_supplicant_notify_scanning(wpa_s, 1);
198 ret = wpa_drv_scan(wpa_s, params);
200 wpa_supplicant_notify_scanning(wpa_s, 0);
201 wpas_notify_scan_done(wpa_s, 0);
204 wpa_s->normal_scans++;
212 wpa_supplicant_delayed_sched_scan_timeout(void *eloop_ctx, void *timeout_ctx)
214 struct wpa_supplicant *wpa_s = eloop_ctx;
216 wpa_dbg(wpa_s, MSG_DEBUG, "Starting delayed sched scan");
218 if (wpa_supplicant_req_sched_scan(wpa_s))
219 wpa_supplicant_req_scan(wpa_s, 0, 0);
224 wpa_supplicant_sched_scan_timeout(void *eloop_ctx, void *timeout_ctx)
226 struct wpa_supplicant *wpa_s = eloop_ctx;
228 wpa_dbg(wpa_s, MSG_DEBUG, "Sched scan timeout - stopping it");
230 wpa_s->sched_scan_timed_out = 1;
231 wpa_supplicant_cancel_sched_scan(wpa_s);
236 wpa_supplicant_start_sched_scan(struct wpa_supplicant *wpa_s,
237 struct wpa_driver_scan_params *params,
242 wpa_supplicant_notify_scanning(wpa_s, 1);
243 ret = wpa_drv_sched_scan(wpa_s, params, interval * 1000);
245 wpa_supplicant_notify_scanning(wpa_s, 0);
247 wpa_s->sched_scanning = 1;
253 static int wpa_supplicant_stop_sched_scan(struct wpa_supplicant *wpa_s)
257 ret = wpa_drv_stop_sched_scan(wpa_s);
259 wpa_dbg(wpa_s, MSG_DEBUG, "stopping sched_scan failed!");
260 /* TODO: what to do if stopping fails? */
268 static struct wpa_driver_scan_filter *
269 wpa_supplicant_build_filter_ssids(struct wpa_config *conf, size_t *num_ssids)
271 struct wpa_driver_scan_filter *ssids;
272 struct wpa_ssid *ssid;
276 if (!conf->filter_ssids)
279 for (count = 0, ssid = conf->ssid; ssid; ssid = ssid->next) {
280 if (ssid->ssid && ssid->ssid_len)
285 ssids = os_zalloc(count * sizeof(struct wpa_driver_scan_filter));
289 for (ssid = conf->ssid; ssid; ssid = ssid->next) {
290 if (!ssid->ssid || !ssid->ssid_len)
292 os_memcpy(ssids[*num_ssids].ssid, ssid->ssid, ssid->ssid_len);
293 ssids[*num_ssids].ssid_len = ssid->ssid_len;
301 static void wpa_supplicant_optimize_freqs(
302 struct wpa_supplicant *wpa_s, struct wpa_driver_scan_params *params)
305 if (params->freqs == NULL && wpa_s->p2p_in_provisioning &&
307 /* Optimize provisioning state scan based on GO information */
308 if (wpa_s->p2p_in_provisioning < 5 &&
309 wpa_s->go_params->freq > 0) {
310 wpa_dbg(wpa_s, MSG_DEBUG, "P2P: Scan only GO "
311 "preferred frequency %d MHz",
312 wpa_s->go_params->freq);
313 params->freqs = os_zalloc(2 * sizeof(int));
315 params->freqs[0] = wpa_s->go_params->freq;
316 } else if (wpa_s->p2p_in_provisioning < 8 &&
317 wpa_s->go_params->freq_list[0]) {
318 wpa_dbg(wpa_s, MSG_DEBUG, "P2P: Scan only common "
320 int_array_concat(¶ms->freqs,
321 wpa_s->go_params->freq_list);
323 int_array_sort_unique(params->freqs);
325 wpa_s->p2p_in_provisioning++;
327 #endif /* CONFIG_P2P */
330 if (params->freqs == NULL && wpa_s->after_wps && wpa_s->wps_freq) {
332 * Optimize post-provisioning scan based on channel used
333 * during provisioning.
335 wpa_dbg(wpa_s, MSG_DEBUG, "WPS: Scan only frequency %u MHz "
336 "that was used during provisioning", wpa_s->wps_freq);
337 params->freqs = os_zalloc(2 * sizeof(int));
339 params->freqs[0] = wpa_s->wps_freq;
343 if (params->freqs == NULL && wpa_s->known_wps_freq && wpa_s->wps_freq)
345 /* Optimize provisioning scan based on already known channel */
346 wpa_dbg(wpa_s, MSG_DEBUG, "WPS: Scan only frequency %u MHz",
348 params->freqs = os_zalloc(2 * sizeof(int));
350 params->freqs[0] = wpa_s->wps_freq;
351 wpa_s->known_wps_freq = 0; /* only do this once */
353 #endif /* CONFIG_WPS */
357 #ifdef CONFIG_INTERWORKING
358 static void wpas_add_interworking_elements(struct wpa_supplicant *wpa_s,
361 if (wpa_s->conf->interworking == 0)
364 wpabuf_put_u8(buf, WLAN_EID_EXT_CAPAB);
365 wpabuf_put_u8(buf, 4);
366 wpabuf_put_u8(buf, 0x00);
367 wpabuf_put_u8(buf, 0x00);
368 wpabuf_put_u8(buf, 0x00);
369 wpabuf_put_u8(buf, 0x80); /* Bit 31 - Interworking */
371 wpabuf_put_u8(buf, WLAN_EID_INTERWORKING);
372 wpabuf_put_u8(buf, is_zero_ether_addr(wpa_s->conf->hessid) ? 1 :
374 wpabuf_put_u8(buf, wpa_s->conf->access_network_type);
376 if (!is_zero_ether_addr(wpa_s->conf->hessid))
377 wpabuf_put_data(buf, wpa_s->conf->hessid, ETH_ALEN);
379 #endif /* CONFIG_INTERWORKING */
382 static struct wpabuf *
383 wpa_supplicant_extra_ies(struct wpa_supplicant *wpa_s,
384 struct wpa_driver_scan_params *params)
386 struct wpabuf *extra_ie = NULL;
389 enum wps_request_type req_type = WPS_REQ_ENROLLEE_INFO;
390 #endif /* CONFIG_WPS */
392 #ifdef CONFIG_INTERWORKING
393 if (wpa_s->conf->interworking &&
394 wpabuf_resize(&extra_ie, 100) == 0)
395 wpas_add_interworking_elements(wpa_s, extra_ie);
396 #endif /* CONFIG_INTERWORKING */
399 wps = wpas_wps_in_use(wpa_s, &req_type);
402 struct wpabuf *wps_ie;
403 wps_ie = wps_build_probe_req_ie(wps == 2, &wpa_s->wps->dev,
404 wpa_s->wps->uuid, req_type,
407 if (wpabuf_resize(&extra_ie, wpabuf_len(wps_ie)) == 0)
408 wpabuf_put_buf(extra_ie, wps_ie);
415 size_t ielen = p2p_scan_ie_buf_len(wpa_s->global->p2p);
416 if (wpabuf_resize(&extra_ie, ielen) == 0)
417 wpas_p2p_scan_ie(wpa_s, extra_ie);
419 #endif /* CONFIG_P2P */
421 #endif /* CONFIG_WPS */
427 static void wpa_supplicant_scan(void *eloop_ctx, void *timeout_ctx)
429 struct wpa_supplicant *wpa_s = eloop_ctx;
430 struct wpa_ssid *ssid;
431 int scan_req = 0, ret;
432 struct wpabuf *extra_ie;
433 struct wpa_driver_scan_params params;
435 enum wpa_states prev_state;
437 if (wpa_s->wpa_state == WPA_INTERFACE_DISABLED) {
438 wpa_dbg(wpa_s, MSG_DEBUG, "Skip scan - interface disabled");
442 if (wpa_s->disconnected && !wpa_s->scan_req) {
443 wpa_supplicant_set_state(wpa_s, WPA_DISCONNECTED);
447 if (!wpa_supplicant_enabled_networks(wpa_s->conf) &&
449 wpa_dbg(wpa_s, MSG_DEBUG, "No enabled networks - do not scan");
450 wpa_supplicant_set_state(wpa_s, WPA_INACTIVE);
454 if (wpa_s->conf->ap_scan != 0 &&
455 (wpa_s->drv_flags & WPA_DRIVER_FLAGS_WIRED)) {
456 wpa_dbg(wpa_s, MSG_DEBUG, "Using wired authentication - "
457 "overriding ap_scan configuration");
458 wpa_s->conf->ap_scan = 0;
459 wpas_notify_ap_scan_changed(wpa_s);
462 if (wpa_s->conf->ap_scan == 0) {
463 wpa_supplicant_gen_assoc_event(wpa_s);
468 if (wpas_p2p_in_progress(wpa_s)) {
469 if (wpa_s->wpa_state == WPA_SCANNING) {
470 wpa_dbg(wpa_s, MSG_DEBUG, "Delay station mode scan "
471 "while P2P operation is in progress");
472 wpa_supplicant_req_scan(wpa_s, 5, 0);
474 wpa_dbg(wpa_s, MSG_DEBUG, "Do not request scan while "
475 "P2P operation is in progress");
479 #endif /* CONFIG_P2P */
481 if (wpa_s->conf->ap_scan == 2)
484 max_ssids = wpa_s->max_scan_ssids;
485 if (max_ssids > WPAS_MAX_SCAN_SSIDS)
486 max_ssids = WPAS_MAX_SCAN_SSIDS;
489 scan_req = wpa_s->scan_req;
492 os_memset(¶ms, 0, sizeof(params));
494 prev_state = wpa_s->wpa_state;
495 if (wpa_s->wpa_state == WPA_DISCONNECTED ||
496 wpa_s->wpa_state == WPA_INACTIVE)
497 wpa_supplicant_set_state(wpa_s, WPA_SCANNING);
499 if (scan_req != 2 && wpa_s->connect_without_scan) {
500 for (ssid = wpa_s->conf->ssid; ssid; ssid = ssid->next) {
501 if (ssid == wpa_s->connect_without_scan)
504 wpa_s->connect_without_scan = NULL;
506 wpa_printf(MSG_DEBUG, "Start a pre-selected network "
507 "without scan step");
508 wpa_supplicant_associate(wpa_s, NULL, ssid);
513 /* Find the starting point from which to continue scanning */
514 ssid = wpa_s->conf->ssid;
515 if (wpa_s->prev_scan_ssid != WILDCARD_SSID_SCAN) {
517 if (ssid == wpa_s->prev_scan_ssid) {
525 if (scan_req != 2 && wpa_s->conf->ap_scan == 2) {
526 wpa_s->connect_without_scan = NULL;
527 wpa_s->prev_scan_wildcard = 0;
528 wpa_supplicant_assoc_try(wpa_s, ssid);
530 } else if (wpa_s->conf->ap_scan == 2) {
532 * User-initiated scan request in ap_scan == 2; scan with
537 struct wpa_ssid *start = ssid, *tssid;
539 if (ssid == NULL && max_ssids > 1)
540 ssid = wpa_s->conf->ssid;
542 if (!ssid->disabled && ssid->scan_ssid) {
543 wpa_hexdump_ascii(MSG_DEBUG, "Scan SSID",
544 ssid->ssid, ssid->ssid_len);
545 params.ssids[params.num_ssids].ssid =
547 params.ssids[params.num_ssids].ssid_len =
550 if (params.num_ssids + 1 >= max_ssids)
556 if (ssid == NULL && max_ssids > 1 &&
557 start != wpa_s->conf->ssid)
558 ssid = wpa_s->conf->ssid;
561 for (tssid = wpa_s->conf->ssid; tssid; tssid = tssid->next) {
564 if ((params.freqs || !freqs_set) && tssid->scan_freq) {
565 int_array_concat(¶ms.freqs,
568 os_free(params.freqs);
573 int_array_sort_unique(params.freqs);
576 if (ssid && max_ssids == 1) {
578 * If the driver is limited to 1 SSID at a time interleave
579 * wildcard SSID scans with specific SSID scans to avoid
580 * waiting a long time for a wildcard scan.
582 if (!wpa_s->prev_scan_wildcard) {
583 params.ssids[0].ssid = NULL;
584 params.ssids[0].ssid_len = 0;
585 wpa_s->prev_scan_wildcard = 1;
586 wpa_dbg(wpa_s, MSG_DEBUG, "Starting AP scan for "
587 "wildcard SSID (Interleave with specific)");
589 wpa_s->prev_scan_ssid = ssid;
590 wpa_s->prev_scan_wildcard = 0;
591 wpa_dbg(wpa_s, MSG_DEBUG,
592 "Starting AP scan for specific SSID: %s",
593 wpa_ssid_txt(ssid->ssid, ssid->ssid_len));
598 wpa_s->prev_scan_ssid = ssid;
599 wpa_dbg(wpa_s, MSG_DEBUG, "Include wildcard SSID in "
603 wpa_s->prev_scan_ssid = WILDCARD_SSID_SCAN;
605 wpa_dbg(wpa_s, MSG_DEBUG, "Starting AP scan for wildcard "
609 wpa_supplicant_optimize_freqs(wpa_s, ¶ms);
610 extra_ie = wpa_supplicant_extra_ies(wpa_s, ¶ms);
612 if (params.freqs == NULL && wpa_s->next_scan_freqs) {
613 wpa_dbg(wpa_s, MSG_DEBUG, "Optimize scan based on previously "
614 "generated frequency list");
615 params.freqs = wpa_s->next_scan_freqs;
617 os_free(wpa_s->next_scan_freqs);
618 wpa_s->next_scan_freqs = NULL;
620 params.filter_ssids = wpa_supplicant_build_filter_ssids(
621 wpa_s->conf, ¶ms.num_filter_ssids);
623 params.extra_ies = wpabuf_head(extra_ie);
624 params.extra_ies_len = wpabuf_len(extra_ie);
628 if (wpa_s->p2p_in_provisioning) {
630 * The interface may not yet be in P2P mode, so we have to
631 * explicitly request P2P probe to disable CCK rates.
633 params.p2p_probe = 1;
635 #endif /* CONFIG_P2P */
637 ret = wpa_supplicant_trigger_scan(wpa_s, ¶ms);
639 wpabuf_free(extra_ie);
640 os_free(params.freqs);
641 os_free(params.filter_ssids);
644 wpa_msg(wpa_s, MSG_WARNING, "Failed to initiate AP scan");
645 if (prev_state != wpa_s->wpa_state)
646 wpa_supplicant_set_state(wpa_s, prev_state);
647 wpa_supplicant_req_scan(wpa_s, 1, 0);
653 * wpa_supplicant_req_scan - Schedule a scan for neighboring access points
654 * @wpa_s: Pointer to wpa_supplicant data
655 * @sec: Number of seconds after which to scan
656 * @usec: Number of microseconds after which to scan
658 * This function is used to schedule a scan for neighboring access points after
659 * the specified time.
661 void wpa_supplicant_req_scan(struct wpa_supplicant *wpa_s, int sec, int usec)
663 /* If there's at least one network that should be specifically scanned
664 * then don't cancel the scan and reschedule. Some drivers do
665 * background scanning which generates frequent scan results, and that
666 * causes the specific SSID scan to get continually pushed back and
667 * never happen, which causes hidden APs to never get probe-scanned.
669 if (eloop_is_timeout_registered(wpa_supplicant_scan, wpa_s, NULL) &&
670 wpa_s->conf->ap_scan == 1) {
671 struct wpa_ssid *ssid = wpa_s->conf->ssid;
674 if (!ssid->disabled && ssid->scan_ssid)
679 wpa_dbg(wpa_s, MSG_DEBUG, "Not rescheduling scan to "
680 "ensure that specific SSID scans occur");
685 wpa_dbg(wpa_s, MSG_DEBUG, "Setting scan request: %d sec %d usec",
687 eloop_cancel_timeout(wpa_supplicant_scan, wpa_s, NULL);
688 eloop_register_timeout(sec, usec, wpa_supplicant_scan, wpa_s, NULL);
693 * wpa_supplicant_delayed_sched_scan - Request a delayed scheduled scan
694 * @wpa_s: Pointer to wpa_supplicant data
695 * @sec: Number of seconds after which to scan
696 * @usec: Number of microseconds after which to scan
698 * This function is used to schedule periodic scans for neighboring
699 * access points after the specified time.
701 int wpa_supplicant_delayed_sched_scan(struct wpa_supplicant *wpa_s,
704 if (!wpa_s->sched_scan_supported)
707 eloop_register_timeout(sec, usec,
708 wpa_supplicant_delayed_sched_scan_timeout,
716 * wpa_supplicant_req_sched_scan - Start a periodic scheduled scan
717 * @wpa_s: Pointer to wpa_supplicant data
719 * This function is used to schedule periodic scans for neighboring
720 * access points repeating the scan continuously.
722 int wpa_supplicant_req_sched_scan(struct wpa_supplicant *wpa_s)
724 struct wpa_driver_scan_params params;
725 enum wpa_states prev_state;
726 struct wpa_ssid *ssid;
727 struct wpabuf *wps_ie = NULL;
729 unsigned int max_sched_scan_ssids;
733 if (!wpa_s->sched_scan_supported)
736 if (wpa_s->max_sched_scan_ssids > WPAS_MAX_SCAN_SSIDS)
737 max_sched_scan_ssids = WPAS_MAX_SCAN_SSIDS;
739 max_sched_scan_ssids = wpa_s->max_sched_scan_ssids;
740 if (max_sched_scan_ssids < 1)
743 if (wpa_s->sched_scanning) {
744 wpa_dbg(wpa_s, MSG_DEBUG, "Already sched scanning");
749 for (ssid = wpa_s->conf->ssid; ssid; ssid = ssid->next) {
750 if (!ssid->disabled && !ssid->scan_ssid) {
751 /* Use wildcard SSID to find this network */
753 } else if (!ssid->disabled && ssid->ssid_len)
757 if (!ssid->disabled && ssid->key_mgmt == WPA_KEY_MGMT_WPS) {
759 * Normal scan is more reliable and faster for WPS
760 * operations and since these are for short periods of
761 * time, the benefit of trying to use sched_scan would
764 wpa_dbg(wpa_s, MSG_DEBUG, "Use normal scan instead of "
765 "sched_scan for WPS");
768 #endif /* CONFIG_WPS */
773 if (wpa_s->normal_scans < 3 &&
774 (need_ssids <= wpa_s->max_scan_ssids ||
775 wpa_s->max_scan_ssids >= (int) max_sched_scan_ssids)) {
777 * When normal scan can speed up operations, use that for the
778 * first operations before starting the sched_scan to allow
779 * user space sleep more. We do this only if the normal scan
780 * has functionality that is suitable for this or if the
781 * sched_scan does not have better support for multiple SSIDs.
783 wpa_dbg(wpa_s, MSG_DEBUG, "Use normal scan instead of "
784 "sched_scan for initial scans (normal_scans=%d)",
785 wpa_s->normal_scans);
789 os_memset(¶ms, 0, sizeof(params));
791 /* If we can't allocate space for the filters, we just don't filter */
792 params.filter_ssids = os_zalloc(wpa_s->max_match_sets *
793 sizeof(struct wpa_driver_scan_filter));
795 prev_state = wpa_s->wpa_state;
796 if (wpa_s->wpa_state == WPA_DISCONNECTED ||
797 wpa_s->wpa_state == WPA_INACTIVE)
798 wpa_supplicant_set_state(wpa_s, WPA_SCANNING);
800 /* Find the starting point from which to continue scanning */
801 ssid = wpa_s->conf->ssid;
802 if (wpa_s->prev_sched_ssid) {
804 if (ssid == wpa_s->prev_sched_ssid) {
812 if (!ssid || !wpa_s->prev_sched_ssid) {
813 wpa_dbg(wpa_s, MSG_DEBUG, "Beginning of SSID list");
815 wpa_s->sched_scan_interval = 10;
816 wpa_s->sched_scan_timeout = max_sched_scan_ssids * 2;
817 wpa_s->first_sched_scan = 1;
818 ssid = wpa_s->conf->ssid;
819 wpa_s->prev_sched_ssid = ssid;
823 wpa_dbg(wpa_s, MSG_DEBUG, "Add wildcard SSID to sched_scan");
831 if (params.num_filter_ssids < wpa_s->max_match_sets &&
832 params.filter_ssids && ssid->ssid && ssid->ssid_len) {
833 wpa_dbg(wpa_s, MSG_DEBUG, "add to filter ssid: %s",
834 wpa_ssid_txt(ssid->ssid, ssid->ssid_len));
835 os_memcpy(params.filter_ssids[params.num_filter_ssids].ssid,
836 ssid->ssid, ssid->ssid_len);
837 params.filter_ssids[params.num_filter_ssids].ssid_len =
839 params.num_filter_ssids++;
840 } else if (params.filter_ssids && ssid->ssid && ssid->ssid_len)
842 wpa_dbg(wpa_s, MSG_DEBUG, "Not enough room for SSID "
843 "filter for sched_scan - drop filter");
844 os_free(params.filter_ssids);
845 params.filter_ssids = NULL;
846 params.num_filter_ssids = 0;
849 if (ssid->scan_ssid && ssid->ssid && ssid->ssid_len) {
850 if (params.num_ssids == max_sched_scan_ssids)
851 break; /* only room for broadcast SSID */
852 wpa_dbg(wpa_s, MSG_DEBUG,
853 "add to active scan ssid: %s",
854 wpa_ssid_txt(ssid->ssid, ssid->ssid_len));
855 params.ssids[params.num_ssids].ssid =
857 params.ssids[params.num_ssids].ssid_len =
860 if (params.num_ssids >= max_sched_scan_ssids) {
861 wpa_s->prev_sched_ssid = ssid;
867 wpa_s->prev_sched_ssid = ssid;
871 if (params.num_filter_ssids == 0) {
872 os_free(params.filter_ssids);
873 params.filter_ssids = NULL;
877 wps_ie = wpa_supplicant_extra_ies(wpa_s, ¶ms);
879 if (ssid || !wpa_s->first_sched_scan) {
880 wpa_dbg(wpa_s, MSG_DEBUG,
881 "Starting sched scan: interval %d (no timeout)",
882 wpa_s->sched_scan_interval);
884 wpa_dbg(wpa_s, MSG_DEBUG,
885 "Starting sched scan: interval %d timeout %d",
886 wpa_s->sched_scan_interval, wpa_s->sched_scan_timeout);
889 ret = wpa_supplicant_start_sched_scan(wpa_s, ¶ms,
890 wpa_s->sched_scan_interval);
892 os_free(params.filter_ssids);
894 wpa_msg(wpa_s, MSG_WARNING, "Failed to initiate sched scan");
895 if (prev_state != wpa_s->wpa_state)
896 wpa_supplicant_set_state(wpa_s, prev_state);
900 /* If we have more SSIDs to scan, add a timeout so we scan them too */
901 if (ssid || !wpa_s->first_sched_scan) {
902 wpa_s->sched_scan_timed_out = 0;
903 eloop_register_timeout(wpa_s->sched_scan_timeout, 0,
904 wpa_supplicant_sched_scan_timeout,
906 wpa_s->first_sched_scan = 0;
907 wpa_s->sched_scan_timeout /= 2;
908 wpa_s->sched_scan_interval *= 2;
916 * wpa_supplicant_cancel_scan - Cancel a scheduled scan request
917 * @wpa_s: Pointer to wpa_supplicant data
919 * This function is used to cancel a scan request scheduled with
920 * wpa_supplicant_req_scan().
922 void wpa_supplicant_cancel_scan(struct wpa_supplicant *wpa_s)
924 wpa_dbg(wpa_s, MSG_DEBUG, "Cancelling scan request");
925 eloop_cancel_timeout(wpa_supplicant_scan, wpa_s, NULL);
930 * wpa_supplicant_cancel_sched_scan - Stop running scheduled scans
931 * @wpa_s: Pointer to wpa_supplicant data
933 * This function is used to stop a periodic scheduled scan.
935 void wpa_supplicant_cancel_sched_scan(struct wpa_supplicant *wpa_s)
937 if (!wpa_s->sched_scanning)
940 wpa_dbg(wpa_s, MSG_DEBUG, "Cancelling sched scan");
941 eloop_cancel_timeout(wpa_supplicant_sched_scan_timeout, wpa_s, NULL);
942 wpa_supplicant_stop_sched_scan(wpa_s);
946 void wpa_supplicant_notify_scanning(struct wpa_supplicant *wpa_s,
949 if (wpa_s->scanning != scanning) {
950 wpa_s->scanning = scanning;
951 wpas_notify_scanning(wpa_s);
956 static int wpa_scan_get_max_rate(const struct wpa_scan_res *res)
962 ie = wpa_scan_get_ie(res, WLAN_EID_SUPP_RATES);
963 for (i = 0; ie && i < ie[1]; i++) {
964 if ((ie[i + 2] & 0x7f) > rate)
965 rate = ie[i + 2] & 0x7f;
968 ie = wpa_scan_get_ie(res, WLAN_EID_EXT_SUPP_RATES);
969 for (i = 0; ie && i < ie[1]; i++) {
970 if ((ie[i + 2] & 0x7f) > rate)
971 rate = ie[i + 2] & 0x7f;
978 const u8 * wpa_scan_get_ie(const struct wpa_scan_res *res, u8 ie)
982 pos = (const u8 *) (res + 1);
983 end = pos + res->ie_len;
985 while (pos + 1 < end) {
986 if (pos + 2 + pos[1] > end)
997 const u8 * wpa_scan_get_vendor_ie(const struct wpa_scan_res *res,
1000 const u8 *end, *pos;
1002 pos = (const u8 *) (res + 1);
1003 end = pos + res->ie_len;
1005 while (pos + 1 < end) {
1006 if (pos + 2 + pos[1] > end)
1008 if (pos[0] == WLAN_EID_VENDOR_SPECIFIC && pos[1] >= 4 &&
1009 vendor_type == WPA_GET_BE32(&pos[2]))
1018 struct wpabuf * wpa_scan_get_vendor_ie_multi(const struct wpa_scan_res *res,
1022 const u8 *end, *pos;
1024 buf = wpabuf_alloc(res->ie_len);
1028 pos = (const u8 *) (res + 1);
1029 end = pos + res->ie_len;
1031 while (pos + 1 < end) {
1032 if (pos + 2 + pos[1] > end)
1034 if (pos[0] == WLAN_EID_VENDOR_SPECIFIC && pos[1] >= 4 &&
1035 vendor_type == WPA_GET_BE32(&pos[2]))
1036 wpabuf_put_data(buf, pos + 2 + 4, pos[1] - 4);
1040 if (wpabuf_len(buf) == 0) {
1049 struct wpabuf * wpa_scan_get_vendor_ie_multi_beacon(
1050 const struct wpa_scan_res *res, u32 vendor_type)
1053 const u8 *end, *pos;
1055 if (res->beacon_ie_len == 0)
1057 buf = wpabuf_alloc(res->beacon_ie_len);
1061 pos = (const u8 *) (res + 1);
1063 end = pos + res->beacon_ie_len;
1065 while (pos + 1 < end) {
1066 if (pos + 2 + pos[1] > end)
1068 if (pos[0] == WLAN_EID_VENDOR_SPECIFIC && pos[1] >= 4 &&
1069 vendor_type == WPA_GET_BE32(&pos[2]))
1070 wpabuf_put_data(buf, pos + 2 + 4, pos[1] - 4);
1074 if (wpabuf_len(buf) == 0) {
1084 * Channels with a great SNR can operate at full rate. What is a great SNR?
1085 * This doc https://supportforums.cisco.com/docs/DOC-12954 says, "the general
1086 * rule of thumb is that any SNR above 20 is good." This one
1087 * http://www.cisco.com/en/US/tech/tk722/tk809/technologies_q_and_a_item09186a00805e9a96.shtml#qa23
1088 * recommends 25 as a minimum SNR for 54 Mbps data rate. 30 is chosen here as a
1089 * conservative value.
1091 #define GREAT_SNR 30
1093 /* Compare function for sorting scan results. Return >0 if @b is considered
1095 static int wpa_scan_result_compar(const void *a, const void *b)
1097 #define IS_5GHZ(n) (n > 4000)
1098 #define MIN(a,b) a < b ? a : b
1099 struct wpa_scan_res **_wa = (void *) a;
1100 struct wpa_scan_res **_wb = (void *) b;
1101 struct wpa_scan_res *wa = *_wa;
1102 struct wpa_scan_res *wb = *_wb;
1103 int wpa_a, wpa_b, maxrate_a, maxrate_b;
1106 /* WPA/WPA2 support preferred */
1107 wpa_a = wpa_scan_get_vendor_ie(wa, WPA_IE_VENDOR_TYPE) != NULL ||
1108 wpa_scan_get_ie(wa, WLAN_EID_RSN) != NULL;
1109 wpa_b = wpa_scan_get_vendor_ie(wb, WPA_IE_VENDOR_TYPE) != NULL ||
1110 wpa_scan_get_ie(wb, WLAN_EID_RSN) != NULL;
1112 if (wpa_b && !wpa_a)
1114 if (!wpa_b && wpa_a)
1117 /* privacy support preferred */
1118 if ((wa->caps & IEEE80211_CAP_PRIVACY) == 0 &&
1119 (wb->caps & IEEE80211_CAP_PRIVACY))
1121 if ((wa->caps & IEEE80211_CAP_PRIVACY) &&
1122 (wb->caps & IEEE80211_CAP_PRIVACY) == 0)
1125 if ((wa->flags & wb->flags & WPA_SCAN_LEVEL_DBM) &&
1126 !((wa->flags | wb->flags) & WPA_SCAN_NOISE_INVALID)) {
1127 snr_a = MIN(wa->level - wa->noise, GREAT_SNR);
1128 snr_b = MIN(wb->level - wb->noise, GREAT_SNR);
1130 /* Not suitable information to calculate SNR, so use level */
1135 /* best/max rate preferred if SNR close enough */
1136 if ((snr_a && snr_b && abs(snr_b - snr_a) < 5) ||
1137 (wa->qual && wb->qual && abs(wb->qual - wa->qual) < 10)) {
1138 maxrate_a = wpa_scan_get_max_rate(wa);
1139 maxrate_b = wpa_scan_get_max_rate(wb);
1140 if (maxrate_a != maxrate_b)
1141 return maxrate_b - maxrate_a;
1142 if (IS_5GHZ(wa->freq) ^ IS_5GHZ(wb->freq))
1143 return IS_5GHZ(wa->freq) ? -1 : 1;
1146 /* use freq for channel preference */
1148 /* all things being equal, use SNR; if SNRs are
1149 * identical, use quality values since some drivers may only report
1150 * that value and leave the signal level zero */
1152 return wb->qual - wa->qual;
1153 return snr_b - snr_a;
1160 /* Compare function for sorting scan results when searching a WPS AP for
1161 * provisioning. Return >0 if @b is considered better. */
1162 static int wpa_scan_result_wps_compar(const void *a, const void *b)
1164 struct wpa_scan_res **_wa = (void *) a;
1165 struct wpa_scan_res **_wb = (void *) b;
1166 struct wpa_scan_res *wa = *_wa;
1167 struct wpa_scan_res *wb = *_wb;
1168 int uses_wps_a, uses_wps_b;
1169 struct wpabuf *wps_a, *wps_b;
1172 /* Optimization - check WPS IE existence before allocated memory and
1173 * doing full reassembly. */
1174 uses_wps_a = wpa_scan_get_vendor_ie(wa, WPS_IE_VENDOR_TYPE) != NULL;
1175 uses_wps_b = wpa_scan_get_vendor_ie(wb, WPS_IE_VENDOR_TYPE) != NULL;
1176 if (uses_wps_a && !uses_wps_b)
1178 if (!uses_wps_a && uses_wps_b)
1181 if (uses_wps_a && uses_wps_b) {
1182 wps_a = wpa_scan_get_vendor_ie_multi(wa, WPS_IE_VENDOR_TYPE);
1183 wps_b = wpa_scan_get_vendor_ie_multi(wb, WPS_IE_VENDOR_TYPE);
1184 res = wps_ap_priority_compar(wps_a, wps_b);
1192 * Do not use current AP security policy as a sorting criteria during
1193 * WPS provisioning step since the AP may get reconfigured at the
1194 * completion of provisioning.
1197 /* all things being equal, use signal level; if signal levels are
1198 * identical, use quality values since some drivers may only report
1199 * that value and leave the signal level zero */
1200 if (wb->level == wa->level)
1201 return wb->qual - wa->qual;
1202 return wb->level - wa->level;
1204 #endif /* CONFIG_WPS */
1207 static void dump_scan_res(struct wpa_scan_results *scan_res)
1209 #ifndef CONFIG_NO_STDOUT_DEBUG
1212 if (scan_res->res == NULL || scan_res->num == 0)
1215 wpa_printf(MSG_EXCESSIVE, "Sorted scan results");
1217 for (i = 0; i < scan_res->num; i++) {
1218 struct wpa_scan_res *r = scan_res->res[i];
1219 if ((r->flags & (WPA_SCAN_LEVEL_DBM | WPA_SCAN_NOISE_INVALID))
1220 == WPA_SCAN_LEVEL_DBM) {
1221 int snr = r->level - r->noise;
1222 wpa_printf(MSG_EXCESSIVE, MACSTR " freq=%d qual=%d "
1223 "noise=%d level=%d snr=%d%s flags=0x%x",
1224 MAC2STR(r->bssid), r->freq, r->qual,
1225 r->noise, r->level, snr,
1226 snr >= GREAT_SNR ? "*" : "", r->flags);
1228 wpa_printf(MSG_EXCESSIVE, MACSTR " freq=%d qual=%d "
1229 "noise=%d level=%d flags=0x%x",
1230 MAC2STR(r->bssid), r->freq, r->qual,
1231 r->noise, r->level, r->flags);
1234 #endif /* CONFIG_NO_STDOUT_DEBUG */
1238 int wpa_supplicant_filter_bssid_match(struct wpa_supplicant *wpa_s,
1243 if (wpa_s->bssid_filter == NULL)
1246 for (i = 0; i < wpa_s->bssid_filter_count; i++) {
1247 if (os_memcmp(wpa_s->bssid_filter + i * ETH_ALEN, bssid,
1256 static void filter_scan_res(struct wpa_supplicant *wpa_s,
1257 struct wpa_scan_results *res)
1261 if (wpa_s->bssid_filter == NULL)
1264 for (i = 0, j = 0; i < res->num; i++) {
1265 if (wpa_supplicant_filter_bssid_match(wpa_s,
1266 res->res[i]->bssid)) {
1267 res->res[j++] = res->res[i];
1269 os_free(res->res[i]);
1274 if (res->num != j) {
1275 wpa_printf(MSG_DEBUG, "Filtered out %d scan results",
1276 (int) (res->num - j));
1283 * wpa_supplicant_get_scan_results - Get scan results
1284 * @wpa_s: Pointer to wpa_supplicant data
1285 * @info: Information about what was scanned or %NULL if not available
1286 * @new_scan: Whether a new scan was performed
1287 * Returns: Scan results, %NULL on failure
1289 * This function request the current scan results from the driver and updates
1290 * the local BSS list wpa_s->bss. The caller is responsible for freeing the
1291 * results with wpa_scan_results_free().
1293 struct wpa_scan_results *
1294 wpa_supplicant_get_scan_results(struct wpa_supplicant *wpa_s,
1295 struct scan_info *info, int new_scan)
1297 struct wpa_scan_results *scan_res;
1299 int (*compar)(const void *, const void *) = wpa_scan_result_compar;
1301 scan_res = wpa_drv_get_scan_results2(wpa_s);
1302 if (scan_res == NULL) {
1303 wpa_dbg(wpa_s, MSG_DEBUG, "Failed to get scan results");
1306 filter_scan_res(wpa_s, scan_res);
1309 if (wpas_wps_in_progress(wpa_s)) {
1310 wpa_dbg(wpa_s, MSG_DEBUG, "WPS: Order scan results with WPS "
1311 "provisioning rules");
1312 compar = wpa_scan_result_wps_compar;
1314 #endif /* CONFIG_WPS */
1316 qsort(scan_res->res, scan_res->num, sizeof(struct wpa_scan_res *),
1318 dump_scan_res(scan_res);
1320 wpa_bss_update_start(wpa_s);
1321 for (i = 0; i < scan_res->num; i++)
1322 wpa_bss_update_scan_res(wpa_s, scan_res->res[i]);
1323 wpa_bss_update_end(wpa_s, info, new_scan);
1329 int wpa_supplicant_update_scan_results(struct wpa_supplicant *wpa_s)
1331 struct wpa_scan_results *scan_res;
1332 scan_res = wpa_supplicant_get_scan_results(wpa_s, NULL, 0);
1333 if (scan_res == NULL)
1335 wpa_scan_results_free(scan_res);