History

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.

Jouni Malinen committed 10 years ago

Commit 35eb8f71 parent bddf5902 files · +36 −6Browse files

Showing the changes to include/uapi (1 of 2 files). Show all

Unified · Split

include/uapi/linux/nl80211.h+13−3
@@ -429,7 +429,11 @@ · 428 unmodified lines
429 * @NL80211_CMD_ASSOCIATE: association request and notification; like429 * @NL80211_CMD_ASSOCIATE: association request and notification; like
430 * NL80211_CMD_AUTHENTICATE but for Association and Reassociation430 * NL80211_CMD_AUTHENTICATE but for Association and Reassociation
431 * (similar to MLME-ASSOCIATE.request, MLME-REASSOCIATE.request,431 * (similar to MLME-ASSOCIATE.request, MLME-REASSOCIATE.request,
432 * MLME-ASSOCIATE.confirm or MLME-REASSOCIATE.confirm primitives).432 * MLME-ASSOCIATE.confirm or MLME-REASSOCIATE.confirm primitives). The
433 * %NL80211_ATTR_PREV_BSSID attribute is used to specify whether the
434 * request is for the initial association to an ESS (that attribute not
435 * included) or for reassociation within the ESS (that attribute is
436 * included).
433 * @NL80211_CMD_DEAUTHENTICATE: deauthentication request and notification; like437 * @NL80211_CMD_DEAUTHENTICATE: deauthentication request and notification; like
434 * NL80211_CMD_AUTHENTICATE but for Deauthentication frames (similar to438 * NL80211_CMD_AUTHENTICATE but for Deauthentication frames (similar to
435 * MLME-DEAUTHENTICATION.request and MLME-DEAUTHENTICATE.indication439 * MLME-DEAUTHENTICATION.request and MLME-DEAUTHENTICATE.indication
@@ -479,6 +483,9 @@ · 43 unmodified lines
479 * set of BSSID,frequency parameters is used (i.e., either the enforcing483 * set of BSSID,frequency parameters is used (i.e., either the enforcing
480 * %NL80211_ATTR_MAC,%NL80211_ATTR_WIPHY_FREQ or the less strict484 * %NL80211_ATTR_MAC,%NL80211_ATTR_WIPHY_FREQ or the less strict
481 * %NL80211_ATTR_MAC_HINT and %NL80211_ATTR_WIPHY_FREQ_HINT).485 * %NL80211_ATTR_MAC_HINT and %NL80211_ATTR_WIPHY_FREQ_HINT).
486 * %NL80211_ATTR_PREV_BSSID can be used to request a reassociation within
487 * the ESS in case the device is already associated and an association with
488 * a different BSS is desired.
482 * Background scan period can optionally be489 * Background scan period can optionally be
483 * specified in %NL80211_ATTR_BG_SCAN_PERIOD,490 * specified in %NL80211_ATTR_BG_SCAN_PERIOD,
484 * if not specified default background scan configuration491 * if not specified default background scan configuration
@@ -1287,8 +1294,11 @@ enum nl80211_commands { · 802 unmodified lines
1287 * @NL80211_ATTR_RESP_IE: (Re)association response information elements as1294 * @NL80211_ATTR_RESP_IE: (Re)association response information elements as
1288 * sent by peer, for ROAM and successful CONNECT events.1295 * sent by peer, for ROAM and successful CONNECT events.
1289 *1296 *
1290 * @NL80211_ATTR_PREV_BSSID: previous BSSID, to be used by in ASSOCIATE1297 * @NL80211_ATTR_PREV_BSSID: previous BSSID, to be used in ASSOCIATE and CONNECT
1291 * commands to specify using a reassociate frame1298 * commands to specify a request to reassociate within an ESS, i.e., to use
1299 * Reassociate Request frame (with the value of this attribute in the
1300 * Current AP address field) instead of Association Request frame which is
1301 * used for the initial association to an ESS.
1292 *1302 *
1293 * @NL80211_ATTR_KEY: key information in a nested attribute with1303 * @NL80211_ATTR_KEY: key information in a nested attribute with
1294 * %NL80211_KEY_* sub-attributes1304 * %NL80211_KEY_* sub-attributes

Keyboard shortcuts

General

Show keyboard shortcuts
?
Focus the current search
/

Issues and pull requests

Open filters
f

Issues, pull requests and Inbox

Select next item
j↓
Select previous item
k↑
Open selected item
Enter
Dismiss filters or clear selection
Esc

Repository code

Go to file
t