SEARCH
NEW RPMS
DIRECTORIES
ABOUT
FAQ
VARIOUS
BLOG
DONATE


YUM REPOSITORY

 
 

MAN page from Trustix net-snmp-5.4-2tr.i586.rpm

SNMPTRAPD

Section: Net-SNMP (8)
Updated: 15 Jan 2004
Index 

NAME

snmptrapd - Receive and log SNMP trap messages. 

SYNOPSIS

snmptrapd [OPTIONS] [LISTENING ADDRESSES] 

DESCRIPTION

snmptrapdis an SNMP application that receives and logs SNMP TRAP and INFORMmessages.

Note: the default is to listen on UDP port 162 on all IPv4 interfaces.Since 162 is a privileged port,snmptrapdmust typically be run as root. 

OPTIONS

-a
Ignore authenticationFailure traps.
-A
Append to the log file rather than truncating it.
-c FILE
Read FILEas 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 givenTOKEN(s).TryALLfor 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 in the stringFORMAT.See the sectionFORMAT SPECIFICATIONSbelow for more details.
-h, --help
Display a brief usage message and then exit.
-H
Display a list of configuration file directives understood by thetrap daemon and then exit.
-I [-]INITLIST
Specifies which modules should (or should not) be initializedwhen snmptrapd starts up. If the comma-separatedINITLISTis precededwith a '-', it is the list of modules that should not be started.notwant to be started. Otherwise,INITLISTOtherwise 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 thisapplication. 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 intohostnames.
-p FILE
Save the process ID of the trap daemon inFILE.
-O [abeEfnqQsStTuUvxX]
Specifies how MIB objects and other output should be displayed.See the sectionOUTPUT OPTIONSin thesnmpcmd(1)manual page for details.
-t
Do not log traps to syslog. This disables logging to syslog. This isuseful if you want the snmptrapd application toonlyrun 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 thesnmptrapd.conffile and sets its value to "value". Overrides the corresponding token in thesnmptrapd.conffile. Seesnmptrapd.conf(5)for the full list of tokens.
 

FORMAT SPECIFICATIONS

snmptrapdinterprets format strings similarly toprintf(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 ofthe PDU, if available, otherwise the contents of the agent-addr fieldof the PDU (v1 TRAPs only).
%b
PDU source address (Note: this is not necessarily an IPv4address)
%B
PDU source hostname if available, otherwise PDU source address (seenote 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)
%t
decimal number of seconds since the operating system epoch (asreturned bytime(2))
%T
the value of the sysUpTime.0 varbind in seconds
%v
list of variable-bindings from the notification payload.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 ofcharacters, 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 fieldwidth 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 various formatstring 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

snmptrapd -P -F "%#02.2h:%#02.2j TRAP%w.%q from %A\n"
 

LISTENING ADDRESSES

By default,snmptrapdlistens for incoming SNMP TRAP and INFORM packets on UDP port 162 onall IPv4 interfaces. However, it is possible to modify this behaviourby specifying one or more listening addresses as arguments tosnmptrapd.See thesnmpd(8)manual page for more information about the format of listeningaddresses. 

NOTIFICATION-LOG-MIB SUPPORT

As of net-snmp 5.0, the snmptrapd application supports theNOTIFICATION-LOG-MIB. It does this by opening an AgentX subagentconnection to the master snmpd agent and registering the notificationlog tables. As long as the snmpd application is started first, itwill attach itself to it and thus you should be able to view the lastrecorded notifications via the nlmLogTable and nlmLogVariableTable.See the snmptrapd.conf file and the "dontRetainLogs" token for turningoff this support. See the NOTIFICATION-LOG-MIB for more details aboutthe MIB itself. 

EXTENSIBILITY AND CONFIGURATION

See thesnmptrapd.conf(5)manual page. 

SEE ALSO

snmpcmd(1), snmpd(8), printf(3), snmptrapd.conf(5), syslog(8), variables(5)


 

Index

NAME
SYNOPSIS
DESCRIPTION
OPTIONS
FORMAT SPECIFICATIONS
Examples:
LISTENING ADDRESSES
NOTIFICATION-LOG-MIB SUPPORT
EXTENSIBILITY AND CONFIGURATION
SEE ALSO

This document was created byman2html,using the manual pages.