1 /*
2  * wpa_supplicant - Internal definitions
3  * Copyright (c) 2003-2014, Jouni Malinen <j@w1.fi>
4  *
5  * This software may be distributed under the terms of the BSD license.
6  * See README for more details.
7  */
8 
9 #ifndef WPA_SUPPLICANT_I_H
10 #define WPA_SUPPLICANT_I_H
11 
12 #include "utils/bitfield.h"
13 #include "utils/list.h"
14 #include "common/defs.h"
15 #include "common/sae.h"
16 #include "common/wpa_ctrl.h"
17 #include "wps/wps_defs.h"
18 #include "config_ssid.h"
19 #include "wmm_ac.h"
20 
21 extern const char *const wpa_supplicant_version;
22 extern const char *const wpa_supplicant_license;
23 #ifndef CONFIG_NO_STDOUT_DEBUG
24 extern const char *const wpa_supplicant_full_license1;
25 extern const char *const wpa_supplicant_full_license2;
26 extern const char *const wpa_supplicant_full_license3;
27 extern const char *const wpa_supplicant_full_license4;
28 extern const char *const wpa_supplicant_full_license5;
29 #endif /* CONFIG_NO_STDOUT_DEBUG */
30 
31 struct wpa_sm;
32 struct wpa_supplicant;
33 struct ibss_rsn;
34 struct scan_info;
35 struct wpa_bss;
36 struct wpa_scan_results;
37 struct hostapd_hw_modes;
38 struct wpa_driver_associate_params;
39 
40 /*
41  * Forward declarations of private structures used within the ctrl_iface
42  * backends. Other parts of wpa_supplicant do not have access to data stored in
43  * these structures.
44  */
45 struct ctrl_iface_priv;
46 struct ctrl_iface_global_priv;
47 struct wpas_dbus_priv;
48 struct wpas_hidl_priv;
49 
50 /**
51  * struct wpa_interface - Parameters for wpa_supplicant_add_iface()
52  */
53 struct wpa_interface {
54 	/**
55 	 * confname - Configuration name (file or profile) name
56 	 *
57 	 * This can also be %NULL when a configuration file is not used. In
58 	 * that case, ctrl_interface must be set to allow the interface to be
59 	 * configured.
60 	 */
61 	const char *confname;
62 
63 	/**
64 	 * confanother - Additional configuration name (file or profile) name
65 	 *
66 	 * This can also be %NULL when the additional configuration file is not
67 	 * used.
68 	 */
69 	const char *confanother;
70 
71 	/**
72 	 * ctrl_interface - Control interface parameter
73 	 *
74 	 * If a configuration file is not used, this variable can be used to
75 	 * set the ctrl_interface parameter that would have otherwise been read
76 	 * from the configuration file. If both confname and ctrl_interface are
77 	 * set, ctrl_interface is used to override the value from configuration
78 	 * file.
79 	 */
80 	const char *ctrl_interface;
81 
82 	/**
83 	 * driver - Driver interface name, or %NULL to use the default driver
84 	 */
85 	const char *driver;
86 
87 	/**
88 	 * driver_param - Driver interface parameters
89 	 *
90 	 * If a configuration file is not used, this variable can be used to
91 	 * set the driver_param parameters that would have otherwise been read
92 	 * from the configuration file. If both confname and driver_param are
93 	 * set, driver_param is used to override the value from configuration
94 	 * file.
95 	 */
96 	const char *driver_param;
97 
98 	/**
99 	 * ifname - Interface name
100 	 */
101 	const char *ifname;
102 
103 	/**
104 	 * bridge_ifname - Optional bridge interface name
105 	 *
106 	 * If the driver interface (ifname) is included in a Linux bridge
107 	 * device, the bridge interface may need to be used for receiving EAPOL
108 	 * frames. This can be enabled by setting this variable to enable
109 	 * receiving of EAPOL frames from an additional interface.
110 	 */
111 	const char *bridge_ifname;
112 
113 	/**
114 	 * p2p_mgmt - Interface used for P2P management (P2P Device operations)
115 	 *
116 	 * Indicates whether wpas_p2p_init() must be called for this interface.
117 	 * This is used only when the driver supports a dedicated P2P Device
118 	 * interface that is not a network interface.
119 	 */
120 	int p2p_mgmt;
121 };
122 
123 /**
124  * struct wpa_params - Parameters for wpa_supplicant_init()
125  */
126 struct wpa_params {
127 	/**
128 	 * daemonize - Run %wpa_supplicant in the background
129 	 */
130 	int daemonize;
131 
132 	/**
133 	 * wait_for_monitor - Wait for a monitor program before starting
134 	 */
135 	int wait_for_monitor;
136 
137 	/**
138 	 * pid_file - Path to a PID (process ID) file
139 	 *
140 	 * If this and daemonize are set, process ID of the background process
141 	 * will be written to the specified file.
142 	 */
143 	char *pid_file;
144 
145 	/**
146 	 * wpa_debug_level - Debugging verbosity level (e.g., MSG_INFO)
147 	 */
148 	int wpa_debug_level;
149 
150 	/**
151 	 * wpa_debug_show_keys - Whether keying material is included in debug
152 	 *
153 	 * This parameter can be used to allow keying material to be included
154 	 * in debug messages. This is a security risk and this option should
155 	 * not be enabled in normal configuration. If needed during
156 	 * development or while troubleshooting, this option can provide more
157 	 * details for figuring out what is happening.
158 	 */
159 	int wpa_debug_show_keys;
160 
161 	/**
162 	 * wpa_debug_timestamp - Whether to include timestamp in debug messages
163 	 */
164 	int wpa_debug_timestamp;
165 
166 	/**
167 	 * ctrl_interface - Global ctrl_iface path/parameter
168 	 */
169 	char *ctrl_interface;
170 
171 	/**
172 	 * ctrl_interface_group - Global ctrl_iface group
173 	 */
174 	char *ctrl_interface_group;
175 
176 	/**
177 	 * dbus_ctrl_interface - Enable the DBus control interface
178 	 */
179 	int dbus_ctrl_interface;
180 
181 	/**
182 	 * wpa_debug_file_path - Path of debug file or %NULL to use stdout
183 	 */
184 	const char *wpa_debug_file_path;
185 
186 	/**
187 	 * wpa_debug_syslog - Enable log output through syslog
188 	 */
189 	int wpa_debug_syslog;
190 
191 	/**
192 	 * wpa_debug_tracing - Enable log output through Linux tracing
193 	 */
194 	int wpa_debug_tracing;
195 
196 	/**
197 	 * override_driver - Optional driver parameter override
198 	 *
199 	 * This parameter can be used to override the driver parameter in
200 	 * dynamic interface addition to force a specific driver wrapper to be
201 	 * used instead.
202 	 */
203 	char *override_driver;
204 
205 	/**
206 	 * override_ctrl_interface - Optional ctrl_interface override
207 	 *
208 	 * This parameter can be used to override the ctrl_interface parameter
209 	 * in dynamic interface addition to force a control interface to be
210 	 * created.
211 	 */
212 	char *override_ctrl_interface;
213 
214 	/**
215 	 * entropy_file - Optional entropy file
216 	 *
217 	 * This parameter can be used to configure wpa_supplicant to maintain
218 	 * its internal entropy store over restarts.
219 	 */
220 	char *entropy_file;
221 
222 #ifdef CONFIG_P2P
223 	/**
224 	 * conf_p2p_dev - Configuration file used to hold the
225 	 * P2P Device configuration parameters.
226 	 *
227 	 * This can also be %NULL. In such a case, if a P2P Device dedicated
228 	 * interfaces is created, the main configuration file will be used.
229 	 */
230 	char *conf_p2p_dev;
231 #endif /* CONFIG_P2P */
232 
233 #ifdef CONFIG_MATCH_IFACE
234 	/**
235 	 * match_ifaces - Interface descriptions to match
236 	 */
237 	struct wpa_interface *match_ifaces;
238 
239 	/**
240 	 * match_iface_count - Number of defined matching interfaces
241 	 */
242 	int match_iface_count;
243 #endif /* CONFIG_MATCH_IFACE */
244 };
245 
246 struct p2p_srv_bonjour {
247 	struct dl_list list;
248 	struct wpabuf *query;
249 	struct wpabuf *resp;
250 };
251 
252 struct p2p_srv_upnp {
253 	struct dl_list list;
254 	u8 version;
255 	char *service;
256 };
257 
258 /**
259  * struct wpa_global - Internal, global data for all %wpa_supplicant interfaces
260  *
261  * This structure is initialized by calling wpa_supplicant_init() when starting
262  * %wpa_supplicant.
263  */
264 struct wpa_global {
265 	struct wpa_supplicant *ifaces;
266 	struct wpa_params params;
267 	struct ctrl_iface_global_priv *ctrl_iface;
268 	struct wpas_dbus_priv *dbus;
269 	struct wpas_hidl_priv *hidl;
270 	void **drv_priv;
271 	size_t drv_count;
272 	struct os_time suspend_time;
273 	struct p2p_data *p2p;
274 	struct wpa_supplicant *p2p_init_wpa_s;
275 	struct wpa_supplicant *p2p_group_formation;
276 	struct wpa_supplicant *p2p_invite_group;
277 	u8 p2p_dev_addr[ETH_ALEN];
278 	struct os_reltime p2p_go_wait_client;
279 	struct dl_list p2p_srv_bonjour; /* struct p2p_srv_bonjour */
280 	struct dl_list p2p_srv_upnp; /* struct p2p_srv_upnp */
281 	int p2p_disabled;
282 	int cross_connection;
283 	struct wpa_freq_range_list p2p_disallow_freq;
284 	struct wpa_freq_range_list p2p_go_avoid_freq;
285 	enum wpa_conc_pref {
286 		WPA_CONC_PREF_NOT_SET,
287 		WPA_CONC_PREF_STA,
288 		WPA_CONC_PREF_P2P
289 	} conc_pref;
290 	unsigned int p2p_per_sta_psk:1;
291 	unsigned int p2p_fail_on_wps_complete:1;
292 	unsigned int p2p_24ghz_social_channels:1;
293 	unsigned int pending_p2ps_group:1;
294 	unsigned int pending_group_iface_for_p2ps:1;
295 	unsigned int pending_p2ps_group_freq;
296 
297 #ifdef CONFIG_WIFI_DISPLAY
298 	int wifi_display;
299 #define MAX_WFD_SUBELEMS 12
300 	struct wpabuf *wfd_subelem[MAX_WFD_SUBELEMS];
301 #endif /* CONFIG_WIFI_DISPLAY */
302 
303 	struct psk_list_entry *add_psk; /* From group formation */
304 };
305 
306 
307 /**
308  * struct wpa_radio - Internal data for per-radio information
309  *
310  * This structure is used to share data about configured interfaces
311  * (struct wpa_supplicant) that share the same physical radio, e.g., to allow
312  * better coordination of offchannel operations.
313  */
314 struct wpa_radio {
315 	char name[16]; /* from driver_ops get_radio_name() or empty if not
316 			* available */
317 	unsigned int external_scan_running:1;
318 	unsigned int num_active_works;
319 	struct dl_list ifaces; /* struct wpa_supplicant::radio_list entries */
320 	struct dl_list work; /* struct wpa_radio_work::list entries */
321 };
322 
323 #define MAX_ACTIVE_WORKS 2
324 
325 
326 /**
327  * struct wpa_radio_work - Radio work item
328  */
329 struct wpa_radio_work {
330 	struct dl_list list;
331 	unsigned int freq; /* known frequency (MHz) or 0 for multiple/unknown */
332 	const char *type;
333 	struct wpa_supplicant *wpa_s;
334 	void (*cb)(struct wpa_radio_work *work, int deinit);
335 	void *ctx;
336 	unsigned int started:1;
337 	struct os_reltime time;
338 	unsigned int bands;
339 };
340 
341 int radio_add_work(struct wpa_supplicant *wpa_s, unsigned int freq,
342 		   const char *type, int next,
343 		   void (*cb)(struct wpa_radio_work *work, int deinit),
344 		   void *ctx);
345 void radio_work_done(struct wpa_radio_work *work);
346 void radio_remove_works(struct wpa_supplicant *wpa_s,
347 			const char *type, int remove_all);
348 void radio_work_check_next(struct wpa_supplicant *wpa_s);
349 struct wpa_radio_work *
350 radio_work_pending(struct wpa_supplicant *wpa_s, const char *type);
351 
352 struct wpa_connect_work {
353 	unsigned int sme:1;
354 	unsigned int bss_removed:1;
355 	struct wpa_bss *bss;
356 	struct wpa_ssid *ssid;
357 };
358 
359 int wpas_valid_bss_ssid(struct wpa_supplicant *wpa_s, struct wpa_bss *test_bss,
360 			struct wpa_ssid *test_ssid);
361 void wpas_connect_work_free(struct wpa_connect_work *cwork);
362 void wpas_connect_work_done(struct wpa_supplicant *wpa_s);
363 
364 struct wpa_external_work {
365 	unsigned int id;
366 	char type[100];
367 	unsigned int timeout;
368 };
369 
370 enum wpa_radio_work_band wpas_freq_to_band(int freq);
371 unsigned int wpas_get_bands(struct wpa_supplicant *wpa_s, const int *freqs);
372 
373 /**
374  * offchannel_send_action_result - Result of offchannel send Action frame
375  */
376 enum offchannel_send_action_result {
377 	OFFCHANNEL_SEND_ACTION_SUCCESS /**< Frame was send and acknowledged */,
378 	OFFCHANNEL_SEND_ACTION_NO_ACK /**< Frame was sent, but not acknowledged
379 				       */,
380 	OFFCHANNEL_SEND_ACTION_FAILED /**< Frame was not sent due to a failure
381 				       */
382 };
383 
384 struct wps_ap_info {
385 	u8 bssid[ETH_ALEN];
386 	enum wps_ap_info_type {
387 		WPS_AP_NOT_SEL_REG,
388 		WPS_AP_SEL_REG,
389 		WPS_AP_SEL_REG_OUR
390 	} type;
391 	unsigned int tries;
392 	struct os_reltime last_attempt;
393 	unsigned int pbc_active;
394 	u8 uuid[WPS_UUID_LEN];
395 };
396 
397 #define WPA_FREQ_USED_BY_INFRA_STATION BIT(0)
398 #define WPA_FREQ_USED_BY_P2P_CLIENT BIT(1)
399 
400 struct wpa_used_freq_data {
401 	int freq;
402 	unsigned int flags;
403 };
404 
405 #define RRM_NEIGHBOR_REPORT_TIMEOUT 1 /* 1 second for AP to send a report */
406 
407 /*
408  * struct rrm_data - Data used for managing RRM features
409  */
410 struct rrm_data {
411 	/* rrm_used - indication regarding the current connection */
412 	unsigned int rrm_used:1;
413 
414 	/*
415 	 * notify_neighbor_rep - Callback for notifying report requester
416 	 */
417 	void (*notify_neighbor_rep)(void *ctx, struct wpabuf *neighbor_rep);
418 
419 	/*
420 	 * neighbor_rep_cb_ctx - Callback context
421 	 * Received in the callback registration, and sent to the callback
422 	 * function as a parameter.
423 	 */
424 	void *neighbor_rep_cb_ctx;
425 
426 	/* next_neighbor_rep_token - Next request's dialog token */
427 	u8 next_neighbor_rep_token;
428 
429 	/* token - Dialog token of the current radio measurement */
430 	u8 token;
431 
432 	/* destination address of the current radio measurement request */
433 	u8 dst_addr[ETH_ALEN];
434 };
435 
436 enum wpa_supplicant_test_failure {
437 	WPAS_TEST_FAILURE_NONE,
438 	WPAS_TEST_FAILURE_SCAN_TRIGGER,
439 };
440 
441 struct icon_entry {
442 	struct dl_list list;
443 	u8 bssid[ETH_ALEN];
444 	u8 dialog_token;
445 	char *file_name;
446 	u8 *image;
447 	size_t image_len;
448 };
449 
450 struct wpa_bss_tmp_disallowed {
451 	struct dl_list list;
452 	u8 bssid[ETH_ALEN];
453 };
454 
455 struct beacon_rep_data {
456 	u8 token;
457 	struct wpa_driver_scan_params scan_params;
458 	u8 ssid[SSID_MAX_LEN];
459 	size_t ssid_len;
460 	u8 bssid[ETH_ALEN];
461 	enum beacon_report_detail report_detail;
462 	struct bitfield *eids;
463 };
464 
465 
466 struct external_pmksa_cache {
467 	struct dl_list list;
468 	void *pmksa_cache;
469 };
470 
471 struct fils_hlp_req {
472 	struct dl_list list;
473 	u8 dst[ETH_ALEN];
474 	struct wpabuf *pkt;
475 };
476 
477 /**
478  * struct wpa_supplicant - Internal data for wpa_supplicant interface
479  *
480  * This structure contains the internal data for core wpa_supplicant code. This
481  * should be only used directly from the core code. However, a pointer to this
482  * data is used from other files as an arbitrary context pointer in calls to
483  * core functions.
484  */
485 struct wpa_supplicant {
486 	struct wpa_global *global;
487 	struct wpa_radio *radio; /* shared radio context */
488 	struct dl_list radio_list; /* list head: struct wpa_radio::ifaces */
489 	struct wpa_supplicant *parent;
490 	struct wpa_supplicant *p2pdev;
491 	struct wpa_supplicant *next;
492 	struct l2_packet_data *l2;
493 	struct l2_packet_data *l2_br;
494 	unsigned char own_addr[ETH_ALEN];
495 	unsigned char perm_addr[ETH_ALEN];
496 	char ifname[100];
497 #ifdef CONFIG_MATCH_IFACE
498 	int matched;
499 #endif /* CONFIG_MATCH_IFACE */
500 #ifdef CONFIG_CTRL_IFACE_DBUS
501 	char *dbus_path;
502 #endif /* CONFIG_CTRL_IFACE_DBUS */
503 #ifdef CONFIG_CTRL_IFACE_DBUS_NEW
504 	char *dbus_new_path;
505 	char *dbus_groupobj_path;
506 #ifdef CONFIG_AP
507 	char *preq_notify_peer;
508 #endif /* CONFIG_AP */
509 #endif /* CONFIG_CTRL_IFACE_DBUS_NEW */
510 #ifdef CONFIG_CTRL_IFACE_HIDL
511 	const void *hidl_object_key;
512 #endif /* CONFIG_CTRL_IFACE_HIDL */
513 	char bridge_ifname[16];
514 
515 	char *confname;
516 	char *confanother;
517 
518 	struct wpa_config *conf;
519 	int countermeasures;
520 	struct os_reltime last_michael_mic_error;
521 	u8 bssid[ETH_ALEN];
522 	u8 pending_bssid[ETH_ALEN]; /* If wpa_state == WPA_ASSOCIATING, this
523 				     * field contains the target BSSID. */
524 	int reassociate; /* reassociation requested */
525 	unsigned int reassoc_same_bss:1; /* reassociating to the same BSS */
526 	unsigned int reassoc_same_ess:1; /* reassociating to the same ESS */
527 	int disconnected; /* all connections disabled; i.e., do no reassociate
528 			   * before this has been cleared */
529 	struct wpa_ssid *current_ssid;
530 	struct wpa_ssid *last_ssid;
531 	struct wpa_bss *current_bss;
532 	int ap_ies_from_associnfo;
533 	unsigned int assoc_freq;
534 
535 	/* Selected configuration (based on Beacon/ProbeResp WPA IE) */
536 	int pairwise_cipher;
537 	int group_cipher;
538 	int key_mgmt;
539 	int wpa_proto;
540 	int mgmt_group_cipher;
541 
542 	void *drv_priv; /* private data used by driver_ops */
543 	void *global_drv_priv;
544 
545 	u8 *bssid_filter;
546 	size_t bssid_filter_count;
547 
548 	u8 *disallow_aps_bssid;
549 	size_t disallow_aps_bssid_count;
550 	struct wpa_ssid_value *disallow_aps_ssid;
551 	size_t disallow_aps_ssid_count;
552 
553 	enum set_band setband;
554 
555 	/* Preferred network for the next connection attempt */
556 	struct wpa_ssid *next_ssid;
557 
558 	/* previous scan was wildcard when interleaving between
559 	 * wildcard scans and specific SSID scan when max_ssids=1 */
560 	int prev_scan_wildcard;
561 	struct wpa_ssid *prev_scan_ssid; /* previously scanned SSID;
562 					  * NULL = not yet initialized (start
563 					  * with wildcard SSID)
564 					  * WILDCARD_SSID_SCAN = wildcard
565 					  * SSID was used in the previous scan
566 					  */
567 #define WILDCARD_SSID_SCAN ((struct wpa_ssid *) 1)
568 
569 	struct wpa_ssid *prev_sched_ssid; /* last SSID used in sched scan */
570 	int sched_scan_timeout;
571 	int first_sched_scan;
572 	int sched_scan_timed_out;
573 	struct sched_scan_plan *sched_scan_plans;
574 	size_t sched_scan_plans_num;
575 
576 	void (*scan_res_handler)(struct wpa_supplicant *wpa_s,
577 				 struct wpa_scan_results *scan_res);
578 	struct dl_list bss; /* struct wpa_bss::list */
579 	struct dl_list bss_id; /* struct wpa_bss::list_id */
580 	size_t num_bss;
581 	unsigned int bss_update_idx;
582 	unsigned int bss_next_id;
583 
584 	 /*
585 	  * Pointers to BSS entries in the order they were in the last scan
586 	  * results.
587 	  */
588 	struct wpa_bss **last_scan_res;
589 	unsigned int last_scan_res_used;
590 	unsigned int last_scan_res_size;
591 	struct os_reltime last_scan;
592 
593 	const struct wpa_driver_ops *driver;
594 	int interface_removed; /* whether the network interface has been
595 				* removed */
596 	struct wpa_sm *wpa;
597 	struct eapol_sm *eapol;
598 
599 	struct ctrl_iface_priv *ctrl_iface;
600 
601 	enum wpa_states wpa_state;
602 	struct wpa_radio_work *scan_work;
603 	int scanning;
604 	int sched_scanning;
605 	unsigned int sched_scan_stop_req:1;
606 	int new_connection;
607 
608 	int eapol_received; /* number of EAPOL packets received after the
609 			     * previous association event */
610 
611 	struct scard_data *scard;
612 	char imsi[20];
613 	int mnc_len;
614 
615 	unsigned char last_eapol_src[ETH_ALEN];
616 
617 	unsigned int keys_cleared; /* bitfield of key indexes that the driver is
618 				    * known not to be configured with a key */
619 
620 	struct wpa_blacklist *blacklist;
621 
622 	/**
623 	 * extra_blacklist_count - Sum of blacklist counts after last connection
624 	 *
625 	 * This variable is used to maintain a count of temporary blacklisting
626 	 * failures (maximum number for any BSS) over blacklist clear
627 	 * operations. This is needed for figuring out whether there has been
628 	 * failures prior to the last blacklist clear operation which happens
629 	 * whenever no other not-blacklisted BSS candidates are available. This
630 	 * gets cleared whenever a connection has been established successfully.
631 	 */
632 	int extra_blacklist_count;
633 
634 	/**
635 	 * scan_req - Type of the scan request
636 	 */
637 	enum scan_req_type {
638 		/**
639 		 * NORMAL_SCAN_REQ - Normal scan request
640 		 *
641 		 * This is used for scans initiated by wpa_supplicant to find an
642 		 * AP for a connection.
643 		 */
644 		NORMAL_SCAN_REQ,
645 
646 		/**
647 		 * INITIAL_SCAN_REQ - Initial scan request
648 		 *
649 		 * This is used for the first scan on an interface to force at
650 		 * least one scan to be run even if the configuration does not
651 		 * include any enabled networks.
652 		 */
653 		INITIAL_SCAN_REQ,
654 
655 		/**
656 		 * MANUAL_SCAN_REQ - Manual scan request
657 		 *
658 		 * This is used for scans where the user request a scan or
659 		 * a specific wpa_supplicant operation (e.g., WPS) requires scan
660 		 * to be run.
661 		 */
662 		MANUAL_SCAN_REQ
663 	} scan_req, last_scan_req;
664 	enum wpa_states scan_prev_wpa_state;
665 	struct os_reltime scan_trigger_time, scan_start_time;
666 	/* Minimum freshness requirement for connection purposes */
667 	struct os_reltime scan_min_time;
668 	int scan_runs; /* number of scan runs since WPS was started */
669 	int *next_scan_freqs;
670 	int *select_network_scan_freqs;
671 	int *manual_scan_freqs;
672 	int *manual_sched_scan_freqs;
673 	unsigned int manual_scan_passive:1;
674 	unsigned int manual_scan_use_id:1;
675 	unsigned int manual_scan_only_new:1;
676 	unsigned int own_scan_requested:1;
677 	unsigned int own_scan_running:1;
678 	unsigned int clear_driver_scan_cache:1;
679 	unsigned int manual_scan_id;
680 	int scan_interval; /* time in sec between scans to find suitable AP */
681 	int normal_scans; /* normal scans run before sched_scan */
682 	int scan_for_connection; /* whether the scan request was triggered for
683 				  * finding a connection */
684 	/*
685 	 * A unique cookie representing the vendor scan request. This cookie is
686 	 * returned from the driver interface. 0 indicates that there is no
687 	 * pending vendor scan request.
688 	 */
689 	u64 curr_scan_cookie;
690 #define MAX_SCAN_ID 16
691 	int scan_id[MAX_SCAN_ID];
692 	unsigned int scan_id_count;
693 	u8 next_scan_bssid[ETH_ALEN];
694 
695 	struct wpa_ssid_value *ssids_from_scan_req;
696 	unsigned int num_ssids_from_scan_req;
697 
698 	u64 drv_flags;
699 	unsigned int drv_enc;
700 	unsigned int drv_smps_modes;
701 	unsigned int drv_rrm_flags;
702 
703 	/*
704 	 * A bitmap of supported protocols for probe response offload. See
705 	 * struct wpa_driver_capa in driver.h
706 	 */
707 	unsigned int probe_resp_offloads;
708 
709 	/* extended capabilities supported by the driver */
710 	const u8 *extended_capa, *extended_capa_mask;
711 	unsigned int extended_capa_len;
712 
713 	int max_scan_ssids;
714 	int max_sched_scan_ssids;
715 	unsigned int max_sched_scan_plans;
716 	unsigned int max_sched_scan_plan_interval;
717 	unsigned int max_sched_scan_plan_iterations;
718 	int sched_scan_supported;
719 	unsigned int max_match_sets;
720 	unsigned int max_remain_on_chan;
721 	unsigned int max_stations;
722 
723 	int pending_mic_error_report;
724 	int pending_mic_error_pairwise;
725 	int mic_errors_seen; /* Michael MIC errors with the current PTK */
726 
727 	struct wps_context *wps;
728 	int wps_success; /* WPS success event received */
729 	struct wps_er *wps_er;
730 	unsigned int wps_run;
731 	struct os_reltime wps_pin_start_time;
732 	int blacklist_cleared;
733 
734 	struct wpabuf *pending_eapol_rx;
735 	struct os_reltime pending_eapol_rx_time;
736 	u8 pending_eapol_rx_src[ETH_ALEN];
737 	unsigned int last_eapol_matches_bssid:1;
738 	unsigned int eap_expected_failure:1;
739 	unsigned int reattach:1; /* reassociation to the same BSS requested */
740 	unsigned int mac_addr_changed:1;
741 	unsigned int added_vif:1;
742 	unsigned int wnmsleep_used:1;
743 
744 	struct os_reltime last_mac_addr_change;
745 	int last_mac_addr_style;
746 
747 	struct ibss_rsn *ibss_rsn;
748 
749 	int set_sta_uapsd;
750 	int sta_uapsd;
751 	int set_ap_uapsd;
752 	int ap_uapsd;
753 	int auth_alg;
754 
755 #ifdef CONFIG_SME
756 	struct {
757 		u8 ssid[SSID_MAX_LEN];
758 		size_t ssid_len;
759 		int freq;
760 		u8 assoc_req_ie[1500];
761 		size_t assoc_req_ie_len;
762 		int mfp;
763 		int ft_used;
764 		u8 mobility_domain[2];
765 		u8 *ft_ies;
766 		size_t ft_ies_len;
767 		u8 prev_bssid[ETH_ALEN];
768 		int prev_bssid_set;
769 		int auth_alg;
770 		int proto;
771 
772 		int sa_query_count; /* number of pending SA Query requests;
773 				     * 0 = no SA Query in progress */
774 		int sa_query_timed_out;
775 		u8 *sa_query_trans_id; /* buffer of WLAN_SA_QUERY_TR_ID_LEN *
776 					* sa_query_count octets of pending
777 					* SA Query transaction identifiers */
778 		struct os_reltime sa_query_start;
779 		struct os_reltime last_unprot_disconnect;
780 		enum { HT_SEC_CHAN_UNKNOWN,
781 		       HT_SEC_CHAN_ABOVE,
782 		       HT_SEC_CHAN_BELOW } ht_sec_chan;
783 		u8 sched_obss_scan;
784 		u16 obss_scan_int;
785 		u16 bss_max_idle_period;
786 #ifdef CONFIG_SAE
787 		struct sae_data sae;
788 		struct wpabuf *sae_token;
789 		int sae_group_index;
790 		unsigned int sae_pmksa_caching:1;
791 #endif /* CONFIG_SAE */
792 	} sme;
793 #endif /* CONFIG_SME */
794 
795 #ifdef CONFIG_AP
796 	struct hostapd_iface *ap_iface;
797 	void (*ap_configured_cb)(void *ctx, void *data);
798 	void *ap_configured_cb_ctx;
799 	void *ap_configured_cb_data;
800 #endif /* CONFIG_AP */
801 
802 	struct hostapd_iface *ifmsh;
803 #ifdef CONFIG_MESH
804 	struct mesh_rsn *mesh_rsn;
805 	int mesh_if_idx;
806 	unsigned int mesh_if_created:1;
807 	unsigned int mesh_ht_enabled:1;
808 	unsigned int mesh_vht_enabled:1;
809 #ifdef CONFIG_PMKSA_CACHE_EXTERNAL
810 	/* struct external_pmksa_cache::list */
811 	struct dl_list mesh_external_pmksa_cache;
812 #endif /* CONFIG_PMKSA_CACHE_EXTERNAL */
813 #endif /* CONFIG_MESH */
814 
815 	unsigned int off_channel_freq;
816 	struct wpabuf *pending_action_tx;
817 	u8 pending_action_src[ETH_ALEN];
818 	u8 pending_action_dst[ETH_ALEN];
819 	u8 pending_action_bssid[ETH_ALEN];
820 	unsigned int pending_action_freq;
821 	int pending_action_no_cck;
822 	int pending_action_without_roc;
823 	unsigned int pending_action_tx_done:1;
824 	void (*pending_action_tx_status_cb)(struct wpa_supplicant *wpa_s,
825 					    unsigned int freq, const u8 *dst,
826 					    const u8 *src, const u8 *bssid,
827 					    const u8 *data, size_t data_len,
828 					    enum offchannel_send_action_result
829 					    result);
830 	unsigned int roc_waiting_drv_freq;
831 	int action_tx_wait_time;
832 	int action_tx_wait_time_used;
833 
834 	int p2p_mgmt;
835 
836 #ifdef CONFIG_P2P
837 	struct p2p_go_neg_results *go_params;
838 	int create_p2p_iface;
839 	u8 pending_interface_addr[ETH_ALEN];
840 	char pending_interface_name[100];
841 	int pending_interface_type;
842 	int p2p_group_idx;
843 	unsigned int pending_listen_freq;
844 	unsigned int pending_listen_duration;
845 	enum {
846 		NOT_P2P_GROUP_INTERFACE,
847 		P2P_GROUP_INTERFACE_PENDING,
848 		P2P_GROUP_INTERFACE_GO,
849 		P2P_GROUP_INTERFACE_CLIENT
850 	} p2p_group_interface;
851 	struct p2p_group *p2p_group;
852 	int p2p_long_listen; /* remaining time in long Listen state in ms */
853 	char p2p_pin[10];
854 	int p2p_wps_method;
855 	u8 p2p_auth_invite[ETH_ALEN];
856 	int p2p_sd_over_ctrl_iface;
857 	int p2p_in_provisioning;
858 	int p2p_in_invitation;
859 	int p2p_invite_go_freq;
860 	int pending_invite_ssid_id;
861 	int show_group_started;
862 	u8 go_dev_addr[ETH_ALEN];
863 	int pending_pd_before_join;
864 	u8 pending_join_iface_addr[ETH_ALEN];
865 	u8 pending_join_dev_addr[ETH_ALEN];
866 	int pending_join_wps_method;
867 	u8 p2p_join_ssid[SSID_MAX_LEN];
868 	size_t p2p_join_ssid_len;
869 	int p2p_join_scan_count;
870 	int auto_pd_scan_retry;
871 	int force_long_sd;
872 	u16 pending_pd_config_methods;
873 	enum {
874 		NORMAL_PD, AUTO_PD_GO_NEG, AUTO_PD_JOIN, AUTO_PD_ASP
875 	} pending_pd_use;
876 
877 	/*
878 	 * Whether cross connection is disallowed by the AP to which this
879 	 * interface is associated (only valid if there is an association).
880 	 */
881 	int cross_connect_disallowed;
882 
883 	/*
884 	 * Whether this P2P group is configured to use cross connection (only
885 	 * valid if this is P2P GO interface). The actual cross connect packet
886 	 * forwarding may not be configured depending on the uplink status.
887 	 */
888 	int cross_connect_enabled;
889 
890 	/* Whether cross connection forwarding is in use at the moment. */
891 	int cross_connect_in_use;
892 
893 	/*
894 	 * Uplink interface name for cross connection
895 	 */
896 	char cross_connect_uplink[100];
897 
898 	unsigned int p2p_auto_join:1;
899 	unsigned int p2p_auto_pd:1;
900 	unsigned int p2p_persistent_group:1;
901 	unsigned int p2p_fallback_to_go_neg:1;
902 	unsigned int p2p_pd_before_go_neg:1;
903 	unsigned int p2p_go_ht40:1;
904 	unsigned int p2p_go_vht:1;
905 	unsigned int user_initiated_pd:1;
906 	unsigned int p2p_go_group_formation_completed:1;
907 	unsigned int group_formation_reported:1;
908 	unsigned int waiting_presence_resp;
909 	int p2p_first_connection_timeout;
910 	unsigned int p2p_nfc_tag_enabled:1;
911 	unsigned int p2p_peer_oob_pk_hash_known:1;
912 	unsigned int p2p_disable_ip_addr_req:1;
913 	unsigned int p2ps_method_config_any:1;
914 	unsigned int p2p_cli_probe:1;
915 	int p2p_persistent_go_freq;
916 	int p2p_persistent_id;
917 	int p2p_go_intent;
918 	int p2p_connect_freq;
919 	struct os_reltime p2p_auto_started;
920 	struct wpa_ssid *p2p_last_4way_hs_fail;
921 	struct wpa_radio_work *p2p_scan_work;
922 	struct wpa_radio_work *p2p_listen_work;
923 	struct wpa_radio_work *p2p_send_action_work;
924 
925 	u16 p2p_oob_dev_pw_id; /* OOB Device Password Id for group formation */
926 	struct wpabuf *p2p_oob_dev_pw; /* OOB Device Password for group
927 					* formation */
928 	u8 p2p_peer_oob_pubkey_hash[WPS_OOB_PUBKEY_HASH_LEN];
929 	u8 p2p_ip_addr_info[3 * 4];
930 
931 	/* group common frequencies */
932 	int *p2p_group_common_freqs;
933 	unsigned int p2p_group_common_freqs_num;
934 	u8 p2ps_join_addr[ETH_ALEN];
935 
936 	unsigned int p2p_go_max_oper_chwidth;
937 	unsigned int p2p_go_vht_center_freq2;
938 	int p2p_lo_started;
939 #endif /* CONFIG_P2P */
940 
941 	struct wpa_ssid *bgscan_ssid;
942 	const struct bgscan_ops *bgscan;
943 	void *bgscan_priv;
944 
945 	const struct autoscan_ops *autoscan;
946 	struct wpa_driver_scan_params *autoscan_params;
947 	void *autoscan_priv;
948 
949 	struct wpa_ssid *connect_without_scan;
950 
951 	struct wps_ap_info *wps_ap;
952 	size_t num_wps_ap;
953 	int wps_ap_iter;
954 
955 	int after_wps;
956 	int known_wps_freq;
957 	unsigned int wps_freq;
958 	int wps_fragment_size;
959 	int auto_reconnect_disabled;
960 
961 	 /* Channel preferences for AP/P2P GO use */
962 	int best_24_freq;
963 	int best_5_freq;
964 	int best_overall_freq;
965 
966 	struct gas_query *gas;
967 	struct gas_server *gas_server;
968 
969 #ifdef CONFIG_INTERWORKING
970 	unsigned int fetch_anqp_in_progress:1;
971 	unsigned int network_select:1;
972 	unsigned int auto_select:1;
973 	unsigned int auto_network_select:1;
974 	unsigned int interworking_fast_assoc_tried:1;
975 	unsigned int fetch_all_anqp:1;
976 	unsigned int fetch_osu_info:1;
977 	unsigned int fetch_osu_waiting_scan:1;
978 	unsigned int fetch_osu_icon_in_progress:1;
979 	struct wpa_bss *interworking_gas_bss;
980 	unsigned int osu_icon_id;
981 	struct dl_list icon_head; /* struct icon_entry */
982 	struct osu_provider *osu_prov;
983 	size_t osu_prov_count;
984 	struct os_reltime osu_icon_fetch_start;
985 	unsigned int num_osu_scans;
986 	unsigned int num_prov_found;
987 #endif /* CONFIG_INTERWORKING */
988 	unsigned int drv_capa_known;
989 
990 	struct {
991 		struct hostapd_hw_modes *modes;
992 		u16 num_modes;
993 		u16 flags;
994 	} hw;
995 	enum local_hw_capab {
996 		CAPAB_NO_HT_VHT,
997 		CAPAB_HT,
998 		CAPAB_HT40,
999 		CAPAB_VHT,
1000 	} hw_capab;
1001 #ifdef CONFIG_MACSEC
1002 	struct ieee802_1x_kay *kay;
1003 #endif /* CONFIG_MACSEC */
1004 
1005 	int pno;
1006 	int pno_sched_pending;
1007 
1008 	/* WLAN_REASON_* reason codes. Negative if locally generated. */
1009 	int disconnect_reason;
1010 
1011 	/* WLAN_STATUS_* status codes from (Re)Association Response frame. */
1012 	u16 assoc_status_code;
1013 	/* Indicates if the previous association request timed out. */
1014 	u8 assoc_timed_out;
1015 
1016 	struct ext_password_data *ext_pw;
1017 
1018 	struct wpabuf *last_gas_resp, *prev_gas_resp;
1019 	u8 last_gas_addr[ETH_ALEN], prev_gas_addr[ETH_ALEN];
1020 	u8 last_gas_dialog_token, prev_gas_dialog_token;
1021 
1022 	unsigned int no_keep_alive:1;
1023 	unsigned int ext_mgmt_frame_handling:1;
1024 	unsigned int ext_eapol_frame_io:1;
1025 	unsigned int wmm_ac_supported:1;
1026 	unsigned int ext_work_in_progress:1;
1027 	unsigned int own_disconnect_req:1;
1028 	unsigned int ignore_post_flush_scan_res:1;
1029 
1030 #define MAC_ADDR_RAND_SCAN       BIT(0)
1031 #define MAC_ADDR_RAND_SCHED_SCAN BIT(1)
1032 #define MAC_ADDR_RAND_PNO        BIT(2)
1033 #define MAC_ADDR_RAND_ALL        (MAC_ADDR_RAND_SCAN | \
1034 				  MAC_ADDR_RAND_SCHED_SCAN | \
1035 				  MAC_ADDR_RAND_PNO)
1036 	unsigned int mac_addr_rand_supported;
1037 	unsigned int mac_addr_rand_enable;
1038 
1039 	/* MAC Address followed by mask (2 * ETH_ALEN) */
1040 	u8 *mac_addr_scan;
1041 	u8 *mac_addr_sched_scan;
1042 	u8 *mac_addr_pno;
1043 
1044 #ifdef CONFIG_WNM
1045 	u8 wnm_dialog_token;
1046 	u8 wnm_reply;
1047 	u8 wnm_num_neighbor_report;
1048 	u8 wnm_mode;
1049 	u16 wnm_dissoc_timer;
1050 	u8 wnm_bss_termination_duration[12];
1051 	struct neighbor_report *wnm_neighbor_report_elements;
1052 	struct os_reltime wnm_cand_valid_until;
1053 	u8 wnm_cand_from_bss[ETH_ALEN];
1054 #ifdef CONFIG_MBO
1055 	unsigned int wnm_mbo_trans_reason_present:1;
1056 	u8 wnm_mbo_transition_reason;
1057 #endif /* CONFIG_MBO */
1058 #endif /* CONFIG_WNM */
1059 
1060 #ifdef CONFIG_TESTING_GET_GTK
1061 	u8 last_gtk[32];
1062 	size_t last_gtk_len;
1063 #endif /* CONFIG_TESTING_GET_GTK */
1064 
1065 	unsigned int num_multichan_concurrent;
1066 	struct wpa_radio_work *connect_work;
1067 
1068 	unsigned int ext_work_id;
1069 
1070 	struct wpabuf *vendor_elem[NUM_VENDOR_ELEM_FRAMES];
1071 
1072 #ifdef CONFIG_TESTING_OPTIONS
1073 	struct l2_packet_data *l2_test;
1074 	unsigned int extra_roc_dur;
1075 	enum wpa_supplicant_test_failure test_failure;
1076 	char *get_pref_freq_list_override;
1077 	unsigned int reject_btm_req_reason;
1078 	unsigned int p2p_go_csa_on_inv:1;
1079 	unsigned int ignore_auth_resp:1;
1080 	unsigned int ignore_assoc_disallow:1;
1081 	unsigned int testing_resend_assoc:1;
1082 	struct wpabuf *sae_commit_override;
1083 	enum wpa_alg last_tk_alg;
1084 	u8 last_tk_addr[ETH_ALEN];
1085 	int last_tk_key_idx;
1086 	u8 last_tk[WPA_TK_MAX_LEN];
1087 	size_t last_tk_len;
1088 	struct wpabuf *last_assoc_req_wpa_ie;
1089 #endif /* CONFIG_TESTING_OPTIONS */
1090 
1091 	struct wmm_ac_assoc_data *wmm_ac_assoc_info;
1092 	struct wmm_tspec_element *tspecs[WMM_AC_NUM][TS_DIR_IDX_COUNT];
1093 	struct wmm_ac_addts_request *addts_request;
1094 	u8 wmm_ac_last_dialog_token;
1095 	struct wmm_tspec_element *last_tspecs;
1096 	u8 last_tspecs_count;
1097 
1098 	struct rrm_data rrm;
1099 	struct beacon_rep_data beacon_rep_data;
1100 
1101 #ifdef CONFIG_FST
1102 	struct fst_iface *fst;
1103 	const struct wpabuf *fst_ies;
1104 	struct wpabuf *received_mb_ies;
1105 #endif /* CONFIG_FST */
1106 
1107 #ifdef CONFIG_MBO
1108 	/* Multiband operation non-preferred channel */
1109 	struct wpa_mbo_non_pref_channel {
1110 		enum mbo_non_pref_chan_reason reason;
1111 		u8 oper_class;
1112 		u8 chan;
1113 		u8 preference;
1114 	} *non_pref_chan;
1115 	size_t non_pref_chan_num;
1116 	u8 mbo_wnm_token;
1117 	/**
1118 	 * enable_oce - Enable OCE if it is enabled by user and device also
1119 	 *		supports OCE.
1120 	 * User can enable OCE with wpa_config's 'oce' parameter as follows -
1121 	 *  - Set BIT(0) to enable OCE in non-AP STA mode.
1122 	 *  - Set BIT(1) to enable OCE in STA-CFON mode.
1123 	 */
1124 	u8 enable_oce;
1125 #endif /* CONFIG_MBO */
1126 
1127 	/*
1128 	 * This should be under CONFIG_MBO, but it is left out to allow using
1129 	 * the bss_temp_disallowed list for other purposes as well.
1130 	 */
1131 	struct dl_list bss_tmp_disallowed;
1132 
1133 	/*
1134 	 * Content of a measurement report element with type 8 (LCI),
1135 	 * own location.
1136 	 */
1137 	struct wpabuf *lci;
1138 	struct os_reltime lci_time;
1139 
1140 	struct os_reltime beacon_rep_scan;
1141 
1142 	/* FILS HLP requests (struct fils_hlp_req) */
1143 	struct dl_list fils_hlp_req;
1144 
1145 	struct sched_scan_relative_params {
1146 		/**
1147 		 * relative_rssi_set - Enable relatively preferred BSS reporting
1148 		 *
1149 		 * 0 = Disable reporting relatively preferred BSSs
1150 		 * 1 = Enable reporting relatively preferred BSSs
1151 		 */
1152 		int relative_rssi_set;
1153 
1154 		/**
1155 		 * relative_rssi - Relative RSSI for reporting better BSSs
1156 		 *
1157 		 * Amount of RSSI by which a BSS should be better than the
1158 		 * current connected BSS so that the new BSS can be reported
1159 		 * to user space. This applies to sched_scan operations.
1160 		 */
1161 		int relative_rssi;
1162 
1163 		/**
1164 		 * relative_adjust_band - Band in which RSSI is to be adjusted
1165 		 */
1166 		enum set_band relative_adjust_band;
1167 
1168 		/**
1169 		 * relative_adjust_rssi - RSSI adjustment
1170 		 *
1171 		 * An amount of relative_adjust_rssi should be added to the
1172 		 * BSSs that belong to the relative_adjust_band while comparing
1173 		 * with other bands for BSS reporting.
1174 		 */
1175 		int relative_adjust_rssi;
1176 	} srp;
1177 
1178 	/* RIC elements for FT protocol */
1179 	struct wpabuf *ric_ies;
1180 
1181 #ifdef CONFIG_DPP
1182 	struct dl_list dpp_bootstrap; /* struct dpp_bootstrap_info */
1183 	struct dl_list dpp_configurator; /* struct dpp_configurator */
1184 	int dpp_init_done;
1185 	struct dpp_authentication *dpp_auth;
1186 	struct wpa_radio_work *dpp_listen_work;
1187 	unsigned int dpp_pending_listen_freq;
1188 	unsigned int dpp_listen_freq;
1189 	u8 dpp_allowed_roles;
1190 	int dpp_qr_mutual;
1191 	int dpp_netrole_ap;
1192 	int dpp_auth_ok_on_ack;
1193 	int dpp_gas_client;
1194 	u8 dpp_intro_bssid[ETH_ALEN];
1195 	void *dpp_intro_network;
1196 	struct dpp_pkex *dpp_pkex;
1197 	struct dpp_bootstrap_info *dpp_pkex_bi;
1198 	char *dpp_pkex_code;
1199 	char *dpp_pkex_identifier;
1200 	char *dpp_pkex_auth_cmd;
1201 	char *dpp_configurator_params;
1202 #ifdef CONFIG_TESTING_OPTIONS
1203 	char *dpp_config_obj_override;
1204 	char *dpp_discovery_override;
1205 	char *dpp_groups_override;
1206 	unsigned int dpp_ignore_netaccesskey_mismatch:1;
1207 #endif /* CONFIG_TESTING_OPTIONS */
1208 #endif /* CONFIG_DPP */
1209 };
1210 
1211 
1212 /* wpa_supplicant.c */
1213 void wpa_supplicant_apply_ht_overrides(
1214 	struct wpa_supplicant *wpa_s, struct wpa_ssid *ssid,
1215 	struct wpa_driver_associate_params *params);
1216 void wpa_supplicant_apply_vht_overrides(
1217 	struct wpa_supplicant *wpa_s, struct wpa_ssid *ssid,
1218 	struct wpa_driver_associate_params *params);
1219 
1220 int wpa_set_wep_keys(struct wpa_supplicant *wpa_s, struct wpa_ssid *ssid);
1221 int wpa_supplicant_set_wpa_none_key(struct wpa_supplicant *wpa_s,
1222 				    struct wpa_ssid *ssid);
1223 
1224 int wpa_supplicant_reload_configuration(struct wpa_supplicant *wpa_s);
1225 
1226 const char * wpa_supplicant_state_txt(enum wpa_states state);
1227 int wpa_supplicant_update_mac_addr(struct wpa_supplicant *wpa_s);
1228 int wpa_supplicant_driver_init(struct wpa_supplicant *wpa_s);
1229 int wpa_supplicant_set_suites(struct wpa_supplicant *wpa_s,
1230 			      struct wpa_bss *bss, struct wpa_ssid *ssid,
1231 			      u8 *wpa_ie, size_t *wpa_ie_len);
1232 void wpa_supplicant_associate(struct wpa_supplicant *wpa_s,
1233 			      struct wpa_bss *bss,
1234 			      struct wpa_ssid *ssid);
1235 void wpa_supplicant_set_non_wpa_policy(struct wpa_supplicant *wpa_s,
1236 				       struct wpa_ssid *ssid);
1237 void wpa_supplicant_initiate_eapol(struct wpa_supplicant *wpa_s);
1238 void wpa_clear_keys(struct wpa_supplicant *wpa_s, const u8 *addr);
1239 void wpa_supplicant_req_auth_timeout(struct wpa_supplicant *wpa_s,
1240 				     int sec, int usec);
1241 void wpa_supplicant_reinit_autoscan(struct wpa_supplicant *wpa_s);
1242 void wpa_supplicant_set_state(struct wpa_supplicant *wpa_s,
1243 			      enum wpa_states state);
1244 struct wpa_ssid * wpa_supplicant_get_ssid(struct wpa_supplicant *wpa_s);
1245 const char * wpa_supplicant_get_eap_mode(struct wpa_supplicant *wpa_s);
1246 void wpa_supplicant_cancel_auth_timeout(struct wpa_supplicant *wpa_s);
1247 void wpa_supplicant_deauthenticate(struct wpa_supplicant *wpa_s,
1248 				   int reason_code);
1249 
1250 struct wpa_ssid * wpa_supplicant_add_network(struct wpa_supplicant *wpa_s);
1251 int wpa_supplicant_remove_network(struct wpa_supplicant *wpa_s, int id);
1252 void wpa_supplicant_enable_network(struct wpa_supplicant *wpa_s,
1253 				   struct wpa_ssid *ssid);
1254 void wpa_supplicant_disable_network(struct wpa_supplicant *wpa_s,
1255 				    struct wpa_ssid *ssid);
1256 void wpa_supplicant_select_network(struct wpa_supplicant *wpa_s,
1257 				   struct wpa_ssid *ssid);
1258 int wpas_set_pkcs11_engine_and_module_path(struct wpa_supplicant *wpa_s,
1259 					   const char *pkcs11_engine_path,
1260 					   const char *pkcs11_module_path);
1261 int wpa_supplicant_set_ap_scan(struct wpa_supplicant *wpa_s,
1262 			       int ap_scan);
1263 int wpa_supplicant_set_bss_expiration_age(struct wpa_supplicant *wpa_s,
1264 					  unsigned int expire_age);
1265 int wpa_supplicant_set_bss_expiration_count(struct wpa_supplicant *wpa_s,
1266 					    unsigned int expire_count);
1267 int wpa_supplicant_set_scan_interval(struct wpa_supplicant *wpa_s,
1268 				     int scan_interval);
1269 int wpa_supplicant_set_debug_params(struct wpa_global *global,
1270 				    int debug_level, int debug_timestamp,
1271 				    int debug_show_keys);
1272 void free_hw_features(struct wpa_supplicant *wpa_s);
1273 
1274 void wpa_show_license(void);
1275 
1276 struct wpa_interface * wpa_supplicant_match_iface(struct wpa_global *global,
1277 						  const char *ifname);
1278 struct wpa_supplicant * wpa_supplicant_add_iface(struct wpa_global *global,
1279 						 struct wpa_interface *iface,
1280 						 struct wpa_supplicant *parent);
1281 int wpa_supplicant_remove_iface(struct wpa_global *global,
1282 				struct wpa_supplicant *wpa_s,
1283 				int terminate);
1284 struct wpa_supplicant * wpa_supplicant_get_iface(struct wpa_global *global,
1285 						 const char *ifname);
1286 struct wpa_global * wpa_supplicant_init(struct wpa_params *params);
1287 int wpa_supplicant_run(struct wpa_global *global);
1288 void wpa_supplicant_deinit(struct wpa_global *global);
1289 
1290 int wpa_supplicant_scard_init(struct wpa_supplicant *wpa_s,
1291 			      struct wpa_ssid *ssid);
1292 void wpa_supplicant_terminate_proc(struct wpa_global *global);
1293 void wpa_supplicant_rx_eapol(void *ctx, const u8 *src_addr,
1294 			     const u8 *buf, size_t len);
1295 void wpa_supplicant_update_config(struct wpa_supplicant *wpa_s);
1296 void wpa_supplicant_clear_status(struct wpa_supplicant *wpa_s);
1297 void wpas_connection_failed(struct wpa_supplicant *wpa_s, const u8 *bssid);
1298 int wpas_driver_bss_selection(struct wpa_supplicant *wpa_s);
1299 int wpas_is_p2p_prioritized(struct wpa_supplicant *wpa_s);
1300 void wpas_auth_failed(struct wpa_supplicant *wpa_s, char *reason);
1301 void wpas_clear_temp_disabled(struct wpa_supplicant *wpa_s,
1302 			      struct wpa_ssid *ssid, int clear_failures);
1303 int disallowed_bssid(struct wpa_supplicant *wpa_s, const u8 *bssid);
1304 int disallowed_ssid(struct wpa_supplicant *wpa_s, const u8 *ssid,
1305 		    size_t ssid_len);
1306 void wpas_request_connection(struct wpa_supplicant *wpa_s);
1307 void wpas_request_disconnection(struct wpa_supplicant *wpa_s);
1308 int wpas_build_ext_capab(struct wpa_supplicant *wpa_s, u8 *buf, size_t buflen);
1309 int wpas_update_random_addr(struct wpa_supplicant *wpa_s, int style);
1310 int wpas_update_random_addr_disassoc(struct wpa_supplicant *wpa_s);
1311 void add_freq(int *freqs, int *num_freqs, int freq);
1312 
1313 void wpas_rrm_reset(struct wpa_supplicant *wpa_s);
1314 void wpas_rrm_process_neighbor_rep(struct wpa_supplicant *wpa_s,
1315 				   const u8 *report, size_t report_len);
1316 int wpas_rrm_send_neighbor_rep_request(struct wpa_supplicant *wpa_s,
1317 				       const struct wpa_ssid_value *ssid,
1318 				       int lci, int civic,
1319 				       void (*cb)(void *ctx,
1320 						  struct wpabuf *neighbor_rep),
1321 				       void *cb_ctx);
1322 void wpas_rrm_handle_radio_measurement_request(struct wpa_supplicant *wpa_s,
1323 					       const u8 *src, const u8 *dst,
1324 					       const u8 *frame, size_t len);
1325 void wpas_rrm_handle_link_measurement_request(struct wpa_supplicant *wpa_s,
1326 					      const u8 *src,
1327 					      const u8 *frame, size_t len,
1328 					      int rssi);
1329 void wpas_rrm_refuse_request(struct wpa_supplicant *wpa_s);
1330 int wpas_beacon_rep_scan_process(struct wpa_supplicant *wpa_s,
1331 				 struct wpa_scan_results *scan_res,
1332 				 struct scan_info *info);
1333 void wpas_clear_beacon_rep_data(struct wpa_supplicant *wpa_s);
1334 void wpas_flush_fils_hlp_req(struct wpa_supplicant *wpa_s);
1335 
1336 
1337 /* MBO functions */
1338 int wpas_mbo_ie(struct wpa_supplicant *wpa_s, u8 *buf, size_t len);
1339 const u8 * wpas_mbo_get_bss_attr(struct wpa_bss *bss, enum mbo_attr_id attr);
1340 int wpas_mbo_update_non_pref_chan(struct wpa_supplicant *wpa_s,
1341 				  const char *non_pref_chan);
1342 void wpas_mbo_scan_ie(struct wpa_supplicant *wpa_s, struct wpabuf *ie);
1343 void wpas_mbo_ie_trans_req(struct wpa_supplicant *wpa_s, const u8 *ie,
1344 			   size_t len);
1345 size_t wpas_mbo_ie_bss_trans_reject(struct wpa_supplicant *wpa_s, u8 *pos,
1346 				    size_t len,
1347 				    enum mbo_transition_reject_reason reason);
1348 void wpas_mbo_update_cell_capa(struct wpa_supplicant *wpa_s, u8 mbo_cell_capa);
1349 struct wpabuf * mbo_build_anqp_buf(struct wpa_supplicant *wpa_s,
1350 				   struct wpa_bss *bss, u32 mbo_subtypes);
1351 void mbo_parse_rx_anqp_resp(struct wpa_supplicant *wpa_s,
1352 			    struct wpa_bss *bss, const u8 *sa,
1353 			    const u8 *data, size_t slen);
1354 
1355 /* op_classes.c */
1356 enum chan_allowed {
1357 	NOT_ALLOWED, NO_IR, ALLOWED
1358 };
1359 
1360 enum chan_allowed verify_channel(struct hostapd_hw_modes *mode, u8 channel,
1361 				 u8 bw);
1362 size_t wpas_supp_op_class_ie(struct wpa_supplicant *wpa_s, int freq, u8 *pos,
1363 			      size_t len);
1364 
1365 /**
1366  * wpa_supplicant_ctrl_iface_ctrl_rsp_handle - Handle a control response
1367  * @wpa_s: Pointer to wpa_supplicant data
1368  * @ssid: Pointer to the network block the reply is for
1369  * @field: field the response is a reply for
1370  * @value: value (ie, password, etc) for @field
1371  * Returns: 0 on success, non-zero on error
1372  *
1373  * Helper function to handle replies to control interface requests.
1374  */
1375 int wpa_supplicant_ctrl_iface_ctrl_rsp_handle(struct wpa_supplicant *wpa_s,
1376 					      struct wpa_ssid *ssid,
1377 					      const char *field,
1378 					      const char *value);
1379 /**
1380  * wpa_supplicant_ctrl_rsp_handle - Handle a control response
1381  * @wpa_s: Pointer to wpa_supplicant data
1382  * @ssid: Pointer to the network block the reply is for
1383  * @field: field the response is a reply for
1384  * @value: value (ie, password, etc) for @field
1385  * Returns: 0 on success, non-zero on error
1386  *
1387  * Helper function to handle replies to control interface requests.
1388  */
1389 int wpa_supplicant_ctrl_rsp_handle(struct wpa_supplicant *wpa_s,
1390 				   struct wpa_ssid *ssid,
1391 				   enum wpa_ctrl_req_type rtype,
1392 				   const char *value, int len);
1393 
1394 void ibss_mesh_setup_freq(struct wpa_supplicant *wpa_s,
1395 			  const struct wpa_ssid *ssid,
1396 			  struct hostapd_freq_params *freq);
1397 
1398 /* events.c */
1399 void wpa_supplicant_mark_disassoc(struct wpa_supplicant *wpa_s);
1400 int wpa_supplicant_connect(struct wpa_supplicant *wpa_s,
1401 			   struct wpa_bss *selected,
1402 			   struct wpa_ssid *ssid);
1403 void wpa_supplicant_stop_countermeasures(void *eloop_ctx, void *sock_ctx);
1404 void wpa_supplicant_delayed_mic_error_report(void *eloop_ctx, void *sock_ctx);
1405 void wnm_bss_keep_alive_deinit(struct wpa_supplicant *wpa_s);
1406 int wpa_supplicant_fast_associate(struct wpa_supplicant *wpa_s);
1407 struct wpa_bss * wpa_supplicant_pick_network(struct wpa_supplicant *wpa_s,
1408 					     struct wpa_ssid **selected_ssid);
1409 int wpas_temp_disabled(struct wpa_supplicant *wpa_s, struct wpa_ssid *ssid);
1410 
1411 /* eap_register.c */
1412 int eap_register_methods(void);
1413 
1414 /**
1415  * Utility method to tell if a given network is for persistent group storage
1416  * @ssid: Network object
1417  * Returns: 1 if network is a persistent group, 0 otherwise
1418  */
network_is_persistent_group(struct wpa_ssid * ssid)1419 static inline int network_is_persistent_group(struct wpa_ssid *ssid)
1420 {
1421 	return ssid->disabled == 2 && ssid->p2p_persistent_group;
1422 }
1423 
1424 int wpas_network_disabled(struct wpa_supplicant *wpa_s, struct wpa_ssid *ssid);
1425 int wpas_get_ssid_pmf(struct wpa_supplicant *wpa_s, struct wpa_ssid *ssid);
1426 
1427 int wpas_init_ext_pw(struct wpa_supplicant *wpa_s);
1428 
1429 void dump_freq_data(struct wpa_supplicant *wpa_s, const char *title,
1430 		    struct wpa_used_freq_data *freqs_data,
1431 		    unsigned int len);
1432 
1433 int get_shared_radio_freqs_data(struct wpa_supplicant *wpa_s,
1434 				struct wpa_used_freq_data *freqs_data,
1435 				unsigned int len);
1436 int get_shared_radio_freqs(struct wpa_supplicant *wpa_s,
1437 			   int *freq_array, unsigned int len);
1438 
1439 void wpas_network_reenabled(void *eloop_ctx, void *timeout_ctx);
1440 
1441 void wpas_vendor_elem_update(struct wpa_supplicant *wpa_s);
1442 struct wpa_supplicant * wpas_vendor_elem(struct wpa_supplicant *wpa_s,
1443 					 enum wpa_vendor_elem_frame frame);
1444 int wpas_vendor_elem_remove(struct wpa_supplicant *wpa_s, int frame,
1445 			    const u8 *elem, size_t len);
1446 
1447 #ifdef CONFIG_FST
1448 
1449 struct fst_wpa_obj;
1450 
1451 void fst_wpa_supplicant_fill_iface_obj(struct wpa_supplicant *wpa_s,
1452 				       struct fst_wpa_obj *iface_obj);
1453 
1454 #endif /* CONFIG_FST */
1455 
1456 int wpas_sched_scan_plans_set(struct wpa_supplicant *wpa_s, const char *cmd);
1457 
1458 struct hostapd_hw_modes * get_mode(struct hostapd_hw_modes *modes,
1459 				   u16 num_modes, enum hostapd_hw_mode mode);
1460 
1461 void wpa_bss_tmp_disallow(struct wpa_supplicant *wpa_s, const u8 *bssid,
1462 			  unsigned int sec);
1463 int wpa_is_bss_tmp_disallowed(struct wpa_supplicant *wpa_s, const u8 *bssid);
1464 
1465 struct wpa_ssid * wpa_scan_res_match(struct wpa_supplicant *wpa_s,
1466 				     int i, struct wpa_bss *bss,
1467 				     struct wpa_ssid *group,
1468 				     int only_first_ssid, int debug_print);
1469 
1470 int wpas_ctrl_iface_get_pref_freq_list_override(struct wpa_supplicant *wpa_s,
1471 						enum wpa_driver_if_type if_type,
1472 						unsigned int *num,
1473 						unsigned int *freq_list);
1474 
1475 #endif /* WPA_SUPPLICANT_I_H */
1476