wireless_tools/iwevent.8

   1 .\" Jean Tourrilhes - HPL - 2002
   2 .\" iwevent.8
   3 .\"
   4 .TH IWEVENT 8 "25 January 2002" "net-tools" "Linux Programmer's Manual"
   5 .\"
   6 .\" NAME part
   7 .\"
   8 .SH NAME
   9 iwevent \- Display Wireless Events generated by drivers and setting changes
  10 .\"
  11 .\" SYNOPSIS part
  12 .\"
  13 .SH SYNOPSIS
  14 .BI "iwevent "
  15 .br
  16 .\"
  17 .\" DESCRIPTION part
  18 .\"
  19 .SH DESCRIPTION
  20 .B iwevent
  21 display Wireless Events received through the RTNetlink socket. Each
  22 line display the specific Wireless Event which describe what has
  23 happened on the specified wireless interface.
  24 .br
  25 This command doesn't take any arguments.
  26 .\"
  27 .\" DISPLAY part
  28 .\"
  29 .SH DISPLAY
  30 There is two classes of Wireless Events.
  31 .PP
  32 The first class is events related to a change of wireless settings on
  33 the interface (typically done through
  34 .B iwconfig
  35 or a script calling
  36 .BR iwconfig ).
  37 Only settings that could result in a disruption of connectivity are
  38 reported. The events currently reported are changing one of the
  39 following setting :
  40 .br
  41 .I "    Network ID"
  42 .br
  43 .I "    ESSID"
  44 .br
  45 .I "    Frequency"
  46 .br
  47 .I "    Mode"
  48 .br
  49 .I "    Encryption"
  50 .br
  51 All those events will be generated on all wireless interfaces by the
  52 kernel wireless subsystem (but only if the driver has been converted
  53 to the new driver API).
  54 .PP
  55 The second class of events are events generated by the hardware, when
  56 something happens or a task has been finished. Those events include :
  57 .TP
  58 .B New Access Point/Cell address
  59 The interface has joined a new Access Point or Ad-Hoc Cell, or lost
  60 its association with it. This is the same MAC address that is reported
  61 by
  62 .BR iwconfig .
  63 .TP
  64 .B Scan request completed
  65 A scanning request has been completed, results of the scan are
  66 available (see
  67 .BR iwlist ).
  68 .TP
  69 .B Tx packet dropped
  70 A packet directed at this address has been dropped because the card
  71 believes this node doesn't answer anymore. An early indication that
  72 the node may have left the cell or gone out of range.
  73 .PP
  74 Only some of those events will be generated on some wireless
  75 interfaces by the wireless driver, and their support depend on the
  76 specific hardware/driver combination.
  77 .\"
  78 .\" AUTHOR part
  79 .\"
  80 .SH AUTHOR
  81 Jean Tourrilhes \- jt@hpl.hp.com
  82 .\"
  83 .\" SEE ALSO part
  84 .\"
  85 .SH SEE ALSO
  86 .BR iwconfig (8),
  87 .BR ifconfig (8),
  88 .BR iwspy (8),
  89 .BR iwpriv (8).