Net-SNMP SNMPTRAPD(8)
NAME
snmptrapd - Receive and log SNMP trap messages.
SYNOPSIS
snmptrapd [OPTIONS] [LISTENING ADDRESSES]
DESCRIPTION
snmptrapd is an SNMP application that receives and logs SNMP
TRAP and INFORM messages. Note: the default is to listen on UDP port 162 on all IPv4interfaces. Since 162 is a privileged port, snmptrapd must
typically be run as root. OPTIONS-a Ignore authenticationFailure traps.
-A Append to the log file rather than truncating it.
-c FILE Read FILE as a configuration file.
-C Do not read any configuration files except the one
optionally specified by the -c option.
-d Dump (in hexadecimal) the sent and received SNMP
packets.-D TOKEN[,...]
Turn on debugging output for the given TOKEN(s). Try ALL for extremely verbose output.-e Print event numbers (rising/falling alarm etc.) from
the (obsolete) M2M-MIB.
This functionality is being deprecated and will be removed in due course.-f Do not fork() from the calling shell.
-F FORMAT
When logging to standard output, use the format inthe string FORMAT. See the section FORMAT SPECIFI-
CATIONS below for more details.-h, --help
Display a brief usage message and then exit.-H Display a list of configuration file directives
understood by the trap daemon and then exit.-I [-]INITLIST
Specifies which modules should (or should not) beinitialized when snmptrapd starts up. If the
V5.4.1 Last change: 15 Jan 2004 1Net-SNMP SNMPTRAPD(8)
comma-separated INITLIST is preceded with a '-', it
is the list of modules that should not be started. Otherwise this is the list of the only modules that should be started.To get a list of compiled modules, run snmptrapd
with the arguments -Dmib_init -H (assuming debugging
support has been compiled in).-L[efos]
Specify where logging output should be directed (standard error or output, to a file or via syslog). See LOGGING OPTIONS in snmpcmd(1) for details.-m MIBLIST
Specifies a colon separated list of MIB modules to load for this application. This overrides the environment variable MIBS. See snmpcmd(1) for details.-M DIRLIST
Specifies a colon separated list of directories to search for MIBs. This overrides the environment variable MIBDIRS. See snmpcmd(1) for details.-n Do not attempt to translate source addresses of
incoming packets into hostnames.-p FILE Save the process ID of the trap daemon in FILE.
-O [abeEfnqQsStTuUvxX]
Specifies how MIB objects and other output should bedisplayed. See the section OUTPUT OPTIONS in the
snmpcmd(1) manual page for details.-t Do not log traps to syslog. This disables logging
to syslog. This is useful if you want the snmptrapd
application to only run traphandle hooks and not to log any traps to any location.-v, --version
Print version information for the trap daemon and then exit.-x ADDRESS
Connect to the AgentX master agent on the specified address, rather than the default "/var/agentx/master". See snmpd(8) for details of the format of such addresses.--name=value
Allows to specify any token ("name") supported in V5.4.1 Last change: 15 Jan 2004 2Net-SNMP SNMPTRAPD(8)
the snmptrapd.conf file and sets its value to
"value". Overrides the corresponding token in thesnmptrapd.conf file. See snmptrapd.conf(5) for the
full list of tokens. FORMAT SPECIFICATIONSsnmptrapd interprets format strings similarly to printf(3).
It understands the following formatting sequences:%% a literal %
%a the contents of the agent-addr field of the PDU (v1
TRAPs only)%A the hostname corresponding to the contents of the
agent-addr field of the PDU, if available, otherwise
the contents of the agent-addr field of the PDU (v1
TRAPs only).%b PDU source address (Note: this is not necessarily an
IPv4 address)%B PDU source hostname if available, otherwise PDU
source address (see note above)%h current hour on the local system
%H the hour field from the sysUpTime.0 varbind
%j current minute on the local system
%J the minute field from the sysUpTime.0 varbind
%k current second on the local system
%K the seconds field from the sysUpTime.0 varbind
%l current day of month on the local system
%L the day of month field from the sysUpTime.0 varbind
%m current (numeric) month on the local system
%M the numeric month field from the sysUpTime.0 varbind
%N enterprise string
%q trap sub-type (numeric, in decimal)
%P security information from the PDU (community name
for v1/v2c, user and context for v3) V5.4.1 Last change: 15 Jan 2004 3Net-SNMP SNMPTRAPD(8)
%t decimal number of seconds since the operating system
epoch (as returned by time(2))%T the value of the sysUpTime.0 varbind in seconds
%v list of variable-bindings from the notification pay-
load. These will be separated by a tab, or by a comma and a blank if the alternate form is requestedSee also %V
%V specifies the variable-bindings separator. This
takes a sequence of characters, up to the next % (to
embed a % in the string, use \%)
%w trap type (numeric, in decimal)
%W trap description
%y current year on the local system
%Y the year field from the sysUpTime.0 varbind
In addition to these values, an optional field width and precision may also be specified , just as in printf(3), and a flag value. The following flags are supported:- left justify
0 use leading zeros# use alternate form
The "use alternate form" flag changes the behavior of vari-
ous format string sequences: Time information will be displayed based on GMT (rather than the local timezone)The variable-bindings will be a comma-separated list
(rather than a tab-separated one)
The system uptime will be broken down into a human-
meaningful format (rather than being a simple integer) Examples: To get a message like "14:03 TRAP3.1 from humpty.ucd.edu" you could use something like this:snmptrapd -P -F "%02.2h:%02.2j TRAP%w.%q from %A\n"
If you want the same thing but in GMT rather than local time, use V5.4.1 Last change: 15 Jan 2004 4Net-SNMP SNMPTRAPD(8)
snmptrapd -P -F "%#02.2h:%#02.2j TRAP%w.%q from %A\n"
LISTENING ADDRESSESBy default, snmptrapd listens for incoming SNMP TRAP and
INFORM packets on UDP port 162 on all IPv4 interfaces. How-
ever, it is possible to modify this behaviour by specifyingone or more listening addresses as arguments to snmptrapd.
See the snmpd(8) manual page for more information about the format of listening addresses.NOTIFICATION-LOG-MIB SUPPORT
As of net-snmp 5.0, the snmptrapd application supports the
NOTIFICATION-LOG-MIB. It does this by opening an AgentX
subagent connection to the master snmpd agent and register-
ing the notification log tables. As long as the snmpd application is started first, it will attach itself to itand thus you should be able to view the last recorded notif-
ications via the nlmLogTable and nlmLogVariableTable. Seethe snmptrapd.conf file and the "dontRetainLogs" token for
turning off this support. See the NOTIFICATION-LOG-MIB for
more details about the MIB itself. EXTENSIBILITY AND CONFIGURATIONSee the snmptrapd.conf(5) manual page.
SEE ALSO
snmpcmd(1), snmpd(8), printf(3), snmptrapd.conf(5), sys-
log(8), variables(5)ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:_______________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|____________________|__________________________________|_
| Availability | system/management/snmp/net-snmp|
|____________________|__________________________________|_
| Interface Stability| Volatile ||____________________|_________________________________|
NOTESSource for net-snmp is available on http://opensolaris.org.
V5.4.1 Last change: 15 Jan 2004 5