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 .br
  20 .BI "iwspy " interface " setthr " "low high"
  21 .br
  22 .BI "iwspy " interface " getthr"
  23 .\"
  24 .\" DESCRIPTION part
  25 .\"
  26 .SH DESCRIPTION
  27 .B Iwspy
  28 is used to set a list of addresses in a wireless network interface and
  29 to read back quality of link information for each of those. This
  30 information is the same as the one available in
  31 .I /proc/net/wireless
  32 : quality of the link, signal strength and noise level.
  33 .PP
  34 This information is updated each time a new packet is received, so
  35 each address of the list add some overhead in the driver.
  36 .PP
  37 Note the this functionality work only for node part of the current
  38 wireless cells.
  39 .\"
  40 .\" PARAMETER part
  41 .\"
  42 .SH PARAMETERS
  43 You may set any number of addresses up to 8.
  44 .TP
  45 .BR DNSNAME " | " IPADDR
  46 Set an IP address, or in some cases a DNS name (using the name
  47 resolver). As the hardware work with hardware addresses,
  48 .B iwspy
  49 will translate this IP address through
  50 .IR ARP .
  51 In some case, this address might not be in the ARP cache and
  52 .B iwspy
  53 will fail. In those case,
  54 .IR ping (8)
  55 this name/address and retry.
  56 .TP
  57 .B HWADDR
  58 Set a hardware (MAC) address (this address is not translated & checked
  59 like the IP one). The address must contain a colon
  60 .RB ( : )
  61 to be recognised as a hardware address.
  62 .TP
  63 .B +
  64 Add the new set of addresses at the end of the current list instead of
  65 replacing it. The address list is unique for each device, so each user
  66 should use this option to avoid conflicts.
  67 .TP
  68 .B off
  69 Remove the current list of addresses and disable the spy functionality
  70 .TP
  71 .B setthr
  72 Set the
  73 .I low
  74 and
  75 .I high
  76 signal strength threshold for the iwspy event (for driver that support
  77 it).
  78 .br
  79 Every time the signal strengh for any of the address monitored
  80 with iwspy goes lower than the low threshold or goes higher than the
  81 high threshold, a Wireless Event will be generated.
  82 .br
  83 This can be used to monitor link outages without having to run iwspy
  84 periodically.
  85 .TP
  86 .B getthr
  87 Retrieve the current
  88 .I low
  89 and
  90 .I high
  91 signal strength threshold for the iwspy event.
  92 \"
  93 .\" FILES part
  94 .\"
  95 .SH FILES
  96 .I /proc/net/wireless
  97 .\"
  98 .\" SEE ALSO part
  99 .\"
 100 .SH SEE ALSO
 101 .BR iwconfig (8),
 102 .BR iwlist (8),
 103 .BR iwevent (8),
 104 .BR iwpriv (8),
 105 .BR wireless (7).
 106