diff options
Diffstat (limited to 'usr.sbin')
-rw-r--r-- | usr.sbin/wicontrol/wicontrol.8 | 248 |
1 files changed, 150 insertions, 98 deletions
diff --git a/usr.sbin/wicontrol/wicontrol.8 b/usr.sbin/wicontrol/wicontrol.8 index e64f2d9..1be50b6 100644 --- a/usr.sbin/wicontrol/wicontrol.8 +++ b/usr.sbin/wicontrol/wicontrol.8 @@ -39,53 +39,53 @@ .Sh SYNOPSIS .Nm .Op Fl i -.Ar iface Op Fl oa +.Ar iface Op Fl o .Nm .Op Fl i -.Ar iface Fl t Ar tx rate +.Ar iface Fl t Ar tx_rate .Nm .Op Fl i -.Ar iface Fl n Ar network name +.Ar iface Fl n Ar network_name .Nm .Op Fl i -.Ar iface Fl s Ar station name +.Ar iface Fl s Ar station_name .Nm .Op Fl i -.Ar iface Fl c Ar 0|1 +.Ar iface Fl c Cm 0 | 1 .Nm .Op Fl i .Ar iface Fl q Ar SSID .Nm .Op Fl i -.Ar iface Fl p Ar port type +.Ar iface Fl p Ar port_type .Nm .Op Fl i -.Ar iface Fl a Ar access point density +.Ar iface Fl a Ar access_point_density .Nm .Op Fl i -.Ar iface Fl m Ar mac address +.Ar iface Fl m Ar mac_address .Nm .Op Fl i -.Ar iface Fl d Ar max data length +.Ar iface Fl d Ar max_data_length .Nm .Op Fl i -.Ar iface Fl e Ar 0|1 +.Ar iface Fl e Cm 0 | 1 .Nm .Op Fl i .Ar iface Fl k Ar key -.Op Fl v Ar 1|2|3|4 +.Op Fl v Cm 1 | 2 | 3 | 4 .Nm .Op Fl i -.Ar iface Fl T Ar 1|2|3|4 +.Ar iface Fl T Cm 1 | 2 | 3 | 4 .Nm .Op Fl i -.Ar iface Fl r Ar RTS threshold +.Ar iface Fl r Ar RTS_threshold .Nm .Op Fl i .Ar iface Fl f Ar frequency .Nm .Op Fl i -.Ar iface Fl P Ar 0|1 +.Ar iface Fl P Cm 0 | 1 .Nm .Op Fl i .Ar iface Fl S Ar max_sleep_duration @@ -120,12 +120,16 @@ The argument given to .Nm should be the logical interface name associated with the WaveLAN/IEEE -device (wi0, wi1, etc...). If none is specified then wi0 is used -as default. +device +.Li ( wi0 , wi1 , +etc.). +If none is specified then +.Dq Li wi0 +is used as default. .Sh OPTIONS The options are as follows: -.Bl -tag -width Fl -.It Fl i Ar iface Op Fl o +.Bl -tag -width indent +.It Oo Fl i Oc Ar iface Op Fl o Display the current settings of the specified WaveLAN/IEEE interface. This retrieves the current card settings from the driver and prints them out. @@ -134,8 +138,10 @@ Using the additional flag will cause .Nm to print out the statistics counters instead of the card settings. -Encryption keys are only displayed if wicontrol is run as root. -.It Fl i Ar iface Fl t Ar tx rate +Encryption keys are only displayed if +.Nm +is run as root. +.It Oo Fl i Oc Ar iface Fl t Ar tx_rate Set the transmit rate of the specified interface. The legal values for the transmit rate vary depending on whether the interface is a @@ -145,28 +151,35 @@ NICs support a maximum transmit rate of 2Mbps while the turbo NICs support a maximum speed of 6Mbps. The following table shows the legal transmit rate settings and the corresponding transmit speeds: -.Bl -column "TX rate " "NIC speed " -offset indent +.Bl -column ".Em TX\ rate" ".Em NIC\ speed" -offset indent .Em "TX rate NIC speed" -1 Fixed Low (1Mbps) -2 Fixed Standard (2Mbps) -3 Auto Rate Select (High) -4 Fixed Medium (4Mbps) -5 Fixed High (6Mbps) -6 Auto Rate Select (Standard) -7 Auto Rate Select (Medium) +.It Cm 1 Ta "Fixed Low (1Mbps)" +.It Cm 2 Ta "Fixed Standard (2Mbps)" +.It Cm 3 Ta "Auto Rate Select (High)" +.It Cm 4 Ta "Fixed Medium (4Mbps)" +.It Cm 5 Ta "Fixed High (6Mbps)" +.It Cm 6 Ta "Auto Rate Select (Standard)" +.It Cm 7 Ta "Auto Rate Select (Medium)" .El .Pp -The standard NICs support only settings 1 through 3. Turbo NICs support -all the above listed speed settings. -The default driver setting is 3 (auto rate select). -.It Fl i Ar iface Fl n Ar network name +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). +.It Oo Fl i Oc Ar iface Fl n Ar network_name Set the name of the service set (IBSS) that this station wishes to join. The -.Ar network name +.Ar network_name can be any text string up to 30 characters in length. The default name -is the string "ANY" which should allow the station to connect to the first +is the string +.Dq Li ANY +which should allow the station to connect to the first available access point. The interface should be set for BSS mode using the @@ -175,24 +188,33 @@ flag in order for this to work. .Pp Note: the WaveLAN manual indicates that an empty string will allow the host to connect to any access point, however I have also seen a reference -in another driver which indicates that the "ANY" string works as well. -.It Fl i Ar iface Fl s Ar station name +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 Sets the -.Ar station name +station name for the specified interface. The -.Ar station name +.Ar station_name is used for diagnostic purposes. -The Lucent WaveMANAGER software can +The +.Tn "Lucent WaveMANAGER" +software can poll the names of remote hosts. -.It Fl i Ar iface Fl c Ar 0|1 -Allow the station to create a service set (IBSS). Permitted values -are 0 (don't create IBSS) and 1 (enable creation of IBSS). The default -is 0. +.It Oo Fl i Oc Ar iface Fl c Cm 0 | 1 +Allow the station to create a service set (IBSS). +Permitted values are +.Cm 0 +(don't create IBSS) and +.Cm 1 +(enable creation of IBSS). +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. -.It Fl i Ar iface Fl q Ar SSID +.It Oo Fl i Oc Ar iface Fl q Ar SSID Specify the name of an IBSS (SSID) to create on a given interface. The .Ar SSID @@ -200,52 +222,67 @@ can be any text string up to 30 characters long. .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. -.It Fl i Ar iface Fl p Ar port type +.It Oo Fl i Oc Ar iface Fl p Ar port_type Set the -.Ar port type +port type for a specified interface. The legal values for -.Ar port type -are 1 (BSS mode) and 3 (ad-hoc) mode. +.Ar port_type +are +.Cm 1 +(BSS mode) and +.Cm 3 +(ad-hoc) mode. In ad-hoc mode, the station can communicate directly with any other stations within direct radio range -(provided that they are also operating in ad-hoc mode). In BSS mode, +(provided that they are also operating in ad-hoc mode). +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 3 +The default setting is +.Cm 3 (ad-hoc mode). -.It Fl i Ar iface Fl a Ar access_point_density +.It Oo Fl i Oc Ar iface Fl a Ar access_point_density Specify the -.Ar access point density +access point density for a given interface. -Legal values are 1 (low), 2 (medium) and 3 (high). +Legal values are +.Cm 1 +(low), +.Cm 2 +(medium) and +.Cm 3 +(high). This setting influences some of the radio modem threshold settings. -.It Fl i Ar iface Fl m Ar mac address +.It Oo Fl i Oc Ar iface Fl m Ar mac_address Set the station address for the specified interface. The -.Ar mac address +.Ar mac_address is specified as a series of six hexadecimal values separated by colons, -e.g.: 00:60:1d:12:34:56. +e.g., +.Dq Li 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 d Ar max_data_length +.It Oo Fl i Oc Ar iface Fl d Ar max_data_length Set the maximum receive and transmit frame size for a specified interface. The -.Ar max data length +.Ar max_data_length can be any number from 350 to 2304. The default is 2304. -.It Fl i Ar iface Fl e Ar 0|1 +.It Oo Fl i Oc Ar iface Fl e Cm 0 | 1 Enable or disable WEP encryption. Permitted values are -.Ar 0 +.Cm 0 (encryption disabled) or -.Ar 1 +.Cm 1 (encryption enabled). Encryption is off by default. .Pp Both 128-bit and 64-bit WEP have been broken. -See the BUGS section for details. -.It Fl i Ar iface Fl k Ar key "[-v 1|2|3|4]" +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 Set WEP encryption keys. There are four default encryption keys that can be programmed. @@ -257,8 +294,11 @@ If the .Fl v flag is not specified, the first key will be set. Encryption keys -can either be normal text (i.e. "hello") or a series of hexadecimal -digits (i.e. "0x1234512345"). For +can either be normal text (i.e.\& +.Dq Li hello ) +or a series of hexadecimal digits (i.e.\& +.Dq Li 0x1234512345 ) . +For WaveLAN Turbo Silver cards, the key is restricted to 40 bits, hence the key can be either a 5 character text string or 10 hex digits. For WaveLAN Turbo Gold cards, the key can also be 104 bits, @@ -267,22 +307,26 @@ string or 26 hex digits in addition to the formats supported by the Silver cards. .Pp Note: Both 128-bit and 64-bit WEP have been broken. -See the BUGS section for details. -.It Fl i Ar iface Fl T Ar 1|2|3|4 +See the +.Sx BUGS +section for details. +.It Oo Fl i Oc Ar iface Fl T Cm 1 | 2 | 3 | 4 Specify which of the four WEP encryption keys will be used to encrypt transmitted packets. .Pp Note: Both 128-bit and 64-bit WEP have been broken. -See the BUGS section for details. -.It Fl i Ar iface Fl r Ar RTS threshold +See the +.Sx BUGS +section for details. +.It Oo Fl i Oc 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 handshake boundary. The -.Ar RTS threshold +.Ar RTS_threshold can be any value between 0 and 2047. The default is 2347. -.It Fl i Ar iface Fl f Ar frequency +.It Oo Fl i Oc Ar iface Fl f Ar frequency Set the radio frequency of a given interface. The .Ar frequency @@ -294,34 +338,37 @@ Recognized regulatory authorities include the FCC (United States), ETSI (Europe), France and Japan. Frequencies in the table are specified in Mhz. -.Bl -column "Channel ID " "FCC " "ETSI " "France " "Japan " -offset indent +.Bl -column ".Em Channel\ ID" ".Em FCC" ".Em ETSI" ".Em France" ".Em Japan" -offset indent .Em "Channel ID FCC ETSI France Japan" -1 2412 2412 - 2412 -2 2417 2417 - 2417 -3 2422 2422 - 2422 -4 2427 2427 - 2427 -5 2432 2432 - 2432 -6 2437 2437 - 2437 -7 2442 2442 - 2442 -8 2447 2447 - 2447 -9 2452 2452 - 2452 -10 2457 2457 2457 2457 -11 2462 2462 2462 2462 -12 - 2467 2467 2467 -13 - 2472 2472 2472 -14 - - - 2484 +.It Cm 1 Ta "2412 2412 - 2412" +.It Cm 2 Ta "2417 2417 - 2417" +.It Cm 3 Ta "2422 2422 - 2422" +.It Cm 4 Ta "2427 2427 - 2427" +.It Cm 5 Ta "2432 2432 - 2432" +.It Cm 6 Ta "2437 2437 - 2437" +.It Cm 7 Ta "2442 2442 - 2442" +.It Cm 8 Ta "2447 2447 - 2447" +.It Cm 9 Ta "2452 2452 - 2452" +.It Cm 10 Ta "2457 2457 2457 2457" +.It Cm 11 Ta "2462 2462 2462 2462" +.It Cm 12 Ta "- 2467 2467 2467" +.It Cm 13 Ta "- 2472 2472 2472" +.It Cm 14 Ta "- - - 2484" .El .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 default channel is 14, +and Europe, the default channel is +.Cm 3 . +For NICs sold in France, the default channel is +.Cm 11 . +For NICs sold in Japan, the default channel is +.Cm 14 , 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 Fl i Ar iface Fl P Ar 0|1 +.It Oo Fl i Oc Ar iface Fl P Cm 0 | 1 Enable or disable power management on a given interface. Enabling power management uses an alternating sleep/wake protocol to help @@ -337,20 +384,24 @@ later, and in WaveLAN PCMCIA adapter firmware 2.00 or later. Older revisions will silently ignore the power management setting. Legal -values for this parameter are 0 (off) and 1 (on). -.It Fl i Ar iface Fl S Ar max_sleep_interval +values for this parameter are +.Cm 0 +(off) and +.Cm 1 +(on). +.It Oo Fl i Oc Ar iface Fl S Ar max_sleep_interval Specify the sleep interval to use when power management is enabled. The .Ar max_sleep_interval is specified in milliseconds. The default is 100. -.It Fl i Ar iface Fl Z +.It Oo Fl i Oc Ar iface Fl Z Clear the signal strength cache maintained internally by the -.Nm wi +.Xr wi 4 driver. -.It Fl i Ar iface Fl C +.It Oo Fl i Oc Ar iface Fl C Display the cached signal strength information maintained by the -.Nm wi +.Xr wi 4 driver. The driver retains information about signal strength and noise level for packets received from different hosts. @@ -389,8 +440,9 @@ hours on a partially loaded network. Once a key has been compromised, the only remedial action is to discontinue it and use a new key. .Pp -See http://www.cs.rice.edu/~astubble/wep/wep_attack.html for details -of the attack. +See +.Pa http://www.cs.rice.edu/~astubble/wep/wep_attack.html +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. |