man pages section 1: User Commands

Exit Print View

Updated: July 2014

snmpbulkwalk (1)


snmpbulkwalk - retrieve a subtree of management values using SNMP GETBULK requests




Net-SNMP                                          SNMPBULKWALK(1)

     snmpbulkwalk - retrieve a subtree of management values using
     SNMP GETBULK requests


     snmpbulkwalk is an SNMP application that uses  SNMP  GETBULK
     requests to query a network entity efficiently for a tree of

     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 GETBULK  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, snmpbulkwalk will search MIB-2.

     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 snmpbulkwalk  to  loop  indefinitely.   By
             default,  snmpbulkwalk tries to detect this behavior
             and warns you when it hits  an  agent  acting  ille-
             gally.  Use -Cc to turn off this behaviour.

     -Ci     Include the given OID in the search range.  Normally
             snmpbulkwalk uses GETBULK requests starting with the
             OID you specified and returns all results in the MIB
             tree after 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.

             Set  the  non-repeaters  field  in the GETBULK PDUs.
             This specifies the number of supplied variables that
             should not be iterated over.  The default is 0.

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

SunOS 5.11           Last change: 17 Jun 1998                   1

Net-SNMP                                          SNMPBULKWALK(1)

             Set the max-repetitions field in the  GETBULK  PDUs.
             This specifies the maximum number of iterations over
             the repeating variables.  The default is 10.

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

     The command:

     snmpbulkwalk -v2c -Os -c public 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

     In contrast to snmpwalk, this information will typically  be
     gathered in a single transaction with the agent, rather than
     one transaction per variable found.   snmpbulkwalk  is  thus
     more efficient in terms of network utilisation, which may be
     especially important when retrieving large tables.

     As the name implies, snmpbulkwalk utilizes the SNMP  GETBULK
     message, which is not available in SNMP v1.

     See   attributes(5)   for   descriptions  of  the  following

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

SunOS 5.11           Last change: 17 Jun 1998                   2

Net-SNMP                                          SNMPBULKWALK(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

SunOS 5.11           Last change: 17 Jun 1998                   3