This document is a Mac OS X manual page. Manual pages are a command-line technology for providing documentation. You can view these manual pages locally using the man(1) command. These manual pages come from many different sources, and thus, have a variety of writing styles.

For more information about the manual page format, see the manual page for manpages(5).

SNMPDF(1)                                         Net-SNMP                                         SNMPDF(1)



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

SYNOPSIS
       snmpdf [COMMON OPTIONS] [-Cu] AGENT

DESCRIPTION
       snmpdf  is  simply  a  networked  verison 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  gievn  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.

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

OPTIONS
       COMMON OPTIONS
               Please see snmpcmd(1) for a list of possible values for  COMMON  OPTIONS  as  well  as  their
               descriptions.

       -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 HOST-RESOURCESMIB
               MIB is preferred because it typically contains more information.

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
       snmpd.conf(5), snmp.conf(5)



4th Berkeley Distribution                        25 Jul 2003                                       SNMPDF(1)