2 * WPA Supplicant - Scanning
3 * Copyright (c) 2003-2012, 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"
14 #include "common/wpa_ctrl.h"
16 #include "wpa_supplicant_i.h"
18 #include "wps_supplicant.h"
19 #include "p2p_supplicant.h"
21 #include "hs20_supplicant.h"
24 #include "gas_query.h"
28 static void wpa_supplicant_gen_assoc_event(struct wpa_supplicant *wpa_s)
30 struct wpa_ssid *ssid;
31 union wpa_event_data data;
33 ssid = wpa_supplicant_get_ssid(wpa_s);
37 if (wpa_s->current_ssid == NULL) {
38 wpa_s->current_ssid = ssid;
39 if (wpa_s->current_ssid != NULL)
40 wpas_notify_network_changed(wpa_s);
42 wpa_supplicant_initiate_eapol(wpa_s);
43 wpa_dbg(wpa_s, MSG_DEBUG, "Already associated with a configured "
44 "network - generating associated event");
45 os_memset(&data, 0, sizeof(data));
46 wpa_supplicant_event(wpa_s, EVENT_ASSOC, &data);
51 static int wpas_wps_in_use(struct wpa_supplicant *wpa_s,
52 enum wps_request_type *req_type)
54 struct wpa_ssid *ssid;
57 for (ssid = wpa_s->conf->ssid; ssid; ssid = ssid->next) {
58 if (!(ssid->key_mgmt & WPA_KEY_MGMT_WPS))
62 *req_type = wpas_wps_get_req_type(ssid);
63 if (!ssid->eap.phase1)
66 if (os_strstr(ssid->eap.phase1, "pbc=1"))
71 if (!wpa_s->global->p2p_disabled && wpa_s->global->p2p &&
72 !wpa_s->conf->p2p_disabled) {
73 wpa_s->wps->dev.p2p = 1;
76 *req_type = WPS_REQ_ENROLLEE_INFO;
79 #endif /* CONFIG_P2P */
83 #endif /* CONFIG_WPS */
87 * wpa_supplicant_enabled_networks - Check whether there are enabled networks
88 * @wpa_s: Pointer to wpa_supplicant data
89 * Returns: 0 if no networks are enabled, >0 if networks are enabled
91 * This function is used to figure out whether any networks (or Interworking
92 * with enabled credentials and auto_interworking) are present in the current
95 int wpa_supplicant_enabled_networks(struct wpa_supplicant *wpa_s)
97 struct wpa_ssid *ssid = wpa_s->conf->ssid;
98 int count = 0, disabled = 0;
100 if (!wpas_network_disabled(wpa_s, ssid))
106 if (wpa_s->conf->cred && wpa_s->conf->interworking &&
107 wpa_s->conf->auto_interworking)
109 if (count == 0 && disabled > 0) {
110 wpa_dbg(wpa_s, MSG_DEBUG, "No enabled networks (%d disabled "
111 "networks)", disabled);
117 static void wpa_supplicant_assoc_try(struct wpa_supplicant *wpa_s,
118 struct wpa_ssid *ssid)
121 if (!wpas_network_disabled(wpa_s, ssid))
126 /* ap_scan=2 mode - try to associate with each SSID. */
128 wpa_dbg(wpa_s, MSG_DEBUG, "wpa_supplicant_assoc_try: Reached "
129 "end of scan list - go back to beginning");
130 wpa_s->prev_scan_ssid = WILDCARD_SSID_SCAN;
131 wpa_supplicant_req_scan(wpa_s, 0, 0);
135 /* Continue from the next SSID on the next attempt. */
136 wpa_s->prev_scan_ssid = ssid;
138 /* Start from the beginning of the SSID list. */
139 wpa_s->prev_scan_ssid = WILDCARD_SSID_SCAN;
141 wpa_supplicant_associate(wpa_s, NULL, ssid);
146 * wpa_supplicant_trigger_scan - Request driver to start a scan
147 * @wpa_s: Pointer to wpa_supplicant data
148 * @params: Scan parameters
149 * Returns: 0 on success, -1 on failure
151 int wpa_supplicant_trigger_scan(struct wpa_supplicant *wpa_s,
152 struct wpa_driver_scan_params *params)
156 wpa_supplicant_notify_scanning(wpa_s, 1);
158 ret = wpa_drv_scan(wpa_s, params);
160 wpa_supplicant_notify_scanning(wpa_s, 0);
161 wpas_notify_scan_done(wpa_s, 0);
163 os_get_reltime(&wpa_s->scan_trigger_time);
165 wpa_s->normal_scans++;
166 wpa_s->own_scan_requested = 1;
174 wpa_supplicant_delayed_sched_scan_timeout(void *eloop_ctx, void *timeout_ctx)
176 struct wpa_supplicant *wpa_s = eloop_ctx;
178 wpa_dbg(wpa_s, MSG_DEBUG, "Starting delayed sched scan");
180 if (wpa_supplicant_req_sched_scan(wpa_s))
181 wpa_supplicant_req_scan(wpa_s, 0, 0);
186 wpa_supplicant_sched_scan_timeout(void *eloop_ctx, void *timeout_ctx)
188 struct wpa_supplicant *wpa_s = eloop_ctx;
190 wpa_dbg(wpa_s, MSG_DEBUG, "Sched scan timeout - stopping it");
192 wpa_s->sched_scan_timed_out = 1;
193 wpa_supplicant_cancel_sched_scan(wpa_s);
197 int wpa_supplicant_start_sched_scan(struct wpa_supplicant *wpa_s,
198 struct wpa_driver_scan_params *params,
203 wpa_supplicant_notify_scanning(wpa_s, 1);
204 ret = wpa_drv_sched_scan(wpa_s, params, interval * 1000);
206 wpa_supplicant_notify_scanning(wpa_s, 0);
208 wpa_s->sched_scanning = 1;
214 int wpa_supplicant_stop_sched_scan(struct wpa_supplicant *wpa_s)
218 ret = wpa_drv_stop_sched_scan(wpa_s);
220 wpa_dbg(wpa_s, MSG_DEBUG, "stopping sched_scan failed!");
221 /* TODO: what to do if stopping fails? */
229 static struct wpa_driver_scan_filter *
230 wpa_supplicant_build_filter_ssids(struct wpa_config *conf, size_t *num_ssids)
232 struct wpa_driver_scan_filter *ssids;
233 struct wpa_ssid *ssid;
237 if (!conf->filter_ssids)
240 for (count = 0, ssid = conf->ssid; ssid; ssid = ssid->next) {
241 if (ssid->ssid && ssid->ssid_len)
246 ssids = os_zalloc(count * sizeof(struct wpa_driver_scan_filter));
250 for (ssid = conf->ssid; ssid; ssid = ssid->next) {
251 if (!ssid->ssid || !ssid->ssid_len)
253 os_memcpy(ssids[*num_ssids].ssid, ssid->ssid, ssid->ssid_len);
254 ssids[*num_ssids].ssid_len = ssid->ssid_len;
262 static void wpa_supplicant_optimize_freqs(
263 struct wpa_supplicant *wpa_s, struct wpa_driver_scan_params *params)
266 if (params->freqs == NULL && wpa_s->p2p_in_provisioning &&
268 /* Optimize provisioning state scan based on GO information */
269 if (wpa_s->p2p_in_provisioning < 5 &&
270 wpa_s->go_params->freq > 0) {
271 wpa_dbg(wpa_s, MSG_DEBUG, "P2P: Scan only GO "
272 "preferred frequency %d MHz",
273 wpa_s->go_params->freq);
274 params->freqs = os_zalloc(2 * sizeof(int));
276 params->freqs[0] = wpa_s->go_params->freq;
277 } else if (wpa_s->p2p_in_provisioning < 8 &&
278 wpa_s->go_params->freq_list[0]) {
279 wpa_dbg(wpa_s, MSG_DEBUG, "P2P: Scan only common "
281 int_array_concat(¶ms->freqs,
282 wpa_s->go_params->freq_list);
284 int_array_sort_unique(params->freqs);
286 wpa_s->p2p_in_provisioning++;
288 #endif /* CONFIG_P2P */
291 if (params->freqs == NULL && wpa_s->after_wps && wpa_s->wps_freq) {
293 * Optimize post-provisioning scan based on channel used
294 * during provisioning.
296 wpa_dbg(wpa_s, MSG_DEBUG, "WPS: Scan only frequency %u MHz "
297 "that was used during provisioning", wpa_s->wps_freq);
298 params->freqs = os_zalloc(2 * sizeof(int));
300 params->freqs[0] = wpa_s->wps_freq;
304 if (params->freqs == NULL && wpa_s->known_wps_freq && wpa_s->wps_freq)
306 /* Optimize provisioning scan based on already known channel */
307 wpa_dbg(wpa_s, MSG_DEBUG, "WPS: Scan only frequency %u MHz",
309 params->freqs = os_zalloc(2 * sizeof(int));
311 params->freqs[0] = wpa_s->wps_freq;
312 wpa_s->known_wps_freq = 0; /* only do this once */
314 #endif /* CONFIG_WPS */
318 #ifdef CONFIG_INTERWORKING
319 static void wpas_add_interworking_elements(struct wpa_supplicant *wpa_s,
322 if (wpa_s->conf->interworking == 0)
325 wpabuf_put_u8(buf, WLAN_EID_EXT_CAPAB);
326 wpabuf_put_u8(buf, 4);
327 wpabuf_put_u8(buf, 0x00);
328 wpabuf_put_u8(buf, 0x00);
329 wpabuf_put_u8(buf, 0x00);
330 wpabuf_put_u8(buf, 0x80); /* Bit 31 - Interworking */
332 wpabuf_put_u8(buf, WLAN_EID_INTERWORKING);
333 wpabuf_put_u8(buf, is_zero_ether_addr(wpa_s->conf->hessid) ? 1 :
335 wpabuf_put_u8(buf, wpa_s->conf->access_network_type);
337 if (!is_zero_ether_addr(wpa_s->conf->hessid))
338 wpabuf_put_data(buf, wpa_s->conf->hessid, ETH_ALEN);
340 #endif /* CONFIG_INTERWORKING */
343 static struct wpabuf * wpa_supplicant_extra_ies(struct wpa_supplicant *wpa_s)
345 struct wpabuf *extra_ie = NULL;
348 enum wps_request_type req_type = WPS_REQ_ENROLLEE_INFO;
349 #endif /* CONFIG_WPS */
351 #ifdef CONFIG_INTERWORKING
352 if (wpa_s->conf->interworking &&
353 wpabuf_resize(&extra_ie, 100) == 0)
354 wpas_add_interworking_elements(wpa_s, extra_ie);
355 #endif /* CONFIG_INTERWORKING */
358 wps = wpas_wps_in_use(wpa_s, &req_type);
361 struct wpabuf *wps_ie;
362 wps_ie = wps_build_probe_req_ie(wps == 2 ? DEV_PW_PUSHBUTTON :
365 wpa_s->wps->uuid, req_type,
368 if (wpabuf_resize(&extra_ie, wpabuf_len(wps_ie)) == 0)
369 wpabuf_put_buf(extra_ie, wps_ie);
376 size_t ielen = p2p_scan_ie_buf_len(wpa_s->global->p2p);
377 if (wpabuf_resize(&extra_ie, ielen) == 0)
378 wpas_p2p_scan_ie(wpa_s, extra_ie);
380 #endif /* CONFIG_P2P */
382 #endif /* CONFIG_WPS */
385 if (wpa_s->conf->hs20 && wpabuf_resize(&extra_ie, 7) == 0)
386 wpas_hs20_add_indication(extra_ie);
387 #endif /* CONFIG_HS20 */
396 * Check whether there are any enabled networks or credentials that could be
397 * used for a non-P2P connection.
399 static int non_p2p_network_enabled(struct wpa_supplicant *wpa_s)
401 struct wpa_ssid *ssid;
403 for (ssid = wpa_s->conf->ssid; ssid; ssid = ssid->next) {
404 if (wpas_network_disabled(wpa_s, ssid))
406 if (!ssid->p2p_group)
410 if (wpa_s->conf->cred && wpa_s->conf->interworking &&
411 wpa_s->conf->auto_interworking)
417 #endif /* CONFIG_P2P */
420 static struct hostapd_hw_modes * get_mode(struct hostapd_hw_modes *modes,
422 enum hostapd_hw_mode mode)
426 for (i = 0; i < num_modes; i++) {
427 if (modes[i].mode == mode)
435 static void wpa_setband_scan_freqs_list(struct wpa_supplicant *wpa_s,
436 enum hostapd_hw_mode band,
437 struct wpa_driver_scan_params *params)
439 /* Include only supported channels for the specified band */
440 struct hostapd_hw_modes *mode;
443 mode = get_mode(wpa_s->hw.modes, wpa_s->hw.num_modes, band);
445 /* No channels supported in this band - use empty list */
446 params->freqs = os_zalloc(sizeof(int));
450 params->freqs = os_zalloc((mode->num_channels + 1) * sizeof(int));
451 if (params->freqs == NULL)
453 for (count = 0, i = 0; i < mode->num_channels; i++) {
454 if (mode->channels[i].flag & HOSTAPD_CHAN_DISABLED)
456 params->freqs[count++] = mode->channels[i].freq;
461 static void wpa_setband_scan_freqs(struct wpa_supplicant *wpa_s,
462 struct wpa_driver_scan_params *params)
464 if (wpa_s->hw.modes == NULL)
465 return; /* unknown what channels the driver supports */
467 return; /* already using a limited channel set */
468 if (wpa_s->setband == WPA_SETBAND_5G)
469 wpa_setband_scan_freqs_list(wpa_s, HOSTAPD_MODE_IEEE80211A,
471 else if (wpa_s->setband == WPA_SETBAND_2G)
472 wpa_setband_scan_freqs_list(wpa_s, HOSTAPD_MODE_IEEE80211G,
477 static void wpa_supplicant_scan(void *eloop_ctx, void *timeout_ctx)
479 struct wpa_supplicant *wpa_s = eloop_ctx;
480 struct wpa_ssid *ssid;
482 struct wpabuf *extra_ie = NULL;
483 struct wpa_driver_scan_params params;
484 struct wpa_driver_scan_params *scan_params;
486 enum wpa_states prev_state;
488 if (wpa_s->wpa_state == WPA_INTERFACE_DISABLED) {
489 wpa_dbg(wpa_s, MSG_DEBUG, "Skip scan - interface disabled");
490 wpas_p2p_continue_after_scan(wpa_s);
494 if (wpa_s->disconnected && wpa_s->scan_req == NORMAL_SCAN_REQ) {
495 wpa_dbg(wpa_s, MSG_DEBUG, "Disconnected - do not scan");
496 wpa_supplicant_set_state(wpa_s, WPA_DISCONNECTED);
497 wpas_p2p_continue_after_scan(wpa_s);
501 if (wpa_s->scanning) {
503 * If we are already in scanning state, we shall reschedule the
504 * the incoming scan request.
506 wpa_dbg(wpa_s, MSG_DEBUG, "Already scanning - Reschedule the incoming scan req");
507 wpa_supplicant_req_scan(wpa_s, 1, 0);
511 if (!wpa_supplicant_enabled_networks(wpa_s) &&
512 wpa_s->scan_req == NORMAL_SCAN_REQ) {
513 wpa_dbg(wpa_s, MSG_DEBUG, "No enabled networks - do not scan");
514 wpa_supplicant_set_state(wpa_s, WPA_INACTIVE);
515 wpas_p2p_continue_after_scan(wpa_s);
519 if (wpa_s->conf->ap_scan != 0 &&
520 (wpa_s->drv_flags & WPA_DRIVER_FLAGS_WIRED)) {
521 wpa_dbg(wpa_s, MSG_DEBUG, "Using wired authentication - "
522 "overriding ap_scan configuration");
523 wpa_s->conf->ap_scan = 0;
524 wpas_notify_ap_scan_changed(wpa_s);
527 if (wpa_s->conf->ap_scan == 0) {
528 wpa_supplicant_gen_assoc_event(wpa_s);
533 if (wpas_p2p_in_progress(wpa_s) || wpas_wpa_is_in_progress(wpa_s, 0)) {
534 if (wpa_s->sta_scan_pending &&
535 wpas_p2p_in_progress(wpa_s) == 2 &&
536 wpa_s->global->p2p_cb_on_scan_complete) {
537 wpa_dbg(wpa_s, MSG_DEBUG, "Process pending station "
538 "mode scan during P2P search");
540 wpa_dbg(wpa_s, MSG_DEBUG, "Delay station mode scan "
541 "while P2P operation is in progress");
542 wpa_s->sta_scan_pending = 1;
543 wpa_supplicant_req_scan(wpa_s, 5, 0);
547 #endif /* CONFIG_P2P */
550 if (gas_query_in_progress(wpa_s->gas)) {
551 wpa_dbg(wpa_s, MSG_DEBUG, "Delay scan while GAS query is in progress");
552 wpa_supplicant_req_scan(wpa_s, 1, 0);
555 #endif /* CONFIG_GAS */
557 if (wpa_s->conf->ap_scan == 2)
560 max_ssids = wpa_s->max_scan_ssids;
561 if (max_ssids > WPAS_MAX_SCAN_SSIDS)
562 max_ssids = WPAS_MAX_SCAN_SSIDS;
565 wpa_s->last_scan_req = wpa_s->scan_req;
566 wpa_s->scan_req = NORMAL_SCAN_REQ;
568 os_memset(¶ms, 0, sizeof(params));
570 prev_state = wpa_s->wpa_state;
571 if (wpa_s->wpa_state == WPA_DISCONNECTED ||
572 wpa_s->wpa_state == WPA_INACTIVE)
573 wpa_supplicant_set_state(wpa_s, WPA_SCANNING);
576 * If autoscan has set its own scanning parameters
578 if (wpa_s->autoscan_params != NULL) {
579 scan_params = wpa_s->autoscan_params;
583 if (wpa_s->last_scan_req != MANUAL_SCAN_REQ &&
584 wpa_s->connect_without_scan) {
585 for (ssid = wpa_s->conf->ssid; ssid; ssid = ssid->next) {
586 if (ssid == wpa_s->connect_without_scan)
589 wpa_s->connect_without_scan = NULL;
591 wpa_printf(MSG_DEBUG, "Start a pre-selected network "
592 "without scan step");
593 wpa_supplicant_associate(wpa_s, NULL, ssid);
599 if ((wpa_s->p2p_in_provisioning || wpa_s->show_group_started) &&
601 wpa_printf(MSG_DEBUG, "P2P: Use specific SSID for scan during P2P group formation (p2p_in_provisioning=%d show_group_started=%d)",
602 wpa_s->p2p_in_provisioning,
603 wpa_s->show_group_started);
604 params.ssids[0].ssid = wpa_s->go_params->ssid;
605 params.ssids[0].ssid_len = wpa_s->go_params->ssid_len;
606 params.num_ssids = 1;
609 #endif /* CONFIG_P2P */
611 /* Find the starting point from which to continue scanning */
612 ssid = wpa_s->conf->ssid;
613 if (wpa_s->prev_scan_ssid != WILDCARD_SSID_SCAN) {
615 if (ssid == wpa_s->prev_scan_ssid) {
623 if (wpa_s->last_scan_req != MANUAL_SCAN_REQ &&
624 wpa_s->conf->ap_scan == 2) {
625 wpa_s->connect_without_scan = NULL;
626 wpa_s->prev_scan_wildcard = 0;
627 wpa_supplicant_assoc_try(wpa_s, ssid);
629 } else if (wpa_s->conf->ap_scan == 2) {
631 * User-initiated scan request in ap_scan == 2; scan with
636 struct wpa_ssid *start = ssid, *tssid;
638 if (ssid == NULL && max_ssids > 1)
639 ssid = wpa_s->conf->ssid;
641 if (!wpas_network_disabled(wpa_s, ssid) &&
643 wpa_hexdump_ascii(MSG_DEBUG, "Scan SSID",
644 ssid->ssid, ssid->ssid_len);
645 params.ssids[params.num_ssids].ssid =
647 params.ssids[params.num_ssids].ssid_len =
650 if (params.num_ssids + 1 >= max_ssids)
656 if (ssid == NULL && max_ssids > 1 &&
657 start != wpa_s->conf->ssid)
658 ssid = wpa_s->conf->ssid;
661 for (tssid = wpa_s->conf->ssid; tssid; tssid = tssid->next) {
662 if (wpas_network_disabled(wpa_s, tssid))
664 if ((params.freqs || !freqs_set) && tssid->scan_freq) {
665 int_array_concat(¶ms.freqs,
668 os_free(params.freqs);
673 int_array_sort_unique(params.freqs);
676 if (ssid && max_ssids == 1) {
678 * If the driver is limited to 1 SSID at a time interleave
679 * wildcard SSID scans with specific SSID scans to avoid
680 * waiting a long time for a wildcard scan.
682 if (!wpa_s->prev_scan_wildcard) {
683 params.ssids[0].ssid = NULL;
684 params.ssids[0].ssid_len = 0;
685 wpa_s->prev_scan_wildcard = 1;
686 wpa_dbg(wpa_s, MSG_DEBUG, "Starting AP scan for "
687 "wildcard SSID (Interleave with specific)");
689 wpa_s->prev_scan_ssid = ssid;
690 wpa_s->prev_scan_wildcard = 0;
691 wpa_dbg(wpa_s, MSG_DEBUG,
692 "Starting AP scan for specific SSID: %s",
693 wpa_ssid_txt(ssid->ssid, ssid->ssid_len));
698 wpa_s->prev_scan_ssid = ssid;
699 wpa_dbg(wpa_s, MSG_DEBUG, "Include wildcard SSID in "
702 } else if (wpa_s->last_scan_req == MANUAL_SCAN_REQ &&
703 wpa_s->manual_scan_passive && params.num_ssids == 0) {
704 wpa_dbg(wpa_s, MSG_DEBUG, "Use passive scan based on manual request");
706 wpa_s->prev_scan_ssid = WILDCARD_SSID_SCAN;
708 wpa_dbg(wpa_s, MSG_DEBUG, "Starting AP scan for wildcard "
713 #endif /* CONFIG_P2P */
715 wpa_supplicant_optimize_freqs(wpa_s, ¶ms);
716 extra_ie = wpa_supplicant_extra_ies(wpa_s);
718 if (wpa_s->last_scan_req == MANUAL_SCAN_REQ && params.freqs == NULL &&
719 wpa_s->manual_scan_freqs) {
720 wpa_dbg(wpa_s, MSG_DEBUG, "Limit manual scan to specified channels");
721 params.freqs = wpa_s->manual_scan_freqs;
722 wpa_s->manual_scan_freqs = NULL;
725 if (params.freqs == NULL && wpa_s->next_scan_freqs) {
726 wpa_dbg(wpa_s, MSG_DEBUG, "Optimize scan based on previously "
727 "generated frequency list");
728 params.freqs = wpa_s->next_scan_freqs;
730 os_free(wpa_s->next_scan_freqs);
731 wpa_s->next_scan_freqs = NULL;
732 wpa_setband_scan_freqs(wpa_s, ¶ms);
734 /* See if user specified frequencies. If so, scan only those. */
735 if (wpa_s->conf->freq_list && !params.freqs) {
736 wpa_dbg(wpa_s, MSG_DEBUG,
737 "Optimize scan based on conf->freq_list");
738 int_array_concat(¶ms.freqs, wpa_s->conf->freq_list);
741 /* Use current associated channel? */
742 if (wpa_s->conf->scan_cur_freq && !params.freqs) {
743 unsigned int num = wpa_s->num_multichan_concurrent;
745 params.freqs = os_calloc(num + 1, sizeof(int));
747 num = get_shared_radio_freqs(wpa_s, params.freqs, num);
749 wpa_dbg(wpa_s, MSG_DEBUG, "Scan only the "
750 "current operating channels since "
751 "scan_cur_freq is enabled");
753 os_free(params.freqs);
759 params.filter_ssids = wpa_supplicant_build_filter_ssids(
760 wpa_s->conf, ¶ms.num_filter_ssids);
762 params.extra_ies = wpabuf_head(extra_ie);
763 params.extra_ies_len = wpabuf_len(extra_ie);
767 if (wpa_s->p2p_in_provisioning ||
768 (wpa_s->show_group_started && wpa_s->go_params)) {
770 * The interface may not yet be in P2P mode, so we have to
771 * explicitly request P2P probe to disable CCK rates.
773 params.p2p_probe = 1;
775 #endif /* CONFIG_P2P */
777 scan_params = ¶ms;
782 * If the driver does not support multi-channel concurrency and a
783 * virtual interface that shares the same radio with the wpa_s interface
784 * is operating there may not be need to scan other channels apart from
785 * the current operating channel on the other virtual interface. Filter
786 * out other channels in case we are trying to find a connection for a
787 * station interface when we are not configured to prefer station
788 * connection and a concurrent operation is already in process.
790 if (wpa_s->scan_for_connection &&
791 wpa_s->last_scan_req == NORMAL_SCAN_REQ &&
792 !scan_params->freqs && !params.freqs &&
793 wpas_is_p2p_prioritized(wpa_s) &&
794 wpa_s->p2p_group_interface == NOT_P2P_GROUP_INTERFACE &&
795 non_p2p_network_enabled(wpa_s)) {
796 unsigned int num = wpa_s->num_multichan_concurrent;
798 params.freqs = os_calloc(num + 1, sizeof(int));
800 num = get_shared_radio_freqs(wpa_s, params.freqs, num);
801 if (num > 0 && num == wpa_s->num_multichan_concurrent) {
802 wpa_dbg(wpa_s, MSG_DEBUG, "Scan only the current operating channels since all channels are already used");
804 os_free(params.freqs);
809 #endif /* CONFIG_P2P */
811 ret = wpa_supplicant_trigger_scan(wpa_s, scan_params);
813 if (ret && wpa_s->last_scan_req == MANUAL_SCAN_REQ && params.freqs &&
814 !wpa_s->manual_scan_freqs) {
815 /* Restore manual_scan_freqs for the next attempt */
816 wpa_s->manual_scan_freqs = params.freqs;
820 wpabuf_free(extra_ie);
821 os_free(params.freqs);
822 os_free(params.filter_ssids);
825 wpa_msg(wpa_s, MSG_WARNING, "Failed to initiate AP scan");
826 if (prev_state != wpa_s->wpa_state)
827 wpa_supplicant_set_state(wpa_s, prev_state);
828 /* Restore scan_req since we will try to scan again */
829 wpa_s->scan_req = wpa_s->last_scan_req;
830 wpa_supplicant_req_scan(wpa_s, 1, 0);
832 wpa_s->scan_for_connection = 0;
837 void wpa_supplicant_update_scan_int(struct wpa_supplicant *wpa_s, int sec)
839 struct os_reltime remaining, new_int;
842 cancelled = eloop_cancel_timeout_one(wpa_supplicant_scan, wpa_s, NULL,
847 if (cancelled && os_reltime_before(&remaining, &new_int)) {
848 new_int.sec = remaining.sec;
849 new_int.usec = remaining.usec;
853 eloop_register_timeout(new_int.sec, new_int.usec,
854 wpa_supplicant_scan, wpa_s, NULL);
856 wpa_s->scan_interval = sec;
861 * wpa_supplicant_req_scan - Schedule a scan for neighboring access points
862 * @wpa_s: Pointer to wpa_supplicant data
863 * @sec: Number of seconds after which to scan
864 * @usec: Number of microseconds after which to scan
866 * This function is used to schedule a scan for neighboring access points after
867 * the specified time.
869 void wpa_supplicant_req_scan(struct wpa_supplicant *wpa_s, int sec, int usec)
871 if (eloop_deplete_timeout(sec, usec, wpa_supplicant_scan, wpa_s, NULL))
873 wpa_dbg(wpa_s, MSG_DEBUG, "Rescheduling scan request: %d sec %d usec",
878 wpa_dbg(wpa_s, MSG_DEBUG, "Setting scan request: %d sec %d usec",
880 eloop_cancel_timeout(wpa_supplicant_scan, wpa_s, NULL);
881 eloop_register_timeout(sec, usec, wpa_supplicant_scan, wpa_s, NULL);
886 * wpa_supplicant_delayed_sched_scan - Request a delayed scheduled scan
887 * @wpa_s: Pointer to wpa_supplicant data
888 * @sec: Number of seconds after which to scan
889 * @usec: Number of microseconds after which to scan
890 * Returns: 0 on success or -1 otherwise
892 * This function is used to schedule periodic scans for neighboring
893 * access points after the specified time.
895 int wpa_supplicant_delayed_sched_scan(struct wpa_supplicant *wpa_s,
898 if (!wpa_s->sched_scan_supported)
901 eloop_register_timeout(sec, usec,
902 wpa_supplicant_delayed_sched_scan_timeout,
910 * wpa_supplicant_req_sched_scan - Start a periodic scheduled scan
911 * @wpa_s: Pointer to wpa_supplicant data
912 * Returns: 0 is sched_scan was started or -1 otherwise
914 * This function is used to schedule periodic scans for neighboring
915 * access points repeating the scan continuously.
917 int wpa_supplicant_req_sched_scan(struct wpa_supplicant *wpa_s)
919 struct wpa_driver_scan_params params;
920 struct wpa_driver_scan_params *scan_params;
921 enum wpa_states prev_state;
922 struct wpa_ssid *ssid = NULL;
923 struct wpabuf *extra_ie = NULL;
925 unsigned int max_sched_scan_ssids;
929 if (!wpa_s->sched_scan_supported)
932 if (wpa_s->max_sched_scan_ssids > WPAS_MAX_SCAN_SSIDS)
933 max_sched_scan_ssids = WPAS_MAX_SCAN_SSIDS;
935 max_sched_scan_ssids = wpa_s->max_sched_scan_ssids;
936 if (max_sched_scan_ssids < 1 || wpa_s->conf->disable_scan_offload)
939 if (wpa_s->sched_scanning) {
940 wpa_dbg(wpa_s, MSG_DEBUG, "Already sched scanning");
945 for (ssid = wpa_s->conf->ssid; ssid; ssid = ssid->next) {
946 if (!wpas_network_disabled(wpa_s, ssid) && !ssid->scan_ssid) {
947 /* Use wildcard SSID to find this network */
949 } else if (!wpas_network_disabled(wpa_s, ssid) &&
954 if (!wpas_network_disabled(wpa_s, ssid) &&
955 ssid->key_mgmt == WPA_KEY_MGMT_WPS) {
957 * Normal scan is more reliable and faster for WPS
958 * operations and since these are for short periods of
959 * time, the benefit of trying to use sched_scan would
962 wpa_dbg(wpa_s, MSG_DEBUG, "Use normal scan instead of "
963 "sched_scan for WPS");
966 #endif /* CONFIG_WPS */
971 if (wpa_s->normal_scans < 3 &&
972 (need_ssids <= wpa_s->max_scan_ssids ||
973 wpa_s->max_scan_ssids >= (int) max_sched_scan_ssids)) {
975 * When normal scan can speed up operations, use that for the
976 * first operations before starting the sched_scan to allow
977 * user space sleep more. We do this only if the normal scan
978 * has functionality that is suitable for this or if the
979 * sched_scan does not have better support for multiple SSIDs.
981 wpa_dbg(wpa_s, MSG_DEBUG, "Use normal scan instead of "
982 "sched_scan for initial scans (normal_scans=%d)",
983 wpa_s->normal_scans);
987 os_memset(¶ms, 0, sizeof(params));
989 /* If we can't allocate space for the filters, we just don't filter */
990 params.filter_ssids = os_zalloc(wpa_s->max_match_sets *
991 sizeof(struct wpa_driver_scan_filter));
993 prev_state = wpa_s->wpa_state;
994 if (wpa_s->wpa_state == WPA_DISCONNECTED ||
995 wpa_s->wpa_state == WPA_INACTIVE)
996 wpa_supplicant_set_state(wpa_s, WPA_SCANNING);
998 if (wpa_s->autoscan_params != NULL) {
999 scan_params = wpa_s->autoscan_params;
1003 /* Find the starting point from which to continue scanning */
1004 ssid = wpa_s->conf->ssid;
1005 if (wpa_s->prev_sched_ssid) {
1007 if (ssid == wpa_s->prev_sched_ssid) {
1015 if (!ssid || !wpa_s->prev_sched_ssid) {
1016 wpa_dbg(wpa_s, MSG_DEBUG, "Beginning of SSID list");
1017 if (wpa_s->conf->sched_scan_interval)
1018 wpa_s->sched_scan_interval =
1019 wpa_s->conf->sched_scan_interval;
1020 if (wpa_s->sched_scan_interval == 0)
1021 wpa_s->sched_scan_interval = 10;
1022 wpa_s->sched_scan_timeout = max_sched_scan_ssids * 2;
1023 wpa_s->first_sched_scan = 1;
1024 ssid = wpa_s->conf->ssid;
1025 wpa_s->prev_sched_ssid = ssid;
1029 wpa_dbg(wpa_s, MSG_DEBUG, "Add wildcard SSID to sched_scan");
1034 if (wpas_network_disabled(wpa_s, ssid))
1037 if (params.num_filter_ssids < wpa_s->max_match_sets &&
1038 params.filter_ssids && ssid->ssid && ssid->ssid_len) {
1039 wpa_dbg(wpa_s, MSG_DEBUG, "add to filter ssid: %s",
1040 wpa_ssid_txt(ssid->ssid, ssid->ssid_len));
1041 os_memcpy(params.filter_ssids[params.num_filter_ssids].ssid,
1042 ssid->ssid, ssid->ssid_len);
1043 params.filter_ssids[params.num_filter_ssids].ssid_len =
1045 params.num_filter_ssids++;
1046 } else if (params.filter_ssids && ssid->ssid && ssid->ssid_len)
1048 wpa_dbg(wpa_s, MSG_DEBUG, "Not enough room for SSID "
1049 "filter for sched_scan - drop filter");
1050 os_free(params.filter_ssids);
1051 params.filter_ssids = NULL;
1052 params.num_filter_ssids = 0;
1055 if (ssid->scan_ssid && ssid->ssid && ssid->ssid_len) {
1056 if (params.num_ssids == max_sched_scan_ssids)
1057 break; /* only room for broadcast SSID */
1058 wpa_dbg(wpa_s, MSG_DEBUG,
1059 "add to active scan ssid: %s",
1060 wpa_ssid_txt(ssid->ssid, ssid->ssid_len));
1061 params.ssids[params.num_ssids].ssid =
1063 params.ssids[params.num_ssids].ssid_len =
1066 if (params.num_ssids >= max_sched_scan_ssids) {
1067 wpa_s->prev_sched_ssid = ssid;
1071 (wpas_network_disabled(wpa_s, ssid) ||
1078 wpa_s->prev_sched_ssid = ssid;
1082 if (params.num_filter_ssids == 0) {
1083 os_free(params.filter_ssids);
1084 params.filter_ssids = NULL;
1087 extra_ie = wpa_supplicant_extra_ies(wpa_s);
1089 params.extra_ies = wpabuf_head(extra_ie);
1090 params.extra_ies_len = wpabuf_len(extra_ie);
1093 scan_params = ¶ms;
1096 if (ssid || !wpa_s->first_sched_scan) {
1097 wpa_dbg(wpa_s, MSG_DEBUG,
1098 "Starting sched scan: interval %d timeout %d",
1099 wpa_s->sched_scan_interval, wpa_s->sched_scan_timeout);
1101 wpa_dbg(wpa_s, MSG_DEBUG,
1102 "Starting sched scan: interval %d (no timeout)",
1103 wpa_s->sched_scan_interval);
1106 wpa_setband_scan_freqs(wpa_s, scan_params);
1108 ret = wpa_supplicant_start_sched_scan(wpa_s, scan_params,
1109 wpa_s->sched_scan_interval);
1110 wpabuf_free(extra_ie);
1111 os_free(params.filter_ssids);
1113 wpa_msg(wpa_s, MSG_WARNING, "Failed to initiate sched scan");
1114 if (prev_state != wpa_s->wpa_state)
1115 wpa_supplicant_set_state(wpa_s, prev_state);
1119 /* If we have more SSIDs to scan, add a timeout so we scan them too */
1120 if (ssid || !wpa_s->first_sched_scan) {
1121 wpa_s->sched_scan_timed_out = 0;
1122 eloop_register_timeout(wpa_s->sched_scan_timeout, 0,
1123 wpa_supplicant_sched_scan_timeout,
1125 wpa_s->first_sched_scan = 0;
1126 wpa_s->sched_scan_timeout /= 2;
1127 wpa_s->sched_scan_interval *= 2;
1128 if (wpa_s->sched_scan_timeout < wpa_s->sched_scan_interval) {
1129 wpa_s->sched_scan_interval = 10;
1130 wpa_s->sched_scan_timeout = max_sched_scan_ssids * 2;
1134 /* If there is no more ssids, start next time from the beginning */
1136 wpa_s->prev_sched_ssid = NULL;
1143 * wpa_supplicant_cancel_scan - Cancel a scheduled scan request
1144 * @wpa_s: Pointer to wpa_supplicant data
1146 * This function is used to cancel a scan request scheduled with
1147 * wpa_supplicant_req_scan().
1149 void wpa_supplicant_cancel_scan(struct wpa_supplicant *wpa_s)
1151 wpa_dbg(wpa_s, MSG_DEBUG, "Cancelling scan request");
1152 eloop_cancel_timeout(wpa_supplicant_scan, wpa_s, NULL);
1153 wpas_p2p_continue_after_scan(wpa_s);
1158 * wpa_supplicant_cancel_delayed_sched_scan - Stop a delayed scheduled scan
1159 * @wpa_s: Pointer to wpa_supplicant data
1161 * This function is used to stop a delayed scheduled scan.
1163 void wpa_supplicant_cancel_delayed_sched_scan(struct wpa_supplicant *wpa_s)
1165 if (!wpa_s->sched_scan_supported)
1168 wpa_dbg(wpa_s, MSG_DEBUG, "Cancelling delayed sched scan");
1169 eloop_cancel_timeout(wpa_supplicant_delayed_sched_scan_timeout,
1175 * wpa_supplicant_cancel_sched_scan - Stop running scheduled scans
1176 * @wpa_s: Pointer to wpa_supplicant data
1178 * This function is used to stop a periodic scheduled scan.
1180 void wpa_supplicant_cancel_sched_scan(struct wpa_supplicant *wpa_s)
1182 if (!wpa_s->sched_scanning)
1185 wpa_dbg(wpa_s, MSG_DEBUG, "Cancelling sched scan");
1186 eloop_cancel_timeout(wpa_supplicant_sched_scan_timeout, wpa_s, NULL);
1187 wpa_supplicant_stop_sched_scan(wpa_s);
1192 * wpa_supplicant_notify_scanning - Indicate possible scan state change
1193 * @wpa_s: Pointer to wpa_supplicant data
1194 * @scanning: Whether scanning is currently in progress
1196 * This function is to generate scanning notifycations. It is called whenever
1197 * there may have been a change in scanning (scan started, completed, stopped).
1198 * wpas_notify_scanning() is called whenever the scanning state changed from the
1199 * previously notified state.
1201 void wpa_supplicant_notify_scanning(struct wpa_supplicant *wpa_s,
1204 if (wpa_s->scanning != scanning) {
1205 wpa_s->scanning = scanning;
1206 wpas_notify_scanning(wpa_s);
1211 static int wpa_scan_get_max_rate(const struct wpa_scan_res *res)
1217 ie = wpa_scan_get_ie(res, WLAN_EID_SUPP_RATES);
1218 for (i = 0; ie && i < ie[1]; i++) {
1219 if ((ie[i + 2] & 0x7f) > rate)
1220 rate = ie[i + 2] & 0x7f;
1223 ie = wpa_scan_get_ie(res, WLAN_EID_EXT_SUPP_RATES);
1224 for (i = 0; ie && i < ie[1]; i++) {
1225 if ((ie[i + 2] & 0x7f) > rate)
1226 rate = ie[i + 2] & 0x7f;
1234 * wpa_scan_get_ie - Fetch a specified information element from a scan result
1235 * @res: Scan result entry
1236 * @ie: Information element identitifier (WLAN_EID_*)
1237 * Returns: Pointer to the information element (id field) or %NULL if not found
1239 * This function returns the first matching information element in the scan
1242 const u8 * wpa_scan_get_ie(const struct wpa_scan_res *res, u8 ie)
1244 const u8 *end, *pos;
1246 pos = (const u8 *) (res + 1);
1247 end = pos + res->ie_len;
1249 while (pos + 1 < end) {
1250 if (pos + 2 + pos[1] > end)
1262 * wpa_scan_get_vendor_ie - Fetch vendor information element from a scan result
1263 * @res: Scan result entry
1264 * @vendor_type: Vendor type (four octets starting the IE payload)
1265 * Returns: Pointer to the information element (id field) or %NULL if not found
1267 * This function returns the first matching information element in the scan
1270 const u8 * wpa_scan_get_vendor_ie(const struct wpa_scan_res *res,
1273 const u8 *end, *pos;
1275 pos = (const u8 *) (res + 1);
1276 end = pos + res->ie_len;
1278 while (pos + 1 < end) {
1279 if (pos + 2 + pos[1] > end)
1281 if (pos[0] == WLAN_EID_VENDOR_SPECIFIC && pos[1] >= 4 &&
1282 vendor_type == WPA_GET_BE32(&pos[2]))
1292 * wpa_scan_get_vendor_ie_beacon - Fetch vendor information from a scan result
1293 * @res: Scan result entry
1294 * @vendor_type: Vendor type (four octets starting the IE payload)
1295 * Returns: Pointer to the information element (id field) or %NULL if not found
1297 * This function returns the first matching information element in the scan
1300 * This function is like wpa_scan_get_vendor_ie(), but uses IE buffer only
1301 * from Beacon frames instead of either Beacon or Probe Response frames.
1303 const u8 * wpa_scan_get_vendor_ie_beacon(const struct wpa_scan_res *res,
1306 const u8 *end, *pos;
1308 if (res->beacon_ie_len == 0)
1311 pos = (const u8 *) (res + 1);
1313 end = pos + res->beacon_ie_len;
1315 while (pos + 1 < end) {
1316 if (pos + 2 + pos[1] > end)
1318 if (pos[0] == WLAN_EID_VENDOR_SPECIFIC && pos[1] >= 4 &&
1319 vendor_type == WPA_GET_BE32(&pos[2]))
1329 * wpa_scan_get_vendor_ie_multi - Fetch vendor IE data from a scan result
1330 * @res: Scan result entry
1331 * @vendor_type: Vendor type (four octets starting the IE payload)
1332 * Returns: Pointer to the information element payload or %NULL if not found
1334 * This function returns concatenated payload of possibly fragmented vendor
1335 * specific information elements in the scan result. The caller is responsible
1336 * for freeing the returned buffer.
1338 struct wpabuf * wpa_scan_get_vendor_ie_multi(const struct wpa_scan_res *res,
1342 const u8 *end, *pos;
1344 buf = wpabuf_alloc(res->ie_len);
1348 pos = (const u8 *) (res + 1);
1349 end = pos + res->ie_len;
1351 while (pos + 1 < end) {
1352 if (pos + 2 + pos[1] > end)
1354 if (pos[0] == WLAN_EID_VENDOR_SPECIFIC && pos[1] >= 4 &&
1355 vendor_type == WPA_GET_BE32(&pos[2]))
1356 wpabuf_put_data(buf, pos + 2 + 4, pos[1] - 4);
1360 if (wpabuf_len(buf) == 0) {
1370 * Channels with a great SNR can operate at full rate. What is a great SNR?
1371 * This doc https://supportforums.cisco.com/docs/DOC-12954 says, "the general
1372 * rule of thumb is that any SNR above 20 is good." This one
1373 * http://www.cisco.com/en/US/tech/tk722/tk809/technologies_q_and_a_item09186a00805e9a96.shtml#qa23
1374 * recommends 25 as a minimum SNR for 54 Mbps data rate. 30 is chosen here as a
1375 * conservative value.
1377 #define GREAT_SNR 30
1379 /* Compare function for sorting scan results. Return >0 if @b is considered
1381 static int wpa_scan_result_compar(const void *a, const void *b)
1383 #define IS_5GHZ(n) (n > 4000)
1384 #define MIN(a,b) a < b ? a : b
1385 struct wpa_scan_res **_wa = (void *) a;
1386 struct wpa_scan_res **_wb = (void *) b;
1387 struct wpa_scan_res *wa = *_wa;
1388 struct wpa_scan_res *wb = *_wb;
1389 int wpa_a, wpa_b, maxrate_a, maxrate_b;
1392 /* WPA/WPA2 support preferred */
1393 wpa_a = wpa_scan_get_vendor_ie(wa, WPA_IE_VENDOR_TYPE) != NULL ||
1394 wpa_scan_get_ie(wa, WLAN_EID_RSN) != NULL;
1395 wpa_b = wpa_scan_get_vendor_ie(wb, WPA_IE_VENDOR_TYPE) != NULL ||
1396 wpa_scan_get_ie(wb, WLAN_EID_RSN) != NULL;
1398 if (wpa_b && !wpa_a)
1400 if (!wpa_b && wpa_a)
1403 /* privacy support preferred */
1404 if ((wa->caps & IEEE80211_CAP_PRIVACY) == 0 &&
1405 (wb->caps & IEEE80211_CAP_PRIVACY))
1407 if ((wa->caps & IEEE80211_CAP_PRIVACY) &&
1408 (wb->caps & IEEE80211_CAP_PRIVACY) == 0)
1411 if ((wa->flags & wb->flags & WPA_SCAN_LEVEL_DBM) &&
1412 !((wa->flags | wb->flags) & WPA_SCAN_NOISE_INVALID)) {
1413 snr_a = MIN(wa->level - wa->noise, GREAT_SNR);
1414 snr_b = MIN(wb->level - wb->noise, GREAT_SNR);
1416 /* Not suitable information to calculate SNR, so use level */
1421 /* best/max rate preferred if SNR close enough */
1422 if ((snr_a && snr_b && abs(snr_b - snr_a) < 5) ||
1423 (wa->qual && wb->qual && abs(wb->qual - wa->qual) < 10)) {
1424 maxrate_a = wpa_scan_get_max_rate(wa);
1425 maxrate_b = wpa_scan_get_max_rate(wb);
1426 if (maxrate_a != maxrate_b)
1427 return maxrate_b - maxrate_a;
1428 if (IS_5GHZ(wa->freq) ^ IS_5GHZ(wb->freq))
1429 return IS_5GHZ(wa->freq) ? -1 : 1;
1432 /* use freq for channel preference */
1434 /* all things being equal, use SNR; if SNRs are
1435 * identical, use quality values since some drivers may only report
1436 * that value and leave the signal level zero */
1438 return wb->qual - wa->qual;
1439 return snr_b - snr_a;
1446 /* Compare function for sorting scan results when searching a WPS AP for
1447 * provisioning. Return >0 if @b is considered better. */
1448 static int wpa_scan_result_wps_compar(const void *a, const void *b)
1450 struct wpa_scan_res **_wa = (void *) a;
1451 struct wpa_scan_res **_wb = (void *) b;
1452 struct wpa_scan_res *wa = *_wa;
1453 struct wpa_scan_res *wb = *_wb;
1454 int uses_wps_a, uses_wps_b;
1455 struct wpabuf *wps_a, *wps_b;
1458 /* Optimization - check WPS IE existence before allocated memory and
1459 * doing full reassembly. */
1460 uses_wps_a = wpa_scan_get_vendor_ie(wa, WPS_IE_VENDOR_TYPE) != NULL;
1461 uses_wps_b = wpa_scan_get_vendor_ie(wb, WPS_IE_VENDOR_TYPE) != NULL;
1462 if (uses_wps_a && !uses_wps_b)
1464 if (!uses_wps_a && uses_wps_b)
1467 if (uses_wps_a && uses_wps_b) {
1468 wps_a = wpa_scan_get_vendor_ie_multi(wa, WPS_IE_VENDOR_TYPE);
1469 wps_b = wpa_scan_get_vendor_ie_multi(wb, WPS_IE_VENDOR_TYPE);
1470 res = wps_ap_priority_compar(wps_a, wps_b);
1478 * Do not use current AP security policy as a sorting criteria during
1479 * WPS provisioning step since the AP may get reconfigured at the
1480 * completion of provisioning.
1483 /* all things being equal, use signal level; if signal levels are
1484 * identical, use quality values since some drivers may only report
1485 * that value and leave the signal level zero */
1486 if (wb->level == wa->level)
1487 return wb->qual - wa->qual;
1488 return wb->level - wa->level;
1490 #endif /* CONFIG_WPS */
1493 static void dump_scan_res(struct wpa_scan_results *scan_res)
1495 #ifndef CONFIG_NO_STDOUT_DEBUG
1498 if (scan_res->res == NULL || scan_res->num == 0)
1501 wpa_printf(MSG_EXCESSIVE, "Sorted scan results");
1503 for (i = 0; i < scan_res->num; i++) {
1504 struct wpa_scan_res *r = scan_res->res[i];
1506 if ((r->flags & (WPA_SCAN_LEVEL_DBM | WPA_SCAN_NOISE_INVALID))
1507 == WPA_SCAN_LEVEL_DBM) {
1508 int snr = r->level - r->noise;
1509 wpa_printf(MSG_EXCESSIVE, MACSTR " freq=%d qual=%d "
1510 "noise=%d level=%d snr=%d%s flags=0x%x "
1512 MAC2STR(r->bssid), r->freq, r->qual,
1513 r->noise, r->level, snr,
1514 snr >= GREAT_SNR ? "*" : "", r->flags,
1517 wpa_printf(MSG_EXCESSIVE, MACSTR " freq=%d qual=%d "
1518 "noise=%d level=%d flags=0x%x age=%u",
1519 MAC2STR(r->bssid), r->freq, r->qual,
1520 r->noise, r->level, r->flags, r->age);
1522 pos = (u8 *) (r + 1);
1524 wpa_hexdump(MSG_EXCESSIVE, "IEs", pos, r->ie_len);
1526 if (r->beacon_ie_len)
1527 wpa_hexdump(MSG_EXCESSIVE, "Beacon IEs",
1528 pos, r->beacon_ie_len);
1530 #endif /* CONFIG_NO_STDOUT_DEBUG */
1535 * wpa_supplicant_filter_bssid_match - Is the specified BSSID allowed
1536 * @wpa_s: Pointer to wpa_supplicant data
1537 * @bssid: BSSID to check
1538 * Returns: 0 if the BSSID is filtered or 1 if not
1540 * This function is used to filter out specific BSSIDs from scan reslts mainly
1541 * for testing purposes (SET bssid_filter ctrl_iface command).
1543 int wpa_supplicant_filter_bssid_match(struct wpa_supplicant *wpa_s,
1548 if (wpa_s->bssid_filter == NULL)
1551 for (i = 0; i < wpa_s->bssid_filter_count; i++) {
1552 if (os_memcmp(wpa_s->bssid_filter + i * ETH_ALEN, bssid,
1561 static void filter_scan_res(struct wpa_supplicant *wpa_s,
1562 struct wpa_scan_results *res)
1566 if (wpa_s->bssid_filter == NULL)
1569 for (i = 0, j = 0; i < res->num; i++) {
1570 if (wpa_supplicant_filter_bssid_match(wpa_s,
1571 res->res[i]->bssid)) {
1572 res->res[j++] = res->res[i];
1574 os_free(res->res[i]);
1579 if (res->num != j) {
1580 wpa_printf(MSG_DEBUG, "Filtered out %d scan results",
1581 (int) (res->num - j));
1588 * wpa_supplicant_get_scan_results - Get scan results
1589 * @wpa_s: Pointer to wpa_supplicant data
1590 * @info: Information about what was scanned or %NULL if not available
1591 * @new_scan: Whether a new scan was performed
1592 * Returns: Scan results, %NULL on failure
1594 * This function request the current scan results from the driver and updates
1595 * the local BSS list wpa_s->bss. The caller is responsible for freeing the
1596 * results with wpa_scan_results_free().
1598 struct wpa_scan_results *
1599 wpa_supplicant_get_scan_results(struct wpa_supplicant *wpa_s,
1600 struct scan_info *info, int new_scan)
1602 struct wpa_scan_results *scan_res;
1604 int (*compar)(const void *, const void *) = wpa_scan_result_compar;
1606 scan_res = wpa_drv_get_scan_results2(wpa_s);
1607 if (scan_res == NULL) {
1608 wpa_dbg(wpa_s, MSG_DEBUG, "Failed to get scan results");
1611 if (scan_res->fetch_time.sec == 0) {
1613 * Make sure we have a valid timestamp if the driver wrapper
1614 * does not set this.
1616 os_get_reltime(&scan_res->fetch_time);
1618 filter_scan_res(wpa_s, scan_res);
1621 if (wpas_wps_in_progress(wpa_s)) {
1622 wpa_dbg(wpa_s, MSG_DEBUG, "WPS: Order scan results with WPS "
1623 "provisioning rules");
1624 compar = wpa_scan_result_wps_compar;
1626 #endif /* CONFIG_WPS */
1628 qsort(scan_res->res, scan_res->num, sizeof(struct wpa_scan_res *),
1630 dump_scan_res(scan_res);
1632 wpa_bss_update_start(wpa_s);
1633 for (i = 0; i < scan_res->num; i++)
1634 wpa_bss_update_scan_res(wpa_s, scan_res->res[i],
1635 &scan_res->fetch_time);
1636 wpa_bss_update_end(wpa_s, info, new_scan);
1643 * wpa_supplicant_update_scan_results - Update scan results from the driver
1644 * @wpa_s: Pointer to wpa_supplicant data
1645 * Returns: 0 on success, -1 on failure
1647 * This function updates the BSS table within wpa_supplicant based on the
1648 * currently available scan results from the driver without requesting a new
1649 * scan. This is used in cases where the driver indicates an association
1650 * (including roaming within ESS) and wpa_supplicant does not yet have the
1651 * needed information to complete the connection (e.g., to perform validation
1652 * steps in 4-way handshake).
1654 int wpa_supplicant_update_scan_results(struct wpa_supplicant *wpa_s)
1656 struct wpa_scan_results *scan_res;
1657 scan_res = wpa_supplicant_get_scan_results(wpa_s, NULL, 0);
1658 if (scan_res == NULL)
1660 wpa_scan_results_free(scan_res);
1667 * scan_only_handler - Reports scan results
1669 void scan_only_handler(struct wpa_supplicant *wpa_s,
1670 struct wpa_scan_results *scan_res)
1672 wpa_dbg(wpa_s, MSG_DEBUG, "Scan-only results received");
1673 if (wpa_s->last_scan_req == MANUAL_SCAN_REQ &&
1674 wpa_s->manual_scan_use_id && wpa_s->own_scan_running) {
1675 wpa_msg_ctrl(wpa_s, MSG_INFO, WPA_EVENT_SCAN_RESULTS "id=%u",
1676 wpa_s->manual_scan_id);
1677 wpa_s->manual_scan_use_id = 0;
1679 wpa_msg_ctrl(wpa_s, MSG_INFO, WPA_EVENT_SCAN_RESULTS);
1681 wpas_notify_scan_results(wpa_s);
1682 wpas_notify_scan_done(wpa_s, 1);
1686 int wpas_scan_scheduled(struct wpa_supplicant *wpa_s)
1688 return eloop_is_timeout_registered(wpa_supplicant_scan, wpa_s, NULL);