Debian Codegraph @

upstream/debian-unstable/man8/iwlist.8

raw
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).