SNMPTEST(1)							     Net-SNMP							       SNMPTEST(1)

NAME

       snmptest - communicates with a network entity using SNMP requests

SYNOPSIS

       snmptest [COMMON OPTIONS]

DESCRIPTION

       snmptest is a flexible SNMP application that can monitor and manage information on a network entity.

       After invoking the program, a command line interpreter proceeds to accept commands.  It will prompt with:

       Variable:

       At  this  point	you can enter one or more variable names, one per line.  A blank line is a command to send a request for each of the vari-
       ables (in a single packet) to the remote entity. Each variable name is given in the format specified in variables(5).  For example:

       snmptest -c public -v 1 zeus
       Variable: system.sysDescr.0
       Variable:

       will return some information about the request and reply packets, as well as the information:

       requestid 0x5992478A errstat 0x0 errindex 0x0
       system.sysDescr.0 = STRING: "Unix 4.3BSD"

       Upon startup, the program defaults to sending a GET request packet.  This can be changed to a GETNEXT request or a SET  request	by  typing
       the commands "$N" or "$S" respectively.	Typing "$G" will go back to the GET request mode.

       The command "$D" will toggle the dumping of each sent and received packet.

       The command "$QP" will toggle a quicker, less verbose output form.

       When in the "SET request" mode, more information is requested by the prompt for each variable.  The prompt:

       Type [i|s|x|d|n|o|t|a]:

       requests  the  type  of the variable be entered.  Type "i" for an integer, "s" for an octet string in ASCII, "x" for an octet string as hex
       bytes separated by whitespace, "d" for an octet string as decimal bytes separated by whitespace, , "a" for an ip address in dotted IP nota-
       tion, and "o" for an object identifier.	At this point a value will be prompted for:

       Value:

       If this is an integer value, just type the integer (in decimal).  If it is a decimal string, type in white-space separated decimal numbers,
       one per byte of the string.  Again type a blank line at the prompt for the variable name to send the packet.

       At the variable name line, typing "$Q" will quit the program.

OPTIONS

       snmptest takes the common options described in the snmpcmd(1) manual page.

SEE ALSO

       snmpcmd(1), snmpget(1), snmpset(1), variables(5)

4th Berkeley Distribution					    08 Feb 2002 						       SNMPTEST(1)