161 lines
5.0 KiB
Groff
161 lines
5.0 KiB
Groff
.\" $NetBSD: cnwctl.8,v 1.2 1999/11/29 12:55:07 itojun 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: cnwctl.8,v 1.1.1.1 1997/12/11 14:46:06 itojun Exp
|
|
.\"
|
|
.Dd January 5, 1997
|
|
.Dt CNWCTL 8
|
|
.Os
|
|
.Sh NAME
|
|
.Nm cnwctl
|
|
.Nd display statistics and control Netwave AirSurfer PC Cards
|
|
.Sh SYNOPSIS
|
|
.Nm cnwctl
|
|
.Op Fl d Ar domain
|
|
.Op Fl i Ar interface
|
|
.Op Fl k Ar scramble-key
|
|
.Op Fl sS Op Ar rate
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm cnwctl
|
|
utility is used to control Netwave AirSurfer PC Cards as well as
|
|
display statistics.
|
|
The following options are available:
|
|
.
|
|
.Bl -tag -width indent
|
|
.It Fl d
|
|
Set the domain of the card to
|
|
.Ar domain .
|
|
The domain must be between 0x000 and 0x1ff.
|
|
The domains 0x000 through 0x0ff are for access to an add-hoc network.
|
|
The domains 0x100 through 0x1ff are for access to a Netwave Access Point.
|
|
The default domain is 0x000.
|
|
A card may only talk to the access point in its domain, or other cards
|
|
in its add-hoc domain.
|
|
.It Fl i
|
|
Use
|
|
.Ar interface
|
|
as the interface rather than
|
|
.Li cnw0 .
|
|
.It Fl k
|
|
Set the scramble key to
|
|
.Ar scramble-key .
|
|
The scramble key must be between 0x0000 and 0xffff.
|
|
Both the source and the destination must use the same scramble key
|
|
in order to communicate.
|
|
.It Fl s
|
|
Display statistics.
|
|
When the optional argument
|
|
.Ar rate
|
|
(which must be the last argument to the end of the command line)
|
|
is specified as a non-zero value, statistics will be displayed
|
|
every
|
|
.Ar rate
|
|
seconds.
|
|
At the top of each
|
|
.Dq page
|
|
of statistics, column labels will be displayed. The first row of
|
|
statistics will be totals since boot, subsequent lines are deltas
|
|
from the previous row.
|
|
If
|
|
.Ar rate
|
|
is not specified, or is 0 (zero), a single page of statistics will be
|
|
displayed. These statistics are more detailed and include:
|
|
.Bl -tag -width indent
|
|
.It domain
|
|
The domain this card is part of.
|
|
.It rx
|
|
Number of packets received.
|
|
.It rxoverflow
|
|
Number of overflows detected.
|
|
.It rxoverrun
|
|
Number of overruns detected.
|
|
.It rxcrcerror
|
|
Number of CRC errors detected.
|
|
Random noise can cause these errors.
|
|
.It rxframe
|
|
Number of framing errors detected.
|
|
.It rxerrors
|
|
Number of generic errors detected.
|
|
.It rxavail
|
|
Number of times a packet was available.
|
|
.It tx
|
|
Number of packets requested to be sent.
|
|
.It txokay
|
|
Number of packets sent.
|
|
.It txabort
|
|
Number of packets aborted (not sent within 9 tries).
|
|
.It txlostcd
|
|
Number of times carrier detect was lost.
|
|
.It txerrors
|
|
Number of generic transmit errors detected.
|
|
.It txretries
|
|
Total number of retries.
|
|
.It Ar N Ns No x retries
|
|
Number of packets which were retried
|
|
.Ar N
|
|
times.
|
|
.El
|
|
.It Fl S
|
|
Display status read from the hardware. This option is only available
|
|
to the super user.
|
|
The
|
|
.Ar rate
|
|
argument is used as with the
|
|
.Fl s
|
|
option.
|
|
The following fields are displayed
|
|
.Bl -tag -width indent
|
|
.It link integrity field (lif)
|
|
A 0 value implies no links.
|
|
.It connection quality (cq)
|
|
Probably indicates the quality of the connection to the access point.
|
|
.It spu
|
|
Unknown meaning.
|
|
.It link quality (lq)
|
|
Probably indicated the quality of the link to the access point.
|
|
.It hhc
|
|
Unknown meaning.
|
|
.It mhs
|
|
Unknown meaning.
|
|
.It revision
|
|
The revision numbers of the card.
|
|
.It id
|
|
The ID of the card.
|
|
.El
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr cnw 4
|