1*2adb3a73Sriastradh.\" $NetBSD: wiconfig.8,v 1.34 2014/03/18 18:20:47 riastradh Exp $ 282cee51cSexplorer.\" 37c002751Ssommerfeld.\" Copyright (c) 1997, 1998, 1999 47c002751Ssommerfeld.\" Bill Paul <wpaul@ctr.columbia.edu> All rights reserved. 57c002751Ssommerfeld.\" 67c002751Ssommerfeld.\" Redistribution and use in source and binary forms, with or without 77c002751Ssommerfeld.\" modification, are permitted provided that the following conditions 87c002751Ssommerfeld.\" are met: 97c002751Ssommerfeld.\" 1. Redistributions of source code must retain the above copyright 107c002751Ssommerfeld.\" notice, this list of conditions and the following disclaimer. 117c002751Ssommerfeld.\" 2. Redistributions in binary form must reproduce the above copyright 127c002751Ssommerfeld.\" notice, this list of conditions and the following disclaimer in the 137c002751Ssommerfeld.\" documentation and/or other materials provided with the distribution. 147c002751Ssommerfeld.\" 3. All advertising materials mentioning features or use of this software 157c002751Ssommerfeld.\" must display the following acknowledgement: 167c002751Ssommerfeld.\" This product includes software developed by Bill Paul. 177c002751Ssommerfeld.\" 4. Neither the name of the author nor the names of any co-contributors 187c002751Ssommerfeld.\" may be used to endorse or promote products derived from this software 197c002751Ssommerfeld.\" without specific prior written permission. 207c002751Ssommerfeld.\" 217c002751Ssommerfeld.\" THIS SOFTWARE IS PROVIDED BY Bill Paul AND CONTRIBUTORS ``AS IS'' AND 227c002751Ssommerfeld.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 237c002751Ssommerfeld.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 247c002751Ssommerfeld.\" ARE DISCLAIMED. IN NO EVENT SHALL Bill Paul OR THE VOICES IN HIS HEAD 257c002751Ssommerfeld.\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 267c002751Ssommerfeld.\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF 277c002751Ssommerfeld.\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS 287c002751Ssommerfeld.\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN 297c002751Ssommerfeld.\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) 307c002751Ssommerfeld.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF 317c002751Ssommerfeld.\" THE POSSIBILITY OF SUCH DAMAGE. 327c002751Ssommerfeld.\" 3382cee51cSexplorer.\" From: wicontrol.8,v 1.6 1999/05/22 16:12:47 wpaul Exp $ 347c002751Ssommerfeld.\" 3553e43e1eSdyoung.Dd July 2, 2009 36ebe6b128Ssommerfeld.Dt WICONFIG 8 3782cee51cSexplorer.Os 387c002751Ssommerfeld.Sh NAME 39ebe6b128Ssommerfeld.Nm wiconfig 407c002751Ssommerfeld.Nd configure WaveLAN/IEEE devices 417c002751Ssommerfeld.Sh SYNOPSIS 42ebe6b128Ssommerfeld.Nm wiconfig 4382cee51cSexplorer.Ar interface 44f8b131ddSwiz.Op Fl \&Dho 452cf9ffa1Swrstuden.Op Fl A Ar 1|2 46f8b131ddSwiz.Op Fl a Ar access_point_density 47f8b131ddSwiz.Op Fl d Ar max_data_length 485056d0ceSjhawk.Op Fl M Ar 0|1 49a420303aSichiro.Op Fl R Ar 1|3 50f8b131ddSwiz.Op Fl s Ar station_name 517c002751Ssommerfeld.Sh DESCRIPTION 527c002751SsommerfeldThe 537c002751Ssommerfeld.Nm 54622875edSfaircommand controls the operation of 55622875edSfair.Tn WaveLAN/IEEE 56622875edSfairwireless networking devices via the 577c002751Ssommerfeld.Xr wi 4 5882cee51cSexplorerand 5982cee51cSexplorer.Xr awi 4 60622875edSfairdrivers. 61622875edSfairThe 627c002751Ssommerfeld.Nm 636412403cSenamicommand can also be used to view the current settings of these parameters 647c002751Ssommerfeldand to dump out the values of the card's statistics counters. 657c002751Ssommerfeld.Pp 66622875edSfairMost of the parameters that can be changed relate to the 67622875edSfair.Tn IEEE 68622875edSfair802.11 protocol which the 69622875edSfair.Tn WaveLAN 70622875edSfairimplements. 71622875edSfairThis includes the station name, whether the station is operating 72622875edSfairin ad-hoc (point to point) or BSS (service set) mode, and the 73622875edSfairnetwork name of a service set to join (IBSS) if BSS mode is enabled. 74622875edSfair.Pp 757c002751SsommerfeldThe 7679ebccc3Swiz.Ar interface 777c002751Ssommerfeldargument given to 787c002751Ssommerfeld.Nm 79622875edSfairshould be the logical interface name associated with the 80622875edSfair.Tn WaveLAN/IEEE 814e9fe74cSwizdevice (e.g., wi0, wi1, etc.). 827c002751Ssommerfeld.Sh OPTIONS 830b740ef3SitojunWith no extra options, 840b740ef3Sitojun.Nm 85622875edSfairwill display the current settings of the specified 86622875edSfair.Tn WaveLAN/IEEE 87622875edSfairinterface. 880b740ef3Sitojun.Pp 897c002751SsommerfeldThe options are as follows: 9082cee51cSexplorer.Pp 917c002751Ssommerfeld.Bl -tag -width Fl 92ab0dd82bSwiz.It Fl A Ar 1|2 93ab0dd82bSwizSet the authentication type for a specified interface. 94ab0dd82bSwizPermitted values are 95ab0dd82bSwiz.Ar 1 96ab0dd82bSwiz(Open System Authentication) or 97ab0dd82bSwiz.Ar 2 98ab0dd82bSwiz(Shared Key Authentication). 99ab0dd82bSwizThe default is 1. 100c59faa6fSwiz.It Fl a Ar access_point_density 101c59faa6fSwizSpecify the 102c59faa6fSwiz.Ar access point density 103c59faa6fSwizfor a given interface. 104c59faa6fSwizLegal values are 1 (low), 2 (medium), and 3 (high). 105c59faa6fSwizThis setting influences some of the radio modem threshold settings. 1061635f76bSichiro.It Fl D 1071635f76bSichiroThis forces the driver to initiate one round of access point scanning. 108622875edSfairAll of the access points found are displayed. 109c59faa6fSwiz.It Fl d Ar max_data_length 110c59faa6fSwizSet the maximum receive and transmit frame size for a specified interface. 111c59faa6fSwizThe 112c59faa6fSwiz.Ar max data length 113c59faa6fSwizcan be any number from 256 to 2346. 114c59faa6fSwizThe default is 2304. 115f8b131ddSwiz.It Fl h 116f8b131ddSwizDisplay a short help. 117c59faa6fSwiz.It Fl M Ar 0|1 118c59faa6fSwizEnable or disable 119c59faa6fSwiz.Qq microwave oven robustness 120c59faa6fSwizon a given interface. 121ba7c369fSperryThis should only be used if needed. 122ba7c369fSperry.Pp 123ba7c369fSperryIn cases of slow performance where there is a good quality signal but 1244e9fe74cSwizalso high levels of noise (i.e., the signal to noise ratio is bad but 12553e43e1eSdyoungthe signal strength is good), or a microwave oven is operating near the 12653e43e1eSdyoungantenna of the WLAN peer or access point, this option may be of use. 127ba7c369fSperry.Pp 128ba7c369fSperryIn bad signal-to-noise conditions, the link layer will switch to lower 129ba7c369fSperrytransmit rates. 130ba7c369fSperryHowever at lower transmit rates, individual frames 131ba7c369fSperrytake longer to transmit, making them more vulnerable to bursty 132ba7c369fSperrynoise. 133ba7c369fSperryThe option works by enabling data fragmentation in the link 134ba7c369fSperrylayer as the transmit speed lowers in an attempt to shorten the 135ba7c369fSperrytransmit time of each frame so that individual frames are more likely 136ba7c369fSperryto be transmitted without error. 137ba7c369fSperry.Pp 138ba7c369fSperryNote that this does not impact the visible MTU of the link. 139c59faa6fSwiz.It Fl o 140c59faa6fSwizPrint out the statistics counters instead of the card settings. 141c59faa6fSwizNote that, however, the statistics will only be updated every minute or so. 142c59faa6fSwiz.It Fl R Ar 1|3 143c59faa6fSwizEnable or disable roaming function on a given interface. 144c59faa6fSwizThe legal values are 145c59faa6fSwiz.Ar 1 146c59faa6fSwiz(Roaming handled by firmware) and 147c59faa6fSwiz.Ar 3 148c59faa6fSwiz(Roaming Disabled). 149c59faa6fSwizThe default is 1. 150f8b131ddSwiz.It Fl r Ar RTS_threshold 15153e43e1eSdyoung.It Fl f Ar fragmentation_threshold 15253e43e1eSdyoung.It Fl m Ar MAC_address 15353e43e1eSdyoungThese options are deprecated since 15453e43e1eSdyoung.Nx 6.0 . 15553e43e1eSdyoungUse 15653e43e1eSdyoung.Xr ifconfig 8 15753e43e1eSdyoungto set the link-layer address, the fragmentation threshold, and the RTS 15853e43e1eSdyoungthreshold. 159f8b131ddSwiz.It Fl s Ar station_name 1607c002751SsommerfeldSets the 161f8b131ddSwiz.Ar station_name 162674e4981Swizfor the specified interface. 163674e4981SwizThe 164f8b131ddSwiz.Ar station_name 165622875edSfairis used for diagnostic purposes. 166622875edSfairThe 167622875edSfair.Tn Lucent 168622875edSfair.Tn WaveMANAGER 169622875edSfairsoftware can poll the names of remote hosts. 1707c002751Ssommerfeld.El 1717c002751Ssommerfeld.Sh SEE ALSO 17282cee51cSexplorer.Xr awi 4 , 1737c002751Ssommerfeld.Xr wi 4 , 1747c002751Ssommerfeld.Xr ifconfig 8 1757c002751Ssommerfeld.Sh HISTORY 1767c002751SsommerfeldThe 1777c002751Ssommerfeld.Nm 1787c002751Ssommerfeldcommand first appeared in 179f6ba8482Sexplorer.Fx 3.0 , 180ebcd47ebSlukemas 1817557a033Swiz.Ic wicontrol . 182ebcd47ebSlukemIt was added to 183f6ba8482Sexplorer.Nx 1.5 184f6ba8482Sexplorerunder its present name. 185d2eb889fSwiz.Sh AUTHORS 1867c002751SsommerfeldThe 1877c002751Ssommerfeld.Nm 1887c002751Ssommerfeldcommand was written by 189fb06f38bSwiz.An Bill Paul Aq Mt wpaul@ctr.columbia.edu . 190