Go to main content

man pages section 1: User Commands

Exit Print View

Updated: Thursday, March 14, 2019
 
 

snmpbulkget (1)

Name

snmpbulkget - communicates with a network entity using SNMP GETBULK requests.

Synopsis

snmpbulkget [COMMON OPTIONS] [-Cn <num>] [-Cr <NUM>] AGENT OID [OID]...

Description

SNMPBULKGET(1)                     Net-SNMP                     SNMPBULKGET(1)



NAME
       snmpbulkget  -  communicates  with  a network entity using SNMP GETBULK
       requests.

SYNOPSIS
       snmpbulkget [COMMON OPTIONS] [-Cn <num>] [-Cr <NUM>] AGENT OID [OID]...

DESCRIPTION
       snmpbulkget is an SNMP application that uses the SNMP  GETBULK  request
       to  query  a  network  entity efficiently for information.  One or more
       object identifiers (OIDs) may be given  as  arguments  on  the  command
       line.   Each  variable  name  is given in the format specified in vari-
       ables(5).

       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.

OPTIONS
       -Cn<NUM>
               Set the non-repeaters field in the GETBULK PDU.  This specifies
               the  number  of  supplied variables that should not be iterated
               over.  The default is 0.

       -Cr<NUM>
               Set the max-repetitions field in the GETBULK PDU.  This  speci-
               fies  the maximum number of iterations over the repeating vari-
               ables.  The default is 10.

       In addition to these options,  snmpbulkget  takes  the  common  options
       described  in  the  snmpcmd(1)  manual  page.   Note  that  snmpbulkget
       REQUIRES  an argument specifying the agent to query and  at  least  one
       OID argument, as described there.

EXAMPLE
       The command:

       snmpbulkget -v2c -Cn1 -Cr5 -Os -c public zeus system ifTable

       will retrieve the variable system.sysDescr.0 (which is the lexicograph-
       ically next object to system) and the first 5 objects in the ifTable:

       sysDescr.0 = STRING: "SunOS zeus.net.cmu.edu 4.1.3_U1 1 sun4m"
       ifIndex.1 = INTEGER: 1
       ifIndex.2 = INTEGER: 2
       ifDescr.1 = STRING: "lo0"
       et cetera.

NOTE
       As the name implies, snmpbulkget utilizes  the  SNMP  GETBULK  message,
       which is not available in SNMPv1.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


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



NOTES
       This     software     was    built    from    source    available    at
       https://github.com/oracle/solaris-userland.   The  original   community
       source  was  downloaded  from   http://ftp.ntua.gr/mirror/net-snmp/net-
       snmp/5.7.3/net-snmp-5.7.3.tar.gz

       Further information about this software can be found on the open source
       community website at http://www.net-snmp.org/.



V5.7.3                            01 May 2002                   SNMPBULKGET(1)