Provided by: wireless-tools_30~pre9-12ubuntu1_amd64 bug

NAME

       iwspy - Get wireless statistics from specific nodes

SYNOPSIS

       iwspy [interface]
       iwspy interface [+] DNSNAME | IPADDR | HWADDR [...]
       iwspy interface off
       iwspy interface setthr low high
       iwspy interface getthr

DESCRIPTION

       Iwspy is used to set a list of addresses to monitor in a wireless network interface and to
       read back quality of link information for each of those. This information is the  same  as
       the  one  available in /proc/net/wireless : quality of the link, signal strength and noise
       level.

       This information is updated each time a new packet is received, so  each  address  of  the
       list adds some overhead in the driver.

       Note  that  this functionality works only for nodes part of the current wireless cell, you
       can not monitor Access Points you are not associated with (you can use Scanning for  that)
       and  nodes in other cells. In Managed mode, in most case packets are relayed by the Access
       Point, in this case you will get the signal  strength  of  the  Access  Point.  For  those
       reasons this functionality is mostly useful in Ad-Hoc and Master mode.

PARAMETERS

       You may set any number of addresses up to 8.

       DNSNAME | IPADDR
              Set  an  IP  address, or in some cases a DNS name (using the name resolver). As the
              hardware works with hardware  addresses,  iwspy  will  translate  this  IP  address
              through  ARP.   In  some case, this address might not be in the ARP cache and iwspy
              will fail. In those case, ping(8) this name/address and retry.

       HWADDR Set a hardware (MAC) address (this address is not translated & checked like the  IP
              one). The address must contain a colon (:) to be recognised as a hardware address.

       +      Add  the  new  set of addresses at the end of the current list instead of replacing
              it. The address list is unique for each device, so each user should use this option
              to avoid conflicts.

       off    Remove the current list of addresses and disable the spy functionality

       setthr Set  the  low  and  high signal strength threshold for the iwspy event (for drivers
              that support it).
              Every time the signal strength for any of the address  monitored  with  iwspy  goes
              lower  than  the  low  threshold or goes higher than the high threshold, a Wireless
              Event will be generated.
              This can be used to monitor link outages without having to run iwspy periodically.

       getthr Retrieve the current low and high signal strength threshold for the iwspy event.

FILES

       /proc/net/wireless

SEE ALSO

       iwconfig(8), iwlist(8), iwevent(8), iwpriv(8), wireless(7).