From nobody Thu Dec 30 19:22:50 2021 X-Original-To: dev-commits-src-branches@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 D67B0191FC4B; Thu, 30 Dec 2021 19:22:54 +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 "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4JPyph2dhSz3CG3; Thu, 30 Dec 2021 19:22:51 +0000 (UTC) (envelope-from git@FreeBSD.org) 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 7570D1DE6A; Thu, 30 Dec 2021 19:22:50 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 1BUJMojP017615; Thu, 30 Dec 2021 19:22:50 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 1BUJMoSM017614; Thu, 30 Dec 2021 19:22:50 GMT (envelope-from git) Date: Thu, 30 Dec 2021 19:22:50 GMT Message-Id: <202112301922.1BUJMoSM017614@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: "Bjoern A. Zeeb" Subject: git: f02c5a4cf950 - stable/13 - iwlwifi: add man pages List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-branches@freebsd.org X-BeenThere: dev-commits-src-branches@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/stable/13 X-Git-Reftype: branch X-Git-Commit: f02c5a4cf9507e24da4ad868398b2b9b875d4ec0 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1640892173; 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=YMyKitp/cG1C8ueoZvP7ythk97VexNOKDHWjRlZzIrk=; b=lHKCM+nldovxmC6gCa5TTw2xIjQtknbM/aKQD8shHC/khIS1wxuLhQ/hDey5bJEdpq2Ob6 DmOmYys+B/oQS9hI77kXtBbyP6Kui2x4wp9Znzt0xbz7mIyy+Jxc3RsUuZB9JQwA1+4k8V w954y0qoK4vpWaAWSHF/MLEcm2gxUNFanVUKxqYcJ9tQVHnTH44jKa2BCpCIdp6j3RTXLZ yGGUq7Rd42qMAUwvxwDBJCSyQ9pS6vbPzXC4Yhw2Owr6heeJgH1bLGlv9BgQgNT1Kfptnm 2wHwBA3qdCCtVzLd60RslreFLJ7PlIduMfWOMABDz1ECgynA5bSzstnq+49+Fg== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1640892173; a=rsa-sha256; cv=none; b=wb54eQQspZapPu+azBsPKgJn67f7DRghx92qR5lZfYk9ST9I44uHNBW6JL9UG6NPlNMkW6 08Ljkf2UEQ+s488F+neKWOZKHMQFcTarwQKwbRfGLVV+twprh5nZRK75W6IMOTCn67K6Qb dqZAaNnDZaei2cLQrWzAzExXcqxDBBvn1ADs13ThWmkbhWqixSuVGnCHsejsY6gty96xR3 L/jATNTW/WUno0p8cyiQeWKIrY3vNsTN6R4JUs+3RbuCylmQ4mZqt975/gI9/92Ysvu9Eq kKG4TSaYHMGKACr+a9J1Xe+B8sAgqlqQKZH9C7Fh3Cx7inxFp1P3v0xvPlT1Lg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/13 has been updated by bz: URL: https://cgit.FreeBSD.org/src/commit/?id=f02c5a4cf9507e24da4ad868398b2b9b875d4ec0 commit f02c5a4cf9507e24da4ad868398b2b9b875d4ec0 Author: Bjoern A. Zeeb AuthorDate: 2021-12-27 17:40:02 +0000 Commit: Bjoern A. Zeeb CommitDate: 2021-12-30 18:28:32 +0000 iwlwifi: add man pages Add and hook up man pages for iwlwifi and iwlwififw and install a copy of the firmware license to /usr/share/docs/legal so it will always be shipped with the installed system. Sponsored by: The FreeBSD Foundation (cherry picked from commit 5a02ae5e8f2d74b7ac20fa2e0cd98c66d934905b) --- share/doc/legal/Makefile | 1 + share/doc/legal/intel_iwlwififw/Makefile | 7 +++ share/man/man4/Makefile | 2 + share/man/man4/iwlwifi.4 | 81 ++++++++++++++++++++++++++++++++ share/man/man4/iwlwififw.4 | 52 ++++++++++++++++++++ 5 files changed, 143 insertions(+) diff --git a/share/doc/legal/Makefile b/share/doc/legal/Makefile index 5c0f37bd33d2..7a20215305d2 100644 --- a/share/doc/legal/Makefile +++ b/share/doc/legal/Makefile @@ -2,6 +2,7 @@ SUBDIR= intel_ipw \ intel_iwi \ + intel_iwlwififw \ intel_iwn \ intel_wpi \ realtek diff --git a/share/doc/legal/intel_iwlwififw/Makefile b/share/doc/legal/intel_iwlwififw/Makefile new file mode 100644 index 000000000000..a2d806075d1a --- /dev/null +++ b/share/doc/legal/intel_iwlwififw/Makefile @@ -0,0 +1,7 @@ +# $FreeBSD$ + +FILES= ${SRCTOP}/sys/contrib/dev/iwlwififw/LICENCE.iwlwifi_firmware +FILESDIR= ${SHAREDIR}/doc/legal +FILESNAME= intel_iwlwifi_firmware.LICENCE + +.include diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile index 655997ebaa31..4a8bb061a3c5 100644 --- a/share/man/man4/Makefile +++ b/share/man/man4/Makefile @@ -255,6 +255,8 @@ MAN= aac.4 \ iwmfw.4 \ iwn.4 \ iwnfw.4 \ + iwlwifi.4 \ + iwlwififw.4 \ ixgbe.4 \ ixl.4 \ jedec_dimm.4 \ diff --git a/share/man/man4/iwlwifi.4 b/share/man/man4/iwlwifi.4 new file mode 100644 index 000000000000..5d96b263c9e2 --- /dev/null +++ b/share/man/man4/iwlwifi.4 @@ -0,0 +1,81 @@ +.\"- +.\" Copyright (c) 2021 The FreeBSD Foundation +.\" +.\" This documentation was 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. +.\" +.\" $FreeBSD$ +.\" +.Dd October 27, 2021 +.Dt iwlwifi 4 +.Os +.Sh NAME +.Nm iwlwifi +.Nd Intel IEEE 802.11a/b/g/n/ac/ax wireless network driver +.Sh SYNOPSIS +To load the driver as a module at boot time, place the following lines in +.Xr loader.conf 5 : +.Bd -literal -offset indent +if_iwlwifi_load="YES" +.Ed +.Pp +The driver should automatically load any +.Xr iwlwififw 4 +firmware needed for the particular chipset. +.Sh DESCRIPTION +The +.Nm +driver is derived from Intel's Linux iwlwifi driver and provides support for +all chipsets supported by the +.Em mvm +part of that driver. +This superseeds the +.Xr iwm 4 +driver which provided support for a subset of these chipsets and still +complements the +.Xr iwn 4 +driver supporting older chipsets. +.Pp +The driver uses the +.\" No LinuxKPI man pages so no .Xr here. +.Em linuxkpi_wlan +and +.Em linuxkpi +compat framework to bridge between the Linux and +native FreeBSD driver code. +.Pp +While +.Nm +supports all 802.11 a/b/g/n/ac/ax +the compatibility code currently only supports 802.11 a/b/g modes. +Support for 802.11 n/ac is to come. 802.11ax and 6Ghz support are planned. +.Sh BUGS +Certainly. +.Sh SEE ALSO +.Xr iwlwififw 4 , +.Xr iwm 4 , +.Xr iwn 4 , +.Xr wlan 4 , +.Xr ifconfig 8 , +.Xr wpa_supplicant 8 diff --git a/share/man/man4/iwlwififw.4 b/share/man/man4/iwlwififw.4 new file mode 100644 index 000000000000..81daaa02817a --- /dev/null +++ b/share/man/man4/iwlwififw.4 @@ -0,0 +1,52 @@ +.\"- +.\" Copyright (c) 2021 The FreeBSD Foundation +.\" +.\" This documentation was 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. +.\" +.\" $FreeBSD$ +.\" +.Dd November 30, 2021 +.Dt iwlwififw 4 +.Os +.Sh NAME +.Nm iwlwififw +.Nd Firmware modules for Intel iwlwifi wireless network driver +.Sh SYNOPSIS +The +.Xr iwlwifi 4 +driver should auto-load any firmware needed. +.Sh DESCRIPTION +Multiple modules provide access to firmware for the various chipset +models supported by the +.Xr iwlwifi 4 +driver. +.Sh FILES +A copy of the +.Xr iwlwifi 4 +firmware license is installed at +.Em /usr/share/doc/legal/intel_iwlwifi_firmware.LICENCE . +.Sh SEE ALSO +.Xr iwlwifi 4 , +.Xr firmware 9