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 takes 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. With some card/driver,
  76 this enables to see hidden networks. The option
  77 .B last
  78 does not trigger a scan and read left-over scan results.
  79 .TP
  80 .BR freq [uency]/ channel
  81 Give the list of available frequencies in the device and the number of
  82 defined channels. Please note that usually the driver returns the
  83 total number of channels and only the frequencies available in the
  84 present locale, so there is no one-to-one mapping between frequencies
  85 displayed and channel numbers.
  86 .TP
  87 .BR rate / bit [rate]
  88 List the bit-rates supported by the device.
  89 .TP
  90 .BR keys / enc [ryption]
  91 List the encryption key sizes supported and list all the encryption
  92 keys set in the device.
  93 .TP
  94 .B power
  95 List the various Power Management attributes and modes of the device.
  96 .TP
  97 .B txpower
  98 List the various Transmit Powers available on the device.
  99 .TP
 100 .B retry
 101 List the transmit retry limits and retry lifetime on the device.
 102 .TP
 103 .BR ap / accesspoint / peers
 104 Give the list of Access Points in range, and optionally the quality of
 105 link to them. This feature is
 106 .B obsolete
 107 and now deprecated in favor of scanning support (above), and most
 108 drivers don't support it.
 109 .br
 110 Some drivers may use this command to return a specific list of Peers
 111 or Access Points, such as the list of Peers associated/registered with
 112 the card. See your driver documentation for details.
 113 .TP
 114 .B event
 115 List the wireless events supported by the device.
 116 .TP
 117 .B auth
 118 List the WPA authentication parametes curently set.
 119 .TP
 120 .BR wpa [keys]
 121 List all the WPA encryption keys set in the device.
 122 .TP
 123 .B genie
 124 List the Generic Information Elements set in the device (used for WPA
 125 support).
 126 .TP
 127 .BR modu [lation]
 128 List the modulations supported by the device and the modulations
 129 currently enabled.
 130 .TP
 131 .B --version
 132 Display the version of the tools, as well as the recommended and
 133 current Wireless Extensions version for the tool and the various
 134 wireless interfaces.
 135 .TP
 136 .B --help
 137 Display short help message.
 138 .\"
 139 .\" FILES part
 140 .\"
 141 .SH FILES
 142 .I /proc/net/wireless
 143 .\"
 144 .\" SEE ALSO part
 145 .\"
 146 .SH SEE ALSO
 147 .BR iwconfig (8),
 148 .BR iwspy (8).
 149 .BR iwevent (8),
 150 .BR iwpriv (8),
 151 .BR wireless (7).
 152