snmpget(1) Net-SNMP snmpget(1)
NAME
snmpget - communicates with a network entity using SNMP GET requests
SYNOPSIS
snmpget [COMMON OPTIONS] [-Cf] OID [OID]...
DESCRIPTION
snmpget 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 variables(5).
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.
In addition to this option, snmpget snmpgetnext takes the common
options described in the snmpcmd(1) manual page. Note that snmpgetnext
REQUIRES an argument specifying the agent to query and at least one OID
argument, as described in the snmpcmd(1) manual page.
EXAMPLES
The command:
snmpget -c public zeus system.sysDescr.0
will retrieve the variable system.sysDescr.0 from the host zeus using
the community string public :
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.
Here is another example. The -c and -v options are defined in the snm-
pcmd(1) manual page. (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
This example will return the following:
Error in packet
Reason: (noSuchName) There is no such variable name in this MIB.
This name doesn't exist: system.sysUpTime
Similarly, the command:
snmpget -v1 -c public localhost system.sysUpTime system.sysContact.0
Will return:
Error in packet
Reason: (noSuchName) There is no such variable name in this MIB.
This name doesn't exist: system.sysUpTime
system.sysContact.0 = STRING: root@localhost
With the -Cf flag specified the application will not try to fix the PDU
for you.
SEE ALSO
snmpcmd(1), snmpwalk(1), variables(5).
V5.6 18 Jun 2007 snmpget(1)
Mac OS X 10.7 - Generated Wed Aug 10 12:44:35 CDT 2011