1
0
mirror of https://git.FreeBSD.org/src.git synced 2024-12-20 11:11:24 +00:00

Add a manpage for the cnw(4) driver, adopted from NetBSD.

MFC after:	5 days
This commit is contained in:
Christian Brueffer 2004-09-09 23:49:19 +00:00
parent 91461de402
commit 0785d2fe36
Notes: svn2git 2020-12-20 02:59:44 +00:00
svn path=/head/; revision=135017

130
share/man/man4/cnw.4 Normal file
View File

@ -0,0 +1,130 @@
.\" $NetBSD: cnw.4,v 1.12 2001/09/12 18:19:17 wiz Exp $
.\"
.\" Copyright (c) 1997 Berkeley Software Design, Inc. All rights reserved.
.\"
.\" Redistribution and use in source and binary forms, with or without
.\" modification, are permitted provided that this notice is retained,
.\" the conditions in the following notices are met, and terms applying
.\" to contributors in the following notices also apply to Berkeley
.\" Software Design, Inc.
.\"
.\" 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
.\" Berkeley Software Design, Inc.
.\" 4. Neither the name of the Berkeley Software Design, Inc. nor the names
.\" of its contributors may be used to endorse or promote products derived
.\" from this software without specific prior written permission.
.\"
.\" THIS SOFTWARE IS PROVIDED BY BERKELEY SOFTWARE DESIGN, INC. ``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 BERKELEY SOFTWARE DESIGN, INC. 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.
.\"
.\" PAO2 Id: cnw.4,v 1.1.1.1 1997/12/11 14:46:23 itojun Exp
.\"
.\" $FreeBSD$
.\"
.Dd September 5, 2004
.Dt CNW 4
.Os
.Sh NAME
.Nm cnw
.Nd Netwave AirSurfer wireless network driver
.Sh SYNOPSIS
.Cd "device cnw"
.Sh DESCRIPTION
The
.Nm cnw
interface provides access to a theoretical 1 Mb/s wireless Ethernet network
based on the Netwave AirSurfer Wireless LAN (formerly known as the Xircom
Netwave Wireless LAN).
.Pp
Note that the driver does not support newer devices
such as the Netwave AirSurfer
.Dq Plus ,
or the BayStack 650/660.
These devices are supported by the
.Xr awi 4
driver.
.Pp
Netwave devices are not compatible with IEEE 802.11 wireless networks.
Also note that there are Netwave devices with different wireless frequency,
depending on the radio band plan in each country.
.Pp
The card uses 36K of I/O memory mapped to the card.
.\"The card uses 32K of I/O memory mapped to the card along with either 16 I/O ports
.\"or 4K of additional I/O memory for access to command registers.
.\"The driver currently only supports the use of the additional 4K of I/O memory.
You may need to increase memory space available to the PC Card controller.
See
.Xr pccard 4
for details.
.Pp
In use, the cards appear to achieve up to a 420Kb/s transfer rate, though
a transfer rate between 250Kb/s and 350Kb/s is typical.
.Pp
The card operates in the 2.4GHz frequency range and is subject to interference
from microwaves, IEEE 802.11 wireless network devices, as well as earth.
For example, it seems that IEEE 802.11 channel 14 conflicts with Netwave
.Pq US frequency .
They interfere with each other if they are both operated
in the same geographic region, causing weird packet loss.
You may be able to avoid the interference with IEEE 802.11 devices,
by changing the IEEE 802.11 channel.
.Sh HARDWARE
Cards supported by the
.Nm
driver include:
.Pp
.Bl -bullet -compact
.It
Xircom CreditCard Netwave
.It
NetWave AirSurfer
.El
.Sh DIAGNOSTICS
.Bl -diag
.It "cnw0: can't map memory"
Indicates that the driver was not able to allocate enough PC Card bus
address space into which to map the device.
See
.Xr pccard 4
and increase memory available to the PC Card controller.
.El
.Sh SEE ALSO
.Xr arp 4 ,
.Xr awi 4 ,
.Xr inet 4 ,
.Xr intro 4 ,
.Xr pccard 4
.Sh HISTORY
The
.Nm
driver was ported from
.Nx
by
.An -nosplit
.An Hiroyuki Aizu Aq aizu@jaist.ac.jp .
It first appeared in
.Nx 1.4 .
The first
.Fx
release to include it was
.Fx 5.0 .
This manual page was adopted from
.Nx
by
.An Christian Brueffer Aq brueffer@FreeBSD.org .