1SNMPBULKGET(1) Net-SNMP SNMPBULKGET(1)
2
3
4
6 snmpbulkget - communicates with a network entity using SNMP GETBULK re‐
7 quests.
8
10 snmpbulkget [COMMON OPTIONS] [-Cn <num>] [-Cr <NUM>] AGENT OID [OID]...
11
13 snmpbulkget is an SNMP application that uses the SNMP GETBULK request
14 to query a network entity efficiently for information. One or more ob‐
15 ject identifiers (OIDs) may be given as arguments on the command line.
16 Each variable name is given in the format specified in variables(5).
17
18 If the network entity has an error processing the request packet, an
19 error packet will be returned and a message will be shown, helping to
20 pinpoint why the request was malformed.
21
23 -Cn<NUM>
24 Set the non-repeaters field in the GETBULK PDU. This specifies
25 the number of supplied variables that should not be iterated
26 over. The default is 0.
27
28 -Cr<NUM>
29 Set the max-repetitions field in the GETBULK PDU. This speci‐
30 fies the maximum number of iterations over the repeating vari‐
31 ables. The default is 10.
32
33 In addition to these options, snmpbulkget takes the common options de‐
34 scribed in the snmpcmd(1) manual page. Note that snmpbulkget REQUIRES
35 an argument specifying the agent to query and at least one OID argu‐
36 ment, as described there.
37
39 The command:
40
41 snmpbulkget -v2c -Cn1 -Cr5 -Os -c public zeus system ifTable
42
43 will retrieve the variable system.sysDescr.0 (which is the lexicograph‐
44 ically next object to system) and the first 5 objects in the ifTable:
45
46 sysDescr.0 = STRING: "SunOS zeus.net.cmu.edu 4.1.3_U1 1 sun4m"
47 ifIndex.1 = INTEGER: 1
48 ifIndex.2 = INTEGER: 2
49 ifDescr.1 = STRING: "lo0"
50 et cetera.
51
53 As the name implies, snmpbulkget utilizes the SNMP GETBULK message,
54 which is not available in SNMPv1.
55
57 snmpcmd(1), variables(5), RFC 1905.
58
59
60
61V5.9.1 01 May 2002 SNMPBULKGET(1)