185 lines
4.4 KiB
HTML
185 lines
4.4 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of IWEVENT</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>IWEVENT</H1>
|
|
Section: Linux Programmer's Manual (8)<BR>Updated: 23 June 2004<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>
|
|
|
|
iwevent - Display Wireless Events generated by drivers and setting changes
|
|
|
|
|
|
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<B>iwevent </B>
|
|
|
|
<BR>
|
|
|
|
|
|
|
|
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>iwevent</B>
|
|
|
|
displays Wireless Events received through the RTNetlink socket. Each
|
|
line displays the specific Wireless Event which describes what has
|
|
happened on the specified wireless interface.
|
|
<BR>
|
|
|
|
This command doesn't take any arguments.
|
|
|
|
|
|
|
|
<A NAME="lbAE"> </A>
|
|
<H2>DISPLAY</H2>
|
|
|
|
There are two classes of Wireless Events.
|
|
<P>
|
|
|
|
The first class is events related to a change of wireless settings on
|
|
the interface (typically done through
|
|
<B>iwconfig</B>
|
|
|
|
or a script calling
|
|
<B>iwconfig</B>).
|
|
|
|
Only settings that could result in a disruption of connectivity are
|
|
reported. The events currently reported are changing one of the
|
|
following setting :
|
|
<BR>
|
|
|
|
<I><TT> </TT>Network ID</I>
|
|
|
|
<BR>
|
|
|
|
<I><TT> </TT>ESSID</I>
|
|
|
|
<BR>
|
|
|
|
<I><TT> </TT>Frequency</I>
|
|
|
|
<BR>
|
|
|
|
<I><TT> </TT>Mode</I>
|
|
|
|
<BR>
|
|
|
|
<I><TT> </TT>Encryption</I>
|
|
|
|
<BR>
|
|
|
|
All those events will be generated on all wireless interfaces by the<BR>
|
|
kernel wireless subsystem (but only if the driver has been converted
|
|
to the new driver API).
|
|
<P>
|
|
|
|
The second class of events are events generated by the hardware, when
|
|
something happens or a task has been finished. Those events include :
|
|
<DL COMPACT>
|
|
<DT id="1"><B>New Access Point/Cell address</B>
|
|
|
|
<DD>
|
|
The interface has joined a new Access Point or Ad-Hoc Cell, or lost
|
|
its association with it. This is the same address that is reported
|
|
by
|
|
<B>iwconfig</B>.
|
|
|
|
<DT id="2"><B>Scan request completed</B>
|
|
|
|
<DD>
|
|
A scanning request has been completed, results of the scan are
|
|
available (see
|
|
<B>iwlist</B>).
|
|
|
|
<DT id="3"><B>Tx packet dropped</B>
|
|
|
|
<DD>
|
|
A packet directed at this address has been dropped because the
|
|
interface believes this node doesn't answer anymore (usually maximum
|
|
of MAC level retry exceeded). This is usually an early indication that
|
|
the node may have left the cell or gone out of range, but it may be
|
|
due to fading or excessive contention.
|
|
<DT id="4"><B>Custom driver event</B>
|
|
|
|
<DD>
|
|
Event specific to the driver. Please check the driver documentation.
|
|
<DT id="5"><B>Registered node</B>
|
|
|
|
<DD>
|
|
The interface has successfully registered a new wireless
|
|
client/peer. Will be generated mostly when the interface acts as an
|
|
Access Point (mode Master).
|
|
<DT id="6"><B>Expired node</B>
|
|
|
|
<DD>
|
|
The registration of the client/peer on this interface has
|
|
expired. Will be generated mostly when the interface acts as an Access
|
|
Point (mode Master).
|
|
<DT id="7"><B>Spy threshold crossed</B>
|
|
|
|
<DD>
|
|
The signal strength for one of the addresses in the spy list went
|
|
under the low threshold or went above the high threshold.
|
|
</DL>
|
|
<P>
|
|
|
|
Most wireless drivers generate only a subset of those events, not all
|
|
of them, the exact list depends on the specific hardware/driver
|
|
combination. Please refer to driver documentation for details on when
|
|
they are generated, and use
|
|
<I><A HREF="/cgi-bin/man/man2html?8+iwlist">iwlist</A></I>(8)
|
|
|
|
to check what the driver supports.
|
|
|
|
|
|
|
|
<A NAME="lbAF"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
Jean Tourrilhes - <A HREF="mailto:jt@hpl.hp.com">jt@hpl.hp.com</A>
|
|
|
|
|
|
|
|
<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+iwspy">iwspy</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>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="8"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="9"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="10"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="11"><A HREF="#lbAE">DISPLAY</A><DD>
|
|
<DT id="12"><A HREF="#lbAF">AUTHOR</A><DD>
|
|
<DT id="13"><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:06:13 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|