NAME

snmplookup − SNMP interactive querying application

SYNOPSIS

snmplookup

DESCRIPTION

snmplookup is an application to allow the interactive querying of Internet network entities running the Simple Network Management Protocol.  Once started up, snmplookup will prompt the user for commands (see section COMMANDS below), and act upon the commands issued by the user. 

COMMANDS

-? or help: print the standard help message, which lists legal commands in snmplookup. 

-agent agent: set the agent for all future queries to the agent agent where agent is a dot notation address (eg: ’128.84.248.254’) or host name.  This command simply sets an internal variable - it will not check the validity of agent. 

-community community_name: set the community_name for querying to community_name.  community_name should be a string of ASCII characters. 

-prefix snmp_mib_subtree: Positions the user in a subtree of the MIB.  Queries to an agent can be specified with variable names beginning at the subtree location.  The prefix will be prepended to the variable requested. 

-retry maxretries: set the number of times to retry in the event of a receive failure to maxretries, where maxretries is an integer quantity.  Note that this is the number of times to retry a receive, not the number of times to try. In other words, setting it to 1 will cause two tries etc. 

-timeout seconds: set the timeout for both send and receive attempts to seconds seconds, with seconds being an integer quantity. There is no way currently to specify a separate timeout for send and receive attempts. 

-query variable: query the remote agent (set by the agent command above) for the value of variable variable.  snmplookup will print out the name of the variable received, together with the value of the variable. If the value is an integer, both the octal and decimal representations of the value will be printed out. If the value is a character string, that character string will be printed out.  Variables used must start with ’_mgmt_mib’: for example to get information on ’_iso_org_dod_internet_mgmt_mib_system_sysDescr_0’, query for the variable ’_mgmt_mib_system_sysDescr_0’. 

-mquery variable_class: query for the values of all instances of the variable class variable_class.  As with the query command, variable classes such as ’_mgmt_mib_interfaces_ifTable_ifEntry_ifSpeed’ must begin with ’_mgmt_mib’. 

-display: display settings for gateway,community id, maxretries and timeout. 

-^D or quit: leave snmplookup.  Note that ’q’ does not work. 

FILES

/etc/snmp.variablesdefault variable initfile

SEE ALSO

J.D. Case, J.R. Davin, M.S. Fedor, M.L. Schoffstall, Simple Network Management Protocol, Request for Comments 1157, Network Information Center, SRI International, Menlo Park, California, May, 1990.  M.T. Rose, K. McCloghrie, Structure of Management Information, Request for Comments 1155, Network Information Center, SRI International, Menlo Park, California, May, 1990.  K. McCloghrie, M.T. Rose, Management Information Base, Request for Comments 1156, Network Information Center, SRI International, Menlo Park, California, May, 1990.  M.T. Rose, Editor Management Information Base: MIB-II, Request for Comments 1158, Network Information Center, SRI International, Menlo Park, California, May, 1990. 

NEWS-OSRelease 4.2.1R