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 " [+] " DNSNAME " | " IPADDR " | " HWADDR " [...]"
  17 .br
  18 .BI "iwspy " interface " off"
  19 .\"
  20 .\" DESCRIPTION part
  21 .\"
  22 .SH DESCRIPTION
  23 .B Iwspy
  24 is used to set a list of addresses in a wireless network interface and
  25 to read back quality of link information for each of those. This
  26 information is the same as the one available in
  27 .I /proc/net/wireless
  28 : quality of the link, signal strength and noise level.
  29 .PP
  30 This information is updated each time a new packet is received, so
  31 each address of the list add some overhead in the driver.
  32 .PP
  33 Note the this functionality work only for node part of the current
  34 wireless cells.
  35 .\"
  36 .\" PARAMETER part
  37 .\"
  38 .SH PARAMETERS
  39 You may set any number of addresses up to 8.
  40 .TP
  41 .BR DNSNAME " | " IPADDR
  42 Set an IP address, or in some cases a DNS name (using the name
  43 resolver). As the hardware work with hardware addresses,
  44 .B iwspy
  45 will translate this IP address through
  46 .IR ARP .
  47 In some case, this address might not be in the ARP cache and
  48 .B iwspy
  49 will fail. In those case,
  50 .IR ping (8)
  51 this name/address and retry.
  52 .TP
  53 .B HWADDR
  54 Set a hardware (MAC) address (this address is not translated & checked
  55 like the IP one). The address must contain a colon
  56 .RB ( : )
  57 to be recognised as a hardware address.
  58 .TP
  59 .B +
  60 Add the new set of addresses at the end of the current list instead of
  61 replacing it. The address list is unique for each device, so each user
  62 should use this option to avoid conflicts.
  63 .TP
  64 .B off
  65 Remove the current list of addresses and disable the spy functionality
  66 .\"
  67 .\" FILES part
  68 .\"
  69 .SH FILES
  70 .I /proc/net/wireless
  71 .\"
  72 .\" SEE ALSO part
  73 .\"
  74 .SH SEE ALSO
  75 .BR iwconfig (8),
  76 .BR ifconfig (8),
  77 .BR iwlist (8).
  78 .BR iwpriv (8).
  79