snmpget(1M)						  System Administration Commands					       snmpget(1M)

NAME

       snmpget - communicate with a network entity using SNMP GET requests

SYNOPSIS

       /usr/sfw/bin/snmpget [common options] [-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. You can specify one
       or more object identifiers (OIDs) as arguments on the command line. Each variable name  must  be  specified  in	the  format  specified	in
       snmp_variables(4) .

       For example, the command:

       # snmpget -c public zeus system.sysDescr.0

       retrieves 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 is returned and a message displayed. The message indi-
       cates the way in which the request was malformed. If there were other variables in the request that were correctly formed, the request will
       be resent without the bad variable.

OPTIONS

       The following option is supported:

       -Cf

	   If -Cf is not specified, some applications (including snmpgetnext(1M) and snmpget) attempt to fix errors returned by the agent that you
	   were talking to and resend the request. The -Cf option suppresses this fix-and-resend feature.

	   Fix-and-resend is useful if you specified a nonexistent OID in your request and you are using SNMPv1, which requires "all  or  nothing"
	   types  of requests. In the following example note that system.sysUpTime is an incomplete OID, because it requires 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 = STRING: root@localhost

       In addition to this option, snmpwalk takes the common options described in the snmpcmd(1M) manual page.

EXIT STATUS

       0

	   Successful completion.

       1

	   A usage syntax error. A usage message is displayed. Also used for timeout errors.

       2

	   An error occurred while executing the command. An error message is displayed.

ATTRIBUTES

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

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWsmcmd 		   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |External			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       snmpcmd(1M), snmp_variables(4), attributes(5)

SunOS 5.10							    20 Jan 2004 						       snmpget(1M)