Perl5 SNMP Extension Module v1.8
		       for the UCD SNMP Library
		G.S. Marzot (gmarzot@baynetworks.com)

Contents:
   Introduction:
   Availability:
   Supported Platforms:
   Release Notes:
   Installation:
   Operational Description:
   Trouble Shooting:
   Acknowledments:
   History:

Introduction:

This is a Perl5 extension module which provides a full featured SNMP
client side API.  The SNMP module internals rely on the UCD SNMP
client library toolkit. The UCD SNMP library was originally based on
version 2.1.2.1 of the CMU SNMP library but has incorporated many
bugfixes and enhancements. For information on the UCD SNMP library see
the documentation provided with the UCD SNMP distribution or the
ucd-snmp project web page: http://www.ece.ucdavis.edu/ucd-snmp

(NOTE: In previous releases this module was compatible with both the
UCD and CMU SNMP libraries. Starting with Perl5/SNMP-1.7 this module
will *only* work with the UCD SNMP library due to dependence on new
features)

Availability:

The most recent release of the UCD SNMP Libray can be found at:
ftp://ftp.ece.ucdavis.edu/pub/snmp/ucd-snmp.tar.gz

The most recent release of the Perl5/SNMP module can be found at:
ftp:/ftp.wellfleet.com/netman/snmp/perl5/SNMP.tar.gz
(as well as the usual perl archives, CPAN)

Supported Platforms:
	SunOS 4.1.x
	Solaris 2.x
	Linux 1.2.x, 2.0.x
	Many other UNIX variants
	Win95/NT

Release Notes:

version 1.8 is intended to compile w/ ucd-snmp-3.5 (1.8a1 was
targetted at ucd-snmp-3.4). Compatibility with later versions of
ucd-snmp is not guaranteed due to the dynamic nature of free software
development :). As of 1.8a2, 'make test' will fail session test 9 when
tested with the ucd-snmp agent due to a bug in the agent in which
'set's to read-only attributes appear to succeed. This 'make test'
failure can be safely ignored.

Installation:

build and install ucd-snmp-3.5 

note: you should ensure that any previous ucd-snmp or cmu snmp
installation is located so that the wrong libsnmp or headers are not
used by mistake).

perl Makefile.PL
make
make test
make install

note: 'make test' requires that an agent is running to which you have
read/write access. For the ucd-snmp snmpd this may involve setting up
the snmpd.conf file with read-write access for 'private'

Operational Description:

The basic operations offered by the SNMP module are provided through
an object oriented interface for modularity and ease of use. The
primary class is SNMP::Session which encapsulates the persistent
aspects of a connection between the management application and the
managed agent. Internally the class is implemented as a blessed hash
reference. This class supplies 'get', 'getnext', 'set', 'fget', and
'fgetnext' method calls. The methods take a variety of input argument
formats and support both syncronous and asyncronous operation through
a polymorphic API (i.e., method behaviour varies dependent on args
passed - see below).

A description of the fields which can be specified when an
SNMP::Session object is created follows:

SNMP::Session
public:
 De