man-pages/cs/man8/iwspy.8.html
2021-03-31 01:06:50 +01:00

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">&nbsp;</A>
<H2>NAME</H2>
iwspy - Get wireless statistics from specific nodes
<A NAME="lbAC">&nbsp;</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">&nbsp;</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">&nbsp;</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 &amp; 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">&nbsp;</A>
<H2>FILES</H2>
<I>/proc/net/wireless</I>
<A NAME="lbAG">&nbsp;</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">&nbsp;</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>