`snmptest`

monitor and manage information on a network entity

Syntax:

snmptest [-d] [-p port] [-r retry] [-t timeout]
         -v 1 host community

snmptest [-d] [-p port] [-r retry] [-t timeout] 
         [-v 2] host noAuth

snmptest [-d] [-p port] [-r retry] [-t timeout] 
         [-v 2] host srcparty dstparty context

Options:

-d: Dump input and output packets.
-p port: Specify the destination port number.
-r retry: Specify the number of retries.
-t timeout: Specify the timeout (in seconds).
-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 information.
host: An Internet address specified in dot notation or a host name.
srcparty: The name of the party requesting information.

Description:

The snmptest utility monitors and manages information on a network entity.

After you invoke snmptest, you can enter commands at a line interpreter's prompt:

Please enter the variable name:

At this point, you can enter one or more variable names, one per line. If you enter a blank line, snmptest sends a request for each of the variables (in a single packet) to the network entity. See the file mib.txt for the format specification of variable names.

For example (for SNMPv1), if you enter:

snmptest -v 1 netdev-kbox.cc.cmu.edu public

(or for SNMPv2)

snmptest netdev-kbox.cc.cmu.edu manager_party agent_party agent_context

Please enter the variable name: system.sysdescr.0

Please enter the variable name:

then snmptest returns information about the request and reply packets, as well as:

Name: system.sysDescr.0
OCTET STRING- (ascii): Kinetics FastPath2

By default, snmptest sends a GET request packet but you can change this as follows:

In order to:	Enter this command:
Quit the utility.	`$Q`
Send BULK TRANSFER request.	`$B`
Send GET NEXT request.	`$N`
Send GET request.	`$G`
Send INFORM request.	`$I`
Send SET request.	`$S`
Send SNMP2 TRAP.	`$T`
Toggle the dumping of each sent and received packet.	`$D`

If you enter $I, $S, or $T, then snmptest requests information about each variable. First it prompts you for the variable type:

Please enter variable type [a|d|i|n|o|s|t|x]:

If the variable is:	Enter:
ip address	`a`
string	`d`
integer	`i`
null	`n`
object id	`o`
string	`s`
timeticks	`t`
string	`x`

After you enter a character, snmptest prompts you for a value:

Please enter new value:

For this variable type:	Enter:
integer	Integer in decimal.
ipaddress	IP address in the standard internet dot notation.
object id	Object ID in dotted numeric notation.
string	Whitespace-delimited decimal numbers, one per byte of the string.
timeticks	Integer in decimal.

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 ``Administrative model'' section in the SNMPv2 chapter, and 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.

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 will be printed with only the last element. Examples:

This ID:

system.syscontact.0

will be printed as:

syscontact.0