wpa_supplicant / hostapd 2.0
Data Fields

wpa_driver_associate_params Struct Reference

Association parameters. More...

#include <driver.h>

Data Fields

const u8 * bssid
 BSSID of the selected AP.
const u8 * ssid
 The selected SSID.
size_t ssid_len
 Length of the SSID (1..32)
int freq
 Frequency of the channel the selected AP is using.
int bg_scan_period
 Background scan period in seconds, 0 to disable.
const u8 * wpa_ie
 WPA information element for (Re)Association Request.
size_t wpa_ie_len
 length of the wpa_ie
unsigned int wpa_proto
 Bitfield of WPA_PROTO_* values to indicate WPA/WPA2.
enum wpa_cipher pairwise_suite
 Selected pairwise cipher suite.
enum wpa_cipher group_suite
 Selected group cipher suite.
enum wpa_key_mgmt key_mgmt_suite
 Selected key management suite.
int auth_alg
 Allowed authentication algorithms.
int mode
 Operation mode (infra/ibss) IEEE80211_MODE_*.
const u8 * wep_key [4]
 WEP keys for static WEP configuration.
size_t wep_key_len [4]
 WEP key length for static WEP configuration.
int wep_tx_keyidx
 WEP TX key index for static WEP configuration.
enum mfp_options mgmt_frame_protection
 IEEE 802.11w management frame protection.
const u8 * ft_ies
 IEEE 802.11r / FT information elements.
size_t ft_ies_len
 Length of ft_ies in bytes.
const u8 * ft_md
 FT Mobility domain (6 octets) (also included inside ft_ies)
const char * passphrase
 RSN passphrase for PSK.
const u8 * psk
 RSN PSK (alternative for passphrase for PSK)
int drop_unencrypted
 Enable/disable unencrypted frame filtering.
const u8 * prev_bssid
 Previously used BSSID in this ESS.
enum wps_mode wps
 WPS mode.
int p2p
 Whether this connection is a P2P group.
int uapsd
 UAPSD parameters for the network.
int fixed_bssid
 Whether to force this BSSID in IBSS mode.
int disable_ht
 Disable HT (IEEE 802.11n) for this connection.
const u8 * htcaps
const u8 * htcaps_mask

Detailed Description

Association parameters.

Data for struct wpa_driver_ops::associate().


Field Documentation

Allowed authentication algorithms.

Bit field of WPA_AUTH_ALG_*

Background scan period in seconds, 0 to disable.

background scan, or -1 to indicate no change to default driver configuration

BSSID of the selected AP.

This can be NULL, if ap_scan=2 mode is used and the driver is responsible for selecting with which BSS to associate.

Enable/disable unencrypted frame filtering.

Configure the driver to drop all non-EAPOL frames (both receive and transmit paths). Unencrypted EAPOL frames (ethertype 0x888e) must still be allowed for key negotiation.

Whether to force this BSSID in IBSS mode.

1 = Fix this BSSID and prevent merges. 0 = Do not fix BSSID.

Frequency of the channel the selected AP is using.

Frequency that the selected AP is using (in MHz as reported in the scan results)

IEEE 802.11r / FT information elements.

If the supplicant is using IEEE 802.11r (FT) and has the needed keys for fast transition, this parameter is set to include the IEs that are to be sent in the next FT Authentication Request message. update_ft_ies() handler is called to update the IEs for further FT messages in the sequence.

The driver should use these IEs only if the target AP is advertising the same mobility domain as the one included in the MDIE here.

In ap_scan=2 mode, the driver can use these IEs when moving to a new AP after the initial association. These IEs can only be used if the target AP is advertising support for FT and is using the same MDIE and SSID as the current AP.

The driver is responsible for reporting the FT IEs received from the AP's response using wpa_supplicant_event() with EVENT_FT_RESPONSE type. update_ft_ies() handler will then be called with the FT IEs to include in the next frame in the authentication sequence.

FT Mobility domain (6 octets) (also included inside ft_ies)

This value is provided to allow the driver interface easier access to the current mobility domain. This value is set to NULL if no mobility domain is currently active.

Selected group cipher suite.

This is usually ignored if is used.

HT Capabilities over-rides. Only bits set in the mask will be used, and not all values are used by the kernel anyway. Currently, MCS, MPDU and MSDU fields are used.

Selected key management suite.

This is usually ignored if is used.

Selected pairwise cipher suite.

This is usually ignored if is used.

RSN passphrase for PSK.

This value is made available only for WPA/WPA2-Personal (PSK) and only for drivers that set WPA_DRIVER_FLAGS_4WAY_HANDSHAKE. This is the 8..63 character ASCII passphrase, if available. Please note that this can be NULL if passphrase was not used to generate the PSK. In that case, the psk field must be used to fetch the PSK.

Previously used BSSID in this ESS.

When not NULL, this is a request to use reassociation instead of association.

RSN PSK (alternative for passphrase for PSK)

This value is made available only for WPA/WPA2-Personal (PSK) and only for drivers that set WPA_DRIVER_FLAGS_4WAY_HANDSHAKE. This is the 32-octet (256-bit) PSK, if available. The driver wrapper should be prepared to handle NULL value as an error.

UAPSD parameters for the network.

-1 = do not change defaults AP mode: 1 = enabled, 0 = disabled STA mode: bits 0..3 UAPSD enabled for VO,VI,BK,BE

WPA information element for (Re)Association Request.

WPA information element to be included in (Re)Association Request (including information element id and length). Use of this WPA IE is optional. If the driver generates the WPA IE, it can use pairwise_suite, group_suite, and key_mgmt_suite to select proper algorithms. In this case, the driver has to notify wpa_supplicant about the used WPA IE by generating an event that the interface code will convert into EVENT_ASSOCINFO data (see below).

When using WPA2/IEEE 802.11i, wpa_ie is used for RSN IE instead. The driver can determine which version is used by looking at the first byte of the IE (0xdd for WPA, 0x30 for WPA2/RSN).

When using WPS, wpa_ie is used for WPS IE instead of WPA/RSN IE.

WPS mode.

If the driver needs to do special configuration for WPS association, this variable provides more information on what type of association is being requested. Most drivers should not need ot use this.


The documentation for this struct was generated from the following file:
 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Defines