git: 93b30f1b6cae - main - man4:: wifi manuals: revise .Sh HARDWARE + polish some
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Tue, 12 Nov 2024 23:04:15 UTC
The branch main has been updated by bz:
URL: https://cgit.FreeBSD.org/src/commit/?id=93b30f1b6caec5083efacf3fb5049b72e75cc09e
commit 93b30f1b6caec5083efacf3fb5049b72e75cc09e
Author: Alexander Ziaee <concussious@runbox.com>
AuthorDate: 2024-11-12 22:44:37 +0000
Commit: Bjoern A. Zeeb <bz@FreeBSD.org>
CommitDate: 2024-11-12 23:02:45 +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.
MFC after: 3 days
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
---
share/man/man4/ipw.4 | 39 +++++----
share/man/man4/iwi.4 | 47 +++++++----
share/man/man4/iwlwifi.4 | 41 +++++----
share/man/man4/iwm.4 | 2 +-
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 | 61 ++++++++------
share/man/man4/rtw89.4 | 64 +++++++-------
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, 698 insertions(+), 442 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 c5622f2586f1..04317c22936f 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 October 12, 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,26 +68,20 @@ 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
+.Sy mvm
sub-driver with the following chipset generations:
.Pp
.\" awk -F\\t '{ print $5 }' ~/tmp/iwlwifi_pci_ids_name.txt | \
@@ -111,12 +107,12 @@ SC
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
@@ -237,15 +233,15 @@ Intel(R) TBD Sc device
Intel(R) TBD Sc2 device
.It
Intel(R) TBD Sc2f 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
@@ -253,3 +249,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 7fd301929524..5249959cd3f6 100644
--- a/share/man/man4/iwm.4
+++ b/share/man/man4/iwm.4
@@ -26,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
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 040d4b14cb01..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,57 +81,73 @@ The
.Nm
driver can be configured at runtime with
.Xr ifconfig 8 .
-.Sh FILES
-The driver needs at least version 1.0 of the following firmware files,
-which is loaded when an interface is attached:
-.Pp
-.Bl -tag -width Ds -offset indent -compact
-.It Pa /boot/kernel/otusfw-init.ko
-.It Pa /boot/kernel/otusfw-main.ko
-.El
.Sh HARDWARE
The
.Nm
driver provides 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
+.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
+.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:
+.Pp
+.Bl -tag -width Ds -offset indent -compact
+.It Pa /boot/kernel/otusfw-init.ko
+.It Pa /boot/kernel/otusfw-main.ko
.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 b523bfe4aa0e..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
+wireless network adapters, including:
+.Pp
+.Bl -bullet -offset indent -compact
+.It
+ASUS USB-N10
+.It
+ASUS WL-167G V3
+.It
+Belkin F7D1101 v1
+.It
+D-Link DWA-131 A1
+.It
+EDUP EP-MS150N(W)
+.It
+Edimax EW-7622UMN
+.It
+Hercules HWGUn-54
+.It
+Hercules HWNUm-300
+.It
+Planex GW-USNano
+.It
+Sitecom WL-349 v1
+.It
+Sitecom WL-353
+.It
+Sweex LW154
+.It
+TRENDnet TEW-646UBH
+.It
+TRENDnet TEW-648UB
+.It
+TRENDnet TEW-649UB
+.El
.Sh FILES
-.Bl -tag -width ".Pa /usr/share/doc/legal/realtek.LICENSE" -compact
+.Bl -tag -width "/usr/share/doc/legal/realtek.LICENSE" -compact
.It Pa /usr/share/doc/legal/realtek.LICENSE
.Nm
firmware license
@@ -106,45 +147,20 @@ which is loaded when an interface is attached:
.Bl -tag -width Ds -offset indent -compact
.It Pa /boot/kernel/rsu-rtl8712fw.ko
.El
-.Sh HARDWARE
-The
-.Nm
-driver provides support for Realtek RTL8188SU/RTL8192SU USB IEEE 802.11b/g/n
-wireless network adapters, including:
-.Pp
-.Bl -tag -width Ds -offset indent -compact
-.It ASUS USB-N10
-.It ASUS WL-167G V3
-.It Belkin F7D1101 v1
-.It D-Link DWA-131 A1
-.It EDUP EP-MS150N(W)
-.It Edimax EW-7622UMN
-.It Hercules HWGUn-54
-.It Hercules HWNUm-300
-.It Planex GW-USNano
-.It Sitecom WL-349 v1
-.It Sitecom WL-353
-.It Sweex LW154
-.It TRENDnet TEW-646UBH
-.It TRENDnet TEW-648UB
-.It TRENDnet TEW-649UB
-.El
.Sh EXAMPLES
Join an existing BSS network (i.e., connect to an access point):
-.Bd -literal -offset indent
-ifconfig wlan create wlandev rsu0 inet 192.168.0.20 \e
- netmask 0xffffff00
-.Ed
+.Pp
+.Dl ifconfig wlan create wlandev rsu0 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 rsu0 ssid my_net up"
+.Dl ifconfig wlan create wlandev rsu0 ssid my_net up
.Pp
Join a specific BSS network with 64-bit WEP encryption:
.Bd -literal -offset indent
ifconfig wlan create wlandev rsu0 ssid my_net \e
- wepmode on wepkey 0x1234567890 weptxkey 1 up
+ wepmode on wepkey 0x1234567890 weptxkey 1 up
.Ed
.Sh DIAGNOSTICS
.Bl -diag
@@ -163,6 +179,7 @@ This should not happen.
.Xr rsufw 4 ,
.Xr usb 4 ,
.Xr wlan 4 ,
+.Xr networking 7 ,
.Xr arp 8 ,
.Xr hostapd 8 ,
.Xr ifconfig 8 ,
diff --git a/share/man/man4/rtw88.4 b/share/man/man4/rtw88.4
index 898f57beabd8..1165c5763de8 100644
--- a/share/man/man4/rtw88.4
+++ b/share/man/man4/rtw88.4
@@ -1,4 +1,6 @@
.\"-
+.\" SPDX-License-Identifer: BSD-2-Clause
+.\"
.\" Copyright (c) 2022-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 RTW88 4
.Os
.Sh NAME
@@ -65,21 +67,30 @@ 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
+.Sh HARDWARE
+The
.Nm
-supports all 802.11 a/b/g/n and ac
-the compatibility code currently only supports 802.11 a/b/g modes.
-Support for 802.11 n/ac is to come.
+driver supports PCIe devices with the following chipsets:
+.Pp
+.Bl -bullet -offset indent -compact
+.It
+Realtek 802.11n wireless 8723de (RTL8723DE)
+.It
+Realtek 802.11ac wireless 8821ce (RTL8821CE)
+.It
+Realtek 802.11ac wireless 8822be (RTL8822BE)
+.It
+Realtek 802.11ac wireless 8822ce (RTL8822CE)
+.El
.Sh LOADER TUNABLES
.Bl -tag -width indent
.It Va compat.linuxkpi.skb.mem_limit
@@ -93,28 +104,10 @@ This tunable will work around a problem with DMA and limit allocations
for network buffer memory to the lower 32bit of physical memory and
make the driver work.
.El
-.Sh HARDWARE
-The
-.Nm
-driver supports PCIe devices with the following chipsets:
*** 1162 LINES SKIPPED ***