1SNMPDF(1)                          Net-SNMP                          SNMPDF(1)
2
3
4

NAME

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

SYNOPSIS

9       snmpdf [COMMON OPTIONS] [-Cu] AGENT
10

DESCRIPTION

12       snmpdf  is  simply  a  networked verison of the typical df command.  It
13       checks the disk space on the remote  machine  by  examining  the  HOST-
14       RESOURCES-MIB's  hrStorageTable  or  the  UCD-SNMP-MIB's  dskTable.  By
15       default, the hrStorageTable is preferred as it typically contains  more
16       information.   However,  the  -Cu  argument  can be passed to snmpdf to
17       force the usage of the dskTable.
18
19       AGENT identifies a target SNMP agent, which is instrumented to  monitor
20       the  gievn objects.  At its simplest, the AGENT specification will con‐
21       sist of a hostname or an IPv4 address.  In this situation, the  command
22       will  attempt  communication with the agent, using UDP/IPv4 to port 161
23       of the given target host. See the snmpcmd(1) manual  page  for  a  full
24       list of the possible formats for AGENT.
25
26       See  the snmpd.conf(5) manual page on setting up the dskTable using the
27       disk directive in the snmpd.conf file.
28

OPTIONS

30       COMMON OPTIONS
31               Please see snmpcmd(1) for a list of possible values for  COMMON
32               OPTIONS as well as their descriptions.
33
34       -Cu     Forces  the command to use dskTable in mib UCD-SNMP-MIB instead
35               of the default to determine the storage information. Generally,
36               the  default use of hrStorageTable in mib HOST-RESOURCES-MIB is
37               preferred because it typically contains more information.
38

EXAMPLES

40       % snmpdf -v 2c -c public localhost
41
42       Description       size (kB)         Used    Available Used%
43       /                   7524587      2186910      5337677   29%
44       /proc                     0            0            0    0%
45       /etc/mnttab               0            0            0    0%
46       /var/run            1223088           32      1223056    0%
47       /tmp                1289904        66848      1223056    5%
48       /cache               124330         2416       121914    1%
49       /vol                      0            0            0    0%
50       Real Memory          524288       447456        76832   85%
51       Swap Space          1420296       195192      1225104   13%
52

SEE ALSO

54       snmpd.conf(5), snmp.conf(5)
55
56
57
584th Berkeley Distribution         25 Jul 2003                        SNMPDF(1)