man pages section 1: User Commands

Exit Print View

Updated: July 2014

snmpwalk (1)


snmpwalk - retrieve a subtree of management values using SNMP GETNEXT requests




Net-SNMP                                              SNMPWALK(1)

     snmpwalk  -  retrieve  a  subtree of management values using
     SNMP GETNEXT requests


     snmpwalk is an  SNMP  application  that  uses  SNMP  GETNEXT
     requests  to  query  a network entity for a tree of informa-

     An object identifier (OID) may be given on the command line.
     This  OID  specifies  which portion of the object identifier
     space will be searched using GETNEXT  requests.   All  vari-
     ables  in  the  subtree  below the given OID are queried and
     their values presented to the user.  Each variable  name  is
     given in the format specified in variables(5).

     If no OID argument is present, snmpwalk will search the sub-
     tree rooted at SNMPv2-SMI::mib-2 (including any  MIB  object
     values  from  other  MIB  modules, that are defined as lying
     within this subtree).  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
     why the request was malformed.

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

     -Cc     Do not check whether the returned OIDs are  increas-
             ing.   Some agents (LaserJets are an example) 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 hits an  agent  acting  illegally.
             Use -Cc to turn off this check.

     -Ci     Include the given OID in the search range.  Normally
             snmpwalk uses GETNEXT requests starting with the OID
             you  specified  and  returns  all results in the MIB
             subtree rooted at that OID.  Sometimes, you may wish
             to  include the OID specified on the command line in
             the printed results if it is a valid OID in the tree
             itself.  This option lets you do this explicitly.

     -CI     In  fact,  the given OID will be retrieved automati-
             cally if the main subtree walk  returns  no  useable
             values.   This allows a walk of a single instance to
             behave  as  generally  expected,  and   return   the

V5.4.1               Last change: 08 Feb 2002                   1

Net-SNMP                                              SNMPWALK(1)

             specified  instance  value.   This  option turns off
             this final GET  request,  so  a  walk  of  a  single
             instance will return nothing.

     -Cp     Upon  completion  of  the  walk, print the number of
             variables found.

     -Ct     Upon completion of the walk, print the  total  wall-
             clock time it took to collect the data (in seconds).
             Note that the  timer  is  started  just  before  the
             beginning  of  the  data  request series and stopped
             just after  it  finishes.   Most  importantly,  this
             means that it does not include snmp library initial-
             ization,  shutdown,  argument  processing,  and  any
             other overhead.

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

     The command:

     snmpwalk -Os -c public -v 1 zeus system

     will retrieve all of the variables under system:

     sysDescr.0 =  STRING:  "SunOS  4.1.3_U1  1
     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: ""
     sysLocation.0 = STRING: ""
     sysServices.0 = INTEGER: 72

     See   attributes(5)   for   descriptions  of  the  following

     |ATTRIBUTE TYPE |               ATTRIBUTE VALUE                 |
     |Availability   | system/management/snmp/net-snmp/documentation |
     |Stability      | Volatile                                      |
     snmpcmd(1), snmpbulkwalk(1), variables(5).

V5.4.1               Last change: 08 Feb 2002                   2

Net-SNMP                                              SNMPWALK(1)

     This  software  was   built   from   source   available   at    The  original
     community       source       was       downloaded       from

     Further information about this software can be found on  the
     open source community website at

V5.4.1               Last change: 08 Feb 2002                   3