Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 9 Jan 2022 02:39:57 GMT
From:      "Bjoern A. Zeeb" <bz@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org
Subject:   git: aef4a2f5a8e8 - stable/13 - iwlwifi: clarifying man page update
Message-ID:  <202201090239.2092dvGX095362@gitrepo.freebsd.org>

next in thread | raw e-mail | index | archive | help
The branch stable/13 has been updated by bz:

URL: https://cgit.FreeBSD.org/src/commit/?id=aef4a2f5a8e84fcae7baf9fa832349883ff64260

commit aef4a2f5a8e84fcae7baf9fa832349883ff64260
Author:     Bjoern A. Zeeb <bz@FreeBSD.org>
AuthorDate: 2022-01-01 18:08:31 +0000
Commit:     Bjoern A. Zeeb <bz@FreeBSD.org>
CommitDate: 2022-01-09 02:39:00 +0000

    iwlwifi: clarifying man page update
    
    Based on some feedback clarify the man page for
    - how to load the driver currently
    - status of the driver with respect to iwm(4)
    and leave a comment to (automatically) add a full list of chipsets
    to the man page.
    
    Sponsored by:   The FreeBSD Foundation
    Reviewed by:    debdrup
    Differential Revision: https://reviews.freebsd.org/D33713
    
    (cherry picked from commit e9016c0be83f9b1d9cf7c2460ee3b041967bb75f)
---
 share/man/man4/iwlwifi.4   | 29 ++++++++++++++++++++---------
 share/man/man4/iwlwififw.4 |  4 +++-
 2 files changed, 23 insertions(+), 10 deletions(-)

diff --git a/share/man/man4/iwlwifi.4 b/share/man/man4/iwlwifi.4
index 5d96b263c9e2..1f79319aad61 100644
--- a/share/man/man4/iwlwifi.4
+++ b/share/man/man4/iwlwifi.4
@@ -27,7 +27,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd October 27, 2021
+.Dd January 1, 2022
 .Dt iwlwifi 4
 .Os
 .Sh NAME
@@ -35,14 +35,21 @@
 .Nd Intel IEEE 802.11a/b/g/n/ac/ax wireless network driver
 .Sh SYNOPSIS
 To load the driver as a module at boot time, place the following lines in
-.Xr loader.conf 5 :
+.Xr rc.conf 5 :
 .Bd -literal -offset indent
-if_iwlwifi_load="YES"
+kld_list="${kld_list} if_iwlwifi"
 .Ed
 .Pp
 The driver should automatically load any
 .Xr iwlwififw 4
-firmware needed for the particular chipset.
+firmware needed for the particular chipset in that case.
+.Pp
+It is anticipated that the driver will support auto-loading via
+.Xr devmatch 8
+in the future and will need no configuration at all.
+.Pp
+It is discouraged to load the driver from
+.Xr loader 8 .
 .Sh DESCRIPTION
 The
 .Nm
@@ -50,12 +57,14 @@ driver is derived from Intel's Linux iwlwifi driver and provides support for
 all chipsets supported by the
 .Em mvm
 part of that driver.
-This superseeds the
+.\" XXX-BZ find way to add full list of chipsets automatically
+.Nm
+will be a successor to
 .Xr iwm 4
-driver which provided support for a subset of these chipsets and still
-complements the
+and may superseed that driver in the future.
+It still complements the
 .Xr iwn 4
-driver supporting older chipsets.
+driver which supports older chipsets.
 .Pp
 The driver uses the
 .\" No LinuxKPI man pages so no .Xr here.
@@ -63,7 +72,9 @@ The driver uses the
 and
 .Em linuxkpi
 compat framework to bridge between the Linux and
-native FreeBSD driver code.
+native FreeBSD driver code as well as to the native
+.Xr net80211 4
+wireless stack.
 .Pp
 While
 .Nm
diff --git a/share/man/man4/iwlwififw.4 b/share/man/man4/iwlwififw.4
index 81daaa02817a..d38d38f28695 100644
--- a/share/man/man4/iwlwififw.4
+++ b/share/man/man4/iwlwififw.4
@@ -27,7 +27,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd November 30, 2021
+.Dd January 1, 2022
 .Dt iwlwififw 4
 .Os
 .Sh NAME
@@ -37,6 +37,8 @@
 The
 .Xr iwlwifi 4
 driver should auto-load any firmware needed.
+It is discouraged to load the driver or firmware manually from
+.Xr loader 8 .
 .Sh DESCRIPTION
 Multiple modules provide access to firmware for the various chipset
 models supported by the



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202201090239.2092dvGX095362>