NICs. (Finally!) The PCMCIA, ISA and PCI varieties are all supported, though only the ISA and PCI ones will work on the alpha for now. PCCARD, ISA and PCI attachments are all provided. Also provided an ancontrol(8) utility for configuring the NIC, man pages, and updated pccard.conf.sample. ISA cards are supported in both ISA PnP and hard-wired mode, although you must configure the kernel explicitly to support the hardwired mode since you have to know the I/O address and port ahead of time. Special thanks to Doug Ambrisko for doing the initial newbus hackery and getting it to work in infrastructure mode.
319 lines
11 KiB
Groff
319 lines
11 KiB
Groff
.\" Copyright (c) 1997, 1998, 1999
|
|
.\" Bill Paul <wpaul@ee.columbia.edu> All rights reserved.
|
|
.\"
|
|
.\" Redistribution and use in source and binary forms, with or without
|
|
.\" modification, are permitted provided that the following conditions
|
|
.\" are met:
|
|
.\" 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 Bill Paul.
|
|
.\" 4. Neither the name of the author nor the names of any co-contributors
|
|
.\" may be used to endorse or promote products derived from this software
|
|
.\" without specific prior written permission.
|
|
.\"
|
|
.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``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 Bill Paul OR THE VOICES IN HIS HEAD
|
|
.\" 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.
|
|
.\"
|
|
.\" $FreeBSD$
|
|
.\"
|
|
.Dd September 10, 1999
|
|
.Dt ANCONTROL 8
|
|
.Os FreeBSD 3.0
|
|
.Sh NAME
|
|
.Nm ancontrol
|
|
.Nd configure Aironet 4500/4800 devices
|
|
.Sh SYNOPSIS
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl A
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl N
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl S
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl I
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl T
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl C
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl t Ar 0|1|2|3|4
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl s Ar 0|1|2|3
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl a Ar AP
|
|
.Op Fl v Ar 1|2|3|4
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl b Ar beacon period
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl d Ar 0|1|2|3
|
|
.Op v Ar 0|1
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl j Ar netjoin timeout
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl l Ar station name
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl m Ar mac address
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl n Ar SSID
|
|
.Op Fl v Ar 1|2|3
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl o Ar 0|1
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl p Ar tx power
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl c Ar channel number
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl f Ar fragmentation threshold
|
|
.Nm ancontrol
|
|
.Fl i Ar iface Fl r Ar RTS threshold
|
|
.Nm ancontrol
|
|
.Fl h
|
|
.Sh DESCRIPTION
|
|
The
|
|
.Nm
|
|
command controls the operation of Aironet wireless networking
|
|
devices via the
|
|
.Xr an 4
|
|
driver. Most of the parameters that can be changed relate to the
|
|
IEEE 802.11 protocol which the Aironet cards implement. This includes
|
|
the station name, whether the station is operating in ad-hoc (point
|
|
to point) or infrastructure mode, and the network name of a service
|
|
set to join. The
|
|
.Nm
|
|
command can also be used to view the current NIC status, configuration
|
|
and to dump out the values of the card's statistics counters.
|
|
.Pp
|
|
The
|
|
.Ar iface
|
|
argument given to
|
|
.Nm
|
|
should be the logical interface name associated with the Aironet
|
|
device (an0, an1, etc...).
|
|
.Sh OPTIONS
|
|
The options are as follows:
|
|
.Bl -tag -width Fl
|
|
.It Fl i Ar iface Fl A
|
|
Display the prefered access point list. The AP list can be used by
|
|
stations to specify the MAC address of access points with which it
|
|
wishes to associate. If no AP list is specified (the default) then
|
|
the station will associate with the first access point that it finds
|
|
which serves the SSID(s) specified in the SSID list. The AP list can
|
|
be modified with the
|
|
.Fl a
|
|
option.
|
|
.It Fl i Ar iface Fl 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 first matching SSID that it finds.
|
|
.It Fl i Ar iface Fl S
|
|
Display NIC status information. This includes the current operating
|
|
status, current BSSID, SSID, channel, beacon period and currently
|
|
associated access point. The operating mode indicates the state of
|
|
the NIC, MAC status and receiver status. When the "synced" keyword
|
|
appears, it means the NIC has successfully associated with an access
|
|
point, associated with an ad-hoc "master" station, or become a "master"
|
|
itself. The beacon period can be anything between 20 and 976 milliseconds.
|
|
The default is 100.
|
|
.It Fl i Ar iface Fl I
|
|
Display NIC capability information. This shows the device type,
|
|
frequency, speed and power level capablities and firmware revision levels.
|
|
.It Fl i Ar iface Fl T
|
|
Display the NIC's internal statistics counters.
|
|
.It Fl i Ar iface Fl C
|
|
Display current NIC configuration. This shows the current operation mode,
|
|
receive mode, MAC address, power save settings, various timing settings,
|
|
channel selection, diversity, transmit power and transmit speed.
|
|
.It Fl i Ar iface Fl t Ar 0|1|2|3|4
|
|
Select transmit speed. The available settings are as follows:
|
|
.Bd -filled -offset indent
|
|
.Bl -column "TX rate " "NIC speed "
|
|
.Em "TX rate NIC speed"
|
|
0 Auto -- NIC selects optimal speed
|
|
1 1Mbps fixed
|
|
2 2Mbps fixed
|
|
3 5.5Mbps fixed
|
|
4 11Mbps fixed
|
|
.El
|
|
.Ed
|
|
.Pp
|
|
Note that the 5.5 and 11Mbps settings are only supported on the 4800
|
|
series adapters: the 4500 series adapters have a maximum speed of 2Mbps.
|
|
.It Fl i Ar iface Fl s Ar 0|1|2|3
|
|
Set power save mode. Valid selections are as follows:
|
|
.Bd -filled -offset indent
|
|
.Bl -column "Selection " "Power save mode "
|
|
.Em "Selection Power save mode"
|
|
0 None - power save disabled
|
|
1 Constantly awake mode (CAM)
|
|
2 Power Save Polling (PSP)
|
|
3 Fast Power Save Polling (PSP-CAM)
|
|
.El
|
|
.Ed
|
|
.Pp
|
|
Note that for IBSS (ad-hoc) mode, only PSP mode is supported, and only
|
|
if the ATIM window is non-zero.
|
|
.It Fl i Ar iface Fl a Ar AP "[-v 1|2|3|4]"
|
|
Set prefered access point. The
|
|
.Ar AP
|
|
is specified as a MAC address consisting of 6 hexadecimal values
|
|
separated by colons. By default, the
|
|
.Fl a
|
|
option only sets the first entry in the AP list. The
|
|
.Fl v
|
|
modifier can be used to specify exactly which AP list entry is to be
|
|
modified. If the
|
|
.Fl v
|
|
flag is not used, the first AP list entry will be changed.
|
|
.It Fl i Ar iface Fl b Ar beacon period
|
|
Set the ad-hoc mode beacon period. The becon period is specified in
|
|
milliseconds. The default is 100ms.
|
|
.It Fl i Ar iface Fl d Ar 0|1|2|3 "-v 0|1"
|
|
Select the antenna diversity. Aironet devices can be configured with up
|
|
to two antennas, and transmit and receive diversity can be configured
|
|
accordingly. Valid selections are as follows:
|
|
.Bd -filled -offset indent
|
|
.Bl -column "Selection " "Diversity "
|
|
.Em "Selection Diversity"
|
|
0 Select factory default diversity
|
|
1 Antenna 1 only
|
|
2 Antenna 2 only
|
|
3 Antenna 1 and 2
|
|
.El
|
|
.Ed
|
|
.Pp
|
|
The receive and transmit diversity can be set independently. The user
|
|
must specify which diversity setting is to be modified by using the
|
|
.Fl v
|
|
option: selection
|
|
.Ar 0
|
|
sets the receive diversity and
|
|
.Ar 1
|
|
sets the transmit diversity.
|
|
.It Fl i Ar iface Fl j Ar netjoin timeout
|
|
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 station is 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 option. The timeout should be specified in milliseconds.
|
|
.It i Ar iface Fl l Ar station name
|
|
Set the station name used internally by the NIC. The
|
|
.Ar station name
|
|
can be any text string up to 16 characters in length. The default name
|
|
is set by the driver to "FreeBSD."
|
|
.It Fl i Ar iface Fl m Ar mac address
|
|
Set the station address for the specified interface. The
|
|
.Ar mac address
|
|
is specified as a series of six hexadecimal values separated by colons,
|
|
e.g.: 00:60:1d:12:34:56. This programs the new address into the card
|
|
and updates the interface as well.
|
|
.It Fl i Ar iface Fl n Ar SSID "[-v 1|2|3]"
|
|
Set the desired SSID (network name). There are three SSIDs which allows
|
|
the NIC to work with access points at several locations without needing
|
|
to be reconfigured. The NIC checks each SSID in sequence when searching
|
|
for a match. The SSID to be changed can be specified with the
|
|
.Fl v
|
|
modifier option. If the
|
|
.Fl v
|
|
flag isn't used, the first SSID in the list is set.
|
|
.It Fl i Ar iface Fl o Ar 0|1
|
|
Set the operating mode of the Aironet interface. Valid selections are
|
|
.Ar 0
|
|
for ad-hoc mode and
|
|
.Ar 1
|
|
for infrastructure mode. The default driver setting is for ad-hoc
|
|
mode.
|
|
.It Fl i Ar iface Fl p Ar tx power
|
|
Set the transmit power level in milliwatts. Valid power settings
|
|
vary depending on the actual NIC and can be viewed by dumping the
|
|
device capabilities with the
|
|
.Fl I
|
|
flag. Typical values are 1, 5, 20, 50 and 100mW. Selecting 0 sets
|
|
the factory default.
|
|
.It Fl i Ar iface Fl c Ar channel
|
|
Set the radio frequency of a given interface. The
|
|
.Ar frequency
|
|
should be specfied as a channel ID as shown in the table below. The
|
|
list of available frequencies is dependent on radio regulations specified
|
|
by regional authorities. Recognized regulatory authorities include
|
|
the FCC (United States), ETSI (Europe), France and Japan. Frequencies
|
|
in the table are specified in Mhz.
|
|
.Bd -filled -offset indent
|
|
.Bl -column "Channel ID " "FCC " "ETSI " "France " "Japan "
|
|
.Em "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
|
|
.El
|
|
.Ed
|
|
.Pp
|
|
If an illegal channel is specified, the
|
|
NIC will revert to its default channel. For NICs sold in the United States
|
|
and Europe, the default channel is 3. For NICs sold in France, the default
|
|
channel is 11. For NICs sold in Japan, the only available channel is 14.
|
|
Note that two stations must be set to the same channel in order to
|
|
communicate.
|
|
.It Fl i Ar iface Fl f Ar fragmentation threshold
|
|
Set the fragmentation threshold in bytes. This threshold controls the
|
|
point at which outgoing packets will be split into multiple fragments.
|
|
If a single fragment is not sent successfully, only that fragment will
|
|
need to be retransmitted instead of the whole packet. The fragmentation
|
|
threshold can be anything from 64 to 2312 bytes. The default is 2312.
|
|
.It Fl i Ar iface Fl r Ar RTS threshold
|
|
Set the RTS/CTS threshold for a given interface. This controls the
|
|
number of bytes used for the RTS/CTS handhake boundary. The
|
|
.Ar RTS threshold
|
|
can be any value between 0 and 2312. The default is 2312.
|
|
.It Fl h
|
|
Prints a list of available options and sample usage.
|
|
.El
|
|
.Sh SEE ALSO
|
|
.Xr an 4 ,
|
|
.Xr ifconfig 8
|
|
.Sh HISTORY
|
|
The
|
|
.Nm
|
|
command first appeared in
|
|
.Fx 3.0 .
|
|
.Sh BUGS
|
|
The statistics counters do not seem to show the amount of transmit
|
|
and received frames as increasing. This is likely due to the fact that
|
|
the
|
|
.Xr an 4
|
|
driver uses unmodified packet mode instead of letting the NIC perform
|
|
802.11/ethernet encapsulation itself.
|
|
.Pp
|
|
Setting the channel does not seem to have any effect.
|
|
.Sh AUTHOR
|
|
The
|
|
.Nm
|
|
command was written by
|
|
.An Bill Paul Aq wpaul@ee.columbia.edu .
|