From nobody Sun Jan 09 02:39:57 2022 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 9932B1933735; Sun, 9 Jan 2022 02:39:58 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4JWh4t0tXrz3qnR; Sun, 9 Jan 2022 02:39:58 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id B110A1EF0; Sun, 9 Jan 2022 02:39:57 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 2092dvpE095364; Sun, 9 Jan 2022 02:39:57 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 2092dvGX095362; Sun, 9 Jan 2022 02:39:57 GMT (envelope-from git) Date: Sun, 9 Jan 2022 02:39:57 GMT Message-Id: <202201090239.2092dvGX095362@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: "Bjoern A. Zeeb" Subject: git: aef4a2f5a8e8 - stable/13 - iwlwifi: clarifying man page update List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: bz X-Git-Repository: src X-Git-Refname: refs/heads/stable/13 X-Git-Reftype: branch X-Git-Commit: aef4a2f5a8e84fcae7baf9fa832349883ff64260 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1641695998; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=J0tiw5M1DPcq4aChPO+1ydo/3DAvNtlhHrijzQsUqQE=; b=evJZdt859E9DIwD/PUybck7sOBmygg4udS+7gwOIKOtmi4jR1w5cu/xB5YX+Y1sals0IG7 /+aJD96OLwQ7EK7v9l+dCPTNPxvfJ8LhiubWmwmugFGGaY9hwkJGhgjYp0sw3M0q2yZUM/ IZvUwaMCmluZsWfqpeWA4Krr29Fv7IP1ZX+xJnRWiuHOLMIRK+PwPaKfMk6laJA8Hptn9h NmR9i4Ciweug9AoMBsxvdPkL0FozUXJo4V+CA6fkGPeZsrGpc5i+wS5laJoZdaCkFU+e/X Swk9rpERffBP34k74c/bP9XlOhon7sCCRguHB1MByziQZ/LnCylGUT72kZKVSQ== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1641695998; a=rsa-sha256; cv=none; b=sExdQ/eKDMy+lVJN826UQIo/WYRe+bLdvl8hC0dEINXvmITRw9iB32PctJ8cO15i/pThM/ g1DWWt8Kc1mb7Ya3gMXupwL+3H1aChso6E0omdaidbzkBE6lBMUqUGy4ZSnEYjFD2mosaX 4GVYuYbPuWfnRy/1b/iQB03jCbCd3cQGM6j9XavjerXby0DJBpZqaUtn5LHUJlKd0IHYBx G29BdHO14QVgkJ0XHUDb35URbIFiiQF0bhRz2oodceTkwjf9zhCsBsCOyKFboaa7Pv8PhS c5CpQJvB3GkBsoSKoMUBTVdiFS9nKM3mBSpv9nV9rz+hB7F9Y7UDbtrd8GYKcg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch stable/13 has been updated by bz: URL: https://cgit.FreeBSD.org/src/commit/?id=aef4a2f5a8e84fcae7baf9fa832349883ff64260 commit aef4a2f5a8e84fcae7baf9fa832349883ff64260 Author: Bjoern A. Zeeb AuthorDate: 2022-01-01 18:08:31 +0000 Commit: Bjoern A. Zeeb 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