git: 0a2f7683bf0c - main - man: iwlwifi/rtw88/rtw89: update man pages for Linux v7.0 based updates
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Fri, 15 May 2026 18:39:05 UTC
The branch main has been updated by bz:
URL: https://cgit.FreeBSD.org/src/commit/?id=0a2f7683bf0cbd57d7cdba0713a3e30b24cbf9b4
commit 0a2f7683bf0cbd57d7cdba0713a3e30b24cbf9b4
Author: Bjoern A. Zeeb <bz@FreeBSD.org>
AuthorDate: 2026-05-15 16:29:48 +0000
Commit: Bjoern A. Zeeb <bz@FreeBSD.org>
CommitDate: 2026-05-15 18:38:52 +0000
man: iwlwifi/rtw88/rtw89: update man pages for Linux v7.0 based updates
For all:
- harmonize Copyright/license section according to style.9 and used
SPDX only.
- mention that the current generation of the driver is based on
Linux version 7.0.
- make linuxkpi.4 and linuxkpi_wlan.4 .Xr as the man pages do exist
these days.
iwlwifi: update the card/chipset names supported (while we still can)
iwlwififw: leave a comment only that we can no longer update the
man page and it will be removed in the future.
rtw88: update supported chipsets and add note to BUGS sections
rtw89: update supported chipsets and add note to BUGS sections
Sponsored by: The FreeBSD Foundation
MFC after: 3 days
Reviewed by: ziaee
Differential Revision: https://reviews.freebsd.org/D57019
---
share/man/man4/iwlwifi.4 | 154 +++++++++++++++++++++------------------------
share/man/man4/iwlwififw.4 | 28 ++-------
share/man/man4/rtw88.4 | 27 +++++---
share/man/man4/rtw89.4 | 26 +++++---
4 files changed, 116 insertions(+), 119 deletions(-)
diff --git a/share/man/man4/iwlwifi.4 b/share/man/man4/iwlwifi.4
index 411af54be9fb..71825507f7c7 100644
--- a/share/man/man4/iwlwifi.4
+++ b/share/man/man4/iwlwifi.4
@@ -1,33 +1,12 @@
.\"
-.\" SPDX-License-Identifier: BSD-2-Clause
-.\"
-.\" Copyright (c) 2021-2025 The FreeBSD Foundation
+.\" Copyright (c) 2021-2026 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.
+.\" SPDX-License-Identifier: BSD-2-Clause
.\"
-.Dd August 19, 2025
+.Dd May 15, 2026
.Dt IWLWIFI 4
.Os
.Sh NAME
@@ -62,7 +41,7 @@ The
driver provides support for Intel Wireless network devices.
.Pp
.Nm
-is derived from Intel's Linux iwlwifi driver.
+is derived from Intel's Linux iwlwifi driver based on Linux version 7.0.
The
.Xr iwm 4
and
@@ -72,7 +51,7 @@ driver.
.Pp
In addition
.Nm
-already supports Intel's Linux iwlwifi/mld chipsets.
+supports the chipsets based on Intel's Linux iwlwifi/mld driver.
.Pp
.Nm
still complements the
@@ -83,10 +62,9 @@ Intel's Linux iwlwifi/dvm, which
does not support.
.Pp
The driver uses the
-.\" No LinuxKPI man pages so no .Xr here.
-.Sy linuxkpi_wlan
+.Xr linuxkpi_wlan 4
and
-.Sy linuxkpi
+.Xr linuxkpi 4
compat framework to bridge between the Linux and
native
.Fx
@@ -147,117 +125,129 @@ Intel(R) Wireless N 7260
.It
Intel(R) Dual Band Wireless AC 3160
.It
+Intel(R) Wireless N 3160
+.It
Intel(R) Dual Band Wireless N 3160
.It
-Intel(R) Wireless N 3160
+Intel(R) Dual Band Wireless-AC 3165
.It
-Intel(R) Dual Band Wireless AC 3165
+Intel(R) Dual Band Wireless-AC 3168
.It
-Intel(R) Dual Band Wireless AC 3168
+Intel(R) Dual Band Wireless-AC 7265
.It
-Intel(R) Dual Band Wireless AC 7265
+Intel(R) Dual Band Wireless-N 7265
.It
-Intel(R) Wireless N 7265
+Intel(R) Wireless-N 7265
.It
-Intel(R) Dual Band Wireless N 7265
+Intel(R) Dual Band Wireless-AC 8260
.It
-Intel(R) Dual Band Wireless AC 8260
+Intel(R) Dual Band Wireless-N 8260
.It
-Intel(R) Dual Band Wireless N 8260
+Intel(R) Dual Band Wireless-AC 4165
.It
-Intel(R) Dual Band Wireless AC 4165
+Intel(R) Dual Band Wireless-AC 8265
.It
-Intel(R) Dual Band Wireless AC 8265
+Intel(R) Dual Band Wireless-AC 8275
.It
-Intel(R) Dual Band Wireless AC 8275
+Killer(R) Wireless-AC 1435i Wireless Network Adapter (8265D2W)
.It
-Killer (R) Wireless-AC 1550 Wireless Network Adapter (9260NGW) 160MHz
+Killer(R) Wireless-AC 1435-KIX Wireless Network Adapter (8265NGW)
.It
-Killer (R) Wireless-AC 1550s Wireless Network Adapter (9560NGW)
+Intel(R) Wireless-AC 9461 160MHz
.It
-Killer (R) Wireless-AC 1550i Wireless Network Adapter (9560NGW)
+Intel(R) Wireless-AC 9461
.It
-Killer(R) Wireless-AC 1550s Wireless Network Adapter (9560D2W) 160MHz
+Intel(R) Wireless-AC 9462 160MHz
.It
-Killer(R) Wireless-AC 1550i Wireless Network Adapter (9560NGW) 160MHz
+Intel(R) Wireless-AC 9462
.It
-Killer(R) Wi-Fi 6E AX1690s 160MHz Wireless Network Adapter (411D2W)
+Intel(R) Wireless-AC 9260 160MHz
.It
-Killer(R) Wi-Fi 6E AX1690i 160MHz Wireless Network Adapter (411NGW)
+Intel(R) Wireless-AC 9260
+.It
+Intel(R) Wireless-AC 9560 160MHz
+.It
+Intel(R) Wireless-AC 9560
+.It
+Intel(R) Wi-Fi 6 AX201 160MHz
.It
-Intel(R) Wireless-AC 9260-1
+Intel(R) Wi-Fi 6 AX101
+.It
+Intel(R) Wi-Fi 6 AX203
.It
Intel(R) Wi-Fi 6 AX200 160MHz
.It
-Killer(R) Wi-Fi 6 AX1650w 160MHz Wireless Network Adapter (200D2W)
+Intel(R) Wi-Fi 6E AX211 160MHz
.It
-Killer(R) Wi-Fi 6 AX1650x 160MHz Wireless Network Adapter (200NGW)
+Intel(R) Wi-Fi 6E AX411 160MHz
.It
-Intel(R) Wi-Fi 6 AX201 160MHz
+Intel(R) Wi-Fi 6E AX210 160MHz
.It
-Killer(R) Wi-Fi 6 AX1650s 160MHz Wireless Network Adapter (201D2W)
+Killer(R) Wireless-AC 1550 Wireless Network Adapter (9260NGW) 160MHz
.It
-Killer(R) Wi-Fi 6 AX1650i 160MHz Wireless Network Adapter (201NGW)
+Killer(R) Wireless-AC 1550s Wireless Network Adapter (9560D2W) 160MHz
+.It
+Killer(R) Wireless-AC 1550i Wireless Network Adapter (9560NGW) 160MHz
.It
-Killer(R) Wi-Fi 6 AX1650s 160MHz Wireless Network Adapter (201NGW)
+Killer(R) Wi-Fi 6 AX1650s 160MHz Wireless Network Adapter (201D2W)
.It
-Killer(R) Wi-Fi 6 AX1650i 160MHz Wireless Network Adapter (201D2W)
+Killer(R) Wi-Fi 6 AX1650i 160MHz Wireless Network Adapter (201NGW)
.It
-Intel(R) Wi-Fi 6E AX211 160MHz
+Killer(R) Wi-Fi 6E AX1675s 160MHz Wireless Network Adapter (211D2W)
.It
-Intel(R) Wi-Fi 6 AX210 160MHz
+Killer(R) Wi-Fi 6E AX1675i 160MHz Wireless Network Adapter (211NGW)
.It
Killer(R) Wi-Fi 6E AX1675w 160MHz Wireless Network Adapter (210D2W)
.It
Killer(R) Wi-Fi 6E AX1675x 160MHz Wireless Network Adapter (210NGW)
.It
-Intel(R) Wi-Fi 6E AX411 160MHz
+Killer(R) Wi-Fi 6E AX1690s 160MHz Wireless Network Adapter (411D2W)
.It
-Killer(R) Wi-Fi 6E AX1675s 160MHz Wireless Network Adapter (211NGW)
+Killer(R) Wi-Fi 6E AX1690i 160MHz Wireless Network Adapter (411NGW)
.It
-Killer(R) Wi-Fi 6E AX1675i 160MHz Wireless Network Adapter (211NGW)
+Killer(R) Wi-Fi 6 AX1650w 160MHz Wireless Network Adapter (200D2W)
.It
-Intel(R) Wireless-AC 9461 160MHz
+Killer(R) Wi-Fi 6 AX1650x 160MHz Wireless Network Adapter (200NGW)
.It
-Intel(R) Wireless-AC 9461
+Intel(R) Wi-Fi 7 BE201 320MHz
.It
-Intel(R) Wireless-AC 9462 160MHz
+Intel(R) Wi-Fi 7 BE401 320MHz
.It
-Intel(R) Wireless-AC 9462
+Intel(R) Wi-Fi 7 BE200 320MHz
.It
-Intel(R) Wireless-AC 9560 160MHz
+Intel(R) Wi-Fi 7 BE202 160MHz
.It
-Intel(R) Wireless-AC 9560
+Killer(R) Wi-Fi 7 BE1750s 320MHz Wireless Network Adapter (BE201D2W)
.It
-Intel(R) Wireless-AC 9270 160MHz
+Killer(R) Wi-Fi 7 BE1750i 320MHz Wireless Network Adapter (BE201NGW)
.It
-Intel(R) Wireless-AC 9270
+Killer(R) Wi-Fi 7 BE1790s 320MHz Wireless Network Adapter (BE401D2W)
.It
-Intel(R) Wireless-AC 9162 160MHz
+Killer(R) Wi-Fi 7 BE1790i 320MHz Wireless Network Adapter (BE401NGW)
.It
-Intel(R) Wireless-AC 9162
+Killer(TM) Wi-Fi 7 BE1750w 320MHz Wireless Network Adapter (BE200D2W)
.It
-Intel(R) Wireless-AC 9260 160MHz
+Killer(TM) Wi-Fi 7 BE1750x 320MHz Wireless Network Adapter (BE200NGW)
.It
-Intel(R) Wireless-AC 9260
+Intel(R) Wi-Fi 7 BE211 320MHz
.It
-Intel(R) Wi-Fi 6 AX101
+Intel(R) Wi-Fi 6E AX221 160MHz
.It
-Intel(R) Wi-Fi 6 AX203
+Intel(R) Wi-Fi 7 BE213 160MHz
.It
-Intel(R) Wi-Fi 6E AX231 160MHz
+Intel(R) Wi-Fi 8 BN201
.It
-Intel(R) Wi-Fi 7 BE201 320MHz
+Intel(R) Wi-Fi 7 BE223
.It
-Intel(R) Wi-Fi 7 BE200 320MHz
+Intel(R) Wi-Fi 8 BN203
.It
-Intel(R) Wi-Fi 7 BE202 160MHz
+Killer(R) Wi-Fi 7 BE1775s 320MHz Wireless Network Adapter (BE211D2W)
.It
-Intel(R) TBD Sc device
+Killer(R) Wi-Fi 7 BE1775i 320MHz Wireless Network Adapter (BE211NGW)
.It
-Intel(R) TBD Sc2 device
+Killer(R) Wi-Fi 8 BN1850w2 320MHz Wireless Network Adapter (BN201.D2W)
.It
-Intel(R) TBD Sc2f device
+Killer(R) Wi-Fi 8 BN1850i 320MHz Wireless Network Adapter (BN201.NGW)
.\" --------------------------------------------------------------------
.El
.Sh LOADER TUNABLES
@@ -318,6 +308,8 @@ directory.
.Xr iwm 4 ,
.Xr iwn 4 ,
.Xr iwx 4 ,
+.Xr linuxkpi 4,
+.Xr linuxkpi_wlan 4,
.Xr wlan 4 ,
.Xr networking 7 ,
.Xr fwget 8 ,
diff --git a/share/man/man4/iwlwififw.4 b/share/man/man4/iwlwififw.4
index 45ee0e757c07..32c9e974b60d 100644
--- a/share/man/man4/iwlwififw.4
+++ b/share/man/man4/iwlwififw.4
@@ -1,31 +1,15 @@
.\"
-.\" SPDX-License-Identifier: BSD-2-Clause
-.\"
-.\" Copyright (c) 2021-2025 The FreeBSD Foundation
+.\" Copyright (c) 2021-2026 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.
+.\" SPDX-License-Identifier: BSD-2-Clause
.\"
-.\" 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.
+.\" NOTE: this man page is obsolete and will be removed in future versions
+.\" of FreeBSD as there is (easy) no way to extract the information anymore
+.\" from the driver. We do leave it currently for completeness until the
+.\" next generation of cards start shipping.
.\"
.Dd May 12, 2025
.Dt IWLWIFIFW 4
diff --git a/share/man/man4/rtw88.4 b/share/man/man4/rtw88.4
index e01f508ef80e..6f60861cf623 100644
--- a/share/man/man4/rtw88.4
+++ b/share/man/man4/rtw88.4
@@ -1,9 +1,13 @@
-.\"-
-.\" SPDX-License-Identifier: BSD-2-Clause
.\"
.\" Copyright (c) 2022-2026 Bjoern A. Zeeb
+.\" Copyright (c) 2026 The FreeBSD Foundation
+.\"
+.\" Portions of this documentation were written by Bj\xc3\xb6rn Zeeb
+.\" under sponsorship from the FreeBSD Foundation.
+.\"
+.\" SPDX-License-Identifier: BSD-2-Clause
.\"
-.Dd February 10, 2026
+.Dd May 15, 2026
.Dt RTW88 4
.Os
.Sh NAME
@@ -28,7 +32,7 @@ It is not possible to load the driver from
.Sh DESCRIPTION
The
.Nm
-driver is derived from Realtek's Linux rtw88 driver.
+driver is derived from Realtek's Linux rtw88 driver based on Linux version 7.0.
.Pp
This driver requires firmware to be loaded before it will work.
The package
@@ -45,10 +49,9 @@ One can use
to install the correct firmware package.
.Pp
The driver uses the
-.\" No LinuxKPI man pages so no .Xr here.
-.Sy linuxkpi_wlan
+.Xr linuxkpi_wlan 4
and
-.Sy linuxkpi
+.Xr linuxkpi 4
compat framework to bridge between the Linux and
native
.Fx
@@ -64,6 +67,8 @@ driver supports PCIe devices with the following chipsets:
.It
Realtek 802.11n wireless 8723de (RTL8723DE)
.It
+Realtek 802.11ac wireless 8814ae (RTL8814AE)
+.It
Realtek 802.11ac wireless 8821ce (RTL8821CE)
.It
Realtek 802.11ac wireless 8822be (RTL8822BE)
@@ -84,6 +89,8 @@ for network buffer memory to the lower 32bit of physical memory and
make the driver work.
.El
.Sh SEE ALSO
+.Xr linuxkpi 4,
+.Xr linuxkpi_wlan 4,
.Xr wlan 4 ,
.Xr networking 7 ,
.Xr fwget 8 ,
@@ -95,14 +102,16 @@ The
driver first appeared in
.Fx 13.2 .
.Sh BUGS
-Certainly.
-.Pp
Does not seem to work (reliably) on machines with more than 4GB of
main memory.
See in the
.Sx LOADER TUNABLES
section above.
.Pp
+At least the 8821CE and 8822BE chipsets have trouble associating,
+which seems to be due to the software scan fallback, the chandef emulation,
+and net80211 interactions, along with a 6s timeout observed in the driver.
+.Pp
While
.Nm
supports 802.11a/b/g/n/ac modes,
diff --git a/share/man/man4/rtw89.4 b/share/man/man4/rtw89.4
index 8c7132673db5..95d75781f995 100644
--- a/share/man/man4/rtw89.4
+++ b/share/man/man4/rtw89.4
@@ -1,9 +1,13 @@
-.\"-
-.\" SPDX-License-Identifier: BSD-2-Clause
.\"
.\" Copyright (c) 2023-2025 Bjoern A. Zeeb
+.\" Copyright (c) 2026 The FreeBSD Foundation
+.\"
+.\" Portions of this documentation were written by Bj\xc3\xb6rn Zeeb
+.\" under sponsorship from the FreeBSD Foundation.
+.\"
+.\" SPDX-License-Identifier: BSD-2-Clause
.\"
-.Dd June 13, 2025
+.Dd May 15, 2026
.Dt RTW89 4
.Os
.Sh NAME
@@ -28,7 +32,7 @@ It is not possible to load the driver from
.Sh DESCRIPTION
The
.Nm
-driver is derived from Realtek's Linux rtw89 driver.
+driver is derived from Realtek's Linux rtw89 driver based on Linux version 7.0.
.Pp
This driver requires firmware to be loaded before it will work.
The package
@@ -45,10 +49,9 @@ One should use
to install the correct firmware package.
.Pp
The driver uses the
-.\" No LinuxKPI man pages so no .Xr here.
-.Sy linuxkpi_wlan
+.Xr linuxkpi_wlan 4
and
-.Sy linuxkpi
+.Xr linuxkpi 4
compat framework to bridge between the Linux and
native
.Fx
@@ -68,6 +71,8 @@ Realtek 8852AE Wi-Fi 6 (RTL8852AE)
.It
Realtek 8852BE Wi-Fi 6 (RTL8852BE)
.It
+Realtek 8852BTE Wi-Fi 6 (RTL8852BE-VT)
+.It
Realtek 8852CE Wi-Fi 6E (RTL8852CE)
.It
Realtek 8922AE Wi-Fi 7 (RTL8922AE)
@@ -86,6 +91,8 @@ for network buffer memory to the lower 32bit of physical memory and
make the driver work.
.El
.Sh SEE ALSO
+.Xr linuxkpi 4,
+.Xr linuxkpi_wlan 4,
.Xr wlan 4 ,
.Xr networking 7 ,
.Xr fwget 8 ,
@@ -105,6 +112,11 @@ See in the
.Sx LOADER TUNABLES
section above.
.Pp
+We observe various stability issues leading up to driver crashes and
+kernel panics with the current set of chipsets at least in combination
+with
+.Xr linuxkpi_wlan 4 .
+.Pp
While
.Nm
supports 802.11a/b/g/n/ac/ax modes,