1 .\" /***********************************************************
2 .\" Copyright 1988, 1989 by Carnegie Mellon University
4 .\" All Rights Reserved
6 .\" Permission to use, copy, modify, and distribute this software and its
7 .\" documentation for any purpose and without fee is hereby granted,
8 .\" provided that the above copyright notice appear in all copies and that
9 .\" both that copyright notice and this permission notice appear in
10 .\" supporting documentation, and that the name of CMU not be
11 .\" used in advertising or publicity pertaining to distribution of the
12 .\" software without specific, written prior permission.
14 .\" CMU DISCLAIMS ALL WARRANTIES WITH REGARD TO THIS SOFTWARE, INCLUDING
15 .\" ALL IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS, IN NO EVENT SHALL
16 .\" CMU BE LIABLE FOR ANY SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR
17 .\" ANY DAMAGES WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS,
18 .\" WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION,
19 .\" ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS
21 .\" ******************************************************************/
22 .TH SNMPTEST 1 "08 Feb 2002" VVERSIONINFO "Net-SNMP"
25 snmptest - communicates with a network entity using SNMP requests
31 is a flexible SNMP application that can monitor and manage information
34 After invoking the program, a command line interpreter proceeds to
35 accept commands. It will prompt with:
39 At this point you can enter one or more variable names, one per line.
40 A blank line is a command to send a request for each of the variables
41 (in a single packet) to the remote entity. Each variable name is given
42 in the format specified in
46 snmptest -c public -v 1 zeus
48 .BR Variable: " system.sysDescr.0"
52 will return some information about the request and reply packets, as
53 well as the information:
55 requestid 0x5992478A errstat 0x0 errindex 0x0
57 system.sysDescr.0 = STRING: "Unix 4.3BSD"
59 Upon startup, the program defaults to sending a GET request packet.
60 This can be changed to a GETNEXT request or a SET request by typing
61 the commands "$N" or "$S" respectively. Typing "$G" will go back to
64 The command "$D" will toggle the dumping of each sent and received packet.
66 The command "$QP" will toggle a quicker, less verbose output form.
68 When in the "SET request" mode, more information is requested by the prompt for each variable. The prompt:
70 .B Type [i|s|x|d|n|o|t|a]:
72 requests the type of the variable be entered. Type "i" for an
73 integer, "s" for an octet string in ASCII, "x" for an octet string as
74 hex bytes separated by whitespace, "d" for an octet string as decimal
75 bytes separated by whitespace, , "a" for an ip address in dotted IP
76 notation, and "o" for an object identifier. At this point a value
81 If this is an integer value, just type the integer (in decimal). If
82 it is a decimal string, type in white-space separated decimal numbers,
83 one per byte of the string. Again type a blank line at the prompt for
84 the variable name to send the packet.
86 At the variable name line, typing "$Q" will quit the program.
89 takes the common options described in the
93 snmpcmd(1), snmpget(1), snmpset(1), variables(5)