snmpget

communicates with a network entity using SNMP GET Requests 

Command

SYNOPSIS

snmpget [COMMON_OPTION] [-Cf] OID [OID]...

DESCRIPTION

The snmpget utility is an SNMP application that uses the SNMP GET request to query for information on a network entity. One or more object identifiers (OIDs) may be given as arguments on the command line. Each variable name is given in the format specified in snmp_variables.

For example: 

snmpget -c public zeus system.sysDescr.0

will retrieve the variable system.sysDescr.0: 

system.sysDescr.0 = "SunOS zeus.net.cmu.edu 4.1.3_U1 1 sun4m"

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 in what way the request was malformed. If there were other variables in the request, the request will be resent without the bad variable.

Options

-Cf 

If -Cf is not specified, some applications (snmpdelta, snmpget, snmpgetnext, and snmpstatus) will try to fix errors returned by the agent that you were talking to and resend the request. The only time this is really useful is if you specified a OID that didn't exist in your request and you're using SNMPv1 which requires "all or nothing" kinds of requests. Here is an example (note that system.sysUpTime is an incomplete OID as it needs the .0 index appended to it): 

snmpget -v1 -Cf -c public localhost system.sysUpTime system.sysContact.0

Error in packet
Reason: (noSuchName) There is no such variable name in this MIB.
This name doesn't exist: system.sysUpTime
snmpget -v1 -c public localhost system.sysUpTime system.sysContact.0
Error in packet
Reason: (noSuchName) There is no such variable name in this MIB.
This name doesn't exist: system.sysUpTime
system.sysContact.0 = root@localhost

With the -Cf option specified the application will not try to fix the PDU for you.

In addition to this option, snmpget takes the common options described in the snmpcmd reference page.

PORTABILITY

All UNIX systems. Windows 2000. Windows XP. Windows Server 2003. Windows Vista.

AVAILABILITY

MKS Toolkit for System Administrators
MKS Toolkit for Developers
MKS Toolkit for Interoperability
MKS Toolkit for Professional Developers
MKS Toolkit for Enterprise Developers
MKS Toolkit for Enterprise Developers 64-Bit Edition

SEE ALSO

Miscellaneous:
snmp_variables, snmpcmd

MKS Toolkit 9.2 Documentation Build 16.