
	This is an ELF binary release of CMU's snmp version 2.1.2l3 intended
primarily for those wishing to develop SNMP-using software. Just verify the
makefile and then use it to install all files in their proper places

	All of the included files are Copyright (C) 1988-1992 Carnegie
Mellon University. Any errors or mistakes in this release are probably my
fault. E-Mail me at Stimpson@Panix.COM.

	Example source is in the "examples" subdirectory.

	The information below is from the README.linux file included with
the Linux source release and is written by those who ported the CMU package
to Linux, Juergen Schoenwaelder (schoenw@ibr.cs.tu-bs.de) and Erik
Schoenfelder (schoenfr@ibr.cs.tu-bs.de).

----------------------------------------------------------------------------

The original cmu code (cmu-snmp2.1.2.tar.Z) is hopefully avail at your
nearest, well assorted ftp-server.

The source changes belongs mostly to the agent/*.[ch] files for the snmpd
agent and snmplib/snmp.c for the snmpd.conf reading.  The linux version of
snmpd uses mainly the /proc/* files, /etc/mtab and some ioctl's for the
interface parameters.

Setting the writeable system group variables now works (the values are
saved in the snmpd.conf file) and the `private' community string for
V1 is now configurable via the config file (other communities than
`public' and the private community string are now disabled). The
host-mib (RFC 1514) is partially added. To be on the secure side,
hostSWRun{Perf} requests are only answered for V1 ``private''requests,
and the configured V2 views.

Files installed for the applications:

	/usr/bin/snmpwalk		/usr/bin/snmptest
	/usr/bin/snmptranslate		/usr/bin/snmpget
	/usr/bin/snmptrapd		/usr/bin/snmpnetstat
	/usr/bin/mib.txt
	/etc/{snmpd,acl,context,party,view}.conf   (if not already installed)
	/usr/man/man1/snmpwalk.1	/usr/man/man1/snmptest.1
	/usr/man/man1/snmptranslate.1	/usr/man/man1/snmpset.1
	/usr/man/man1/snmpget.1		/usr/man/man1/snmpnetstat.1
	/usr/man/man5/variables.5	/usr/man/man8/snmptrapd.8


STARTUP AT BOOTTIME:

To run ``snmpd'' at boottime add a line to /etc/rc.local containing:

	/usr/sbin/snmpd >/dev/null 2>&1 &

You may test it with ``snmpwalk -v 1 localhost public'' or choose
tkined's SNMP Trouble-Shooter or SNMP-Browser to contact the agent.

Please have a look at the original README file too and for the
copyright refer to agent/snmpd.c.

If you are running a CD-based Linux-system (/usr/lib mounted readonly
from CD), you may copy mib.txt to /etc and it will be used instead.



NEWS:
	* cmu-snmp2.1.2l3 wrapped.
	* ipNetToMediaType now should distinguish between static, dynamic 
	  and other arp entries, instead of telling always dynamic.
        * V2 communication with MD5 authentication seems to work fine.
	* man/{snmpset.1,snmpget.1,snmpnetstat.1,snmptrapd.8} and
	  apps/snmpset.c added from cmu-snmp2.1.2.1.tar.gz, which was
	  created/modified by dpz@noc.rutgers.edu, 15 July 1994 for 
	  SunOS 5.x.
	* snmpnetstat failed due to a uninitialized variable, when 
	  running the optimized version; fixed.
	* at least gcc v2.6.2 miscompiles snmplib/snmp_acl.c with
	  optimisation switched on; harmless workaround added.
	* hrSWRun[Perf] restricted to V1 ``private'' requests.
	* from the host resources mib (rfc1514) the hrSystem group 
	  and parts of hrStorage, hrDevice, hrSWRun and hrSWRunPerf 
	  are added.
	* sysName, sysContact, sysLocation are now setable,
	  and remembered in /etc/snmpd.conf (if present); the real
	  hostname is not changed.
	* system.sysUpTime now returns the ticks up the uptime of the
	  agent, not the system (host.hrSystem.hrSystemUptime tells this).
	* Interface_Scan_By_Index() in agent/snmp_vars.c tries to
	  optimize identical consecutive requests; timeout added,
	  because identical answers after long intervals are simplely
	  wrong.
	* cmu-snmp2.1.2l2 wrapped.
	* MIB-II snmp group added (nearly complete).
	* ipNetToMedia added; udpEntry added.
	* ifSpecific added; ipRouteMask added (ipRouteInfo prepared).
	* /etc/snmpd.conf added - this means setable Location and Contact.
	* cmu-snmp2.1.2l1 wrapped.

BUGS and TODO:
	* snmpwalk into the party mib shows objectid's with reversed
	  ip-adresses.
	* add nfs-mounted volumes to hrFSRemoteMountPoint.
	* setting of routing entries run in an encoding error. haven't 
	  tracked this down yet; the code is a mess... patches are
	  welcome.
	* speedup: the complete reading of the ifnet is very expensive.
	* byte-order: the code was written for network-byte-order;
 	  i guess there are some missing conversions in the applications.
	* still for harware-adresses only ethernet is assumed.
        * manpages/docs: aeh, umm - beam me up.

Have fun.

Juergen Schoenwaelder (schoenw@ibr.cs.tu-bs.de)
Erik Schoenfelder (schoenfr@ibr.cs.tu-bs.de)
