`snmpget`

communicate with a network entity using SNMP GET requests

Syntax:

snmpget [-d] [-p port] [-r retry] [-t timeout] 
        -v 1 host community variable_name [variable_name]

snmpget [-d] [-p port] [-r retry] [-t timeout] [-v 2]
        host noAuth variable_name [variable_name]

snmpget [-d] [-p port] [-r retry] [-t timeout] [-v 2]
        host scrparty dstparty context variable_name 
        [variable_name]

Options:

-d: Dump input and output packets.
-p port: Specify the destination port number.
-r retry: Specify the number of retries.
-t timeout: Specify timeout (in seconds).
-v 1|2: SNMP version (default is 2).
community: The community name for the transaction with the remote system.
context: The collection of object resources that can be queried by the dstparty.
dstparty: The name of the party providing information.
host: An Internet address specified in dot notation or a hostname.
srcparty: The name of the party requesting information.
variable_name: The variable name in the format specified in the file mib.txt.

The snmpget utility uses the GET request to query for information about a network entity. You can specify one or more fully qualified object identifiers in the format specified in the file mib.txt.

If you're using SNMP version 2, the following files must be configured:

/etc/acl.conf
/etc/context.conf
/etc/party.conf
/etc/snmpd.conf (required only if you change the default location of your config files)

For a description on how to configure the files please see the ``Administrative model'' section in the SNMPv2 chapter, and the file page for each of the configuration files listed above. If you wish to change the location of your configuration files, you must include a snmpd.conf file.

Examples:

Retrieve the variables sysDescr.0 and sysUpTime.0:

Using SNMPv1

snmpget -v 1 netdev-kbox.cc.cmu.edu public system.sysDescr.0
    system.sysUpTime.0

Using SNMPv2

snmpget
    netdev-kbox.cc.cmu.edu manager_party agent_party agent_context system.sysDescr.0
    system.sysUpTime.0

The output is similar to:

Name: system.sysDescr.0
OCTET STRING- (ascii):   Kinetics FastPath2

Name: system.sysUpTime.0
Timeticks: (2270351) 6:18:23

Environment variables:

MIBFILE

Specify the location of the mib.txt file. For example, MIBFILE=path/mib.txt (the default path is /etc).

SUFFIX

If SUFFIX exists in your environment, all object IDs with a symbolic name will be printed with only the last element. Examples:

This ID:

system.syscontact.0

will be printed as:

syscontact.0