snmp.conf

- configuration file for the Net-SNMP applications

Synopsis

snmp.conf

Description

The file snmp.conf defines how the Net-SNMP applications operate. Tokens that can be put in the file are described in the DIRECTIVES section below.

If you are storing sensitive information, such as passphrases, in snmp.conf, make sure you make the file readable only by user.

Before modifying snmp.conf, make sure to read the snmp_config(4) manual page, which describes the effects of the Net-SNMP configuration files, where they are located, and how they all work together.

DIRECTIVES

The snmp.conf file supports the following directives:

mibdirs (mib-dirs| +mib-dirs)

Look for text MIBs to parse in the colon-separated list of directories. If the directive value starts with a plus sign, it prepends this list to the default directory list compiled into the application. Note that the value specified here can be overridden by the MIBDIRS environment variable.

mibs (mib-tokens| +mib-tokens)

Specifies a colon-separated list of MIB tokens that represent textual MIB files that are to be found and parsed. If the directive value starts with a plus sign, it prepends this list to the default MIB token list compiled into the application. The special keyword of ALL forces all MIBs files found to be read. Note that the value specified here can be overridden by the MIBS environment variable.

mibfile file

Specifies a text MIB file to read and parse, in addition to the list read from the MIBs token. Note that the value specified here can be overridden by the MIBFILES environment variable.

persistentDir directory

The directory where snmpd and snmptrapd store their persistent data files.

defaultPort port

The default port number that all SNMP applications and daemons should use.

defVersion ( 1 | 2c | 3 )

The default SNMP version to use. The default value is 3.

defCommunity string

The default SNMPv1 and SNMPv2c community string to use. The default value is the empty string, "".

defSecurityName string

The default SNMPv3 USM security name you want to use for SNMPv3 requests.

defContext string

The default SNMPv3 context name you want to use.

defPassphrase string

defAuthPassphrase string

defPrivPassphrase string

The default SNMPv3 USM passphrase(s) to use. If it is specified, defPassphrase is used for both authentication and privacy pass phrases.

defAuthType MD5 | SHA

The SNMPv3 USM authentication type to use. The default value is MD5.

defPrivType DES

The SNMPv3 USM privacy type to use. Currently, DES is the only possible value.

defSecurityLevel noAuthNoPriv | authNoPriv | authPriv

The SNMPv3 default security level to use. The default is authPriv.

showMibErrors ( 1 | yes | true | 0 | no | false )

Determines whether to display text MIB parsing errors when commands are run.

strictCommentTerm ( 1 | yes | true | 0 | no | false )

Determines whether parsing of MIBs should be strict about comment termination. A double hyphen ("--") terminates a comment if this is true. Many MIBs have broken comments in them, hence this option.

mibAllowUnderline ( 1 | yes | true | 0 | no | false )

Allow underline characters in MIBs (ordinarily illegal).

mibWarningLevel integerValue

Specifies the minimum warning level of the warnings printed by the MIB parser.

printNumericEnums ( 1 | yes | true | 0 | no | false )

Equivalent to -Oe.

printNumericOids ( 1 | yes | true | 0 | no | false )

Equivalent to -On.

dontBreakdownOids ( 1 | yes | true | 0 | no | false )

Equivalent to -Ob.

escapeQuotes ( 1 | yes | true | 0 | no | false )

Equivalent to -OE.

quickPrinting ( 1 | yes | true | 0 | no | false )

Equivalent to -Oq.

dontPrintUnits ( 1 | yes | true | 0 | no | false )

Equivalent to -OU.

printHexText ( 1 | yes | true | 0 | no | false )

Equivalent to -OT.

suffixPrinting ( 0 | 1 | 2 )

If the value is 1, this directive is equivalent to -Os. If the value is 2, it is equivalent to -OS.

oidOutputFormat ( 1 | 2 | 3 | 4 | 5 | 6)

Maps -O options as follows:

-Os=1
-OS=2
-Of=3
-On=4
-Ou=5

The value 6 has no matching -O option. It suppresses output.

extendedIndex ( 1 | yes | true | 0 | no | false )

Equivalent to -OX.

noRangeCheck ( 1 | yes | true | 0 | no | false )

Disables the validation of values that is done by snmpset(1M) before issuing the request to the agent. Equivalent to -Ir.

noDisplayHint ( 1 | yes | true | 0 | no | false )

Disables the use of DISPLAY-HINT information when parsing indices and values to set. Equivalent to -Ih.

dumpPacket ( 1 | yes | true | 0 | no | false )

Determines whether commands should dump packets by default.

doDebugging ( 1 | 0 )

Turns on debugging for all applications run if set to 1.

debugTokens token[,token...]

Specifies the debugging tokens that should be displayed. See snmpcmd(1M) for debugging usage details.

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

snmpcmd(1M), snmpset(1M), snmp_config(4), attributes(5)