SNMPGET(1)

NAME
snmpget - Communicates with a network entity using SNMP GET Requests.

SYNOPSIS
snmpget [ -d ] [ -V ] [ -v ] [ -q ] [ -p port ] [ -r retries ] [ -t timeout ] [ -1 ] [ -2 ] host community object-identifier [ object-identifier ]

DESCRIPTION
Snmpget is an SNMP application that uses GET Requests to query for information about a network entity.

The host specification may be either a host name or an internet address specified in "dot notation"

If the network entity has an error processing the request packet, an error packet will be returned and a message will be shown, helping to pinpoint why the request was malformed.

If the tree search causes attempts to search beyond the end of the MIB, a message will be displayed:

End of MIB.

Adding a "-d" to the argument list will cause the application to dump input and output packets.

The "-V" flag returns the version of the app, and the version of the SNMP library used.

The "-v" flag provides a more verbose output format.

The "-q" flag just prints the returned value, and nothing else.

The "-p" flag allows you to specify a port to use for the SNMP requests.

The "-r" flag sets the number of retries. The default is 4.

The "-t" flag sets the timeout in microseconds. The default is 1000000.

The "-1" and "-2" flags set the SNMP version of the outgoing request.

EXAMPLES
% snmpget snmp-example.net.cmu.edu public .1.3.6.1.2.1.1.1.0

returns

Name: mib2.system.sysDescr.0 -> DisplayString : Unix 4.3BSD

% snmpget -v snmp-example.net.cmu.edu public .1.3.6.1.2.1.1.1.0

returns

Name:            mib2.system.sysDescr.0
Returned Type:   Octet String
Value:           "Unix 4.3BSD"

ENVIRONMENT
MIBFILE: Location of the SNMP MIB.

FILES
mib.txt                   First MIB tried if env. var is not set
/etc/mib.txt              Second MIB tried if env. var is not set

RFCS
Related RFCs: 1065, 1066, 1067
Related SNMPv2 RFCs: 1901, 1902, 1902, 1904, 1905, 1906, 1907, 1908, 1909

RELATED URLS
CMU Networking Group: http://www.net.cmu.edu/
CMU SNMP Home Page: http://www.net.cmu.edu/projects/snmp

SEE ALSO
snmpdelta(1), snmpget(1), snmpgetnext(1), snmpset(1), snmpstatus(1), snmptest(1), snmptranslate(1), snmptrap(1), snmptrap2(1), snmptrapd(1), snmpwalk(1)