diff mbox series

[1/1] wifi: nl80211: Documentation update for NL80211_CMD_PORT_AUTHORIZED event

Message ID f746b59f41436e9df29c24688035fbc6eb91ab06.1699510229.git.vinayak.yadawad@broadcom.com (mailing list archive)
State Accepted
Delegated to: Johannes Berg
Headers show
Series [1/1] wifi: nl80211: Documentation update for NL80211_CMD_PORT_AUTHORIZED event | expand

Commit Message

Vinayak Yadawad Nov. 9, 2023, 6:33 a.m. UTC
Drivers supporting 4 way handshake offload for AP/GO and STA/GC
should use this event to indicate that port has been authorized and
open for regular data traffic. 4way handshake offload enabled
drivers should send this event on completion of successful 4way
handshake.

Signed-off-by: Vinayak Yadawad <vinayak.yadawad@broadcom.com>
---
 include/uapi/linux/nl80211.h | 13 ++++++++-----
 1 file changed, 8 insertions(+), 5 deletions(-)
diff mbox series

Patch

diff --git a/include/uapi/linux/nl80211.h b/include/uapi/linux/nl80211.h
index dced2c49daec..e8d8ffc802a4 100644
--- a/include/uapi/linux/nl80211.h
+++ b/include/uapi/linux/nl80211.h
@@ -1135,11 +1135,14 @@ 
  * @NL80211_CMD_DEL_PMK: For offloaded 4-Way handshake, delete the previously
  *	configured PMK for the authenticator address identified by
  *	%NL80211_ATTR_MAC.
- * @NL80211_CMD_PORT_AUTHORIZED: An event that indicates an 802.1X FT roam was
- *	completed successfully. Drivers that support 4 way handshake offload
- *	should send this event after indicating 802.1X FT assocation with
- *	%NL80211_CMD_ROAM. If the 4 way handshake failed %NL80211_CMD_DISCONNECT
- *	should be indicated instead.
+ * @NL80211_CMD_PORT_AUTHORIZED: An event that indicates port is authorized and
+ *	open for regular data traffic. For STA/P2P GC, this event is sent with
+ *	AP mac addr and for AP/P2P GO, the event carries the STA/GC macaddr.
+ *	Drivers that support 4 way handshake offload should send this event for
+ *	STA/GC after successful 4 way HS or after 802.1X FT following
+ *	NL80211_CMD_CONNECT or NL80211_CMD_ROAM. Drivers using AP/P2P GO 4 way
+ *	handshake offload should send this event on successful completion of
+ *	4way handshake with the peer (STA/GC).
  * @NL80211_CMD_CONTROL_PORT_FRAME: Control Port (e.g. PAE) frame TX request
  *	and RX notification.  This command is used both as a request to transmit
  *	a control port frame and as a notification that a control port frame