SNMPSTATUS(1)

📦
version 5.9.5.2 · 6 versions
, in alpine 3.23, alpine 3.24, arch rolling, fedora 44, nixos 26.05, nixpkgs unstable, ubuntu stonking

💖 SNMPSTATUS 💖

okay bestie, so this is snmpstatus, and it lives in the Net-SNMP family. Think of it as the girl who shows up to the party, grabs exactly the seven things she came for, and leaves. No scrolling, no vibes-based wandering. It grabs a fixed set of management information from a network entity and that is literally the whole job. 🎀

✨ SYNOPSIS ✨

snmpstatus [COMMON OPTIONS] [-Cf] AGENT

🌸 DESCRIPTION 🌸

snmpstatus is an SNMP application that pulls several important statistics off a network entity. She's not nosy, she's focused. 🦋

So AGENT identifies a target SNMP agent, and that agent is instrumented to monitor the given objects. At its simplest? AGENT is just a hostname or an IPv4 address, periodt. When you give it one of those, the command will attempt communication with the agent using UDP/IPv4 to port 161 of the given target host. Easy.

For the full list of possible formats for AGENT, go check snmpcmd(1) — she has the receipts. 💅

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

ngl, look at her go. ✨

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!

😭 the drama. the honesty.

Now here's the important bit. 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. So bestie, just know: she fixes what she can, but that one variable is ghosting you. 👻

🎀 OPTIONS 🎀

💜 COMMON OPTIONS

Please see snmpcmd(1) for a list of possible values for COMMON OPTIONS as well as their descriptions. She's got the whole menu, iykyk.

💜 -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. No retries, no healing era, we simply stop. 💀

🌈 SEE ALSO 🌈

snmpcmd(1), snmpget(1)

and that's the whole page, bestie 🫶 this one's from Net-SNMP, version V5.9.5.2, dated 25 Jul 2003 — an icon, an absolute legend, and she still hits different. mwah 💋👑

📦 where this page comes from