home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / ip / manage / snmp / cmu-snmp1.0 / man / snmptrap.1 < prev    next >
Encoding:
Text File  |  1989-09-19  |  3.8 KB  |  107 lines
  1. .\* /***********************************************************
  2. .\"     Copyright 1988, 1989 by Carnegie Mellon University
  3. .\" 
  4. .\"                       All Rights Reserved
  5. .\" 
  6. .\" Permission to use, copy, modify, and distribute this software and its 
  7. .\" documentation for any purpose and without fee is hereby granted, 
  8. .\" provided that the above copyright notice appear in all copies and that
  9. .\" both that copyright notice and this permission notice appear in 
  10. .\" supporting documentation, and that the name of CMU not be
  11. .\" used in advertising or publicity pertaining to distribution of the
  12. .\" software without specific, written prior permission.  
  13. .\" 
  14. .\" CMU DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
  15. .\" ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
  16. .\" CMU BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
  17. .\" ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
  18. .\" WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
  19. .\" ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
  20. .\" SOFTWARE.
  21. .\" ******************************************************************/
  22. .TH SNMPTRAP 1 "17 September 1989"
  23. .UC 4
  24. .SH NAME
  25. snmptrap - Send an SNMP TRAP message to a host.
  26. .SH SYNOPSIS
  27. snmptrap host community trap-type specific-type device-description [ -a agent-addr ]
  28. .SH DESCRIPTION
  29. snmptrap is an SNMP application that forms and sends an SNMP TRAP message to
  30. a host.
  31. .PP
  32. The
  33. .I host
  34. specification may be either a host name or an internet address
  35. specified in "dot notation"
  36. .PP
  37. The
  38. .I community
  39. specifies the community name for the transaction with the remote system.
  40. .PP
  41. The
  42. .I trap-type
  43. and
  44. .I specific-type
  45. are integers that specify the type of trap message being sent.
  46. .PP
  47. The
  48. .I device-description
  49. is a textual description of the device sending this trap, to be used as the value of
  50. a system.sysDescr.0 variable sent in the variable list of this trap message.
  51. The optional argument
  52. .I -a agent-addr
  53. can be used to change the address from which the trap reports it is being sent.  Otherwise
  54. the sending host's address is used.
  55. .PP
  56. For example
  57. .PP
  58. .I snmptrap nic.andrew.cmu.edu public 0 0
  59. .I 'SUN 3/60: SUNOS4.0'
  60. .PP
  61. will send a Cold Start trap to the specified machine.
  62. .PP
  63. The defined trap types are:
  64. .TP
  65. .B 0
  66. coldStart \- signifies that the sending protocol entity is
  67. reinitializing itself such that the agent's configuration or the
  68. protocol entity implementation may be altered.
  69. .TP
  70. .B 1
  71. warmStart \- signifies that the sending protocol entity is
  72. reinitializing itself such that neither the agent configuration nor
  73. the protocol entity implementation is altered.
  74. .TP
  75. .B 2
  76. linkDown \- signifies that the sending protocol entity
  77. recognizes a failure in one of the communication links represented in
  78. the agent's configuration.
  79. .TP
  80. .B 3
  81. linkUp \- signifies that the sending protocol entity
  82. recognizes that one of the communication links represented in the
  83. agent's configuration has come up.
  84. .TP
  85. .B 4
  86. authenticationFailure \- signifies that the sending protocol
  87. entity is the addressee of a protocol message that is not properly
  88. authenticated.  While implementations of the SNMP must be capable of
  89. generating this trap, they must also be capable of suppressing the
  90. emission of such traps via an implementation-specific mechanism.
  91. .TP
  92. .B 5
  93. egpNeighborLoss \- signifies that an EGP neighbor for whom
  94. the sending protocol entity was an EGP peer has been marked down and
  95. the peer relationship no longer obtains.
  96. .TP
  97. .B 6
  98. enterpriseSpecific \- signifies that the sending protocol
  99. entity recognizes that some enterprise-specific event has occurred.
  100. The specific-trap field identifies the particular trap which
  101. occurred.
  102. .PP
  103. Adding a "-d" to the argument list will cause the application to dump the output packet.
  104. .PP
  105. .SH "SEE ALSO"
  106. RFC 1065, RFC 1066, RFC 1067
  107.