man pages section 1M: System Administration Commands

snmptrap(1M)

Name

snmptrap, snmpinform– send an SNMP trap to a manager

Synopsis

snmptrap -v 1 [common options] [-Ci] enterprise-oid agent generic-trap specific-trap uptime 
     [oid type value]...

snmptrap -v {2c | 3} [common options] [-Ci] uptime trap-oid 
     [oid type value]...

snmptrap -v {2c | 3} [common options] uptime trap-oid 
     [oid type value]...

Description

The snmptrap utility is an SNMP application that uses the SNMP TRAP operation to send information to a network manager. You can specify one or more object identifiers (OIDs) on the command line. A type and a value must accompany each object identifier. Each variable name must be entered in the format specified in snmp_variables(4).

When invoked as snmpinform, or when you specify the -Ci option to snmptrap, it sends an INFORM-PDU, expecting a response from the trap receiver, and retransmitting if required. Otherwise, it sends a TRAP-PDU or TRAP2-PDU.

If any of the required version 1 parameters—enterprise-oid, agent, and uptime—are specified as empty, they default to 1.3.6.1.4.1.3.1.1 (enterprises.cmu.1.1), hostname, and host-uptime respectively.

The type is a single character, one of:

i INTEGER
u UNSIGNED
c COUNTER32
s STRING
x HEX STRING
d DECIMAL STRING
n NULLOBJ
o OBJID
t TIMETICKS
a IPADDRESS
b BITS

For example, the following command sends a generic linkUp trap to manager, for interface 1:

# snmptrap -v 1 -c public manager enterprises.spider test-hub 3 0 ''
interfaces.iftable.ifentry.ifindex.1 i 1

Options

The following option is supported:

-Ci: Sends an INFORM-PDU, as described above. Applies only to snmptrap. This option provides the equivalent function of snmpinform.

In addition to this option, snmptrap takes the common options described in the snmpcmd(1M) manual page.

Exit Status

0: Successful completion.
1: A usage syntax error. A usage message is displayed.

Attributes

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWsmcmd
Interface Stability	External