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
MFC after:	3 days

share/doc/legal/Makefile

@@ -2,6 +2,7 @@
 
 SUBDIR=	intel_ipw \
 	intel_iwi \
+	intel_iwlwififw \
 	intel_iwn \
 	intel_wpi \
 	realtek

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 <bsd.prog.mk>

share/man/man4/Makefile

@@ -251,6 +251,8 @@ MAN=	aac.4 \
 	iwmfw.4 \
 	iwn.4 \
 	iwnfw.4 \
+	iwlwifi.4 \
+	iwlwififw.4 \
 	ixgbe.4 \
 	ixl.4 \
 	jedec_dimm.4 \

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

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