 |
Index for
Section 8 |
|
 |
Alphabetical
listing for S |
|
 |
Bottom of
page |
|
snmp_trapsnd(8)
NAME
snmp_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
-v version
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.
-h host
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.
-d Causes a hexadecimal dump of the encoded packet to be sent to stdout.
-tcp
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).
-p port
Specifies the port number on the destination host to which this message
is sent. The default is 162, the well-known SNMP trap port.
-c community
Specifies the community string used to send the trap. The default is
public.
OPERANDS
enterprise
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.
agent_addr
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.
generic
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.
specific
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.
timeticks
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.
variable type value
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.
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 Network
Management Protocol (SNMPv2)
|
Index for
Section 8 |
|
|
Alphabetical
listing for S |
|
 |
Top of
page |
|