snmpbulkwalk

Query for a tree of information about a network entity

Syntax:

snmpbulkwalk [-d] [-p port] -v 1 host community 
             [variable_name]

snmpbulkwalk [-d] [-p port] [-v 2] host noAuth 
             [variable_name]

snmpbulkwalk [-d] [-p port] [-v 2] host srcparty 
             dstparty context [variable_name]

Runs on:

Neutrino

Options:

-d

Dump input and output packets.

-p port

Specify the destination port number.

-v 1|2

SNMP version (default is 2).

community

The community name for the transaction with the remote system.

context

The collection of object resources that can be queried by the dstparty.

dstparty

The name of the party providing the information.

host

An Internet address specified in dot notation or a host name.

srcparty

The name of the party requesting information.

variable_name

The portion of the object identifier space that's searched using BULK requests. The snmpbulkwalk utility queries all variables in the subtree below the given variable and displays their values. Specify variable_name in the format specified in the file mib.txt.

If you don't specify variable_name, snmpbulkwalk searches the entire Internet MIB for host.

Description:

The snmpbulkwalk utility uses BULK requests to query for a tree of information about a network entity (snmpwalk uses GET NEXT requests).

If you're using SNMP version 2, the following files must be configured:

• /etc/acl.conf
• /etc/context.conf
• /etc/party.conf
• /etc/snmpd.conf (required only if you change the default location of your config files)

For a description on how to configure the files please see the file page for each of the configuration files listed above. If you wish to change the location of your configuration files, you must include a snmpd.conf file.

Examples:

Retrieve the variables in the system subtree:

Using SNMPv1

snmpbulkwalk -v 1 netdev-kbox.cc.cmu.edu public system

Using SNMPv2

snmpbulkwalk netdev-kbox.cc.cmu.edu manager_party agent_party agent_context system

The output is similar to:

system.sysDescr.0 = "QNX 425 C, cpu: 586"
system.sysObjectID.0 = OID: enterprises.QNX-Systems.1.1
system.sysUpTime.0 = Timeticks: (8336500) 23:09:25 Current time: Wed Mar 18 14:1
6:59 1998
system.sysContact.0 = "Dave Brown"
system.sysName.0 = ""
system.sysLocation.0 = ""
system.sysServices.0 = 79

Environment variables:

MIBFILE

Specify the location of the mib.txt file. For example, MIBFILE=path/mib.txt (the default path is /etc).

SUFFIX

If SUFFIX exists in your environment, all object IDs with a symbolic name are printed with only the last element. Examples:

This ID:

system.syscontact.0
      

is printed as:

syscontact.0
      

This ID:

udp.udpTable.udpEntry.udpLocalAddress.0.0.0.161
      

is printed as:

udpLocalAddress.0.0.0.161
      

Errors:

If the network entity has an error processing the request packet, an error packet is returned and snmpbulkwalk displays a message to help pinpoint how the request was malformed.

If snmpbulkwalk tries to search beyond the end of the MIB, it displays this message:

End of MIB

See also:

snmpd, snmpget, snmpgetnext, snmpnetstat, snmpset, snmpstatus, snmptest, snmptranslate, snmptrap, snmptrapd

/etc/acl.conf, /etc/context.conf, /etc/mib.txt, /etc/party.conf, /etc/snmpd.conf, /etc/view.conf files

Based on RFC 1065, RFC 1066, RFC 1067,
RFC 1441, RFC 1445, RFC 1446,
RFC 1448, RFC 1449

Marshall T. Rose, The Simple Book: An Introduction to Internet Management, Revised 2nd ed. (Prentice-Hall, 1996, ISBN 0-13-451659-1)