From nobody Sun Nov 10 19:34:06 2024 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 4XmjXt2qfWz5c8lS; Sun, 10 Nov 2024 19:34:06 +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 "R10" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4XmjXt20tZz4R5D; Sun, 10 Nov 2024 19:34:06 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1731267246; 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=DYl8nybdjipLTRFcSc7BLBg7WzTzRCIC5Hz+31l6oxE=; b=btzcNQgH15YADt9wHUB1jYov8rd0b+z3n8PVeCu8wHo86GaMcF4oalCC3tmxYnD7g/ZXSG LF2OClfWaoycNMTr9ZCvuftUdjCQOMfPWv33LXRiukDKMRz5QgUXD55coW5CufH7jsaJTS 7opYaiMI4iiryS8AJXMTW+6f5uPpfhj6xsKSs2Y54ptg61nzGKQ9//Zznw8JR/PrhRyXvK 7887RhxScUyQxL8Q55RwXsIZHdRzrq14bUG5OnwvGJavaKHwSDcEsMoe79XNF/WS9FHRLY aTi2RjzdJOO/fqA/ZCsHNEUAIWNelts5D9F4yjjDz9lKQT0F0gasHATijauTnA== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1731267246; 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=DYl8nybdjipLTRFcSc7BLBg7WzTzRCIC5Hz+31l6oxE=; b=g0T1O3jCF24yHdd6Rfei5P66htCxr5/YNkXMXyBuFE8TV7n/eylspqfMNUSMSQGXJ3pdY1 omHIR73xCnD6RnL1+b8xchuOkp6JD1A64e++vZlMz0/6SettQY+CJ1TKk2EiJs12WkmmAZ Qd88vm//Go/M9ZKDqWt+hoxhfgQBaSE8WnwXyhLzCYOqIiCtagbsqktNkBHaVfhX2dH+g0 qTLpKerYc4wlrlLcp5gAAkRP+aPfzByeF7s4YfqnTjZXmbWtibPuH987gmdWAPPUCP5iLn LMZ2EkySrEuDF5ZZZBbXC3K46jUMFtz6LrY+tpuUsolJkG6mconUXqQCOKHX1g== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1731267246; a=rsa-sha256; cv=none; b=wWcK3BHA/GJRmWikPQoRP6HgUaWxoYYZcRn4lvIu4xK57n7ZyooL14m95b5H15B1JmAv/l b8RRhu+KB1vg7s+jQqh/etvZHwwM2hCowwUjPgran7xShQSqSDowTYnmf18EYAkO4av69d PduhGvsOXGSBFuobjW0hEpypkE6u2HqXDHUD8SmaHhkDcrqUBkrEgmIQMSKWtESSaBCXbA ZFLaud7CuxqZTzKTuc5WaoKZjztEgLzqBqJhWj7ouIxGQKG2V1TGwTyzNyKjwo1rJtT+Vi h9u8Th5TOK7EksihT9zwv2uLtURSRNjH1RY9REyEcGZRVGzcvO/s04ss1AlpQw== 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 4XmjXt1cXWzvkT; Sun, 10 Nov 2024 19:34:06 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.18.1/8.18.1) with ESMTP id 4AAJY6Bs026732; Sun, 10 Nov 2024 19:34:06 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.18.1/8.18.1/Submit) id 4AAJY6Ac026729; Sun, 10 Nov 2024 19:34:06 GMT (envelope-from git) Date: Sun, 10 Nov 2024 19:34:06 GMT Message-Id: <202411101934.4AAJY6Ac026729@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: 8f1a2d507e25 - main - iwm.4: move hardware list to .Sh HARDWARE and minor cleanup 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: X-BeenThere: dev-commits-src-all@freebsd.org Sender: owner-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: 8f1a2d507e25e77d20a5d7675dc8eee9b83d3570 Auto-Submitted: auto-generated The branch main has been updated by bz: URL: https://cgit.FreeBSD.org/src/commit/?id=8f1a2d507e25e77d20a5d7675dc8eee9b83d3570 commit 8f1a2d507e25e77d20a5d7675dc8eee9b83d3570 Author: Alexander Ziaee AuthorDate: 2024-11-10 19:28:22 +0000 Commit: Bjoern A. Zeeb CommitDate: 2024-11-10 19:33:18 +0000 iwm.4: move hardware list to .Sh HARDWARE and minor cleanup Add devices supported by this driver to a HARDWARE section for inclusion in the Release Hardware Compatibility Notes. While here: - license: add spdx license identifier tag - synopsis: join a line for grep/brevity - description: reflow for consistency, xref iwmfw(4) - examples: use test-net-1 in cidr notation as example IPv4 address - see also: add networking(7) quick start guide - bugs: move 'incompatible modes' here for consistency/flow - mention 802.11a support MFC after: 3 days Reported by: bz (relnotes generation, cidr, test-net-1 ip4addr) Reported by: Graham Percival (no prompt) Reviewed by: bz Differential Revision: https://reviews.freebsd.org/D47171 --- share/man/man4/iwm.4 | 94 ++++++++++++++++++++++++++++++---------------------- 1 file changed, 54 insertions(+), 40 deletions(-) diff --git a/share/man/man4/iwm.4 b/share/man/man4/iwm.4 index b810f7016e54..7fd301929524 100644 --- a/share/man/man4/iwm.4 +++ b/share/man/man4/iwm.4 @@ -1,3 +1,6 @@ +.\"- +.\" SPDX-License-Identifier: BSD-2-Clause +.\" .\" Copyright (c) 2004-2006 .\" Damien Bergamini . All rights reserved. .\" @@ -31,8 +34,7 @@ .Nd Intel IEEE 802.11ac wireless network driver .Sh SYNOPSIS To compile this driver into the kernel, -include the following lines in your -kernel configuration file: +include the following lines in your kernel configuration file: .Bd -ragged -offset indent .Cd "device iwm" .Cd "device pci" @@ -79,55 +81,59 @@ iwm9260fw_load="YES" .Sh DESCRIPTION The .Nm -driver provides support for: -.Pp -.Bl -tag -width Ds -offset indent -compact -.It Intel Dual Band Wireless AC 3160 -.It Intel Dual Band Wireless AC 3165 -.It Intel Dual Band Wireless AC 3168 -.It Intel Dual Band Wireless AC 7260 -.It Intel Dual Band Wireless AC 7265 -.It Intel Dual Band Wireless AC 8260 -.It Intel Dual Band Wireless AC 8265 -.It Intel Dual Band Wireless AC 9260 -.It Intel Dual Band Wireless AC 9270 -.It Intel Dual Band Wireless AC 946X -.It Intel Dual Band Wireless AC 9560 -.El -.Pp -.Nm -supports +driver supports running most Intel Wireless AC series network devices in .Cm station mode operation. Only one virtual interface may be configured at any time. -For more information on configuring this device, see -.Xr ifconfig 8 . -.Pp This driver requires the firmware built with the -.Nm iwmfw +.Xr iwmfw 4 module to work. .Pp -Currently, +For more information on configuring this device, see +.Xr ifconfig 8 . +.Sh HARDWARE +The .Nm -only supports 802.11b and 802.11g modes. -It will not associate to access points that are configured to operate only -in 802.11n or 802.11ac modes. +driver supports the following PCIe Wi-Fi devices: +.Pp +.Bl -bullet -compact +.It +Intel Dual Band Wireless AC 3160 +.It +Intel Dual Band Wireless AC 3165 +.It +Intel Dual Band Wireless AC 3168 +.It +Intel Dual Band Wireless AC 7260 +.It +Intel Dual Band Wireless AC 7265 +.It +Intel Dual Band Wireless AC 8260 +.It +Intel Dual Band Wireless AC 8265 +.It +Intel Dual Band Wireless AC 9260 +.It +Intel Dual Band Wireless AC 9270 +.It +Intel Dual Band Wireless AC 946X +.It +Intel Dual Band Wireless AC 9560 +.El .Sh EXAMPLES Join an existing BSS network (i.e., connect to an access point): -.Bd -literal -offset indent -ifconfig wlan create wlandev iwm0 inet 192.168.0.20 \e - netmask 0xffffff00 -.Ed +.Pp +.Dl ifconfig wlan create wlandev iwm0 inet 192.0.2.20/24 .Pp Join a specific BSS network with network name -.Dq Li my_net : +.Ar my_net : .Pp -.Dl "ifconfig wlan create wlandev iwm0 ssid my_net up" +.Dl ifconfig wlan create wlandev iwm0 ssid my_net up .Pp Join a specific BSS network with 64-bit WEP encryption: .Bd -literal -offset indent ifconfig wlan create wlandev iwm0 ssid my_net \e - wepmode on wepkey 0x1234567890 weptxkey 1 up + wepmode on wepkey 0x1234567890 weptxkey 1 up .Ed .Pp Join a specific BSS network with 128-bit WEP encryption: @@ -155,15 +161,16 @@ Verify the .Xr iwmfw 4 firmware module is present. .It "iwm%d: could not load boot firmware" -An attempt to upload the boot firmware image to the onboard microcontroller -failed. +An attempt to upload the boot firmware image +to the onboard microcontroller failed. This should not happen. .It "iwm%d: could not load microcode" -An attempt to upload the microcode image to the onboard microcontroller failed. +An attempt to upload the microcode image +to the onboard microcontroller failed. This should not happen. .It "iwm%d: could not load main firmware" -An attempt to upload the main firmware image to the onboard microcontroller -failed. +An attempt to upload the main firmware image +to the onboard microcontroller failed. This should not happen. .El .Sh SEE ALSO @@ -174,5 +181,12 @@ This should not happen. .Xr wlan_ccmp 4 , .Xr wlan_tkip 4 , .Xr wlan_wep 4 , +.Xr networking 7 , .Xr ifconfig 8 , .Xr wpa_supplicant 8 +.Sh BUGS +Currently, +.Nm +only supports 802.11a/b/g modes. +It will not associate to access points that are configured to operate +only in 802.11n/ac modes.