wireless_tools/iwspy.8

   1 .\" Jean II - HPLB - 96
   2 .\" iwspy.8
   3 .\"
   4 .TH IWSPY 8 "31 October 1996" "net-tools" "Linux Programmer's Manual"
   5 .\"
   6 .\" NAME part
   7 .\"
   8 .SH NAME
   9 iwspy \- Get wireless statistics from specific nodes
  10 .\"
  11 .\" SYNOPSIS part
  12 .\"
  13 .SH SYNOPSIS
  14 .BI "iwspy " interface
  15 .br
  16 .BI "iwspy " interface " [+] " IPADDR " | " HWADDR " [...]"
  17 .br
  18 .BI "iwspy " interface " off"
  19 .br
  20 .BI "iwspy " interface " freq"
  21 .br
  22 .BI "iwspy " interface " ap"
  23 .br
  24 .BI "iwspy " interface " rate"
  25 .br
  26 .BI "iwspy " interface " keys"
  27 .\"
  28 .\" DESCRIPTION part
  29 .\"
  30 .SH DESCRIPTION
  31 .B Iwspy
  32 is used to set a list of addresses in a wireless network interface and
  33 to read back quality of link information for each of those. This
  34 information is the same as the one available in
  35 .I /proc/net/wireless
  36 : quality of the link, signal strength and noise level.
  37 .PP
  38 This information is updated each time a new packet is received, so
  39 each address of the list add some overhead in the driver.
  40 .PP
  41 .B Iwspy
  42 Can also display the list of frequencies available for the device or the
  43 list of Access Points in range.
  44 .\"
  45 .\" PARAMETER part
  46 .\"
  47 .SH PARAMETERS
  48 You may set any number of addresses up to 8.
  49 .TP
  50 .B IPADDR
  51 Set an IP address, or in some cases a domain name. As the hardware
  52 work with hardware addresses,
  53 .B iwspy
  54 will translate this address through
  55 .IR ARP .
  56 In some case, this address might not be in the ARP cache and
  57 .B iwspy
  58 will fail. In those case,
  59 .IR ping (8)
  60 this address and retry.
  61 .TP
  62 .B HWADDR
  63 Set a hardware (MAC) address (this address is not translated & checked
  64 like the IP one). The address must contain a semicolon
  65 .RB ( : )
  66 to be recognised as a hardware address.
  67 .TP
  68 .B +
  69 Add the new set of addresses at the end of the current list instead of
  70 replacing it. The address list is unique for each device, so each user
  71 should use this option to avoid conflicts.
  72 .TP
  73 .B off
  74 Remove the current list of addresses and disable the spy functionality
  75 .TP
  76 .B freq
  77 Give the list of available frequencies in the device and the number of
  78 defined channels. Please note that usually the driver returns the
  79 total number of channels and only the frequencies available in the
  80 present locale, so there is no one to one mapping between frequencies
  81 displayed and channel numbers.
  82 .TP
  83 .B ap
  84 Give the list of Access Points in range, and optionally the quality of
  85 link to them.
  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 display all the encryption
  92 keys availables in the device.
  93 .\"
  94 .\" FILES part
  95 .\"
  96 .SH FILES
  97 .I /proc/net/wireless
  98 .\"
  99 .\" SEE ALSO part
 100 .\"
 101 .SH SEE ALSO
 102 .BR iwconfig (8),
 103 .BR ifconfig (8),
 104 .BR iwpriv (8).
 105