cnwctl
—
display statistics and control Netwave AirSurfer PC Cards
cnwctl |
[-d domain]
[-i interface]
[-k scramble-key]
[-sS [rate]] |
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 seconds. 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.