diff options
-rw-r--r-- | usr.sbin/wicontrol/wicontrol.8 | 113 |
1 files changed, 97 insertions, 16 deletions
diff --git a/usr.sbin/wicontrol/wicontrol.8 b/usr.sbin/wicontrol/wicontrol.8 index 0b80fba..e8365e1 100644 --- a/usr.sbin/wicontrol/wicontrol.8 +++ b/usr.sbin/wicontrol/wicontrol.8 @@ -30,7 +30,7 @@ .\" .\" $FreeBSD$ .\" -.Dd April 21, 1999 +.Dd March 4, 2003 .Dt WICONTROL 8 .Os .Sh NAME @@ -112,12 +112,12 @@ utility controls the operation of WaveLAN/IEEE wireless networking devices via the .Xr wi 4 driver. -Most of the parameters that can be changed relate to the -IEEE 802.11 protocol which the WaveLAN implements. -This includes -the station name, whether the station is operating in ad-hoc (point -to point) or BSS (service set) mode, and the network name of a service -set to join (IBSS) if BSS mode is enabled. +.Pp +You should not use this program to configure IEEE 802.11 paramters. +Use +.Xr ifconfig 8 +instead to do those tasks. +.Pp The .Nm utility can also be used to view the current settings of these parameters @@ -150,6 +150,12 @@ Encryption keys are only displayed if .Nm is run as root. .It Oo Fl i Oc Ar iface Fl t Ar tx_rate +This flag is obsolete. +Use +.Xr ifconfig 8 +.Dq mediaopt +instead. +.Pp Set the transmit rate of the specified interface. The legal values for the transmit rate vary depending on whether the interface is a @@ -170,15 +176,19 @@ legal transmit rate settings and the corresponding transmit speeds: .It Cm 7 Ta "Auto Rate Select (Medium)" .El .Pp -The standard NICs support only settings -.Cm 1 -through -.Cm 3 . -Turbo NICs support all the above listed speed settings. The default driver setting is .Cm 3 (auto rate select). +The numbers vary from card to card. .It Oo Fl i Oc Ar iface Fl n Ar network_name +This flag is obsolete. +Use +.Xr ifconfig 8 +.Dq ssid +or +.Dq nwid +instead. +.Pp Set the name of the service set (IBSS) that this station wishes to join. The @@ -200,6 +210,14 @@ in another driver which indicates that the .Dq Li ANY string works as well. .It Oo Fl i Oc Ar iface Fl s Ar station_name +This flag is obsolete. +Use +.Xr ifconfig 8 +.Dq stationname +or +.Dq station +instead. +.Pp Sets the station name for the specified interface. @@ -211,6 +229,10 @@ The software can poll the names of remote hosts. .It Oo Fl i Oc Ar iface Fl c Cm 0 | 1 +This flag is obsolete. +IBSS networks are automatically created on those cards whose firmware +supports it while in IBSS mode. +.Pp Allow the station to create a service set (IBSS). Permitted values are .Cm 0 @@ -220,9 +242,13 @@ Permitted values are The default is .Cm 0 . .Pp -Note: this option is provided for experimental purposes only: enabling -the creation of an IBSS on a host system doesn't appear to actually work. +Only newer versions of the Lucent firmware support this. .It Oo Fl i Oc Ar iface Fl q Ar SSID +This flag is obsolete. +The ssid setting from +.Xr ifconfig 8 +is the current preferred way of setting this parameter. +.Pp Specify the name of an IBSS (SSID) to create on a given interface. The .Ar SSID @@ -231,6 +257,21 @@ 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 appear to actually work. .It Oo Fl i Oc Ar iface Fl p Ar port_type +This flag is obsolete. +It should never be used. +Do not use this flag. +Its meaning depends on the type of card you are using, as well as the +firmware you have installed in the card in some cases. +Beware. +Danger. +Do not use. +Instead, use the +.Xr ifconfig 8 +.Dq media +and +.Dq mediaopt +commands. +.Pp Set the port type for a specified interface. @@ -248,8 +289,12 @@ In BSS mode, hosts must associate with a service set controlled by an access point, which relays traffic between end stations. The default setting is -.Cm 3 -(ad-hoc mode). +.Cm 1 +(BSS mode). +Lucent cards have one set of meanings. +Prism cards have another. +Symbol cards have a third. +Do not use this flag. .It Oo Fl i Oc Ar iface Fl a Ar access_point_density Specify the access point density @@ -278,6 +323,12 @@ The can be any number from 350 to 2304. The default is 2304. .It Oo Fl i Oc Ar iface Fl e Cm 0 | 1 +This flag is obsolete. +It has been replaced by the +.Xr ifconfig 8 +.Dq wepmode +option. +.Pp Enable or disable WEP encryption. Permitted values are .Cm 0 @@ -291,6 +342,12 @@ See the .Sx BUGS section for details. .It Oo Fl i Oc Ar iface Fl k Ar key Op Fl v Cm 1 | 2 | 3 | 4 +This flag is obsoelte. +The +.Xr ifconfig 8 +.Dq wepkey +should be used instead. +.Pp Set WEP encryption keys. There are four default encryption keys that can be programmed. @@ -326,6 +383,12 @@ See the .Sx BUGS section for details. .It Oo Fl i Oc Ar iface Fl T Cm 1 | 2 | 3 | 4 +This flag is obsoelte. +The +.Xr ifconfig 8 +.Dq wepkey +should be used instead. +.Pp Specify which of the four WEP encryption keys will be used to encrypt transmitted packets. .Pp @@ -384,6 +447,12 @@ and it is the only available channel for pre-11Mbps NICs. Note that two stations must be set to the same channel in order to communicate. .It Oo Fl i Oc Ar iface Fl P Cm 0 | 1 +This flag is obsoelte. +The +.Xr ifconfig 8 +.Dq powersave +should be used instead. +.Pp Enable or disable power management on a given interface. Enabling power management uses an alternating sleep/wake protocol to help @@ -405,6 +474,12 @@ values for this parameter are .Cm 1 (on). .It Oo Fl i Oc Ar iface Fl S Ar max_sleep_interval +This flag is obsoelte. +The +.Xr ifconfig 8 +.Dq powersleep +should be used instead. +.Pp Specify the sleep interval to use when power management is enabled. The .Ar max_sleep_interval @@ -428,9 +503,13 @@ better signal quality). .El .Sh SEE ALSO .Xr ipsec 4 , +.Xr awi 4 , .Xr wi 4 , .Xr ifconfig 8 .Sh BUGS +There are obsolete flags here that should be removed. +These flags will be removed without further notice. +.Pp The WEP encryption method has been broken so that third parties can recover the keys in use relatively quickly at distances that are surprising to most people. @@ -461,6 +540,8 @@ for details of the attack. .Pp If you must use WEP, you are strongly encouraged to pick keys whose bytes are random and not confined to ASCII characters. +.Pp +Signal cache is broken right now. .Sh HISTORY The .Nm |