| 1 |
.\" Jean II - HPLB - 96 |
| 2 |
.\" iwlist.8 |
| 3 |
.\" |
| 4 |
.TH IWLIST 8 "13 April 2006" "wireless-tools" "Linux Programmer's Manual" |
| 5 |
.\" |
| 6 |
.\" NAME part |
| 7 |
.\" |
| 8 |
.SH NAME |
| 9 |
iwlist \- Get more detailed wireless information from a wireless interface |
| 10 |
.\" |
| 11 |
.\" SYNOPSIS part |
| 12 |
.\" |
| 13 |
.SH SYNOPSIS |
| 14 |
.BI "iwlist [" interface "] scanning" |
| 15 |
.br |
| 16 |
.BI "iwlist [" interface "] frequency" |
| 17 |
.br |
| 18 |
.BI "iwlist [" interface "] channel" |
| 19 |
.br |
| 20 |
.BI "iwlist [" interface "] rate" |
| 21 |
.br |
| 22 |
.BI "iwlist [" interface "] bitrate" |
| 23 |
.br |
| 24 |
.BI "iwlist [" interface "] keys" |
| 25 |
.br |
| 26 |
.BI "iwlist [" interface "] encryption" |
| 27 |
.br |
| 28 |
.BI "iwlist [" interface "] power" |
| 29 |
.br |
| 30 |
.BI "iwlist [" interface "] txpower" |
| 31 |
.br |
| 32 |
.BI "iwlist [" interface "] retry" |
| 33 |
.br |
| 34 |
.BI "iwlist [" interface "] ap" |
| 35 |
.br |
| 36 |
.BI "iwlist [" interface "] accesspoints" |
| 37 |
.br |
| 38 |
.BI "iwlist [" interface "] peers" |
| 39 |
.br |
| 40 |
.BI "iwlist [" interface "] event" |
| 41 |
.br |
| 42 |
.BI "iwlist [" interface "] auth" |
| 43 |
.br |
| 44 |
.BI "iwlist [" interface "] wpakeys" |
| 45 |
.br |
| 46 |
.BI "iwlist [" interface "] genie" |
| 47 |
.br |
| 48 |
.BI "iwlist [" interface "] modulation" |
| 49 |
.br |
| 50 |
.BI "iwlist --help" |
| 51 |
.br |
| 52 |
.BI "iwlist --version" |
| 53 |
.\" |
| 54 |
.\" DESCRIPTION part |
| 55 |
.\" |
| 56 |
.SH DESCRIPTION |
| 57 |
.B Iwlist |
| 58 |
is used to display some additional information from a wireless network |
| 59 |
interface that is not displayed by |
| 60 |
.IR iwconfig (8). |
| 61 |
The main argument is used |
| 62 |
to select a category of information, |
| 63 |
.B iwlist |
| 64 |
displays in detailed form all information related to this category, |
| 65 |
including information already shown by |
| 66 |
.IR iwconfig (8). |
| 67 |
.\" |
| 68 |
.\" PARAMETER part |
| 69 |
.\" |
| 70 |
.SH PARAMETERS |
| 71 |
.TP |
| 72 |
.BR scan [ning] |
| 73 |
Give the list of Access Points and Ad-Hoc cells in range, and |
| 74 |
optionally a whole bunch of information about them (ESSID, Quality, |
| 75 |
Frequency, Mode...). The type of information returned depends on what |
| 76 |
the card supports. |
| 77 |
.br |
| 78 |
Triggering scanning is a privileged operation |
| 79 |
.RI ( root |
| 80 |
only) and normal users can only read left-over scan results. By |
| 81 |
default, the way scanning is done (the scope of the scan) is dependant |
| 82 |
on the card and card settings. |
| 83 |
.br |
| 84 |
This command takes optional arguments, however most drivers will ignore |
| 85 |
those. The option |
| 86 |
.B essid |
| 87 |
is used to specify a scan on a specific ESSID. With some card/driver, |
| 88 |
this enables to see hidden networks. The option |
| 89 |
.B last |
| 90 |
does not trigger a scan and read left-over scan results. |
| 91 |
.TP |
| 92 |
.BR freq [uency]/ channel |
| 93 |
Give the list of available frequencies in the device and the number of |
| 94 |
defined channels. Please note that usually the driver returns the |
| 95 |
total number of channels and only the frequencies available in the |
| 96 |
present locale, so there is no one-to-one mapping between frequencies |
| 97 |
displayed and channel numbers. |
| 98 |
.TP |
| 99 |
.BR rate / bit [rate] |
| 100 |
List the bit-rates supported by the device. |
| 101 |
.TP |
| 102 |
.BR keys / enc [ryption] |
| 103 |
List the encryption key sizes supported and list all the encryption |
| 104 |
keys set in the device. |
| 105 |
.TP |
| 106 |
.B power |
| 107 |
List the various Power Management attributes and modes of the device. |
| 108 |
.TP |
| 109 |
.B txpower |
| 110 |
List the various Transmit Powers available on the device. |
| 111 |
.TP |
| 112 |
.B retry |
| 113 |
List the transmit retry limits and retry lifetime on the device. |
| 114 |
.TP |
| 115 |
.BR ap / accesspoint / peers |
| 116 |
Give the list of Access Points in range, and optionally the quality of |
| 117 |
link to them. This feature is |
| 118 |
.B obsolete |
| 119 |
and now deprecated in favor of scanning support (above), and most |
| 120 |
drivers don't support it. |
| 121 |
.br |
| 122 |
Some drivers may use this command to return a specific list of Peers |
| 123 |
or Access Points, such as the list of Peers associated/registered with |
| 124 |
the card. See your driver documentation for details. |
| 125 |
.TP |
| 126 |
.B event |
| 127 |
List the wireless events supported by the device. |
| 128 |
.TP |
| 129 |
.B auth |
| 130 |
List the WPA authentication parameters currently set. |
| 131 |
.TP |
| 132 |
.BR wpa [keys] |
| 133 |
List all the WPA encryption keys set in the device. |
| 134 |
.TP |
| 135 |
.B genie |
| 136 |
List the Generic Information Elements set in the device (used for WPA |
| 137 |
support). |
| 138 |
.TP |
| 139 |
.BR modu [lation] |
| 140 |
List the modulations supported by the device and the modulations |
| 141 |
currently enabled. |
| 142 |
.TP |
| 143 |
.B --version |
| 144 |
Display the version of the tools, as well as the recommended and |
| 145 |
current Wireless Extensions version for the tool and the various |
| 146 |
wireless interfaces. |
| 147 |
.TP |
| 148 |
.B --help |
| 149 |
Display short help message. |
| 150 |
.\" |
| 151 |
.\" FILES part |
| 152 |
.\" |
| 153 |
.SH FILES |
| 154 |
.I /proc/net/wireless |
| 155 |
.\" |
| 156 |
.\" SEE ALSO part |
| 157 |
.\" |
| 158 |
.SH SEE ALSO |
| 159 |
.BR iwconfig (8), |
| 160 |
.BR iwspy (8). |
| 161 |
.BR iwevent (8), |
| 162 |
.BR iwpriv (8), |
| 163 |
.BR wireless (7), |
| 164 |
.BR ifrename (8), |
| 165 |
.BR iftab (5), |
| 166 |
.BR iwgetid (8). |