WICONTROL(8) BSD System Manager's Manual WICONTROL(8)NAMEwicontrol - configure WaveLAN/IEEE devices
SYNOPSISwicontrol [-i iface]
wicontrol [-i iface] -o
wicontrol [-i iface] -c 0|1
wicontrol [-i iface] -q SSID
wicontrol [-i iface] -d max data length
wicontrol [-i iface] -r RTS threshold
wicontrol [-i iface] -P 0|1
wicontrol [-i iface] -S max_sleep_duration
wicontrol [-i iface] -C
wicontrol [-i iface] -Z
DESCRIPTION
The wicontrol command controls the operation of WaveLAN/IEEE wireless
networking devices via the wi(4) driver. Most of the parameters that can
be changed are device-specific, as ifconfig(8) can be used to set general
and 802.11-specific parameters. The wicontrol command can also be used
to view the current settings of these paremeters and to dump out the val-
ues of the card's statistics counters.
Configuration changes can only be performed by the super user.
The iface argument given to wicontrol should be the logical interface
name associated with the WaveLAN/IEEE device (wi0, wi1, etc...).
OPTIONS
The options are as follows:
(none) Display the current settings of the specified WaveLAN/IEEE
interface. This retrives the current card settings from the
driver and prints them out.
-o Display the statistics counters.
-c 0|1 Allow the station to create a service set (IBSS). Permitted
values are 0 (don't create IBSS) and 1 (enable creation of
IBSS). The default is 0.
Note: this option is provided for experimental purposes only:
enabling the creation of an IBSS on a host system doesn't ap-
pear to actually work.
-q SSID Specify the name of an IBSS (SSID) to create on a given in-
terface. The SSID can be any text string up to 30 characters
long.
Note: this option is provided for experimental purposes only:
enabling the creation of an IBSS on a host system doesn't ap-
pear to actually work.
-d max_data_length
Set the maximum receive and transmit frame size for a speci-
fied interface. The max data length can be any number from
350 to 2304. The default is 2304.
-r RTS threshold
Set the RTS/CTS threshold for a given interface. This con-
trols the number of bytes used for the RTS/CTS handhake
boundary. The RTS threshold can be any value between 0 and
2047. The default is 2347.
-P 0|1 Enable or disable power management on a given interface. En-
abling power management uses an alternating sleep/wake proto-
col to help conserve power on mobile stations, at the cost of
some increased receive latency. Power management is off by
default. Note that power management requires the cooperation
of an access point in order to function; it is not functional
in ad-hoc mode. Also, power management is only implemented in
Lucent WavePOINT firmware version 2.03 or later, and in Wave-
LAN PCMCIA adapter firmware 2.00 or later. Older revisions
will silently ignore the power management setting. Legal val-
ues for this parameter are 0 (off) and 1 (on).
-S max_sleep_interval
Specify the sleep interval to use when power management is
enabled. The max sleep interval is specified in millisec-
onds. The default is 100.
-C Print the signal strength cache.
-Z Zero the signal strength cache.
SEE ALSOwi(4), ifconfig(8)HISTORY
The wicontrol command first appeared in FreeBSD and was later modified
for BSD/OS.
AUTHOR
The wicontrol command was written by Bill Paul <wpaul@ctr.columbia.edu>.
BSD/OS modifications by Geert Jan de Groot.
BSD/OS April 21, 1999 2