SNMPTRAPD.CONF(5)SNMPTRAPD.CONF(5)NAME
/usr/contrib/share/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
27 Jan 2000 1
SNMPTRAPD.CONF(5)SNMPTRAPD.CONF(5)
number.
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.
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 ALSOsnmp_config(5), snmptrapd(8), syslog(8), variables(5),
read_config(3).
27 Jan 2000 2