SNMP(1C)SNMP(1C)NAMEsnmp - a client for communicating with SNMP servers (agents)
SYNOPSISsnmp [-d] [-n] [-a agent] [-c community] [-r retries] [-t timeout]
[command] server [vars...]
DESCRIPTION
The snmp program is a tool for sending queries to servers (agents)
implementing the Simple Network Management Protocol (SNMP). An SNMP
agent supports a management information base (MIB) consisting of a set
of variables layed out in a tree. The variables and their types are
defined using ASN.1, and are listed in /etc/snmp.mib.
Using snmp, one can inquire about the status of a remote system and
obtain information about its current state. The two most basic
commands are get and getnext, which will return the value of a list of
variables. There are also a number of status commands that will issue
a sequence of get queries and present the returned information in a
more readable form.
The SNMP variables can be specified both in symbolic form as well as
numeric. Unless prefixed with a dot, they are all presumed to start at
the iso.org.dod.internet.mgmt.mib (1.3.6.1.2.1) level.
OPTIONS-d Debug mode.
-a agent
Sets the server to be queried to the specified name. There is
no default server.
-c community
Sets the community to use in all queries to the specified
string. The default community is ``public''.
-r retries
Sets the number of retries that should be attempted for each
query. The default number of retries is implementation
specific.
-t timeout
Sets the timeout for each retry to the specified number of
seconds. The default timeout is implementation specific.
COMMANDS
get variable [...]
Inquire the value of the given variable from the server.
Variables may be listed both in symbolic as well as numeric
form. The reply is presented in two columns, with the variable
first followed by a tab and its value.
getnext variable [...]
Same as the get command above, except that the variable names
returned will be those of the argument variable. This can be
used to traverse a certain subtree of the management hierarchy
(see also the walk command, below).
help Print a list of all recognized commands.
ip-status
Query the remote server for its IP related variables and present
them in a readable form.
quit Exit from running the snmp program. Returns to the calling
program, usually the shell.
status Query the remote server for its system and interface related
variables and present them in a readable form.
tcp-status
Query the remote server for its TCP related variables and
present them in a readable form.
udp-status
Query the remote server for its UCP related variables and
present them in a readable form.
walk variable [...]
Repeatedly issue getnext commands until all variables of the
specified subtree have been returned.
EXAMPLES
% snmp status localhost
% snmp get localhost system.sysdescr.0
% snmp localhost
snmp> get system.sysdescr.0
snmp> getnext system.sysdescr.0
snmp> walk system
snmp> quit
SEE ALSOsnmpnetstat(1), snmpd(8), RFC1155, RFC1156, RFC1157, RFC1158.
BUGS
The set command has not yet been implemented, so it is currently
impossible to do any changes to the remote MIB.
The snmp client cannot distinguish between a network entity that has no
agent running and one that does not allow access to it.
3 June 1992 SNMP(1C)