]>
Commit | Line | Data |
---|---|---|
6fc6879b JM |
1 | /* |
2 | * WPA Supplicant / Configuration file structures | |
f64adcd7 | 3 | * Copyright (c) 2003-2012, Jouni Malinen <j@w1.fi> |
6fc6879b | 4 | * |
0f3d578e JM |
5 | * This software may be distributed under the terms of the BSD license. |
6 | * See README for more details. | |
6fc6879b JM |
7 | */ |
8 | ||
9 | #ifndef CONFIG_H | |
10 | #define CONFIG_H | |
11 | ||
12 | #define DEFAULT_EAPOL_VERSION 1 | |
13 | #ifdef CONFIG_NO_SCAN_PROCESSING | |
14 | #define DEFAULT_AP_SCAN 2 | |
15 | #else /* CONFIG_NO_SCAN_PROCESSING */ | |
16 | #define DEFAULT_AP_SCAN 1 | |
17 | #endif /* CONFIG_NO_SCAN_PROCESSING */ | |
e45e8989 | 18 | #define DEFAULT_USER_MPM 1 |
4b409368 | 19 | #define DEFAULT_MAX_PEER_LINKS 99 |
5a2a6de6 | 20 | #define DEFAULT_MESH_MAX_INACTIVITY 300 |
ecd40fef MH |
21 | /* |
22 | * The default dot11RSNASAERetransPeriod is defined as 40 ms in the standard, | |
23 | * but use 1000 ms in practice to avoid issues on low power CPUs. | |
24 | */ | |
25 | #define DEFAULT_DOT11_RSNA_SAE_RETRANS_PERIOD 1000 | |
6fc6879b | 26 | #define DEFAULT_FAST_REAUTH 1 |
e3768e7c | 27 | #define DEFAULT_P2P_GO_INTENT 7 |
0f66abd2 | 28 | #define DEFAULT_P2P_INTRA_BSS 1 |
462a7439 | 29 | #define DEFAULT_P2P_GO_MAX_INACTIVITY (5 * 60) |
e3bd6e9d | 30 | #define DEFAULT_P2P_OPTIMIZE_LISTEN_CHAN 0 |
c9c38b09 | 31 | #define DEFAULT_BSS_MAX_COUNT 200 |
78633c37 SL |
32 | #define DEFAULT_BSS_EXPIRATION_AGE 180 |
33 | #define DEFAULT_BSS_EXPIRATION_SCAN_COUNT 2 | |
dae608d5 | 34 | #define DEFAULT_MAX_NUM_STA 128 |
19e20c14 | 35 | #define DEFAULT_AP_ISOLATE 0 |
11540c0b | 36 | #define DEFAULT_ACCESS_NETWORK_TYPE 15 |
6124e858 | 37 | #define DEFAULT_SCAN_CUR_FREQ 0 |
d3b20469 | 38 | #define DEFAULT_P2P_SEARCH_DELAY 500 |
c267753b | 39 | #define DEFAULT_RAND_ADDR_LIFETIME 60 |
b41f2684 | 40 | #define DEFAULT_KEY_MGMT_OFFLOAD 1 |
483dd6a5 | 41 | #define DEFAULT_CERT_IN_CB 1 |
0b8bcaa5 | 42 | #define DEFAULT_P2P_GO_CTWINDOW 0 |
73ed03f3 | 43 | #define DEFAULT_WPA_RSC_RELAXATION 1 |
c5d193d7 | 44 | #define DEFAULT_MBO_CELL_CAPA MBO_CELL_CAPA_NOT_SUPPORTED |
af8bc24d | 45 | #define DEFAULT_DISASSOC_IMMINENT_RSSI_THRESHOLD -75 |
332aadb8 | 46 | #define DEFAULT_OCE_SUPPORT OCE_STA |
6fc6879b JM |
47 | |
48 | #include "config_ssid.h" | |
2f646b6e | 49 | #include "wps/wps.h" |
eaa8eefe | 50 | #include "common/ieee802_11_defs.h" |
c26effe1 | 51 | #include "common/ieee802_11_common.h" |
6fc6879b JM |
52 | |
53 | ||
909a948b JM |
54 | #define MAX_ROAMING_CONS 36 |
55 | #define MAX_ROAMING_CONS_OI_LEN 15 | |
56 | ||
1bb7b8e8 JM |
57 | struct wpa_cred { |
58 | /** | |
59 | * next - Next credential in the list | |
60 | * | |
61 | * This pointer can be used to iterate over all credentials. The head | |
62 | * of this list is stored in the cred field of struct wpa_config. | |
63 | */ | |
64 | struct wpa_cred *next; | |
65 | ||
66 | /** | |
67 | * id - Unique id for the credential | |
68 | * | |
69 | * This identifier is used as a unique identifier for each credential | |
70 | * block when using the control interface. Each credential is allocated | |
71 | * an id when it is being created, either when reading the | |
72 | * configuration file or when a new credential is added through the | |
73 | * control interface. | |
74 | */ | |
75 | int id; | |
76 | ||
03ed3324 JM |
77 | /** |
78 | * temporary - Whether this credential is temporary and not to be saved | |
79 | */ | |
80 | int temporary; | |
81 | ||
1a712d2f JM |
82 | /** |
83 | * priority - Priority group | |
84 | * | |
85 | * By default, all networks and credentials get the same priority group | |
86 | * (0). This field can be used to give higher priority for credentials | |
87 | * (and similarly in struct wpa_ssid for network blocks) to change the | |
88 | * Interworking automatic networking selection behavior. The matching | |
89 | * network (based on either an enabled network block or a credential) | |
90 | * with the highest priority value will be selected. | |
91 | */ | |
92 | int priority; | |
93 | ||
d7b01abd JM |
94 | /** |
95 | * pcsc - Use PC/SC and SIM/USIM card | |
96 | */ | |
97 | int pcsc; | |
98 | ||
1bb7b8e8 JM |
99 | /** |
100 | * realm - Home Realm for Interworking | |
101 | */ | |
102 | char *realm; | |
103 | ||
104 | /** | |
105 | * username - Username for Interworking network selection | |
106 | */ | |
107 | char *username; | |
108 | ||
109 | /** | |
110 | * password - Password for Interworking network selection | |
111 | */ | |
112 | char *password; | |
113 | ||
02af9c90 JM |
114 | /** |
115 | * ext_password - Whether password is a name for external storage | |
116 | */ | |
117 | int ext_password; | |
118 | ||
1bb7b8e8 JM |
119 | /** |
120 | * ca_cert - CA certificate for Interworking network selection | |
121 | */ | |
122 | char *ca_cert; | |
123 | ||
11e4f46a JM |
124 | /** |
125 | * client_cert - File path to client certificate file (PEM/DER) | |
126 | * | |
127 | * This field is used with Interworking networking selection for a case | |
128 | * where client certificate/private key is used for authentication | |
129 | * (EAP-TLS). Full path to the file should be used since working | |
130 | * directory may change when wpa_supplicant is run in the background. | |
131 | * | |
132 | * Alternatively, a named configuration blob can be used by setting | |
133 | * this to blob://blob_name. | |
134 | */ | |
135 | char *client_cert; | |
136 | ||
137 | /** | |
138 | * private_key - File path to client private key file (PEM/DER/PFX) | |
139 | * | |
140 | * When PKCS#12/PFX file (.p12/.pfx) is used, client_cert should be | |
141 | * commented out. Both the private key and certificate will be read | |
142 | * from the PKCS#12 file in this case. Full path to the file should be | |
143 | * used since working directory may change when wpa_supplicant is run | |
144 | * in the background. | |
145 | * | |
146 | * Windows certificate store can be used by leaving client_cert out and | |
147 | * configuring private_key in one of the following formats: | |
148 | * | |
149 | * cert://substring_to_match | |
150 | * | |
151 | * hash://certificate_thumbprint_in_hex | |
152 | * | |
153 | * For example: private_key="hash://63093aa9c47f56ae88334c7b65a4" | |
154 | * | |
155 | * Note that when running wpa_supplicant as an application, the user | |
156 | * certificate store (My user account) is used, whereas computer store | |
157 | * (Computer account) is used when running wpasvc as a service. | |
158 | * | |
159 | * Alternatively, a named configuration blob can be used by setting | |
160 | * this to blob://blob_name. | |
161 | */ | |
162 | char *private_key; | |
163 | ||
164 | /** | |
165 | * private_key_passwd - Password for private key file | |
166 | */ | |
167 | char *private_key_passwd; | |
168 | ||
1bb7b8e8 JM |
169 | /** |
170 | * imsi - IMSI in <MCC> | <MNC> | '-' | <MSIN> format | |
171 | */ | |
172 | char *imsi; | |
173 | ||
174 | /** | |
175 | * milenage - Milenage parameters for SIM/USIM simulator in | |
176 | * <Ki>:<OPc>:<SQN> format | |
177 | */ | |
178 | char *milenage; | |
179 | ||
ac1bc549 JM |
180 | /** |
181 | * domain_suffix_match - Constraint for server domain name | |
182 | * | |
183 | * If set, this FQDN is used as a suffix match requirement for the AAA | |
184 | * server certificate in SubjectAltName dNSName element(s). If a | |
185 | * matching dNSName is found, this constraint is met. If no dNSName | |
e24aef10 | 186 | * values are present, this constraint is matched against SubjectName CN |
ac1bc549 JM |
187 | * using same suffix match comparison. Suffix match here means that the |
188 | * host/domain name is compared one label at a time starting from the | |
189 | * top-level domain and all the labels in @domain_suffix_match shall be | |
190 | * included in the certificate. The certificate may include additional | |
191 | * sub-level labels in addition to the required labels. | |
192 | * | |
193 | * For example, domain_suffix_match=example.com would match | |
194 | * test.example.com but would not match test-example.com. | |
195 | */ | |
196 | char *domain_suffix_match; | |
197 | ||
1bb7b8e8 | 198 | /** |
463c8ffb | 199 | * domain - Home service provider FQDN(s) |
1bb7b8e8 JM |
200 | * |
201 | * This is used to compare against the Domain Name List to figure out | |
463c8ffb JM |
202 | * whether the AP is operated by the Home SP. Multiple domain entries |
203 | * can be used to configure alternative FQDNs that will be considered | |
204 | * home networks. | |
1bb7b8e8 | 205 | */ |
463c8ffb JM |
206 | char **domain; |
207 | ||
208 | /** | |
209 | * num_domain - Number of FQDNs in the domain array | |
210 | */ | |
211 | size_t num_domain; | |
8ca93c59 | 212 | |
955567bc JM |
213 | /** |
214 | * roaming_consortium - Roaming Consortium OI | |
215 | * | |
216 | * If roaming_consortium_len is non-zero, this field contains the | |
217 | * Roaming Consortium OI that can be used to determine which access | |
218 | * points support authentication with this credential. This is an | |
219 | * alternative to the use of the realm parameter. When using Roaming | |
220 | * Consortium to match the network, the EAP parameters need to be | |
221 | * pre-configured with the credential since the NAI Realm information | |
222 | * may not be available or fetched. | |
223 | */ | |
224 | u8 roaming_consortium[15]; | |
225 | ||
226 | /** | |
227 | * roaming_consortium_len - Length of roaming_consortium | |
228 | */ | |
229 | size_t roaming_consortium_len; | |
230 | ||
9b6f93e4 JM |
231 | /** |
232 | * required_roaming_consortium - Required Roaming Consortium OI | |
233 | * | |
234 | * If required_roaming_consortium_len is non-zero, this field contains | |
235 | * the Roaming Consortium OI that is required to be advertised by the AP | |
236 | * for the credential to be considered matching. | |
237 | */ | |
f47c1452 | 238 | u8 required_roaming_consortium[15]; |
9b6f93e4 JM |
239 | |
240 | /** | |
241 | * required_roaming_consortium_len - Length of required_roaming_consortium | |
242 | */ | |
f47c1452 JM |
243 | size_t required_roaming_consortium_len; |
244 | ||
909a948b JM |
245 | /** |
246 | * roaming_consortiums - Roaming Consortium OI(s) memberships | |
247 | * | |
248 | * This field contains one or more OIs identifying the roaming | |
249 | * consortiums of which the provider is a member. The list is sorted | |
250 | * from the most preferred one to the least preferred one. A match | |
251 | * between the Roaming Consortium OIs advertised by an AP and the OIs | |
252 | * in this list indicates that successful authentication is possible. | |
253 | * (Hotspot 2.0 PerProviderSubscription/<X+>/HomeSP/RoamingConsortiumOI) | |
254 | */ | |
255 | u8 roaming_consortiums[MAX_ROAMING_CONS][MAX_ROAMING_CONS_OI_LEN]; | |
256 | ||
257 | /** | |
258 | * roaming_consortiums_len - Length on roaming_consortiums[i] | |
259 | */ | |
260 | size_t roaming_consortiums_len[MAX_ROAMING_CONS]; | |
261 | ||
262 | /** | |
263 | * num_roaming_consortiums - Number of entries in roaming_consortiums | |
264 | */ | |
265 | unsigned int num_roaming_consortiums; | |
266 | ||
8ca93c59 JM |
267 | /** |
268 | * eap_method - EAP method to use | |
269 | * | |
270 | * Pre-configured EAP method to use with this credential or %NULL to | |
271 | * indicate no EAP method is selected, i.e., the method will be | |
272 | * selected automatically based on ANQP information. | |
273 | */ | |
274 | struct eap_method_type *eap_method; | |
275 | ||
276 | /** | |
277 | * phase1 - Phase 1 (outer authentication) parameters | |
278 | * | |
279 | * Pre-configured EAP parameters or %NULL. | |
280 | */ | |
281 | char *phase1; | |
282 | ||
283 | /** | |
284 | * phase2 - Phase 2 (inner authentication) parameters | |
285 | * | |
286 | * Pre-configured EAP parameters or %NULL. | |
287 | */ | |
288 | char *phase2; | |
dbea8ac7 JM |
289 | |
290 | struct excluded_ssid { | |
eaa8eefe | 291 | u8 ssid[SSID_MAX_LEN]; |
dbea8ac7 JM |
292 | size_t ssid_len; |
293 | } *excluded_ssid; | |
294 | size_t num_excluded_ssid; | |
bc00053c JM |
295 | |
296 | struct roaming_partner { | |
297 | char fqdn[128]; | |
298 | int exact_match; | |
299 | u8 priority; | |
300 | char country[3]; | |
301 | } *roaming_partner; | |
302 | size_t num_roaming_partner; | |
f9cd147d JM |
303 | |
304 | int update_identifier; | |
aa26ba68 JM |
305 | |
306 | /** | |
307 | * provisioning_sp - FQDN of the SP that provisioned the credential | |
308 | */ | |
309 | char *provisioning_sp; | |
4cad9df1 | 310 | |
74794891 JM |
311 | /** |
312 | * sp_priority - Credential priority within a provisioning SP | |
313 | * | |
314 | * This is the priority of the credential among all credentials | |
315 | * provisionined by the same SP (i.e., for entries that have identical | |
316 | * provisioning_sp value). The range of this priority is 0-255 with 0 | |
317 | * being the highest and 255 the lower priority. | |
318 | */ | |
319 | int sp_priority; | |
320 | ||
4cad9df1 JM |
321 | unsigned int min_dl_bandwidth_home; |
322 | unsigned int min_ul_bandwidth_home; | |
323 | unsigned int min_dl_bandwidth_roaming; | |
324 | unsigned int min_ul_bandwidth_roaming; | |
a45b2dc5 JM |
325 | |
326 | /** | |
327 | * max_bss_load - Maximum BSS Load Channel Utilization (1..255) | |
328 | * This value is used as the maximum channel utilization for network | |
329 | * selection purposes for home networks. If the AP does not advertise | |
330 | * BSS Load or if the limit would prevent any connection, this | |
331 | * constraint will be ignored. | |
332 | */ | |
333 | unsigned int max_bss_load; | |
33fb8c52 JM |
334 | |
335 | unsigned int num_req_conn_capab; | |
336 | u8 *req_conn_capab_proto; | |
337 | int **req_conn_capab_port; | |
cf6d08a6 JM |
338 | |
339 | /** | |
340 | * ocsp - Whether to use/require OCSP to check server certificate | |
341 | * | |
342 | * 0 = do not use OCSP stapling (TLS certificate status extension) | |
343 | * 1 = try to use OCSP stapling, but not require response | |
344 | * 2 = require valid OCSP stapling response | |
345 | */ | |
346 | int ocsp; | |
13f6a07e NJ |
347 | |
348 | /** | |
349 | * sim_num - User selected SIM identifier | |
350 | * | |
351 | * This variable is used for identifying which SIM is used if the system | |
352 | * has more than one. | |
353 | */ | |
354 | int sim_num; | |
1bb7b8e8 JM |
355 | }; |
356 | ||
357 | ||
1d47214a JM |
358 | #define CFG_CHANGED_DEVICE_NAME BIT(0) |
359 | #define CFG_CHANGED_CONFIG_METHODS BIT(1) | |
360 | #define CFG_CHANGED_DEVICE_TYPE BIT(2) | |
361 | #define CFG_CHANGED_OS_VERSION BIT(3) | |
362 | #define CFG_CHANGED_UUID BIT(4) | |
363 | #define CFG_CHANGED_COUNTRY BIT(5) | |
e3768e7c JM |
364 | #define CFG_CHANGED_SEC_DEVICE_TYPE BIT(6) |
365 | #define CFG_CHANGED_P2P_SSID_POSTFIX BIT(7) | |
1c9cb49f | 366 | #define CFG_CHANGED_WPS_STRING BIT(8) |
0f66abd2 | 367 | #define CFG_CHANGED_P2P_INTRA_BSS BIT(9) |
f95cac27 | 368 | #define CFG_CHANGED_VENDOR_EXTENSION BIT(10) |
2463ba70 JS |
369 | #define CFG_CHANGED_P2P_LISTEN_CHANNEL BIT(11) |
370 | #define CFG_CHANGED_P2P_OPER_CHANNEL BIT(12) | |
21d996f7 | 371 | #define CFG_CHANGED_P2P_PREF_CHAN BIT(13) |
306ae225 | 372 | #define CFG_CHANGED_EXT_PW_BACKEND BIT(14) |
042ec551 | 373 | #define CFG_CHANGED_NFC_PASSWORD_TOKEN BIT(15) |
1b928f96 | 374 | #define CFG_CHANGED_P2P_PASSPHRASE_LEN BIT(16) |
bea48f77 | 375 | #define CFG_CHANGED_SCHED_SCAN_PLANS BIT(17) |
3c7863f8 | 376 | #define CFG_CHANGED_WOWLAN_TRIGGERS BIT(18) |
1d47214a | 377 | |
6fc6879b JM |
378 | /** |
379 | * struct wpa_config - wpa_supplicant configuration data | |
380 | * | |
381 | * This data structure is presents the per-interface (radio) configuration | |
382 | * data. In many cases, there is only one struct wpa_config instance, but if | |
383 | * more than one network interface is being controlled, one instance is used | |
384 | * for each. | |
385 | */ | |
386 | struct wpa_config { | |
387 | /** | |
388 | * ssid - Head of the global network list | |
389 | * | |
390 | * This is the head for the list of all the configured networks. | |
391 | */ | |
392 | struct wpa_ssid *ssid; | |
393 | ||
394 | /** | |
395 | * pssid - Per-priority network lists (in priority order) | |
396 | */ | |
397 | struct wpa_ssid **pssid; | |
398 | ||
399 | /** | |
400 | * num_prio - Number of different priorities used in the pssid lists | |
401 | * | |
402 | * This indicates how many per-priority network lists are included in | |
403 | * pssid. | |
404 | */ | |
405 | int num_prio; | |
406 | ||
1bb7b8e8 JM |
407 | /** |
408 | * cred - Head of the credential list | |
409 | * | |
410 | * This is the head for the list of all the configured credentials. | |
411 | */ | |
412 | struct wpa_cred *cred; | |
413 | ||
6fc6879b JM |
414 | /** |
415 | * eapol_version - IEEE 802.1X/EAPOL version number | |
416 | * | |
417 | * wpa_supplicant is implemented based on IEEE Std 802.1X-2004 which | |
418 | * defines EAPOL version 2. However, there are many APs that do not | |
419 | * handle the new version number correctly (they seem to drop the | |
420 | * frames completely). In order to make wpa_supplicant interoperate | |
421 | * with these APs, the version number is set to 1 by default. This | |
422 | * configuration value can be used to set it to the new version (2). | |
423 | */ | |
424 | int eapol_version; | |
425 | ||
426 | /** | |
427 | * ap_scan - AP scanning/selection | |
428 | * | |
429 | * By default, wpa_supplicant requests driver to perform AP | |
430 | * scanning and then uses the scan results to select a | |
431 | * suitable AP. Another alternative is to allow the driver to | |
432 | * take care of AP scanning and selection and use | |
433 | * wpa_supplicant just to process EAPOL frames based on IEEE | |
434 | * 802.11 association information from the driver. | |
435 | * | |
436 | * 1: wpa_supplicant initiates scanning and AP selection (default). | |
437 | * | |
438 | * 0: Driver takes care of scanning, AP selection, and IEEE 802.11 | |
439 | * association parameters (e.g., WPA IE generation); this mode can | |
440 | * also be used with non-WPA drivers when using IEEE 802.1X mode; | |
441 | * do not try to associate with APs (i.e., external program needs | |
442 | * to control association). This mode must also be used when using | |
443 | * wired Ethernet drivers. | |
444 | * | |
445 | * 2: like 0, but associate with APs using security policy and SSID | |
446 | * (but not BSSID); this can be used, e.g., with ndiswrapper and NDIS | |
447 | * drivers to enable operation with hidden SSIDs and optimized roaming; | |
448 | * in this mode, the network blocks in the configuration are tried | |
449 | * one by one until the driver reports successful association; each | |
450 | * network block should have explicit security policy (i.e., only one | |
451 | * option in the lists) for key_mgmt, pairwise, group, proto variables. | |
8406cd35 JM |
452 | * |
453 | * Note: ap_scan=2 should not be used with the nl80211 driver interface | |
454 | * (the current Linux interface). ap_scan=1 is optimized work working | |
455 | * with nl80211. For finding networks using hidden SSID, scan_ssid=1 in | |
456 | * the network block can be used with nl80211. | |
6fc6879b JM |
457 | */ |
458 | int ap_scan; | |
459 | ||
31392709 HD |
460 | /** |
461 | * bgscan - Background scan and roaming parameters or %NULL if none | |
462 | * | |
463 | * This is an optional set of parameters for background scanning and | |
464 | * roaming within a network (ESS). For more detailed information see | |
465 | * ssid block documentation. | |
466 | * | |
467 | * The variable defines default bgscan behavior for all BSS station | |
468 | * networks except for those which have their own bgscan configuration. | |
469 | */ | |
470 | char *bgscan; | |
471 | ||
54ddd743 JM |
472 | /** |
473 | * disable_scan_offload - Disable automatic offloading of scan requests | |
474 | * | |
475 | * By default, %wpa_supplicant tries to offload scanning if the driver | |
476 | * indicates support for this (sched_scan). This configuration | |
477 | * parameter can be used to disable this offloading mechanism. | |
478 | */ | |
479 | int disable_scan_offload; | |
480 | ||
6fc6879b JM |
481 | /** |
482 | * ctrl_interface - Parameters for the control interface | |
483 | * | |
484 | * If this is specified, %wpa_supplicant will open a control interface | |
485 | * that is available for external programs to manage %wpa_supplicant. | |
486 | * The meaning of this string depends on which control interface | |
ffbf1eaa | 487 | * mechanism is used. For all cases, the existence of this parameter |
6fc6879b JM |
488 | * in configuration is used to determine whether the control interface |
489 | * is enabled. | |
490 | * | |
491 | * For UNIX domain sockets (default on Linux and BSD): This is a | |
492 | * directory that will be created for UNIX domain sockets for listening | |
493 | * to requests from external programs (CLI/GUI, etc.) for status | |
494 | * information and configuration. The socket file will be named based | |
495 | * on the interface name, so multiple %wpa_supplicant processes can be | |
496 | * run at the same time if more than one interface is used. | |
497 | * /var/run/wpa_supplicant is the recommended directory for sockets and | |
498 | * by default, wpa_cli will use it when trying to connect with | |
499 | * %wpa_supplicant. | |
500 | * | |
501 | * Access control for the control interface can be configured | |
502 | * by setting the directory to allow only members of a group | |
503 | * to use sockets. This way, it is possible to run | |
504 | * %wpa_supplicant as root (since it needs to change network | |
505 | * configuration and open raw sockets) and still allow GUI/CLI | |
506 | * components to be run as non-root users. However, since the | |
507 | * control interface can be used to change the network | |
508 | * configuration, this access needs to be protected in many | |
509 | * cases. By default, %wpa_supplicant is configured to use gid | |
510 | * 0 (root). If you want to allow non-root users to use the | |
511 | * control interface, add a new group and change this value to | |
512 | * match with that group. Add users that should have control | |
513 | * interface access to this group. | |
514 | * | |
515 | * When configuring both the directory and group, use following format: | |
516 | * DIR=/var/run/wpa_supplicant GROUP=wheel | |
517 | * DIR=/var/run/wpa_supplicant GROUP=0 | |
518 | * (group can be either group name or gid) | |
519 | * | |
520 | * For UDP connections (default on Windows): The value will be ignored. | |
521 | * This variable is just used to select that the control interface is | |
522 | * to be created. The value can be set to, e.g., udp | |
523 | * (ctrl_interface=udp). | |
524 | * | |
525 | * For Windows Named Pipe: This value can be used to set the security | |
526 | * descriptor for controlling access to the control interface. Security | |
527 | * descriptor can be set using Security Descriptor String Format (see | |
528 | * http://msdn.microsoft.com/library/default.asp?url=/library/en-us/secauthz/security/security_descriptor_string_format.asp). | |
529 | * The descriptor string needs to be prefixed with SDDL=. For example, | |
530 | * ctrl_interface=SDDL=D: would set an empty DACL (which will reject | |
531 | * all connections). | |
532 | */ | |
533 | char *ctrl_interface; | |
534 | ||
535 | /** | |
536 | * ctrl_interface_group - Control interface group (DEPRECATED) | |
537 | * | |
538 | * This variable is only used for backwards compatibility. Group for | |
b39d1280 | 539 | * UNIX domain sockets should now be specified using GROUP=group in |
6fc6879b JM |
540 | * ctrl_interface variable. |
541 | */ | |
542 | char *ctrl_interface_group; | |
543 | ||
544 | /** | |
545 | * fast_reauth - EAP fast re-authentication (session resumption) | |
546 | * | |
547 | * By default, fast re-authentication is enabled for all EAP methods | |
548 | * that support it. This variable can be used to disable fast | |
549 | * re-authentication (by setting fast_reauth=0). Normally, there is no | |
550 | * need to disable fast re-authentication. | |
551 | */ | |
552 | int fast_reauth; | |
553 | ||
6fc6879b JM |
554 | /** |
555 | * opensc_engine_path - Path to the OpenSSL engine for opensc | |
556 | * | |
557 | * This is an OpenSSL specific configuration option for loading OpenSC | |
558 | * engine (engine_opensc.so); if %NULL, this engine is not loaded. | |
559 | */ | |
560 | char *opensc_engine_path; | |
561 | ||
562 | /** | |
563 | * pkcs11_engine_path - Path to the OpenSSL engine for PKCS#11 | |
564 | * | |
565 | * This is an OpenSSL specific configuration option for loading PKCS#11 | |
566 | * engine (engine_pkcs11.so); if %NULL, this engine is not loaded. | |
567 | */ | |
568 | char *pkcs11_engine_path; | |
569 | ||
570 | /** | |
571 | * pkcs11_module_path - Path to the OpenSSL OpenSC/PKCS#11 module | |
572 | * | |
573 | * This is an OpenSSL specific configuration option for configuring | |
574 | * path to OpenSC/PKCS#11 engine (opensc-pkcs11.so); if %NULL, this | |
575 | * module is not loaded. | |
576 | */ | |
577 | char *pkcs11_module_path; | |
6fc6879b | 578 | |
07e2de31 JM |
579 | /** |
580 | * openssl_ciphers - OpenSSL cipher string | |
581 | * | |
582 | * This is an OpenSSL specific configuration option for configuring the | |
583 | * default ciphers. If not set, "DEFAULT:!EXP:!LOW" is used as the | |
584 | * default. | |
585 | */ | |
586 | char *openssl_ciphers; | |
587 | ||
f64adcd7 JM |
588 | /** |
589 | * pcsc_reader - PC/SC reader name prefix | |
590 | * | |
591 | * If not %NULL, PC/SC reader with a name that matches this prefix is | |
592 | * initialized for SIM/USIM access. Empty string can be used to match | |
593 | * the first available reader. | |
594 | */ | |
595 | char *pcsc_reader; | |
596 | ||
597 | /** | |
598 | * pcsc_pin - PIN for USIM, GSM SIM, and smartcards | |
599 | * | |
600 | * This field is used to configure PIN for SIM/USIM for EAP-SIM and | |
601 | * EAP-AKA. If left out, this will be asked through control interface. | |
602 | */ | |
603 | char *pcsc_pin; | |
604 | ||
a5d44ac0 JM |
605 | /** |
606 | * external_sim - Use external processing for SIM/USIM operations | |
607 | */ | |
608 | int external_sim; | |
609 | ||
6fc6879b JM |
610 | /** |
611 | * driver_param - Driver interface parameters | |
612 | * | |
613 | * This text string is passed to the selected driver interface with the | |
614 | * optional struct wpa_driver_ops::set_param() handler. This can be | |
615 | * used to configure driver specific options without having to add new | |
616 | * driver interface functionality. | |
617 | */ | |
618 | char *driver_param; | |
619 | ||
620 | /** | |
621 | * dot11RSNAConfigPMKLifetime - Maximum lifetime of a PMK | |
622 | * | |
623 | * dot11 MIB variable for the maximum lifetime of a PMK in the PMK | |
624 | * cache (unit: seconds). | |
625 | */ | |
626 | unsigned int dot11RSNAConfigPMKLifetime; | |
627 | ||
628 | /** | |
629 | * dot11RSNAConfigPMKReauthThreshold - PMK re-authentication threshold | |
630 | * | |
631 | * dot11 MIB variable for the percentage of the PMK lifetime | |
632 | * that should expire before an IEEE 802.1X reauthentication occurs. | |
633 | */ | |
634 | unsigned int dot11RSNAConfigPMKReauthThreshold; | |
635 | ||
636 | /** | |
637 | * dot11RSNAConfigSATimeout - Security association timeout | |
638 | * | |
639 | * dot11 MIB variable for the maximum time a security association | |
640 | * shall take to set up (unit: seconds). | |
641 | */ | |
642 | unsigned int dot11RSNAConfigSATimeout; | |
643 | ||
644 | /** | |
645 | * update_config - Is wpa_supplicant allowed to update configuration | |
646 | * | |
647 | * This variable control whether wpa_supplicant is allow to re-write | |
648 | * its configuration with wpa_config_write(). If this is zero, | |
649 | * configuration data is only changed in memory and the external data | |
650 | * is not overriden. If this is non-zero, wpa_supplicant will update | |
651 | * the configuration data (e.g., a file) whenever configuration is | |
652 | * changed. This update may replace the old configuration which can | |
653 | * remove comments from it in case of a text file configuration. | |
654 | */ | |
655 | int update_config; | |
656 | ||
657 | /** | |
658 | * blobs - Configuration blobs | |
659 | */ | |
660 | struct wpa_config_blob *blobs; | |
f855f923 JM |
661 | |
662 | /** | |
663 | * uuid - Universally Unique IDentifier (UUID; see RFC 4122) for WPS | |
664 | */ | |
665 | u8 uuid[16]; | |
6d158490 | 666 | |
183d3924 JM |
667 | /** |
668 | * auto_uuid - Automatic UUID behavior | |
669 | * 0 = generate static value based on the local MAC address (default) | |
670 | * 1 = generate a random UUID every time wpa_supplicant starts | |
671 | */ | |
672 | int auto_uuid; | |
673 | ||
3c0b7aa4 JM |
674 | /** |
675 | * device_name - Device Name (WPS) | |
676 | * User-friendly description of device; up to 32 octets encoded in | |
677 | * UTF-8 | |
678 | */ | |
679 | char *device_name; | |
680 | ||
681 | /** | |
682 | * manufacturer - Manufacturer (WPS) | |
683 | * The manufacturer of the device (up to 64 ASCII characters) | |
684 | */ | |
685 | char *manufacturer; | |
686 | ||
687 | /** | |
688 | * model_name - Model Name (WPS) | |
689 | * Model of the device (up to 32 ASCII characters) | |
690 | */ | |
691 | char *model_name; | |
692 | ||
693 | /** | |
694 | * model_number - Model Number (WPS) | |
695 | * Additional device description (up to 32 ASCII characters) | |
696 | */ | |
697 | char *model_number; | |
698 | ||
699 | /** | |
700 | * serial_number - Serial Number (WPS) | |
701 | * Serial number of the device (up to 32 characters) | |
702 | */ | |
703 | char *serial_number; | |
704 | ||
705 | /** | |
706 | * device_type - Primary Device Type (WPS) | |
3c0b7aa4 | 707 | */ |
2f646b6e | 708 | u8 device_type[WPS_DEV_TYPE_LEN]; |
3c0b7aa4 | 709 | |
c0e4dd9e JM |
710 | /** |
711 | * config_methods - Config Methods | |
712 | * | |
713 | * This is a space-separated list of supported WPS configuration | |
6a857074 JM |
714 | * methods. For example, "label virtual_display virtual_push_button |
715 | * keypad". | |
c0e4dd9e | 716 | * Available methods: usba ethernet label display ext_nfc_token |
6a857074 JM |
717 | * int_nfc_token nfc_interface push_button keypad |
718 | * virtual_display physical_display | |
719 | * virtual_push_button physical_push_button. | |
c0e4dd9e JM |
720 | */ |
721 | char *config_methods; | |
722 | ||
3c0b7aa4 JM |
723 | /** |
724 | * os_version - OS Version (WPS) | |
725 | * 4-octet operating system version number | |
726 | */ | |
727 | u8 os_version[4]; | |
728 | ||
6d158490 | 729 | /** |
315ce40a | 730 | * country - Country code |
6d158490 LR |
731 | * |
732 | * This is the ISO/IEC alpha2 country code for which we are operating | |
733 | * in | |
734 | */ | |
315ce40a | 735 | char country[2]; |
47662164 JM |
736 | |
737 | /** | |
738 | * wps_cred_processing - Credential processing | |
739 | * | |
740 | * 0 = process received credentials internally | |
741 | * 1 = do not process received credentials; just pass them over | |
742 | * ctrl_iface to external program(s) | |
743 | * 2 = process received credentials internally and pass them over | |
744 | * ctrl_iface to external program(s) | |
745 | */ | |
746 | int wps_cred_processing; | |
c9c38b09 | 747 | |
e3768e7c JM |
748 | #define MAX_SEC_DEVICE_TYPES 5 |
749 | /** | |
2f646b6e | 750 | * sec_device_types - Secondary Device Types (P2P) |
e3768e7c | 751 | */ |
2f646b6e JB |
752 | u8 sec_device_type[MAX_SEC_DEVICE_TYPES][WPS_DEV_TYPE_LEN]; |
753 | int num_sec_device_types; | |
e3768e7c JM |
754 | |
755 | int p2p_listen_reg_class; | |
756 | int p2p_listen_channel; | |
757 | int p2p_oper_reg_class; | |
758 | int p2p_oper_channel; | |
759 | int p2p_go_intent; | |
760 | char *p2p_ssid_postfix; | |
761 | int persistent_reconnect; | |
0f66abd2 | 762 | int p2p_intra_bss; |
21d996f7 JM |
763 | unsigned int num_p2p_pref_chan; |
764 | struct p2p_channel *p2p_pref_chan; | |
556b30da | 765 | struct wpa_freq_range_list p2p_no_go_freq; |
51e9f228 | 766 | int p2p_add_cli_chan; |
b277a2be | 767 | int p2p_ignore_shared_freq; |
e3bd6e9d | 768 | int p2p_optimize_listen_chan; |
e3768e7c | 769 | |
71dd3b78 AS |
770 | struct wpabuf *wps_vendor_ext_m1; |
771 | ||
f95cac27 JMB |
772 | #define MAX_WPS_VENDOR_EXT 10 |
773 | /** | |
774 | * wps_vendor_ext - Vendor extension attributes in WPS | |
775 | */ | |
776 | struct wpabuf *wps_vendor_ext[MAX_WPS_VENDOR_EXT]; | |
777 | ||
3071e181 JM |
778 | /** |
779 | * p2p_group_idle - Maximum idle time in seconds for P2P group | |
780 | * | |
781 | * This value controls how long a P2P group is maintained after there | |
782 | * is no other members in the group. As a GO, this means no associated | |
783 | * stations in the group. As a P2P client, this means no GO seen in | |
784 | * scan results. The maximum idle time is specified in seconds with 0 | |
785 | * indicating no time limit, i.e., the P2P group remains in active | |
c8106615 JM |
786 | * state indefinitely until explicitly removed. As a P2P client, the |
787 | * maximum idle time of P2P_MAX_CLIENT_IDLE seconds is enforced, i.e., | |
788 | * this parameter is mainly meant for GO use and for P2P client, it can | |
5f482d55 JM |
789 | * only be used to reduce the default timeout to smaller value. A |
790 | * special value -1 can be used to configure immediate removal of the | |
791 | * group for P2P client role on any disconnection after the data | |
792 | * connection has been established. | |
3071e181 | 793 | */ |
5f482d55 | 794 | int p2p_group_idle; |
3071e181 | 795 | |
1a471ff0 IP |
796 | /** |
797 | * p2p_go_freq_change_policy - The GO frequency change policy | |
798 | * | |
799 | * This controls the behavior of the GO when there is a change in the | |
800 | * map of the currently used frequencies in case more than one channel | |
801 | * is supported. | |
802 | * | |
803 | * @P2P_GO_FREQ_MOVE_SCM: Prefer working in a single channel mode if | |
804 | * possible. In case the GO is the only interface using its frequency | |
805 | * and there are other station interfaces on other frequencies, the GO | |
806 | * will migrate to one of these frequencies. | |
807 | * | |
808 | * @P2P_GO_FREQ_MOVE_SCM_PEER_SUPPORTS: Same as P2P_GO_FREQ_MOVE_SCM, | |
809 | * but a transition is possible only in case one of the other used | |
810 | * frequencies is one of the frequencies in the intersection of the | |
811 | * frequency list of the local device and the peer device. | |
812 | * | |
813 | * @P2P_GO_FREQ_MOVE_STAY: Prefer to stay on the current frequency. | |
98b05081 AO |
814 | * |
815 | * @P2P_GO_FREQ_MOVE_SCM_ECSA: Same as | |
816 | * P2P_GO_FREQ_MOVE_SCM_PEER_SUPPORTS but a transition is possible only | |
817 | * if all the group members advertise eCSA support. | |
1a471ff0 IP |
818 | */ |
819 | enum { | |
820 | P2P_GO_FREQ_MOVE_SCM = 0, | |
821 | P2P_GO_FREQ_MOVE_SCM_PEER_SUPPORTS = 1, | |
822 | P2P_GO_FREQ_MOVE_STAY = 2, | |
98b05081 AO |
823 | P2P_GO_FREQ_MOVE_SCM_ECSA = 3, |
824 | P2P_GO_FREQ_MOVE_MAX = P2P_GO_FREQ_MOVE_SCM_ECSA, | |
1a471ff0 IP |
825 | } p2p_go_freq_change_policy; |
826 | ||
827 | #define DEFAULT_P2P_GO_FREQ_MOVE P2P_GO_FREQ_MOVE_STAY | |
828 | ||
1b928f96 JM |
829 | /** |
830 | * p2p_passphrase_len - Passphrase length (8..63) for P2P GO | |
831 | * | |
832 | * This parameter controls the length of the random passphrase that is | |
833 | * generated at the GO. | |
834 | */ | |
835 | unsigned int p2p_passphrase_len; | |
836 | ||
c9c38b09 JM |
837 | /** |
838 | * bss_max_count - Maximum number of BSS entries to keep in memory | |
839 | */ | |
840 | unsigned int bss_max_count; | |
3812464c | 841 | |
78633c37 SL |
842 | /** |
843 | * bss_expiration_age - BSS entry age after which it can be expired | |
844 | * | |
845 | * This value controls the time in seconds after which a BSS entry | |
846 | * gets removed if it has not been updated or is not in use. | |
847 | */ | |
848 | unsigned int bss_expiration_age; | |
849 | ||
850 | /** | |
851 | * bss_expiration_scan_count - Expire BSS after number of scans | |
852 | * | |
853 | * If the BSS entry has not been seen in this many scans, it will be | |
854 | * removed. A value of 1 means that entry is removed after the first | |
855 | * scan in which the BSSID is not seen. Larger values can be used | |
856 | * to avoid BSS entries disappearing if they are not visible in | |
857 | * every scan (e.g., low signal quality or interference). | |
858 | */ | |
859 | unsigned int bss_expiration_scan_count; | |
860 | ||
3812464c JM |
861 | /** |
862 | * filter_ssids - SSID-based scan result filtering | |
863 | * | |
864 | * 0 = do not filter scan results | |
865 | * 1 = only include configured SSIDs in scan results/BSS table | |
866 | */ | |
867 | int filter_ssids; | |
1d47214a | 868 | |
bf8d6d24 TP |
869 | /** |
870 | * filter_rssi - RSSI-based scan result filtering | |
871 | * | |
872 | * 0 = do not filter scan results | |
873 | * -n = filter scan results below -n dBm | |
874 | */ | |
875 | int filter_rssi; | |
876 | ||
dae608d5 JM |
877 | /** |
878 | * max_num_sta - Maximum number of STAs in an AP/P2P GO | |
879 | */ | |
880 | unsigned int max_num_sta; | |
881 | ||
19e20c14 DR |
882 | /** |
883 | * ap_isolate - Whether to use client isolation feature | |
884 | * | |
885 | * Client isolation can be used to prevent low-level bridging of | |
886 | * frames between associated stations in the BSS. By default, | |
887 | * this bridging is allowed (ap_isolate=0); except in P2P GO case, | |
888 | * where p2p_intra_bss parameter is used to determine whether to allow | |
889 | * intra-BSS forwarding (ap_isolate = !p2p_intra_bss). | |
890 | * | |
891 | * 0 = do not enable AP isolation | |
892 | * 1 = enable AP isolation | |
893 | */ | |
894 | int ap_isolate; | |
895 | ||
f5ffc348 BG |
896 | /** |
897 | * freq_list - Array of allowed scan frequencies or %NULL for all | |
898 | * | |
899 | * This is an optional zero-terminated array of frequencies in | |
900 | * megahertz (MHz) to allow for narrowing scanning range. | |
901 | */ | |
902 | int *freq_list; | |
903 | ||
6124e858 BG |
904 | /** |
905 | * scan_cur_freq - Whether to scan only the current channel | |
906 | * | |
907 | * If true, attempt to scan only the current channel if any other | |
908 | * VIFs on this radio are already associated on a particular channel. | |
909 | */ | |
910 | int scan_cur_freq; | |
911 | ||
1d47214a JM |
912 | /** |
913 | * changed_parameters - Bitmap of changed parameters since last update | |
914 | */ | |
915 | unsigned int changed_parameters; | |
0d7e5a3a JB |
916 | |
917 | /** | |
6e3726c0 | 918 | * disassoc_low_ack - Disassociate stations with massive packet loss |
0d7e5a3a JB |
919 | */ |
920 | int disassoc_low_ack; | |
46ee0427 JM |
921 | |
922 | /** | |
923 | * interworking - Whether Interworking (IEEE 802.11u) is enabled | |
924 | */ | |
925 | int interworking; | |
926 | ||
11540c0b JM |
927 | /** |
928 | * access_network_type - Access Network Type | |
929 | * | |
930 | * When Interworking is enabled, scans will be limited to APs that | |
931 | * advertise the specified Access Network Type (0..15; with 15 | |
932 | * indicating wildcard match). | |
933 | */ | |
934 | int access_network_type; | |
935 | ||
63bc0ab0 SD |
936 | /** |
937 | * go_interworking - Whether Interworking for P2P GO is enabled | |
938 | */ | |
939 | int go_interworking; | |
940 | ||
941 | /** | |
942 | * go_access_network_type - P2P GO Access Network Type | |
943 | * | |
944 | * This indicates which access network type to advertise if Interworking | |
945 | * is enabled for P2P GO. | |
946 | */ | |
947 | int go_access_network_type; | |
948 | ||
949 | /** | |
950 | * go_internet - Interworking: Internet connectivity (0 or 1) | |
951 | */ | |
952 | int go_internet; | |
953 | ||
954 | /** | |
955 | * go_venue_group - Interworking: Venue group | |
956 | */ | |
957 | int go_venue_group; | |
958 | ||
959 | /** | |
960 | * go_venue_type: Interworking: Venue type | |
961 | */ | |
962 | int go_venue_type; | |
963 | ||
46ee0427 JM |
964 | /** |
965 | * hessid - Homogenous ESS identifier | |
966 | * | |
967 | * If this is set (any octet is non-zero), scans will be used to | |
968 | * request response only from BSSes belonging to the specified | |
969 | * Homogeneous ESS. This is used only if interworking is enabled. | |
970 | */ | |
971 | u8 hessid[ETH_ALEN]; | |
1298c145 | 972 | |
66aadbd7 JK |
973 | /** |
974 | * hs20 - Hotspot 2.0 | |
975 | */ | |
976 | int hs20; | |
977 | ||
1298c145 WJL |
978 | /** |
979 | * pbc_in_m1 - AP mode WPS probing workaround for PBC with Windows 7 | |
980 | * | |
981 | * Windows 7 uses incorrect way of figuring out AP's WPS capabilities | |
982 | * by acting as a Registrar and using M1 from the AP. The config | |
983 | * methods attribute in that message is supposed to indicate only the | |
984 | * configuration method supported by the AP in Enrollee role, i.e., to | |
985 | * add an external Registrar. For that case, PBC shall not be used and | |
986 | * as such, the PushButton config method is removed from M1 by default. | |
987 | * If pbc_in_m1=1 is included in the configuration file, the PushButton | |
988 | * config method is left in M1 (if included in config_methods | |
989 | * parameter) to allow Windows 7 to use PBC instead of PIN (e.g., from | |
990 | * a label in the AP). | |
991 | */ | |
992 | int pbc_in_m1; | |
b0786fba TB |
993 | |
994 | /** | |
995 | * autoscan - Automatic scan parameters or %NULL if none | |
996 | * | |
997 | * This is an optional set of parameters for automatic scanning | |
998 | * within an interface in following format: | |
999 | * <autoscan module name>:<module parameters> | |
1000 | */ | |
1001 | char *autoscan; | |
3f2c8ba6 | 1002 | |
042ec551 JM |
1003 | /** |
1004 | * wps_nfc_pw_from_config - NFC Device Password was read from config | |
1005 | * | |
1006 | * This parameter can be determined whether the NFC Device Password was | |
1007 | * included in the configuration (1) or generated dynamically (0). Only | |
1008 | * the former case is re-written back to the configuration file. | |
1009 | */ | |
1010 | int wps_nfc_pw_from_config; | |
1011 | ||
3f2c8ba6 JM |
1012 | /** |
1013 | * wps_nfc_dev_pw_id - NFC Device Password ID for password token | |
1014 | */ | |
1015 | int wps_nfc_dev_pw_id; | |
1016 | ||
1017 | /** | |
1018 | * wps_nfc_dh_pubkey - NFC DH Public Key for password token | |
1019 | */ | |
1020 | struct wpabuf *wps_nfc_dh_pubkey; | |
1021 | ||
1022 | /** | |
ed2e61fe | 1023 | * wps_nfc_dh_privkey - NFC DH Private Key for password token |
3f2c8ba6 JM |
1024 | */ |
1025 | struct wpabuf *wps_nfc_dh_privkey; | |
1026 | ||
1027 | /** | |
ed2e61fe | 1028 | * wps_nfc_dev_pw - NFC Device Password for password token |
3f2c8ba6 JM |
1029 | */ |
1030 | struct wpabuf *wps_nfc_dev_pw; | |
306ae225 JM |
1031 | |
1032 | /** | |
1033 | * ext_password_backend - External password backend or %NULL if none | |
1034 | * | |
1035 | * format: <backend name>[:<optional backend parameters>] | |
1036 | */ | |
1037 | char *ext_password_backend; | |
462a7439 ES |
1038 | |
1039 | /* | |
1040 | * p2p_go_max_inactivity - Timeout in seconds to detect STA inactivity | |
1041 | * | |
1042 | * This timeout value is used in P2P GO mode to clean up | |
1043 | * inactive stations. | |
1044 | * By default: 300 seconds. | |
1045 | */ | |
1046 | int p2p_go_max_inactivity; | |
c26effe1 YD |
1047 | |
1048 | struct hostapd_wmm_ac_params wmm_ac_params[4]; | |
4d5bda5f JM |
1049 | |
1050 | /** | |
1051 | * auto_interworking - Whether to use network selection automatically | |
1052 | * | |
1053 | * 0 = do not automatically go through Interworking network selection | |
1054 | * (i.e., require explicit interworking_select command for this) | |
1055 | * 1 = perform Interworking network selection if one or more | |
1056 | * credentials have been configured and scan did not find a | |
1057 | * matching network block | |
1058 | */ | |
1059 | int auto_interworking; | |
a93a15bb AN |
1060 | |
1061 | /** | |
1062 | * p2p_go_ht40 - Default mode for HT40 enable when operating as GO. | |
1063 | * | |
1064 | * This will take effect for p2p_group_add, p2p_connect, and p2p_invite. | |
1065 | * Note that regulatory constraints and driver capabilities are | |
1066 | * consulted anyway, so setting it to 1 can't do real harm. | |
1067 | * By default: 0 (disabled) | |
1068 | */ | |
1069 | int p2p_go_ht40; | |
7a808c7e | 1070 | |
20ea1ca4 EP |
1071 | /** |
1072 | * p2p_go_vht - Default mode for VHT enable when operating as GO | |
1073 | * | |
1074 | * This will take effect for p2p_group_add, p2p_connect, and p2p_invite. | |
1075 | * Note that regulatory constraints and driver capabilities are | |
1076 | * consulted anyway, so setting it to 1 can't do real harm. | |
1077 | * By default: 0 (disabled) | |
1078 | */ | |
1079 | int p2p_go_vht; | |
1080 | ||
0b8bcaa5 EP |
1081 | /** |
1082 | * p2p_go_ctwindow - CTWindow to use when operating as GO | |
1083 | * | |
1084 | * By default: 0 (no CTWindow). Values 0-127 can be used to indicate | |
1085 | * the length of the CTWindow in TUs. | |
1086 | */ | |
1087 | int p2p_go_ctwindow; | |
1088 | ||
7a808c7e JM |
1089 | /** |
1090 | * p2p_disabled - Whether P2P operations are disabled for this interface | |
1091 | */ | |
1092 | int p2p_disabled; | |
d76cd41a JM |
1093 | |
1094 | /** | |
1095 | * p2p_no_group_iface - Whether group interfaces can be used | |
1096 | * | |
1097 | * By default, wpa_supplicant will create a separate interface for P2P | |
1098 | * group operations if the driver supports this. This functionality can | |
1099 | * be disabled by setting this parameter to 1. In that case, the same | |
1100 | * interface that was used for the P2P management operations is used | |
1101 | * also for the group operation. | |
1102 | */ | |
1103 | int p2p_no_group_iface; | |
6e202021 | 1104 | |
07c1e987 MS |
1105 | /** |
1106 | * p2p_cli_probe - Enable/disable P2P CLI probe request handling | |
1107 | * | |
1108 | * If this parameter is set to 1, a connected P2P Client will receive | |
1109 | * and handle Probe Request frames. Setting this parameter to 0 | |
1110 | * disables this option. Default value: 0. | |
1111 | * | |
1112 | * Note: Setting this property at run time takes effect on the following | |
1113 | * interface state transition to/from the WPA_COMPLETED state. | |
1114 | */ | |
1115 | int p2p_cli_probe; | |
1116 | ||
6e202021 JM |
1117 | /** |
1118 | * okc - Whether to enable opportunistic key caching by default | |
1119 | * | |
1120 | * By default, OKC is disabled unless enabled by the per-network | |
1121 | * proactive_key_caching=1 parameter. okc=1 can be used to change this | |
1122 | * default behavior. | |
1123 | */ | |
1124 | int okc; | |
62d49803 JM |
1125 | |
1126 | /** | |
1127 | * pmf - Whether to enable/require PMF by default | |
1128 | * | |
1129 | * By default, PMF is disabled unless enabled by the per-network | |
1130 | * ieee80211w=1 or ieee80211w=2 parameter. pmf=1/2 can be used to change | |
22950049 JM |
1131 | * this default behavior for RSN network (this is not applicable for |
1132 | * non-RSN cases). | |
62d49803 JM |
1133 | */ |
1134 | enum mfp_options pmf; | |
625f202a JM |
1135 | |
1136 | /** | |
1137 | * sae_groups - Preference list of enabled groups for SAE | |
1138 | * | |
1139 | * By default (if this parameter is not set), the mandatory group 19 | |
1140 | * (ECC group defined over a 256-bit prime order field) is preferred, | |
1141 | * but other groups are also enabled. If this parameter is set, the | |
1142 | * groups will be tried in the indicated order. | |
1143 | */ | |
1144 | int *sae_groups; | |
18206e02 JM |
1145 | |
1146 | /** | |
1147 | * dtim_period - Default DTIM period in Beacon intervals | |
1148 | * | |
1149 | * This parameter can be used to set the default value for network | |
1150 | * blocks that do not specify dtim_period. | |
1151 | */ | |
1152 | int dtim_period; | |
1153 | ||
1154 | /** | |
1155 | * beacon_int - Default Beacon interval in TU | |
1156 | * | |
1157 | * This parameter can be used to set the default value for network | |
1158 | * blocks that do not specify beacon_int. | |
1159 | */ | |
1160 | int beacon_int; | |
18a2eaab JM |
1161 | |
1162 | /** | |
1163 | * ap_vendor_elements: Vendor specific elements for Beacon/ProbeResp | |
1164 | * | |
1165 | * This parameter can be used to define additional vendor specific | |
1166 | * elements for Beacon and Probe Response frames in AP/P2P GO mode. The | |
1167 | * format for these element(s) is a hexdump of the raw information | |
1168 | * elements (id+len+payload for one or more elements). | |
1169 | */ | |
1170 | struct wpabuf *ap_vendor_elements; | |
4342326f JM |
1171 | |
1172 | /** | |
1173 | * ignore_old_scan_res - Ignore scan results older than request | |
1174 | * | |
1175 | * The driver may have a cache of scan results that makes it return | |
1176 | * information that is older than our scan trigger. This parameter can | |
1177 | * be used to configure such old information to be ignored instead of | |
1178 | * allowing it to update the internal BSS table. | |
1179 | */ | |
1180 | int ignore_old_scan_res; | |
4aa81868 SF |
1181 | |
1182 | /** | |
1183 | * sched_scan_interval - schedule scan interval | |
1184 | */ | |
1185 | unsigned int sched_scan_interval; | |
800d5872 | 1186 | |
d0330d57 PK |
1187 | /** |
1188 | * sched_scan_start_delay - Schedule scan start delay before first scan | |
1189 | * | |
1190 | * Delay (in seconds) before scheduling first scan plan cycle. The | |
1191 | * driver may ignore this parameter and start immediately (or at any | |
1192 | * other time), if this feature is not supported. | |
1193 | */ | |
1194 | unsigned int sched_scan_start_delay; | |
1195 | ||
800d5872 SD |
1196 | /** |
1197 | * tdls_external_control - External control for TDLS setup requests | |
1198 | * | |
1199 | * Enable TDLS mode where external programs are given the control | |
1200 | * to specify the TDLS link to get established to the driver. The | |
1201 | * driver requests the TDLS setup to the supplicant only for the | |
1202 | * specified TDLS peers. | |
1203 | */ | |
1204 | int tdls_external_control; | |
25ef8529 JM |
1205 | |
1206 | u8 ip_addr_go[4]; | |
1207 | u8 ip_addr_mask[4]; | |
1208 | u8 ip_addr_start[4]; | |
1209 | u8 ip_addr_end[4]; | |
b572df86 JM |
1210 | |
1211 | /** | |
1212 | * osu_dir - OSU provider information directory | |
1213 | * | |
1214 | * If set, allow FETCH_OSU control interface command to be used to fetch | |
1215 | * OSU provider information into all APs and store the results in this | |
1216 | * directory. | |
1217 | */ | |
1218 | char *osu_dir; | |
e4fa8b12 EP |
1219 | |
1220 | /** | |
1221 | * wowlan_triggers - Wake-on-WLAN triggers | |
1222 | * | |
1223 | * If set, these wowlan triggers will be configured. | |
1224 | */ | |
1225 | char *wowlan_triggers; | |
d3b20469 NS |
1226 | |
1227 | /** | |
1228 | * p2p_search_delay - Extra delay between concurrent search iterations | |
1229 | * | |
1230 | * Add extra delay (in milliseconds) between search iterations when | |
1231 | * there is a concurrent operation to make p2p_find friendlier to | |
1232 | * concurrent operations by avoiding it from taking 100% of radio | |
1233 | * resources. | |
1234 | */ | |
1235 | unsigned int p2p_search_delay; | |
c267753b JM |
1236 | |
1237 | /** | |
1238 | * mac_addr - MAC address policy default | |
1239 | * | |
1240 | * 0 = use permanent MAC address | |
1241 | * 1 = use random MAC address for each ESS connection | |
a313d17d | 1242 | * 2 = like 1, but maintain OUI (with local admin bit set) |
c267753b JM |
1243 | * |
1244 | * By default, permanent MAC address is used unless policy is changed by | |
1245 | * the per-network mac_addr parameter. Global mac_addr=1 can be used to | |
1246 | * change this default behavior. | |
1247 | */ | |
1248 | int mac_addr; | |
1249 | ||
1250 | /** | |
1251 | * rand_addr_lifetime - Lifetime of random MAC address in seconds | |
1252 | */ | |
1253 | unsigned int rand_addr_lifetime; | |
1254 | ||
1255 | /** | |
1256 | * preassoc_mac_addr - Pre-association MAC address policy | |
1257 | * | |
1258 | * 0 = use permanent MAC address | |
1259 | * 1 = use random MAC address | |
a313d17d | 1260 | * 2 = like 1, but maintain OUI (with local admin bit set) |
c267753b JM |
1261 | */ |
1262 | int preassoc_mac_addr; | |
b41f2684 CL |
1263 | |
1264 | /** | |
1265 | * key_mgmt_offload - Use key management offload | |
1266 | * | |
1267 | * Key management offload should be used if the device supports it. | |
1268 | * Key management offload is the capability of a device operating as | |
1269 | * a station to do the exchange necessary to establish temporal keys | |
1270 | * during initial RSN connection, after roaming, or during a PTK | |
1271 | * rekeying operation. | |
1272 | */ | |
1273 | int key_mgmt_offload; | |
e45e8989 TP |
1274 | |
1275 | /** | |
1276 | * user_mpm - MPM residency | |
1277 | * | |
1278 | * 0: MPM lives in driver. | |
1279 | * 1: wpa_supplicant handles peering and station allocation. | |
1280 | * | |
1281 | * If AMPE or SAE is enabled, the MPM is always in userspace. | |
1282 | */ | |
1283 | int user_mpm; | |
4b409368 MH |
1284 | |
1285 | /** | |
1286 | * max_peer_links - Maximum number of peer links | |
1287 | * | |
1288 | * Maximum number of mesh peering currently maintained by the STA. | |
1289 | */ | |
1290 | int max_peer_links; | |
483dd6a5 JM |
1291 | |
1292 | /** | |
1293 | * cert_in_cb - Whether to include a peer certificate dump in events | |
1294 | * | |
1295 | * This controls whether peer certificates for authentication server and | |
1296 | * its certificate chain are included in EAP peer certificate events. | |
1297 | */ | |
1298 | int cert_in_cb; | |
5a2a6de6 MH |
1299 | |
1300 | /** | |
1301 | * mesh_max_inactivity - Timeout in seconds to detect STA inactivity | |
1302 | * | |
1303 | * This timeout value is used in mesh STA to clean up inactive stations. | |
1304 | * By default: 300 seconds. | |
1305 | */ | |
1306 | int mesh_max_inactivity; | |
c35e35ed | 1307 | |
ecd40fef MH |
1308 | /** |
1309 | * dot11RSNASAERetransPeriod - Timeout to retransmit SAE Auth frame | |
1310 | * | |
1311 | * This timeout value is used in mesh STA to retransmit | |
1312 | * SAE Authentication frame. | |
1313 | * By default: 1000 milliseconds. | |
1314 | */ | |
1315 | int dot11RSNASAERetransPeriod; | |
1316 | ||
c35e35ed JM |
1317 | /** |
1318 | * passive_scan - Whether to force passive scan for network connection | |
1319 | * | |
1320 | * This parameter can be used to force only passive scanning to be used | |
1321 | * for network connection cases. It should be noted that this will slow | |
1322 | * down scan operations and reduce likelihood of finding the AP. In | |
1323 | * addition, some use cases will override this due to functional | |
1324 | * requirements, e.g., for finding an AP that uses hidden SSID | |
1325 | * (scan_ssid=1) or P2P device discovery. | |
1326 | */ | |
1327 | int passive_scan; | |
59b416c7 JM |
1328 | |
1329 | /** | |
1330 | * reassoc_same_bss_optim - Whether to optimize reassoc-to-same-BSS | |
1331 | */ | |
1332 | int reassoc_same_bss_optim; | |
94687a0a SD |
1333 | |
1334 | /** | |
1335 | * wps_priority - Priority for the networks added through WPS | |
1336 | * | |
1337 | * This priority value will be set to each network profile that is added | |
1338 | * by executing the WPS protocol. | |
1339 | */ | |
1340 | int wps_priority; | |
76ca15b7 AN |
1341 | |
1342 | /** | |
1343 | * fst_group_id - FST group ID | |
1344 | */ | |
1345 | char *fst_group_id; | |
1346 | ||
1347 | /** | |
1348 | * fst_priority - priority of the interface within the FST group | |
1349 | */ | |
1350 | int fst_priority; | |
1351 | ||
1352 | /** | |
1353 | * fst_llt - default FST LLT (Link-Lost Timeout) to be used for the | |
1354 | * interface. | |
1355 | */ | |
1356 | int fst_llt; | |
73ed03f3 MS |
1357 | |
1358 | /** | |
1359 | * wpa_rsc_relaxation - RSC relaxation on GTK installation | |
1360 | * | |
1361 | * Values: | |
1362 | * 0 - use the EAPOL-Key RSC value on GTK installation | |
1363 | * 1 - use the null RSC if a bogus RSC value is detected in message 3 | |
1364 | * of 4-Way Handshake or message 1 of Group Key Handshake. | |
1365 | */ | |
1366 | int wpa_rsc_relaxation; | |
32c02261 AS |
1367 | |
1368 | /** | |
1369 | * sched_scan_plans - Scan plans for scheduled scan | |
1370 | * | |
1371 | * Each scan plan specifies the interval between scans and the number of | |
1372 | * iterations. The last scan plan only specifies the scan interval and | |
1373 | * will be run infinitely. | |
1374 | * | |
1375 | * format: <interval:iterations> <interval2:iterations2> ... <interval> | |
1376 | */ | |
1377 | char *sched_scan_plans; | |
facf2c72 DS |
1378 | |
1379 | #ifdef CONFIG_MBO | |
1380 | /** | |
1381 | * non_pref_chan - Non-preferred channels list, separated by spaces. | |
1382 | * | |
1383 | * format: op_class:chan:preference:reason<:detail> | |
1384 | * Detail is optional. | |
1385 | */ | |
1386 | char *non_pref_chan; | |
c5d193d7 DS |
1387 | |
1388 | /** | |
1389 | * mbo_cell_capa - Cellular capabilities for MBO | |
1390 | */ | |
1391 | enum mbo_cellular_capa mbo_cell_capa; | |
af8bc24d KV |
1392 | |
1393 | /** | |
1394 | * disassoc_imminent_rssi_threshold - RSSI threshold of candidate AP | |
1395 | * when disassociation imminent is set. | |
1396 | */ | |
6d49aeb7 | 1397 | int disassoc_imminent_rssi_threshold; |
332aadb8 AP |
1398 | |
1399 | /** | |
1400 | * oce - Enable OCE in STA and/or STA-CFON mode | |
1401 | * - Set BIT(0) to enable OCE in non-AP STA mode | |
1402 | * - Set BIT(1) to enable OCE in STA-CFON mode | |
1403 | */ | |
1404 | unsigned int oce; | |
facf2c72 | 1405 | #endif /* CONFIG_MBO */ |
c86bef29 JM |
1406 | |
1407 | /** | |
1408 | * gas_address3 - GAS Address3 field behavior | |
1409 | * | |
1410 | * Values: | |
1411 | * 0 - P2P specification (Address3 = AP BSSID) | |
1412 | * 1 = IEEE 802.11 standard compliant (Address3 = Wildcard BSSID when | |
1413 | * sent to not-associated AP; if associated, AP BSSID) | |
1414 | */ | |
1415 | int gas_address3; | |
d1723c55 LD |
1416 | |
1417 | /** | |
1418 | * ftm_responder - Publish FTM (fine timing measurement) | |
1419 | * responder functionality | |
1420 | * | |
1421 | * Values: | |
1422 | * 0 - do not publish FTM responder functionality (Default) | |
1423 | * 1 - publish FTM responder functionality in | |
1424 | * bit 70 of Extended Capabilities element | |
1425 | * Note, actual FTM responder operation is managed outside | |
1426 | * wpa_supplicant. | |
1427 | */ | |
1428 | int ftm_responder; | |
1429 | ||
1430 | /** | |
1431 | * ftm_initiator - Publish FTM (fine timing measurement) | |
1432 | * initiator functionality | |
1433 | * | |
1434 | * Values: | |
1435 | * 0 - do not publish FTM initiator functionality (Default) | |
1436 | * 1 - publish FTM initiator functionality in | |
1437 | * bit 71 of Extended Capabilities element | |
1438 | * Note, actual FTM initiator operation is managed outside | |
1439 | * wpa_supplicant. | |
1440 | */ | |
1441 | int ftm_initiator; | |
1d9d21f3 VK |
1442 | |
1443 | /** | |
1444 | * gas_rand_addr_lifetime - Lifetime of random MAC address for ANQP in | |
1445 | * seconds | |
1446 | */ | |
1447 | unsigned int gas_rand_addr_lifetime; | |
1448 | ||
1449 | /** | |
1450 | * gas_rand_mac_addr - GAS MAC address policy | |
1451 | * | |
1452 | * 0 = use permanent MAC address | |
1453 | * 1 = use random MAC address | |
1454 | * 2 = like 1, but maintain OUI (with local admin bit set) | |
1455 | */ | |
1456 | int gas_rand_mac_addr; | |
8528994e JM |
1457 | |
1458 | /** | |
1459 | * dpp_config_processing - How to process DPP configuration | |
1460 | * | |
1461 | * 0 = report received configuration to an external program for | |
1462 | * processing; do not generate any network profile internally | |
1463 | * 1 = report received configuration to an external program and generate | |
1464 | * a network profile internally, but do not automatically connect | |
1465 | * to the created (disabled) profile; the network profile id is | |
1466 | * reported to external programs | |
1467 | * 2 = report received configuration to an external program, generate | |
1468 | * a network profile internally, try to connect to the created | |
1469 | * profile automatically | |
1470 | */ | |
1471 | int dpp_config_processing; | |
6fc6879b JM |
1472 | }; |
1473 | ||
1474 | ||
1475 | /* Prototypes for common functions from config.c */ | |
1476 | ||
1477 | void wpa_config_free(struct wpa_config *ssid); | |
1478 | void wpa_config_free_ssid(struct wpa_ssid *ssid); | |
7c49fdd0 SL |
1479 | void wpa_config_foreach_network(struct wpa_config *config, |
1480 | void (*func)(void *, struct wpa_ssid *), | |
1481 | void *arg); | |
6fc6879b JM |
1482 | struct wpa_ssid * wpa_config_get_network(struct wpa_config *config, int id); |
1483 | struct wpa_ssid * wpa_config_add_network(struct wpa_config *config); | |
1484 | int wpa_config_remove_network(struct wpa_config *config, int id); | |
1485 | void wpa_config_set_network_defaults(struct wpa_ssid *ssid); | |
1486 | int wpa_config_set(struct wpa_ssid *ssid, const char *var, const char *value, | |
1487 | int line); | |
67e1b984 JM |
1488 | int wpa_config_set_quoted(struct wpa_ssid *ssid, const char *var, |
1489 | const char *value); | |
10263dc2 OO |
1490 | int wpa_config_dump_values(struct wpa_config *config, char *buf, |
1491 | size_t buflen); | |
1492 | int wpa_config_get_value(const char *name, struct wpa_config *config, | |
1493 | char *buf, size_t buflen); | |
1494 | ||
3d3d3056 | 1495 | char ** wpa_config_get_all(struct wpa_ssid *ssid, int get_keys); |
6fc6879b JM |
1496 | char * wpa_config_get(struct wpa_ssid *ssid, const char *var); |
1497 | char * wpa_config_get_no_key(struct wpa_ssid *ssid, const char *var); | |
1498 | void wpa_config_update_psk(struct wpa_ssid *ssid); | |
1499 | int wpa_config_add_prio_network(struct wpa_config *config, | |
1500 | struct wpa_ssid *ssid); | |
aa53509f | 1501 | int wpa_config_update_prio_list(struct wpa_config *config); |
6fc6879b JM |
1502 | const struct wpa_config_blob * wpa_config_get_blob(struct wpa_config *config, |
1503 | const char *name); | |
1504 | void wpa_config_set_blob(struct wpa_config *config, | |
1505 | struct wpa_config_blob *blob); | |
1506 | void wpa_config_free_blob(struct wpa_config_blob *blob); | |
1507 | int wpa_config_remove_blob(struct wpa_config *config, const char *name); | |
d9bb2821 | 1508 | void wpa_config_flush_blobs(struct wpa_config *config); |
6fc6879b | 1509 | |
d94c9ee6 JM |
1510 | struct wpa_cred * wpa_config_get_cred(struct wpa_config *config, int id); |
1511 | struct wpa_cred * wpa_config_add_cred(struct wpa_config *config); | |
1512 | int wpa_config_remove_cred(struct wpa_config *config, int id); | |
1bb7b8e8 JM |
1513 | void wpa_config_free_cred(struct wpa_cred *cred); |
1514 | int wpa_config_set_cred(struct wpa_cred *cred, const char *var, | |
1515 | const char *value, int line); | |
c880ab87 | 1516 | char * wpa_config_get_cred_no_key(struct wpa_cred *cred, const char *var); |
1bb7b8e8 | 1517 | |
6fc6879b JM |
1518 | struct wpa_config * wpa_config_alloc_empty(const char *ctrl_interface, |
1519 | const char *driver_param); | |
1520 | #ifndef CONFIG_NO_STDOUT_DEBUG | |
1521 | void wpa_config_debug_dump_networks(struct wpa_config *config); | |
1522 | #else /* CONFIG_NO_STDOUT_DEBUG */ | |
1523 | #define wpa_config_debug_dump_networks(c) do { } while (0) | |
1524 | #endif /* CONFIG_NO_STDOUT_DEBUG */ | |
1525 | ||
1526 | ||
121adf9c JM |
1527 | /* Prototypes for common functions from config.c */ |
1528 | int wpa_config_process_global(struct wpa_config *config, char *pos, int line); | |
1529 | ||
e50c50d5 DW |
1530 | int wpa_config_get_num_global_field_names(void); |
1531 | ||
1532 | const char * wpa_config_get_global_field_name(unsigned int i, int *no_var); | |
121adf9c | 1533 | |
6fc6879b JM |
1534 | /* Prototypes for backend specific functions from the selected config_*.c */ |
1535 | ||
1536 | /** | |
1537 | * wpa_config_read - Read and parse configuration database | |
1538 | * @name: Name of the configuration (e.g., path and file name for the | |
1539 | * configuration file) | |
e6304cad | 1540 | * @cfgp: Pointer to previously allocated configuration data or %NULL if none |
6fc6879b JM |
1541 | * Returns: Pointer to allocated configuration data or %NULL on failure |
1542 | * | |
1543 | * This function reads configuration data, parses its contents, and allocates | |
1544 | * data structures needed for storing configuration information. The allocated | |
1545 | * data can be freed with wpa_config_free(). | |
1546 | * | |
1547 | * Each configuration backend needs to implement this function. | |
1548 | */ | |
e6304cad | 1549 | struct wpa_config * wpa_config_read(const char *name, struct wpa_config *cfgp); |
6fc6879b JM |
1550 | |
1551 | /** | |
1552 | * wpa_config_write - Write or update configuration data | |
1553 | * @name: Name of the configuration (e.g., path and file name for the | |
1554 | * configuration file) | |
1555 | * @config: Configuration data from wpa_config_read() | |
1556 | * Returns: 0 on success, -1 on failure | |
1557 | * | |
1558 | * This function write all configuration data into an external database (e.g., | |
1559 | * a text file) in a format that can be read with wpa_config_read(). This can | |
1560 | * be used to allow wpa_supplicant to update its configuration, e.g., when a | |
1561 | * new network is added or a password is changed. | |
1562 | * | |
1563 | * Each configuration backend needs to implement this function. | |
1564 | */ | |
1565 | int wpa_config_write(const char *name, struct wpa_config *config); | |
1566 | ||
1567 | #endif /* CONFIG_H */ |