NAME

na.snmp-trap - SNMP trap daemon

SYNOPSIS

na.snmp-trap -p UDP_port_number

DESCRIPTION

na.snmp-trap receives SNMP traps, translates them to SunNet Manager traps, and forwards them to the event dispatcher on one or more management stations. na.snmp-trap is usually started from inetd (1M).

OPTIONS

na.snmp-trap uses the following entries in snm.conf(5):

na.snmp.hostfile

is the name of the SNMP host file specifying system-specific schema and trap files.

na.snmp.default-schema

is the name of the default SNMP schema file. This file is used if you do not specify a system-specific schema file.

na.snmp-trap.default-trapfile

is the name of the default SNMP trap file. This file is used if you do not specify a system-specific trap file.

na.snmp-trap.rendez

are the names of one or more manager systems that should receive the traps. Separate multiple host names with a colon (:). If this entry is not found, traps will be forwarded to the local machine.

na.snmp-trap.raw

specifies whether the SNMP trap daemon returns raw OIDs and their values without translation for attributes in trap reports, in addition to the translated attribute names and values.

DESCRIPTION

When the SNMP trap daemon receives a trap, it attempts to match the IP address and the community string name in the trap with the system (or proxy) address and read community string specified by the entries in the SNMP host file. If a match is found, the system name, schema, and trap file specified by that entry are used. If no match is found, the default schema and trap file are used and the system name is set by looking up the name of the IP address in the trap. If this fails, the system name is set to the IP address in dot format.

When the trap daemon starts up, it loads the schema files specified by the keywords ``na.snmp.schemas'' and ``na.snmp.default-schema'' in the

/etc/opt/SUNWconn/snm/snm.conf file for Solaris 2.x and in the /etc/snm.conf file for Solaris 1.x. The SNMP trap daemon uses the schema file to determine the name of attributes in the trap's var-bind list and to map enumerated types to a string. If this fails, attribute names are the object identifier in dot format, and enumerated types are returned as numeric strings. If any changes are made to the schema file, you need to restart the trap daemon.

If a trap file has been specified, the SNMP trap daemon will use it to decide whether the trap should be forwarded or not. It is also used to generate the name of the trap. If no trap file has been specified or the enterprise trap entry cannot be found in the trap file, the trap is forwarded. If it is an enterprise-specific trap, its name will be ``enterprise X,'' where X is the enterprise-specific trap type number.

OPTIONS

-p UDP_port_number

UDP port number to use for na.snmp-trap daemon. Default is 162.

SEE ALSO

na.snmp.trapfile(5), na.snmp.hostfile(5), snm.conf(5)

NOTES

na.snmp-trap must not be running when inetd restarts because inetd will respond, ``address already in use.''