git: 5252ae96ad2d - releng/14.2 - man4: wifi manuals: revise .Sh HARDWARE + polish some

From: Bjoern A. Zeeb <bz_at_FreeBSD.org>
Date: Tue, 19 Nov 2024 00:38:44 UTC
The branch releng/14.2 has been updated by bz:

URL: https://cgit.FreeBSD.org/src/commit/?id=5252ae96ad2df7d812d4e9689cb234b036dc7a98

commit 5252ae96ad2df7d812d4e9689cb234b036dc7a98
Author:     Alexander Ziaee <concussious@runbox.com>
AuthorDate: 2024-11-10 19:28:22 +0000
Commit:     Bjoern A. Zeeb <bz@FreeBSD.org>
CommitDate: 2024-11-19 00:36:55 +0000

    man4: wifi manuals: revise .Sh HARDWARE + polish some
    
    The Release Hardware Notes are generated from hardware sections in the
    manual pages. Create or organize these sections in Wi-Fi driver manuals
    for information flow, and perform minor maintenance on them while here.
    
    After some testing, we have determined that a compact column list is
    the best for a single column listing in the hardware release notes.
    This makes very clean subsections and is for some reason denser than
    using a tagged list.
    
    This adds the long requested conversion from netmask to cidr examples.
    These examples probably shouldn't even be here, but that is a discussion
    for another day.
    
    Reported by: bz (relnotes generation, cidr, test-net-1 ip4addr)
    Reported by: grahamperrin (HARDWARE order mentioned in fdp-primer)
    Reported by: Graham Percival <gperciva@tarsnap.com> (don't prompt)
    Reviewed by: bz (anything wrong likely is my polishing fault; incl. iwm.4)
    Approved by: re (cperciva)
    Differential Revision: https://reviews.freebsd.org/D47508
    
    (cherry picked from commit 8f1a2d507e25e77d20a5d7675dc8eee9b83d3570)
    (cherry picked from commit 93b30f1b6caec5083efacf3fb5049b72e75cc09e)
    (cherry picked from commit 6c140ba1266b7957e1c2861e6ce41d9b88381f8a)
---
 share/man/man4/ipw.4      |  39 +++++----
 share/man/man4/iwi.4      |  47 +++++++----
 share/man/man4/iwlwifi.4  |  67 ++++++++++-----
 share/man/man4/iwm.4      |  96 ++++++++++++---------
 share/man/man4/mt7915.4   |  38 ++++++---
 share/man/man4/mt7921.4   |  38 ++++++---
 share/man/man4/otus.4     |  94 +++++++++++++--------
 share/man/man4/ral.4      |  27 +++---
 share/man/man4/rsu.4      |  83 ++++++++++--------
 share/man/man4/rtw88.4    |  60 +++++++------
 share/man/man4/rtw89.4    |  63 ++++++++------
 share/man/man4/rtwn.4     | 104 ++++++++++++++---------
 share/man/man4/rtwn_pci.4 |  26 ++++--
 share/man/man4/rtwn_usb.4 |  21 +++--
 share/man/man4/rum.4      |  23 ++---
 share/man/man4/run.4      | 211 ++++++++++++++++++++++++++++++----------------
 share/man/man4/ural.4     |  30 ++++---
 share/man/man4/urtw.4     |  44 +++++-----
 share/man/man4/zyd.4      | 147 +++++++++++++++++++++-----------
 19 files changed, 777 insertions(+), 481 deletions(-)

diff --git a/share/man/man4/ipw.4 b/share/man/man4/ipw.4
index c1010b798290..0ebee0f1e6eb 100644
--- a/share/man/man4/ipw.4
+++ b/share/man/man4/ipw.4
@@ -1,3 +1,6 @@
+.\"-
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
 .\" Copyright (c) 2004-2006
 .\"	Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
 .\"
@@ -23,12 +26,12 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd October 15, 2015
+.Dd November 10, 2024
 .Dt IPW 4
 .Os
 .Sh NAME
 .Nm ipw
-.Nd "Intel PRO/Wireless 2100 IEEE 802.11 driver"
+.Nd Intel PRO/Wireless 2100 IEEE 802.11a/b driver
 .Sh SYNOPSIS
 To compile this driver into the kernel,
 place the following lines in your
@@ -57,19 +60,14 @@ legal.intel_ipw.license_ack=1
 .Sh DESCRIPTION
 The
 .Nm
-driver provides support for the
-.Tn Intel
-PRO/Wireless 2100 MiniPCI network adapter.
-.Nm
-supports
+driver provides support for Intel PRO/Wireless 2100 802.11a/b
+wireless network devices in
 .Cm station ,
 .Cm adhoc ,
 and
 .Cm monitor
 mode operation.
 Only one virtual interface may be configured at any time.
-For more information on configuring this device, see
-.Xr ifconfig 8 .
 .Pp
 This driver requires the firmware built with the
 .Nm ipwfw
@@ -80,28 +78,34 @@ must be agreed by adding the following line to
 .Xr loader.conf 5 :
 .Pp
 .Dl "legal.intel_ipw.license_ack=1"
+.Pp
+For more information on configuring this device, see
+.Xr ifconfig 8 .
+.Sh HARDWARE
+The
+.Nm
+driver provides support for the
+Intel PRO/Wireless 2100a/b MiniPCI network adapter.
 .Sh FILES
-.Bl -tag -width ".Pa /usr/share/doc/legal/intel_ipw.LICENSE" -compact
+.Bl -tag -width "/usr/share/doc/legal/intel_ipw.LICENSE" -compact
 .It Pa /usr/share/doc/legal/intel_ipw.LICENSE
 .Nm
 firmware license
 .El
 .Sh EXAMPLES
 Join an existing BSS network (i.e., connect to an access point):
-.Bd -literal -offset indent
-ifconfig wlan create wlandev ipw0 inet 192.168.0.20 \e
-    netmask 0xffffff00
-.Ed
+.Pp
+.Dl ifconfig wlan create wlandev ipw0 inet 192.0.2.20/24
 .Pp
 Join a specific BSS network with network name
-.Dq Li my_net :
+.Ar my_net :
 .Pp
-.Dl "ifconfig wlan create wlandev ipw0 ssid my_net up"
+.Dl ifconfig wlan create wlandev ipw0 ssid my_net up
 .Pp
 Join a specific BSS network with 64-bit WEP encryption:
 .Bd -literal -offset indent
 ifconfig wlan create wlandev ipw0 ssid my_net \e
-	wepmode on wepkey 0x1234567890 weptxkey 1 up
+    wepmode on wepkey 0x1234567890 weptxkey 1 up
 .Ed
 .Pp
 Join a specific BSS network with 128-bit WEP encryption:
@@ -144,6 +148,7 @@ This should not happen.
 .Xr wlan_ccmp 4 ,
 .Xr wlan_tkip 4 ,
 .Xr wlan_wep 4 ,
+.Xr networking 7 ,
 .Xr ifconfig 8 ,
 .Xr wpa_supplicant 8
 .Sh AUTHORS
diff --git a/share/man/man4/iwi.4 b/share/man/man4/iwi.4
index 9de9b3e6c490..31ef4ec83d32 100644
--- a/share/man/man4/iwi.4
+++ b/share/man/man4/iwi.4
@@ -1,3 +1,6 @@
+.\"-
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
 .\" Copyright (c) 2004-2006
 .\"	Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
 .\"
@@ -23,12 +26,12 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd October 15, 2015
+.Dd November 10, 2024
 .Dt IWI 4
 .Os
 .Sh NAME
 .Nm iwi
-.Nd "Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11 driver"
+.Nd Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11 network driver
 .Sh SYNOPSIS
 To compile this driver into the kernel,
 include the following lines in your
@@ -57,19 +60,14 @@ legal.intel_iwi.license_ack=1
 .Sh DESCRIPTION
 The
 .Nm
-driver provides support for
-.Tn Intel
-PRO/Wireless 2200BG/2915ABG MiniPCI and 2225BG PCI network adapters.
-.Nm
-supports
+driver provides support for Intel PRO/Wireless 2200BG/2225BG/2915ABG
+IEEE 802.11a/b/g wireless network devices in
 .Cm station ,
 .Cm adhoc ,
 and
 .Cm monitor
 mode operation.
 Only one virtual interface may be configured at any time.
-For more information on configuring this device, see
-.Xr ifconfig 8 .
 .Pp
 This driver requires the firmware built with the
 .Nm iwifw
@@ -80,28 +78,42 @@ must be agreed by adding the following line to
 .Xr loader.conf 5 :
 .Pp
 .Dl "legal.intel_iwi.license_ack=1"
+.Pp
+For more information on configuring this device, see
+.Xr ifconfig 8 .
+.Sh HARDWARE
+The
+.Nm
+driver supports the following wireless network devices:
+.Pp
+.Bl -bullet -compact
+.It
+Intel PRO/Wireless 2200BG MiniPCI Network Connection
+.It
+Intel PRO/Wireless 2225BG PCI Network Connection
+.It
+Intel PRO/Wireless 2915ABG MiniPCI Network Connection
+.El
 .Sh FILES
-.Bl -tag -width ".Pa /usr/share/doc/legal/intel_iwi.LICENSE" -compact
+.Bl -tag -width "/usr/share/doc/legal/intel_iwi.LICENSE" -compact
 .It Pa /usr/share/doc/legal/intel_iwi.LICENSE
 .Nm
 firmware license
 .El
 .Sh EXAMPLES
 Join an existing BSS network (i.e., connect to an access point):
-.Bd -literal -offset indent
-ifconfig wlan create wlandev iwi0 inet 192.168.0.20 \e
-    netmask 0xffffff00
-.Ed
+.Pp
+.Dl ifconfig wlan create wlandev iwi0 inet 192.0.2.20/24
 .Pp
 Join a specific BSS network with network name
-.Dq Li my_net :
+.Ar my_net :
 .Pp
-.Dl "ifconfig wlan create wlandev iwi0 ssid my_net up"
+.Dl ifconfig wlan create wlandev iwi0 ssid my_net up
 .Pp
 Join a specific BSS network with 64-bit WEP encryption:
 .Bd -literal -offset indent
 ifconfig wlan create wlandev iwi0 ssid my_net \e
-	wepmode on wepkey 0x1234567890 weptxkey 1 up
+    wepmode on wepkey 0x1234567890 weptxkey 1 up
 .Ed
 .Pp
 Join a specific BSS network with 128-bit WEP encryption:
@@ -149,6 +161,7 @@ This should not happen.
 .Xr wlan_ccmp 4 ,
 .Xr wlan_tkip 4 ,
 .Xr wlan_wep 4 ,
+.Xr networking 7 ,
 .Xr ifconfig 8 ,
 .Xr wpa_supplicant 8
 .Sh AUTHORS
diff --git a/share/man/man4/iwlwifi.4 b/share/man/man4/iwlwifi.4
index ddeeb549d0f4..b4dce91f1ee4 100644
--- a/share/man/man4/iwlwifi.4
+++ b/share/man/man4/iwlwifi.4
@@ -1,4 +1,6 @@
 .\"-
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
 .\" Copyright (c) 2021-2024 The FreeBSD Foundation
 .\"
 .\" This documentation was written by Bj\xc3\xb6rn Zeeb under sponsorship from
@@ -25,7 +27,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd September 30, 2024
+.Dd November 10, 2024
 .Dt IWLWIFI 4
 .Os
 .Sh NAME
@@ -54,11 +56,11 @@ It is discouraged to load the driver from
 .Sh DESCRIPTION
 The
 .Nm
-driver is derived from Intel's Linux iwlwifi driver
+driver provides support for Intel Wireless network devices.
 .Pp
 .Nm
-will be a successor to
-.Xr iwm 4
+is derived from Intel's Linux iwlwifi driver, will be a successor to
+.Xr iwm 4 ,
 and may supersede that driver in the future.
 It still complements the
 .Xr iwn 4
@@ -66,33 +68,51 @@ driver which supports older chipsets.
 .Pp
 The driver uses the
 .\" No LinuxKPI man pages so no .Xr here.
-.Em linuxkpi_wlan
+.Sy linuxkpi_wlan
 and
-.Em linuxkpi
+.Sy linuxkpi
 compat framework to bridge between the Linux and
 native
 .Fx
 driver code as well as to the native
 .Xr net80211 4
 wireless stack.
-.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 HARDWARE
 The
 .Nm
 driver supports PCIe devices from the
-.Em mvm
-sub-driver with the following chipsets:
+.Sy mvm
+sub-driver with the following chipset generations:
 .Pp
+.\" awk -F\\t '{ print $5 }' ~/tmp/iwlwifi_pci_ids_name.txt | \
+.\" grep -v undefined | sort -V | uniq | grep -v ^$ | \
+.\" awk '{ printf ".It\n%s\n", $0 }'
 .Bl -bullet -compact
-.\" ---------------------------------------------------------------------
+.It
+7000
+.It
+8000
+.It
+9000
+.It
+22000
+.It
+AX210
+.It
+BZ
+.It
+SC
+.El
+.Pp
+These chipset generations match the following common device names:
+.Pp
+.Bl -bullet -compact
+.\" --------------------------------------------------------------------
 .\" This list is manually generated from a sysctl and post-processing.
 .\" Edits will be overwritten on next update.
-.\" ---------------------------------------------------------------------
+.\" awk -F\\t '{ if ($2 == "") { next; } if (seen[$2]) { next; } \
+.\" seen[$2]=1; printf ".It\n%s\n", $2; }' iwlwifi_pci_ids_name.txt
+.\" --------------------------------------------------------------------
 .It
 Intel(R) Dual Band Wireless AC 7260
 .It
@@ -209,15 +229,15 @@ Intel(R) TBD Bz device
 Intel(R) Wi-Fi 6 AX204 160MHz
 .It
 Intel(R) TBD Sc device
-.\" ---------------------------------------------------------------------
+.\" --------------------------------------------------------------------
 .El
-.Sh BUGS
-Certainly.
 .Sh SEE ALSO
 .Xr iwlwififw 4 ,
 .Xr iwm 4 ,
 .Xr iwn 4 ,
 .Xr wlan 4 ,
+.Xr networking 7 ,
+.Xr fwget 8 ,
 .Xr ifconfig 8 ,
 .Xr wpa_supplicant 8
 .Sh HISTORY
@@ -225,3 +245,12 @@ The
 .Nm
 driver first appeared in
 .Fx 13.1 .
+.Sh BUGS
+Certainly.
+.Pp
+While
+.Nm
+supports 802.11a/b/g/n/ac/ax modes,
+the compatibility code currently only supports 802.11a/b/g modes.
+Support for 802.11n/ac/ax is yet to come.
+802.11ax and 6Ghz support are planned.
diff --git a/share/man/man4/iwm.4 b/share/man/man4/iwm.4
index b810f7016e54..5249959cd3f6 100644
--- a/share/man/man4/iwm.4
+++ b/share/man/man4/iwm.4
@@ -1,3 +1,6 @@
+.\"-
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
 .\" Copyright (c) 2004-2006
 .\"	Damien Bergamini <damien.bergamini@free.fr>. All rights reserved.
 .\"
@@ -23,7 +26,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd February 20, 2024
+.Dd November 10, 2024
 .Dt IWM 4
 .Os
 .Sh NAME
@@ -31,8 +34,7 @@
 .Nd Intel IEEE 802.11ac wireless network driver
 .Sh SYNOPSIS
 To compile this driver into the kernel,
-include the following lines in your
-kernel configuration file:
+include the following lines in your kernel configuration file:
 .Bd -ragged -offset indent
 .Cd "device iwm"
 .Cd "device pci"
@@ -79,55 +81,59 @@ iwm9260fw_load="YES"
 .Sh DESCRIPTION
 The
 .Nm
-driver provides support for:
-.Pp
-.Bl -tag -width Ds -offset indent -compact
-.It Intel Dual Band Wireless AC 3160
-.It Intel Dual Band Wireless AC 3165
-.It Intel Dual Band Wireless AC 3168
-.It Intel Dual Band Wireless AC 7260
-.It Intel Dual Band Wireless AC 7265
-.It Intel Dual Band Wireless AC 8260
-.It Intel Dual Band Wireless AC 8265
-.It Intel Dual Band Wireless AC 9260
-.It Intel Dual Band Wireless AC 9270
-.It Intel Dual Band Wireless AC 946X
-.It Intel Dual Band Wireless AC 9560
-.El
-.Pp
-.Nm
-supports
+driver supports running most Intel Wireless AC series network devices in
 .Cm station
 mode operation.
 Only one virtual interface may be configured at any time.
-For more information on configuring this device, see
-.Xr ifconfig 8 .
-.Pp
 This driver requires the firmware built with the
-.Nm iwmfw
+.Xr iwmfw 4
 module to work.
 .Pp
-Currently,
+For more information on configuring this device, see
+.Xr ifconfig 8 .
+.Sh HARDWARE
+The
 .Nm
-only supports 802.11b and 802.11g modes.
-It will not associate to access points that are configured to operate only
-in 802.11n or 802.11ac modes.
+driver supports the following PCIe Wi-Fi devices:
+.Pp
+.Bl -bullet -compact
+.It
+Intel Dual Band Wireless AC 3160
+.It
+Intel Dual Band Wireless AC 3165
+.It
+Intel Dual Band Wireless AC 3168
+.It
+Intel Dual Band Wireless AC 7260
+.It
+Intel Dual Band Wireless AC 7265
+.It
+Intel Dual Band Wireless AC 8260
+.It
+Intel Dual Band Wireless AC 8265
+.It
+Intel Dual Band Wireless AC 9260
+.It
+Intel Dual Band Wireless AC 9270
+.It
+Intel Dual Band Wireless AC 946X
+.It
+Intel Dual Band Wireless AC 9560
+.El
 .Sh EXAMPLES
 Join an existing BSS network (i.e., connect to an access point):
-.Bd -literal -offset indent
-ifconfig wlan create wlandev iwm0 inet 192.168.0.20 \e
-    netmask 0xffffff00
-.Ed
+.Pp
+.Dl ifconfig wlan create wlandev iwm0 inet 192.0.2.20/24
 .Pp
 Join a specific BSS network with network name
-.Dq Li my_net :
+.Ar my_net :
 .Pp
-.Dl "ifconfig wlan create wlandev iwm0 ssid my_net up"
+.Dl ifconfig wlan create wlandev iwm0 ssid my_net up
 .Pp
 Join a specific BSS network with 64-bit WEP encryption:
 .Bd -literal -offset indent
 ifconfig wlan create wlandev iwm0 ssid my_net \e
-	wepmode on wepkey 0x1234567890 weptxkey 1 up
+    wepmode on wepkey 0x1234567890 weptxkey 1 up
 .Ed
 .Pp
 Join a specific BSS network with 128-bit WEP encryption:
@@ -155,15 +161,16 @@ Verify the
 .Xr iwmfw 4
 firmware module is present.
 .It "iwm%d: could not load boot firmware"
-An attempt to upload the boot firmware image to the onboard microcontroller
-failed.
+An attempt to upload the boot firmware image
+to the onboard microcontroller failed.
 This should not happen.
 .It "iwm%d: could not load microcode"
-An attempt to upload the microcode image to the onboard microcontroller failed.
+An attempt to upload the microcode image
+to the onboard microcontroller failed.
 This should not happen.
 .It "iwm%d: could not load main firmware"
-An attempt to upload the main firmware image to the onboard microcontroller
-failed.
+An attempt to upload the main firmware image
+to the onboard microcontroller failed.
 This should not happen.
 .El
 .Sh SEE ALSO
@@ -174,5 +181,12 @@ This should not happen.
 .Xr wlan_ccmp 4 ,
 .Xr wlan_tkip 4 ,
 .Xr wlan_wep 4 ,
+.Xr networking 7 ,
 .Xr ifconfig 8 ,
 .Xr wpa_supplicant 8
+.Sh BUGS
+Currently,
+.Nm
+only supports 802.11a/b/g modes.
+It will not associate to access points that are configured to operate
+only in 802.11n/ac modes.
diff --git a/share/man/man4/mt7915.4 b/share/man/man4/mt7915.4
index eece142c11a5..ba67a77af735 100644
--- a/share/man/man4/mt7915.4
+++ b/share/man/man4/mt7915.4
@@ -1,4 +1,6 @@
 .\"-
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
 .\" Copyright (c) 2023-2024 Bjoern A. Zeeb
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -22,7 +24,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd September 30, 2024
+.Dd November 10, 2024
 .Dt MT7915 4
 .Os
 .Sh NAME
@@ -50,7 +52,9 @@ It is discouraged to load the driver from
 .Sh DESCRIPTION
 The
 .Nm
-driver is derived from MediaTek's Linux mt76 driver.
+driver provides support for MediaTek MT7915E wireless network devices.
+.Nm
+is derived from MediaTek's Linux mt76 driver.
 .Pp
 This driver requires firmware to be loaded before it will work.
 The package
@@ -62,36 +66,34 @@ Otherwise no
 .Xr wlan 4
 interface can be created using
 .Xr ifconfig 8 .
+One can use
+.Xr fwget 8
+to install the correct firmware package.
 .Pp
 The driver uses the
 .\" No LinuxKPI man pages so no .Xr here.
-.Em linuxkpi_wlan
+.Sy linuxkpi_wlan
 and
-.Em linuxkpi
+.Sy linuxkpi
 compat framework to bridge between the Linux and
 native
 .Fx
 driver code as well as to the native
 .Xr net80211 4
 wireless stack.
-.Pp
-While
-.Nm
-supports all 802.11 a/b/g/n/ac and ax
-the compatibility code currently only supports 802.11 a/b/g modes.
-Support for 802.11 n/ac is to come.
 .Sh HARDWARE
 The
 .Nm
 driver supports PCIe devices with the following chipsets:
 .Pp
-.Bl -tag -width Ds -offset indent -compact
-.It MediaTek MT7915E
+.Bl -bullet -offset indent -compact
+.It
+MediaTek MT7915E
 .El
-.Sh BUGS
-Certainly.
 .Sh SEE ALSO
 .Xr wlan 4 ,
+.Xr networking 7 ,
+.Xr fwget 8 ,
 .Xr ifconfig 8 ,
 .Xr wpa_supplicant 8
 .Sh HISTORY
@@ -99,3 +101,11 @@ The
 .Nm
 driver first appeared in
 .Fx 14.0 .
+.Sh BUGS
+Certainly.
+.Pp
+While
+.Nm
+supports 802.11a/b/g/n/ac/ax modes,
+the compatibility code currently only supports 802.11a/b/g modes.
+Support for 802.11n/ac/ax is yet to come.
diff --git a/share/man/man4/mt7921.4 b/share/man/man4/mt7921.4
index d28dc520de6b..fe9efa77e35d 100644
--- a/share/man/man4/mt7921.4
+++ b/share/man/man4/mt7921.4
@@ -1,4 +1,6 @@
 .\"-
+.\" SPDX-License-Identifier: BSD-2-Clause
+.\"
 .\" Copyright (c) 2023-2024 Bjoern A. Zeeb
 .\"
 .\" Redistribution and use in source and binary forms, with or without
@@ -22,7 +24,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd September 30, 2024
+.Dd November 10, 2024
 .Dt MT7921 4
 .Os
 .Sh NAME
@@ -50,7 +52,9 @@ It is discouraged to load the driver from
 .Sh DESCRIPTION
 The
 .Nm
-driver is derived from MediaTek's Linux mt76 driver.
+driver provides support for MediaTek MT7921E wireless network devices.
+.Nm
+is derived from MediaTek's Linux mt76 driver.
 .Pp
 This driver requires firmware to be loaded before it will work.
 The package
@@ -62,36 +66,34 @@ Otherwise no
 .Xr wlan 4
 interface can be created using
 .Xr ifconfig 8 .
+One can use
+.Xr fwget 8
+to install the correct firmware package.
 .Pp
 The driver uses the
 .\" No LinuxKPI man pages so no .Xr here.
-.Em linuxkpi_wlan
+.Sy linuxkpi_wlan
 and
-.Em linuxkpi
+.Sy linuxkpi
 compat framework to bridge between the Linux and
 native
 .Fx
 driver code as well as to the native
 .Xr net80211 4
 wireless stack.
-.Pp
-While
-.Nm
-supports all 802.11 a/b/g/n/ac and ax
-the compatibility code currently only supports 802.11 a/b/g modes.
-Support for 802.11 n/ac is to come.
 .Sh HARDWARE
 The
 .Nm
 driver supports PCIe devices with the following chipsets:
 .Pp
-.Bl -tag -width Ds -offset indent -compact
-.It MediaTek MT7921E
+.Bl -bullet -offset indent -compact
+.It
+MediaTek MT7921E
 .El
-.Sh BUGS
-Certainly.
 .Sh SEE ALSO
 .Xr wlan 4 ,
+.Xr networking 7 ,
+.Xr fwget 8 ,
 .Xr ifconfig 8 ,
 .Xr wpa_supplicant 8
 .Sh HISTORY
@@ -99,3 +101,11 @@ The
 .Nm
 driver first appeared in
 .Fx 14.0 .
+.Sh BUGS
+Certainly.
+.Pp
+While
+.Nm
+supports 802.11a/b/g/n/ac/ax modes,
+the compatibility code currently only supports 802.11a/b/g modes.
+Support for 802.11n/ac/ax is to come.
diff --git a/share/man/man4/otus.4 b/share/man/man4/otus.4
index 1e2d1e0a402f..06f73bfe3338 100644
--- a/share/man/man4/otus.4
+++ b/share/man/man4/otus.4
@@ -1,3 +1,5 @@
+.\"-
+.\" SPDX-License-Identifier: ISC
 .\"
 .\" Copyright (c) 2015 Adrian Chadd <adrian@FreeBSD.org>
 .\"
@@ -13,12 +15,12 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd September 25, 2015
+.Dd November 10, 2024
 .Dt OTUS 4
 .Os
 .Sh NAME
 .Nm otus
-.Nd Atheros AR9170 USB IEEE 802.11a/b/g/n wireless network device
+.Nd Atheros AR9170 USB IEEE 802.11a/b/g/n wireless network driver
 .Sh SYNOPSIS
 To compile this driver into the kernel,
 place the following lines in your kernel configuration file:
@@ -79,6 +81,51 @@ The
 .Nm
 driver can be configured at runtime with
 .Xr ifconfig 8 .
+.Sh HARDWARE
+The
+.Nm
+driver provides support for Atheros AR9170 USB IEEE 802.11b/g/n
+wireless network adapters, including:
+.Pp
+.Bl -bullet -offset indent -compact
+.It
+3Com 3CRUSBN275
+.It
+Arcadyan WN7512
+.\" .It AVM FRITZ!WLAN USB Stick N
+.It
+CACE AirPcap \&Nx
+.It
+D-Link DWA-130 rev \&D1
+.It
+D-Link DWA-160 rev A1
+.It
+D-Link DWA-160 rev A2
+.It
+IO-Data WN-GDN/US2
+.It
+NEC Aterm WL300NU-G
+.It
+Netgear WNDA3100
+.It
+Netgear WN111 v2
+.It
+Planex GW-US300
+.It
+SMC Networks SMCWUSB-N2
+.It
+TP-Link TL-WN821N v1, v2
+.It
+Ubiquiti SR71 USB
+.It
+Unex DNUA-81
+.It
+Z-Com UB81
+.It
+Z-Com UB82
+.It
+ZyXEL NWD-271N
+.El
 .Sh FILES
 The driver needs at least version 1.0 of the following firmware files,
 which is loaded when an interface is attached:
@@ -87,49 +134,20 @@ which is loaded when an interface is attached:
 .It Pa /boot/kernel/otusfw-init.ko
 .It Pa /boot/kernel/otusfw-main.ko
 .El
-.Sh HARDWARE
-The
-.Nm
-driver provices support for Atheros AR9170 USB IEEE 802.11b/g/n
-wireless network adapters, including:
-.Pp
-.Bl -tag -width Ds -offset indent -compact
-.It 3Com 3CRUSBN275
-.It Arcadyan WN7512
-.\" .It AVM FRITZ!WLAN USB Stick N
-.It CACE AirPcap \&Nx
-.It D-Link DWA-130 rev \&D1
-.It D-Link DWA-160 rev A1
-.It D-Link DWA-160 rev A2
-.It IO-Data WN-GDN/US2
-.It NEC Aterm WL300NU-G
-.It Netgear WNDA3100
-.It Netgear WN111 v2
-.It Planex GW-US300
-.It SMC Networks SMCWUSB-N2
-.It TP-Link TL-WN821N v1, v2
-.It Ubiquiti SR71 USB
-.It Unex DNUA-81
-.It Z-Com UB81
-.It Z-Com UB82
-.It ZyXEL NWD-271N
-.El
 .Sh EXAMPLES
 Join an existing BSS network (i.e., connect to an access point):
-.Bd -literal -offset indent
-ifconfig wlan create wlandev otus0 inet 192.168.0.20 \e
-    netmask 0xffffff00
-.Ed
+.Pp
+.Dl ifconfig wlan create wlandev otus0 inet 192.0.2.20/24
 .Pp
 Join a specific BSS network with network name
-.Dq Li my_net :
+.Ar my_net :
 .Pp
-.Dl "ifconfig wlan create wlandev otus0 ssid my_net up"
+.Dl ifconfig wlan create wlandev otus0 ssid my_net up
 .Pp
 Join a specific BSS network with 64-bit WEP encryption:
 .Bd -literal -offset indent
 ifconfig wlan create wlandev otus0 ssid my_net \e
-        wepmode on wepkey 0x1234567890 weptxkey 1 up
+    wepmode on wepkey 0x1234567890 weptxkey 1 up
 .Ed
 .Sh DIAGNOSTICS
 .Bl -diag
@@ -152,7 +170,9 @@ The file might be missing or corrupted.
 The
 .Nm
 driver first appeared in
-.Ox 4.6 .
+.Ox 4.6
+and
+.Fx 11 .
 .Sh AUTHORS
 .An -nosplit
 The
diff --git a/share/man/man4/ral.4 b/share/man/man4/ral.4
index dbdc017dc33a..ad385e5f09d6 100644
--- a/share/man/man4/ral.4
+++ b/share/man/man4/ral.4
@@ -1,3 +1,6 @@
+.\"-
+.\" SPDX-License-Identifier: ISC
+.\"
 .\" Copyright (c) 2005-2010 Damien Bergamini <damien.bergamini@free.fr>
 .\"
 .\" Permission to use, copy, modify, and distribute this software for any
@@ -12,12 +15,12 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd April 4, 2017
+.Dd November 10, 2024
 .Dt RAL 4
 .Os
 .Sh NAME
 .Nm ral
-.Nd "Ralink Technology IEEE 802.11a/g/n wireless network device"
+.Nd Ralink Technology IEEE 802.11a/g/n wireless network driver
 .Sh SYNOPSIS
 To compile this driver into the kernel,
 place the following lines in your
@@ -119,7 +122,7 @@ The
 driver supports PCI/PCIe/CardBus wireless adapters based on Ralink Technology
 chipsets, including:
 .Pp
-.Bl -column -compact ".Li Atlantis Land A02-PCM-W54" "RT2561S" "CardBus"
+.Bl -column -offset indent -compact "Atlantis Land A02-PCM-W54" "RT2561S" "CardBus"
 .It Em Card Ta Em MAC/BBP Ta Em Bus
 .It "A-Link WL54H" Ta RT2560 Ta PCI
 .It "A-Link WL54PC" Ta RT2560 Ta CardBus
@@ -212,26 +215,25 @@ chipsets, including:
 .Sh EXAMPLES
 Join an existing BSS network (i.e., connect to an access point):
 .Pp
-.Dl "ifconfig wlan create wlandev ral0 inet 192.168.0.20 netmask 0xffffff00"
+.Dl ifconfig wlan create wlandev ral0 inet 192.0.2.20/24
 .Pp
 Join a specific BSS network with network name
-.Dq Li my_net :
+.Ar my_net :
 .Bd -literal -offset indent
-ifconfig wlan create wlandev ral0 inet 192.168.0.20 \e
-    netmask 0xffffff00 ssid my_net
+ifconfig wlan create wlandev ral0 inet 192.0.2.20/24 \e
+    ssid my_net
 .Ed
 .Pp
 Join a specific BSS network with 40-bit WEP encryption:
 .Bd -literal -offset indent
-ifconfig wlan create wlandev ral0 inet 192.168.0.20 \e
-    netmask 0xffffff00 ssid my_net \e
-    wepmode on wepkey 0x1234567890 weptxkey 1
+ifconfig wlan create wlandev ral0 inet 192.0.2.20/24 \e
+    ssid my_net wepmode on wepkey 0x1234567890 weptxkey 1
 .Ed
 .Pp
 Join a specific BSS network with 104-bit WEP encryption:
 .Bd -literal -offset indent
-ifconfig wlan create wlandev ral0 inet 192.168.0.20 \e
-    netmask 0xffffff00 ssid my_net \e
+ifconfig wlan create wlandev ral0 inet 192.0.2.20/24 \e
+    ssid my_net \e
     wepmode on wepkey 0x01020304050607080910111213 weptxkey 1
 .Ed
 .Sh DIAGNOSTICS
@@ -254,6 +256,7 @@ This should not happen.
 .Xr wlan_tkip 4 ,
 .Xr wlan_wep 4 ,
 .Xr wlan_xauth 4 ,
+.Xr networking 7 ,
 .Xr hostapd 8 ,
 .Xr ifconfig 8 ,
 .Xr wpa_supplicant 8
diff --git a/share/man/man4/rsu.4 b/share/man/man4/rsu.4
index 34cebc598c0a..7aaacb8112a0 100644
--- a/share/man/man4/rsu.4
+++ b/share/man/man4/rsu.4
@@ -1,3 +1,6 @@
+.\"-
+.\" SPDX-License-Identifier: ISC
+.\"
 .\" $OpenBSD: rsu.4,v 1.11 2013/02/14 07:40:42 jmc Exp $
 .\"
 .\" Copyright (c) 2010 Damien Bergamini <damien.bergamini@free.fr>
@@ -14,12 +17,12 @@
 .\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
 .\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 .\"
-.Dd May 23, 2021
+.Dd November 10, 2024
 .Dt RSU 4
 .Os
 .Sh NAME
 .Nm rsu
-.Nd Realtek RTL8188SU/RTL8192SU USB IEEE 802.11b/g/n wireless network device
+.Nd Realtek RTL8188SU/RTL8192SU USB IEEE 802.11b/g/n wireless network driver
 .Sh SYNOPSIS
 To compile this driver into the kernel,
 place the following lines in your kernel configuration file:
@@ -93,8 +96,46 @@ The
 .Nm
 driver can be configured at runtime with
 .Xr ifconfig 8 .
+.Sh HARDWARE
+The
+.Nm
*** 1326 LINES SKIPPED ***