wpa_config Struct Reference

wpa_supplicant configuration data More...

#include <config.h>

Collaboration diagram for wpa_config:

Collaboration graph
[legend]

Data Fields

wpa_ssidssid
 Head of the global network list.
wpa_ssid ** pssid
 Per-priority network lists (in priority order).
int num_prio
 Number of different priorities used in the pssid lists.
int eapol_version
 IEEE 802.1X/EAPOL version number.
int ap_scan
 AP scanning/selection.
char * ctrl_interface
 Directory for UNIX domain sockets.
int fast_reauth
 EAP fast re-authentication (session resumption).
char * opensc_engine_path
 Path to the OpenSSL engine for opensc.
char * pkcs11_engine_path
 Path to the OpenSSL engine for PKCS#11.
char * pkcs11_module_path
 Path to the OpenSSL OpenSC/PKCS#11 module.
char * driver_param
 Driver interface parameters.
unsigned int dot11RSNAConfigPMKLifetime
 Maximum lifetime of a PMK.
unsigned int dot11RSNAConfigPMKReauthThreshold
 PMK re-authentication threshold.
unsigned int dot11RSNAConfigSATimeout
 Security association timeout.
int update_config
 Is wpa_supplicant allowed to update configuration.
wpa_config_blobblobs
 Configuration blobs.

Detailed Description

wpa_supplicant configuration data

This data structure is presents the per-interface (radio) configuration data. In many cases, there is only one struct wpa_config instance, but if more than one network interface is being controlled, one instance is used for each.

Definition at line 75 of file config.h.


Field Documentation

int wpa_config::ap_scan
 

AP scanning/selection.

By default, wpa_supplicant requests driver to perform AP scanning and then uses the scan results to select a suitable AP. Another alternative is to allow the driver to take care of AP scanning and selection and use wpa_supplicant just to process EAPOL frames based on IEEE 802.11 association information from the driver.

1: wpa_supplicant initiates scanning and AP selection (default).

0: Driver takes care of scanning, AP selection, and IEEE 802.11 association parameters (e.g., WPA IE generation); this mode can also be used with non-WPA drivers when using IEEE 802.1X mode; do not try to associate with APs (i.e., external program needs to control association). This mode must also be used when using wired Ethernet drivers.

2: like 0, but associate with APs using security policy and SSID (but not BSSID); this can be used, e.g., with ndiswrapper and NDIS drivers to enable operation with hidden SSIDs and optimized roaming; in this mode, the network blocks in the configuration are tried one by one until the driver reports successful association; each network block should have explicit security policy (i.e., only one option in the lists) for key_mgmt, pairwise, group, proto variables.

Definition at line 140 of file config.h.

char* wpa_config::ctrl_interface
 

Directory for UNIX domain sockets.

This variable is used to configure where the UNIX domain sockets for the control interface are created. If UDP-based ctrl_iface is used, this variable can be set to any string (i.e., NULL is not allowed).

Definition at line 151 of file config.h.

unsigned int wpa_config::dot11RSNAConfigPMKLifetime
 

Maximum lifetime of a PMK.

dot11 MIB variable for the maximum lifetime of a PMK in the PMK cache (unit: seconds).

Definition at line 243 of file config.h.

unsigned int wpa_config::dot11RSNAConfigPMKReauthThreshold
 

PMK re-authentication threshold.

dot11 MIB variable for the percentage of the PMK lifetime that should expire before an IEEE 802.1X reauthentication occurs.

Definition at line 252 of file config.h.

unsigned int wpa_config::dot11RSNAConfigSATimeout
 

Security association timeout.

dot11 MIB variable for the maximum time a security association shall take to set up (unit: seconds).

Definition at line 261 of file config.h.

char* wpa_config::driver_param
 

Driver interface parameters.

This text string is passed to the selected driver interface with the optional struct wpa_driver_ops::set_param() handler. This can be used to configure driver specific options without having to add new driver interface functionality.

Definition at line 234 of file config.h.

int wpa_config::eapol_version
 

IEEE 802.1X/EAPOL version number.

wpa_supplicant is implemented based on IEEE Std 802.1X-2004 which defines EAPOL version 2. However, there are many APs that do not handle the new version number correctly (they seem to drop the frames completely). In order to make wpa_supplicant interoperate with these APs, the version number is set to 1 by default. This configuration value can be used to set it to the new version (2).

Definition at line 110 of file config.h.

int wpa_config::fast_reauth
 

EAP fast re-authentication (session resumption).

By default, fast re-authentication is enabled for all EAP methods that support it. This variable can be used to disable fast re-authentication (by setting fast_reauth=0). Normally, there is no need to disable fast re-authentication.

Definition at line 195 of file config.h.

int wpa_config::num_prio
 

Number of different priorities used in the pssid lists.

This indicates how many per-priority network lists are included in pssid.

Definition at line 97 of file config.h.

char* wpa_config::opensc_engine_path
 

Path to the OpenSSL engine for opensc.

This is an OpenSSL specific configuration option for loading OpenSC engine (engine_opensc.so); if NULL, this engine is not loaded.

Definition at line 204 of file config.h.

char* wpa_config::pkcs11_engine_path
 

Path to the OpenSSL engine for PKCS#11.

This is an OpenSSL specific configuration option for loading PKCS#11 engine (engine_pkcs11.so); if NULL, this engine is not loaded.

Definition at line 213 of file config.h.

char* wpa_config::pkcs11_module_path
 

Path to the OpenSSL OpenSC/PKCS#11 module.

This is an OpenSSL specific configuration option for configuring path to OpenSC/PKCS#11 engine (opensc-pkcs11.so); if NULL, this module is not loaded.

Definition at line 223 of file config.h.

struct wpa_ssid* wpa_config::ssid
 

Head of the global network list.

This is the head for the list of all the configured networks.

Definition at line 82 of file config.h.

int wpa_config::update_config
 

Is wpa_supplicant allowed to update configuration.

This variable control whether wpa_supplicant is allow to re-write its configuration with wpa_config_write(). If this is zero, configuration data is only changed in memory and the external data is not overriden. If this is non-zero, wpa_supplicant will update the configuration data (e.g., a file) whenever configuration is changed. This update may replace the old configuration which can remove comments from it in case of a text file configuration.

Definition at line 275 of file config.h.


The documentation for this struct was generated from the following file:
Generated on Sat May 6 21:20:21 2006 for wpa_supplicant by  doxygen 1.4.2