Table of Contents
snmptrap - Send an SNMP TRAP message to a host.
snmptrap
host community trap-type specific-type device-description [ -a agent-addr ]
snmptrap is an SNMP application that forms and sends an SNMP
TRAP message to a host.
The host specification may be either a host name
or an internet address specified in "dot notation"
The community specifies
the community name for the transaction with the remote system.
The trap-type
and specific-type are integers that specify the type of trap message being
sent.
The device-description is a textual description of the device sending
this trap, to be used as the value of a system.sysDescr.0 variable sent
in the variable list of this trap message. The optional argument -a agent-addr
can be used to change the address from which the trap reports it is being
sent. Otherwise the sending host's address is used.
For example
snmptrap
nic.andrew.cmu.edu public 0 0 'SUN 3/60: SUNOS4.0'
will send a Cold Start trap
to the specified machine.
The defined trap types are:
- coldStart - signifies
that the sending protocol entity is reinitializing itself such that the
agent's configuration or the protocol entity implementation may be altered.
- warmStart - signifies that the sending protocol entity is reinitializing
itself such that neither the agent configuration nor the protocol entity
implementation is altered.
- linkDown - signifies that the sending protocol
entity recognizes a failure in one of the communication links represented
in the agent's configuration.
- linkUp - signifies that the sending protocol
entity recognizes that one of the communication links represented in the
agent's configuration has come up.
- authenticationFailure - signifies that
the sending protocol entity is the addressee of a protocol message that
is not properly authenticated. While implementations of the SNMP must
be capable of generating this trap, they must also be capable of suppressing
the emission of such traps via an implementation-specific mechanism.
- egpNeighborLoss
- signifies that an EGP neighbor for whom the sending protocol entity was
an EGP peer has been marked down and the peer relationship no longer obtains.
- enterpriseSpecific - signifies that the sending protocol entity recognizes
that some enterprise-specific event has occurred. The specific-trap field
identifies the particular trap which occurred.
Adding a "-d" to the argument
list will cause the application to dump the output packet.
RFC
1065, RFC 1066, RFC 1067
Table of Contents