diff options
Diffstat (limited to 'share/man/man4/wi.4')
-rw-r--r-- | share/man/man4/wi.4 | 377 |
1 files changed, 377 insertions, 0 deletions
diff --git a/share/man/man4/wi.4 b/share/man/man4/wi.4 new file mode 100644 index 0000000..92dedff --- /dev/null +++ b/share/man/man4/wi.4 @@ -0,0 +1,377 @@ +.\" Copyright (c) 1997, 1998, 1999 +.\" Bill Paul <wpaul@ctr.columbia.edu>. All rights reserved. +.\" +.\" Redistribution and use in source and binary forms, with or without +.\" modification, are permitted provided that the following conditions +.\" are met: +.\" 1. Redistributions of source code must retain the above copyright +.\" notice, this list of conditions and the following disclaimer. +.\" 2. Redistributions in binary form must reproduce the above copyright +.\" notice, this list of conditions and the following disclaimer in the +.\" documentation and/or other materials provided with the distribution. +.\" 3. All advertising materials mentioning features or use of this software +.\" must display the following acknowledgement: +.\" This product includes software developed by Bill Paul. +.\" 4. Neither the name of the author nor the names of any co-contributors +.\" may be used to endorse or promote products derived from this software +.\" without specific prior written permission. +.\" +.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND +.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE +.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE +.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD +.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR +.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF +.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS +.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN +.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) +.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF +.\" THE POSSIBILITY OF SUCH DAMAGE. +.\" +.\" $FreeBSD$ +.\" $OpenBSD: wi.4tbl,v 1.14 2002/04/29 19:53:50 jsyn Exp $ +.\" +.Dd July 23, 2011 +.Dt WI 4 +.Os +.Sh NAME +.Nm wi +.Nd "Lucent Hermes, and Intersil PRISM IEEE 802.11 driver" +.Sh SYNOPSIS +To compile this driver into the kernel, +place the following lines in your +kernel configuration file: +.Bd -ragged -offset indent +.Cd "device wi" +.Cd "device wlan" +.Ed +.Pp +Alternatively, to load the driver as a +module at boot time, place the following line in +.Xr loader.conf 5 : +.Bd -literal -offset indent +if_wi_load="YES" +.Ed +.Sh DESCRIPTION +The +.Nm +driver provides support for 802.11b wireless network adapters based around +the Lucent Hermes, Intersil PRISM-II, Intersil PRISM-2.5, and Intersil +Prism-3 chipsets. +All chipsets provide a similar interface to the driver. +Only the Intersil chipsets support access point operation or WPA. +Very old versions of firmware are not supported at all. +Older versions of the firmware that are supported may severely limit +the ability to use these cards in newer networks. +Only relatively recent versions of Intersil firmware supports WPA. +See CAVEATS for details. +All host/device interaction is via programmed I/O, even on those cards +that support a DMA interface. +.Pp +For more information on configuring this device, see +.Xr ifconfig 8 . +.Pp +.Nm +supports +.Cm station , +.Cm adhoc , +.Cm adhoc-demo , +.Cm hostap , +and +.Cm monitor +mode operation. +Only one +virtual interface may be configured at a time. +For more information on configuring this device, see +.Xr ifconfig 8 . +.Pp +Cards supported by the +.Nm +driver come in a variety of packages, though the most common +are of the PCMCIA type. +In many cases, the PCI version of a wireless card is simply +a PCMCIA card bundled with a PCI adapter. +The PCI adapters come in two flavors: true PCMCIA bridges and +dumb PCMCIA bridges. +A true PCMCIA bridge (such as those sold by Lucent) will attach +as a real PCMCIA controller. +The wireless card will then attach to the PCMCIA bus. +Wireless cards in PCMCIA slots may be inserted and ejected on the fly. +.Pp +A dumb bridge, on the other hand, does not show up as a true PCMCIA bus. +The wireless card will simply appear to the host as a normal PCI +device and will not require any PCMCIA support. +Cards in this type of adapter should only be removed when the +machine is powered down. +.Pp +The following cards are among those supported by the +.Nm +driver: +.Pp +.Bl -column -compact "Linksys Instant Wireless WPC11 2.5" "Spectrum24" "PCI or PCMCIA" +.Em "Card Chip Bus" +3Com AirConnect 3CRWE777A Prism-II PCI +Accton airDirect WN3301 PCMCIA +ACTIONTEC HWC01170 Prism-2.5 PCMCIA +Adaptech ANW-8030 Prism-3 PCMCIA +Addtron AWP-100 Prism-II PCMCIA +Adtec Adlink/340C Prism-II PCMCIA +Airvast WN 100 Prism-3 PCMCIA +Airway 802.11 Adapter PCMCIA +Agere Orinoco Hermes PCMCIA +Allied Telesis WR211PCM Prism-II PCMCIA +ArTem OnAir Prism? PCMCIA +Asus WL100 Prism-2.5 PCMCIA +Avaya Wireless Prism-II PCMCIA +Bay eMobility 11B Prism-2.5? PCMCIA +Blue Concentric Circle WL-379F Prism-II CF +BreezeNet Wireless Prism-II PCMCIA +Buffalo WLI-PCM-S11 Prism-II PCMCIA +Buffalo WLI-PCM-L11G Hermes PCMCIA +Buffalo WLI-CF-S11G Prism-II CF +Buffalo WLI2-CF-S11G Prism 2.5 CF +Cabletron RoamAbout Hermes PCMCIA +Compaq Agency NC5004 Prism-II PCMCIA +Compaq WL100 Prism-II PCMCIA +Compaq WL110 Hermes PCMCIA +Compaq WL200 Prism-II PCMCIA +Contec FLEXLAN/FX-DS110-PCC Prism-II PCMCIA +Corega PCC-11 Prism-II PCMCIA +Corega PCCA-11 Prism-II PCMCIA +Corega PCCB-11 Prism-II PCMCIA +Corega CGWLPCIA11 Prism-II PCI +Dell TrueMobile 1150 Hermes PCMCIA +Dlink Air 660 Prism-II PCMCIA +Dlink DWL520 Prism-2.5 PCI +Dlink DWL650 Prism-2.5 PCMCIA +ELECOM Air@Hawk/LD-WL11/PCC PCMCIA +ELSA MC-11 PCMCIA +ELSA XI300 Prism-II PCMCIA +ELSA XI325 Prism-2.5 PCMCIA +ELSA APDL325 Prism-2.5 PCMCIA +ELSA XI330 Prism-3 PCMCIA +ELSA XI800 Prism-II CF +EMTAC A2424i Prism-II PCMCIA +Farallon Skyline Prism-II PCMCIA +Gemtek WL-311 Prism-2.5 PCMCIA +Hawking Technology WE110P Prism-2.5 PCMCIA +Home Wireless Networks Prism-II PCMCIA +IBM High Rate Wireless Hermes PCMCIA +ICOM SL-1100 Prism-II PCMCIA +I-O DATA WN-B11/PCM Prism-II PCMCIA +Intersil Prism II Prism-II PCMCIA +Intersil Mini-PCI Prism-2.5 PCI +Intersil ISL37100P Prism-3 PCMCIA +Intersil ISL37110P Prism-3 PCMCIA +Intersil ISL37300P Prism-3 PCMCIA +Laneed Wireless PCMCIA +Linksys Instant Wireless WPC11 Prism-II PCMCIA +Linksys Instant Wireless WPC11 2.5 Prism-2.5 PCMCIA +Linksys Instant Wireless WPC11 3.0 Prism-3 PCMCIA +Linksys WCF11 Prism-3 PCMCIA +Linksys WCF12 Prism-3 CF +Lucent WaveLAN Hermes PCMCIA +Melco Airconnect Prism-II PCMCIA +Microsoft MN-520 WLAN Prism-II PCMCIA +NANOSPEED ROOT-RZ2000 Prism-II PCMCIA +NCR WaveLAN/IEEE 802.11 PCMCIA +NDC/Sohoware NCP130 Prism-II PCI +NEC CMZ-RT-WP Prism-II PCMCIA +NEC PK-WL001 Lucent PCMCIA +NEC PC-WL/11C Prism-II PCMCIA +Netgear MA311 Prism-2.5 PCI +Netgear MA401 Prism-II/2.5 PCMCIA +Netgear MA401RA Prism-II PCMCIA +Netgear MA701 Prism-II CF +NOKIA C020 WLAN Prism-II PCMCIA +NOKIA C110 WLAN Prism-2.5 PCMCIA +NTT-ME 11Mbps Wireless LAN Prism-II PCMCIA +Planex GeoWave/GW-NS110 Prism-II PCMCIA +Planex GW-NS11H Prism-II PCMCIA +Proxim Harmony Prism-II PCMCIA +Proxim RangeLAN-DS Prism-II PCMCIA +Samsung MagicLAN SWL-2000N Prism-II PCMCIA +SENAO SL-2511CD Prism-3 PCMCIA +Siemens SpeedStream SS1021 Prism-II PCMCIA +Siemens SpeedStream SS1021 Prism-3 PCMCIA +SMC 2532W-B Prism-II PCMCIA +SMC 2602 EZ Connect (3.3V) Prism-II PCI or PCMCIA +SMC 2632 EZ Connect Prism-II PCMCIA +Socket Low Power WLAN-CF Prism-II CF +Sony PCWA-C100 Lucent PCMCIA +Sony PEGA-WL110 Prism-2.5 PCMCIA +TDK LAK-CD011WL Prism-II PCMCIA +Toshiba Wireless LAN Card Prism-II PCMCIA +U.S.\& Robotics Wireless Card 2410 Prism-II PCMCIA +YIS YWL-11B Prism-II PCMCIA +.El +.Pp +Several vendors sell PCI adapters built around the PLX Technology 9050 +or 9052 chip. +The following such adapters are supported or expected to work: +.Pp +.Bl -item -compact +.It +3Com AirConnect 3CRWE777A (3.3V) +.It +Belkin F5D6000 (a rebadged WL11000P) +.It +Eumitcom WL11000P +.It +Global Sun Technology GL24110P (untested) +.It +Global Sun Technology GL24110P02 +.It +LinkSys WDT11 (a rebadged GL24110P02) +.It +Netgear MA301 +.It +US Robotics 2415 (rebadged WL11000P) +.It +Wisecom Wireless LAN PCI Adapter +.El +.Pp +The following adapters have the same model numbers as those listed +above, but might not work if the actual card is after the change away +from the Prism family: +.Pp +.Bl -item -compact +.It +DLink DWL520 +.El +.Sh EXAMPLES +Join an existing BSS network (ie: connect to an access point): +.Bd -literal -offset indent +ifconfig wlan create wlandev wi0 inet 192.168.0.20 \e + netmask 0xffffff00 +.Ed +.Pp +Join a specific BSS network with network name +.Dq Li my_net : +.Bd -literal -offset indent +ifconfig wlan create wlandev wi0 inet 192.168.0.20 \e + netmask 0xffffff00 ssid my_net +.Ed +.Pp +Join a specific BSS network with WEP encryption: +.Bd -literal -offset indent +ifconfig wlan create wlandev wi0 inet 192.168.0.20 \e + netmask 0xffffff00 ssid my_net \e + wepmode on wepkey 0x8736639624 weptxkey 1 +.Ed +.Pp +Join a Lucent legacy demo ad-hoc network with network name +.Dq Li my_net : +.Bd -literal -offset indent +ifconfig wlan create wlandev wi0 wlanmode ahdemo \e + inet 192.168.0.20 netmask 0xffffff00 ssid my_net +.Ed +.Pp +Join/create an IBSS network with network name +.Dq Li my_net : +.Bd -literal -offset indent +ifconfig wlan create wlandev wi0 wlanmode adhoc wi0 \e + inet 192.168.0.22 netmask 0xffffff00 ssid my_net +.Ed +.Pp +Create a host-based access point (Prism only): +.Bd -literal -offset indent +ifconfig wlan create wlandev wi0 wlanmode hostap \e + inet 192.168.0.10 netmask 0xffffff00 ssid my_ap +.Ed +.Pp +Create a host-based access point with WEP enabled (Prism only) +and plumb it into bridge to fxp0: +.Bd -literal -offset indent +ifconfig wlan0 create wlandev wi0 wlanmode hostap \e + inet 192.168.0.10 netmask 0xffffff00 ssid my_ap \e + wepmode on wepkey 0x1234567890 weptxkey 1 +ifconfig bridge0 create +ifconfig bridge0 addm wlan0 addm fxp0 up +.Ed +.Pp +This will give you the same functionality as an access point. +.Sh DIAGNOSTICS +.Bl -diag +.It "wi%d: init failed" +The WaveLAN card failed to become ready after an initialization command +was issued. +.It "wi%d: failed to allocate %d bytes on NIC" +The driver was unable to allocate memory for transmit frames in the +NIC's on-board RAM. +This can also be an indication of an incorrectly configured interrupt. +.It "wi%d: device timeout" +The WaveLAN card failed to generate an interrupt to acknowledge a transmit +command. +.El +.Sh SEE ALSO +.Xr intro 4 , +.Xr pccard 4 , +.Xr pccbb 4 , +.Xr pcic 4 , +.Xr wlan 4 , +.Xr wlan_ccmp 4 , +.Xr wlan_tkip 4 , +.Xr wlan_wep 4 , +.Xr wlan_xauth 4 , +.Xr hostapd 8 , +.Xr ifconfig 8 , +.Xr wpa_supplicant 8 . +.Rs +.%T HCF Light programming specification +.%U http://web.archive.org/web/20040130141721/http://wavelan.com/ +.Re +.Sh HISTORY +The +.Nm +device driver first appeared in +.Fx 3.0 . +.Sh AUTHORS +The original +.Nm +driver was written by +.An Bill Paul Aq wpaul@ctr.columbia.edu . +This man page comes from +.Ox . +.Sh CAVEATS +The driver will reject devices with old firmware to +avoid dealing with numerous defects. +Unfortunately the driver does not support downloading new firmware +to the card so if new firmware is needed users will have to boot +a different system to accomplish this. +.Pp +Intersil Prism cards must have firmware versions 0.8.0 or later and +version 1.7.0 or later are required to support functionality such as WPA. +Some users of Prism-II and 2.5 based cards report that station firmware +version 1.3.4 works better for them in hostap than 1.4.9. +Older versions of the Prism station firmware have a number of issues +with hostap mode. +The IBSS/adhoc mode appears to work well on station firmware 1.3.1 and +later. +The IBSS/adhoc mode appears to have problems for some people with +older versions of station firmware. +.Pp +Lucent cards prior to firmware version 6.0.6 do not implement IBSS +mode and are not supported. +.Pp +Prior versions of +.Nm +supported Symbol firmware. +That support has been removed due to persistent problems with this +firmware as well as getting proper documentation on this firmware. +.Pp +Hermes 2 and Hermes 3 chips are not supported by this driver. +.Pp +Here's the above requirements in the form of a table +.Pp +.Bl -column -compact "Prims II/2.5" "xxxxxxxx" "xxxxxxxx" "xxxxxxxx" "xxxxxxxx" +.Em "Firmware Minimum WPA Host AP Adhoc/IBSS" +Prism II/2.5 0.8.0 1.7.0 1.3.4 1.3.1 +Prism 3 0.8.0 1.7.0 1.4.9 1.3.1 +Hermes 6.0.6 none none 6.0.6 +Symbol none none none none +.El +.Sh BUGS +Not all the new messages are documented here, and many of them are +indications of transient errors that are not indications of serious +problems. |