First stab at updating wi(4) to reality. Replace wi.4 with wi.4tbl

so we can do tables.

2 files changed, 234 insertions, 2 deletions

diff --git a/share/man/man4/Makefile b/share/man/man4/Makefile
index 53d192c0a2f..673c97257f7 100644
--- a/share/man/man4/Makefile
+++ b/share/man/man4/Makefile
@@ -1,4 +1,4 @@
-#	$OpenBSD: Makefile,v 1.194 2002/03/14 19:39:16 jason Exp $
+#	$OpenBSD: Makefile,v 1.195 2002/03/30 00:12:38 millert Exp $
 
 MAN=	aac.4 ac97.4 addcom.4 adv.4 aha.4 ahb.4 ahc.4 aic.4 ami.4 amphy.4 \
 	an.4 aria.4 ast.4 atalk.4 atapiscsi.4 \
@@ -29,7 +29,7 @@ MAN=	aac.4 ac97.4 addcom.4 adv.4 aha.4 ahb.4 ahc.4 aic.4 ami.4 amphy.4 \
 	uaudio.4 ubsec.4 ucom.4 udp.4 uftdi.4 ugen.4 uhci.4 uhid.4 uk.4 ukbd.4 \
 	ukphy.4 ulpt.4 umodem.4 ums.4 umass.4 unix.4 upl.4 uplcom.4 urio.4 \
 	usb.4 uscanner.4 usscanner.4 uvisor.4 uyap.4 vga.4 vlan.4 vnd.4 vr.4 \
-	wb.4 wd.4 wdc.4 we.4 wi.4 \
+	wb.4 wd.4 wdc.4 we.4 wi.4tbl \
 	wscons.4 wsdisplay.4 wskbd.4 wsmouse.4 wsmux.4 \
 	wx.4 xe.4 xl.4 xmphy.4 yds.4 ym.4 xf86.4 zero.4
 
diff --git a/share/man/man4/wi.4tbl b/share/man/man4/wi.4tbl
new file mode 100644
index 00000000000..6c42f7f3e10
--- /dev/null
+++ b/share/man/man4/wi.4tbl
@@ -0,0 +1,232 @@
+.\"	$OpenBSD: wi.4tbl,v 1.1 2002/03/30 00:12:38 millert Exp $
+.\"
+.\" 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: wi.4,v 1.3 1999/05/22 16:12:43 wpaul Exp $
+.\"
+.Dd June 24, 2001
+.Dt WI 4
+.Os
+.Sh NAME
+.Nm wi
+.Nd WaveLAN/IEEE and PRISM-II 802.11DS wireless network driver
+.Sh SYNOPSIS
+.Cd "wi* at pci? dev ? function ?"
+.Cd "wi* at pcmcia? function ?"
+.Cd "wi* at macobio?"
+.Sh DESCRIPTION
+The
+.Nm
+driver provides support for wireless network adapters based on the
+Lucent Technologies WaveLAN/IEEE (aka WaveLAN II) and Intersil
+PRISM-II and PRISM-2.5 chipsets.
+.Pp
+The core of the WaveLAN/IEEE is the Lucent Hermes controller.
+All host/device interaction is via programmed I/O with the Hermes.
+The Hermes supports 802.11 and 802.3 frames, power management, BSS,
+WDS and ad-hoc operation modes.
+.Pp
+The
+.Nm
+driver encapsulates all IP and ARP traffic as 802.11 frames, however
+it can receive either 802.11 or 802.3 frames.
+Transmit speed is selectable between 1Mbps fixed, 2Mbps fixed, 2Mbps
+with auto fallback, 6Mbps, 8Mbps, or 11Mbps depending on your hardware
+(see above).
+The Lucent WaveLAN/IEEE Silver and Gold cards as well as the Intersil
+cards have support for WEP encryption.
+The WaveLAN Gold and newer Intersil cards support 104bit keys, the others
+only accept 40bit keys.
+The Lucent Bronze cards do not support WEP.
+To enable encryption, use the
+.Xr wicontrol 8
+utility to set your keys.
+.Pp
+By default, the
+.Nm
+driver configures the card for BSS operation (aka infrastructure
+mode).
+This mode requires the use of an access point (base station).
+.Pp
+The
+.Nm
+driver also supports an ad-hoc (point-to-point) mode where
+the nwid is ignored and stations can communicate amongst
+themselves without the aid of an access point.
+Note that there are two possible ad-hoc modes.
+One mode, referred to as
+.Dq ad-hoc demo mode ,
+predates the IEEE 802.11 specification and so may not interoperate
+with cards from other vendors.
+The standardized ad-hoc mode, also know as IBSS mode, is not
+supported by cards with very old firmware revisions.
+.Pp
+Additionally, cards based on the Intersil PRISM-II and PRISM-2.5 chips 
+have a host-based access point mode which allows the card to
+act as a normal access point (with some assistance from the
+.Nm
+driver).
+This mode is not available on cards that uses the Hermes controller,
+such as those from Lucent.
+.Pp
+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.
+.br
+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 to by
+.Nm
+driver:
+.Pp
+.in +\n(dIu
+.TS
+tab (:) ;
+l l l
+_ _ _
+l l l .
+Card:Chip:Bus
+3Com AirConnect 3CRWE737A:Prism-II:PCMCIA
+Addtron AWP-100:Prism-II:PCMCIA
+Agere Orinoco:Hermes:PCMCIA
+BUFFALO AirStation:Prism-II:PCMCIA
+BUFFALO AirStation:Prism-II:CF
+Cabletron RoamAbout:Hermes:PCMCIA
+Compaq Agency NC5004: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
+ELSA XI300:Prism-II:PCMCIA
+ELSA XI800:Prism-II:CF
+EMTAC A2424i:Prism-II:PCMCIA
+Ericsson Wireless LAN CARD C11:Prism-II:PCMCIA
+Gemtek WL-311:Prism-2.5:PCMCIA
+I-O DATA WN-B11/PCM:Prism-II:PCMCIA
+Intel PRO/Wireless 2011:Prism-II:PCMCIA
+Intersil Prism II:Prism-II:PCMCIA
+Intersil Mini-PCI:Prism-2.5:PCI
+Linksys Instant Wireless WPC11:Prism-II:PCMCIA
+Linksys Instant Wireless WPC11 2.5:Prism-2.5:PCMCIA
+Lucent WaveLAN:Hermes:PCMCIA
+NANOSPEED ROOT-RZ2000:Prism-II:PCMCIA
+NDC/Sohoware NCP130:Prism-II:PCI
+NEC CMZ-RT-WP:Prism-II:PCMCIA
+NTT-ME 11Mbps Wireless LAN:Prism-II:PCMCIA
+Proxim RangeLAN-DS:Prism-II:PCMCIA
+Samsung MagicLAN SWL-2000N:Prism-II:PCMCIA
+Symbol Spectrum24:Prism-II:PCMCIA
+SMC 2632 EZ Connect:Prism-II:PCMCIA
+TDK LAK-CD011WL:Prism-II:PCMCIA
+.TE
+.in -\n(dIu
+.Pp
+Note that some of the PRISM-II adapters only work at 3.3V, hence
+.Xr cardbus 4
+support is required for those cards to set VCC correctly, even
+though they are really 16bit cards.
+.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 -tag -width -offset indent -compact
+.It 3Com AirConnect 3CRWE777A
+.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)
+.El
+.Pp
+.Sh DIAGNOSTICS
+.Bl -diag
+.It "wi%d: init failed"
+The WaveLAN card failed to come 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.
+.It "wi%d: device timeout"
+The WaveLAN failed to generate an interrupt to acknowledge a transmit
+command.
+.El
+.Sh SEE ALSO
+.Xr an 4 ,
+.Xr arp 4 ,
+.Xr netintro 4 ,
+.Xr ifconfig 8 ,
+.Xr wicontrol 8
+.Rs
+.%T HCF Light programming specification
+.%O http://www.wavelan.com
+.Re
+.Sh HISTORY
+The
+.Nm
+device driver first appeared in
+.Fx 3.0 .
+.Ox
+support was added in
+.Ox 2.6 .
+.Sh AUTHORS
+The
+.Nm
+driver was written by Bill Paul <wpaul@ctr.columbia.edu> and ported to
+.Ox
+by Niklas Hallqvist <niklas@appli.se>.
+.Sh CAVEATS
+The original Lucent WaveLAN cards usually default to channel 3;
+newer cards use channel 10 by default.
+Non-Lucent cards vary, for instance the Addtron cards use channel
+11 by default.
+See
+.Xr wicontrol 8
+for information on how to change the channel.