Table of Contents

NAME

snmpd.conf - configuration file for cmu snmpd

DESCRIPTION

/etc/snmpd.conf is read on startup by snmpd(8)


This file has two parts. The first part is related to the view, user and community configuration for snmp V2-usec.

The second part is for the Linux port and allows to set additional configuration items:

The Linux specific part consists of lines containing a <key> followed by a : and a <value>.
Lines beginning with a # and empty lines are ignored.

The recognized key and value pairs are as follows:

port
The port to open and listen to; default is port 161.
sysContact
Return string for a system.sysContact request; default is Unknown. Please note: This is setable by a snmp set-request and saved.
sysLocation
Return string for a system.sysLocation request; default is Unknown. Please note: This is setable by a snmp set-request and saved.
sysName
Return string for a system.sysName request; default is the hostname. Please note: This is setable by a snmp set-request and saved.
trap sink
The host the trap is sent to; this parameter is passed to snmptrap(1) . The default is "localhost"
trap community
The trap community used; this parameter is passed to snmptrap(1) . The default is "public".
snmpEnableAuthenTraps
Flag to indicate, traps should be sent. Possible values are "enabled" and "disabled". The default is disabled.

interface
The value must have three fields: a string naming the interface, a integer describing the type of the interface (ala RFC 1213) and a integer describing the speed of the interface. If the name has a trailing asterisk, any suffix will match. Multiple entries are possible. Look at the example below for a sample.

EXAMPLE


A sample /etc/snmpd.conf is:

## /etc/snmpd.conf:
##
## view configuration
##
##    viewName    OID            included/excluded
##
## internet
view    all        .1.3.6.1        included

## internet
view    mini        .1.3.6.1        included

## for v1 public exclude exclude mib-2.ident.identInfo
## and mib-2.host.hrSWRun in the mini view:
view    xmini        .1.3.6.1        included
view    xmini        .1.3.6.1.2.1.24.1    excluded
view    xmini        .1.3.6.1.2.1.25.4    excluded

## system, snmp, usecAgent, usecStats
view    semi        .1.3.6.1.2.1.1        included
view    semi        .1.3.6.1.2.1.11        included
view    semi        .1.3.6.1.6.3.6.1.1    included
view    semi        .1.3.6.1.6.3.6.1.2    included

## snmp, usecAgent, usecStats
view    semi        .1.3.6.1.2.1.11        included
view    semi        .1.3.6.1.6.3.6.1.1    included
view    semi        .1.3.6.1.6.3.6.1.2    included

##
## user configuration
##
##    noneRV    noneWV    authRV    authWV    userName[/authKey]
##
user    mini    -    all    all    public/0x05a1483bb7a0b314cc5cf9d27aee2a89

##
## community configuration
##
##     commName    readV    writeV
##
community public    xmini    -
community private    mini    mini

##
## now follows the specific section of the linux-port.
##

##
## port to use (default is 161):
##
# port:        161

##
## the entry of system.Contact and system.Location:
##
sysContact:        Kaept'n Koerg
sysLocation:        Outer Regions
## system name is per default determined from the hostname:
# sysName:        chappell

##
## trap sink address and community string. (passed to snmptrap(1)
## utility). authentraps contains the value of snmpEnableAuthenTraps;
## (``enabled'' == send traps, default is ``disabled'' == do not send traps).
##
trap sink:        localhost
trap community:        public
snmpEnableAuthenTraps:    enabled

##
## type and speed of interfaces:
## if the last char is an asterisk, any suffix will match.
##
interface:    lo0    24    20000000
interface:    eth0     6    10000000
interface:    sl*    28    38400
interface:    ppp*    23    38400

## end of /etc/snmpd.conf

BUGS

There is currently no further documentation about the usec specific part.

SEE ALSO

snmpd(8)

AUTHOR

Things added for the Linux port by Erik Schoenfelder (schoenfr@gaertner.de), inspired by Juergen Schoenwaelder (schoenw@cs.utwente.nl).


Table of Contents