snmpstatus

retrieve information from a network entity

Syntax:

snmpstatus [-d] host [community]

Options:

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

Description:


Note: This utility has been deprecated in SNMP version 2.

The snmpstatus utility retrieves these statistics from a network entity:

Statistic Variable
IP address of the entity -
textual description of the entity sysDescr.0
uptime of the entity sysUpTime.0
sum of received packets on all interfaces ifInU - CastPkts.* + ifInNUCastPkts.*
sum of transmitted packets on all interfaces ifOutU - CastPkts.* + ifOutNUCastPkts.*
number of IP input packets ipInReceives.0
number of IP output packets ipOutRequests.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!

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

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.

Caveats:

This utility has been deprecated; it works only with SNMP version 1. If you need similar functionality with SNMPv2, you should do the snmpget commands separately.

See also:

snmpd, snmpget, snmpgetnext, snmpnetstat, snmptest, snmptrap, snmptrapd, snmpwalk

/etc/mib.txt file

RFC 1065, RFC 1066, RFC 1067

Marshall T. Rose, The Simple Book: An Introduction to Internet Management, Revised 2nd ed. (Prentice-Hall, 1996, ISBN 0-13-451659-1)