		      ucd-snmp Version: 4.1.1
DISCLAIMER

  The Authors, the University of California, and the University of
  California at Davis assume no responsibility for damage or loss of
  system performance as a direct or indirect result of the use of this
  software.  This software is provided "as is" without express or
  implied warranty.

TABLE OF CONTENTS

  Disclaimer
  Table Of Contents
  Introduction
* Supported Architectures
  Availability
  Web Page
* Installation
  Copying And Copyrights
* Frequently Asked Questions
  Helping Out
* Code Update Announcements
* Mailing Lists
  Agent Extensibility
  Example Agent Configuration and Usage
  Configuration
  Submitting Bug Reports
  Closing
  Thanks

  * = Required Reading.

INTRODUCTION

  This package was originally based on the CMU 2.1.2.1 snmp code.  It
  has been greatly modified, restructured, enhanced and fixed.  It
  hardly looks the same as anything that CMU has ever released.

SUPPORTED ARCHITECTURES

  Please see the FAQ for this information.

  Please let us know if you compile it on other OS versions and it
  works for you so we can add them to the above list.

  Porting:  Please! read the PORTING file.

AVAILABILITY

  ftp://ucd-snmp.ucdavis.edu:/ucd-snmp.tar.gz
  ftp://ucd-snmp.ucdavis.edu:/ucd-snmp.README

  Mirrors:

  Switzerland: ftp://sunsite.cnlab-switch.ch:/mirror/ucd-snmp
  Japan:       ftp://ftp.win.ne.jp/pub/network/snmp/ucd-snmp
  Russia:      ftp://ftp.chg.ru/pub/networking/management/snmp/ucd-snmp
  Australia:   ftp://mirror.aarnet.edu.au/pub/ucd-snmp/

WEB PAGE

  http://ucd-snmp.ucdavis.edu.

  Make sure you check out the logo there, which is created using
  postcards submitted from various locations that make use of the
  ucd-snmp package.

  If you wish to contribute a postcard to the logo (which makes Wes
  happy) (and his co-workers for that matter), send them to:

     Wes Hardaker
     IT-DCAS
     UCDavis
     Davis CA  95616

INSTALLATION

  See the INSTALL file distributed with this package.

COPYING AND COPYRIGHTS

  See the COPYING file distributed with this package.

FREQUENTLY ASKED QUESTIONS

  See the FAQ file distributed with this package.

HELPING OUT

  This is a project worked on by people around the net.  We'd love
  your help, but please read the PORTING file first.  Also, subscribe
  to the ucd-snmp-coders list described below and mention what you're
  going to work on to make sure no one else is already doing so!
  You'll also need to keep up to date with the latest code snap shot,
  which can be obtained from CVS using the information found at
  http://ucd-snmp.ucdavis.edu/developer.html.

CODE UPDATE ANNOUNCEMENTS

  See the NEWS file and the ChangeLog file for details on what has
  changed between releases.

  We hate broadcasting announce messages to other mailing lists and
  newsgroups, so there is a mailing list set up to handle release
  announcements.  Any time we put new software out for ftp, we'll mail
  this fact to ucd-snmp-announce@ucd-snmp.ucdavis.edu.  See the
  MAILING LISTS section described below to sign up for these
  announcements.

  We will post new announcements on a very infrequent basis to the
  other channels (the other snmp mailing lists and newsgroups like
  comp.protocols.snmp), but only for major code revisions and not for
  bug-fix patches or small feature upgrades.

MAILING LISTS

  The lists:

    The following mailing lists have been created for your use:

      ucd-snmp-announce@ucd-snmp.ucdavis.edu  -- For announcements
         Subscribe to ucd-snmp-announce-request@ucd-snmp.ucdavis.edu

      ucd-snmp@ucd-snmp.ucdavis.edu           -- For usage discussions
         Subscribe to ucd-snmp-request@ucd-snmp.ucdavis.edu

      ucd-snmp-coders@ucd-snmp.ucdavis.edu    -- For development discussions
         Subscribe to ucd-snmp-coders-request@ucd-snmp.ucdavis.edu

      ucd-snmp-cvs@ucd-snmp.ucdavis.edu       -- For cvs update announcements
         Subscribe to ucd-snmp-cvs-request@ucd-snmp.ucdavis.edu

      ucd-snmp-bugs-mail@ucd-snmp.ucdavis.edu -- Where bug reports are sent.
         Subscribe to ucd-snmp-bugs-mail-request@ucd-snmp.ucdavis.edu

    The lists you definitely want to subscribe to is the
    ucd-snmp-announce@ucd-snmp.ucdavis.edu list and the
    ucd-snmp@ucd-snmp.ucdavis.edu list.

  Subscribing:

    To (un)subscribe any of the above lists, mail a note to the same
    address with -request appended to the list name with a subject
    line of "subscribe" or "unsubscribe".

    For example:   mailing a note to

          ucd-snmp-announce-request@ucd-snmp.ucdavis.edu

    with a subject line of "subscribe" will subscribe
    you to the announcement list.

  Archives:
    The archives for these mailing lists can be found at
    http://ucd-snmp.ucdavis.edu.

AGENT EXTENSIBILITY

  The agent that comes with this package is extensible through use of
  shell scripts and other methods.  See the configuration manual pages
  (like snmpd.conf) and the EXAMPLE.conf file for details.

  You can also extend the agent by writing C code directly.  The agent
  is extremely modular in nature and you need only create new files,
  re-run configure and re-compile.  No modification of the distributed
  source files are necessary.  See the following files for details on
  how to go about this: AGENT.txt, agent/mibgroup/examples/example.c,
  and agent/mibgroup/examples/example.h.  Also, see the local/mib2c
  program and its README file for help in turning a textual mib
  description into a C code template.

  We now support AgentX for subagent extensibility.  The ucd-snmp
  agent can run as both a master agent and a subagent.  Additionally,
  a toolkit is provided that enables users of it to easily embed a
  agentx client into external applications.  See the tutorial at
  http://ucd-snmp.ucdavis.edu/tutorial/toolkit for an example of how
  go about doing this.

CONFIGURATION

  See the man/snmp.conf.5 manual page.

  For the agent, additionally see the man/snmpd.conf.5 manual page and
  the EXAMPLE.conf file mentioned above.

  For the snmptrapd, see the man/snmptrapd.conf.5 manual page.

EXAMPLE AGENT CONFIGURATION AND USAGE

  See the 'EXAMPLE.conf' file in the top level source directory (you
  must build the package for this file to be generated).

SUBMITTING BUG REPORTS

  Important: *Please* include what version of the ucd-snmp package you
  are using and what architecture(s) you're using, as well as detailed
  information about exactly what is wrong.

  To submit a bug report, ideally, you should use
  http://ucd-snmp.ucdavis.edu/ucd-snmp-bugs to enter your
  submissions.  It is a full-fledged bug-tracking system that will
  allow you to search for already existing bug reports as well as
  track the status of your report as it is processed by the core
  developers.

  Alternatively, submit your bug report to
  ucd-snmp-bugs@ucd-snmp.ucdavis.edu.  Both paths do end up at the
  same place in the bug tracking system, but the URL submissions are a 
  bit more complete in nature.

  Patches should be sent to the above email address as well.

  If you intend to submit a patch as well, please read the PORTING
  file before you do so.  Thanks!

CLOSING

  We love patches.  Send some to us!  But before you do, please see
  the 'PORTING' file for information on helping us out with the
  process of integrating your patches (regardless of whether its a new
  feature implementation or a new port).

  Also, We're interested if anyone actually uses/likes/hates/whatever
  this package...  Mail us a note and let us know what you think of it!

  Have fun and may it make your life easier,

    Wes Hardaker
    ucd-snmp-coders@ucd-snmp.ucdavis.edu

THANKS

  The following people have contributed various patches and
  improvements.  To them we owe our deepest thanks (and you do too!):

  Original Author & Project Leader:

    Wes Hardaker <wjhardaker@ucdavis.edu>

  Major Contributors:  (in no particular order)

    Dan A. Dickey <ddickey@transition.com>
    Dave Shield <D.T.Shield@csc.liv.ac.uk>
    Giovanni S. Marzot <gmarzot@nortelnetworks.com>
    Niels Baggesen <recnba@mediator.uni-c.dk>
    Simon Leinen <simon@limmat.switch.ch>
    David T. Perkins <dperkins@dsperkins.com>
    Mike Perik <mikep@crt.com>
    Sanjai Narain <narain@thumper.bellcore.com>
    francus@metsny.delphi.com
    Gary Palmer <gpalmer@freebsd.org>
    Marc G. Fournier <scrappy@ki.net>
    Gary A. Hayward <gah@bellcore.com>
    Jennifer Bray <jbray@origin-at.co.uk>
    Philip Guenther <guenther@gac.edu>
    Elwyn B Davies <edavies@origin-at.co.uk>
    Simon Burge <simonb@telstra.com.au>
    David Paul Zimmerman <dpz@apple.com>
    Alan Batie <batie@aahz.jf.intel.com>
    Michael Douglass <mikedoug@texas.net>
    Ted Rule <Ted_Rule@FLEXTECH.CO.UK>
    Craig Bevins <craigb@bitcom.net.au>
    Arther Hyun <arthur@psi.com>
    Cristian Estan <Cristian.Estan@net.utcluj.ro>
    Eugene Polovnikov <eugen@rd.zgik.zaporizhzhe.ua>
    Jakob Ellerstedt <jakob@dynarc.se>
    Michael Slifcak <mslifcak@iss.net>
    Jonas Olsson <jolsson@erv.ericsson.se>
    James H. Young <sysjhy@gsu.edu>
    Jeff Johnson <jbj@redhat.com>
    Markku Laukkanen <marlaukk@stybba.ntc.nokia.com>
    Derek Simkowiak <dereks@kd-dev.com>
    David F. Newman <dnewman@epnet.com>
    Nick Amato <naamato@merit.edu>
    Mike Baer <baerm@calweb.com>
    Patrick Lawrence <pjlawrence@ucdavis.edu>
    Russ Mundy <mundy@tislabs.com>
    Olafur Gudmundsson <ogud@tislabs.com>
    David Reeder <dreeder@tislabs.com>
    Ed Lewis <lewis@tislabs.com>
    Bill Babson <wbabson@tislabs.com>
    Chris Smith <csmith@platform.com>
    Mike Michaud <mikemichaud@earthlink.net>
    Andy Hood <ahood@westpac.com.au>
    Robert Story <rs-snmp@revelstone.com>
    Bert Driehuis <driehuis@playbeing.org>
    Juergen Schoenwaelder <schoenw@ibr.cs.tu-bs.de>
    Frank Strauss <strauss@ibr.cs.tu-bs.de>
    Ragnar Kjrstad <ucd@ragnark.vestdata.no>
    Jochen Kmietsch <jochen.kmietsch@tu-clausthal.de>
    Jun-ichiro itojun Hagino <itojun@iijlab.net>

  We've probably forgotten people on this list.  Let us know if you've
  contributed code and we've left you out.
