SNMPDF(1) Net-SNMP SNMPDF(1)

# [NAME](#NAME)

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

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#DESCRIPTION)

**snmpdf** is simply a networked version of the typical df command. It checks the disk space on the remote machine by examining the HOST-RESOURCES-MIB's hrStorageTable or the UCD-SNMP-MIB's dskTable. By default, the hrStorageTable is preferred as it typically contains more information. However, the -Cu argument can be passed to snmpdf to force the usage of the dskTable.

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.

See the [*snmpd.conf(5)*](/man/os/net-snmp/snmpd.conf.5) manual page on setting up the dskTable using the *disk* directive in the snmpd.conf file.

# [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.

[**-Cu**](#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.

[**-Ch**](#Ch)

Print sizes in human readable format (i.e. MiB, GiB, TiB)

[**-CH**](#CH)

Print sizes in human readable SI format (i.e. MB, GB, TB)

# [EXAMPLES](#EXAMPLES)

% snmpdf -v 2c -c public localhost

```
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%
```

# [SEE ALSO](#SEE_ALSO)

[snmpd.conf(5)](/man/os/net-snmp/snmpd.conf.5), [snmp.conf(5)](/man/os/net-snmp/snmp.conf.5)

28 Jan 2013 V5.9.5.2

---

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