Documentation/ap-trapd.8

   1 .\"      Manpage for ap-trapd utility
   2 .\"   from Wireless Access Point Utilitess for Unix
   3 .\"
   4 .\"  Copyright (c) 2002 Roman Festchook <roma at polesye dot net>
   5 .\"
   6 .\"  This program is free software; you can redistribute it and/or modify
   7 .\"  it under the terms of the GNU General Public License Version 2 from
   8 .\"  June 1991 as published by the Free Software Foundation.
   9 .\"
  10 .\"  This program is distributed in the hope that it will be useful, but
  11 .\"  WITHOUT ANY WARRANTY; without even the implied warranty of
  12 .\"  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 .\"  GNU General Public License for more details.
  14 .\"
  15 .\"  You should have received a copy of the GNU General Public License along
  16 .\"  with this program; if not, write to the Free Software Foundation, Inc.,
  17 .\"  59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
  18 .TH ap-trapd 8 "Wireless Access Point Utilites for Unix"
  19 .SH NAME
  20 ap-trapd \- a SNMP trap processing daemon
  21
  22 .SH SYNOPSIS
  23 .B ap-trapd
  24 .B [ -i
  25 .IR device
  26 .B ] [-u
  27 .IR user
  28 .B ] [-s]
  29
  30 .SH DESCRIPTION
  31 .B ap-trapd
  32 It's a SNMP trap processing daemon that accepts traps, parse them and store useful data using syslog, at logging LEVEL0.
  33 Specify
  34 .IR device
  35 to listen for SNMP traps on the particular device (this option only works at Linux). To be running by user different from
  36 nobody you may specify
  37 .IR user.
  38 .br
  39 To correct work with Smartbridges APs specify
  40 .IR -s
  41 key (they use specific traps).
  42 .br
  43 Utility added to ap-utils from version 0.8.
  44
  45 .SH SYSLOG
  46 To store traps to own log file you may add next string to your
  47 .B /etc/syslog.conf
  48 .br
  49         local0.*                /var/log/ap-traps.log
  50 .br
  51 After doing it, just restart syslogd with command like
  52 .br
  53         killall -HUP syslogd
  54
  55 .SH TRAPS
  56 When a trap is received, a message will be logged indicating that an action happened to the Access Point such as:
  57 .TP
  58 Trap Reassociation:
  59 This trap message is sent when a Station reassociation request is received from Access Point.
  60 .TP
  61 Trap Association:
  62 Indicates the reception of an association request packet and the sender Station's successful association with the Access Point.
  63 .TP
  64 Trap Disassociation:
  65 This trap message is sent when a disassociation notification packet is received from a Station.
  66 .TP
  67 Trap Reset:
  68 This trap message is sent when Access Point Resets.
  69 .TP
  70 Trap Setting IP Address with Ping:
  71 This trap message is sent when the Access Point IP address is set with the transmission of a ping message.
  72 .TP
  73 Trap Start Up:
  74 This trap message is sent when the Access Point Starts Up.
  75 .TP
  76 Trap Failed To Erase Flash:
  77 This trap message is sent when Access Point Failed To Erase Flash.
  78 .TP
  79 APClientScanning
  80 Access Point Client is scanning...
  81 .TP
  82 APClientAuthenticating
  83 Access Point Client is authenticating with the AP.
  84 .TP
  85 APClientAssociating
  86 Access Point Client is associating with the AP.
  87 .TP
  88 APClientReAssociating
  89 Access Point Client is reassociating with the AP.
  90 .TP
  91 APClientAuthenticationFailed
  92 Access Point Client has failed authenticating with the AP.
  93 .TP
  94 APClientAssociationFailed
  95 Access Point Client has failed associating with the AP.
  96 .TP
  97 APClientConnected
  98 Access Point Client has been connected with the AP.
  99 .TP
 100 APClientDisconnected
 101 Access Point Client has been disconnected from the AP.
 102 .TP
 103 APClientScanFailed
 104 Access Point Client has failed scanning!
 105 .TP
 106 APClientJoinFailed
 107 Access Point Client has failed joining!
 108 .TP
 109 APClientJoining
 110 Access Point Client is in join state.
 111
 112 .SH Smartbridges specific TRAPS
 113 .TP
 114 MultiAttachedStation
 115 Multiple attached stations in the ethernet size
 116 .TP
 117
 118
 119 .SH SECURITY
 120 Utility ap-trapd must be running by 'root', after opening port utility change owner to 'nobody', so this user must exist in you system.
 121 You may set
 122 .IR user
 123 using -u option as described below for change default unprivileged user.
 124
 125 .SH AUTHOR
 126 Roman Festchook <roma@polesye.net>
 127 .br
 128 http://ap-utils.polesye.net
 129
 130 .SH SEE ALSO
 131 ap-config(8), ap-mrtg(8), syslogd(8)
 132