README file for net-snmp Version: 5.10
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.
 This README file serves as a starting place to learn about the
 package, but very little of the documentation is contained within
 this file. The FAQ is an excellent place to start as well.
 Additionally, there are a bunch of README files for specific
 architectures and specific features. You might wish to look at some
 of these other files as well.
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.
 Also note that many architecture have architecture specific README
 files, so you should check to see if there is one appropriate to
 your platform.
AVAILABILITY
 Download:
 - http://www.net-snmp.org/download/
 Web page:
 - http://www.net-snmp.org/
 Project Wiki:
 - http://www.net-snmp.org/wiki/
 Sourceforge Project page:
 - http://sourceforge.net/projects/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://sourceforge.net/projects/net-snmp
 http://www.net-snmp.org/wiki/
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.
 This is also available on the project Wiki at
 http://www.net-snmp.org/wiki/index.php/FAQ
 so that the wider Net-SNMP community can help maintain it!
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:
 A number of mailing lists have been created for support of the project:
 The main ones are:
 net-snmp-announce@lists.sourceforge.net -- For official announcements
 net-snmp-users@lists.sourceforge.net -- For usage discussions
 net-snmp-coders@lists.sourceforge.net -- For development discussions
 The -coders list is intended for discussion on development of code
 that will be shipped as part of the package. The -users list is
 for general discussion on configuring and using the package,
 including issues with coding user-developed applications (clients,
 managers, MIB modules, etc).
 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. If in doubt,
 just use the -users list.
 The other lists of possible interest are:
 net-snmp-cvs@lists.sourceforge.net -- For cvs update announcements
 net-snmp-bugs@lists.sourceforge.net -- For Bug database update announcements
 net-snmp-patches@lists.sourceforge.net -- For Patch database update announcements
 Please do NOT post messages to these lists (or to the announce list above).
 Bug reports and Patches should be submitted via the Source Forge tracker
 system. See the main project web pages for details.
 To subscribe to any of these lists, please see:
 
 http://www.net-snmp.org/lists/
 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 <nba@users.sourceforge.net>
 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>
 Stephen J. Friedl <sjfriedl@users.sourceforge.net>
 Alex Burger <alex_b@users.sourceforge.net>
 Christophe Varoqui <ext.devoteam.varoqui@sncf.fr>
 Srikanth Pindiproli <sripindip@users.sourceforge.net>
 Kevin Graham <kevgraham7@users.sourceforge.net>
 Xiaofeng Ling <xfling@users.sourceforge.net>
 Brandon Knitter <knitterb@bl...>
 Andrew Findlay <andrew.findlay@skills-1st.co.uk>
 Ron Tabor <rtabor@users.sourceforge.net>
 Peter Warasin <drg-r3@users.sourceforge.net>
 Bob Rowlands <robert.rowlands@sun.com>
 Peter Hicks <Peter.Hicks@POGGS.CO.UK>
 Andy Smith <wasmith32@earthlink.net>
 Nick Barkas <nbarkas@users.sourceforge.net>
 Noah Friedman <friedman@prep.ai.mit.edu>
 Geert De Peuter <geert@depeuter.org>
 Magnus Fromreide <magfr@lysator.liu.se>
 Marcus Meissner <marcusmeissner@users.sourceforge.net>
 Andrew Rucker Jones <arjones@users.sourceforge.net>
 Dai.H. <dg-f@users.sourceforge.net>
 Thomas Anders <tanders@users.sourceforge.net>
 Vladislav Bogdanov <slava_reg@nsys.by>
 Peter Martin <pnmartin@users.sourceforge.net>
 Thomas Lackey <telackey@users.sourceforge.net>
 Joe Buehler <jbuehler@spirentcom.com>
 Anders Persson <apersson@users.sourceforge.net>
 Rojer <rojer@users.sourceforge.net>
 Bart Van Assche <bart.vanassche@gmail.com>
 Pablo Carboni <pcarboni@users.sourceforge.net>
 Bill Fenner <fenner@gmail.com>
 Brian Sipos <bsiposrkf@users.sourceforge.net>
 Eugene M. Kim <eugene.kim@ntti3.com>
 Anders Wallin <wallinux@gmail.com>
 Andrew Stormont <andy-js@users.sourceforge.net>
 Keith Mendoza <keith@icei.org>
 Igor Ryzhov <iryzhov@nfware.com>
 We've probably forgotten people on this list. Let us know if you've
 contributed code and we've left you out.