1.\" 2.\" Copyright (c) 2004, 2005 3.\" Damien Bergamini <damien.bergamini@free.fr>. 4.\" Copyright (c) 2004, 2005 5.\" Andrew Atrens <atrens@nortelnetworks.com>. 6.\" 7.\" All rights reserved. 8.\" 9.\" Redistribution and use in source and binary forms, with or without 10.\" modification, are permitted provided that the following conditions 11.\" are met: 12.\" 1. Redistributions of source code must retain the above copyright 13.\" notice unmodified, this list of conditions, and the following 14.\" disclaimer. 15.\" 2. Redistributions in binary form must reproduce the above copyright 16.\" notice, this list of conditions and the following disclaimer in the 17.\" documentation and/or other materials provided with the distribution. 18.\" 19.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND 20.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 21.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 22.\" ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE 23.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 24.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 25.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 26.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 27.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 28.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 29.\" SUCH DAMAGE. 30.\" 31.\" $DragonFly: src/share/man/man4/iwi.4,v 1.7 2007/02/25 12:03:07 swildner Exp $ 32.\" 33.Dd March 1, 2005 34.Os 35.Dt IWI 4 36.Sh NAME 37.Nm iwi 38.Nd Intel(R) PRO/Wireless 2200BG/2915ABG IEEE 802.11 driver 39.Sh SYNOPSIS 40.Cd "device iwi" 41.Cd "device pci" 42.Cd "device wlan" 43.Sh DESCRIPTION 44The 45.Nm 46driver provides support for Intel(R) PRO/Wireless 2200BG and 2915ABG MiniPCI 47network adapters. 48.Pp 49By default, the 50.Nm 51driver configures the adapter for BSS operation (aka infrastructure mode). 52This mode requires the use of an access point. 53.Pp 54In addition IBSS operation (aka adhoc mode) is also supported. This mode requires 55special ibss firmware. See 56.Xr iwicontrol 8 57for more details on how to load firmware. 58.Pp 59For more (general) information on configuring this device, see 60.Xr ifconfig 8 . 61.Sh EXAMPLES 62Join an existing BSS network (ie: connect to an access point): 63.Pp 64.Dl "ifconfig iwi0 inet 192.168.0.20 netmask 0xffffff00" 65.Pp 66Join a specific BSS network with network name 67.Dq Li my_net : 68.Pp 69.Dl "ifconfig iwi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net" 70.Pp 71Join a specific BSS network with 64 bits WEP encryption: 72.Bd -literal -offset indent 73ifconfig iwi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e 74 wepmode on wepkey 0x1234567890 75.Ed 76.Pp 77Join a specific BSS network with 128bits WEP encryption: 78.Bd -literal -offset indent 79ifconfig iwi0 inet 192.168.0.20 netmask 0xffffff00 ssid my_net \e 80 wepmode on wepkey 0x01020304050607080910111213 81.Ed 82.Pp 83To join or create an IBSS network, use something like: 84.Bd -literal -offset indent 85ifconfig iwi0 192.168.0.20 netmask 0xffffff00 ssid my_net \e 86 mediaopt adhoc 87.Ed 88.Pp 89To debug a network setup, you may wish to enable interface debugging: 90.Bd -literal -offset indent 91ifconfig iwi0 down debug up 92.Ed 93.Pp 94To disable debugging, you may simply use: 95.Bd -literal -offset indent 96ifconfig iwi0 down -debug up 97.Ed 98.Sh WORTH NOTING 99It's worth noting that in BSS mode if you haven't specified an 100ssid, the driver will auto-assign an ssid, joining the best 101network available. 102.Pp 103In IBSS mode you must specify an ssid for the driver to join a network. 104If no network exists with the ssid name you have chosen the driver will 105auto-create a standalone IBSS network that others may later join. This 106behaviour is on by default, and may be controlled by - 107.Bd -literal -offset indent 108wicontrol iwi0 -c 0 Disables network auto-create behaviour. 109.Ed 110.Bd -literal -offset indent 111wicontrol iwi0 -c 1 Enables network auto-create behaviour. 112.Ed 113.Sh DIAGNOSTICS 114.Bl -diag 115.It "iwi%d: firmware reset" 116The driver has reset the firmware. This shouldn't but may occasionally happen. 117.It "iwi%d: device timeout" 118The driver will reset the hardware. This should not happen. 119.El 120.Sh SEE ALSO 121.Xr an 4 , 122.Xr ifmedia 4 , 123.Xr pci 4 , 124.Xr wi 4 , 125.Xr wlan 4 , 126.Xr ifconfig 8 , 127.Xr iwicontrol 8 , 128.Xr wicontrol 8 129.Sh AUTHORS 130.An -nosplit 131The 132.Nm 133driver and this man page were derived from those written by 134.An Damien Bergamini Aq damien.bergamini@free.fr . 135.Pp 136.Dx 137enhancements and IBSS support were written by 138.An Andrew Atrens Aq atrens@nortel.com . 139