ancontrol - configure Aironet 4500/4800 devices
ancontrol [interface] [-AChINQSTZ] [[-v 1|2|3|4] -a AP]
[-b beacon_period] [-c channel] [-v 0|1 -d
[-e 0|1|2|3] [-f fragmentation_threshold] [-j
[-K 0|1|2] [-v 0|1|2|3|4|5|6|7 -k key] [-l
[-m macaddress] [[-v 1|2|3] -n SSID] [-o 0|1] [-p
[-r RTS_threshold] [-s 0|1|2|3] [-t 0|1|2|3|4] [-W
The ancontrol command controls the operation of Aironet
devices via the an(4) driver. Most of the parameters
that can be
changed relate to the IEEE 802.11 protocol which the Aironet
This includes the station name, whether the station
in ad-hoc (point to point) or infrastructure mode, and the
of a service set to join. ancontrol can also be used to
view the current
NIC status, configuration, and to dump the values of the
The interface argument given to ancontrol should be the logical interface
name associated with the Aironet device (e.g., an0, an1,
etc...). If no
interface is specified, `an0' is used.
The options are as follows:
-A Display the preferred access point list. The AP
list can be used
by stations to specify the MAC address of access
which it wishes to associate. If no AP list is
default) then the station will associate with the
point that it finds which serves the SSID(s) specified in the
SSID list. The AP list can be modified with the -a
[-v 1|2|3|4] -a AP
Set preferred access point. The AP is specified as
a MAC address
consisting of 6 hexadecimal values separated by
colons. By default,
the -a option only sets the first entry in
the AP list.
The -v modifier can be used to specify exactly which
AP list entry
is to be modified. If the -v flag is not used,
the first AP
list entry will be changed.
Set the ad-hoc mode beacon period. The beacon period is specified
in milliseconds. The default is 100ms.
-C Display current NIC configuration. This shows the
mode, receive mode, MAC address, power save
timing settings, channel selection, diversity,
and transmit speed.
Set the radio frequency of a given interface. The
should be specified as a channel ID as shown in the
The list of available frequencies is dependent on
specified by regional authorities. Recognized
authorities include the FCC (United States), ETSI
France, and Japan. Frequencies in the table are
Channel ID FCC ETSI France Japan
1 2412 2412 - -
2 2417 2417 - -
3 2422 2422 - -
4 2427 2427 - -
5 2432 2432 - -
6 2437 2437 - -
7 2442 2442 - -
8 2447 2447 - -
9 2452 2452 - -
10 2457 2457 2457 -
11 2462 2462 2462 -
12 - 2467 2467 -
13 - 2472 2472 -
14 - - - 2484
If an illegal channel is specified, the NIC will revert to its
default channel. For NICs sold in the United States
the default channel is 3. For NICs sold in France,
channel is 11. For NICs sold in Japan, the only
is 14. Note that two stations must be set to
the same channel
in order to communicate.
-v 0|1 -d 0|1|2|3
Select the antenna diversity. Aironet devices can
with up to two antennas, and transmit and receive
be configured accordingly. Valid selections are as
0 Select factory default diversity
1 Antenna 1 only
2 Antenna 2 only
3 Antenna 1 and 2
The receive and transmit diversity can be set independently. The
user must specify which diversity setting is to be
using the -v option: selection 0 sets the receive
diversity and 1
sets the transmit diversity.
Set the transmit WEP key to use. Note that until
this command is
issued, the device will use the last key programmed.
key is stored in NVRAM. The currently set
transmit key can
be checked via -C option.
Set the fragmentation threshold in bytes. This
the point at which outgoing packets will be
split into multiple
fragments. If a single fragment is not sent
only that fragment will need to be retransmitted instead of the
whole packet. The fragmentation threshold can be
64 to 2312 bytes. The default is 2312.
-h Prints a list of available options and sample usage.
-I Display NIC capability information. This shows the
frequency, speed, power level capabilities, and
Set the ad-hoc network join timeout. When a station
is first activated
in ad-hoc mode, it will search out a ``master'' station
with the desired SSID and associate with it. If the
unable to locate another station with the same SSID
after a suitable
timeout, it sets itself up as the master so
that other stations
may associate with it. This timeout defaults
to 10000 milliseconds
(10 seconds) but may be changed with this
timeout should be specified in milliseconds.
Set authorization type. Use 0 for none, 1 for
"Open", 2 for
-v 0|1|2|3|4|5|6|7 -k key
Set a WEP key. For 40 bits, prefix 10 hex digits
with 0x. For
128 bits, prefix 26 hex digits with 0x. Use "" as
the key to
erase it. Supports 4 keys; even numbers are for
and odd numbers are for temporary keys. For example, "-v 1" sets
the first temporary key. (A "permanent" key is
stored in NVRAM;
a "temporary" key is not.) Note that the device
will use the
most recently-programmed key by default. Currently
set keys can
be checked via the -C option; only the sizes of the
keys are returned.
Set the station name used internally by the NIC.
can be any text string up to 16 characters in
length. The default
name is set by the driver to "OpenBSD".
Set the station address for the specified interface.
macaddress is specified as a series of six hexadecimal values
separated by colons, e.g. 00:60:1d:12:34:56. This
new address into the card and updates the interface
-N Display the SSID list. This is a list of service
set IDs (i.e.,
network names) with which the station wishes to associate. There
may be up to three SSIDs in the list: the station
will go through
the list in ascending order and associate with the
SSID that it finds.
[-v 1|2|3] -n SSID
Set the desired SSID (network name). There are
three SSIDs which
allows the NIC to work with access points at several
without needing to be reconfigured. The NIC checks
each SSID in
sequence when searching for a match. The SSID to be
be specified with the -v modifier option. If the -v
used, the first SSID in the list is set.
-o 0|1 Set the operating mode of the Aironet interface.
are 0 for ad-hoc mode and 1 for infrastructure
default driver setting is for infrastructure mode.
Set the transmit power level in milliwatts. Valid
vary depending on the actual NIC and can be viewed
by dumping the
device capabilities with the -I flag. Typical values are 1, 5,
20, 50, and 100mW. Selecting 0 sets the factory default.
-Q If driver was compiled with option ANCACHE (default)
the signal cache contents. A maximum of 16 station
collected on the list with LRU expiration policy.
such as MAC address, IP address, and signal strength
from the most recent matching packet received.
Set the RTS/CTS threshold for a given interface.
the number of bytes used for the RTS/CTS handshake
RTS_threshold can be any value between 0 and 2312.
-S Display NIC status information. This includes the
status, current BSSID, SSID, channel, beacon
currently associated access point. The operating
the state of the NIC, MAC status, and receiver status. When the
``synced'' keyword appears, it means the NIC has
with an access point, associated with an
``master'' station, or become a ``master'' itself.
period can be anything between 20 and 976 milliseconds. The default
Set power save mode. Valid selections are as follows:
Selection Power save mode
0 None - power save disabled
1 Constantly awake mode (CAM)
2 Power Save Polling (PSP)
3 Fast Power Save Polling (PSPCAM)
Note that for IBSS (ad-hoc) mode, only PSP mode is
only if the ATIM window is non-zero.
-T Display the NIC's internal statistics counters.
Select transmit speed. The available settings are
TX rate NIC speed
0 Auto -- NIC selects optimal speed
1 1Mbps fixed
2 2Mbps fixed
3 5.5Mbps fixed
4 11Mbps fixed
Note that the 5.5 and 11Mbps settings are only supported on the
4800 series adapters: the 4500 series adapters have
speed of 2Mbps.
Enable WEP. Use 0 for no WEP, 1 to enable full WEP,
2 for mixed
-Z Purge the signal cache contents (see above).
WEP ("wired equivalent privacy") is based on the RC4 algorithm, using a
24-bit initialization vector.
RC4 is supposedly vulnerable to certain known plaintext attacks, especially
with 40-bit keys. So the security of WEP in part depends on how
much known plaintext is transmitted.
Because of this, although counter-intuitive, using "shared
(which involves sending known plaintext) is less secure than using
"open" authentication when WEP is enabled.
Devices may alternate among all of the configured WEP keys
packets. Therefore, all configured keys (up to four)
an(4), wi(4), hostname.if(5), ifconfig(8), wicontrol(8)
The ancontrol command first appeared in FreeBSD 3.0 and
The ancontrol command was written by Bill Paul
and ported to OpenBSD by
Michael Shalayeff <firstname.lastname@example.org>.
The statistics counters do not seem to show the amount of
received frames as increasing. This is likely due to the
fact that the
an(4) driver uses unmodified packet mode instead of letting
the NIC perform
802.11/Ethernet encapsulation itself.
Setting the channel does not seem to have any effect.
OpenBSD 3.6 September 10, 1999
[ Back ]