78 lines
2.8 KiB
Modula-2
78 lines
2.8 KiB
Modula-2
.\" 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.
|
|
.\" ******************************************************************/
|
|
.TH SNMPDF 1 "28 Jan 2013" VVERSIONINFO "Net-SNMP"
|
|
.SH NAME
|
|
snmpdf - display disk space usage on a network entity via SNMP
|
|
.SH SYNOPSIS
|
|
.B snmpdf
|
|
[COMMON OPTIONS] [\-Cu] [\-Ch] AGENT
|
|
.SH DESCRIPTION
|
|
.B 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.
|
|
.PP
|
|
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
|
|
.I snmpcmd(1)
|
|
manual page for a full list of the possible formats for AGENT.
|
|
.PP
|
|
See the
|
|
.I snmpd.conf(5)
|
|
manual page on setting up the dskTable using the
|
|
.I disk
|
|
directive in the snmpd.conf file.
|
|
.SH "OPTIONS"
|
|
.TP 8
|
|
.B COMMON OPTIONS
|
|
Please see
|
|
.I snmpcmd(1)
|
|
for a list of possible values for COMMON OPTIONS
|
|
as well as their descriptions.
|
|
.TP
|
|
.B \-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.
|
|
.TP
|
|
.B \-Ch
|
|
Print sizes in human readable format (i.e. MiB, GiB, TiB)
|
|
.TP
|
|
.B \-CH
|
|
Print sizes in human readable SI format (i.e. MB, GB, TB)
|
|
.SH "EXAMPLES"
|
|
.PP
|
|
% snmpdf \-v 2c \-c public localhost
|
|
.PP
|
|
.nf
|
|
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%
|
|
.fi
|
|
.SH "SEE ALSO"
|
|
snmpd.conf(5), snmp.conf(5)
|