X-Git-Url: http://git.osdn.net/view?p=android-x86%2Fexternal-wireless-tools.git;a=blobdiff_plain;f=wireless_tools%2Fiwconfig.8;h=fefaa9371c4afcd83132330a9af6cd58f9e1ad42;hp=fbc3483fc5e6498876c347c0c9d646a70e5f471a;hb=db34c20cecd8e65eca87ef9a5397b6b69c24dcad;hpb=37268af80055faf826140ff0c255f495df34b616 diff --git a/wireless_tools/iwconfig.8 b/wireless_tools/iwconfig.8 index fbc3483..fefaa93 100644 --- a/wireless_tools/iwconfig.8 +++ b/wireless_tools/iwconfig.8 @@ -20,6 +20,12 @@ iwconfig \- configure a wireless network interface .BI " [rate " R "] [rts " RT "] [frag " FT "] [txpower " T ] .br .BI " [enc " E "] [key " K "] [power " P "] [retry " R ] +.br +.BI " [commit] +.br +.BI "iwconfig --help" +.br +.BI "iwconfig --version" .\" .\" DESCRIPTION part .\" @@ -119,27 +125,45 @@ topology. The mode can be .I Ad-hoc (network composed of only one cell and without Access Point), .I Managed -(network composed of many cells, with roaming or with an Access Point), +(node connects to a network composed of many Access Points, with roaming), .I Master (the node is the synchronisation master or act as an Access Point), .I Repeater -(the node forward packets on the air), +(the node forward packets between other wireless nodes), .I Secondary -(the node act as a backup master/repeater) or +(the node act as a backup master/repeater), +.I Monitor +(the node act as a passive monitor and only receives packets) or .IR Auto . .br .B Example : .br .I " iwconfig eth0 mode Managed" +.br +.I " iwconfig eth0 mode Ad-Hoc" .TP .B ap -Register to the Access Point given by the address, if it is -possible. When the quality of the connection goes too low, the driver -may revert back to automatic mode. +Force the card to register to the Access Point given by the address, +if it is possible. When the quality of the connection goes too low, +the driver may revert back to automatic mode (the card finds the best +Access Point in range). +.br +You may also use +.I off +to re-enable automatic mode without changing the current Access Point, +or you may use +.I any +or +.I auto +to force the card to reassociate with the current best Access Point. .br .B Example : .br .I " iwconfig eth0 ap 00:60:1D:01:23:45" +.br +.I " iwconfig eth0 ap any" +.br +.I " iwconfig eth0 ap off" .TP .BR nick [name] Set the nickname, or the station name. Most 802.11 products do define @@ -173,6 +197,8 @@ the driver will use all bit lower and equal than this value. .I " iwconfig eth0 rate 11M" .br .I " iwconfig eth0 rate auto" +.br +.I " iwconfig eth0 rate 5.5M auto" .TP .BR rts [_threshold] RTS/CTS adds a handshake before each packet transmission to make sure @@ -204,27 +230,41 @@ packet size disable the scheme. You may also set this parameter to .I " iwconfig eth0 frag off" .TP .BR key / enc [ryption] -Used to manipulate encryption or scrambling keys and encryption mode. +Used to manipulate encryption or scrambling keys and security mode. .br To set the current encryption key, just enter the key in hex digits as .IR XXXX-XXXX-XXXX-XXXX " or " XXXXXXXX . -To set a key other than the current key, append +To set a key other than the current key, prepend or append .I [index] -to the key itself. You can also enter the key as an ASCII string by -using the +to the key itself (this won't change which is the active key). You can +also enter the key as an ASCII string by using the .I s: -prefix. +prefix. Passphrase is currently not supported. .br To change which key is the current active key, just enter .I [index] (without entering any key value). .br .IR off " and " on -disable and reenable encryption, +disable and reenable encryption. +.br +The security mode may be +.I open +or +.IR restricted , +and its meaning depend on the card used. With most card, in .I open -set the system in open mode (accept non-encrypted packets) and +mode no authentication is used and the card may also accept +non-encrypted sessions, whereas in .I restricted -discard non-encrypted packets. +mode only encrypted sessions are accepted and the card will use +authentication if available. +.br +If you need to set multiple keys, or set a key and change the active +key, you need to use multiple +.B key +directives. Arguments can be put in any order, the last one will take +precendence. .br .B Examples : .br @@ -235,6 +275,10 @@ discard non-encrypted packets. .I " iwconfig eth0 key [2] open" .br .I " iwconfig eth0 key off" +.br +.I " iwconfig eth0 key restricted [3] 0123456789" +.br +.I " iwconfig eth0 key 01-23 key 45-67 [4] key [4]" .TP .BR power Used to manipulate power management scheme parameters and mode. @@ -324,6 +368,15 @@ is the short retry limit (non RTS/CTS packets). .I " iwconfig eth0 retry lifetime 300m" .br .I " iwconfig eth0 retry min limit 8" +.TP +.BR commit +Some cards may not apply changes done through Wireless Extensions +immediately (they may wait to agregate the changes or apply it only +when the card is brought up via ifconfig). This command (when +available) force the card to apply all pending changes. +.br +This is normally not needed, because the card will eventually apply +the changes, but can be usefull for debugging. .\" .\" DISPLAY part .\" @@ -356,7 +409,7 @@ settings (depending on availability). .br See above for explanations of what these parameters mean. .br -If the label for bitrate is followed by +If the label for some values (such as bitrate) is followed by .RB ` = ', it means that the parameter is fixed and forced to that value, if it is followed by @@ -367,27 +420,57 @@ If .I /proc/net/wireless exists, .I iwconfig -will also display its content : +will also display its content. Note that those values will depend on +the driver and the hardware specifics, so you need to refer to your +driver documentation for proper interpretation of those values. .TP .B Link quality -Quality of the link or the modulation (what is the level of contention -or interference, or how good the received signal is). +Overall quality of the link. May be based on the level of contention +or interference, the bit or frame error rate, how good the received +signal is, some timing synchronisation, or other hardware metric. This +is an aggregate value, and depend totally on the driver and hardware. .TP .B Signal level -Received signal strength (how strong the received signal is). +Received signal strength (RSSI - how strong the received signal +is). May be arbitrary units or dBm, +.I iwconfig +uses driver meta information to interpret the raw value given by +.I /proc/net/wireless +and display the proper unit or maximum value (using 8 bit arithmetic). In +.I Ad-Hoc +mode, this may be undefined and you should use +.IR iwspy . .TP .B Noise level -Background noise level (when no packet is transmited). +Background noise level (when no packet is transmited). Similar +comments as for +.BR "Signal level" . +.TP +.B Rx invalid nwid +Number of packets received with a different NWID or ESSID. Used to +detect configuration problems or adjacent network existence (on the +same frequency). .TP -.B invalid nwid -Number of packets received with a different NWID. Used to detect -configuration problems or adjacent network existence. +.B Rx invalid crypt +Number of packets that the hardware was unable to decrypt. This can be +used to detect invalid encryption settings. .TP -.B invalid crypt -Number of packets that the hardware was unable to decrypt. +.B Rx invalid frag +Number of packets for which the hardware was not able to properly +re-assemble the link layer fragments (most likely one was missing). .TP -.B invalid misc +.B Tx excessive retries +Number of packets that the hardware failed to deliver. Most MAC +protocol will retry the packet a number of time before giving up. +.TP +.B Invalid misc Other packets lost in relation with specific wireless operations. +.TP +.B Missed beacon +Number of periodic beacons from the Cell or the Access Point we have +missed. Beacons are sent at regular interval to maintain the cell +coordination, failure to receive them usually indicate that we are out +of range. .\" .\" AUTHOR part .\" @@ -405,8 +488,6 @@ Jean Tourrilhes \- jt@hpl.hp.com .BR ifconfig (8), .BR iwspy (8), .BR iwlist (8), +.BR iwevent (8), .BR iwpriv (8), -.BR wavelan (4), -.BR wavelan_cs (4), -.BR wvlan_cs (4), -.BR netwave_cs (4). +.BR wireless (7).