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 .\"
  26 .\" DESCRIPTION part
  27 .\"
  28 .SH DESCRIPTION
  29 .B Iwspy
  30 is used to set a list of addresses in a wireless network interface and
  31 to read back quality of link information for each of those. This
  32 information is the same as the one available in
  33 .I /proc/net/wireless
  34 : quality of the link, signal strength and noise level.
  35 .PP
  36 This information is updated each time a new packet is received, so
  37 each address of the list add some overhead in the driver.
  38 .PP
  39 .B Iwspy
  40 Can also display the list of frequencies available for the device or the
  41 list of Access Points in range.
  42 .\"
  43 .\" PARAMETER part
  44 .\"
  45 .SH PARAMETERS
  46 You may set any number of addresses up to 8.
  47 .TP
  48 .B IPADDR
  49 Set an IP address, or in some cases a domain name. As the hardware
  50 work with hardware addresses,
  51 .B iwspy
  52 will translate this address through
  53 .IR ARP .
  54 In some case, this address might not be in the ARP cache and
  55 .B iwspy
  56 will fail. In those case,
  57 .IR ping (8)
  58 this address and retry.
  59 .TP
  60 .B HWADDR
  61 Set a hardware (MAC) address (this address is not translated & checked
  62 like the IP one). The address must contain a semicolon
  63 .RB ( : )
  64 to be recognised as a hardware address.
  65 .TP
  66 .B +
  67 Add the new set of addresses at the end of the current list instead of
  68 replacing it. The address list is unique for each device, so each user
  69 should use this option to avoid conflicts.
  70 .TP
  71 .B off
  72 Remove the current list of addresses and disable the spy functionality
  73 .TP
  74 .B freq
  75 Give the list of available frequencies in the device and the number of
  76 defined channels. Please note that usually the driver returns the
  77 total number of channels and only the frequencies available in the
  78 present locale, so there is no one to one mapping between frequencies
  79 displayed and channel numbers.
  80 .TP
  81 .B ap
  82 Give the list of Access Points in range, and optionally the quality of
  83 link to them.
  84 .TP
  85 .BR rate / bit [ rate ]
  86 List the bit-rates supported by the device.
  87 .\"
  88 .\" FILES part
  89 .\"
  90 .SH FILES
  91 .I /proc/net/wireless
  92 .\"
  93 .\" SEE ALSO part
  94 .\"
  95 .SH SEE ALSO
  96 .BR iwconfig (8),
  97 .BR ifconfig (8),
  98 .BR iwpriv (8).
  99