Commit 30db641e authored by Johannes Berg's avatar Johannes Berg
Browse files

cfg80211: clarify LCI/civic location documentation 



The older code and current userspace assumed that this data
is the content of the Measurement Report element, starting
with the Measurement Token. Clarify this in the documentation.

Signed-off-by: default avatarJohannes Berg <johannes.berg@intel.com>
parent 554be833

include/net/cfg80211.h

+4 −2
Original line number Diff line number Diff line
@@ -777,8 +777,10 @@ struct cfg80211_crypto_settings { 
 * @probe_resp: probe response template (AP mode only)

 * @ftm_responder: enable FTM responder functionality; -1 for no change

 *	(which also implies no change in LCI/civic location data)

 * @lci: LCI subelement content

 * @civicloc: Civic location subelement content

 * @lci: Measurement Report element content, starting with Measurement Token

 *	(measurement type 8)

 * @civicloc: Measurement Report element content, starting with Measurement

 *	Token (measurement type 11)

 * @lci_len: LCI data length

 * @civicloc_len: Civic location data length

 */

include/uapi/linux/nl80211.h

+12 −4
Original line number Diff line number Diff line
@@ -5893,9 +5893,11 @@ enum nl80211_external_auth_action { 
 * @__NL80211_FTM_RESP_ATTR_INVALID: Invalid

 * @NL80211_FTM_RESP_ATTR_ENABLED: FTM responder is enabled

 * @NL80211_FTM_RESP_ATTR_LCI: The content of Measurement Report Element

 *	(9.4.2.22 in 802.11-2016) with type 8 - LCI (9.4.2.22.10)

 *	(9.4.2.22 in 802.11-2016) with type 8 - LCI (9.4.2.22.10),

 *	i.e. starting with the measurement token

 * @NL80211_FTM_RESP_ATTR_CIVIC: The content of Measurement Report Element

 *	(9.4.2.22 in 802.11-2016) with type 11 - Civic (Section 9.4.2.22.13)

 *	(9.4.2.22 in 802.11-2016) with type 11 - Civic (Section 9.4.2.22.13),

 *	i.e. starting with the measurement token

 * @__NL80211_FTM_RESP_ATTR_LAST: Internal

 * @NL80211_FTM_RESP_ATTR_MAX: highest FTM responder attribute.

 */
@@ -6295,9 +6297,15 @@ enum nl80211_peer_measurement_ftm_failure_reasons { 
 * @NL80211_PMSR_FTM_RESP_ATTR_DIST_VARIANCE: distance variance (u64, mm^2, note

 *	that standard deviation is the square root of variance, optional)

 * @NL80211_PMSR_FTM_RESP_ATTR_DIST_SPREAD: distance spread (u64, mm, optional)

 * @NL80211_PMSR_FTM_RESP_ATTR_LCI: LCI data from peer (binary, optional)

 * @NL80211_PMSR_FTM_RESP_ATTR_LCI: LCI data from peer (binary, optional);

 *	this is the contents of the Measurement Report Element (802.11-2016

 *	9.4.2.22.1) starting with the Measurement Token, with Measurement

 *	Type 8.

 * @NL80211_PMSR_FTM_RESP_ATTR_CIVICLOC: civic location data from peer

 *	(binary, optional)

 *	(binary, optional);

 *	this is the contents of the Measurement Report Element (802.11-2016

 *	9.4.2.22.1) starting with the Measurement Token, with Measurement

 *	Type 11.

 * @NL80211_PMSR_FTM_RESP_ATTR_PAD: ignore, for u64/s64 padding only

 *

 * @NUM_NL80211_PMSR_FTM_RESP_ATTR: internal