snmpstatus

retrieve information from a network entity

Syntax:

snmpstatus [-d] host [community]

Options:

-d
Dump input and output packets.
host
An Internet address specified in dot notation or a host name.
community
The community name for the transaction with the remote system (default is public).

Examples:

This command:

snmpstatus netdev-kbox.cc.cmu.edu public

produces output similar to:

[128.2.56.220]=>[Kinetics FastPath2] Up: 1 day, 4:43:31 

IF recv/trans packets 262874/39867 | IP recv/trans packets
31603/15805

Description:

The snmpstatus utility retrieves these statistics from a network entity:

Statistic:Variable:
IP address of the entity-
textual description of the entitysysDescr.0
uptime of the entitysysUpTime.0
sum of received packets on all interfacesifInU - CastPkts.* + ifInNUCastPkts.*
sum of transmitted packets on all interfacesifOutU - CastPkts.* + ifOutNUCastPkts.*
number of IP input packetsipInReceives.0
number of IP output packetsipOutRequests.0

The snmpstatus utility also checks the operational status of all interfaces (ifOperStatus.*), and if it finds any interfaces that aren't running, it displays a report similar to:

2 interfaces are down!

Errors:

If the network entity has an error processing the request packet, an error packet is returned and snmpstatus displays a message to help pinpoint how the request was malformed. If you've specified other variables, snmpstatus resends the request without the variable that caused the problem.

See also:

snmpd, snmpget, snmpgetnext, snmpnetstat, snmptest, snmptrap, snmptrapd, snmpwalk, mib.txt file

RFC 1065, RFC 1066, RFC 1067

Marshall T. Rose, The Simple Book: An Introduction to Internet Management, 2nd ed. (Prentice-Hall, 1994, ISBN 0-13-177254-6)