Sync usage with man page.
[netbsd-mini2440.git] / share / man / man4 / cnw.4
blob33231889f435796b065bf37151018fb73b283dbd
1 .\"     $NetBSD: cnw.4,v 1.12 2001/09/12 18:19:17 wiz Exp $
2 .\"
3 .\" Copyright (c) 1997 Berkeley Software Design, Inc. All rights reserved.
4 .\"
5 .\" Redistribution and use in source and binary forms, with or without
6 .\" modification, are permitted provided that this notice is retained,
7 .\" the conditions in the following notices are met, and terms applying
8 .\" to contributors in the following notices also apply to Berkeley
9 .\" Software Design, Inc.
10 .\"
11 .\" 1. Redistributions of source code must retain the above copyright
12 .\"    notice, this list of conditions and the following disclaimer.
13 .\" 2. Redistributions in binary form must reproduce the above copyright
14 .\"    notice, this list of conditions and the following disclaimer in the
15 .\"    documentation and/or other materials provided with the distribution.
16 .\" 3. All advertising materials mentioning features or use of this software
17 .\"    must display the following acknowledgement:
18 .\"      This product includes software developed by
19 .\"      Berkeley Software Design, Inc.
20 .\" 4. Neither the name of the Berkeley Software Design, Inc. nor the names
21 .\"    of its contributors may be used to endorse or promote products derived
22 .\"    from this software without specific prior written permission.
23 .\"
24 .\" THIS SOFTWARE IS PROVIDED BY BERKELEY SOFTWARE DESIGN, INC. ``AS IS'' AND
25 .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
26 .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
27 .\" ARE DISCLAIMED.  IN NO EVENT SHALL BERKELEY SOFTWARE DESIGN, INC. BE LIABLE
28 .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
29 .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
30 .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
31 .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
32 .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
33 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
34 .\" SUCH DAMAGE.
35 .\"
36 .\"     PAO2 Id: cnw.4,v 1.1.1.1 1997/12/11 14:46:23 itojun Exp
37 .\"
38 .Dd January 5, 1997
39 .Dt CNW 4
40 .Os
41 .Sh NAME
42 .Nm cnw
43 .Nd
44 .Tn Netwave AirSurfer wireless network driver
45 .Sh SYNOPSIS
46 .Cd "cnw*     at pcmcia? function ?"
47 .Sh DESCRIPTION
48 The
49 .Nm cnw
50 interface provides access to a theoretical 1 Mb/s wireless Ethernet network
51 based on the Netwave AirSurfer Wireless LAN (formerly known as the Xircom
52 Netwave Wireless LAN).
53 .Pp
54 Note that the driver does not support newer devices
55 such as the Netwave AirSurfer
56 .Dq Plus ,
57 or the BayStack 650/660.
58 These devices are supported by the
59 .Xr awi 4
60 driver.
61 .Pp
62 Netwave devices are not compatible with IEEE 802.11 wireless networks.
63 Also note that there are Netwave devices with different wireless frequency,
64 depending on the radio band plan in each country.
65 .Pp
66 The card uses 36K of I/O memory mapped to the card.
67 .\"The card uses 32K of I/O memory mapped to the card along with either 16 I/O ports
68 .\"or 4K of additional I/O memory for access to command registers.
69 .\"The driver currently only supports the use of the additional 4K of I/O memory.
70 You may need to increase memory space available to the PCMCIA controller.
71 See
72 .Xr pcmcia 4
73 for details.
74 .Pp
75 In use, the cards appear to achieve up to a 420Kb/s transfer rate, though
76 a transfer rate between 250Kb/s and 350Kb/s is typical.
77 .Pp
78 The card operates in the 2.4GHz frequency range and is subject to interference
79 from microwaves, IEEE 802.11 wireless network devices, as well as earth.
80 For example, it seems that IEEE 802.11 channel 14 conflicts with Netwave
81 .Pq US frequency .
82 They interfere with each other if they are both operated
83 in the same geographic region, causing weird packet loss.
84 You may be able to avoid the interference with IEEE 802.11 devices,
85 by changing the IEEE 802.11 channel.
86 .Sh HARDWARE
87 Cards supported by the
88 .Nm
89 driver include:
90 .Pp
91 .Bl -item -offset indent
92 .It
93 Xircom CreditCard Netwave
94 .It
95 NetWave AirSurfer
96 .El
97 .Sh DIAGNOSTICS
98 .Bl -diag
99 .It "cnw0: can't map memory"
100 Indicates that the driver was not able to allocate enough PCMCIA bus
101 address space into which to map the device.
103 .Xr pcmcia 4
104 and increase memory available to the PCMCIA controller.
106 .Sh SEE ALSO
107 .Xr arp 4 ,
108 .Xr awi 4 ,
109 .Xr inet 4 ,
110 .Xr intro 4 ,
111 .Xr pcmcia 4 ,
112 .Xr cnwctl 8