Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

snmptrapd.conf(4) [sunos man page]

snmptrapd.conf(4)						   File Formats 						 snmptrapd.conf(4)

NAME

       snmptrapd.conf - configuration file for the Net-SNMP trap daemon

SYNOPSIS

       snmptrapd.conf

DESCRIPTION

       The  snmptrapd.conf  file  is  the  configuration file that defines how the Net-SNMP trap-receiving daemon (snmptrapd(1M)) operates when it
       receives a trap. These files can contain any of the directives found in the Directives section, below. This file is not	required  for  the
       daemon to operate, receive, or report traps. It is used solely as a method of providing extensibility to the trap daemon.

       There can be multiple snmptrapd.conf files on a single machine.

       Before  creating  or  modifying	a snmptrapd.conf file, read snmp_config(4). This page describes how the Net-SNMP configuration files work,
       individually and together, and where they are located.

   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 the default
	   one instead. The program is fed details about the trap to its standard input, in the following format, one entry per line:

	   hostname

	       The name of the host that sent the trap, as determined by gethostbyaddr(3NSL).

	   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,  delimited  by  a
	       space,  is  the	OID.  The remainder of the line is its value. The first OID should be system.sysUpTime.0. The second should be the
	       ...snmpTrap.snmpTrapOID.0 OID. The remaining OIDs, with 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.snmpTrapEnterprise OID and its value. Essentially,
	       SNMPv1 traps have been converted to the SNMPv2 trap PDU type by the method described in the SNMPv1/SNMPv2/SNMPv3 coexistence  docu-
	       ment (RFC 2576).

       dontRetainLogs true

	   Turns  off the support for the NOTIFICATION-LOG-MIB and thus does not retain logged traps. Normally, the snmptrapd program keeps a cer-
	   tain number of traps in memory so that they	can  be  retrieved  by	querying  the  nlmLogTable  and  nlmLogvariableTable  tables.  See
	   snmptrapd(1M) and the NOTIFICATION-LOG-MIB for details.

       createUser username (MD5|SHA) authpassphrase [DES]

	   See snmpd.conf(4) for a description of how to create SNMPv3 users. The process of creating users is similar to creating users for other
	   SNMP versions. For SNMPv3, the configuration file name changes to snmptrapd.conf from snmpd.conf.

       format1 format

	   The format used to print a SNMPv1 TRAP message. See snmptrapd(1M) 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.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |External			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       snmptrapd(1M), syslog(3C), snmpd.conf(4), snmp_variables(4), snmp_config(4), attributes(5), sma_snmp(5)

NOTES

       In the current release, the daemon blocks on the executing traphandle commands. This behavior is subject to change in a future release.

SunOS 5.10							    16 Jan 2004 						 snmptrapd.conf(4)

Check Out this Related Man Page

SNMPTRAPD.CONF(5)						     Net-SNMP							 SNMPTRAPD.CONF(5)

NAME

       /usr/share/snmp/snmptrapd.conf - configuration file for the Net-SNMP trap daemon.

DESCRIPTION

       snmptrapd.conf  is  the	configuration  file(s)	which define how the Net-SNMP SNMP trap receiving daemon 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 daemon to  operate,
       receive, or report traps.  It is used solely as a method of providing extensibility to the trap daemon.

PLEASE READ FIRST

       First,  make  sure you have read the snmp_config(5) manual page that describes how the Net-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 following format, one entry per line:

	      HOSTNAME
		     The name of the host in question that sent the trap, as determined by gethostbyaddr(3).

	      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 ...snmpTrap.snmpTrapOID.0 OID.  The remainder of the OIDs, with 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.snmpTrapEnterprise OID and its value.	Essentially, SNMPv1 traps have been converted to the SNMPv2 trap PDU  type
		     by the method described in the SNMPv1/SNMPv2/SNMPv3 coexistence document (RFC2576).

	      Example:
		     A traptoemail script has been included in the Net-SNMP package that can be used as a trap handle directive:

		     traphandle /usr/bin/perl /usr/bin/traptoemail -s mysmtp.somewhere.com -f admin@somewhere.com me@somewhere.com

       dontRetainLogs true
	      Turns  off  the  support	for the NOTIFICATION-LOG-MIB and thus doesn't retain logged traps.  Normally the snmptrapd program keeps a
	      certain number of traps around in memory so they can be retrieved via querying the nlmLogTable and nlmLogvariableTable tables.   See
	      the snmptrapd manual page and the NOTIFICATION-LOG-MIB for details.

       createUser username (MD5|SHA) authpassphrase [DES]
	      See the snmpd.conf(5) 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 daemon blocks on the executing traphandle commands.  (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), snmpd.conf(5), read_config(3).

4th Berkeley Distribution					    28 Aug 2001 						 SNMPTRAPD.CONF(5)
Man Page