and added files
[bcm963xx.git] / userapps / opensource / net-snmp / README
diff --git a/userapps/opensource/net-snmp/README b/userapps/opensource/net-snmp/README
new file mode 100644 (file)
index 0000000..62cbe39
--- /dev/null
@@ -0,0 +1,302 @@
+              README file for net-snmp Version: 5.0.8
+
+DISCLAIMER
+
+  The Authors 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.  It
+  was renamed from cmu-snmp to ucd-snmp in 1995 and later renamed from
+  ucd-snmp to net-snmp in November 2000.
+
+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
+
+  Download:
+    - http://www.net-snmp.org/download/
+    - ftp://ftp.net-snmp.org/pub/sourceforge/net-snmp/
+  Web page:
+    - http://www.net-snmp.org/
+  Sourceforge Project page:
+    - http://www.net-snmp.org/project/
+  Mirrors:
+    - US:        ftp://ftp.freesnmp.com/mirrors/net-snmp/
+    - Bulgaria:  http://rtfm.uni-svishtov.bg/net-snmp/
+    - Japan:     ftp://ftp.ayamura.org/pub/net-snmp/
+    - Germany:   ftp://ftp.mpg.goe.ni.schule.de/pub/internet/net-snmp/
+
+  The old ucd-snmp.ucdavis.edu web site and ftp server is now
+  offline and should not be accessed any longer.
+
+WEB PAGES
+
+  http://www.net-snmp.org/
+  http://www.net-snmp.org/project/
+
+  Make sure you check out the logo there, which is created using
+  postcards submitted from various locations that make use of the
+  net-snmp package.
+
+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 net-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://www.net-snmp.org/cvs/.
+
+  Contributions to the Net-SNMP source code in any form are greatly
+  appreciated.  We expect the parties providing such contributions to
+  have the right to contribute them to the Net-SNMP project or that
+  the parties that do have the right have directed the person
+  submitting the contribution to do so.  In addition, all contributors
+  need to be aware that if the contribution is accepted and
+  incorporated into the Net-SNMP project, it will be redistributed
+  under the terms of the license agreement used for the entire body of
+  work that comprises the Net-SNMP project (see the COPYING file for
+  details).  If this license agreement ever changes the contribution
+  will continue to be released under any new licenses as well.  Thank
+  you, in advance, for your gracious contributions.
+
+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 net-snmp-announce@lists.sourceforge.net.  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:
+
+      net-snmp-announce@lists.sourceforge.net  -- For announcements
+      net-snmp-users@lists.sourceforge.net     -- For usage discussions
+      net-snmp-coders@lists.sourceforge.net    -- For development discussions
+      net-snmp-cvs@lists.sourceforge.net       -- For cvs update announcements
+
+    To subscribe to these lists, please see:
+  
+      http://www.net-snmp.org/lists/
+
+    The lists you definitely want to subscribe to is the
+    net-snmp-announce@lists.sourceforge.net list and the
+    net-snmp-users@lists.sourceforge.net list.
+
+    Please do *NOT* send messages to both -users and -coders lists.
+    This is completely unnecessary, and simply serves to further
+    overload (and annoy) the core development team.  Thank you.
+
+  Archives:
+    The archives for these mailing lists can be found by following links at
+
+      http://www.net-snmp.org/lists/
+
+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 run the snmpconf perl script for further 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 (or link against its libraries).  No
+  modification of the distributed source files are necessary.  See the
+  following files for details on how to go about this:
+  http://www.net-snmp.org/tutorial-5/toolkit/,
+  agent/mibgroup/examples/*.c
+
+  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 net-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://www.net-snmp.org/tutorial-5/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.
+
+  For the snmptrapd, see the man/snmptrapd.conf.5 manual page.
+
+  You can also run the snmpconf perl script to help you create some of
+  these files.
+
+SUBMITTING BUG REPORTS
+
+  Important: *Please* include what version of the net-snmp (or
+  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, please use the web interface at
+  http://www.net-snmp.org/bugs/.  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.
+
+  If you intend to submit a patch as well, please read the PORTING
+  file before you do so and then submit it to
+  http://www.net-snmp.org/patches/.
+
+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,
+
+    The net-snmp developers
+
+THANKS
+
+  The following people have contributed various patches and
+  improvements.  To them we owe our deepest thanks (and you do too!):
+
+    Wes Hardaker <hardaker@users.sourceforge.net>
+    Steve Waldbusser <waldbusser@nextbeacon.com>
+    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 J. Slifcak <slif@bellsouth.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 <rstory@freesnmp.com>
+    Bert Driehuis <driehuis@playbeing.org>
+    Juergen Schoenwaelder <schoenw@ibr.cs.tu-bs.de>
+    Frank Strauss <strauss@ibr.cs.tu-bs.de>
+    Ragnar Kjørstad <ucd@ragnark.vestdata.no>
+    Jochen Kmietsch <jochen.kmietsch@tu-clausthal.de>
+    Jun-ichiro itojun Hagino <itojun@iijlab.net>
+    John L Villalovos <john.l.villalovos@intel.com>
+    Christoph Mammitzsch <Christoph.Mammitzsch@tu-clausthal.de>
+    Arne Oesleboe <Arne.Oesleboe@item.ntnu.no>
+    Jeff Cours <jeff@ultradns.com>
+    Karl Schilke <karl_schilke@eli.net>
+    John Naylon <jbpn@cambridgebroadband.com>
+    Ken Hornstein <kenh@cmf.nrl.navy.mil>
+    Martin Oldfield <m@mail.tc>
+    Harrie Hazewinkel <harrie@users.sourceforge.net>
+    Mark Ferlatte <ferlatte@users.sourceforge.net>
+    Marus Meissner <marcusmeissner@users.sourceforge.net>
+    Stephan Wenzer <stephanwenzel@users.sourceforge.net>
+    Ron Mevissen <ron.mevissen@eed.ericsson.se>
+    T.J. Mather <tjmather@tjmather.com>
+    Craig Setera <seterajunk@charter.net>
+    Katsuhisa ABE <abekatsu@cysols.com>
+    Axel Kittenberger <Axel.Kittenberger@maxxio.com>
+    Johannes Schmidt-Fischer <jsf@InterFace-AG.com>
+    Jeffrey Watson <nostaw@users.sourceforge.net>
+    Bruce Shaw <Bruce.Shaw@gov.ab.ca>
+    Stefan Radman <sradman@users.sourceforge.net>
+
+  We've probably forgotten people on this list.  Let us know if you've
+  contributed code and we've left you out.