|
wpa_supplicant / hostapd
2.5
|
|
wpa_supplicant / hostapd
2.5
|
Association parameters Data for struct wpa_driver_ops::associate(). More...
#include <driver.h>
Data Fields | |
| const u8 * | 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. | |
| const u8 * | bssid_hint |
| BSSID of a proposed AP. More... | |
| const u8 * | ssid |
| The selected SSID. | |
| size_t | ssid_len |
| Length of the SSID (1..32) | |
| struct hostapd_freq_params | freq |
| channel parameters | |
| int | freq_hint |
| Frequency of the channel the proposed AP is using. More... | |
| int | 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 interval for IBSS or 0 to use driver default. | |
| const u8 * | 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). More... | |
| size_t | wpa_ie_len |
| length of the wpa_ie | |
| unsigned int | wpa_proto |
| Bitfield of WPA_PROTO_* values to indicate WPA/WPA2. | |
| unsigned int | pairwise_suite |
| Selected pairwise cipher suite (WPA_CIPHER_*) More... | |
| unsigned int | group_suite |
| Selected group cipher suite (WPA_CIPHER_*) More... | |
| unsigned int | key_mgmt_suite |
| Selected key management suite (WPA_KEY_MGMT_*) More... | |
| int | auth_alg |
| Allowed authentication algorithms Bit field of WPA_AUTH_ALG_*. | |
| 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 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. More... | |
| 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) More... | |
| const char * | passphrase |
| RSN passphrase for PSK. More... | |
| const u8 * | psk |
| RSN PSK (alternative for passphrase for PSK) More... | |
| int | drop_unencrypted |
| Enable/disable unencrypted frame filtering. More... | |
| const u8 * | prev_bssid |
| Previously used BSSID in this ESS. More... | |
| enum wps_mode | wps |
| WPS mode. More... | |
| int | p2p |
| Whether this connection is a P2P group. | |
| int | 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 |
| Whether to force this BSSID in IBSS mode 1 = Fix this BSSID and prevent merges. 0 = Do not fix BSSID. | |
| int | 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 (IEEE 802.11n) for this connection. | |
| const u8 * | htcaps |
| HT Capabilities over-rides. More... | |
| const u8 * | htcaps_mask |
| HT Capabilities over-rides mask. More... | |
| int | 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) | |
Association parameters Data for struct wpa_driver_ops::associate().
| const u8* wpa_driver_associate_params::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 bssid parameter, bssid_hint does not limit the driver from selecting other BSSes in the ESS.
| int wpa_driver_associate_params::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.
| int wpa_driver_associate_params::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 freq parameter, freq_hint does not limit the driver from selecting other channels for driver/firmware-based BSS selection.
| const u8* wpa_driver_associate_params::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.
| const u8* wpa_driver_associate_params::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.
| unsigned int wpa_driver_associate_params::group_suite |
Selected group cipher suite (WPA_CIPHER_*)
This is usually ignored if wpa_ie is used.
| const u8* wpa_driver_associate_params::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.
| const u8* wpa_driver_associate_params::htcaps_mask |
HT Capabilities over-rides mask.
Pointer to struct ieee80211_ht_capabilities.
| unsigned int wpa_driver_associate_params::key_mgmt_suite |
Selected key management suite (WPA_KEY_MGMT_*)
This is usually ignored if wpa_ie is used.
| unsigned int wpa_driver_associate_params::pairwise_suite |
Selected pairwise cipher suite (WPA_CIPHER_*)
This is usually ignored if wpa_ie is used.
| const char* wpa_driver_associate_params::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.
| const u8* wpa_driver_associate_params::prev_bssid |
Previously used BSSID in this ESS.
When not NULL, this is a request to use reassociation instead of association.
| const u8* wpa_driver_associate_params::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.
| int wpa_driver_associate_params::req_key_mgmt_offload |
Request key management offload for connection.
Request key management offload for this connection if the device supports it.
| const u8* wpa_driver_associate_params::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.
| enum wps_mode wpa_driver_associate_params::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.
1.8.6
