snmp_trapsnd(8)snmp_trapsnd(8)NAMEsnmp_trapsnd - A program that sends SNMPv1 and SNMPv2 traps
SYNOPSIS
/usr/sbin/snmp_trapsnd enterprise agent_addr generic specific timeticks
[-v version] [-c community] [-h host] [-p port] [-tcp] [variable [type
value]]
OPTIONS
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 hexa‐
decimal dump of the encoded packet to be sent to stdout. Specifies
that the TCP transport be used instead of the UDP transport. If a con‐
nection 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.
OPERANDS
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 repre‐
sents the value of snmpTrapOID.0. For an SNMPv2 enterprise-spe‐
cific 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 iden‐
tifier. This is a non-zero number. The following table summa‐
rizes 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 informa‐
tion on specifiying SNMP MIB variables on the command line.
DESCRIPTION
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.
RESTRICTIONS
The use of this command should be limited. SNMP traps should be sent
rarely, when significant state changes occur on a managed node.
SEE ALSO
Commands: snmpd(8), snmp_request(8), snmp_traprcv(8)
RFC 1907, Management Information Base for Version 2 of the Simple Net‐
work Management Protocol (SNMPv2)
snmp_trapsnd(8)
