---
name: "snmpstatus"
section: "1"
platform: "linux"
package: "net-snmp"
version: "5.9.5.2-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/snmpstatus"
---

# snmpstatus(1)

retrieves a fixed set of management information from a network entity

## NAME

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

## SYNOPSIS

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

## 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)](/snmpcmd/1.md)* 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

- **COMMON OPTIONS**

  Please see *[snmpcmd(1)](/snmpcmd/1.md)* for a list of possible values for COMMON OPTIONS as well as their descriptions.

- **-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

[snmpcmd(1)](/snmpcmd/1.md), [snmpget(1)](/snmpget/1.md)