bionic (8) iwspy.8.gz

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).