/etc/snmp/snmptrapd.conf - configuration file for the ucd-
snmp trap demon.
DESCRIPTION
snmptrapd.conf is the configuration file(s) which define
how the ucd-snmp SNMP trap receiving demon operates when
it receives a trap. These files may contain any of the
directives found in the DIRECTIVES section below. This
file is not required for the demon to operate, receive, or
report traps. It is used solely as a method of providing
extensibility to the trap demon.
PLEASE READ FIRST
First, make sure you have read the snmp_config(5) manual
page that describes how the ucd-snmp configuration files
operate, where they are located and how they all work
together.
DIRECTIVES
traphandle OID|default PROGRAM [ARGS ...]
The traphandle configuration directive configures
the snmptrapd program to launch an external program
any time it receives a trap matching the OID token.
If the OID token is the word default then any trap
not matching any other trap handler will call this
default one instead. The program is fed details
about the trap to its standard input, in the fol
lowing format, one entry per line:
HOSTNAME
The name of the host in question that sent
the trap, as determined by gethostbyaddr().
IPADDRESS
The IP address of the host that sent the
trap.
VARBINDS
A list of variable bindings that describe
the trap and the variables enclosed in it.
The first token on the line, up until the
space, in the OID and the remainder of the
line is its value. The first OID should be
the system.sysUpTime.0 OID, and the second
should be the possible exception of the last
one, are the variable bindings contained
within the trap. For SNMPv1 traps, the very
last OID will be the ...snmpTrap.snmpTrapEn
terprise OID and its value. Essentially,
SNMPv1 traps have been converted to the
SNMPv2 trap PDU type by the method described
in the SNMPv1/SNMPv2 coexistence document,
for which I forget the appropriate RFC
createUser username (MD5|SHA) authpassphrase [DES]
See the snmpd.conf manual page for a description of
how to create SNMPv3 users. It's roughly the same,
but the file name changes to snmptrapd.conf from
snmpd.conf.
format1 format
The format used to print a SNMPv1 TRAP message. See
snmptrapd(8) for the layout characters available.
format2 format
The format used to print a SNMPv2 TRAP2 or INFORM
message (note that the SNMPv3 protocol uses SNMPv2
style TRAPs and INFORMs).
NOTES
o The demon blocks on the executing traphandle com
mands. (This should be fixed in the future with an
appropriate signal catch and wait() combination).
SEE ALSO
snmp_config(5), snmptrapd(8), syslog(8), variables(5),
read_config(3).
Man(1) output converted with
man2html