• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 10
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 
433 enum wpa_supplicant_test_failure {
434 	WPAS_TEST_FAILURE_NONE,
435 	WPAS_TEST_FAILURE_SCAN_TRIGGER,
436 };
437 
438 struct icon_entry {
439 	struct dl_list list;
440 	u8 bssid[ETH_ALEN];
441 	u8 dialog_token;
442 	char *file_name;
443 	u8 *image;
444 	size_t image_len;
445 };
446 
447 struct wpa_bss_tmp_disallowed {
448 	struct dl_list list;
449 	u8 bssid[ETH_ALEN];
450 	struct os_reltime disallowed_until;
451 };
452 
453 struct beacon_rep_data {
454 	u8 token;
455 	struct wpa_driver_scan_params scan_params;
456 	u8 ssid[SSID_MAX_LEN];
457 	size_t ssid_len;
458 	u8 bssid[ETH_ALEN];
459 	enum beacon_report_detail report_detail;
460 	struct bitfield *eids;
461 };
462 
463 
464 struct external_pmksa_cache {
465 	struct dl_list list;
466 	void *pmksa_cache;
467 };
468 
469 struct fils_hlp_req {
470 	struct dl_list list;
471 	u8 dst[ETH_ALEN];
472 	struct wpabuf *pkt;
473 };
474 
475 /**
476  * struct wpa_supplicant - Internal data for wpa_supplicant interface
477  *
478  * This structure contains the internal data for core wpa_supplicant code. This
479  * should be only used directly from the core code. However, a pointer to this
480  * data is used from other files as an arbitrary context pointer in calls to
481  * core functions.
482  */
483 struct wpa_supplicant {
484 	struct wpa_global *global;
485 	struct wpa_radio *radio; /* shared radio context */
486 	struct dl_list radio_list; /* list head: struct wpa_radio::ifaces */
487 	struct wpa_supplicant *parent;
488 	struct wpa_supplicant *p2pdev;
489 	struct wpa_supplicant *next;
490 	struct l2_packet_data *l2;
491 	struct l2_packet_data *l2_br;
492 	unsigned char own_addr[ETH_ALEN];
493 	unsigned char perm_addr[ETH_ALEN];
494 	char ifname[100];
495 #ifdef CONFIG_MATCH_IFACE
496 	int matched;
497 #endif /* CONFIG_MATCH_IFACE */
498 #ifdef CONFIG_CTRL_IFACE_DBUS
499 	char *dbus_path;
500 #endif /* CONFIG_CTRL_IFACE_DBUS */
501 #ifdef CONFIG_CTRL_IFACE_DBUS_NEW
502 	char *dbus_new_path;
503 	char *dbus_groupobj_path;
504 #ifdef CONFIG_AP
505 	char *preq_notify_peer;
506 #endif /* CONFIG_AP */
507 #endif /* CONFIG_CTRL_IFACE_DBUS_NEW */
508 #ifdef CONFIG_CTRL_IFACE_HIDL
509 	const void *hidl_object_key;
510 #endif /* CONFIG_CTRL_IFACE_HIDL */
511 	char bridge_ifname[16];
512 
513 	char *confname;
514 	char *confanother;
515 
516 	struct wpa_config *conf;
517 	int countermeasures;
518 	struct os_reltime last_michael_mic_error;
519 	u8 bssid[ETH_ALEN];
520 	u8 pending_bssid[ETH_ALEN]; /* If wpa_state == WPA_ASSOCIATING, this
521 				     * field contains the target BSSID. */
522 	int reassociate; /* reassociation requested */
523 	unsigned int reassoc_same_bss:1; /* reassociating to the same BSS */
524 	unsigned int reassoc_same_ess:1; /* reassociating to the same ESS */
525 	int disconnected; /* all connections disabled; i.e., do no reassociate
526 			   * before this has been cleared */
527 	struct wpa_ssid *current_ssid;
528 	struct wpa_ssid *last_ssid;
529 	struct wpa_bss *current_bss;
530 	int ap_ies_from_associnfo;
531 	unsigned int assoc_freq;
532 
533 	/* Selected configuration (based on Beacon/ProbeResp WPA IE) */
534 	int pairwise_cipher;
535 	int group_cipher;
536 	int key_mgmt;
537 	int wpa_proto;
538 	int mgmt_group_cipher;
539 
540 	void *drv_priv; /* private data used by driver_ops */
541 	void *global_drv_priv;
542 
543 	u8 *bssid_filter;
544 	size_t bssid_filter_count;
545 
546 	u8 *disallow_aps_bssid;
547 	size_t disallow_aps_bssid_count;
548 	struct wpa_ssid_value *disallow_aps_ssid;
549 	size_t disallow_aps_ssid_count;
550 
551 	enum set_band setband;
552 
553 	/* Preferred network for the next connection attempt */
554 	struct wpa_ssid *next_ssid;
555 
556 	/* previous scan was wildcard when interleaving between
557 	 * wildcard scans and specific SSID scan when max_ssids=1 */
558 	int prev_scan_wildcard;
559 	struct wpa_ssid *prev_scan_ssid; /* previously scanned SSID;
560 					  * NULL = not yet initialized (start
561 					  * with wildcard SSID)
562 					  * WILDCARD_SSID_SCAN = wildcard
563 					  * SSID was used in the previous scan
564 					  */
565 #define WILDCARD_SSID_SCAN ((struct wpa_ssid *) 1)
566 
567 	struct wpa_ssid *prev_sched_ssid; /* last SSID used in sched scan */
568 	int sched_scan_timeout;
569 	int first_sched_scan;
570 	int sched_scan_timed_out;
571 	struct sched_scan_plan *sched_scan_plans;
572 	size_t sched_scan_plans_num;
573 
574 	void (*scan_res_handler)(struct wpa_supplicant *wpa_s,
575 				 struct wpa_scan_results *scan_res);
576 	struct dl_list bss; /* struct wpa_bss::list */
577 	struct dl_list bss_id; /* struct wpa_bss::list_id */
578 	size_t num_bss;
579 	unsigned int bss_update_idx;
580 	unsigned int bss_next_id;
581 
582 	 /*
583 	  * Pointers to BSS entries in the order they were in the last scan
584 	  * results.
585 	  */
586 	struct wpa_bss **last_scan_res;
587 	unsigned int last_scan_res_used;
588 	unsigned int last_scan_res_size;
589 	struct os_reltime last_scan;
590 
591 	const struct wpa_driver_ops *driver;
592 	int interface_removed; /* whether the network interface has been
593 				* removed */
594 	struct wpa_sm *wpa;
595 	struct eapol_sm *eapol;
596 
597 	struct ctrl_iface_priv *ctrl_iface;
598 
599 	enum wpa_states wpa_state;
600 	struct wpa_radio_work *scan_work;
601 	int scanning;
602 	int sched_scanning;
603 	unsigned int sched_scan_stop_req:1;
604 	int new_connection;
605 
606 	int eapol_received; /* number of EAPOL packets received after the
607 			     * previous association event */
608 
609 	struct scard_data *scard;
610 	char imsi[20];
611 	int mnc_len;
612 
613 	unsigned char last_eapol_src[ETH_ALEN];
614 
615 	unsigned int keys_cleared; /* bitfield of key indexes that the driver is
616 				    * known not to be configured with a key */
617 
618 	struct wpa_blacklist *blacklist;
619 
620 	/**
621 	 * extra_blacklist_count - Sum of blacklist counts after last connection
622 	 *
623 	 * This variable is used to maintain a count of temporary blacklisting
624 	 * failures (maximum number for any BSS) over blacklist clear
625 	 * operations. This is needed for figuring out whether there has been
626 	 * failures prior to the last blacklist clear operation which happens
627 	 * whenever no other not-blacklisted BSS candidates are available. This
628 	 * gets cleared whenever a connection has been established successfully.
629 	 */
630 	int extra_blacklist_count;
631 
632 	/**
633 	 * scan_req - Type of the scan request
634 	 */
635 	enum scan_req_type {
636 		/**
637 		 * NORMAL_SCAN_REQ - Normal scan request
638 		 *
639 		 * This is used for scans initiated by wpa_supplicant to find an
640 		 * AP for a connection.
641 		 */
642 		NORMAL_SCAN_REQ,
643 
644 		/**
645 		 * INITIAL_SCAN_REQ - Initial scan request
646 		 *
647 		 * This is used for the first scan on an interface to force at
648 		 * least one scan to be run even if the configuration does not
649 		 * include any enabled networks.
650 		 */
651 		INITIAL_SCAN_REQ,
652 
653 		/**
654 		 * MANUAL_SCAN_REQ - Manual scan request
655 		 *
656 		 * This is used for scans where the user request a scan or
657 		 * a specific wpa_supplicant operation (e.g., WPS) requires scan
658 		 * to be run.
659 		 */
660 		MANUAL_SCAN_REQ
661 	} scan_req, last_scan_req;
662 	enum wpa_states scan_prev_wpa_state;
663 	struct os_reltime scan_trigger_time, scan_start_time;
664 	/* Minimum freshness requirement for connection purposes */
665 	struct os_reltime scan_min_time;
666 	int scan_runs; /* number of scan runs since WPS was started */
667 	int *next_scan_freqs;
668 	int *manual_scan_freqs;
669 	int *manual_sched_scan_freqs;
670 	unsigned int manual_scan_passive:1;
671 	unsigned int manual_scan_use_id:1;
672 	unsigned int manual_scan_only_new:1;
673 	unsigned int own_scan_requested:1;
674 	unsigned int own_scan_running:1;
675 	unsigned int clear_driver_scan_cache:1;
676 	unsigned int manual_scan_id;
677 	int scan_interval; /* time in sec between scans to find suitable AP */
678 	int normal_scans; /* normal scans run before sched_scan */
679 	int scan_for_connection; /* whether the scan request was triggered for
680 				  * finding a connection */
681 	/*
682 	 * A unique cookie representing the vendor scan request. This cookie is
683 	 * returned from the driver interface. 0 indicates that there is no
684 	 * pending vendor scan request.
685 	 */
686 	u64 curr_scan_cookie;
687 #define MAX_SCAN_ID 16
688 	int scan_id[MAX_SCAN_ID];
689 	unsigned int scan_id_count;
690 	u8 next_scan_bssid[ETH_ALEN];
691 
692 	struct wpa_ssid_value *ssids_from_scan_req;
693 	unsigned int num_ssids_from_scan_req;
694 
695 	u64 drv_flags;
696 	unsigned int drv_enc;
697 	unsigned int drv_smps_modes;
698 	unsigned int drv_rrm_flags;
699 
700 	/*
701 	 * A bitmap of supported protocols for probe response offload. See
702 	 * struct wpa_driver_capa in driver.h
703 	 */
704 	unsigned int probe_resp_offloads;
705 
706 	/* extended capabilities supported by the driver */
707 	const u8 *extended_capa, *extended_capa_mask;
708 	unsigned int extended_capa_len;
709 
710 	int max_scan_ssids;
711 	int max_sched_scan_ssids;
712 	unsigned int max_sched_scan_plans;
713 	unsigned int max_sched_scan_plan_interval;
714 	unsigned int max_sched_scan_plan_iterations;
715 	int sched_scan_supported;
716 	unsigned int max_match_sets;
717 	unsigned int max_remain_on_chan;
718 	unsigned int max_stations;
719 
720 	int pending_mic_error_report;
721 	int pending_mic_error_pairwise;
722 	int mic_errors_seen; /* Michael MIC errors with the current PTK */
723 
724 	struct wps_context *wps;
725 	int wps_success; /* WPS success event received */
726 	struct wps_er *wps_er;
727 	unsigned int wps_run;
728 	struct os_reltime wps_pin_start_time;
729 	int blacklist_cleared;
730 
731 	struct wpabuf *pending_eapol_rx;
732 	struct os_reltime pending_eapol_rx_time;
733 	u8 pending_eapol_rx_src[ETH_ALEN];
734 	unsigned int last_eapol_matches_bssid:1;
735 	unsigned int eap_expected_failure:1;
736 	unsigned int reattach:1; /* reassociation to the same BSS requested */
737 	unsigned int mac_addr_changed:1;
738 	unsigned int added_vif:1;
739 	unsigned int wnmsleep_used:1;
740 
741 	struct os_reltime last_mac_addr_change;
742 	int last_mac_addr_style;
743 
744 	struct ibss_rsn *ibss_rsn;
745 
746 	int set_sta_uapsd;
747 	int sta_uapsd;
748 	int set_ap_uapsd;
749 	int ap_uapsd;
750 
751 #ifdef CONFIG_SME
752 	struct {
753 		u8 ssid[SSID_MAX_LEN];
754 		size_t ssid_len;
755 		int freq;
756 		u8 assoc_req_ie[1500];
757 		size_t assoc_req_ie_len;
758 		int mfp;
759 		int ft_used;
760 		u8 mobility_domain[2];
761 		u8 *ft_ies;
762 		size_t ft_ies_len;
763 		u8 prev_bssid[ETH_ALEN];
764 		int prev_bssid_set;
765 		int auth_alg;
766 		int proto;
767 
768 		int sa_query_count; /* number of pending SA Query requests;
769 				     * 0 = no SA Query in progress */
770 		int sa_query_timed_out;
771 		u8 *sa_query_trans_id; /* buffer of WLAN_SA_QUERY_TR_ID_LEN *
772 					* sa_query_count octets of pending
773 					* SA Query transaction identifiers */
774 		struct os_reltime sa_query_start;
775 		struct os_reltime last_unprot_disconnect;
776 		enum { HT_SEC_CHAN_UNKNOWN,
777 		       HT_SEC_CHAN_ABOVE,
778 		       HT_SEC_CHAN_BELOW } ht_sec_chan;
779 		u8 sched_obss_scan;
780 		u16 obss_scan_int;
781 		u16 bss_max_idle_period;
782 #ifdef CONFIG_SAE
783 		struct sae_data sae;
784 		struct wpabuf *sae_token;
785 		int sae_group_index;
786 		unsigned int sae_pmksa_caching:1;
787 #endif /* CONFIG_SAE */
788 	} sme;
789 #endif /* CONFIG_SME */
790 
791 #ifdef CONFIG_AP
792 	struct hostapd_iface *ap_iface;
793 	void (*ap_configured_cb)(void *ctx, void *data);
794 	void *ap_configured_cb_ctx;
795 	void *ap_configured_cb_data;
796 #endif /* CONFIG_AP */
797 
798 	struct hostapd_iface *ifmsh;
799 #ifdef CONFIG_MESH
800 	struct mesh_rsn *mesh_rsn;
801 	int mesh_if_idx;
802 	unsigned int mesh_if_created:1;
803 	unsigned int mesh_ht_enabled:1;
804 	unsigned int mesh_vht_enabled:1;
805 #ifdef CONFIG_PMKSA_CACHE_EXTERNAL
806 	/* struct external_pmksa_cache::list */
807 	struct dl_list mesh_external_pmksa_cache;
808 #endif /* CONFIG_PMKSA_CACHE_EXTERNAL */
809 #endif /* CONFIG_MESH */
810 
811 	unsigned int off_channel_freq;
812 	struct wpabuf *pending_action_tx;
813 	u8 pending_action_src[ETH_ALEN];
814 	u8 pending_action_dst[ETH_ALEN];
815 	u8 pending_action_bssid[ETH_ALEN];
816 	unsigned int pending_action_freq;
817 	int pending_action_no_cck;
818 	int pending_action_without_roc;
819 	unsigned int pending_action_tx_done:1;
820 	void (*pending_action_tx_status_cb)(struct wpa_supplicant *wpa_s,
821 					    unsigned int freq, const u8 *dst,
822 					    const u8 *src, const u8 *bssid,
823 					    const u8 *data, size_t data_len,
824 					    enum offchannel_send_action_result
825 					    result);
826 	unsigned int roc_waiting_drv_freq;
827 	int action_tx_wait_time;
828 
829 	int p2p_mgmt;
830 
831 #ifdef CONFIG_P2P
832 	struct p2p_go_neg_results *go_params;
833 	int create_p2p_iface;
834 	u8 pending_interface_addr[ETH_ALEN];
835 	char pending_interface_name[100];
836 	int pending_interface_type;
837 	int p2p_group_idx;
838 	unsigned int pending_listen_freq;
839 	unsigned int pending_listen_duration;
840 	enum {
841 		NOT_P2P_GROUP_INTERFACE,
842 		P2P_GROUP_INTERFACE_PENDING,
843 		P2P_GROUP_INTERFACE_GO,
844 		P2P_GROUP_INTERFACE_CLIENT
845 	} p2p_group_interface;
846 	struct p2p_group *p2p_group;
847 	int p2p_long_listen; /* remaining time in long Listen state in ms */
848 	char p2p_pin[10];
849 	int p2p_wps_method;
850 	u8 p2p_auth_invite[ETH_ALEN];
851 	int p2p_sd_over_ctrl_iface;
852 	int p2p_in_provisioning;
853 	int p2p_in_invitation;
854 	int p2p_invite_go_freq;
855 	int pending_invite_ssid_id;
856 	int show_group_started;
857 	u8 go_dev_addr[ETH_ALEN];
858 	int pending_pd_before_join;
859 	u8 pending_join_iface_addr[ETH_ALEN];
860 	u8 pending_join_dev_addr[ETH_ALEN];
861 	int pending_join_wps_method;
862 	u8 p2p_join_ssid[SSID_MAX_LEN];
863 	size_t p2p_join_ssid_len;
864 	int p2p_join_scan_count;
865 	int auto_pd_scan_retry;
866 	int force_long_sd;
867 	u16 pending_pd_config_methods;
868 	enum {
869 		NORMAL_PD, AUTO_PD_GO_NEG, AUTO_PD_JOIN, AUTO_PD_ASP
870 	} pending_pd_use;
871 
872 	/*
873 	 * Whether cross connection is disallowed by the AP to which this
874 	 * interface is associated (only valid if there is an association).
875 	 */
876 	int cross_connect_disallowed;
877 
878 	/*
879 	 * Whether this P2P group is configured to use cross connection (only
880 	 * valid if this is P2P GO interface). The actual cross connect packet
881 	 * forwarding may not be configured depending on the uplink status.
882 	 */
883 	int cross_connect_enabled;
884 
885 	/* Whether cross connection forwarding is in use at the moment. */
886 	int cross_connect_in_use;
887 
888 	/*
889 	 * Uplink interface name for cross connection
890 	 */
891 	char cross_connect_uplink[100];
892 
893 	unsigned int p2p_auto_join:1;
894 	unsigned int p2p_auto_pd:1;
895 	unsigned int p2p_persistent_group:1;
896 	unsigned int p2p_fallback_to_go_neg:1;
897 	unsigned int p2p_pd_before_go_neg:1;
898 	unsigned int p2p_go_ht40:1;
899 	unsigned int p2p_go_vht:1;
900 	unsigned int user_initiated_pd:1;
901 	unsigned int p2p_go_group_formation_completed:1;
902 	unsigned int group_formation_reported:1;
903 	unsigned int waiting_presence_resp;
904 	int p2p_first_connection_timeout;
905 	unsigned int p2p_nfc_tag_enabled:1;
906 	unsigned int p2p_peer_oob_pk_hash_known:1;
907 	unsigned int p2p_disable_ip_addr_req:1;
908 	unsigned int p2ps_method_config_any:1;
909 	unsigned int p2p_cli_probe:1;
910 	int p2p_persistent_go_freq;
911 	int p2p_persistent_id;
912 	int p2p_go_intent;
913 	int p2p_connect_freq;
914 	struct os_reltime p2p_auto_started;
915 	struct wpa_ssid *p2p_last_4way_hs_fail;
916 	struct wpa_radio_work *p2p_scan_work;
917 	struct wpa_radio_work *p2p_listen_work;
918 	struct wpa_radio_work *p2p_send_action_work;
919 
920 	u16 p2p_oob_dev_pw_id; /* OOB Device Password Id for group formation */
921 	struct wpabuf *p2p_oob_dev_pw; /* OOB Device Password for group
922 					* formation */
923 	u8 p2p_peer_oob_pubkey_hash[WPS_OOB_PUBKEY_HASH_LEN];
924 	u8 p2p_ip_addr_info[3 * 4];
925 
926 	/* group common frequencies */
927 	int *p2p_group_common_freqs;
928 	unsigned int p2p_group_common_freqs_num;
929 	u8 p2ps_join_addr[ETH_ALEN];
930 
931 	unsigned int p2p_go_max_oper_chwidth;
932 	unsigned int p2p_go_vht_center_freq2;
933 	int p2p_lo_started;
934 #endif /* CONFIG_P2P */
935 
936 	struct wpa_ssid *bgscan_ssid;
937 	const struct bgscan_ops *bgscan;
938 	void *bgscan_priv;
939 
940 	const struct autoscan_ops *autoscan;
941 	struct wpa_driver_scan_params *autoscan_params;
942 	void *autoscan_priv;
943 
944 	struct wpa_ssid *connect_without_scan;
945 
946 	struct wps_ap_info *wps_ap;
947 	size_t num_wps_ap;
948 	int wps_ap_iter;
949 
950 	int after_wps;
951 	int known_wps_freq;
952 	unsigned int wps_freq;
953 	int wps_fragment_size;
954 	int auto_reconnect_disabled;
955 
956 	 /* Channel preferences for AP/P2P GO use */
957 	int best_24_freq;
958 	int best_5_freq;
959 	int best_overall_freq;
960 
961 	struct gas_query *gas;
962 
963 #ifdef CONFIG_INTERWORKING
964 	unsigned int fetch_anqp_in_progress:1;
965 	unsigned int network_select:1;
966 	unsigned int auto_select:1;
967 	unsigned int auto_network_select:1;
968 	unsigned int interworking_fast_assoc_tried:1;
969 	unsigned int fetch_all_anqp:1;
970 	unsigned int fetch_osu_info:1;
971 	unsigned int fetch_osu_waiting_scan:1;
972 	unsigned int fetch_osu_icon_in_progress:1;
973 	struct wpa_bss *interworking_gas_bss;
974 	unsigned int osu_icon_id;
975 	struct dl_list icon_head; /* struct icon_entry */
976 	struct osu_provider *osu_prov;
977 	size_t osu_prov_count;
978 	struct os_reltime osu_icon_fetch_start;
979 	unsigned int num_osu_scans;
980 	unsigned int num_prov_found;
981 #endif /* CONFIG_INTERWORKING */
982 	unsigned int drv_capa_known;
983 
984 	struct {
985 		struct hostapd_hw_modes *modes;
986 		u16 num_modes;
987 		u16 flags;
988 	} hw;
989 	enum local_hw_capab {
990 		CAPAB_NO_HT_VHT,
991 		CAPAB_HT,
992 		CAPAB_HT40,
993 		CAPAB_VHT,
994 	} hw_capab;
995 #ifdef CONFIG_MACSEC
996 	struct ieee802_1x_kay *kay;
997 #endif /* CONFIG_MACSEC */
998 
999 	int pno;
1000 	int pno_sched_pending;
1001 
1002 	/* WLAN_REASON_* reason codes. Negative if locally generated. */
1003 	int disconnect_reason;
1004 
1005 	/* WLAN_STATUS_* status codes from (Re)Association Response frame. */
1006 	u16 assoc_status_code;
1007 	/* Indicates if the previous association request timed out. */
1008 	u8 assoc_timed_out;
1009 
1010 	struct ext_password_data *ext_pw;
1011 
1012 	struct wpabuf *last_gas_resp, *prev_gas_resp;
1013 	u8 last_gas_addr[ETH_ALEN], prev_gas_addr[ETH_ALEN];
1014 	u8 last_gas_dialog_token, prev_gas_dialog_token;
1015 
1016 	unsigned int no_keep_alive:1;
1017 	unsigned int ext_mgmt_frame_handling:1;
1018 	unsigned int ext_eapol_frame_io:1;
1019 	unsigned int wmm_ac_supported:1;
1020 	unsigned int ext_work_in_progress:1;
1021 	unsigned int own_disconnect_req:1;
1022 	unsigned int ignore_post_flush_scan_res:1;
1023 
1024 #define MAC_ADDR_RAND_SCAN       BIT(0)
1025 #define MAC_ADDR_RAND_SCHED_SCAN BIT(1)
1026 #define MAC_ADDR_RAND_PNO        BIT(2)
1027 #define MAC_ADDR_RAND_ALL        (MAC_ADDR_RAND_SCAN | \
1028 				  MAC_ADDR_RAND_SCHED_SCAN | \
1029 				  MAC_ADDR_RAND_PNO)
1030 	unsigned int mac_addr_rand_supported;
1031 	unsigned int mac_addr_rand_enable;
1032 
1033 	/* MAC Address followed by mask (2 * ETH_ALEN) */
1034 	u8 *mac_addr_scan;
1035 	u8 *mac_addr_sched_scan;
1036 	u8 *mac_addr_pno;
1037 
1038 #ifdef CONFIG_WNM
1039 	u8 wnm_dialog_token;
1040 	u8 wnm_reply;
1041 	u8 wnm_num_neighbor_report;
1042 	u8 wnm_mode;
1043 	u16 wnm_dissoc_timer;
1044 	u8 wnm_bss_termination_duration[12];
1045 	struct neighbor_report *wnm_neighbor_report_elements;
1046 	struct os_reltime wnm_cand_valid_until;
1047 	u8 wnm_cand_from_bss[ETH_ALEN];
1048 #endif /* CONFIG_WNM */
1049 
1050 #ifdef CONFIG_TESTING_GET_GTK
1051 	u8 last_gtk[32];
1052 	size_t last_gtk_len;
1053 #endif /* CONFIG_TESTING_GET_GTK */
1054 
1055 	unsigned int num_multichan_concurrent;
1056 	struct wpa_radio_work *connect_work;
1057 
1058 	unsigned int ext_work_id;
1059 
1060 	struct wpabuf *vendor_elem[NUM_VENDOR_ELEM_FRAMES];
1061 
1062 #ifdef CONFIG_TESTING_OPTIONS
1063 	struct l2_packet_data *l2_test;
1064 	unsigned int extra_roc_dur;
1065 	enum wpa_supplicant_test_failure test_failure;
1066 	char *get_pref_freq_list_override;
1067 	unsigned int reject_btm_req_reason;
1068 	unsigned int p2p_go_csa_on_inv:1;
1069 	unsigned int ignore_auth_resp:1;
1070 	unsigned int ignore_assoc_disallow:1;
1071 #endif /* CONFIG_TESTING_OPTIONS */
1072 
1073 	struct wmm_ac_assoc_data *wmm_ac_assoc_info;
1074 	struct wmm_tspec_element *tspecs[WMM_AC_NUM][TS_DIR_IDX_COUNT];
1075 	struct wmm_ac_addts_request *addts_request;
1076 	u8 wmm_ac_last_dialog_token;
1077 	struct wmm_tspec_element *last_tspecs;
1078 	u8 last_tspecs_count;
1079 
1080 	struct rrm_data rrm;
1081 	struct beacon_rep_data beacon_rep_data;
1082 
1083 #ifdef CONFIG_FST
1084 	struct fst_iface *fst;
1085 	const struct wpabuf *fst_ies;
1086 	struct wpabuf *received_mb_ies;
1087 #endif /* CONFIG_FST */
1088 
1089 #ifdef CONFIG_MBO
1090 	/* Multiband operation non-preferred channel */
1091 	struct wpa_mbo_non_pref_channel {
1092 		enum mbo_non_pref_chan_reason reason;
1093 		u8 oper_class;
1094 		u8 chan;
1095 		u8 preference;
1096 	} *non_pref_chan;
1097 	size_t non_pref_chan_num;
1098 	u8 mbo_wnm_token;
1099 #endif /* CONFIG_MBO */
1100 
1101 	/*
1102 	 * This should be under CONFIG_MBO, but it is left out to allow using
1103 	 * the bss_temp_disallowed list for other purposes as well.
1104 	 */
1105 	struct dl_list bss_tmp_disallowed;
1106 
1107 	/*
1108 	 * Content of a measurement report element with type 8 (LCI),
1109 	 * own location.
1110 	 */
1111 	struct wpabuf *lci;
1112 	struct os_reltime lci_time;
1113 
1114 	struct os_reltime beacon_rep_scan;
1115 
1116 	/* FILS HLP requests (struct fils_hlp_req) */
1117 	struct dl_list fils_hlp_req;
1118 
1119 	struct sched_scan_relative_params {
1120 		/**
1121 		 * relative_rssi_set - Enable relatively preferred BSS reporting
1122 		 *
1123 		 * 0 = Disable reporting relatively preferred BSSs
1124 		 * 1 = Enable reporting relatively preferred BSSs
1125 		 */
1126 		int relative_rssi_set;
1127 
1128 		/**
1129 		 * relative_rssi - Relative RSSI for reporting better BSSs
1130 		 *
1131 		 * Amount of RSSI by which a BSS should be better than the
1132 		 * current connected BSS so that the new BSS can be reported
1133 		 * to user space. This applies to sched_scan operations.
1134 		 */
1135 		int relative_rssi;
1136 
1137 		/**
1138 		 * relative_adjust_band - Band in which RSSI is to be adjusted
1139 		 */
1140 		enum set_band relative_adjust_band;
1141 
1142 		/**
1143 		 * relative_adjust_rssi - RSSI adjustment
1144 		 *
1145 		 * An amount of relative_adjust_rssi should be added to the
1146 		 * BSSs that belong to the relative_adjust_band while comparing
1147 		 * with other bands for BSS reporting.
1148 		 */
1149 		int relative_adjust_rssi;
1150 	} srp;
1151 
1152 	/* RIC elements for FT protocol */
1153 	struct wpabuf *ric_ies;
1154 };
1155 
1156 
1157 /* wpa_supplicant.c */
1158 void wpa_supplicant_apply_ht_overrides(
1159 	struct wpa_supplicant *wpa_s, struct wpa_ssid *ssid,
1160 	struct wpa_driver_associate_params *params);
1161 void wpa_supplicant_apply_vht_overrides(
1162 	struct wpa_supplicant *wpa_s, struct wpa_ssid *ssid,
1163 	struct wpa_driver_associate_params *params);
1164 
1165 int wpa_set_wep_keys(struct wpa_supplicant *wpa_s, struct wpa_ssid *ssid);
1166 int wpa_supplicant_set_wpa_none_key(struct wpa_supplicant *wpa_s,
1167 				    struct wpa_ssid *ssid);
1168 
1169 int wpa_supplicant_reload_configuration(struct wpa_supplicant *wpa_s);
1170 
1171 const char * wpa_supplicant_state_txt(enum wpa_states state);
1172 int wpa_supplicant_update_mac_addr(struct wpa_supplicant *wpa_s);
1173 int wpa_supplicant_driver_init(struct wpa_supplicant *wpa_s);
1174 int wpa_supplicant_set_suites(struct wpa_supplicant *wpa_s,
1175 			      struct wpa_bss *bss, struct wpa_ssid *ssid,
1176 			      u8 *wpa_ie, size_t *wpa_ie_len);
1177 void wpa_supplicant_associate(struct wpa_supplicant *wpa_s,
1178 			      struct wpa_bss *bss,
1179 			      struct wpa_ssid *ssid);
1180 void wpa_supplicant_set_non_wpa_policy(struct wpa_supplicant *wpa_s,
1181 				       struct wpa_ssid *ssid);
1182 void wpa_supplicant_initiate_eapol(struct wpa_supplicant *wpa_s);
1183 void wpa_clear_keys(struct wpa_supplicant *wpa_s, const u8 *addr);
1184 void wpa_supplicant_req_auth_timeout(struct wpa_supplicant *wpa_s,
1185 				     int sec, int usec);
1186 void wpa_supplicant_reinit_autoscan(struct wpa_supplicant *wpa_s);
1187 void wpa_supplicant_set_state(struct wpa_supplicant *wpa_s,
1188 			      enum wpa_states state);
1189 struct wpa_ssid * wpa_supplicant_get_ssid(struct wpa_supplicant *wpa_s);
1190 const char * wpa_supplicant_get_eap_mode(struct wpa_supplicant *wpa_s);
1191 void wpa_supplicant_cancel_auth_timeout(struct wpa_supplicant *wpa_s);
1192 void wpa_supplicant_deauthenticate(struct wpa_supplicant *wpa_s,
1193 				   int reason_code);
1194 
1195 struct wpa_ssid * wpa_supplicant_add_network(struct wpa_supplicant *wpa_s);
1196 int wpa_supplicant_remove_network(struct wpa_supplicant *wpa_s, int id);
1197 void wpa_supplicant_enable_network(struct wpa_supplicant *wpa_s,
1198 				   struct wpa_ssid *ssid);
1199 void wpa_supplicant_disable_network(struct wpa_supplicant *wpa_s,
1200 				    struct wpa_ssid *ssid);
1201 void wpa_supplicant_select_network(struct wpa_supplicant *wpa_s,
1202 				   struct wpa_ssid *ssid);
1203 int wpas_set_pkcs11_engine_and_module_path(struct wpa_supplicant *wpa_s,
1204 					   const char *pkcs11_engine_path,
1205 					   const char *pkcs11_module_path);
1206 int wpa_supplicant_set_ap_scan(struct wpa_supplicant *wpa_s,
1207 			       int ap_scan);
1208 int wpa_supplicant_set_bss_expiration_age(struct wpa_supplicant *wpa_s,
1209 					  unsigned int expire_age);
1210 int wpa_supplicant_set_bss_expiration_count(struct wpa_supplicant *wpa_s,
1211 					    unsigned int expire_count);
1212 int wpa_supplicant_set_scan_interval(struct wpa_supplicant *wpa_s,
1213 				     int scan_interval);
1214 int wpa_supplicant_set_debug_params(struct wpa_global *global,
1215 				    int debug_level, int debug_timestamp,
1216 				    int debug_show_keys);
1217 void free_hw_features(struct wpa_supplicant *wpa_s);
1218 
1219 void wpa_show_license(void);
1220 
1221 struct wpa_interface * wpa_supplicant_match_iface(struct wpa_global *global,
1222 						  const char *ifname);
1223 struct wpa_supplicant * wpa_supplicant_add_iface(struct wpa_global *global,
1224 						 struct wpa_interface *iface,
1225 						 struct wpa_supplicant *parent);
1226 int wpa_supplicant_remove_iface(struct wpa_global *global,
1227 				struct wpa_supplicant *wpa_s,
1228 				int terminate);
1229 struct wpa_supplicant * wpa_supplicant_get_iface(struct wpa_global *global,
1230 						 const char *ifname);
1231 struct wpa_global * wpa_supplicant_init(struct wpa_params *params);
1232 int wpa_supplicant_run(struct wpa_global *global);
1233 void wpa_supplicant_deinit(struct wpa_global *global);
1234 
1235 int wpa_supplicant_scard_init(struct wpa_supplicant *wpa_s,
1236 			      struct wpa_ssid *ssid);
1237 void wpa_supplicant_terminate_proc(struct wpa_global *global);
1238 void wpa_supplicant_rx_eapol(void *ctx, const u8 *src_addr,
1239 			     const u8 *buf, size_t len);
1240 void wpa_supplicant_update_config(struct wpa_supplicant *wpa_s);
1241 void wpa_supplicant_clear_status(struct wpa_supplicant *wpa_s);
1242 void wpas_connection_failed(struct wpa_supplicant *wpa_s, const u8 *bssid);
1243 int wpas_driver_bss_selection(struct wpa_supplicant *wpa_s);
1244 int wpas_is_p2p_prioritized(struct wpa_supplicant *wpa_s);
1245 void wpas_auth_failed(struct wpa_supplicant *wpa_s, char *reason);
1246 void wpas_clear_temp_disabled(struct wpa_supplicant *wpa_s,
1247 			      struct wpa_ssid *ssid, int clear_failures);
1248 int disallowed_bssid(struct wpa_supplicant *wpa_s, const u8 *bssid);
1249 int disallowed_ssid(struct wpa_supplicant *wpa_s, const u8 *ssid,
1250 		    size_t ssid_len);
1251 void wpas_request_connection(struct wpa_supplicant *wpa_s);
1252 void wpas_request_disconnection(struct wpa_supplicant *wpa_s);
1253 int wpas_build_ext_capab(struct wpa_supplicant *wpa_s, u8 *buf, size_t buflen);
1254 int wpas_update_random_addr(struct wpa_supplicant *wpa_s, int style);
1255 int wpas_update_random_addr_disassoc(struct wpa_supplicant *wpa_s);
1256 void add_freq(int *freqs, int *num_freqs, int freq);
1257 
1258 void wpas_rrm_reset(struct wpa_supplicant *wpa_s);
1259 void wpas_rrm_process_neighbor_rep(struct wpa_supplicant *wpa_s,
1260 				   const u8 *report, size_t report_len);
1261 int wpas_rrm_send_neighbor_rep_request(struct wpa_supplicant *wpa_s,
1262 				       const struct wpa_ssid_value *ssid,
1263 				       int lci, int civic,
1264 				       void (*cb)(void *ctx,
1265 						  struct wpabuf *neighbor_rep),
1266 				       void *cb_ctx);
1267 void wpas_rrm_handle_radio_measurement_request(struct wpa_supplicant *wpa_s,
1268 					       const u8 *src,
1269 					       const u8 *frame, size_t len);
1270 void wpas_rrm_handle_link_measurement_request(struct wpa_supplicant *wpa_s,
1271 					      const u8 *src,
1272 					      const u8 *frame, size_t len,
1273 					      int rssi);
1274 int wpas_beacon_rep_scan_process(struct wpa_supplicant *wpa_s,
1275 				 struct wpa_scan_results *scan_res,
1276 				 struct scan_info *info);
1277 void wpas_clear_beacon_rep_data(struct wpa_supplicant *wpa_s);
1278 void wpas_flush_fils_hlp_req(struct wpa_supplicant *wpa_s);
1279 
1280 
1281 /* MBO functions */
1282 int wpas_mbo_ie(struct wpa_supplicant *wpa_s, u8 *buf, size_t len);
1283 const u8 * wpas_mbo_get_bss_attr(struct wpa_bss *bss, enum mbo_attr_id attr);
1284 int wpas_mbo_update_non_pref_chan(struct wpa_supplicant *wpa_s,
1285 				  const char *non_pref_chan);
1286 void wpas_mbo_scan_ie(struct wpa_supplicant *wpa_s, struct wpabuf *ie);
1287 void wpas_mbo_ie_trans_req(struct wpa_supplicant *wpa_s, const u8 *ie,
1288 			   size_t len);
1289 size_t wpas_mbo_ie_bss_trans_reject(struct wpa_supplicant *wpa_s, u8 *pos,
1290 				    size_t len,
1291 				    enum mbo_transition_reject_reason reason);
1292 void wpas_mbo_update_cell_capa(struct wpa_supplicant *wpa_s, u8 mbo_cell_capa);
1293 struct wpabuf * mbo_build_anqp_buf(struct wpa_supplicant *wpa_s,
1294 				   struct wpa_bss *bss);
1295 
1296 /* op_classes.c */
1297 enum chan_allowed {
1298 	NOT_ALLOWED, NO_IR, ALLOWED
1299 };
1300 
1301 enum chan_allowed verify_channel(struct hostapd_hw_modes *mode, u8 channel,
1302 				 u8 bw);
1303 size_t wpas_supp_op_class_ie(struct wpa_supplicant *wpa_s, int freq, u8 *pos,
1304 			      size_t len);
1305 
1306 /**
1307  * wpa_supplicant_ctrl_iface_ctrl_rsp_handle - Handle a control response
1308  * @wpa_s: Pointer to wpa_supplicant data
1309  * @ssid: Pointer to the network block the reply is for
1310  * @field: field the response is a reply for
1311  * @value: value (ie, password, etc) for @field
1312  * Returns: 0 on success, non-zero on error
1313  *
1314  * Helper function to handle replies to control interface requests.
1315  */
1316 int wpa_supplicant_ctrl_iface_ctrl_rsp_handle(struct wpa_supplicant *wpa_s,
1317 					      struct wpa_ssid *ssid,
1318 					      const char *field,
1319 					      const char *value);
1320 /**
1321  * wpa_supplicant_ctrl_rsp_handle - Handle a control response
1322  * @wpa_s: Pointer to wpa_supplicant data
1323  * @ssid: Pointer to the network block the reply is for
1324  * @field: field the response is a reply for
1325  * @value: value (ie, password, etc) for @field
1326  * Returns: 0 on success, non-zero on error
1327  *
1328  * Helper function to handle replies to control interface requests.
1329  */
1330 int wpa_supplicant_ctrl_rsp_handle(struct wpa_supplicant *wpa_s,
1331 				   struct wpa_ssid *ssid,
1332 				   enum wpa_ctrl_req_type rtype,
1333 				   const char *value);
1334 
1335 void ibss_mesh_setup_freq(struct wpa_supplicant *wpa_s,
1336 			  const struct wpa_ssid *ssid,
1337 			  struct hostapd_freq_params *freq);
1338 
1339 /* events.c */
1340 void wpa_supplicant_mark_disassoc(struct wpa_supplicant *wpa_s);
1341 int wpa_supplicant_connect(struct wpa_supplicant *wpa_s,
1342 			   struct wpa_bss *selected,
1343 			   struct wpa_ssid *ssid);
1344 void wpa_supplicant_stop_countermeasures(void *eloop_ctx, void *sock_ctx);
1345 void wpa_supplicant_delayed_mic_error_report(void *eloop_ctx, void *sock_ctx);
1346 void wnm_bss_keep_alive_deinit(struct wpa_supplicant *wpa_s);
1347 int wpa_supplicant_fast_associate(struct wpa_supplicant *wpa_s);
1348 struct wpa_bss * wpa_supplicant_pick_network(struct wpa_supplicant *wpa_s,
1349 					     struct wpa_ssid **selected_ssid);
1350 
1351 /* eap_register.c */
1352 int eap_register_methods(void);
1353 
1354 /**
1355  * Utility method to tell if a given network is for persistent group storage
1356  * @ssid: Network object
1357  * Returns: 1 if network is a persistent group, 0 otherwise
1358  */
network_is_persistent_group(struct wpa_ssid * ssid)1359 static inline int network_is_persistent_group(struct wpa_ssid *ssid)
1360 {
1361 	return ssid->disabled == 2 && ssid->p2p_persistent_group;
1362 }
1363 
1364 int wpas_network_disabled(struct wpa_supplicant *wpa_s, struct wpa_ssid *ssid);
1365 int wpas_get_ssid_pmf(struct wpa_supplicant *wpa_s, struct wpa_ssid *ssid);
1366 
1367 int wpas_init_ext_pw(struct wpa_supplicant *wpa_s);
1368 
1369 void dump_freq_data(struct wpa_supplicant *wpa_s, const char *title,
1370 		    struct wpa_used_freq_data *freqs_data,
1371 		    unsigned int len);
1372 
1373 int get_shared_radio_freqs_data(struct wpa_supplicant *wpa_s,
1374 				struct wpa_used_freq_data *freqs_data,
1375 				unsigned int len);
1376 int get_shared_radio_freqs(struct wpa_supplicant *wpa_s,
1377 			   int *freq_array, unsigned int len);
1378 
1379 void wpas_network_reenabled(void *eloop_ctx, void *timeout_ctx);
1380 
1381 void wpas_vendor_elem_update(struct wpa_supplicant *wpa_s);
1382 struct wpa_supplicant * wpas_vendor_elem(struct wpa_supplicant *wpa_s,
1383 					 enum wpa_vendor_elem_frame frame);
1384 int wpas_vendor_elem_remove(struct wpa_supplicant *wpa_s, int frame,
1385 			    const u8 *elem, size_t len);
1386 
1387 #ifdef CONFIG_FST
1388 
1389 struct fst_wpa_obj;
1390 
1391 void fst_wpa_supplicant_fill_iface_obj(struct wpa_supplicant *wpa_s,
1392 				       struct fst_wpa_obj *iface_obj);
1393 
1394 #endif /* CONFIG_FST */
1395 
1396 int wpas_sched_scan_plans_set(struct wpa_supplicant *wpa_s, const char *cmd);
1397 
1398 struct hostapd_hw_modes * get_mode(struct hostapd_hw_modes *modes,
1399 				   u16 num_modes, enum hostapd_hw_mode mode);
1400 
1401 void wpa_bss_tmp_disallow(struct wpa_supplicant *wpa_s, const u8 *bssid,
1402 			  unsigned int sec);
1403 int wpa_is_bss_tmp_disallowed(struct wpa_supplicant *wpa_s, const u8 *bssid);
1404 
1405 struct wpa_ssid * wpa_scan_res_match(struct wpa_supplicant *wpa_s,
1406 				     int i, struct wpa_bss *bss,
1407 				     struct wpa_ssid *group,
1408 				     int only_first_ssid, int debug_print);
1409 
1410 int wpas_ctrl_iface_get_pref_freq_list_override(struct wpa_supplicant *wpa_s,
1411 						enum wpa_driver_if_type if_type,
1412 						unsigned int *num,
1413 						unsigned int *freq_list);
1414 
1415 #endif /* WPA_SUPPLICANT_I_H */
1416