hostapd
Public Attributes | List of all members
wpa_driver_associate_params Struct Reference

struct wpa_driver_associate_params - Association parameters Data for struct wpa_driver_ops::associate(). More...

#include <driver.h>

Public Attributes

const u8 * bssid
 bssid - 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. More...
 
const u8 * bssid_hint
 bssid_hint - BSSID of a proposed AP More...
 
const u8 * ssid
 ssid - The selected SSID
 
size_t ssid_len
 ssid_len - Length of the SSID (1..32)
 
struct hostapd_freq_params freq
 freq - channel parameters
 
int freq_hint
 freq_hint - Frequency of the channel the proposed AP is using More...
 
int bg_scan_period
 bg_scan_period - Background scan period in seconds, 0 to disable background scan, or -1 to indicate no change to default driver configuration
 
int beacon_int
 beacon_int - Beacon interval for IBSS or 0 to use driver default
 
const u8 * wpa_ie
 wpa_ie - WPA information element for (Re)Association Request WPA information element to be included in (Re)Association Request (including information element id and length). More...
 
size_t wpa_ie_len
 wpa_ie_len - length of the wpa_ie
 
unsigned int wpa_proto
 wpa_proto - Bitfield of WPA_PROTO_* values to indicate WPA/WPA2
 
unsigned int pairwise_suite
 pairwise_suite - Selected pairwise cipher suite (WPA_CIPHER_*) More...
 
unsigned int group_suite
 group_suite - Selected group cipher suite (WPA_CIPHER_*) More...
 
unsigned int key_mgmt_suite
 key_mgmt_suite - Selected key management suite (WPA_KEY_MGMT_*) More...
 
int auth_alg
 auth_alg - Allowed authentication algorithms Bit field of WPA_AUTH_ALG_*
 
int mode
 mode - Operation mode (infra/ibss) IEEE80211_MODE_*
 
const u8 * wep_key [4]
 wep_key - WEP keys for static WEP configuration
 
size_t wep_key_len [4]
 wep_key_len - WEP key length for static WEP configuration
 
int wep_tx_keyidx
 wep_tx_keyidx - WEP TX key index for static WEP configuration
 
enum mfp_options mgmt_frame_protection
 mgmt_frame_protection - IEEE 802.11w management frame protection
 
const u8 * ft_ies
 ft_ies - 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. More...
 
size_t ft_ies_len
 ft_ies_len - Length of ft_ies in bytes
 
const u8 * ft_md
 ft_md - FT Mobility domain (6 octets) (also included inside ft_ies) More...
 
const char * passphrase
 passphrase - RSN passphrase for PSK More...
 
const u8 * psk
 psk - RSN PSK (alternative for passphrase for PSK) More...
 
int drop_unencrypted
 drop_unencrypted - Enable/disable unencrypted frame filtering More...
 
const u8 * prev_bssid
 prev_bssid - Previously used BSSID in this ESS More...
 
enum wps_mode wps
 wps - WPS mode More...
 
int p2p
 p2p - Whether this connection is a P2P group
 
int uapsd
 uapsd - 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
 
int fixed_bssid
 fixed_bssid - Whether to force this BSSID in IBSS mode 1 = Fix this BSSID and prevent merges. More...
 
int fixed_freq
 fixed_freq - Fix control channel in IBSS mode 0 = don't fix control channel (default) 1 = fix control channel; this prevents IBSS merging with another channel
 
int disable_ht
 disable_ht - Disable HT (IEEE 802.11n) for this connection
 
const u8 * htcaps
 htcaps - HT Capabilities over-rides More...
 
const u8 * htcaps_mask
 htcaps_mask - HT Capabilities over-rides mask More...
 
int req_key_mgmt_offload
 req_key_mgmt_offload - Request key management offload for connection More...
 
int rrm_used
 Flag for indicating whether this association includes support for RRM (Radio Resource Measurements)
 
int pbss
 pbss - If set, connect to a PCP in a PBSS. More...
 
const u8 * fils_kek
 fils_kek - KEK for FILS association frame protection (AES-SIV)
 
size_t fils_kek_len
 fils_kek_len: Length of fils_kek in bytes
 
const u8 * fils_nonces
 fils_nonces - Nonces for FILS association frame protection (AES-SIV AAD)
 
size_t fils_nonces_len
 fils_nonces_len: Length of fils_nonce in bytes
 

Detailed Description

struct wpa_driver_associate_params - Association parameters Data for struct wpa_driver_ops::associate().

Member Data Documentation

§ bssid

const u8* wpa_driver_associate_params::bssid

bssid - 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.

§ bssid_hint

const u8* wpa_driver_associate_params::bssid_hint

bssid_hint - BSSID of a proposed AP

This indicates which BSS has been found a suitable candidate for initial association for drivers that use driver/firmwate-based BSS selection. Unlike the parameter, does not limit the driver from selecting other BSSes in the ESS.

§ drop_unencrypted

int wpa_driver_associate_params::drop_unencrypted

drop_unencrypted - 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.

§ fixed_bssid

int wpa_driver_associate_params::fixed_bssid

fixed_bssid - Whether to force this BSSID in IBSS mode 1 = Fix this BSSID and prevent merges.

0 = Do not fix BSSID.

§ freq_hint

int wpa_driver_associate_params::freq_hint

freq_hint - Frequency of the channel the proposed AP is using

This provides a channel on which a suitable BSS has been found as a hint for the driver. Unlike the parameter, does not limit the driver from selecting other channels for driver/firmware-based BSS selection.

§ ft_ies

const u8* wpa_driver_associate_params::ft_ies

ft_ies - 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_md

const u8* wpa_driver_associate_params::ft_md

ft_md - 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.

§ group_suite

unsigned int wpa_driver_associate_params::group_suite

group_suite - Selected group cipher suite (WPA_CIPHER_*)

This is usually ignored if is used.

§ htcaps

const u8* wpa_driver_associate_params::htcaps

htcaps - 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.

Pointer to struct ieee80211_ht_capabilities.

§ htcaps_mask

const u8* wpa_driver_associate_params::htcaps_mask

htcaps_mask - HT Capabilities over-rides mask

Pointer to struct ieee80211_ht_capabilities.

§ key_mgmt_suite

unsigned int wpa_driver_associate_params::key_mgmt_suite

key_mgmt_suite - Selected key management suite (WPA_KEY_MGMT_*)

This is usually ignored if is used.

§ pairwise_suite

unsigned int wpa_driver_associate_params::pairwise_suite

pairwise_suite - Selected pairwise cipher suite (WPA_CIPHER_*)

This is usually ignored if is used.

§ passphrase

const char* wpa_driver_associate_params::passphrase

passphrase - 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.

§ pbss

int wpa_driver_associate_params::pbss

pbss - If set, connect to a PCP in a PBSS.

Otherwise, connect to an AP as usual. Valid for DMG network only.

§ prev_bssid

const u8* wpa_driver_associate_params::prev_bssid

prev_bssid - Previously used BSSID in this ESS

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

§ psk

const u8* wpa_driver_associate_params::psk

psk - 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.

§ req_key_mgmt_offload

int wpa_driver_associate_params::req_key_mgmt_offload

req_key_mgmt_offload - Request key management offload for connection

Request key management offload for this connection if the device supports it.

§ wpa_ie

const u8* wpa_driver_associate_params::wpa_ie

wpa_ie - 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

enum wps_mode wpa_driver_associate_params::wps

wps - 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: