snmpdf(1M) System Administration Commands snmpdf(1M)NAMEsnmpdf - get a listing of disk space usage on a remote machine by means
of SNMP
SYNOPSIS
/usr/sfw/bin/snmpdf [common options] [-Cu] agent
DESCRIPTION
The snmpdf command is a networked verison of the df(1M) 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 than the dskTable. However, the -Cu argument can be passed
to snmpdf to force the usage of dskTable.
The agent operand identifies a target SNMP agent, which is instrumented
to monitor specified objects. At its simplest, the agent specification
consists of a host name or an IPv4 address. In this situation, the com‐
mand attempts communication with the agent using UDP/IPv4 to port 161
of the target host.
See the snmpcmd(1M) manual page for a full list of the possible formats
for agent.
See the snmpd.conf(4) manual page for guidance on setting up dskTable
using the disk directive in the snmpd.conf file.
OPTIONS
The following options are supported:
common options
See snmpcmd(1M) for a list of possible values for common options,
as well as their descriptions.
-Cu
Forces the command to use dskTable in UCD-SNMP-MIB instead of the
default to determine the storage information. Generally, the
default use of hrStorageTable in HOST-RESOURCES-MIB is preferred
because it usually contains more information than dskTable.
EXAMPLES
Example 1: Obtaining Disk Usage of a Remote System
The following command returns a display of the disk usage of a remote
system.
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%
ATTRIBUTES
See attributes(5) for descriptions of the following attributes:
┌─────────────────────────────┬─────────────────────────────┐
│ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
├─────────────────────────────┼─────────────────────────────┤
│Availability │SUNWsmcmd │
├─────────────────────────────┼─────────────────────────────┤
│Interface Stability │External │
└─────────────────────────────┴─────────────────────────────┘
EXIT STATUS
0
Successful completion.
1
A usage syntax error. A usage message is displayed. Also used for
timeout errors.
2
An error occurred while executing the command. An error message is
displayed.
SEE ALSOdf(1M), snmpcmd(1M), snmp.conf(4), snmpd.conf(4), attributes(5)SunOS 5.10 20 Jan 2004 snmpdf(1M)