NAME

snmpd, snmpd.conf − Simple Network Management Protocol (SNMP) agent daemon. 

SYNOPSIS

/usr/sbin/snmpd

DESCRIPTION

The snmpd daemon is an SNMP agent that implements MIB II, FDDI, and Token Ring MIBs, and supports SNMP V1.  The snmpd daemon starts automatically at boot time, and listens for and responds to queries and commands from logically remote network management stations. 

The snmpd reads its configuration file (/etc/snmpd.conf) at startup time.  You can change the configuration by editing the /etc/snmpd.conf file, as described in the Configuring snmpd section in this reference page. 

Note

The default configuration grants read access to the world, and does not generate any traps.

The snmpd daemon logs error messages through the syslog function to the /usr/var/adm/syslog.dated/date/daemon.log log file. 

Configuring snmpd

The /etc/snmpd.conf file defines the initial values for four MIB variables, as well as access control based on community names.  The entries have the following format:

sysName                name
sysLocation            location
sysContact             contact
snmpEnableAuthenTraps  n
community              community-name  IP-address  privileges
trap                   trap-community-name  IP-address

White space (tabs, spaces, line feeds and carriage returns) and blank lines are ignored.

MIB Variable Initialization

When an entry in the /etc/snmpd.conf file is one of the following MIB variables, it is assigned the value that follows it:

sysName                name
sysLocation            location
sysContact             contact
snmpEnableAuthenTraps  n

According to RFC 1213, the variables sysName, sysLocation, and sysContact can be any string of 0 to 255 NVT ASCII characters.  The value of the snmpEnableAuthenTraps entry can be either 1 or 2 to enable or disable traps.  For example:

sysLocation             City, USA
sysContact              Kathy Berberian 555-7667
snmpEnableAuthenTraps   1

If the values of the sysName, sysLocation, and sysContact variables are modified by SNMP set commands, the new values are updated in the snmpd.conf file.  (The sysName variable does not affect the system’s host name.)  If sysName is not defined in the snmpd.conf file, the system’s host name is used. 

Community Entries

Community entries have the following format:

community-name  IP-address  privileges

community-name
Can be any string.

IP-address
Indicates the remote site for which this community is valid. If the IP address is 0.0.0.0, any address can communicate using that community name.

privileges
Can be either read for read only or write for read and write. 

The following is a sample entry for the community variable:

community test1   130.117.1.20 READ

This example defines a community named test1 that allows read-only access from the IP address 130.117.1.20. 

Note

The OSF/1 agent implements write access to all MIB II variables so defined.  Authorized parties are able to change the OSF/1 environment (such as, bring down an interface or delete an entry from the routing table).

Trap Community Entries

Trap entries have the following format:

trap-community-name  IP-address

trap-community
Can be any string.

IP-address
Indicates the destination address to be included in the trap PDU.

The following is a sample trap entry:

trap test2   128.169.4.15

This example indicates to the agent that if a trap needs to be sent, the trap PDU should be built using the community name test2 and sent to the trap port at 128.169.4.15. 

FILES

/etc/snmpd.conf
The snmpd daemon configuration file. 

/usr/var/adm/syslog.dated/date/daemon.log
The system daemon log file,  where date is the date. 

RELATED INFORMATION

Commands: syslog(3)

Network Configuration

Structure and Identification of Management Information for TCP/IP-Based Internets (RFC 1155), A Simple Network Management Protocol (RFC 1157), Concise MIB Definitions (RFC 1212), MIB II (RFC 1213), Conventions for Defining Traps for Use With the SNMP (RFC 1215), IEE 802.5 Token Ring MIB (RFC 1231), FDDI MIB (RFC 1512)