From patchwork Thu Nov 9 06:33:44 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Vinayak Yadawad X-Patchwork-Id: 13450669 X-Patchwork-Delegate: johannes@sipsolutions.net Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from vger.kernel.org (vger.kernel.org [23.128.96.18]) by smtp.lore.kernel.org (Postfix) with ESMTP id D1BC7C4332F for ; Thu, 9 Nov 2023 06:34:08 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S231144AbjKIGd7 (ORCPT ); Thu, 9 Nov 2023 01:33:59 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:33054 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S229697AbjKIGd6 (ORCPT ); Thu, 9 Nov 2023 01:33:58 -0500 Received: from mail-pj1-x102a.google.com (mail-pj1-x102a.google.com [IPv6:2607:f8b0:4864:20::102a]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 72F9B25AC for ; Wed, 8 Nov 2023 22:33:56 -0800 (PST) Received: by mail-pj1-x102a.google.com with SMTP id 98e67ed59e1d1-2802b744e52so1291605a91.0 for ; Wed, 08 Nov 2023 22:33:56 -0800 (PST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=broadcom.com; s=google; t=1699511636; x=1700116436; darn=vger.kernel.org; h=mime-version:message-id:date:subject:cc:to:from:from:to:cc:subject :date:message-id:reply-to; bh=pUjqCGSvjcxIVfUf41gV2EuzjTIHxJEeRl3PegzX2lw=; b=R/s6O82n22FmJ+wTSKrkjboCQ76LD1/RN8W97GVlNDyo7o8t5tJ9jCcD32j+qRjrjk DRBKuYPaQLUevg7fG/XQWyX2BYWUlYvdGBAy+VyXRkc8Wejnjg0SGl0Jv0f60YPH6nDi K74hTq1c+5MTGCiCzi8UIV7x/wP+NmdD3o3iM= X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1699511636; x=1700116436; h=mime-version:message-id:date:subject:cc:to:from:x-gm-message-state :from:to:cc:subject:date:message-id:reply-to; bh=pUjqCGSvjcxIVfUf41gV2EuzjTIHxJEeRl3PegzX2lw=; b=emMTmNblna/dPFR/EdSeoiQ7nKwo70jLZ9J/qcG99aOJc/CEiq2+cFPUl3WeypWh85 wMq8SIKyctfBv2XXOA2b2DCSA+8FT8oSk1Y4zemFkdL65XcVSvZIisBX6/JxZE7ESsfE M8tbUeWLas5CS2ALlMRZFiMaZU3QrepGGrUxYuLCXwo5QktkQX8ihj1ZNrqbFnjZ1in6 lFstMh7ui0F36llurr7dd8/Kqz/ZK/AIV0YMAyvZV/huavmv+ae4IQkfjz6OLi5p3OnO Rh/PzZin8S5R12J9AOfaSJdpICkEayu2tW+9q0tAo+jeIny25zMYTOE+/TfuqoUnFbpD lYGw== X-Gm-Message-State: AOJu0Yz3/Uu909jbqu3PzBcm5mh3XE6JTseSOLr6XcGLZnNC//srVik+ FPQlZZ3ejPnFsNuswnaLzzM6bQ== X-Google-Smtp-Source: AGHT+IHRfIYRzuVofolW7x0rxDRUXF3JcG75bOLt9/TeWFyCSahk53hVVFTtXOi+2idBYOQGgFZWxQ== X-Received: by 2002:a17:90a:fe0d:b0:280:4a23:3c84 with SMTP id ck13-20020a17090afe0d00b002804a233c84mr1199081pjb.22.1699511635804; Wed, 08 Nov 2023 22:33:55 -0800 (PST) Received: from ibnvda0196.ibn.broadcom.net ([192.19.252.250]) by smtp.gmail.com with ESMTPSA id b24-20020a17090ae39800b002800e0b4852sm540770pjz.22.2023.11.08.22.33.54 (version=TLS1_2 cipher=ECDHE-ECDSA-AES128-GCM-SHA256 bits=128/128); Wed, 08 Nov 2023 22:33:55 -0800 (PST) From: Vinayak Yadawad To: johannes@sipsolutions.net Cc: linux-wireless@vger.kernel.org, jithu.jance@broadcom.com, Vinayak Yadawad Subject: [PATCH 1/1] wifi: nl80211: Documentation update for NL80211_CMD_PORT_AUTHORIZED event Date: Thu, 9 Nov 2023 12:03:44 +0530 Message-Id: X-Mailer: git-send-email 2.32.0 MIME-Version: 1.0 Precedence: bulk List-ID: X-Mailing-List: linux-wireless@vger.kernel.org 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 --- include/uapi/linux/nl80211.h | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) 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