home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / ip / manage / snmp / mit / doc / snmptrap.tex < prev    next >
Encoding:
Text File  |  1991-05-17  |  2.2 KB  |  71 lines
  1. %
  2. %    $Header: snmptrap.tex,v 3.0 91/05/17 16:16:14 jrd Rel $
  3. %    Author: J. Davin
  4. %    Copyright 1988, 1989, Massachusetts Institute of Technology
  5. %
  6.  
  7. \newpage
  8. \subsection{The Snmptrap Command}
  9.  
  10. The snmptrap command directs an SNMP trap message
  11. at a specified remote network management application.
  12. It is coded to run in a BSD 4.3 UNIX environment.
  13.  
  14. The code for the snmptrap command illustrates the use of the
  15. Development Kit to accelerate development
  16. of network management applications as well as the
  17. use of the SNMP protocol {\it trap} operation.
  18.  
  19. Sources for the snmptrap command reside in the
  20. \verb"snmptrap" subdirectory of the Development Kit
  21. distribution hierarchy.
  22.  
  23. It is invoked with the syntax:
  24.  
  25. {\bf snmptrap} [{\bf -h} {\it remoteHost}] [{\bf -p} {\it remotePort}]
  26. [{\bf -c} {\it communityName}]
  27. {\it enterprise} {\it agent-address} {\it generic-trap} {\it specific-trap}
  28. {\it timestamp}
  29. [{\it name kind value} ] $\ldots$
  30.  
  31. If the {\bf -h} flag is present, then the program
  32. will send its trap message
  33. to the IP address specified as {\it remoteHost.}
  34.  
  35. If the {\bf -p} flag is present, then the program
  36. will send its trap message
  37. to the UDP port specified as {\it remotePort,}
  38. instead of that assigned to the ``snmp-trap'' service
  39. in the \verb"/etc/services" database.
  40.  
  41. If the {\bf -c} flag is present, then the program
  42. will generate and accept management requests
  43. associated with the community name specified as {\it communityName,}
  44. instead of using the community name ``public.''
  45.  
  46. For example, the command
  47.  
  48. snmptrap -h anyhost 1.3.6.1.4.1.42.1.1 18.26.0.115 4 0 999 1.3.6.1.2.1.1.1.0
  49. OctetString "Fred Router by Flintstones Inc"
  50.  
  51. has the effect of sending to a management application at host {\it anyhost}
  52. an SNMP trap message. The originator of the message is identified
  53. by its enterprise value, 1.3.6.1.4.1.42.1.1 and its IP address,
  54. 18.26.0.115. The message is an authenticationFailure trap, type 4.
  55. The time associated with this trap message is 999 time ticks, and
  56. a standard MIB sysDescr value has been included as additional
  57. information.
  58.  
  59. The kinds of values that are recognized as additional items
  60. in a trap message are
  61. \begin{quote}\small\begin{verbatim}
  62. Integer
  63. Counter
  64. Guage
  65. OctetString
  66. ObjectId
  67. IPAddr
  68. TimeTicks
  69. \end{verbatim}\end{quote}
  70.  
  71.