wireless_tools/iwlist.8

   1 .\" Jean II - HPLB - 96
   2 .\" iwlist.8
   3 .\"
   4 .TH IWLIST 8 "23 June 2004" "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 " key"
  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 --help"
  31 .br
  32 .BI "iwlist --version"
  33 .\"
  34 .\" DESCRIPTION part
  35 .\"
  36 .SH DESCRIPTION
  37 .B Iwlist
  38 is used to display some additional information from a wireless network
  39 interface that is not displayed by
  40 .IR iwconfig (8).
  41 The main argument is used
  42 to select a category of information,
  43 .B iwlist
  44 displays in detailed form all information related to this category,
  45 including information already shown by
  46 .IR iwconfig (8).
  47 .\"
  48 .\" PARAMETER part
  49 .\"
  50 .SH PARAMETERS
  51 .TP
  52 .BR scan [ning]
  53 Give the list of Access Points and Ad-Hoc cells in range, and
  54 optionally a whole bunch of information about them (ESSID, Quality,
  55 Frequency, Mode...). The type of information returned depends on what
  56 the card supports.
  57 .br
  58 Triggering scanning is a privileged operation
  59 .RI ( root
  60 only) and normal users can only read left-over scan results. By
  61 default, the way scanning is done (the scope of the scan) will be
  62 impacted by the current setting of the driver. Also, this command is
  63 supposed to take extra arguments to control the scanning behaviour,
  64 but this is currently not implemented.
  65 .TP
  66 .BR freq [uency]/ channel
  67 Give the list of available frequencies in the device and the number of
  68 defined channels. Please note that usually the driver returns the
  69 total number of channels and only the frequencies available in the
  70 present locale, so there is no one-to-one mapping between frequencies
  71 displayed and channel numbers.
  72 .TP
  73 .BR rate / bit [rate]
  74 List the bit-rates supported by the device.
  75 .TP
  76 .BR key / enc [ryption]
  77 List the encryption key sizes supported and display all the encryption
  78 keys available in the device.
  79 .TP
  80 .B power
  81 List the various Power Management attributes and modes of the device.
  82 .TP
  83 .B txpower
  84 List the various Transmit Powers available on the device.
  85 .TP
  86 .B retry
  87 List the transmit retry limits and retry lifetime on the device.
  88 .TP
  89 .BR ap / accesspoint / peers
  90 Give the list of Access Points in range, and optionally the quality of
  91 link to them. This feature is
  92 .B obsolete
  93 and now deprecated in favor of scanning support (above), and most
  94 drivers don't support it.
  95 .br
  96 Some drivers may use this command to return a specific list of Peers
  97 or Access Points, such as the list of Peers associated/registered with
  98 the card. See your driver documentation for details.
  99 .TP
 100 .B event
 101 List the wireless events supported by the device.
 102 .TP
 103 .B --version
 104 Display the version of the tools, as well as the recommended and
 105 current Wireless Extensions version for the tool and the various
 106 wireless interfaces.
 107 .\"
 108 .\" FILES part
 109 .\"
 110 .SH FILES
 111 .I /proc/net/wireless
 112 .\"
 113 .\" SEE ALSO part
 114 .\"
 115 .SH SEE ALSO
 116 .BR iwconfig (8),
 117 .BR iwspy (8).
 118 .BR iwevent (8),
 119 .BR iwpriv (8),
 120 .BR wireless (7).
 121