Introduction

## What Is It?

Various tools relating to the Simple Network Management Protocol including:

- An extensible agent
- An SNMP library
- tools to request or set information from SNMP agents
- tools to generate and handle SNMP traps
- A slew of SNMP related perl modules
- a version of the unix 'netstat' command using SNMP
- a Tk/perl mib browser

Please see our project development pages as well.

Note: Some links in this document are external to this Windows help file.

## History

This package was originally based on the Carnegie Mellon University and Univerisity of California at Davis SNMP implementations, but has been greatly enhanced, ported, fixed, made easier to use and barely resembles the original package anymore.

## Distribution

Be sure and check out the other related software project links as well.

- 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/
- GPG Key for signed files (also available on pgp.net servers):
  - http://www.Net-SNMP.org/net-snmp-admin.asc
- Mirrors (note that sourceforge download servers are mirrored themselves):
  - 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/

## Documentation

## Introduction/Overview

- The net-snmp Tutorial,
- README, README.SNMPv3, and README.WIN32
- INSTALL file
- The copyright
- Frequently Asked Questions
- Developer Frequently Asked Questions
- News and ChangeLog files
- The Projects Page
- MIB files distributed with Net-SNMP

## Manual Pages

A full list of manual pages can be found in the various sections listed in the table of contents; this is merely a summary of the most important.

- ### General

- Configuring the software via .conf files.
- The doxygen generated API documentation

- ### The Agent

- snmpd
- snmpd.conf
- How to extend the agent
  (plus a list of things to check in case this doesn't seem to work)

  ### The Trap Demon

- snmptrapd
- snmptrapd.conf

  ### The Applications

- snmpcmd: common command line arguments
- snmp.conf
- snmpconf: a configuration file generator
- Applications Tutorial
- snmpget
- snmpset
- snmpwalk
- snmptrap
- snmpbulkwalk
- snmpdelta
- snmpgetnext
- snmpnetstat
- snmpstatus
- snmptable
- snmptest
- snmptranslate
- snmpusm
- snmpdf
- snmpbulkget

  ### The Library API

- Library Tutorial
- snmp_api
- snmp_sess_api
- mib_api
- variables
- read_config
- default_store
- snmp_alarm
- snmp_trap_api
- snmp_agent_api

## Mailing Lists

There is one announcement mailing list:

- net-snmp-announce

There are two main discussion lists:

- net-snmp-users
  for discussion on configuring and using the package, including coding issues for user-developed applications (clients, managers, MIB modules, etc).
- net-snmp-coders
  for discussion on development of code that will be shipped as part of the package.

Please do NOT post messages to both lists. This just increases the support load, annoys the developers and makes it less likely that your query will be answered. If in doubt. post to the net-snmp-users list. None of the other project mailing lists are suitable for general posting - please regard these as "read-only" lists.

See sourceforge.net's mailing list instructions for further details, and to subscribe (or unsubscribe) to individual lists.
Note that messages for non-subscribers will be held for approval before appearing on the list. This is purely intended to stem the recent flood of spam email, and is not meant to deter requests for assistance or information.

Also, stop by the #net-snmp IRC channel on the freenode.net IRC servers to gather, mingle, and chat. At least 3 of the core developers are known to hang out there regularily.

## Contacting the Authors and Submitting Bug Reports

There are many authors from around the net working on the project. To report a bug, see the net-snmp bugs database. For support, please mail a note to our "users discussion mailing list" at net-snmp-users@lists.sourceforge.net.

## Helping Out!

Want to help? There are many projects that need to be tackled to make this software better. To help us out, join the net-snmp-coders mailing list, announce what you're wanting to work on (to make sure its not being done and won't conflict with someone elses work) and start writing! Submit your ideas, questions, patches etc. to the net-snmp-coders list as you come up with them.
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; in summary BSD-like not GPL or LGPL). 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.

## Related Software and Information

### Software

- OpenSNMP: Our sister SNMPv3 reference release: A C++, threaded, modular snmpv3 reference implementation.
- Net-Policy: Net-Policy is a highly-scalable, role-and-policy based network management system. It distrubutes configuration to a network primarily through the SNMP protocol. (Its initial configuration mechanisms are designed for IPsec VPN management.) Stop configuring your SNMP agents one host at a time!
- snarl-snmp: snarl (Snmp based Network Application for Remote Logging and monitoring) is an active MIB module for net-snmp-5.0.3 and higher to actively monitor dynamic web applications. snmp traps are sent and escalated on alarms
- netsnmpj: NetSNMPJ is a open source java library that implements a java API around the Net-SNMP code base.
- Jasmin: A DISMAN-SCRIPT-MIB implementation. This is a third party MIB module that implements the DISMAN-SCRIPT-MIB for use with a the Net-SNMP agent. The implementation supports multiple languages and runtime systems and A script MIB extensibility protocol (SMX) to plugin additional runtime systems.
- Fetchlog: The fetchlog utility fetches and converts the last new messages of a logfile similar to tail. Together with Net-SNMP it can be used to look in remote logfiles or to monitor logfiles, for example with Nagios.
- SNMPTT: SNMPTT is a SNMP trap handler written in Perl for use with the NET-SNMP snmptrapd program. Received traps are translated into friendly messages using variable substitution.

### Other sources of information about SNMP in general

- The comp.protocols.snmp FAQ.
- The Simple Times -- A quarterly to yearly journal about SNMP
- The MIB Depot: A useful site for finding and downloading MIBs
- A Counter Test Mib module to test 32 and 64 bit counters.

### IETF and SNMP protocol standards related information

- The main IETF web page.
- The SNMPv3 web page.
- The agentx web page. (AgentX is a subagent protocol which net-snmp supports)
- The Evolution of SNMP (EoS) Working Group information. This is where future extensions to SNMP are being designed.
- The SMI Next Generation (sming) Working Group information. This is where future changes to the SMI language are being defined. (SMI is the language in which MIBs are written).