2 * WPA Supplicant - Scanning
3 * Copyright (c) 2003-2014, 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"
27 static void wpa_supplicant_gen_assoc_event(struct wpa_supplicant
*wpa_s
)
29 struct wpa_ssid
*ssid
;
30 union wpa_event_data data
;
32 ssid
= wpa_supplicant_get_ssid(wpa_s
);
36 if (wpa_s
->current_ssid
== NULL
) {
37 wpa_s
->current_ssid
= ssid
;
38 if (wpa_s
->current_ssid
!= NULL
)
39 wpas_notify_network_changed(wpa_s
);
41 wpa_supplicant_initiate_eapol(wpa_s
);
42 wpa_dbg(wpa_s
, MSG_DEBUG
, "Already associated with a configured "
43 "network - generating associated event");
44 os_memset(&data
, 0, sizeof(data
));
45 wpa_supplicant_event(wpa_s
, EVENT_ASSOC
, &data
);
50 static int wpas_wps_in_use(struct wpa_supplicant
*wpa_s
,
51 enum wps_request_type
*req_type
)
53 struct wpa_ssid
*ssid
;
56 for (ssid
= wpa_s
->conf
->ssid
; ssid
; ssid
= ssid
->next
) {
57 if (!(ssid
->key_mgmt
& WPA_KEY_MGMT_WPS
))
61 *req_type
= wpas_wps_get_req_type(ssid
);
62 if (!ssid
->eap
.phase1
)
65 if (os_strstr(ssid
->eap
.phase1
, "pbc=1"))
70 if (!wpa_s
->global
->p2p_disabled
&& wpa_s
->global
->p2p
&&
71 !wpa_s
->conf
->p2p_disabled
) {
72 wpa_s
->wps
->dev
.p2p
= 1;
75 *req_type
= WPS_REQ_ENROLLEE_INFO
;
78 #endif /* CONFIG_P2P */
82 #endif /* CONFIG_WPS */
86 * wpa_supplicant_enabled_networks - Check whether there are enabled networks
87 * @wpa_s: Pointer to wpa_supplicant data
88 * Returns: 0 if no networks are enabled, >0 if networks are enabled
90 * This function is used to figure out whether any networks (or Interworking
91 * with enabled credentials and auto_interworking) are present in the current
94 int wpa_supplicant_enabled_networks(struct wpa_supplicant
*wpa_s
)
96 struct wpa_ssid
*ssid
= wpa_s
->conf
->ssid
;
97 int count
= 0, disabled
= 0;
99 if (!wpas_network_disabled(wpa_s
, ssid
))
105 if (wpa_s
->conf
->cred
&& wpa_s
->conf
->interworking
&&
106 wpa_s
->conf
->auto_interworking
)
108 if (count
== 0 && disabled
> 0) {
109 wpa_dbg(wpa_s
, MSG_DEBUG
, "No enabled networks (%d disabled "
110 "networks)", disabled
);
116 static void wpa_supplicant_assoc_try(struct wpa_supplicant
*wpa_s
,
117 struct wpa_ssid
*ssid
)
120 if (!wpas_network_disabled(wpa_s
, ssid
))
125 /* ap_scan=2 mode - try to associate with each SSID. */
127 wpa_dbg(wpa_s
, MSG_DEBUG
, "wpa_supplicant_assoc_try: Reached "
128 "end of scan list - go back to beginning");
129 wpa_s
->prev_scan_ssid
= WILDCARD_SSID_SCAN
;
130 wpa_supplicant_req_scan(wpa_s
, 0, 0);
134 /* Continue from the next SSID on the next attempt. */
135 wpa_s
->prev_scan_ssid
= ssid
;
137 /* Start from the beginning of the SSID list. */
138 wpa_s
->prev_scan_ssid
= WILDCARD_SSID_SCAN
;
140 wpa_supplicant_associate(wpa_s
, NULL
, ssid
);
144 static void wpas_trigger_scan_cb(struct wpa_radio_work
*work
, int deinit
)
146 struct wpa_supplicant
*wpa_s
= work
->wpa_s
;
147 struct wpa_driver_scan_params
*params
= work
->ctx
;
151 if (!work
->started
) {
152 wpa_scan_free_params(params
);
155 wpa_supplicant_notify_scanning(wpa_s
, 0);
156 wpas_notify_scan_done(wpa_s
, 0);
157 wpa_s
->scan_work
= NULL
;
161 if (wpas_update_random_addr_disassoc(wpa_s
) < 0) {
162 wpa_msg(wpa_s
, MSG_INFO
,
163 "Failed to assign random MAC address for a scan");
164 radio_work_done(work
);
168 wpa_supplicant_notify_scanning(wpa_s
, 1);
170 if (wpa_s
->clear_driver_scan_cache
)
171 params
->only_new_results
= 1;
172 ret
= wpa_drv_scan(wpa_s
, params
);
173 wpa_scan_free_params(params
);
176 wpa_supplicant_notify_scanning(wpa_s
, 0);
177 wpas_notify_scan_done(wpa_s
, 0);
178 radio_work_done(work
);
182 os_get_reltime(&wpa_s
->scan_trigger_time
);
184 wpa_s
->normal_scans
++;
185 wpa_s
->own_scan_requested
= 1;
186 wpa_s
->clear_driver_scan_cache
= 0;
187 wpa_s
->scan_work
= work
;
192 * wpa_supplicant_trigger_scan - Request driver to start a scan
193 * @wpa_s: Pointer to wpa_supplicant data
194 * @params: Scan parameters
195 * Returns: 0 on success, -1 on failure
197 int wpa_supplicant_trigger_scan(struct wpa_supplicant
*wpa_s
,
198 struct wpa_driver_scan_params
*params
)
200 struct wpa_driver_scan_params
*ctx
;
202 if (wpa_s
->scan_work
) {
203 wpa_dbg(wpa_s
, MSG_INFO
, "Reject scan trigger since one is already pending");
207 ctx
= wpa_scan_clone_params(params
);
211 if (radio_add_work(wpa_s
, 0, "scan", 0, wpas_trigger_scan_cb
, ctx
) < 0)
213 wpa_scan_free_params(ctx
);
222 wpa_supplicant_delayed_sched_scan_timeout(void *eloop_ctx
, void *timeout_ctx
)
224 struct wpa_supplicant
*wpa_s
= eloop_ctx
;
226 wpa_dbg(wpa_s
, MSG_DEBUG
, "Starting delayed sched scan");
228 if (wpa_supplicant_req_sched_scan(wpa_s
))
229 wpa_supplicant_req_scan(wpa_s
, 0, 0);
234 wpa_supplicant_sched_scan_timeout(void *eloop_ctx
, void *timeout_ctx
)
236 struct wpa_supplicant
*wpa_s
= eloop_ctx
;
238 wpa_dbg(wpa_s
, MSG_DEBUG
, "Sched scan timeout - stopping it");
240 wpa_s
->sched_scan_timed_out
= 1;
241 wpa_supplicant_cancel_sched_scan(wpa_s
);
245 int wpa_supplicant_start_sched_scan(struct wpa_supplicant
*wpa_s
,
246 struct wpa_driver_scan_params
*params
,
251 wpa_supplicant_notify_scanning(wpa_s
, 1);
252 ret
= wpa_drv_sched_scan(wpa_s
, params
, interval
* 1000);
254 wpa_supplicant_notify_scanning(wpa_s
, 0);
256 wpa_s
->sched_scanning
= 1;
262 int wpa_supplicant_stop_sched_scan(struct wpa_supplicant
*wpa_s
)
266 ret
= wpa_drv_stop_sched_scan(wpa_s
);
268 wpa_dbg(wpa_s
, MSG_DEBUG
, "stopping sched_scan failed!");
269 /* TODO: what to do if stopping fails? */
277 static struct wpa_driver_scan_filter
*
278 wpa_supplicant_build_filter_ssids(struct wpa_config
*conf
, size_t *num_ssids
)
280 struct wpa_driver_scan_filter
*ssids
;
281 struct wpa_ssid
*ssid
;
285 if (!conf
->filter_ssids
)
288 for (count
= 0, ssid
= conf
->ssid
; ssid
; ssid
= ssid
->next
) {
289 if (ssid
->ssid
&& ssid
->ssid_len
)
294 ssids
= os_zalloc(count
* sizeof(struct wpa_driver_scan_filter
));
298 for (ssid
= conf
->ssid
; ssid
; ssid
= ssid
->next
) {
299 if (!ssid
->ssid
|| !ssid
->ssid_len
)
301 os_memcpy(ssids
[*num_ssids
].ssid
, ssid
->ssid
, ssid
->ssid_len
);
302 ssids
[*num_ssids
].ssid_len
= ssid
->ssid_len
;
310 static void wpa_supplicant_optimize_freqs(
311 struct wpa_supplicant
*wpa_s
, struct wpa_driver_scan_params
*params
)
314 if (params
->freqs
== NULL
&& wpa_s
->p2p_in_provisioning
&&
316 /* Optimize provisioning state scan based on GO information */
317 if (wpa_s
->p2p_in_provisioning
< 5 &&
318 wpa_s
->go_params
->freq
> 0) {
319 wpa_dbg(wpa_s
, MSG_DEBUG
, "P2P: Scan only GO "
320 "preferred frequency %d MHz",
321 wpa_s
->go_params
->freq
);
322 params
->freqs
= os_zalloc(2 * sizeof(int));
324 params
->freqs
[0] = wpa_s
->go_params
->freq
;
325 } else if (wpa_s
->p2p_in_provisioning
< 8 &&
326 wpa_s
->go_params
->freq_list
[0]) {
327 wpa_dbg(wpa_s
, MSG_DEBUG
, "P2P: Scan only common "
329 int_array_concat(¶ms
->freqs
,
330 wpa_s
->go_params
->freq_list
);
332 int_array_sort_unique(params
->freqs
);
334 wpa_s
->p2p_in_provisioning
++;
337 if (params
->freqs
== NULL
&& wpa_s
->p2p_in_invitation
) {
339 * Optimize scan based on GO information during persistent
342 if (wpa_s
->p2p_in_invitation
< 5 &&
343 wpa_s
->p2p_invite_go_freq
> 0) {
344 wpa_dbg(wpa_s
, MSG_DEBUG
, "P2P: Scan only GO preferred frequency %d MHz during invitation",
345 wpa_s
->p2p_invite_go_freq
);
346 params
->freqs
= os_zalloc(2 * sizeof(int));
348 params
->freqs
[0] = wpa_s
->p2p_invite_go_freq
;
350 wpa_s
->p2p_in_invitation
++;
351 if (wpa_s
->p2p_in_invitation
> 20) {
353 * This should not really happen since the variable is
354 * cleared on group removal, but if it does happen, make
355 * sure we do not get stuck in special invitation scan
358 wpa_dbg(wpa_s
, MSG_DEBUG
, "P2P: Clear p2p_in_invitation");
359 wpa_s
->p2p_in_invitation
= 0;
362 #endif /* CONFIG_P2P */
365 if (params
->freqs
== NULL
&& wpa_s
->after_wps
&& wpa_s
->wps_freq
) {
367 * Optimize post-provisioning scan based on channel used
368 * during provisioning.
370 wpa_dbg(wpa_s
, MSG_DEBUG
, "WPS: Scan only frequency %u MHz "
371 "that was used during provisioning", wpa_s
->wps_freq
);
372 params
->freqs
= os_zalloc(2 * sizeof(int));
374 params
->freqs
[0] = wpa_s
->wps_freq
;
376 } else if (wpa_s
->after_wps
)
379 if (params
->freqs
== NULL
&& wpa_s
->known_wps_freq
&& wpa_s
->wps_freq
)
381 /* Optimize provisioning scan based on already known channel */
382 wpa_dbg(wpa_s
, MSG_DEBUG
, "WPS: Scan only frequency %u MHz",
384 params
->freqs
= os_zalloc(2 * sizeof(int));
386 params
->freqs
[0] = wpa_s
->wps_freq
;
387 wpa_s
->known_wps_freq
= 0; /* only do this once */
389 #endif /* CONFIG_WPS */
393 #ifdef CONFIG_INTERWORKING
394 static void wpas_add_interworking_elements(struct wpa_supplicant
*wpa_s
,
397 if (wpa_s
->conf
->interworking
== 0)
400 wpabuf_put_u8(buf
, WLAN_EID_EXT_CAPAB
);
401 wpabuf_put_u8(buf
, 6);
402 wpabuf_put_u8(buf
, 0x00);
403 wpabuf_put_u8(buf
, 0x00);
404 wpabuf_put_u8(buf
, 0x00);
405 wpabuf_put_u8(buf
, 0x80); /* Bit 31 - Interworking */
406 wpabuf_put_u8(buf
, 0x00);
408 wpabuf_put_u8(buf
, 0x40); /* Bit 46 - WNM-Notification */
409 #else /* CONFIG_HS20 */
410 wpabuf_put_u8(buf
, 0x00);
411 #endif /* CONFIG_HS20 */
413 wpabuf_put_u8(buf
, WLAN_EID_INTERWORKING
);
414 wpabuf_put_u8(buf
, is_zero_ether_addr(wpa_s
->conf
->hessid
) ? 1 :
416 wpabuf_put_u8(buf
, wpa_s
->conf
->access_network_type
);
418 if (!is_zero_ether_addr(wpa_s
->conf
->hessid
))
419 wpabuf_put_data(buf
, wpa_s
->conf
->hessid
, ETH_ALEN
);
421 #endif /* CONFIG_INTERWORKING */
424 static struct wpabuf
* wpa_supplicant_extra_ies(struct wpa_supplicant
*wpa_s
)
426 struct wpabuf
*extra_ie
= NULL
;
429 enum wps_request_type req_type
= WPS_REQ_ENROLLEE_INFO
;
430 #endif /* CONFIG_WPS */
432 #ifdef CONFIG_INTERWORKING
433 if (wpa_s
->conf
->interworking
&&
434 wpabuf_resize(&extra_ie
, 100) == 0)
435 wpas_add_interworking_elements(wpa_s
, extra_ie
);
436 #endif /* CONFIG_INTERWORKING */
439 wps
= wpas_wps_in_use(wpa_s
, &req_type
);
442 struct wpabuf
*wps_ie
;
443 wps_ie
= wps_build_probe_req_ie(wps
== 2 ? DEV_PW_PUSHBUTTON
:
446 wpa_s
->wps
->uuid
, req_type
,
449 if (wpabuf_resize(&extra_ie
, wpabuf_len(wps_ie
)) == 0)
450 wpabuf_put_buf(extra_ie
, wps_ie
);
457 size_t ielen
= p2p_scan_ie_buf_len(wpa_s
->global
->p2p
);
458 if (wpabuf_resize(&extra_ie
, ielen
) == 0)
459 wpas_p2p_scan_ie(wpa_s
, extra_ie
);
461 #endif /* CONFIG_P2P */
463 #endif /* CONFIG_WPS */
466 if (wpa_s
->conf
->hs20
&& wpabuf_resize(&extra_ie
, 7) == 0)
467 wpas_hs20_add_indication(extra_ie
, -1);
468 #endif /* CONFIG_HS20 */
477 * Check whether there are any enabled networks or credentials that could be
478 * used for a non-P2P connection.
480 static int non_p2p_network_enabled(struct wpa_supplicant
*wpa_s
)
482 struct wpa_ssid
*ssid
;
484 for (ssid
= wpa_s
->conf
->ssid
; ssid
; ssid
= ssid
->next
) {
485 if (wpas_network_disabled(wpa_s
, ssid
))
487 if (!ssid
->p2p_group
)
491 if (wpa_s
->conf
->cred
&& wpa_s
->conf
->interworking
&&
492 wpa_s
->conf
->auto_interworking
)
498 #endif /* CONFIG_P2P */
501 static struct hostapd_hw_modes
* get_mode(struct hostapd_hw_modes
*modes
,
503 enum hostapd_hw_mode mode
)
507 for (i
= 0; i
< num_modes
; i
++) {
508 if (modes
[i
].mode
== mode
)
516 static void wpa_setband_scan_freqs_list(struct wpa_supplicant
*wpa_s
,
517 enum hostapd_hw_mode band
,
518 struct wpa_driver_scan_params
*params
)
520 /* Include only supported channels for the specified band */
521 struct hostapd_hw_modes
*mode
;
524 mode
= get_mode(wpa_s
->hw
.modes
, wpa_s
->hw
.num_modes
, band
);
526 /* No channels supported in this band - use empty list */
527 params
->freqs
= os_zalloc(sizeof(int));
531 params
->freqs
= os_zalloc((mode
->num_channels
+ 1) * sizeof(int));
532 if (params
->freqs
== NULL
)
534 for (count
= 0, i
= 0; i
< mode
->num_channels
; i
++) {
535 if (mode
->channels
[i
].flag
& HOSTAPD_CHAN_DISABLED
)
537 params
->freqs
[count
++] = mode
->channels
[i
].freq
;
542 static void wpa_setband_scan_freqs(struct wpa_supplicant
*wpa_s
,
543 struct wpa_driver_scan_params
*params
)
545 if (wpa_s
->hw
.modes
== NULL
)
546 return; /* unknown what channels the driver supports */
548 return; /* already using a limited channel set */
549 if (wpa_s
->setband
== WPA_SETBAND_5G
)
550 wpa_setband_scan_freqs_list(wpa_s
, HOSTAPD_MODE_IEEE80211A
,
552 else if (wpa_s
->setband
== WPA_SETBAND_2G
)
553 wpa_setband_scan_freqs_list(wpa_s
, HOSTAPD_MODE_IEEE80211G
,
558 static void wpa_set_scan_ssids(struct wpa_supplicant
*wpa_s
,
559 struct wpa_driver_scan_params
*params
,
563 struct wpa_ssid
*ssid
;
565 for (i
= 0; i
< wpa_s
->scan_id_count
; i
++) {
568 ssid
= wpa_config_get_network(wpa_s
->conf
, wpa_s
->scan_id
[i
]);
569 if (!ssid
|| !ssid
->scan_ssid
)
572 for (j
= 0; j
< params
->num_ssids
; j
++) {
573 if (params
->ssids
[j
].ssid_len
== ssid
->ssid_len
&&
574 params
->ssids
[j
].ssid
&&
575 os_memcmp(params
->ssids
[j
].ssid
, ssid
->ssid
,
576 ssid
->ssid_len
) == 0)
579 if (j
< params
->num_ssids
)
580 continue; /* already in the list */
582 if (params
->num_ssids
+ 1 > max_ssids
) {
583 wpa_printf(MSG_DEBUG
,
584 "Over max scan SSIDs for manual request");
588 wpa_printf(MSG_DEBUG
, "Scan SSID (manual request): %s",
589 wpa_ssid_txt(ssid
->ssid
, ssid
->ssid_len
));
590 params
->ssids
[params
->num_ssids
].ssid
= ssid
->ssid
;
591 params
->ssids
[params
->num_ssids
].ssid_len
= ssid
->ssid_len
;
595 wpa_s
->scan_id_count
= 0;
599 static void wpa_supplicant_scan(void *eloop_ctx
, void *timeout_ctx
)
601 struct wpa_supplicant
*wpa_s
= eloop_ctx
;
602 struct wpa_ssid
*ssid
;
604 struct wpabuf
*extra_ie
= NULL
;
605 struct wpa_driver_scan_params params
;
606 struct wpa_driver_scan_params
*scan_params
;
608 enum wpa_states prev_state
;
610 if (wpa_s
->pno
|| wpa_s
->pno_sched_pending
) {
611 wpa_dbg(wpa_s
, MSG_DEBUG
, "Skip scan - PNO is in progress");
615 if (wpa_s
->wpa_state
== WPA_INTERFACE_DISABLED
) {
616 wpa_dbg(wpa_s
, MSG_DEBUG
, "Skip scan - interface disabled");
620 if (wpa_s
->disconnected
&& wpa_s
->scan_req
== NORMAL_SCAN_REQ
) {
621 wpa_dbg(wpa_s
, MSG_DEBUG
, "Disconnected - do not scan");
622 wpa_supplicant_set_state(wpa_s
, WPA_DISCONNECTED
);
626 if (wpa_s
->scanning
) {
628 * If we are already in scanning state, we shall reschedule the
629 * the incoming scan request.
631 wpa_dbg(wpa_s
, MSG_DEBUG
, "Already scanning - Reschedule the incoming scan req");
632 wpa_supplicant_req_scan(wpa_s
, 1, 0);
636 if (!wpa_supplicant_enabled_networks(wpa_s
) &&
637 wpa_s
->scan_req
== NORMAL_SCAN_REQ
) {
638 wpa_dbg(wpa_s
, MSG_DEBUG
, "No enabled networks - do not scan");
639 wpa_supplicant_set_state(wpa_s
, WPA_INACTIVE
);
643 if (wpa_s
->conf
->ap_scan
!= 0 &&
644 (wpa_s
->drv_flags
& WPA_DRIVER_FLAGS_WIRED
)) {
645 wpa_dbg(wpa_s
, MSG_DEBUG
, "Using wired authentication - "
646 "overriding ap_scan configuration");
647 wpa_s
->conf
->ap_scan
= 0;
648 wpas_notify_ap_scan_changed(wpa_s
);
651 if (wpa_s
->conf
->ap_scan
== 0) {
652 wpa_supplicant_gen_assoc_event(wpa_s
);
656 if (wpas_p2p_in_progress(wpa_s
)) {
657 wpa_dbg(wpa_s
, MSG_DEBUG
, "Delay station mode scan while P2P operation is in progress");
658 wpa_supplicant_req_scan(wpa_s
, 5, 0);
662 if (wpa_s
->conf
->ap_scan
== 2)
665 max_ssids
= wpa_s
->max_scan_ssids
;
666 if (max_ssids
> WPAS_MAX_SCAN_SSIDS
)
667 max_ssids
= WPAS_MAX_SCAN_SSIDS
;
670 wpa_s
->last_scan_req
= wpa_s
->scan_req
;
671 wpa_s
->scan_req
= NORMAL_SCAN_REQ
;
673 os_memset(¶ms
, 0, sizeof(params
));
675 prev_state
= wpa_s
->wpa_state
;
676 if (wpa_s
->wpa_state
== WPA_DISCONNECTED
||
677 wpa_s
->wpa_state
== WPA_INACTIVE
)
678 wpa_supplicant_set_state(wpa_s
, WPA_SCANNING
);
681 * If autoscan has set its own scanning parameters
683 if (wpa_s
->autoscan_params
!= NULL
) {
684 scan_params
= wpa_s
->autoscan_params
;
688 if (wpa_s
->last_scan_req
!= MANUAL_SCAN_REQ
&&
689 wpa_s
->connect_without_scan
) {
690 for (ssid
= wpa_s
->conf
->ssid
; ssid
; ssid
= ssid
->next
) {
691 if (ssid
== wpa_s
->connect_without_scan
)
694 wpa_s
->connect_without_scan
= NULL
;
696 wpa_printf(MSG_DEBUG
, "Start a pre-selected network "
697 "without scan step");
698 wpa_supplicant_associate(wpa_s
, NULL
, ssid
);
704 if ((wpa_s
->p2p_in_provisioning
|| wpa_s
->show_group_started
) &&
706 wpa_printf(MSG_DEBUG
, "P2P: Use specific SSID for scan during P2P group formation (p2p_in_provisioning=%d show_group_started=%d)",
707 wpa_s
->p2p_in_provisioning
,
708 wpa_s
->show_group_started
);
709 params
.ssids
[0].ssid
= wpa_s
->go_params
->ssid
;
710 params
.ssids
[0].ssid_len
= wpa_s
->go_params
->ssid_len
;
711 params
.num_ssids
= 1;
715 if (wpa_s
->p2p_in_invitation
) {
716 if (wpa_s
->current_ssid
) {
717 wpa_printf(MSG_DEBUG
, "P2P: Use specific SSID for scan during invitation");
718 params
.ssids
[0].ssid
= wpa_s
->current_ssid
->ssid
;
719 params
.ssids
[0].ssid_len
=
720 wpa_s
->current_ssid
->ssid_len
;
721 params
.num_ssids
= 1;
723 wpa_printf(MSG_DEBUG
, "P2P: No specific SSID known for scan during invitation");
727 #endif /* CONFIG_P2P */
729 /* Find the starting point from which to continue scanning */
730 ssid
= wpa_s
->conf
->ssid
;
731 if (wpa_s
->prev_scan_ssid
!= WILDCARD_SSID_SCAN
) {
733 if (ssid
== wpa_s
->prev_scan_ssid
) {
741 if (wpa_s
->last_scan_req
!= MANUAL_SCAN_REQ
&&
742 wpa_s
->conf
->ap_scan
== 2) {
743 wpa_s
->connect_without_scan
= NULL
;
744 wpa_s
->prev_scan_wildcard
= 0;
745 wpa_supplicant_assoc_try(wpa_s
, ssid
);
747 } else if (wpa_s
->conf
->ap_scan
== 2) {
749 * User-initiated scan request in ap_scan == 2; scan with
753 } else if (wpa_s
->reattach
&& wpa_s
->current_ssid
!= NULL
) {
755 * Perform single-channel single-SSID scan for
756 * reassociate-to-same-BSS operation.
759 ssid
= wpa_s
->current_ssid
;
760 wpa_hexdump_ascii(MSG_DEBUG
, "Scan SSID",
761 ssid
->ssid
, ssid
->ssid_len
);
762 params
.ssids
[0].ssid
= ssid
->ssid
;
763 params
.ssids
[0].ssid_len
= ssid
->ssid_len
;
764 params
.num_ssids
= 1;
767 * Allocate memory for frequency array, allocate one extra
768 * slot for the zero-terminator.
770 params
.freqs
= os_malloc(sizeof(int) * 2);
771 if (params
.freqs
== NULL
) {
772 wpa_dbg(wpa_s
, MSG_ERROR
, "Memory allocation failed");
775 params
.freqs
[0] = wpa_s
->assoc_freq
;
779 * Reset the reattach flag so that we fall back to full scan if
784 struct wpa_ssid
*start
= ssid
, *tssid
;
786 if (ssid
== NULL
&& max_ssids
> 1)
787 ssid
= wpa_s
->conf
->ssid
;
789 if (!wpas_network_disabled(wpa_s
, ssid
) &&
791 wpa_hexdump_ascii(MSG_DEBUG
, "Scan SSID",
792 ssid
->ssid
, ssid
->ssid_len
);
793 params
.ssids
[params
.num_ssids
].ssid
=
795 params
.ssids
[params
.num_ssids
].ssid_len
=
798 if (params
.num_ssids
+ 1 >= max_ssids
)
804 if (ssid
== NULL
&& max_ssids
> 1 &&
805 start
!= wpa_s
->conf
->ssid
)
806 ssid
= wpa_s
->conf
->ssid
;
809 if (wpa_s
->scan_id_count
&&
810 wpa_s
->last_scan_req
== MANUAL_SCAN_REQ
)
811 wpa_set_scan_ssids(wpa_s
, ¶ms
, max_ssids
);
813 for (tssid
= wpa_s
->conf
->ssid
; tssid
; tssid
= tssid
->next
) {
814 if (wpas_network_disabled(wpa_s
, tssid
))
816 if ((params
.freqs
|| !freqs_set
) && tssid
->scan_freq
) {
817 int_array_concat(¶ms
.freqs
,
820 os_free(params
.freqs
);
825 int_array_sort_unique(params
.freqs
);
828 if (ssid
&& max_ssids
== 1) {
830 * If the driver is limited to 1 SSID at a time interleave
831 * wildcard SSID scans with specific SSID scans to avoid
832 * waiting a long time for a wildcard scan.
834 if (!wpa_s
->prev_scan_wildcard
) {
835 params
.ssids
[0].ssid
= NULL
;
836 params
.ssids
[0].ssid_len
= 0;
837 wpa_s
->prev_scan_wildcard
= 1;
838 wpa_dbg(wpa_s
, MSG_DEBUG
, "Starting AP scan for "
839 "wildcard SSID (Interleave with specific)");
841 wpa_s
->prev_scan_ssid
= ssid
;
842 wpa_s
->prev_scan_wildcard
= 0;
843 wpa_dbg(wpa_s
, MSG_DEBUG
,
844 "Starting AP scan for specific SSID: %s",
845 wpa_ssid_txt(ssid
->ssid
, ssid
->ssid_len
));
850 wpa_s
->prev_scan_ssid
= ssid
;
851 wpa_dbg(wpa_s
, MSG_DEBUG
, "Include wildcard SSID in "
854 } else if (wpa_s
->last_scan_req
== MANUAL_SCAN_REQ
&&
855 wpa_s
->manual_scan_passive
&& params
.num_ssids
== 0) {
856 wpa_dbg(wpa_s
, MSG_DEBUG
, "Use passive scan based on manual request");
858 wpa_s
->prev_scan_ssid
= WILDCARD_SSID_SCAN
;
860 wpa_dbg(wpa_s
, MSG_DEBUG
, "Starting AP scan for wildcard "
865 #endif /* CONFIG_P2P */
867 wpa_supplicant_optimize_freqs(wpa_s
, ¶ms
);
868 extra_ie
= wpa_supplicant_extra_ies(wpa_s
);
870 if (wpa_s
->last_scan_req
== MANUAL_SCAN_REQ
&&
871 wpa_s
->manual_scan_only_new
)
872 params
.only_new_results
= 1;
874 if (wpa_s
->last_scan_req
== MANUAL_SCAN_REQ
&& params
.freqs
== NULL
&&
875 wpa_s
->manual_scan_freqs
) {
876 wpa_dbg(wpa_s
, MSG_DEBUG
, "Limit manual scan to specified channels");
877 params
.freqs
= wpa_s
->manual_scan_freqs
;
878 wpa_s
->manual_scan_freqs
= NULL
;
881 if (params
.freqs
== NULL
&& wpa_s
->next_scan_freqs
) {
882 wpa_dbg(wpa_s
, MSG_DEBUG
, "Optimize scan based on previously "
883 "generated frequency list");
884 params
.freqs
= wpa_s
->next_scan_freqs
;
886 os_free(wpa_s
->next_scan_freqs
);
887 wpa_s
->next_scan_freqs
= NULL
;
888 wpa_setband_scan_freqs(wpa_s
, ¶ms
);
890 /* See if user specified frequencies. If so, scan only those. */
891 if (wpa_s
->conf
->freq_list
&& !params
.freqs
) {
892 wpa_dbg(wpa_s
, MSG_DEBUG
,
893 "Optimize scan based on conf->freq_list");
894 int_array_concat(¶ms
.freqs
, wpa_s
->conf
->freq_list
);
897 /* Use current associated channel? */
898 if (wpa_s
->conf
->scan_cur_freq
&& !params
.freqs
) {
899 unsigned int num
= wpa_s
->num_multichan_concurrent
;
901 params
.freqs
= os_calloc(num
+ 1, sizeof(int));
903 num
= get_shared_radio_freqs(wpa_s
, params
.freqs
, num
);
905 wpa_dbg(wpa_s
, MSG_DEBUG
, "Scan only the "
906 "current operating channels since "
907 "scan_cur_freq is enabled");
909 os_free(params
.freqs
);
915 params
.filter_ssids
= wpa_supplicant_build_filter_ssids(
916 wpa_s
->conf
, ¶ms
.num_filter_ssids
);
918 params
.extra_ies
= wpabuf_head(extra_ie
);
919 params
.extra_ies_len
= wpabuf_len(extra_ie
);
923 if (wpa_s
->p2p_in_provisioning
|| wpa_s
->p2p_in_invitation
||
924 (wpa_s
->show_group_started
&& wpa_s
->go_params
)) {
926 * The interface may not yet be in P2P mode, so we have to
927 * explicitly request P2P probe to disable CCK rates.
929 params
.p2p_probe
= 1;
931 #endif /* CONFIG_P2P */
933 scan_params
= ¶ms
;
938 * If the driver does not support multi-channel concurrency and a
939 * virtual interface that shares the same radio with the wpa_s interface
940 * is operating there may not be need to scan other channels apart from
941 * the current operating channel on the other virtual interface. Filter
942 * out other channels in case we are trying to find a connection for a
943 * station interface when we are not configured to prefer station
944 * connection and a concurrent operation is already in process.
946 if (wpa_s
->scan_for_connection
&&
947 wpa_s
->last_scan_req
== NORMAL_SCAN_REQ
&&
948 !scan_params
->freqs
&& !params
.freqs
&&
949 wpas_is_p2p_prioritized(wpa_s
) &&
950 wpa_s
->p2p_group_interface
== NOT_P2P_GROUP_INTERFACE
&&
951 non_p2p_network_enabled(wpa_s
)) {
952 unsigned int num
= wpa_s
->num_multichan_concurrent
;
954 params
.freqs
= os_calloc(num
+ 1, sizeof(int));
956 num
= get_shared_radio_freqs(wpa_s
, params
.freqs
, num
);
957 if (num
> 0 && num
== wpa_s
->num_multichan_concurrent
) {
958 wpa_dbg(wpa_s
, MSG_DEBUG
, "Scan only the current operating channels since all channels are already used");
960 os_free(params
.freqs
);
965 #endif /* CONFIG_P2P */
967 ret
= wpa_supplicant_trigger_scan(wpa_s
, scan_params
);
969 if (ret
&& wpa_s
->last_scan_req
== MANUAL_SCAN_REQ
&& params
.freqs
&&
970 !wpa_s
->manual_scan_freqs
) {
971 /* Restore manual_scan_freqs for the next attempt */
972 wpa_s
->manual_scan_freqs
= params
.freqs
;
976 wpabuf_free(extra_ie
);
977 os_free(params
.freqs
);
978 os_free(params
.filter_ssids
);
981 wpa_msg(wpa_s
, MSG_WARNING
, "Failed to initiate AP scan");
982 if (prev_state
!= wpa_s
->wpa_state
)
983 wpa_supplicant_set_state(wpa_s
, prev_state
);
984 /* Restore scan_req since we will try to scan again */
985 wpa_s
->scan_req
= wpa_s
->last_scan_req
;
986 wpa_supplicant_req_scan(wpa_s
, 1, 0);
988 wpa_s
->scan_for_connection
= 0;
993 void wpa_supplicant_update_scan_int(struct wpa_supplicant
*wpa_s
, int sec
)
995 struct os_reltime remaining
, new_int
;
998 cancelled
= eloop_cancel_timeout_one(wpa_supplicant_scan
, wpa_s
, NULL
,
1003 if (cancelled
&& os_reltime_before(&remaining
, &new_int
)) {
1004 new_int
.sec
= remaining
.sec
;
1005 new_int
.usec
= remaining
.usec
;
1009 eloop_register_timeout(new_int
.sec
, new_int
.usec
,
1010 wpa_supplicant_scan
, wpa_s
, NULL
);
1012 wpa_s
->scan_interval
= sec
;
1017 * wpa_supplicant_req_scan - Schedule a scan for neighboring access points
1018 * @wpa_s: Pointer to wpa_supplicant data
1019 * @sec: Number of seconds after which to scan
1020 * @usec: Number of microseconds after which to scan
1022 * This function is used to schedule a scan for neighboring access points after
1023 * the specified time.
1025 void wpa_supplicant_req_scan(struct wpa_supplicant
*wpa_s
, int sec
, int usec
)
1027 int res
= eloop_deplete_timeout(sec
, usec
, wpa_supplicant_scan
, wpa_s
,
1030 wpa_dbg(wpa_s
, MSG_DEBUG
, "Rescheduling scan request: %d.%06d sec",
1032 } else if (res
== 0) {
1033 wpa_dbg(wpa_s
, MSG_DEBUG
, "Ignore new scan request for %d.%06d sec since an earlier request is scheduled to trigger sooner",
1036 wpa_dbg(wpa_s
, MSG_DEBUG
, "Setting scan request: %d.%06d sec",
1038 eloop_register_timeout(sec
, usec
, wpa_supplicant_scan
, wpa_s
, NULL
);
1044 * wpa_supplicant_delayed_sched_scan - Request a delayed scheduled scan
1045 * @wpa_s: Pointer to wpa_supplicant data
1046 * @sec: Number of seconds after which to scan
1047 * @usec: Number of microseconds after which to scan
1048 * Returns: 0 on success or -1 otherwise
1050 * This function is used to schedule periodic scans for neighboring
1051 * access points after the specified time.
1053 int wpa_supplicant_delayed_sched_scan(struct wpa_supplicant
*wpa_s
,
1056 if (!wpa_s
->sched_scan_supported
)
1059 eloop_register_timeout(sec
, usec
,
1060 wpa_supplicant_delayed_sched_scan_timeout
,
1068 * wpa_supplicant_req_sched_scan - Start a periodic scheduled scan
1069 * @wpa_s: Pointer to wpa_supplicant data
1070 * Returns: 0 is sched_scan was started or -1 otherwise
1072 * This function is used to schedule periodic scans for neighboring
1073 * access points repeating the scan continuously.
1075 int wpa_supplicant_req_sched_scan(struct wpa_supplicant
*wpa_s
)
1077 struct wpa_driver_scan_params params
;
1078 struct wpa_driver_scan_params
*scan_params
;
1079 enum wpa_states prev_state
;
1080 struct wpa_ssid
*ssid
= NULL
;
1081 struct wpabuf
*extra_ie
= NULL
;
1083 unsigned int max_sched_scan_ssids
;
1087 if (!wpa_s
->sched_scan_supported
)
1090 if (wpa_s
->max_sched_scan_ssids
> WPAS_MAX_SCAN_SSIDS
)
1091 max_sched_scan_ssids
= WPAS_MAX_SCAN_SSIDS
;
1093 max_sched_scan_ssids
= wpa_s
->max_sched_scan_ssids
;
1094 if (max_sched_scan_ssids
< 1 || wpa_s
->conf
->disable_scan_offload
)
1097 if (wpa_s
->sched_scanning
) {
1098 wpa_dbg(wpa_s
, MSG_DEBUG
, "Already sched scanning");
1103 for (ssid
= wpa_s
->conf
->ssid
; ssid
; ssid
= ssid
->next
) {
1104 if (!wpas_network_disabled(wpa_s
, ssid
) && !ssid
->scan_ssid
) {
1105 /* Use wildcard SSID to find this network */
1107 } else if (!wpas_network_disabled(wpa_s
, ssid
) &&
1112 if (!wpas_network_disabled(wpa_s
, ssid
) &&
1113 ssid
->key_mgmt
== WPA_KEY_MGMT_WPS
) {
1115 * Normal scan is more reliable and faster for WPS
1116 * operations and since these are for short periods of
1117 * time, the benefit of trying to use sched_scan would
1120 wpa_dbg(wpa_s
, MSG_DEBUG
, "Use normal scan instead of "
1121 "sched_scan for WPS");
1124 #endif /* CONFIG_WPS */
1129 if (wpa_s
->normal_scans
< 3 &&
1130 (need_ssids
<= wpa_s
->max_scan_ssids
||
1131 wpa_s
->max_scan_ssids
>= (int) max_sched_scan_ssids
)) {
1133 * When normal scan can speed up operations, use that for the
1134 * first operations before starting the sched_scan to allow
1135 * user space sleep more. We do this only if the normal scan
1136 * has functionality that is suitable for this or if the
1137 * sched_scan does not have better support for multiple SSIDs.
1139 wpa_dbg(wpa_s
, MSG_DEBUG
, "Use normal scan instead of "
1140 "sched_scan for initial scans (normal_scans=%d)",
1141 wpa_s
->normal_scans
);
1145 os_memset(¶ms
, 0, sizeof(params
));
1147 /* If we can't allocate space for the filters, we just don't filter */
1148 params
.filter_ssids
= os_zalloc(wpa_s
->max_match_sets
*
1149 sizeof(struct wpa_driver_scan_filter
));
1151 prev_state
= wpa_s
->wpa_state
;
1152 if (wpa_s
->wpa_state
== WPA_DISCONNECTED
||
1153 wpa_s
->wpa_state
== WPA_INACTIVE
)
1154 wpa_supplicant_set_state(wpa_s
, WPA_SCANNING
);
1156 if (wpa_s
->autoscan_params
!= NULL
) {
1157 scan_params
= wpa_s
->autoscan_params
;
1161 /* Find the starting point from which to continue scanning */
1162 ssid
= wpa_s
->conf
->ssid
;
1163 if (wpa_s
->prev_sched_ssid
) {
1165 if (ssid
== wpa_s
->prev_sched_ssid
) {
1173 if (!ssid
|| !wpa_s
->prev_sched_ssid
) {
1174 wpa_dbg(wpa_s
, MSG_DEBUG
, "Beginning of SSID list");
1175 if (wpa_s
->conf
->sched_scan_interval
)
1176 wpa_s
->sched_scan_interval
=
1177 wpa_s
->conf
->sched_scan_interval
;
1178 if (wpa_s
->sched_scan_interval
== 0)
1179 wpa_s
->sched_scan_interval
= 10;
1180 wpa_s
->sched_scan_timeout
= max_sched_scan_ssids
* 2;
1181 wpa_s
->first_sched_scan
= 1;
1182 ssid
= wpa_s
->conf
->ssid
;
1183 wpa_s
->prev_sched_ssid
= ssid
;
1187 wpa_dbg(wpa_s
, MSG_DEBUG
, "Add wildcard SSID to sched_scan");
1192 if (wpas_network_disabled(wpa_s
, ssid
))
1195 if (params
.num_filter_ssids
< wpa_s
->max_match_sets
&&
1196 params
.filter_ssids
&& ssid
->ssid
&& ssid
->ssid_len
) {
1197 wpa_dbg(wpa_s
, MSG_DEBUG
, "add to filter ssid: %s",
1198 wpa_ssid_txt(ssid
->ssid
, ssid
->ssid_len
));
1199 os_memcpy(params
.filter_ssids
[params
.num_filter_ssids
].ssid
,
1200 ssid
->ssid
, ssid
->ssid_len
);
1201 params
.filter_ssids
[params
.num_filter_ssids
].ssid_len
=
1203 params
.num_filter_ssids
++;
1204 } else if (params
.filter_ssids
&& ssid
->ssid
&& ssid
->ssid_len
)
1206 wpa_dbg(wpa_s
, MSG_DEBUG
, "Not enough room for SSID "
1207 "filter for sched_scan - drop filter");
1208 os_free(params
.filter_ssids
);
1209 params
.filter_ssids
= NULL
;
1210 params
.num_filter_ssids
= 0;
1213 if (ssid
->scan_ssid
&& ssid
->ssid
&& ssid
->ssid_len
) {
1214 if (params
.num_ssids
== max_sched_scan_ssids
)
1215 break; /* only room for broadcast SSID */
1216 wpa_dbg(wpa_s
, MSG_DEBUG
,
1217 "add to active scan ssid: %s",
1218 wpa_ssid_txt(ssid
->ssid
, ssid
->ssid_len
));
1219 params
.ssids
[params
.num_ssids
].ssid
=
1221 params
.ssids
[params
.num_ssids
].ssid_len
=
1224 if (params
.num_ssids
>= max_sched_scan_ssids
) {
1225 wpa_s
->prev_sched_ssid
= ssid
;
1229 (wpas_network_disabled(wpa_s
, ssid
) ||
1236 wpa_s
->prev_sched_ssid
= ssid
;
1240 if (params
.num_filter_ssids
== 0) {
1241 os_free(params
.filter_ssids
);
1242 params
.filter_ssids
= NULL
;
1245 extra_ie
= wpa_supplicant_extra_ies(wpa_s
);
1247 params
.extra_ies
= wpabuf_head(extra_ie
);
1248 params
.extra_ies_len
= wpabuf_len(extra_ie
);
1251 if (wpa_s
->conf
->filter_rssi
)
1252 params
.filter_rssi
= wpa_s
->conf
->filter_rssi
;
1254 /* See if user specified frequencies. If so, scan only those. */
1255 if (wpa_s
->conf
->freq_list
&& !params
.freqs
) {
1256 wpa_dbg(wpa_s
, MSG_DEBUG
,
1257 "Optimize scan based on conf->freq_list");
1258 int_array_concat(¶ms
.freqs
, wpa_s
->conf
->freq_list
);
1261 scan_params
= ¶ms
;
1264 if (ssid
|| !wpa_s
->first_sched_scan
) {
1265 wpa_dbg(wpa_s
, MSG_DEBUG
,
1266 "Starting sched scan: interval %d timeout %d",
1267 wpa_s
->sched_scan_interval
, wpa_s
->sched_scan_timeout
);
1269 wpa_dbg(wpa_s
, MSG_DEBUG
,
1270 "Starting sched scan: interval %d (no timeout)",
1271 wpa_s
->sched_scan_interval
);
1274 wpa_setband_scan_freqs(wpa_s
, scan_params
);
1276 ret
= wpa_supplicant_start_sched_scan(wpa_s
, scan_params
,
1277 wpa_s
->sched_scan_interval
);
1278 wpabuf_free(extra_ie
);
1279 os_free(params
.filter_ssids
);
1281 wpa_msg(wpa_s
, MSG_WARNING
, "Failed to initiate sched scan");
1282 if (prev_state
!= wpa_s
->wpa_state
)
1283 wpa_supplicant_set_state(wpa_s
, prev_state
);
1287 /* If we have more SSIDs to scan, add a timeout so we scan them too */
1288 if (ssid
|| !wpa_s
->first_sched_scan
) {
1289 wpa_s
->sched_scan_timed_out
= 0;
1290 eloop_register_timeout(wpa_s
->sched_scan_timeout
, 0,
1291 wpa_supplicant_sched_scan_timeout
,
1293 wpa_s
->first_sched_scan
= 0;
1294 wpa_s
->sched_scan_timeout
/= 2;
1295 wpa_s
->sched_scan_interval
*= 2;
1296 if (wpa_s
->sched_scan_timeout
< wpa_s
->sched_scan_interval
) {
1297 wpa_s
->sched_scan_interval
= 10;
1298 wpa_s
->sched_scan_timeout
= max_sched_scan_ssids
* 2;
1302 /* If there is no more ssids, start next time from the beginning */
1304 wpa_s
->prev_sched_ssid
= NULL
;
1311 * wpa_supplicant_cancel_scan - Cancel a scheduled scan request
1312 * @wpa_s: Pointer to wpa_supplicant data
1314 * This function is used to cancel a scan request scheduled with
1315 * wpa_supplicant_req_scan().
1317 void wpa_supplicant_cancel_scan(struct wpa_supplicant
*wpa_s
)
1319 wpa_dbg(wpa_s
, MSG_DEBUG
, "Cancelling scan request");
1320 eloop_cancel_timeout(wpa_supplicant_scan
, wpa_s
, NULL
);
1325 * wpa_supplicant_cancel_delayed_sched_scan - Stop a delayed scheduled scan
1326 * @wpa_s: Pointer to wpa_supplicant data
1328 * This function is used to stop a delayed scheduled scan.
1330 void wpa_supplicant_cancel_delayed_sched_scan(struct wpa_supplicant
*wpa_s
)
1332 if (!wpa_s
->sched_scan_supported
)
1335 wpa_dbg(wpa_s
, MSG_DEBUG
, "Cancelling delayed sched scan");
1336 eloop_cancel_timeout(wpa_supplicant_delayed_sched_scan_timeout
,
1342 * wpa_supplicant_cancel_sched_scan - Stop running scheduled scans
1343 * @wpa_s: Pointer to wpa_supplicant data
1345 * This function is used to stop a periodic scheduled scan.
1347 void wpa_supplicant_cancel_sched_scan(struct wpa_supplicant
*wpa_s
)
1349 if (!wpa_s
->sched_scanning
)
1352 wpa_dbg(wpa_s
, MSG_DEBUG
, "Cancelling sched scan");
1353 eloop_cancel_timeout(wpa_supplicant_sched_scan_timeout
, wpa_s
, NULL
);
1354 wpa_supplicant_stop_sched_scan(wpa_s
);
1359 * wpa_supplicant_notify_scanning - Indicate possible scan state change
1360 * @wpa_s: Pointer to wpa_supplicant data
1361 * @scanning: Whether scanning is currently in progress
1363 * This function is to generate scanning notifycations. It is called whenever
1364 * there may have been a change in scanning (scan started, completed, stopped).
1365 * wpas_notify_scanning() is called whenever the scanning state changed from the
1366 * previously notified state.
1368 void wpa_supplicant_notify_scanning(struct wpa_supplicant
*wpa_s
,
1371 if (wpa_s
->scanning
!= scanning
) {
1372 wpa_s
->scanning
= scanning
;
1373 wpas_notify_scanning(wpa_s
);
1378 static int wpa_scan_get_max_rate(const struct wpa_scan_res
*res
)
1384 ie
= wpa_scan_get_ie(res
, WLAN_EID_SUPP_RATES
);
1385 for (i
= 0; ie
&& i
< ie
[1]; i
++) {
1386 if ((ie
[i
+ 2] & 0x7f) > rate
)
1387 rate
= ie
[i
+ 2] & 0x7f;
1390 ie
= wpa_scan_get_ie(res
, WLAN_EID_EXT_SUPP_RATES
);
1391 for (i
= 0; ie
&& i
< ie
[1]; i
++) {
1392 if ((ie
[i
+ 2] & 0x7f) > rate
)
1393 rate
= ie
[i
+ 2] & 0x7f;
1401 * wpa_scan_get_ie - Fetch a specified information element from a scan result
1402 * @res: Scan result entry
1403 * @ie: Information element identitifier (WLAN_EID_*)
1404 * Returns: Pointer to the information element (id field) or %NULL if not found
1406 * This function returns the first matching information element in the scan
1409 const u8
* wpa_scan_get_ie(const struct wpa_scan_res
*res
, u8 ie
)
1411 const u8
*end
, *pos
;
1413 pos
= (const u8
*) (res
+ 1);
1414 end
= pos
+ res
->ie_len
;
1416 while (pos
+ 1 < end
) {
1417 if (pos
+ 2 + pos
[1] > end
)
1429 * wpa_scan_get_vendor_ie - Fetch vendor information element from a scan result
1430 * @res: Scan result entry
1431 * @vendor_type: Vendor type (four octets starting the IE payload)
1432 * Returns: Pointer to the information element (id field) or %NULL if not found
1434 * This function returns the first matching information element in the scan
1437 const u8
* wpa_scan_get_vendor_ie(const struct wpa_scan_res
*res
,
1440 const u8
*end
, *pos
;
1442 pos
= (const u8
*) (res
+ 1);
1443 end
= pos
+ res
->ie_len
;
1445 while (pos
+ 1 < end
) {
1446 if (pos
+ 2 + pos
[1] > end
)
1448 if (pos
[0] == WLAN_EID_VENDOR_SPECIFIC
&& pos
[1] >= 4 &&
1449 vendor_type
== WPA_GET_BE32(&pos
[2]))
1459 * wpa_scan_get_vendor_ie_beacon - Fetch vendor information from a scan result
1460 * @res: Scan result entry
1461 * @vendor_type: Vendor type (four octets starting the IE payload)
1462 * Returns: Pointer to the information element (id field) or %NULL if not found
1464 * This function returns the first matching information element in the scan
1467 * This function is like wpa_scan_get_vendor_ie(), but uses IE buffer only
1468 * from Beacon frames instead of either Beacon or Probe Response frames.
1470 const u8
* wpa_scan_get_vendor_ie_beacon(const struct wpa_scan_res
*res
,
1473 const u8
*end
, *pos
;
1475 if (res
->beacon_ie_len
== 0)
1478 pos
= (const u8
*) (res
+ 1);
1480 end
= pos
+ res
->beacon_ie_len
;
1482 while (pos
+ 1 < end
) {
1483 if (pos
+ 2 + pos
[1] > end
)
1485 if (pos
[0] == WLAN_EID_VENDOR_SPECIFIC
&& pos
[1] >= 4 &&
1486 vendor_type
== WPA_GET_BE32(&pos
[2]))
1496 * wpa_scan_get_vendor_ie_multi - Fetch vendor IE data from a scan result
1497 * @res: Scan result entry
1498 * @vendor_type: Vendor type (four octets starting the IE payload)
1499 * Returns: Pointer to the information element payload or %NULL if not found
1501 * This function returns concatenated payload of possibly fragmented vendor
1502 * specific information elements in the scan result. The caller is responsible
1503 * for freeing the returned buffer.
1505 struct wpabuf
* wpa_scan_get_vendor_ie_multi(const struct wpa_scan_res
*res
,
1509 const u8
*end
, *pos
;
1511 buf
= wpabuf_alloc(res
->ie_len
);
1515 pos
= (const u8
*) (res
+ 1);
1516 end
= pos
+ res
->ie_len
;
1518 while (pos
+ 1 < end
) {
1519 if (pos
+ 2 + pos
[1] > end
)
1521 if (pos
[0] == WLAN_EID_VENDOR_SPECIFIC
&& pos
[1] >= 4 &&
1522 vendor_type
== WPA_GET_BE32(&pos
[2]))
1523 wpabuf_put_data(buf
, pos
+ 2 + 4, pos
[1] - 4);
1527 if (wpabuf_len(buf
) == 0) {
1537 * Channels with a great SNR can operate at full rate. What is a great SNR?
1538 * This doc https://supportforums.cisco.com/docs/DOC-12954 says, "the general
1539 * rule of thumb is that any SNR above 20 is good." This one
1540 * http://www.cisco.com/en/US/tech/tk722/tk809/technologies_q_and_a_item09186a00805e9a96.shtml#qa23
1541 * recommends 25 as a minimum SNR for 54 Mbps data rate. 30 is chosen here as a
1542 * conservative value.
1544 #define GREAT_SNR 30
1546 /* Compare function for sorting scan results. Return >0 if @b is considered
1548 static int wpa_scan_result_compar(const void *a
, const void *b
)
1550 #define IS_5GHZ(n) (n > 4000)
1551 #define MIN(a,b) a < b ? a : b
1552 struct wpa_scan_res
**_wa
= (void *) a
;
1553 struct wpa_scan_res
**_wb
= (void *) b
;
1554 struct wpa_scan_res
*wa
= *_wa
;
1555 struct wpa_scan_res
*wb
= *_wb
;
1556 int wpa_a
, wpa_b
, maxrate_a
, maxrate_b
;
1559 /* WPA/WPA2 support preferred */
1560 wpa_a
= wpa_scan_get_vendor_ie(wa
, WPA_IE_VENDOR_TYPE
) != NULL
||
1561 wpa_scan_get_ie(wa
, WLAN_EID_RSN
) != NULL
;
1562 wpa_b
= wpa_scan_get_vendor_ie(wb
, WPA_IE_VENDOR_TYPE
) != NULL
||
1563 wpa_scan_get_ie(wb
, WLAN_EID_RSN
) != NULL
;
1565 if (wpa_b
&& !wpa_a
)
1567 if (!wpa_b
&& wpa_a
)
1570 /* privacy support preferred */
1571 if ((wa
->caps
& IEEE80211_CAP_PRIVACY
) == 0 &&
1572 (wb
->caps
& IEEE80211_CAP_PRIVACY
))
1574 if ((wa
->caps
& IEEE80211_CAP_PRIVACY
) &&
1575 (wb
->caps
& IEEE80211_CAP_PRIVACY
) == 0)
1578 if ((wa
->flags
& wb
->flags
& WPA_SCAN_LEVEL_DBM
) &&
1579 !((wa
->flags
| wb
->flags
) & WPA_SCAN_NOISE_INVALID
)) {
1580 snr_a
= MIN(wa
->level
- wa
->noise
, GREAT_SNR
);
1581 snr_b
= MIN(wb
->level
- wb
->noise
, GREAT_SNR
);
1583 /* Not suitable information to calculate SNR, so use level */
1588 /* best/max rate preferred if SNR close enough */
1589 if ((snr_a
&& snr_b
&& abs(snr_b
- snr_a
) < 5) ||
1590 (wa
->qual
&& wb
->qual
&& abs(wb
->qual
- wa
->qual
) < 10)) {
1591 maxrate_a
= wpa_scan_get_max_rate(wa
);
1592 maxrate_b
= wpa_scan_get_max_rate(wb
);
1593 if (maxrate_a
!= maxrate_b
)
1594 return maxrate_b
- maxrate_a
;
1595 if (IS_5GHZ(wa
->freq
) ^ IS_5GHZ(wb
->freq
))
1596 return IS_5GHZ(wa
->freq
) ? -1 : 1;
1599 /* use freq for channel preference */
1601 /* all things being equal, use SNR; if SNRs are
1602 * identical, use quality values since some drivers may only report
1603 * that value and leave the signal level zero */
1605 return wb
->qual
- wa
->qual
;
1606 return snr_b
- snr_a
;
1613 /* Compare function for sorting scan results when searching a WPS AP for
1614 * provisioning. Return >0 if @b is considered better. */
1615 static int wpa_scan_result_wps_compar(const void *a
, const void *b
)
1617 struct wpa_scan_res
**_wa
= (void *) a
;
1618 struct wpa_scan_res
**_wb
= (void *) b
;
1619 struct wpa_scan_res
*wa
= *_wa
;
1620 struct wpa_scan_res
*wb
= *_wb
;
1621 int uses_wps_a
, uses_wps_b
;
1622 struct wpabuf
*wps_a
, *wps_b
;
1625 /* Optimization - check WPS IE existence before allocated memory and
1626 * doing full reassembly. */
1627 uses_wps_a
= wpa_scan_get_vendor_ie(wa
, WPS_IE_VENDOR_TYPE
) != NULL
;
1628 uses_wps_b
= wpa_scan_get_vendor_ie(wb
, WPS_IE_VENDOR_TYPE
) != NULL
;
1629 if (uses_wps_a
&& !uses_wps_b
)
1631 if (!uses_wps_a
&& uses_wps_b
)
1634 if (uses_wps_a
&& uses_wps_b
) {
1635 wps_a
= wpa_scan_get_vendor_ie_multi(wa
, WPS_IE_VENDOR_TYPE
);
1636 wps_b
= wpa_scan_get_vendor_ie_multi(wb
, WPS_IE_VENDOR_TYPE
);
1637 res
= wps_ap_priority_compar(wps_a
, wps_b
);
1645 * Do not use current AP security policy as a sorting criteria during
1646 * WPS provisioning step since the AP may get reconfigured at the
1647 * completion of provisioning.
1650 /* all things being equal, use signal level; if signal levels are
1651 * identical, use quality values since some drivers may only report
1652 * that value and leave the signal level zero */
1653 if (wb
->level
== wa
->level
)
1654 return wb
->qual
- wa
->qual
;
1655 return wb
->level
- wa
->level
;
1657 #endif /* CONFIG_WPS */
1660 static void dump_scan_res(struct wpa_scan_results
*scan_res
)
1662 #ifndef CONFIG_NO_STDOUT_DEBUG
1665 if (scan_res
->res
== NULL
|| scan_res
->num
== 0)
1668 wpa_printf(MSG_EXCESSIVE
, "Sorted scan results");
1670 for (i
= 0; i
< scan_res
->num
; i
++) {
1671 struct wpa_scan_res
*r
= scan_res
->res
[i
];
1673 if ((r
->flags
& (WPA_SCAN_LEVEL_DBM
| WPA_SCAN_NOISE_INVALID
))
1674 == WPA_SCAN_LEVEL_DBM
) {
1675 int snr
= r
->level
- r
->noise
;
1676 wpa_printf(MSG_EXCESSIVE
, MACSTR
" freq=%d qual=%d "
1677 "noise=%d level=%d snr=%d%s flags=0x%x "
1679 MAC2STR(r
->bssid
), r
->freq
, r
->qual
,
1680 r
->noise
, r
->level
, snr
,
1681 snr
>= GREAT_SNR
? "*" : "", r
->flags
,
1684 wpa_printf(MSG_EXCESSIVE
, MACSTR
" freq=%d qual=%d "
1685 "noise=%d level=%d flags=0x%x age=%u",
1686 MAC2STR(r
->bssid
), r
->freq
, r
->qual
,
1687 r
->noise
, r
->level
, r
->flags
, r
->age
);
1689 pos
= (u8
*) (r
+ 1);
1691 wpa_hexdump(MSG_EXCESSIVE
, "IEs", pos
, r
->ie_len
);
1693 if (r
->beacon_ie_len
)
1694 wpa_hexdump(MSG_EXCESSIVE
, "Beacon IEs",
1695 pos
, r
->beacon_ie_len
);
1697 #endif /* CONFIG_NO_STDOUT_DEBUG */
1702 * wpa_supplicant_filter_bssid_match - Is the specified BSSID allowed
1703 * @wpa_s: Pointer to wpa_supplicant data
1704 * @bssid: BSSID to check
1705 * Returns: 0 if the BSSID is filtered or 1 if not
1707 * This function is used to filter out specific BSSIDs from scan reslts mainly
1708 * for testing purposes (SET bssid_filter ctrl_iface command).
1710 int wpa_supplicant_filter_bssid_match(struct wpa_supplicant
*wpa_s
,
1715 if (wpa_s
->bssid_filter
== NULL
)
1718 for (i
= 0; i
< wpa_s
->bssid_filter_count
; i
++) {
1719 if (os_memcmp(wpa_s
->bssid_filter
+ i
* ETH_ALEN
, bssid
,
1728 static void filter_scan_res(struct wpa_supplicant
*wpa_s
,
1729 struct wpa_scan_results
*res
)
1733 if (wpa_s
->bssid_filter
== NULL
)
1736 for (i
= 0, j
= 0; i
< res
->num
; i
++) {
1737 if (wpa_supplicant_filter_bssid_match(wpa_s
,
1738 res
->res
[i
]->bssid
)) {
1739 res
->res
[j
++] = res
->res
[i
];
1741 os_free(res
->res
[i
]);
1746 if (res
->num
!= j
) {
1747 wpa_printf(MSG_DEBUG
, "Filtered out %d scan results",
1748 (int) (res
->num
- j
));
1755 * wpa_supplicant_get_scan_results - Get scan results
1756 * @wpa_s: Pointer to wpa_supplicant data
1757 * @info: Information about what was scanned or %NULL if not available
1758 * @new_scan: Whether a new scan was performed
1759 * Returns: Scan results, %NULL on failure
1761 * This function request the current scan results from the driver and updates
1762 * the local BSS list wpa_s->bss. The caller is responsible for freeing the
1763 * results with wpa_scan_results_free().
1765 struct wpa_scan_results
*
1766 wpa_supplicant_get_scan_results(struct wpa_supplicant
*wpa_s
,
1767 struct scan_info
*info
, int new_scan
)
1769 struct wpa_scan_results
*scan_res
;
1771 int (*compar
)(const void *, const void *) = wpa_scan_result_compar
;
1773 scan_res
= wpa_drv_get_scan_results2(wpa_s
);
1774 if (scan_res
== NULL
) {
1775 wpa_dbg(wpa_s
, MSG_DEBUG
, "Failed to get scan results");
1778 if (scan_res
->fetch_time
.sec
== 0) {
1780 * Make sure we have a valid timestamp if the driver wrapper
1781 * does not set this.
1783 os_get_reltime(&scan_res
->fetch_time
);
1785 filter_scan_res(wpa_s
, scan_res
);
1788 if (wpas_wps_searching(wpa_s
)) {
1789 wpa_dbg(wpa_s
, MSG_DEBUG
, "WPS: Order scan results with WPS "
1790 "provisioning rules");
1791 compar
= wpa_scan_result_wps_compar
;
1793 #endif /* CONFIG_WPS */
1795 qsort(scan_res
->res
, scan_res
->num
, sizeof(struct wpa_scan_res
*),
1797 dump_scan_res(scan_res
);
1799 wpa_bss_update_start(wpa_s
);
1800 for (i
= 0; i
< scan_res
->num
; i
++)
1801 wpa_bss_update_scan_res(wpa_s
, scan_res
->res
[i
],
1802 &scan_res
->fetch_time
);
1803 wpa_bss_update_end(wpa_s
, info
, new_scan
);
1810 * wpa_supplicant_update_scan_results - Update scan results from the driver
1811 * @wpa_s: Pointer to wpa_supplicant data
1812 * Returns: 0 on success, -1 on failure
1814 * This function updates the BSS table within wpa_supplicant based on the
1815 * currently available scan results from the driver without requesting a new
1816 * scan. This is used in cases where the driver indicates an association
1817 * (including roaming within ESS) and wpa_supplicant does not yet have the
1818 * needed information to complete the connection (e.g., to perform validation
1819 * steps in 4-way handshake).
1821 int wpa_supplicant_update_scan_results(struct wpa_supplicant
*wpa_s
)
1823 struct wpa_scan_results
*scan_res
;
1824 scan_res
= wpa_supplicant_get_scan_results(wpa_s
, NULL
, 0);
1825 if (scan_res
== NULL
)
1827 wpa_scan_results_free(scan_res
);
1834 * scan_only_handler - Reports scan results
1836 void scan_only_handler(struct wpa_supplicant
*wpa_s
,
1837 struct wpa_scan_results
*scan_res
)
1839 wpa_dbg(wpa_s
, MSG_DEBUG
, "Scan-only results received");
1840 if (wpa_s
->last_scan_req
== MANUAL_SCAN_REQ
&&
1841 wpa_s
->manual_scan_use_id
&& wpa_s
->own_scan_running
) {
1842 wpa_msg_ctrl(wpa_s
, MSG_INFO
, WPA_EVENT_SCAN_RESULTS
"id=%u",
1843 wpa_s
->manual_scan_id
);
1844 wpa_s
->manual_scan_use_id
= 0;
1846 wpa_msg_ctrl(wpa_s
, MSG_INFO
, WPA_EVENT_SCAN_RESULTS
);
1848 wpas_notify_scan_results(wpa_s
);
1849 wpas_notify_scan_done(wpa_s
, 1);
1850 if (wpa_s
->scan_work
) {
1851 struct wpa_radio_work
*work
= wpa_s
->scan_work
;
1852 wpa_s
->scan_work
= NULL
;
1853 radio_work_done(work
);
1858 int wpas_scan_scheduled(struct wpa_supplicant
*wpa_s
)
1860 return eloop_is_timeout_registered(wpa_supplicant_scan
, wpa_s
, NULL
);
1864 struct wpa_driver_scan_params
*
1865 wpa_scan_clone_params(const struct wpa_driver_scan_params
*src
)
1867 struct wpa_driver_scan_params
*params
;
1871 params
= os_zalloc(sizeof(*params
));
1875 for (i
= 0; i
< src
->num_ssids
; i
++) {
1876 if (src
->ssids
[i
].ssid
) {
1877 n
= os_malloc(src
->ssids
[i
].ssid_len
);
1880 os_memcpy(n
, src
->ssids
[i
].ssid
,
1881 src
->ssids
[i
].ssid_len
);
1882 params
->ssids
[i
].ssid
= n
;
1883 params
->ssids
[i
].ssid_len
= src
->ssids
[i
].ssid_len
;
1886 params
->num_ssids
= src
->num_ssids
;
1888 if (src
->extra_ies
) {
1889 n
= os_malloc(src
->extra_ies_len
);
1892 os_memcpy(n
, src
->extra_ies
, src
->extra_ies_len
);
1893 params
->extra_ies
= n
;
1894 params
->extra_ies_len
= src
->extra_ies_len
;
1898 int len
= int_array_len(src
->freqs
);
1899 params
->freqs
= os_malloc((len
+ 1) * sizeof(int));
1900 if (params
->freqs
== NULL
)
1902 os_memcpy(params
->freqs
, src
->freqs
, (len
+ 1) * sizeof(int));
1905 if (src
->filter_ssids
) {
1906 params
->filter_ssids
= os_malloc(sizeof(*params
->filter_ssids
) *
1907 src
->num_filter_ssids
);
1908 if (params
->filter_ssids
== NULL
)
1910 os_memcpy(params
->filter_ssids
, src
->filter_ssids
,
1911 sizeof(*params
->filter_ssids
) *
1912 src
->num_filter_ssids
);
1913 params
->num_filter_ssids
= src
->num_filter_ssids
;
1916 params
->filter_rssi
= src
->filter_rssi
;
1917 params
->p2p_probe
= src
->p2p_probe
;
1918 params
->only_new_results
= src
->only_new_results
;
1919 params
->low_priority
= src
->low_priority
;
1924 wpa_scan_free_params(params
);
1929 void wpa_scan_free_params(struct wpa_driver_scan_params
*params
)
1936 for (i
= 0; i
< params
->num_ssids
; i
++)
1937 os_free((u8
*) params
->ssids
[i
].ssid
);
1938 os_free((u8
*) params
->extra_ies
);
1939 os_free(params
->freqs
);
1940 os_free(params
->filter_ssids
);
1945 int wpas_start_pno(struct wpa_supplicant
*wpa_s
)
1948 size_t i
, num_ssid
, num_match_ssid
;
1949 struct wpa_ssid
*ssid
;
1950 struct wpa_driver_scan_params params
;
1952 if (!wpa_s
->sched_scan_supported
)
1955 if (wpa_s
->pno
|| wpa_s
->pno_sched_pending
)
1958 if ((wpa_s
->wpa_state
> WPA_SCANNING
) &&
1959 (wpa_s
->wpa_state
<= WPA_COMPLETED
)) {
1960 wpa_printf(MSG_ERROR
, "PNO: In assoc process");
1964 if (wpa_s
->wpa_state
== WPA_SCANNING
) {
1965 wpa_supplicant_cancel_scan(wpa_s
);
1966 if (wpa_s
->sched_scanning
) {
1967 wpa_printf(MSG_DEBUG
, "Schedule PNO on completion of "
1968 "ongoing sched scan");
1969 wpa_supplicant_cancel_sched_scan(wpa_s
);
1970 wpa_s
->pno_sched_pending
= 1;
1975 os_memset(¶ms
, 0, sizeof(params
));
1977 num_ssid
= num_match_ssid
= 0;
1978 ssid
= wpa_s
->conf
->ssid
;
1980 if (!wpas_network_disabled(wpa_s
, ssid
)) {
1982 if (ssid
->scan_ssid
)
1988 if (num_match_ssid
== 0) {
1989 wpa_printf(MSG_DEBUG
, "PNO: No configured SSIDs");
1993 if (num_match_ssid
> num_ssid
) {
1994 params
.num_ssids
++; /* wildcard */
1998 if (num_ssid
> WPAS_MAX_SCAN_SSIDS
) {
1999 wpa_printf(MSG_DEBUG
, "PNO: Use only the first %u SSIDs from "
2000 "%u", WPAS_MAX_SCAN_SSIDS
, (unsigned int) num_ssid
);
2001 num_ssid
= WPAS_MAX_SCAN_SSIDS
;
2004 if (num_match_ssid
> wpa_s
->max_match_sets
) {
2005 num_match_ssid
= wpa_s
->max_match_sets
;
2006 wpa_dbg(wpa_s
, MSG_DEBUG
, "PNO: Too many SSIDs to match");
2008 params
.filter_ssids
= os_calloc(num_match_ssid
,
2009 sizeof(struct wpa_driver_scan_filter
));
2010 if (params
.filter_ssids
== NULL
)
2013 ssid
= wpa_s
->conf
->ssid
;
2015 if (!wpas_network_disabled(wpa_s
, ssid
)) {
2016 if (ssid
->scan_ssid
&& params
.num_ssids
< num_ssid
) {
2017 params
.ssids
[params
.num_ssids
].ssid
=
2019 params
.ssids
[params
.num_ssids
].ssid_len
=
2023 os_memcpy(params
.filter_ssids
[i
].ssid
, ssid
->ssid
,
2025 params
.filter_ssids
[i
].ssid_len
= ssid
->ssid_len
;
2026 params
.num_filter_ssids
++;
2028 if (i
== num_match_ssid
)
2034 if (wpa_s
->conf
->filter_rssi
)
2035 params
.filter_rssi
= wpa_s
->conf
->filter_rssi
;
2037 interval
= wpa_s
->conf
->sched_scan_interval
?
2038 wpa_s
->conf
->sched_scan_interval
: 10;
2040 if (params
.freqs
== NULL
&& wpa_s
->manual_sched_scan_freqs
) {
2041 wpa_dbg(wpa_s
, MSG_DEBUG
, "Limit sched scan to specified channels");
2042 params
.freqs
= wpa_s
->manual_sched_scan_freqs
;
2045 ret
= wpa_supplicant_start_sched_scan(wpa_s
, ¶ms
, interval
);
2046 os_free(params
.filter_ssids
);
2050 wpa_msg(wpa_s
, MSG_ERROR
, "Failed to schedule PNO");
2055 int wpas_stop_pno(struct wpa_supplicant
*wpa_s
)
2062 ret
= wpa_supplicant_stop_sched_scan(wpa_s
);
2065 wpa_s
->pno_sched_pending
= 0;
2067 if (wpa_s
->wpa_state
== WPA_SCANNING
)
2068 wpa_supplicant_req_scan(wpa_s
, 0, 0);