cnwctl(8) - NetBSD Manual Pages

Command:
Section:
Arch:
Collection:
>>>
CNWCTL(8)               NetBSD System Manager's Manual               CNWCTL(8)


NAME

     cnwctl - display statistics and control Netwave AirSurfer PC Cards


SYNOPSIS

     cnwctl [-d domain] [-i interface] [-k scramble-key] [-sS [rate]]


DESCRIPTION

     The cnwctl utility is used to control Netwave AirSurfer PC Cards as well
     as display statistics.  The following options are available:

     -d      Set the domain of the card to 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.

     -i      Use interface as the interface rather than cnw0.

     -k      Set the scramble key to 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.

     -s      Display statistics.  When the optional argument 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 rate sec-
             onds.  At the top of each ``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 rate is not specified, or is 0 (zero), a single page of
             statistics will be displayed.  These statistics are more detailed
             and include:

             domain  The domain this card is part of.

             rx      Number of packets received.

             rxoverflow
                     Number of overflows detected.

             rxoverrun
                     Number of overruns detected.

             rxcrcerror
                     Number of CRC errors detected.  Random noise can cause
                     these errors.

             rxframe
                     Number of framing errors detected.

             rxerrors
                     Number of generic errors detected.

             rxavail
                     Number of times a packet was available.

             tx      Number of packets requested to be sent.

             txokay  Number of packets sent.

             txabort
                     Number of packets aborted (not sent within 9 tries).

             txlostcd
                     Number of times carrier detect was lost.

             txerrors
                     Number of generic transmit errors detected.

             txretries
                     Total number of retries.

             Nx retries
                     Number of packets which were retried N times.

     -S      Display status read from the hardware.  This option is only
             available to the super user.  The rate argument is used as with
             the -s option.  The following fields are displayed

             link integrity field (lif)
                     A 0 value implies no links.

             connection quality (cq)
                     Probably indicates the quality of the connection to the
                     access point.

             spu     Unknown meaning.

             link quality (lq)
                     Probably indicated the quality of the link to the access
                     point.

             hhc     Unknown meaning.

             mhs     Unknown meaning.

             revision
                     The revision numbers of the card.

             id      The ID of the card.


SEE ALSO

     cnw(4)

NetBSD 1.6                      January 5, 1997                              2