mirror of
https://git.kernel.org/pub/scm/linux/kernel/git/stable/linux.git
synced 2024-09-28 21:33:52 +00:00
cfg80211: Improve Connect/Associate command documentation
The roaming cases for the Connect command were not fully covered and neither Connect nor Associate command uses of the prev_bssid parameter were very clear. Add details to describe how the prev_bssid argument is supposed to be used and when the driver should use association or reassociation. Signed-off-by: Jouni Malinen <jouni@qca.qualcomm.com> Signed-off-by: Johannes Berg <johannes.berg@intel.com>
This commit is contained in:
parent
bddf59046d
commit
35eb8f7b1a
2 changed files with 36 additions and 6 deletions
|
@ -1750,7 +1750,12 @@ enum cfg80211_assoc_req_flags {
|
||||||
* @ie_len: Length of ie buffer in octets
|
* @ie_len: Length of ie buffer in octets
|
||||||
* @use_mfp: Use management frame protection (IEEE 802.11w) in this association
|
* @use_mfp: Use management frame protection (IEEE 802.11w) in this association
|
||||||
* @crypto: crypto settings
|
* @crypto: crypto settings
|
||||||
* @prev_bssid: previous BSSID, if not %NULL use reassociate frame
|
* @prev_bssid: previous BSSID, if not %NULL use reassociate frame. This is used
|
||||||
|
* to indicate a request to reassociate within the ESS instead of a request
|
||||||
|
* do the initial association with the ESS. When included, this is set to
|
||||||
|
* the BSSID of the current association, i.e., to the value that is
|
||||||
|
* included in the Current AP address field of the Reassociation Request
|
||||||
|
* frame.
|
||||||
* @flags: See &enum cfg80211_assoc_req_flags
|
* @flags: See &enum cfg80211_assoc_req_flags
|
||||||
* @ht_capa: HT Capabilities over-rides. Values set in ht_capa_mask
|
* @ht_capa: HT Capabilities over-rides. Values set in ht_capa_mask
|
||||||
* will be used in ht_capa. Un-supported values will be ignored.
|
* will be used in ht_capa. Un-supported values will be ignored.
|
||||||
|
@ -1925,7 +1930,12 @@ struct cfg80211_bss_selection {
|
||||||
* @pbss: if set, connect to a PCP instead of AP. Valid for DMG
|
* @pbss: if set, connect to a PCP instead of AP. Valid for DMG
|
||||||
* networks.
|
* networks.
|
||||||
* @bss_select: criteria to be used for BSS selection.
|
* @bss_select: criteria to be used for BSS selection.
|
||||||
* @prev_bssid: previous BSSID, if not %NULL use reassociate frame
|
* @prev_bssid: previous BSSID, if not %NULL use reassociate frame. This is used
|
||||||
|
* to indicate a request to reassociate within the ESS instead of a request
|
||||||
|
* do the initial association with the ESS. When included, this is set to
|
||||||
|
* the BSSID of the current association, i.e., to the value that is
|
||||||
|
* included in the Current AP address field of the Reassociation Request
|
||||||
|
* frame.
|
||||||
*/
|
*/
|
||||||
struct cfg80211_connect_params {
|
struct cfg80211_connect_params {
|
||||||
struct ieee80211_channel *channel;
|
struct ieee80211_channel *channel;
|
||||||
|
@ -2377,7 +2387,17 @@ struct cfg80211_qos_map {
|
||||||
* @connect: Connect to the ESS with the specified parameters. When connected,
|
* @connect: Connect to the ESS with the specified parameters. When connected,
|
||||||
* call cfg80211_connect_result() with status code %WLAN_STATUS_SUCCESS.
|
* call cfg80211_connect_result() with status code %WLAN_STATUS_SUCCESS.
|
||||||
* If the connection fails for some reason, call cfg80211_connect_result()
|
* If the connection fails for some reason, call cfg80211_connect_result()
|
||||||
* with the status from the AP.
|
* with the status from the AP. The driver is allowed to roam to other
|
||||||
|
* BSSes within the ESS when the other BSS matches the connect parameters.
|
||||||
|
* When such roaming is initiated by the driver, the driver is expected to
|
||||||
|
* verify that the target matches the configured security parameters and
|
||||||
|
* to use Reassociation Request frame instead of Association Request frame.
|
||||||
|
* The connect function can also be used to request the driver to perform
|
||||||
|
* a specific roam when connected to an ESS. In that case, the prev_bssid
|
||||||
|
* parameter is set to the BSSID of the currently associated BSS as an
|
||||||
|
* indication of requesting reassociation. In both the driver-initiated and
|
||||||
|
* new connect() call initiated roaming cases, the result of roaming is
|
||||||
|
* indicated with a call to cfg80211_roamed() or cfg80211_roamed_bss().
|
||||||
* (invoked with the wireless_dev mutex held)
|
* (invoked with the wireless_dev mutex held)
|
||||||
* @disconnect: Disconnect from the BSS/ESS.
|
* @disconnect: Disconnect from the BSS/ESS.
|
||||||
* (invoked with the wireless_dev mutex held)
|
* (invoked with the wireless_dev mutex held)
|
||||||
|
|
|
@ -429,7 +429,11 @@
|
||||||
* @NL80211_CMD_ASSOCIATE: association request and notification; like
|
* @NL80211_CMD_ASSOCIATE: association request and notification; like
|
||||||
* NL80211_CMD_AUTHENTICATE but for Association and Reassociation
|
* NL80211_CMD_AUTHENTICATE but for Association and Reassociation
|
||||||
* (similar to MLME-ASSOCIATE.request, MLME-REASSOCIATE.request,
|
* (similar to MLME-ASSOCIATE.request, MLME-REASSOCIATE.request,
|
||||||
* MLME-ASSOCIATE.confirm or MLME-REASSOCIATE.confirm primitives).
|
* MLME-ASSOCIATE.confirm or MLME-REASSOCIATE.confirm primitives). The
|
||||||
|
* %NL80211_ATTR_PREV_BSSID attribute is used to specify whether the
|
||||||
|
* request is for the initial association to an ESS (that attribute not
|
||||||
|
* included) or for reassociation within the ESS (that attribute is
|
||||||
|
* included).
|
||||||
* @NL80211_CMD_DEAUTHENTICATE: deauthentication request and notification; like
|
* @NL80211_CMD_DEAUTHENTICATE: deauthentication request and notification; like
|
||||||
* NL80211_CMD_AUTHENTICATE but for Deauthentication frames (similar to
|
* NL80211_CMD_AUTHENTICATE but for Deauthentication frames (similar to
|
||||||
* MLME-DEAUTHENTICATION.request and MLME-DEAUTHENTICATE.indication
|
* MLME-DEAUTHENTICATION.request and MLME-DEAUTHENTICATE.indication
|
||||||
|
@ -479,6 +483,9 @@
|
||||||
* set of BSSID,frequency parameters is used (i.e., either the enforcing
|
* set of BSSID,frequency parameters is used (i.e., either the enforcing
|
||||||
* %NL80211_ATTR_MAC,%NL80211_ATTR_WIPHY_FREQ or the less strict
|
* %NL80211_ATTR_MAC,%NL80211_ATTR_WIPHY_FREQ or the less strict
|
||||||
* %NL80211_ATTR_MAC_HINT and %NL80211_ATTR_WIPHY_FREQ_HINT).
|
* %NL80211_ATTR_MAC_HINT and %NL80211_ATTR_WIPHY_FREQ_HINT).
|
||||||
|
* %NL80211_ATTR_PREV_BSSID can be used to request a reassociation within
|
||||||
|
* the ESS in case the device is already associated and an association with
|
||||||
|
* a different BSS is desired.
|
||||||
* Background scan period can optionally be
|
* Background scan period can optionally be
|
||||||
* specified in %NL80211_ATTR_BG_SCAN_PERIOD,
|
* specified in %NL80211_ATTR_BG_SCAN_PERIOD,
|
||||||
* if not specified default background scan configuration
|
* if not specified default background scan configuration
|
||||||
|
@ -1287,8 +1294,11 @@ enum nl80211_commands {
|
||||||
* @NL80211_ATTR_RESP_IE: (Re)association response information elements as
|
* @NL80211_ATTR_RESP_IE: (Re)association response information elements as
|
||||||
* sent by peer, for ROAM and successful CONNECT events.
|
* sent by peer, for ROAM and successful CONNECT events.
|
||||||
*
|
*
|
||||||
* @NL80211_ATTR_PREV_BSSID: previous BSSID, to be used by in ASSOCIATE
|
* @NL80211_ATTR_PREV_BSSID: previous BSSID, to be used in ASSOCIATE and CONNECT
|
||||||
* commands to specify using a reassociate frame
|
* commands to specify a request to reassociate within an ESS, i.e., to use
|
||||||
|
* Reassociate Request frame (with the value of this attribute in the
|
||||||
|
* Current AP address field) instead of Association Request frame which is
|
||||||
|
* used for the initial association to an ESS.
|
||||||
*
|
*
|
||||||
* @NL80211_ATTR_KEY: key information in a nested attribute with
|
* @NL80211_ATTR_KEY: key information in a nested attribute with
|
||||||
* %NL80211_KEY_* sub-attributes
|
* %NL80211_KEY_* sub-attributes
|
||||||
|
|
Loading…
Reference in a new issue