The branch main has been updated by bz: URL: https://cgit.FreeBSD.org/src/commit/?id=0a2f7683bf0cbd57d7cdba0713a3e30b24cbf9b4
commit 0a2f7683bf0cbd57d7cdba0713a3e30b24cbf9b4 Author: Bjoern A. Zeeb <[email protected]> AuthorDate: 2026-05-15 16:29:48 +0000 Commit: Bjoern A. Zeeb <[email protected]> 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,
