home *** CD-ROM | disk | FTP | other *** search
/ InfoMagic Internet Tools 1993 July / Internet Tools.iso / RockRidge / ip / manage / snmp / cmu-snmp1.0 / README < prev    next >
Encoding:
Text File  |  1989-09-20  |  4.4 KB  |  90 lines
  1.  
  2.   The files in this directory compromise the 1.0 release of the CMU SNMP
  3. distribution.  This includes the SNMP/ASN.1 library, many client
  4. applications, and supporting documentation.  The snmp agent for the Kinetics
  5. box is included in this distribution, but the KIP code it links against is not
  6. yet distributable (this is not the released KIP code).  This will probably
  7. be distributed at another time if there is sufficient demand.
  8.  
  9. This code was written with efficiency and portability in mind.  The
  10. applications compile and run on the following systems: IBM PC/RT running ACIS
  11. Release 3, Sun3/60 running SUNOS 3.5, DEC microVax running Ultrix 2.2, and
  12. DECStation 3100's runing Ultrix 3.0.  They are expected to run on any system
  13. with a Berkeley socket interface.
  14.  
  15. The agent compiles into about 10 KB of 68000 code.  The machine independent
  16. portions of this agent also run on CMU's IBM PC/AT based router.
  17.  
  18. The applications are designed to be useful in the real world.  Snmpnetstat
  19. is a port of the Berkeley Unix netstat that gathers it's information using
  20. SNMP.  (Many people will enjoy "snmpnetstat mygateway public -r").  Snmpstatus
  21. collects several pieces of information and presents them in a useful format
  22. and is good for everyday status monitoring.  The rest of the tools are simpler,
  23. but still interpret input and output symbolicly (they can be used without
  24. referencing the RFC's!).
  25.  
  26. For instance, 
  27. snmpnetstat mygateway public -r returns:
  28. Routing tables
  29. Destination      Gateway            Flags   Interface
  30. bbn-net-temp     psc-gw3.psc.edu    UG      Ethernet0
  31. arpanet          prpnet-gw.cc.cmu.e UG      Ethernet0
  32. xerox-net        psc-gw3.psc.edu    UG      Ethernet0
  33. hp-internet      psc-gw3.psc.edu    UG      Ethernet0
  34. ...
  35.  
  36. snmpstatus returns:
  37. [128.2.56.220]=>[Kinetics Fastpath2] Up: 1 day, 4:43:31
  38. Recv/Trans packets - Interface: 262874/39867 | IP 47432/34587
  39.  
  40. The rest of the applications typically present a variable in a form similar
  41. to the following:
  42. Name: interfaces.ifTable.ifEntry.ifType.1
  43. INTEGER: ethernet-csmacd(6)
  44.  
  45. The parsing and printing of symbolic object identifiers and the printing of
  46. typed variables is driven by a database that describes the MIB.
  47. The MIB database is now retrieved from a text file in the ASN.1 format used in
  48. the RFC1066 MIB.  This makes adding new (enterprise specific) mibs to the database
  49. very simple.  I will solicit description files from other SNMP vendors and redistribute
  50. them via anonymous FTP.  Initially, the mib.txt file contains a discription of the
  51. RFC 1066 MIB and portions of the CMU enterprise specific MIB.  I had help in optimizing
  52. the parser from Phil Lapsley of Berkeley (Thanks Phil!).
  53.  
  54. For further information, please consult the man pages.  There are man pages for
  55. each of the applications, as well as for the Application Programming Interface (API).
  56.  
  57. The API has been redesigned to present a very convenient and useful asynchronous
  58. interface to the SNMP transport.  In addition, snmp_client.c contains a toolkit
  59. of routines that simplify writing client applications.  In particular, there is
  60. a synchronous interface built on top of the asyncronous interface that makes
  61. writing applications very easy.
  62.  
  63. This distribution is coprighted by CMU, but may be used and sold without
  64. permission.  The snmpnetstat application is derived from the Berkeley 4.3 netstat,
  65. and is therefore also copyrighted by Berkeley.  Consult the copyright notices for
  66. further information.
  67.  
  68. The distribution is available by anonymous FTP from the host
  69. lancaster.andrew.cmu.edu (128.2.13.21) as the file pub/cmu-snmp1.0.tar.  I will
  70. maintain a repository of mib description files in the directory pub/mibs.
  71.  
  72. Please direct questions, comments, and bug reports to sw0l+snmp@andrew.cmu.edu.
  73. I have received very helpful feedback in the past that has been integrated into 
  74. the current release.  This wil continue in the future.
  75.  
  76. If you pick up this package, please send me a note to the above address, so
  77. that I may notify you of future enhancements/changes and additions to the
  78. set of applications (several are planned).  I will also redistribute applications
  79. using the CMU SNMP library that were written elsewhere and placed in the public domain.
  80. There are already several such applications pending such a distribution.
  81.  
  82. There is a gateway at CMU running the agent.  Feel free to query it.  You
  83. can access as netdev-kbox.cc.cmu.edu (128.2.56.220) with community name
  84. "public".
  85.  
  86.  
  87. Steve Waldbusser
  88. Network Development
  89. Carnegie-Mellon University
  90.