From nobody Fri Jun 13 14:57:40 2025 X-Original-To: dev-commits-src-main@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4bJjDj1lQHz5q6TZ; Fri, 13 Jun 2025 14:57:41 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R11" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4bJjDj15jsz3V5G; Fri, 13 Jun 2025 14:57:41 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1749826661; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=v+DQpKdLQp5+tmDDvvIEurhwDXKcPMBaDQrviNr7rqw=; b=veICmh0chRUe0otq7k74pqFmI+iCGdfYkN85eSQUsBxClZdtecO3olOect50sTEZZnU0qm Tc8xbLre1CAnmzw8tBxCx7eGDXGceuwulV9g27uhjrcvxiSn9OzSVBvN8b6o4GD3KZ4i4O YbgHyUyJlEljqDARF76ImhXVEExNPd8VIzrYZF9OwWQ+kDeten5x/+qR7R2ima9TG1DhVf i5URrTGg3qvvgaMY9WEHGDzwhgBnibc9DMgCLJ1PA6tDj4veJSClTDtLNVHMZYYGoNsDwy 6Yh02zlhoskJ9itw/FtYZcVz6XqzcgsckcQcBXLXTTPwzC6r59pt7qhoKPkiMg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1749826661; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=v+DQpKdLQp5+tmDDvvIEurhwDXKcPMBaDQrviNr7rqw=; b=dTW2X095rBoTYyq2qy4Sgk/h1T1Ot+l/D8cF+vJx8Q5CddswRO0QZOSFD/zFkFdj/Ave4u moBSsNdaAWnoQpntt11ojgQ7pw0ETlVk+17R3xFaG/3wYB4SbTSrl7xGI2H7TX+NfGWq0P DtQNyzu0zy3IP3Y1D0q3OUGpOv9qEmO9UcNwY0cdLqvbl+Sm+B2I8Puoczyqs3Bi3xpYPW nUq+FslSQrgRWvLeqL4E3nv+GUUFS/l3YOM/bZIJiCzdtFtuoYRjcWUD3jsL8WbU9WyqAy OtM40xo29bE/NRUj9qx+6kc7zYJNyhG5XkE9u5qjecLySiNswY/Xfnx2HDLxhQ== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1749826661; a=rsa-sha256; cv=none; b=kwvRS6V5M0MudLfh2NdgFE7F+028Ipm5kQaGLaXNgNm2I8KWBiqJByxDHqeCyhDKcNyTOn GdICLR0Nu/alEDcjS2r36Dgzm6ncebDlYXb7NMXAFeHvouAsgvPyig5BRW5Aq1TaJqKVWt 0LnFDD0ONaa3fkkQd/JHqCviF++ZDHO8zFC34LfvlUsJRHhZUuNItu4BtvX2ZLWaD61CBz c+GmXIMEeVLjNcjANtlLrDrhqTjxKBoV74+sFjNdYocwGBM7C8jdtX9khmEs1lgBQYTYmd zwGZUtywma72GH1LIccVvA297uydBRT7RRQOAczUWle/hR5T/7rjiz2mWleZig== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 4bJjDj0hL5z12fc; Fri, 13 Jun 2025 14:57:41 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 55DEveXm009478; Fri, 13 Jun 2025 14:57:40 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 55DEveK7009475; Fri, 13 Jun 2025 14:57:40 GMT (envelope-from git) Date: Fri, 13 Jun 2025 14:57:40 GMT Message-Id: <202506131457.55DEveK7009475@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: "Bjoern A. Zeeb" Subject: git: ca6d68a06317 - main - wlan_gcmp.4: add man page List-Id: Commit messages for the main branch of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-main List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-main@freebsd.org Sender: owner-dev-commits-src-main@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bz X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: ca6d68a063171655c34daaddb6eb7768ed283dee Auto-Submitted: auto-generated The branch main has been updated by bz: URL: https://cgit.FreeBSD.org/src/commit/?id=ca6d68a063171655c34daaddb6eb7768ed283dee commit ca6d68a063171655c34daaddb6eb7768ed283dee Author: Bjoern A. Zeeb AuthorDate: 2025-06-11 07:17:07 +0000 Commit: Bjoern A. Zeeb CommitDate: 2025-06-13 14:57:21 +0000 wlan_gcmp.4: add man page The man page is heavily based on wlan_ccmp.4 with minor modifications for GCMP. Add the .Xr to the other wlan*.4 man pages. Sposnored by: The FreeBSD Foundation MFC after: 3 days Reviewed by: adrian, ziaee Differential Revision: https://reviews.freebsd.org/D50789 --- share/man/man4/wlan.4 | 1 + share/man/man4/wlan_ccmp.4 | 1 + share/man/man4/wlan_gcmp.4 | 72 ++++++++++++++++++++++++++++++++++++++++++++++ share/man/man4/wlan_tkip.4 | 1 + share/man/man4/wlan_wep.4 | 1 + 5 files changed, 76 insertions(+) diff --git a/share/man/man4/wlan.4 b/share/man/man4/wlan.4 index 1d297c48d9d6..ff983c66c1cb 100644 --- a/share/man/man4/wlan.4 +++ b/share/man/man4/wlan.4 @@ -192,6 +192,7 @@ Stations implementing earlier drafts (e.g., Linux) may be incompatible. .Xr urtw 4 , .Xr wlan_acl 4 , .Xr wlan_ccmp 4 , +.Xr wlan_gcmp 4 , .Xr wlan_tkip 4 , .Xr wlan_wep 4 , .Xr wlan_xauth 4 , diff --git a/share/man/man4/wlan_ccmp.4 b/share/man/man4/wlan_ccmp.4 index f0efa86d2fdb..ffd4da8694e9 100644 --- a/share/man/man4/wlan_ccmp.4 +++ b/share/man/man4/wlan_ccmp.4 @@ -53,6 +53,7 @@ calculations in hardware, the module will do the work. .Sh SEE ALSO .Xr wlan 4 , +.Xr wlan_gcmp 4 , .Xr wlan_tkip 4 , .Xr wlan_wep 4 .Sh STANDARDS diff --git a/share/man/man4/wlan_gcmp.4 b/share/man/man4/wlan_gcmp.4 new file mode 100644 index 000000000000..a7657a9ad91b --- /dev/null +++ b/share/man/man4/wlan_gcmp.4 @@ -0,0 +1,72 @@ +.\" +.\" Copyright (c) 2004 Sam Leffler +.\" All rights reserved. +.\" Copyright (c) 2025 The FreeBSD Foundation +.\" +.\" Portions of this documentation were written by Bj\xc3\xb6rn Zeeb +.\" under sponsorship from the FreeBSD Foundation. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" +.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE +.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL +.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS +.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) +.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT +.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY +.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF +.\" SUCH DAMAGE. +.\" +.\" Based on wlan_ccmp.4. +.\" +.Dd June 13, 2025 +.Dt WLAN_GCMP 4 +.Os +.Sh NAME +.Nm wlan_gcmp +.Nd AES-GCMP crypto support for 802.11 devices +.Sh SYNOPSIS +.Cd "device wlan_gcmp" +.Sh DESCRIPTION +The +.Nm +module handles the +.Em Galois/Counter Mode Protocol +cryptographic requirements of the IEEE 802.11ad and WPA2/WPA3 protocols. +It does encapsulation and decapsulation of GCMP-encoded 802.11 frames +and optionally calculates the AES-GCMP cipher. +The +.Nm +module is an 802.11 cryptographic plugin module for use by the +.Xr wlan 4 +module. +This module is automatically loaded if an AES-GCMP key is configured; +typically by a WPA supplicant program such as wpa_supplicant, +or a WPA authenticator program such as +.Nm hostapd . +Should the underlying network device not be capable of doing the AES-GCMP +calculations in hardware, the +.Nm +module will do the work. +.Sh SEE ALSO +.Xr wlan 4 , +.Xr wlan_ccmp 4 , +.Xr wlan_tkip 4 , +.Xr wlan_wep 4 +.Sh STANDARDS +More information can be found in the IEEE 802.11, and WPA Standards. +.Sh HISTORY +The +.Nm +driver first appeared in +.Fx 15.0 . diff --git a/share/man/man4/wlan_tkip.4 b/share/man/man4/wlan_tkip.4 index 2e812ceffe9a..e74c24d45614 100644 --- a/share/man/man4/wlan_tkip.4 +++ b/share/man/man4/wlan_tkip.4 @@ -54,6 +54,7 @@ module will do the work. .Sh SEE ALSO .Xr wlan 4 , .Xr wlan_ccmp 4 , +.Xr wlan_gcmp 4 , .Xr wlan_wep 4 .Sh STANDARDS More information can be found in the IEEE 802.11, WPA, and 802.11i Standards. diff --git a/share/man/man4/wlan_wep.4 b/share/man/man4/wlan_wep.4 index 4e5887bbc35e..d83ef23e7a4e 100644 --- a/share/man/man4/wlan_wep.4 +++ b/share/man/man4/wlan_wep.4 @@ -51,6 +51,7 @@ module will do the work. .Sh SEE ALSO .Xr wlan 4 , .Xr wlan_ccmp 4 , +.Xr wlan_gcmp 4 , .Xr wlan_tkip 4 .Sh STANDARDS More information can be found in the IEEE 802.11 Standard.