git: 6c140ba1266b - stable/14 - man4: wifi manuals: revise .Sh HARDWARE + polish some
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Thu, 14 Nov 2024 01:53:54 UTC
The branch stable/14 has been updated by bz:
URL: https://cgit.FreeBSD.org/src/commit/?id=6c140ba1266b7957e1c2861e6ce41d9b88381f8a
commit 6c140ba1266b7957e1c2861e6ce41d9b88381f8a
Author: Alexander Ziaee <concussious@runbox.com>
AuthorDate: 2024-11-10 19:28:22 +0000
Commit: Bjoern A. Zeeb <bz@FreeBSD.org>
CommitDate: 2024-11-14 01:53:11 +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.
X-MFC with: 8f1a2d507e25e77d20a5
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)
Differential Revision: https://reviews.freebsd.org/D47508
(cherry picked from commit 8f1a2d507e25e77d20a5d7675dc8eee9b83d3570)
(cherry picked from commit 93b30f1b6caec5083efacf3fb5049b72e75cc09e)
---
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
+driver provides support for Realtek RTL8188SU/RTL8192SU USB IEEE 802.11b/g/n
*** 1325 LINES SKIPPED ***