From 6d8bdc65446a704d0750217efd05532fc641ea7d Mon Sep 17 00:00:00 2001 From: Jacob McDonnell Date: Sat, 25 Apr 2026 14:02:27 -0400 Subject: docs: OpenBSD Man Pages Added --- static/openbsd/man4/iwm.4 | 169 ++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 169 insertions(+) create mode 100644 static/openbsd/man4/iwm.4 (limited to 'static/openbsd/man4/iwm.4') diff --git a/static/openbsd/man4/iwm.4 b/static/openbsd/man4/iwm.4 new file mode 100644 index 00000000..75e54ec9 --- /dev/null +++ b/static/openbsd/man4/iwm.4 @@ -0,0 +1,169 @@ +.\" $OpenBSD: iwm.4,v 1.48 2025/12/01 16:30:46 stsp Exp $ +.\" +.\" Copyright (c) 2007,2008 +.\" Damien Bergamini . All rights reserved. +.\" +.\" Permission to use, copy, modify, and distribute this software for any +.\" purpose with or without fee is hereby granted, provided that the above +.\" copyright notice and this permission notice appear in all copies. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES +.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF +.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR +.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES +.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN +.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF +.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. +.\" +.Dd $Mdocdate: December 1 2025 $ +.Dt IWM 4 +.Os +.Sh NAME +.Nm iwm +.Nd Intel 7000/8000/9000 IEEE 802.11a/ac/b/g/n wireless network device +.Sh SYNOPSIS +.Cd "iwm* at pci?" +.Sh DESCRIPTION +The +.Nm +driver provides support for Intel Wireless +7260, 7265, 3160, 3165, 3168, 8260, 8265, and 9260 +PCIe Mini Card and M.2 network adapters, +and for Intel Wireless 9560 Integrated Connectivity (CNVi) network +adapters with companion RF M.2 modules. +.Pp +These are the modes the +.Nm +driver can operate in: +.Bl -tag -width "IBSS-masterXX" +.It BSS mode +Also known as +.Em infrastructure +mode, this is used when associating with an access point, through +which all traffic passes. +This mode is the default. +.It monitor mode +In this mode the driver is able to receive packets without +associating with an access point. +This disables the internal receive filter and enables the card to +capture packets from networks which it wouldn't normally have access to, +or to scan for access points. +.El +.Pp +The +.Nm +driver can be configured to use +Wired Equivalent Privacy (WEP) or +Wi-Fi Protected Access (WPA1 and WPA2). +WPA2 is currently the most secure encryption standard for wireless networks +supported by +.Ox . +It is strongly recommended that neither WEP nor WPA1 +are used as the sole mechanism to secure wireless communication, +due to serious weaknesses. +WPA1 is disabled by default and may be enabled using the option +.Qq Cm wpaprotos Ar wpa1,wpa2 . +For standard WPA networks which use pre-shared keys (PSK), +keys are configured using the +.Qq Cm wpakey +option. +WPA-Enterprise networks require use of the wpa_supplicant package. +The +.Nm +driver offloads both encryption and decryption of unicast data frames to the +hardware for the CCMP cipher. +.Pp +The +.Nm +driver supports protected management frames (PMF) which prevents spoofing +of management frames such as deauthentication, disassociation, and block-ack +negotiation, on networks using WPA. +.Pp +In BSS mode the driver supports background scanning; +see +.Xr ifconfig 8 . +.Pp +The +.Nm +driver can be configured at runtime with +.Xr ifconfig 8 +or on boot with +.Xr hostname.if 5 . +.Sh FILES +The driver needs one of the following firmware files, +which are loaded when an interface is brought up: +.Pp +.Bl -tag -width Ds -offset indent -compact +.It Pa /etc/firmware/iwm-3160-17 +.It Pa /etc/firmware/iwm-3168-29 +.It Pa /etc/firmware/iwm-7260-17 +.It Pa /etc/firmware/iwm-7265-17 +.It Pa /etc/firmware/iwm-7265D-29 +.It Pa /etc/firmware/iwm-8000C-36 +.It Pa /etc/firmware/iwm-8265-36 +.It Pa /etc/firmware/iwm-9000-46 +.It Pa /etc/firmware/iwm-9260-46 +.El +.Pp +These firmware files are not free because Intel refuses to grant +distribution rights without contractual obligations. +As a result, even though +.Ox +includes the driver, the firmware files cannot be included and +users have to download these files on their own. +.Pp +A prepackaged version of the firmware can be installed using +.Xr fw_update 8 . +.Sh EXAMPLES +The following example scans for available networks: +.Pp +.Dl # ifconfig iwm0 scan +.Pp +The following +.Xr hostname.if 5 +example configures iwm0 to join network +.Dq mynwid , +using WPA key +.Dq mywpakey , +obtaining an IP address using DHCP: +.Bd -literal -offset indent +join mynwid wpakey mywpakey +inet autoconf +.Ed +.Sh DIAGNOSTICS +.Bl -diag +.It "iwm0: device timeout" +A frame dispatched to the hardware for transmission did not complete in time. +The driver will reset the hardware. +This should not happen. +.It "iwm0: fatal firmware error" +For some reason, the firmware crashed. +The driver will reset the hardware. +This should not happen. +.It "iwm0: radio is disabled by hardware switch" +The radio transmitter is off and thus no packet can go out. +The driver will reset the hardware. +Make sure the laptop radio switch is on. +.It "iwm0: could not read firmware ... (error N)" +For some reason, the driver was unable to read the firmware image from the +filesystem. +The file might be missing or corrupted. +.It "iwm0: firmware too short: N bytes" +The firmware image is corrupted and can't be loaded into the adapter. +.It "iwm0: could not load firmware" +An attempt to load the firmware into the adapter failed. +The driver will reset the hardware. +.El +.Sh SEE ALSO +.Xr arp 4 , +.Xr ifmedia 4 , +.Xr intro 4 , +.Xr netintro 4 , +.Xr pci 4 , +.Xr hostname.if 5 , +.Xr ifconfig 8 +.Sh HISTORY +The +.Nm +device driver first appeared in +.Ox 5.7 . -- cgit v1.2.3