snmpwalk(1M)						  System Administration Commands					      snmpwalk(1M)

NAME

       snmpwalk - communicate with a network entity using SNMP GETNEXT requests

SYNOPSIS

       snmpwalk [application options] [common options] [oid]

DESCRIPTION

       The snmpwalk utility is an SNMP applicationthat uses SNMP GETNEXT requests to query a network entity for a tree of information.

       You  can  specify  an  object identifier (OID) on the command line. This OID specifies which portion of the object identifier space will be
       searched using GETNEXT requests. All variables in the subtree below the specified OID are queried and their values returned. Each  variable
       name must be entered in the format specified in snmp_variables(4).

       If  no  OID argument is present, snmpwalk searches MIB-2. If the network entity has an error processing the request packet, an error packet
       is returned and a message displayed, indicating t the way in which the request was malformed.

       If the tree search causes attempts to search beyond the end of the MIB, the message "End of MIB" is displayed.

OPTIONS

       The following options are supported:

       -Cc

	   Do not check whether the returned OIDs are increasing. Some agents (for example, agents for Laser-Jet  printers)  return  OIDs  out	of
	   order, but can complete the walk anyway. Other agents return OIDs that are out of order and can cause snmpwalk to loop indefinitely. By
	   default, snmpwalk tries to detect this behavior and warns you when it encounters an agent acting illegally. Use -Cc to  turn  off  this
	   feature.

       -Ci

	   Include  the  given OID in the search range. Normally, snmpwalk uses GETNEXT requests starting with the OID you specify and returns all
	   results in the MIB tree beyond that OID. This option allows you to include the OID specified on  the  command  line	in  the  displayed
	   results (assuming the OID is a valid OID in the tree).

       -Cp

	   Upon completion of the walk, display the number of variables found.

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

EXAMPLES

       Example 1: Retrieving All of the Variables Under system

       The following command retrieves all of the variables under system:

       # snmpwalk -Os -c public -v 1 zeus system

       Output from this command will be similar to:

       sysDescr.0 = STRING: "SunOS zeus.net.cmu.edu 4.1.3_U1 1 sun4m"
       sysObjectID.0 = OID: enterprises.hp.nm.hpsystem.10.1.1
       sysUpTime.0 = Timeticks:(155274552) 17 days, 23:19:05
       sysContact.0 = STRING: ""
       sysName.0 = STRING: "zeus.net.cmu.edu"
       sysLocation.0 = STRING: ""
       sysServices.0 = INTEGER: 72

ATTRIBUTES

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

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

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.

SEE ALSO

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

SunOS 5.10							    20 Jan 2004 						      snmpwalk(1M)