| ucd-snmp Version: 4.2.pre0 |
| 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 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> |
| |
| We've probably forgotten people on this list. Let us know if you've |
| contributed code and we've left you out. |
