.\" Jean II - HPLB - 96
.\" iwlist.8
.\"
-.TH IWLIST 8 "31 October 1996" "net-tools" "Linux Programmer's Manual"
+.TH IWLIST 8 "23 June 2004" "wireless-tools" "Linux Programmer's Manual"
.\"
.\" NAME part
.\"
.SH NAME
-iwlist \- Get wireless statistics from specific nodes
+iwlist \- Get more detailed wireless information from a wireless interface
.\"
.\" SYNOPSIS part
.\"
.SH SYNOPSIS
-.BI "iwlist " interface " freq"
+.BI "iwlist " interface " scanning"
.br
-.BI "iwlist " interface " ap"
+.BI "iwlist " interface " frequency"
.br
.BI "iwlist " interface " rate"
.br
.BI "iwlist " interface " txpower"
.br
.BI "iwlist " interface " retry"
+.br
+.BI "iwlist " interface " event"
+.br
+.BI "iwlist --help"
+.br
+.BI "iwlist --version"
.\"
.\" DESCRIPTION part
.\"
.SH DESCRIPTION
.B Iwlist
-is used to display some large chunk of information from a wireless
-network interface that is not displayed by iwconfig. This is typically
-list of parameters.
+is used to display some additional information from a wireless network
+interface that is not displayed by
+.IR iwconfig (8).
+The main argument is used
+to select a category of information,
+.B iwlist
+displays in detailed form all information related to this category,
+including information already shown by
+.IR iwconfig (8).
.\"
.\" PARAMETER part
.\"
.SH PARAMETERS
.TP
-.BR freq / channel
+.BR scan [ning]
+Give the list of Access Points and Ad-Hoc cells in range, and
+optionally a whole bunch of information about them (ESSID, Quality,
+Frequency, Mode...). The type of information returned depends on what
+the card supports.
+.br
+Triggering scanning is a privileged operation
+.RI ( root
+only) and normal users can only read left-over scan results. By
+default, the way scanning is done (the scope of the scan) will be
+impacted by the current setting of the driver. Also, this command is
+supposed to take extra arguments to control the scanning behaviour,
+but this is currently not implemented.
+.TP
+.BR freq [uency]/ channel
Give the list of available frequencies in the device and the number of
defined channels. Please note that usually the driver returns the
total number of channels and only the frequencies available in the
-present locale, so there is no one to one mapping between frequencies
+present locale, so there is no one-to-one mapping between frequencies
displayed and channel numbers.
.TP
-.BR ap / accesspoint
-Give the list of Access Points in range, and optionally the quality of
-link to them.
-.TP
.BR rate / bit [rate]
List the bit-rates supported by the device.
.TP
.BR key / enc [ryption]
List the encryption key sizes supported and display all the encryption
-keys availables in the device.
+keys available in the device.
.TP
.B power
List the various Power Management attributes and modes of the device.
.TP
.B txpower
-List the various Transmit Power available on the device.
+List the various Transmit Powers available on the device.
.TP
.B retry
List the transmit retry limits and retry lifetime on the device.
+.TP
+.BR ap / accesspoint / peers
+Give the list of Access Points in range, and optionally the quality of
+link to them. This feature is
+.B obsolete
+and now deprecated in favor of scanning support (above), and most
+drivers don't support it.
+.br
+Some drivers may use this command to return a specific list of Peers
+or Access Points, such as the list of Peers associated/registered with
+the card. See your driver documentation for details.
+.TP
+.B event
+List the wireless events supported by the device.
+.TP
+.B --version
+Display the version of the tools, as well as the recommended and
+current Wireless Extensions version for the tool and the various
+wireless interfaces.
.\"
.\" FILES part
.\"
.\"
.SH SEE ALSO
.BR iwconfig (8),
-.BR ifconfig (8),
.BR iwspy (8).
-.BR iwpriv (8).
+.BR iwevent (8),
+.BR iwpriv (8),
+.BR wireless (7).
OSDN Git Service
