SNMPSTATUS(1) Net-SNMP SNMPSTATUS(1)

# [NAME](#NAME)

snmpstatus - retrieves a fixed set of management information from a network entity

# [SYNOPSIS](#SYNOPSIS)

**snmpstatus** \[COMMON OPTIONS] \[-Cf] AGENT

# [DESCRIPTION](#DESCRIPTION)

**snmpstatus** is an SNMP application that retrieves several important statistics from a network entity.

AGENT identifies a target SNMP agent, which is instrumented to monitor the given objects. At its simplest, the AGENT specification will consist of a hostname or an IPv4 address. In this situation, the command will attempt communication with the agent, using UDP/IPv4 to port 161 of the given target host.

See the [*snmpcmd(1)*](/man/os/net-snmp/snmpcmd.1) manual page for a full list of the possible formats for AGENT.

The information returned is:

The IP address of the entity.  
A textual description of the entity (sysDescr.0)  
The uptime of the entity's SNMP agent (sysUpTime.0)  
The sum of received packets on all interfaces (ifInUCastPkts.* + ifInNUCastPkts.\*)  
The sum of transmitted packets on all interfaces (ifOutUCastPkts.* + ifOutNUCastPkts.\*)  
The number of IP input packets (ipInReceives.0)  
The number of IP output packets (ipOutRequests.0)

For example:

snmpstatus -c public -v 1 netdev-kbox.cc.cmu.edu

will produce output similar to the following:

\[128.2.56.220]=>\[Kinetics FastPath2] Up: 1 day, 4:43:31  
Interfaces: 1, Recv/Trans packets: 262874/39867 | IP: 31603/15805

**snmpstatus** also checks the operational status of all interfaces (ifOperStatus.\*), and if it finds any that are not running, it will report in a manner similar to this:

2 interfaces are down!

If the network entity has an error processing the request packet, an error packet will be returned and a message will be shown, helping to pinpoint in what way the request was malformed. **snmpstatus** will attempt to reform its request to eliminate the malformed variable (unless the **-Cf** option is given, see below), but this variable will then be missing from the displayed data.

# [OPTIONS](#OPTIONS)

[**COMMON OPTIONS**](#COMMON)

Please see [*snmpcmd(1)*](/man/os/net-snmp/snmpcmd.1) for a list of possible values for COMMON OPTIONS as well as their descriptions.

[**-Cf**](#Cf)

By default, snmpstatus will try to fix errors returned by the agent and retry a request. In this situation, the command will display the data that it can. If the -Cf option is specified, then snmpstatus will not try to fix errors, and the error will cause the command to terminate.

# [SEE ALSO](#SEE_ALSO)

[snmpcmd(1)](/man/os/net-snmp/snmpcmd.1), [snmpget(1)](/man/os/net-snmp/snmpget.1)

25 Jul 2003 V5.9.5.2

---

Document: snmpstatus(1) from net-snmp 5.9.5.2-r12 (Chainguard OS)
Source: https://github.com/net-snmp/net-snmp.git