


SNMPTRAP(1)              USER COMMANDS                SNMPTRAP(1)



NAME
     snmptrap - Send an SNMP TRAP message to a host.

SYNOPSIS
     snmptrap  host  community  trap-type  specific-type  device-
     description [ -a agent-addr ]

DESCRIPTION
     snmptrap is an SNMP application that forms and sends an SNMP
     TRAP message to a host.

     The _h_o_s_t specification may be  either  a  host  name  or  an
     internet address specified in "dot notation"

     The _c_o_m_m_u_n_i_t_y specifies the community name for the  transac-
     tion with the remote system.

     The _t_r_a_p-_t_y_p_e and _s_p_e_c_i_f_i_c-_t_y_p_e are  integers  that  specify
     the type of trap message being sent.

     The _d_e_v_i_c_e-_d_e_s_c_r_i_p_t_i_o_n is a textual description of the  dev-
     ice  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 _a_g_e_n_t-_a_d_d_r 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

     _s_n_m_p_t_r_a_p _n_i_c._a_n_d_r_e_w._c_m_u._e_d_u _p_u_b_l_i_c _0 _0 '_S_U_N _3/_6_0: _S_U_N_O_S_4._0'

     will send a Cold Start trap to the specified machine.

     The defined trap types are:

     0    coldStart - signifies that the sending protocol  entity
          is  reinitializing  itself such that the agent's confi-
          guration or the protocol entity implementation  may  be
          altered.

     1    warmStart - signifies that the sending protocol  entity
          is  reinitializing  itself  such that neither the agent
          configuration nor the protocol entity implementation is
          altered.

     2    linkDown - signifies that the sending  protocol  entity
          recognizes  a failure in one of the communication links
          represented in the agent's configuration.

     3    linkUp - signifies that  the  sending  protocol  entity
          recognizes   that   one   of  the  communication  links
          represented in the agent's configuration has come up.



Sun Release 4.1  Last change: 17 September 1989                 1






SNMPTRAP(1)              USER COMMANDS                SNMPTRAP(1)



     4    authenticationFailure - signifies that the sending pro-
          tocol  entity  is  the  addressee of a protocol message
          that is not properly authenticated.  While  implementa-
          tions  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.

     5    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.

     6    enterpriseSpecific - signifies that the sending  proto-
          col  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  applica-
     tion to dump the output packet.

SEE ALSO
     RFC 1065, RFC 1066, RFC 1067
































Sun Release 4.1  Last change: 17 September 1989                 2



