From 3569e353ca63336d80ab0143dd9669b0b9e6b123 Mon Sep 17 00:00:00 2001 From: sam Date: Sun, 20 Apr 2008 20:35:46 +0000 Subject: Multi-bss (aka vap) support for 802.11 devices. Note this includes changes to all drivers and moves some device firmware loading to use firmware(9) and a separate module (e.g. ral). Also there no longer are separate wlan_scan* modules; this functionality is now bundled into the wlan module. Supported by: Hobnob and Marvell Reviewed by: many Obtained from: Atheros (some bits) --- share/man/man4/iwi.4 | 71 +++++++++++++++++++++++++++++----------------------- 1 file changed, 39 insertions(+), 32 deletions(-) (limited to 'share/man/man4/iwi.4') diff --git a/share/man/man4/iwi.4 b/share/man/man4/iwi.4 index 8a6e9bc..8f82df2 100644 --- a/share/man/man4/iwi.4 +++ b/share/man/man4/iwi.4 @@ -25,7 +25,7 @@ .\" .\" $FreeBSD$ .\" -.Dd March 6, 2007 +.Dd Apri 13, 2008 .Os .Dt IWI 4 .Sh NAME @@ -33,31 +33,28 @@ .Nd "Intel PRO/Wireless 2200BG/2225BG/2915ABG IEEE 802.11 driver" .Sh SYNOPSIS To compile this driver into the kernel, -place the following lines in your +include the following lines in your kernel configuration file: .Bd -ragged -offset indent .Cd "device iwi" +.Cd "device iwifw" .Cd "device pci" .Cd "device wlan" .Cd "device firmware" .Ed .Pp Alternatively, to load the driver as a -module at boot time, place the following lines in +module at boot time, place the following line in .Xr loader.conf 5 : .Bd -literal -offset indent if_iwi_load="YES" -wlan_load="YES" -firmware_load="YES" .Ed .Pp -In both cases, place the following lines in +In both cases, place the following line in .Xr loader.conf 5 -to load the firmware modules: +to acknowledge the firmware license (see below): .Bd -literal -offset indent -iwi_bss_load="YES" -iwi_ibss_load="YES" -iwi_monitor_load="YES" +legal.intel_iwi.license_ack=1 .Ed .Sh DESCRIPTION The @@ -65,19 +62,23 @@ The driver provides support for .Tn Intel PRO/Wireless 2200BG/2915ABG MiniPCI and 2225BG PCI network adapters. -.Pp -By default, the .Nm -driver configures the adapter for BSS operation (aka infrastructure mode). -This mode requires the use of an access point. -.Pp +supports +.Cm station , +.Cm adhoc , +and +.Cm monitor +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 firmware to be loaded before it will work. -For the loaded firmware to work the license at +This driver requires the firmware built with the +.Nm iwifw +module to work. +For the loaded firmware to be enabled for use the license at .Pa /usr/share/doc/legal/intel_iwi/LICENSE -must be agreed to and the following line be added to +must be agreed by adding the following line to .Xr loader.conf 5 : .Pp .Dl "legal.intel_iwi.license_ack=1" @@ -90,22 +91,25 @@ firmware license .Sh EXAMPLES Join an existing BSS network (i.e., connect to an access point): .Pp -.Dl "ifconfig iwi0 inet 192.168.0.20 netmask 0xffffff00" +.Bd -literal -offset indent +ifconfig wlan create wlandev iwi0 inet 192.168.0.20 \e + netmask 0xffffff00 +.Ed .Pp Join a specific BSS network with network name .Dq Li my_net : .Pp -.Dl "ifconfig iwi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net" +.Dl "ifconfig wlan create wlandev iwi0 ssid my_net up" .Pp Join a specific BSS network with 64-bit WEP encryption: .Bd -literal -offset indent -ifconfig iwi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e - wepmode on wepkey 0x1234567890 weptxkey 1 +ifconfig wlan create wlandev iwi0 ssid my_net \e + wepmode on wepkey 0x1234567890 weptxkey 1 up .Ed .Pp Join a specific BSS network with 128-bit WEP encryption: .Bd -literal -offset indent -ifconfig iwi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e +ifconfig wlan create wlandev iwi0 wlanmode adhoc ssid my_net \e wepmode on wepkey 0x01020304050607080910111213 weptxkey 1 .Ed .Sh DIAGNOSTICS @@ -114,7 +118,7 @@ ifconfig iwi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e The driver will reset the hardware. This should not happen. .It "iwi%d: firmware error" -The onboard microcontroller crashes for some reason. +The onboard microcontroller crashed for some reason. The driver will reset the hardware. This should not happen. .It "iwi%d: timeout waiting for firmware initialization to complete" @@ -124,8 +128,9 @@ This should not happen. The driver failed to load the firmware image using the .Xr firmware 9 subsystem. -Verify that the necessary firmware modules are loaded and the -license agreement +Verify the +.Xr iwifw 4 +firmware module is installed and the license agreement .Xr loader 8 tunable has been set. .It "iwi%d: could not load boot firmware" @@ -141,14 +146,16 @@ failed. This should not happen. .El .Sh SEE ALSO -.Xr altq 4 , -.Xr ipw 4 , +.Xr iwifw 4 , .Xr pci 4 , .Xr wlan 4 , -.Xr wpi 4 , -.Xr ifconfig 8 +.Xr wlan_ccmp 4 , +.Xr wlan_tkip 4 , +.Xr wlan_wep 4 , +.Xr ifconfig 8 , +.Xr wpa_supplicant 8 . .Sh AUTHORS -The +The original .Nm driver was written by -.An Damien Bergamini Aq damien@FreeBSD.org . +.An Damien Bergamini Aq damien.bergamini@free.fr -- cgit v1.1