config.h 47 KB

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