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 speci-
     fied file_system or on the file system of which file is a part on	all  ma-
     chines  in a cluster.  If neither a file or a file_system operand is speci-
     fied, statistics for all mounted file systems, on	all  machines  are  dis-
     played  (subject to the -w, -x, -g, -m, -l and -t options below).	The fol-
     lowing 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 argument, a warn-
	  ing is issued and no information is given on that file system.

     -n   Print  out  the  previously obtained statistics from the file systems.
	  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 sta-
	  tistics without a long delay.  When this option is specified, pdf will
	  not  request	new  statistics  from the file systems, 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 ca-
	  pacity 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 filesystems 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 action  should  not  be
	  taken.   If  a file system is given on the command 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	cluster.
	  The format is the same as the -w option, a comma delimited list of ma-
	  chine  names.  This option is silently ignored if used with the -w op-
	  tion.

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.  De-
	       faults to rsh

EXAMPLES
     To  find all the filesystems which are more than 90% full across your clus-
     ter, 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  command
     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  addi-
     tion, numbers longer than 9 digits will be truncated as well.

     pdf  will only work on nodes that produce the df(1) output that it expects.
     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.1.quarterly>

home | help