184 lines
4.1 KiB
HTML
184 lines
4.1 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of IWSPY</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>IWSPY</H1>
|
|
Section: Linux Programmer's Manual (8)<BR>Updated: 31 October 1996<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
|
|
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
iwspy - Get wireless statistics from specific nodes
|
|
|
|
|
|
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>iwspy [</B><I>interface</I><B>]</B>
|
|
|
|
<BR>
|
|
|
|
<B>iwspy </B><I>interface</I><B> [+] </B><I>DNSNAME</I><B> | </B><I>IPADDR</I><B> | </B><I>HWADDR</I><B> [...]</B>
|
|
|
|
<BR>
|
|
|
|
<B>iwspy </B><I>interface</I><B> off</B>
|
|
|
|
<BR>
|
|
|
|
<B>iwspy </B><I>interface</I><B> setthr </B><I>low high</I>
|
|
|
|
<BR>
|
|
|
|
<B>iwspy </B><I>interface</I><B> getthr</B>
|
|
|
|
|
|
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>Iwspy</B>
|
|
|
|
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
|
|
<I>/proc/net/wireless</I>
|
|
|
|
: quality of the link, signal strength and noise level.
|
|
<P>
|
|
|
|
This information is updated each time a new packet is received, so
|
|
each address of the list adds some overhead in the driver.
|
|
<P>
|
|
|
|
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.
|
|
|
|
|
|
|
|
<A NAME="lbAE"> </A>
|
|
<H2>PARAMETERS</H2>
|
|
|
|
You may set any number of addresses up to 8.
|
|
<DL COMPACT>
|
|
<DT id="1"><B>DNSNAME</B> | <B>IPADDR</B>
|
|
|
|
<DD>
|
|
Set an IP address, or in some cases a DNS name (using the name
|
|
resolver). As the hardware works with hardware addresses,
|
|
<B>iwspy</B>
|
|
|
|
will translate this IP address through
|
|
<I>ARP</I>.
|
|
|
|
In some case, this address might not be in the ARP cache and
|
|
<B>iwspy</B>
|
|
|
|
will fail. In those case,
|
|
<I><A HREF="/cgi-bin/man/man2html?8+ping">ping</A></I>(8)
|
|
|
|
this name/address and retry.
|
|
<DT id="2"><B>HWADDR</B>
|
|
|
|
<DD>
|
|
Set a hardware (MAC) address (this address is not translated & checked
|
|
like the IP one). The address must contain a colon
|
|
(<B>:</B>)
|
|
|
|
to be recognised as a hardware address.
|
|
<DT id="3"><B>+</B>
|
|
|
|
<DD>
|
|
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.
|
|
<DT id="4"><B>off</B>
|
|
|
|
<DD>
|
|
Remove the current list of addresses and disable the spy functionality
|
|
<DT id="5"><B>setthr</B>
|
|
|
|
<DD>
|
|
Set the
|
|
<I>low</I>
|
|
|
|
and
|
|
<I>high</I>
|
|
|
|
signal strength threshold for the iwspy event (for drivers that
|
|
support it).
|
|
<BR>
|
|
|
|
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.
|
|
<BR>
|
|
|
|
This can be used to monitor link outages without having to run iwspy
|
|
periodically.
|
|
<DT id="6"><B>getthr</B>
|
|
|
|
<DD>
|
|
Retrieve the current
|
|
<I>low</I>
|
|
|
|
and
|
|
<I>high</I>
|
|
|
|
signal strength threshold for the iwspy event.
|
|
|
|
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
<I>/proc/net/wireless</I>
|
|
|
|
|
|
|
|
|
|
<A NAME="lbAG"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+iwconfig">iwconfig</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+iwlist">iwlist</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+iwevent">iwevent</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?8+iwpriv">iwpriv</A></B>(8),
|
|
|
|
<B><A HREF="/cgi-bin/man/man2html?7+wireless">wireless</A></B>(7).
|
|
|
|
<P>
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="7"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="8"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="9"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="10"><A HREF="#lbAE">PARAMETERS</A><DD>
|
|
<DT id="11"><A HREF="#lbAF">FILES</A><DD>
|
|
<DT id="12"><A HREF="#lbAG">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:04:54 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|