snmpd.peers(SFF)

snmpd.peers -- SMUX peers file

Synopsis

/etc/netmgt/snmpd.peers

Description

The snmpd.peers file contains information which the SNMP agent/server daemon, snmpd(ADMN), uses to authenticate requests from SMUX peers to register subtrees with the SNMP agent/server.

Lines in the snmpd.peers file are of the form:

name object-id password [priority]

where

name: the name of a SMUX peer
object-id: object-identifier (OID) in dot notation that represents the SMUX peer; see RFC 1213 for a description of OIDs
password: a password in unencrypted form; snmpd compares the value of password with the value of the password received in the open request PDU from the SMUX peer
priority: an optional priority value that snmpd uses to determine which SMUX peer to consult when more than one peer registers the same subtree; valid values are in the range [0, (2^31)-1], with a lower number having a higher priority (a ``-1'' can also be used to represent the highest priority)

Each token is separated by white space, though double quotes may be used to prevent separation. Lines which begin with a hash sign (#) are ignored.

Warnings

Since the passwords in the snmpd.peers file are not encrypted, the file must be in protected mode 0600 and owned by root.

Examples

   mysmuxd   1.3.6.1.4.1.4.3.1.2   "aintNothing"
   triald  1.3.6.1.4.1.4.3.1.22  "aintNothing"    4

The following is the default snmpd.peers file; these lines should not be changed:

   # hostmibd realizes Host Resources MIB (RFC 1514).
   "hostmibd"  1.3.6.1.2.1.25       "nopassword"

References

snmpd(ADMN)

RFC 1155, RFC 1157, RFC 1227

For information on writing a custom SNMP peer process, see ``Implementing an SMUX peer'' in Using network programming interfaces.