snmpdf(1M)						  System Administration Commands						snmpdf(1M)

NAME

       snmpdf - 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 specifica-
       tion consists of a host name or an IPv4 address. In this situation, the command 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 ALSO

       df(1M), snmpcmd(1M), snmp.conf(4), snmpd.conf(4), attributes(5)

SunOS 5.10							    20 Jan 2004 							snmpdf(1M)