SNMPWALK(1)

NAME
snmpwalk - communicates with a network entity using SNMP GET Next Requests.

SYNOPSIS
snmpwalk [ -d ] [ -V ] [ -q ] [ -p Port ] [ -r retries ] [ -t timeout ] [ -1 ] [ -2 ] host community [ variable-name ]

DESCRIPTION
Snmpwalk is an SNMP application that uses GET NEXT Requests to query for a tree of information about a network entity.

The host specification may be either a host name or an internet address specified in "dot notation"

community is the community for the requests.

A variable may also be given on the command line. This variable specifies which portion of the object identifier space will be searched using GET NEXT Requests. All variables in the subtree below the given variable are queried and their values presented to the user.

If the "variable-name" argument is not present, snmpwalk will search MIB-2 (.1.3.6.1.2.1).

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, a message will be displayed:

End of MIB.

Adding a "-d" to the argument list will cause the application to dump input and output packets.

The "-V" flag returns the version of the app, and the version of the SNMP library used.

The "-q" flag causes the output oids to all be full dotted notation, rather than the verbose translation done via the MIBFile.

The "-p" flag allows an alternate port to be used for SNMP transactions.

The "-r" flag sets the number of retries. The default is 4.

The "-t" flag sets the timeout in microseconds. The default is 1000000.

The "-1" and "-2" flags set the SNMP version of the outgoing request.

EXAMPLES
% snmpwalk snmp-example.net.cmu.edu public system

returns

Name: mib2.system.sysDescr.0 -> DisplayString : Unix 4.3BSD
Name: mib2.system.sysObjectID.0 -> Object Identifier : enterprises.3.1.1
Name: mib2.system.sysUpTime.0 -> Timeticks : (85305426) 9 days, 20:57:34

% snmpwalk -s snmp-example.net.cmu.edu public system

returns

Name: .1.3.6.1.2.1.1.1.0 -> DisplayString : Unix 4.3BSD
Name: .1.3.6.1.2.1.1.2.0 -> Object Identifier : enterprises.3.1.1
Name: .1.3.6.1.2.1.1.3.0 -> Timeticks : (85305426) 9 days, 20:57:34

ENVIRONMENT
MIBFILE: Location of the SNMP MIB.

FILES
mib.txt                   First MIB tried if env. var is not set
/etc/mib.txt              Second MIB tried if env. var is not set

RFCS
Related RFCs: 1065, 1066, 1067
Related SNMPv2 RFCs: 1901, 1902, 1902, 1904, 1905, 1906, 1907, 1908, 1909

RELATED URLS
CMU Networking Group: http://www.net.cmu.edu/
CMU SNMP Home Page: http://www.net.cmu.edu/projects/snmp

SEE ALSO
snmpdelta(1), snmpget(1), snmpgetnext(1), snmpset(1), snmpstatus(1), snmptest(1), snmptranslate(1), snmptrap(1), snmptrap2(1), snmptrapd(1), snmpwalk(1)