KekenoBSD/src
3
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

man: iwlwifi/rtw88/rtw89: update man pages for Linux v7.0 based updates

Browse Source 
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
This commit is contained in:
Bjoern A. Zeeb
2026-05-15 16:29:48 +00:00
parent 394f8ff461
commit 0a2f7683bf
4 changed files with 134 additions and 137 deletions
Download Patch File Download Diff File Expand all files Collapse all files
share/man/man4/iwlwifi.4
+91 -99
View File
@@ -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.
.\" 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.
.\"
.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,75 +125,33 @@ Intel(R) Wireless N 7260
.It
Intel(R) Dual Band Wireless AC 3160
.It
Intel(R) Dual Band Wireless N 3160
.It
Intel(R) Wireless N 3160
.It
Intel(R) Dual Band Wireless AC 3165
Intel(R) Dual Band Wireless N 3160
.It
Intel(R) Dual Band Wireless AC 3168
Intel(R) Dual Band Wireless-AC 3165
.It
Intel(R) Dual Band Wireless AC 7265
Intel(R) Dual Band Wireless-AC 3168
.It
Intel(R) Wireless N 7265
Intel(R) Dual Band Wireless-AC 7265
.It
Intel(R) Dual Band Wireless N 7265
Intel(R) Dual Band Wireless-N 7265
.It
Intel(R) Dual Band Wireless AC 8260
Intel(R) Wireless-N 7265
.It
Intel(R) Dual Band Wireless N 8260
Intel(R) Dual Band Wireless-AC 8260
.It
Intel(R) Dual Band Wireless AC 4165
Intel(R) Dual Band Wireless-N 8260
.It
Intel(R) Dual Band Wireless AC 8265
Intel(R) Dual Band Wireless-AC 4165
.It
Intel(R) Dual Band Wireless AC 8275
Intel(R) Dual Band Wireless-AC 8265
.It
Killer (R) Wireless-AC 1550 Wireless Network Adapter (9260NGW) 160MHz
Intel(R) Dual Band Wireless-AC 8275
.It
Killer (R) Wireless-AC 1550s Wireless Network Adapter (9560NGW)
Killer(R) Wireless-AC 1435i Wireless Network Adapter (8265D2W)
.It
Killer (R) Wireless-AC 1550i Wireless Network Adapter (9560NGW)
.It
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 6E AX1690s 160MHz Wireless Network Adapter (411D2W)
.It
Killer(R) Wi-Fi 6E AX1690i 160MHz Wireless Network Adapter (411NGW)
.It
Intel(R) Wireless-AC 9260-1
.It
Intel(R) Wi-Fi 6 AX200 160MHz
.It
Killer(R) Wi-Fi 6 AX1650w 160MHz Wireless Network Adapter (200D2W)
.It
Killer(R) Wi-Fi 6 AX1650x 160MHz Wireless Network Adapter (200NGW)
.It
Intel(R) Wi-Fi 6 AX201 160MHz
.It
Killer(R) Wi-Fi 6 AX1650s 160MHz Wireless Network Adapter (201D2W)
.It
Killer(R) Wi-Fi 6 AX1650i 160MHz Wireless Network Adapter (201NGW)
.It
Killer(R) Wi-Fi 6 AX1650s 160MHz Wireless Network Adapter (201NGW)
.It
Killer(R) Wi-Fi 6 AX1650i 160MHz Wireless Network Adapter (201D2W)
.It
Intel(R) Wi-Fi 6E AX211 160MHz
.It
Intel(R) Wi-Fi 6 AX210 160MHz
.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
.It
Killer(R) Wi-Fi 6E AX1675s 160MHz Wireless Network Adapter (211NGW)
.It
Killer(R) Wi-Fi 6E AX1675i 160MHz Wireless Network Adapter (211NGW)
Killer(R) Wireless-AC 1435-KIX Wireless Network Adapter (8265NGW)
.It
Intel(R) Wireless-AC 9461 160MHz
.It
@@ -225,39 +161,93 @@ Intel(R) Wireless-AC 9462 160MHz
.It
Intel(R) Wireless-AC 9462
.It
Intel(R) Wireless-AC 9260 160MHz
.It
Intel(R) Wireless-AC 9260
.It
Intel(R) Wireless-AC 9560 160MHz
.It
Intel(R) Wireless-AC 9560
.It
Intel(R) Wireless-AC 9270 160MHz
.It
Intel(R) Wireless-AC 9270
.It
Intel(R) Wireless-AC 9162 160MHz
.It
Intel(R) Wireless-AC 9162
.It
Intel(R) Wireless-AC 9260 160MHz
.It
Intel(R) Wireless-AC 9260
Intel(R) Wi-Fi 6 AX201 160MHz
.It
Intel(R) Wi-Fi 6 AX101
.It
Intel(R) Wi-Fi 6 AX203
.It
Intel(R) Wi-Fi 6E AX231 160MHz
Intel(R) Wi-Fi 6 AX200 160MHz
.It
Intel(R) Wi-Fi 6E AX211 160MHz
.It
Intel(R) Wi-Fi 6E AX411 160MHz
.It
Intel(R) Wi-Fi 6E AX210 160MHz
.It
Killer(R) Wireless-AC 1550 Wireless Network Adapter (9260NGW) 160MHz
.It
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 (201D2W)
.It
Killer(R) Wi-Fi 6 AX1650i 160MHz Wireless Network Adapter (201NGW)
.It
Killer(R) Wi-Fi 6E AX1675s 160MHz Wireless Network Adapter (211D2W)
.It
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
Killer(R) Wi-Fi 6E AX1690s 160MHz Wireless Network Adapter (411D2W)
.It
Killer(R) Wi-Fi 6E AX1690i 160MHz Wireless Network Adapter (411NGW)
.It
Killer(R) Wi-Fi 6 AX1650w 160MHz Wireless Network Adapter (200D2W)
.It
Killer(R) Wi-Fi 6 AX1650x 160MHz Wireless Network Adapter (200NGW)
.It
Intel(R) Wi-Fi 7 BE201 320MHz
.It
Intel(R) Wi-Fi 7 BE401 320MHz
.It
Intel(R) Wi-Fi 7 BE200 320MHz
.It
Intel(R) Wi-Fi 7 BE202 160MHz
.It
Intel(R) TBD Sc device
Killer(R) Wi-Fi 7 BE1750s 320MHz Wireless Network Adapter (BE201D2W)
.It
Intel(R) TBD Sc2 device
Killer(R) Wi-Fi 7 BE1750i 320MHz Wireless Network Adapter (BE201NGW)
.It
Intel(R) TBD Sc2f device
Killer(R) Wi-Fi 7 BE1790s 320MHz Wireless Network Adapter (BE401D2W)
.It
Killer(R) Wi-Fi 7 BE1790i 320MHz Wireless Network Adapter (BE401NGW)
.It
Killer(TM) Wi-Fi 7 BE1750w 320MHz Wireless Network Adapter (BE200D2W)
.It
Killer(TM) Wi-Fi 7 BE1750x 320MHz Wireless Network Adapter (BE200NGW)
.It
Intel(R) Wi-Fi 7 BE211 320MHz
.It
Intel(R) Wi-Fi 6E AX221 160MHz
.It
Intel(R) Wi-Fi 7 BE213 160MHz
.It
Intel(R) Wi-Fi 8 BN201
.It
Intel(R) Wi-Fi 7 BE223
.It
Intel(R) Wi-Fi 8 BN203
.It
Killer(R) Wi-Fi 7 BE1775s 320MHz Wireless Network Adapter (BE211D2W)
.It
Killer(R) Wi-Fi 7 BE1775i 320MHz Wireless Network Adapter (BE211NGW)
.It
Killer(R) Wi-Fi 8 BN1850w2 320MHz Wireless Network Adapter (BN201.D2W)
.It
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 ,
share/man/man4/iwlwififw.4
+6 -22
View File
@@ -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
share/man/man4/rtw88.4
+18 -9
View File
@@ -1,9 +1,13 @@
.\"-
.\" SPDX-License-Identifier: BSD-2-Clause
.\"
.\" Copyright (c) 2022-2026 Bjoern A. Zeeb
.\" Copyright (c) 2026 The FreeBSD Foundation
.\"
.Dd February 10, 2026
.\" Portions of this documentation were written by Bj\xc3\xb6rn Zeeb
.\" under sponsorship from the FreeBSD Foundation.
.\"
.\" SPDX-License-Identifier: BSD-2-Clause
.\"
.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,
share/man/man4/rtw89.4
+19 -7
View File
@@ -1,9 +1,13 @@
.\"-
.\" SPDX-License-Identifier: BSD-2-Clause
.\"
.\" Copyright (c) 2023-2025 Bjoern A. Zeeb
.\" Copyright (c) 2026 The FreeBSD Foundation
.\"
.Dd June 13, 2025
.\" Portions of this documentation were written by Bj\xc3\xb6rn Zeeb
.\" under sponsorship from the FreeBSD Foundation.
.\"
.\" SPDX-License-Identifier: BSD-2-Clause
.\"
.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,