snmp_trapsnd - A program that sends SNMPv1 and SNMPv2
traps
/usr/sbin/snmp_trapsnd enterprise agent_addr generic specific
timeticks [-v version] [-c community] [-h host] [-p
port] [-tcp] [variable [type value]]
Specifies the type of message in which to send the PDU.
The default version is SNMPv1. Use 2c to specify that the
PDU be sent in an SNMPv2C message. Specifies the host
name or dot-formatted IP address of the destination node
to receive the trap message. If no host is specified, the
trap is sent to the loopback interface. Causes a hexadecimal
dump of the encoded packet to be sent to stdout.
Specifies that the TCP transport be used instead of the
UDP transport. If a connection cannot be established, the
program silently sends the trap to the standard transport
address (UDP 162). Specifies the port number on the destination
host to which this message is sent. The default
is 162, the well-known SNMP trap port. Specifies the community
string used to send the trap. The default is public.
For SNMPv1 traps, this is the enterprise object identifier,
in dot string notation, on whose behalf the trap is
being sent (for example, 1.3.6.1.4.1.232).
For SNMPv2 traps (specified with the -v 2c option),
this represents the value of snmpTrapOID.0. For an
SNMPv2 enterprise-specific trap, this is typically
a concatenated string containing the enterprise
OID, 0 (zero), and a single digit. See the generic
parameter table. The hostname or IP address of the
entity on whose behalf the trap is being generated
(the agent-addr field in the V1 trap PDU). The
special name local reports the host on which this
program is running. This value is ignored if the
-v 2c option is present. The generic trap identifier.
This is a non-zero number. The following
table summarizes the trap IDs:
-----------------------------------------------------------------------
Description V1 generic Value V2 enterprise Value
-----------------------------------------------------------------------
coldStart 0 1.3.6.1.6.3.1.1.5.1
warmStart 1 1.3.6.1.6.3.1.1.5.2
linkDown 2 1.3.6.1.6.3.1.1.5.3
linkUp 3 1.3.6.1.6.3.1.1.5.4
authenticationFailure 4 1.3.6.1.6.3.1.1.5.5
egpNeighborLoss 5 1.3.6.1.6.3.1.1.5.6
enterpriseSpecific 6 enterprise.0.x
-----------------------------------------------------------------------
If the -v 2c option is present, this parameter is
ignored. Specifies the enterprise-specific trap
number. A value must be present, but is ignored if
the -v 2c option is present or if generic is a
value other than 6. Specifies the relative time
associated with the generation of this trap message.
This is the number of TIMETICKS (1/100 of a
second) since the sending SNMP entity started.
Specifies a list of MIB variables to be included in
the trap message. See snmp_request(8) for information
on specifiying SNMP MIB variables on the command
line.
The snmp_trapsnd program encodes an SNMPv1 Trap protocol
data unit (PDU) (see RFC 1215) or a SNMPv2 Trap PDU (see
RFC 1905) into an SNMP message, and sends it to the specified
host(s). All data fields in the trap PDU can be
specified in the run-time arguments.
SNMPv1 traps are uniquely identified by the combination of
enterprise, generic, and specific operands. SNMPv2 traps
are uniquely identified by the value of snmpTrapOID.0 in
the enterprise operand.
The use of this command should be limited. SNMP traps
should be sent rarely, when significant state changes
occur on a managed node.
Commands: snmpd(8), snmp_request(8), snmp_traprcv(8)
RFC 1907, Management Information Base for Version 2 of the
Simple Network Management Protocol (SNMPv2)
snmp_trapsnd(8)
[ Back ] | 