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

FreeBSD Manual Pages

  
 
  

home | help
NAME
       pdf -- display free disk	space across a group of	machines

SYNOPSIS
       pdf   [-ln]   [-g   nodegroup1,...,nodegroupN]	[-m  size]  [-t	 type]
	   [-w node1,...,nodeN]	[-x node1,...,nodeN] [file | file_system ...]

DESCRIPTION
       pdf displays statistics about the amount	of  free  disk	space  on  the
       specified  file_system or on the	file system of which file is a part on
       all machines in a cluster.  If neither a	file or	a file_system  operand
       is  specified, statistics for all mounted file systems, on all machines
       are displayed (subject to the -w, -x, -g, -m, -l	and -t options below).
       The following options are available:

       -l   Display statistics	only  about  mounted  file  systems  with  the
	    MNT_LOCAL flag set.	 If a non-local	file system is given as	an ar-
	    gument,  a	warning	 is issued and no information is given on that
	    file system.

       -n   Print out the previously obtained statistics from  the  file  sys-
	    tems.   This  option  should be used if it is possible that	one or
	    more file systems are in a state such that they will not  be  able
	    to	provide	 statistics without a long delay.  When	this option is
	    specified, pdf will	not request new	statistics from	the file  sys-
	    tems,  but	will  respond  with the	possibly stale statistics that
	    were previously obtained.

       -g   If the -g option is	specified, followed by a comma separated  list
	    of	group  names,  the  command  will only be run on that group of
	    nodes.  A node may be a part of more than one  group  if  desired,
	    however  running without the -g option will	run the	command	on the
	    same node as many times as it appears in the file specified	by the
	    CLUSTER environment	variable.  This	option is silently ignored  if
	    used with the -w option.

       -m size
	    Is	used  to limit the displayed file systems to only those	with a
	    capacity greater than the user-supplied size argument.   This  can
	    be used to find filesystems	over a given threshold.

       -t type
	    Is	used  to indicate the actions should only be taken on filesys-
	    tems of the	specified type.	 More than one type may	 be  specified
	    in	a  comma  separated list.  The list of filesystem types	can be
	    prefixed with "no" to specify the filesystem types for  which  ac-
	    tion  should  not be taken.	 If a file system is given on the com-
	    mand line that is not of the specified type, a warning  is	issued
	    and	no information is given	on that	file system.

       -w   If	the -w option is specified, followed by	a comma	delimited list
	    of machine names, the command will be run  on  each	 node  in  the
	    list.  Without this	flag, pdf runs on the nodes listed in the file
	    pointed to by the CLUSTER environment variable.

       -x   The	-x option can be used to exclude specific nodes	from the clus-
	    ter.   The	format is the same as the -w option, a comma delimited
	    list of machine names.  This option	is silently  ignored  if  used
	    with the -w	option.

ENVIRONMENT
       pdf utilizes the	following environment variables.

       CLUSTER	 Contains  a  filename,	 which	is a newline separated list of
		 nodes in the cluster.

       RCMD_CMD	 Command to use	to connect to remote  machines.	  The  command
		 chosen	must be	able to	connect	with no	password to the	remote
		 host.	Defaults to rsh

EXAMPLES
       To  find	 all  the filesystems which are	more than 90% full across your
       cluster,	you would issue:

	     pdf -m 90

DIAGNOSTICS
       Exit status is 0	on success, 1 if an error occurs.

SEE ALSO
       dsh(1), df(1), rsh(1), kerberos(3), hosts.equiv(5), rhosts(5)

HISTORY
       The pdf command appeared	in clusterit 1.0. It is	based on the pdf  com-
       mand in IBM PSSP.

AUTHOR
       Pdf was written by Tim Rightnour.

BUGS
       Output  is  formatted for 80 columns.  This means that mount points and
       filesystems with	long names (> 20 characters) will  be  truncated.   In
       addition, numbers longer	than 9 digits will be truncated	as well.

       pdf  will  only work on nodes that produce the df(1) output that	it ex-
       pects.  It has been made	to work	on HP-UX, Solaris, and AIX, along with
       any BSD,	and most versions of Linux.

				  May 5, 1999				PDF(1)

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

home | help