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)