1.\" $NetBSD: wiconfig.8,v 1.24 2002/11/17 01:26:30 wiz Exp $ 2.\" 3.\" Copyright (c) 1997, 1998, 1999 4.\" Bill Paul <wpaul@ctr.columbia.edu> All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 3. All advertising materials mentioning features or use of this software 15.\" must display the following acknowledgement: 16.\" This product includes software developed by Bill Paul. 17.\" 4. Neither the name of the author nor the names of any co-contributors 18.\" may be used to endorse or promote products derived from this software 19.\" without specific prior written permission. 20.\" 21.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND 22.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 23.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 24.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD 25.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 26.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 27.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 28.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 29.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 30.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 31.\" THE POSSIBILITY OF SUCH DAMAGE. 32.\" 33.\" From: wicontrol.8,v 1.6 1999/05/22 16:12:47 wpaul Exp $ 34.\" 35.Dd November 16, 2002 36.Dt WICONFIG 8 37.Os 38.Sh NAME 39.Nm wiconfig 40.Nd configure WaveLAN/IEEE devices 41.Sh SYNOPSIS 42.Nm wiconfig 43.Ar interface 44.Op Fl \&Do 45.Bk -words 46.Op Fl a Ar access point density 47.Ek 48.Bk -words 49.Op Fl d Ar max data length 50.Ek 51.Bk -words 52.Op Fl M Ar 0|1 53.Ek 54.Bk -words 55.Op Fl m Ar MAC address 56.Ek 57.Bk -words 58.Op Fl R Ar 1|3 59.Ek 60.Bk -words 61.Op Fl r Ar RTS threshold 62.Ek 63.Bk -words 64.Op Fl s Ar station name 65.Ek 66.Sh DESCRIPTION 67The 68.Nm 69command controls the operation of 70.Tn WaveLAN/IEEE 71wireless networking devices via the 72.Xr wi 4 73and 74.Xr awi 4 75drivers. 76The 77.Nm 78command can also be used to view the current settings of these parameters 79and to dump out the values of the card's statistics counters. 80.Pp 81Most of the parameters that can be changed relate to the 82.Tn IEEE 83802.11 protocol which the 84.Tn WaveLAN 85implements. 86This includes the station name, whether the station is operating 87in ad-hoc (point to point) or BSS (service set) mode, and the 88network name of a service set to join (IBSS) if BSS mode is enabled. 89.Pp 90The 91.Ar iface 92argument given to 93.Nm 94should be the logical interface name associated with the 95.Tn WaveLAN/IEEE 96device (e.g. wi0, wi1, etc.). 97.Sh OPTIONS 98With no extra options, 99.Nm 100will display the current settings of the specified 101.Tn WaveLAN/IEEE 102interface. 103.Pp 104The options are as follows: 105.Pp 106.Bl -tag -width Fl 107.It Fl a Ar access_point_density 108Specify the 109.Ar access point density 110for a given interface. 111Legal values are 1 (low), 2 (medium), and 3 (high). 112This setting influences some of the radio modem threshold settings. 113.It Fl D 114This forces the driver to initiate one round of access point scanning. 115All of the access points found are displayed. 116.It Fl d Ar max_data_length 117Set the maximum receive and transmit frame size for a specified interface. 118The 119.Ar max data length 120can be any number from 256 to 2346. 121The default is 2304. 122.It Fl M Ar 0|1 123Enable or disable 124.Qq microwave oven robustness 125on a given interface. 126.It Fl m Ar MAC address 127Set the station address for the specified interface. 128The 129.Ar MAC address 130is specified as a series of six hexadecimal values separated by colons, 131e.g. 00:60:1d:12:34:56. 132This programs the new address into the card and updates the interface as well. 133.It Fl o 134Print out the statistics counters instead of the card settings. 135Note that, however, the statistics will only be updated every minute or so. 136.It Fl R Ar 1|3 137Enable or disable roaming function on a given interface. 138The legal values are 139.Ar 1 140(Roaming handled by firmware) and 141.Ar 3 142(Roaming Disabled). 143The default is 1. 144.It Fl r Ar RTS threshold 145Set the RTS/CTS threshold for a given interface. 146This controls the number of bytes used for the RTS/CTS handshake boundary. 147The 148.Ar RTS threshold 149can be any value between 0 and 2347. 150The default is 2347, which indicates RTS/CTS mechanism never to be used. 151.It Fl s Ar station name 152Sets the 153.Ar station name 154for the specified interface. The 155.Ar station name 156is used for diagnostic purposes. 157The 158.Tn Lucent 159.Tn WaveMANAGER 160software can poll the names of remote hosts. 161.El 162.Sh SEE ALSO 163.Xr awi 4 , 164.Xr wi 4 , 165.Xr ifconfig 8 166.Sh HISTORY 167The 168.Nm 169command first appeared in 170.Fx 3.0 , 171as 172.Ic wicontrol . 173It was added to 174.Nx 1.5 175under its present name. 176.Sh AUTHORS 177The 178.Nm 179command was written by 180.An Bill Paul Aq wpaul@ctr.columbia.edu . 181