1IWEVENT(8)                 Linux Programmer's Manual                IWEVENT(8)
2
3
4

NAME

6       iwevent  -  Display  Wireless  Events  generated by drivers and setting
7       changes
8

SYNOPSIS

10       iwevent
11

DESCRIPTION

13       iwevent displays Wireless Events received through the RTNetlink socket.
14       Each line displays the specific Wireless Event which describes what has
15       happened on the specified wireless interface.
16       This command doesn't take any arguments.
17

DISPLAY

19       There are two classes of Wireless Events.
20
21       The first class is events related to a change of wireless  settings  on
22       the  interface  (typically  done  through  iwconfig or a script calling
23       iwconfig).  Only settings that could result in a disruption of  connec‐
24       tivity  are reported. The events currently reported are changing one of
25       the following setting :
26            Network ID
27            ESSID
28            Frequency
29            Mode
30            Encryption
31       All those events will be generated on all wireless  interfaces  by  the
32       kernel wireless subsystem (but only if the driver has been converted to
33       the new driver API).
34
35       The second class of events are events generated by the  hardware,  when
36       something happens or a task has been finished. Those events include :
37
38       New Access Point/Cell address
39              The  interface  has joined a new Access Point or Ad-Hoc Cell, or
40              lost its association with it. This is the same address  that  is
41              reported by iwconfig.
42
43       Scan request completed
44              A  scanning  request has been completed, results of the scan are
45              available (see iwlist).
46
47       Tx packet dropped
48              A packet directed at this address has been dropped  because  the
49              interface  believes  this  node  doesn't answer anymore (usually
50              maximum of MAC level retry exceeded). This is usually  an  early
51              indication  that  the node may have left the cell or gone out of
52              range, but it may be due to fading or excessive contention.
53
54       Custom driver event
55              Event specific to the driver. Please check the driver documenta‐
56              tion.
57
58       Registered node
59              The   interface  has  successfully  registered  a  new  wireless
60              client/peer. Will be generated mostly when the interface acts as
61              an Access Point (mode Master).
62
63       Expired node
64              The  registration  of  the  client/peer  on  this  interface has
65              expired. Will be generated mostly when the interface acts as  an
66              Access Point (mode Master).
67
68       Spy threshold crossed
69              The  signal  strength  for  one of the addresses in the spy list
70              went under the low threshold or went above the high threshold.
71
72       Most wireless drivers generate only a subset of those events,  not  all
73       of  them, the exact list depends on the specific hardware/driver combi‐
74       nation. Please refer to driver documentation for details on  when  they
75       are generated, and use iwlist(8) to check what the driver supports.
76

AUTHOR

78       Jean Tourrilhes - jt@hpl.hp.com
79

SEE ALSO

81       iwconfig(8), iwlist(8), iwspy(8), iwpriv(8), wireless(7).
82
83
84
85net-tools                        23 June 2004                       IWEVENT(8)
Impressum