.\" Jean Tourrilhes - HPL - 2002
.\" iwevent.8
.\"
.TH IWEVENT 8 "25 January 2002" "net-tools" "Linux Programmer's Manual"
.\"
.\" NAME part
.\"
.SH NAME
iwevent \- Display Wireless Events generated by drivers and setting changes
.\"
.\" SYNOPSIS part
.\"
.SH SYNOPSIS
.BI "iwevent "
.br
.\"
.\" DESCRIPTION part
.\"
.SH DESCRIPTION
.B iwevent
display Wireless Events received through the RTNetlink socket. Each
line display the specific Wireless Event which describe what has
happened on the specified wireless interface.
.br
This command doesn't take any arguments.
.\"
.\" DISPLAY part
.\"
.SH DISPLAY
There is two classes of Wireless Events.
.PP
The first class is events related to a change of wireless settings on
the interface (typically done through
.B iwconfig
or a script calling
.BR iwconfig ).
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 "	Network ID"
.br
.I "	ESSID"
.br
.I "	Frequency"
.br
.I "	Mode"
.br
.I "	Encryption"
.br
All those events will be generated on all wireless interfaces by the
kernel wireless subsystem (but only if the driver has been converted
to the new driver API).
.PP
The second class of events are events generated by the hardware, when
something happens or a task has been finished. Those events include :
.TP
.B New Access Point/Cell address
The interface has joined a new Access Point or Ad-Hoc Cell, or lost
its association with it. This is the same MAC address that is reported
by
.BR iwconfig .
.TP
.B Scan request completed
A scanning request has been completed, results of the scan are
available (see
.BR iwlist ).
.TP
.B Tx packet dropped
A packet directed at this address has been dropped because the card
believes this node doesn't answer anymore. An early indication that
the node may have left the cell or gone out of range.
.PP
Only some of those events will be generated on some wireless
interfaces by the wireless driver, and their support depend on the
specific hardware/driver combination.
.\"
.\" AUTHOR part
.\"
.SH AUTHOR
Jean Tourrilhes \- jt@hpl.hp.com
.\"
.\" SEE ALSO part
.\"
.SH SEE ALSO
.BR iwconfig (8),
.BR ifconfig (8),
.BR iwspy (8),
.BR iwpriv (8).