SNMPDF(1)

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

✨ SNMPDF(1) ✨

okay bestie, gather round, because this is snmpdf from the Net-SNMP crew and it's literally just df but for a whole other machine across the network 💅

🌸 NAME 🌸

snmpdf — display disk space usage on a network entity via SNMP

🎀 SYNOPSIS 🎀

snmpdf [COMMON OPTIONS] [-Cu] [-Ch] AGENT

🦋 DESCRIPTION 🦋

So like, snmpdf is simply a networked version of the typical df command. That's it. That's the whole vibe. It peeks at the disk space on a remote machine by digging through the HOST-RESOURCES-MIB's hrStorageTable or the UCD-SNMP-MIB's dskTable 👑

By default, hrStorageTable is the main character, because it typically contains more information. But if you're feeling a little rebellious, you can pass the -Cu argument to snmpdf and force it to use the dskTable instead. no cap.

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) manual page for a full list of the possible formats for AGENT 📋

Also! See the snmpd.conf(5) manual page on setting up the dskTable using the disk directive in the snmpd.conf file. iykyk.

💖 OPTIONS 💖

  • COMMON OPTIONS — bestie please see snmpcmd(1) for a list of possible values for COMMON OPTIONS as well as their descriptions, I can't do everything for you 🫶
  • -Cu — Forces the command to use dskTable in mib UCD-SNMP-MIB instead of the default to determine the storage information. Generally, the default use of hrStorageTable in mib HOST-RESOURCES-MIB is preferred because it typically contains more information. so like, only do this if you have a reason ✨
  • -Ch — Print sizes in human readable format (i.e. MiB, GiB, TiB) 🧚
  • -CH — Print sizes in human readable SI format (i.e. MB, GB, TB) 🌈

🔥 EXAMPLES 🔥

% snmpdf -v 2c -c public localhost

and boom, out comes this iconic little table:

Description       size (kB)         Used    Available Used%
/                   7524587      2186910      5337677   29%
/proc                     0            0            0    0%
/etc/mnttab               0            0            0    0%
/var/run            1223088           32      1223056    0%
/tmp                1289904        66848      1223056    5%
/cache               124330         2416       121914    1%
/vol                      0            0            0    0%
Real Memory          524288       447456        76832   85%
Swap Space          1420296       195192      1225104   13%

ate. no notes. 👑

🌟 SEE ALSO 🌟

snmpd.conf(5), snmp.conf(5)

lowkey a PSA: Real Memory and Swap Space showing up in a disk table is not a glitch, it's just the storage table doing its thing, so don't come for me 💀

k bye bestie, go check your remote disks, this page was brought to you by version V5.9.5.2 and it's dated 28 Jan 2013 💖 slay, stay hydrated, and always read your man pages 🎀

📦 where this page comes from