From nobody Sat Jan 01 21:05:00 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 9238819209CB; Sat, 1 Jan 2022 21:05:00 +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 4JRDzc1hwpz4rbv; Sat, 1 Jan 2022 21:05:00 +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 198D1257AF; Sat, 1 Jan 2022 21:05:00 +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 201L50Kp096167; Sat, 1 Jan 2022 21:05:00 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 201L50Nh096162; Sat, 1 Jan 2022 21:05:00 GMT (envelope-from git) Date: Sat, 1 Jan 2022 21:05:00 GMT Message-Id: <202201012105.201L50Nh096162@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: "Bjoern A. Zeeb" Subject: git: e9016c0be83f - main - iwlwifi: clarify 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/main X-Git-Reftype: branch X-Git-Commit: e9016c0be83f9b1d9cf7c2460ee3b041967bb75f Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1641071100; 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=cB+6/7BUVE4Q3UI7p7m8B4u/Ey2fuZv46m4oto7KUco=; b=QiPN3E5X/ya75T/GgSalxfcR0NqtSvr0sVpg3HZuK0yZf3e5Tk31D2wlXmeAx1IBqH08GT Dg90eVC/BRuO9vFZptDMl/5o2rjaYCtulGxCVVWZIfwM+pGr/Dcm4ydfvbD3Wk83kaSe+4 yctx+wVqSkpb2KdKU6BhRMgklNyYhc5iLFeAfsFqYBHFKC03SbDOcIhIWT0gIcun4/lB0j 79qEKRlr3KKEDCoCB5HIqxh/UhCjTGjCBJrNF4Ry0s25rYQwf9FEv0q1l/Q4MbcTkxpFgB xG3R0BP7rd85cfzxzbCUbdSnS9E5ULp+/k/OD7u0GwomjM0eY9e0sfLr3nZ32Q== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1641071100; a=rsa-sha256; cv=none; b=bBjCHEmBD3hQ2972oJLn7K4WRCL0tkRnv8Q0DrRcTumWjxUGsoURiy+xZ+SMXSRHiVQXsw i4m8UWUYAEPqiQymULuQszcBp50ULkLnHOcTs1tTWv8C3wW43acT+gPVOex1e//xdyvvYT jvJov91F0MgqmCRR/MPEGcms6rAD5DihiqDY6mx+23S3Tn3Z5oYCCcsI1lX2+P6n2BkhDq pNHzHfPtsKGoUiAb3luuJ+VtCzfU5wsBWKeWCHL3Meu7OTekg+AsURctxwnVxAThxtUkYS fuR2GoleytL1AR8edIa+YIIZWQ1RbEJzT1vEQeoXs1WN/OFBFk1PyjWA4FCaOg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by bz: URL: https://cgit.FreeBSD.org/src/commit/?id=e9016c0be83f9b1d9cf7c2460ee3b041967bb75f commit e9016c0be83f9b1d9cf7c2460ee3b041967bb75f Author: Bjoern A. Zeeb AuthorDate: 2022-01-01 18:08:31 +0000 Commit: Bjoern A. Zeeb CommitDate: 2022-01-01 20:57:13 +0000 iwlwifi: clarify 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 MFC after: 3 days Reviewed by: debdrup Differential Revision: https://reviews.freebsd.org/D33713 --- 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