snmpdf (1)
Leading comments
Portions of this file are subject to the following copyright. See the Net-SNMP's COPYING file for more details and other copyrights that may apply: /*********************************************************** Portions of this file are copyrighted by: Copyright Copyright 2003 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms specified in the COPYING file distributed with the Net-SNMP package. ******************************************************************/
NAME
snmpdf - display disk space usage on a network entity via SNMPSYNOPSIS
snmpdf [COMMON OPTIONS] [-Cu] [-Ch] AGENTDESCRIPTION
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) 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 is preferred because it typically contains more information.
- -Ch
- Print sizes in human readable format (i.e. MiB, GiB, TiB)
- -CH
- Print sizes in human readable SI format (i.e. MB, GB, TB)
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%