snmpd(1M)

NAME

snmpd − daemon that responds to SNMP requests

SYNOPSIS

snmpd [-C contact] [-L location] [-a] [-c] [-k] [-l logfile] [-m logmask]

snmpd [-M logmask]

DESCRIPTION

snmpd is the Simple Network Management Protocol (SNMP) agent.

An SNMP manager sends requests for Management Information Base (MIB) values to snmpd using the SNMP. The agent replies with the information requested.

The MIB is a conceptual database of values on the agent. See /usr/OV/snmp_mibs/hp-unix for a list of MIB values that snmpd supports. The MIB file /usr/OV/snmp_mibs/hp-unix is included with HP OpenView products. The agent supports all objects in RFC 1213 except the EGP group.

Only the super-user can start snmpd, and only one snmpd can execute at a time.

When invoked, snmpd reads /etc/snmpd.conf to configure itself (see snmpd.conf(4)).

Options

snmpd recognizes the following options:

-C contact Specify the contact person responsible for the network management agent. This option overrides the contact person specified in /etc/snmpd.conf.

-L location Specify the location of the agent. This option overrides the location specified in /etc/snmpd.conf.

-M logmask Send a message to the currently running snmpd to change its logging mask to logmask. See the Log Masks section for valid values.

-a Suppress sending authenticationFailure traps.

-c Reconfigure snmpd (force snmpd to re-read /etc/snmpd.conf).

-k Kill the currently running snmpd.

-l logfile Use logfile for logging rather than the default logfile, /usr/adm/snmpd.log.

-m logmask Sets the initial logging mask to logmask. See the Log Masks section for valid values.

Traps

The agent also sends information to a manager without an explicit request from the manager. Such an operation is called a “trap”. snmpd sends the following SNMP traps:

coldStart Sends a coldStart trap when snmpd is invoked.

linkDown Sends a linkDown trap when an interface goes down.

linkUp Sends a linkUp trap when an interface comes up.

authenticationFailure
Sends an authenticationFailure trap when an SNMP request is sent to snmpd with a community name that does not match the community names specified in /etc/snmpd.conf.

Each SNMP request is accompanied by a community name, which is a password that enables SNMP access to MIB values on an agent. A manager can request to read a MIB value by issuing an SNMP GetRequest, or a manager may request to alter a MIB value by issuing an SNMP SetRequest.

Log Masks

Log masks specify the type of output listed in /usr/adm/snmpd.log or in logfile. To select multiple output types, add the individual logmask values together and enter that number.

0 Turn off logging.

1 Log authenticationFailure traps.

2 Log errors.

4 Log configuration requests.

8 Log requests and replies.

16 Log requests and replies for objects that have been added.

32 Log hexdumps of packets received and sent by snmpd.

64 Log trace messages.

Defaults

By default, the agent (/etc/snmpd) does not allow managers to alter MIB values (it returns errors for SNMP SetRequests). To configure the agent to respond to SNMP SetRequests, add a set-community-name to /etc/snmpd.conf.

By default, the agent responds to all SNMP GetRequests, regardless of community name used in the request. To configure the agent to respond to a specific community name, add a get-community-name to /etc/snmpd.conf.

By default, SNMP traps are not sent to any destination. To configure the agent to send traps to one or more specific destinations, add the trap destinations to /etc/snmpd.conf.

By default, the agent’s location is a blank string. To configure the agent’s location, add the location to /etc/snmpd.conf, or use the -L option.

By default, the agent’s contact is a blank string. To configure the agent’s contact, add the contact to /etc/snmpd.conf, or use the -C option.

By default the agent logs authenticationFailure traps and errors to /usr/adm/snmpd.log or in logfile.

EXTERNAL INFLUENCES

Environment Variables

LANG determines the language in which messages appear. If LANG is not specified or is set to the empty string, a default of "C" (see lang(5)) is used instead of LANG. If any internationalization variable contains an invalid setting, snmpd behaves as if all internationalization variables are set to "C." See environ(5).

International Code Set Support

Supports single-byte character code sets.

AUTHOR

snmpd was developed by HP and Massachusetts Institute of Technology.

FILES

/etc/snmpd.conf
/usr/adm/snmpd.log
/usr/OV/snmp_mibs/hp-unix

Museum

Related Articles