wireless_tools/iwlist.8

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