Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SNMPDF(1)			    Net-SNMP			       SNMPDF(1)

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

SYNOPSIS
     snmpdf [COMMON OPTIONS] [-Cu] [-Ch] AGENT

DESCRIPTION
     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 hrStor-
     ageTable is preferred as it typically contains more information.	However,
     the  -Cu  argument  can  be passed to snmpdf to force the usage of the dsk-
     Table.

     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 tar-
     get 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 OP-
	     TIONS 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  pre-
	     ferred 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%

SEE ALSO
     snmpd.conf(5), snmp.conf(5)

V5.9.5.2			   28 Jan 2013			       SNMPDF(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=snmpdf&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help