PDF(1)                     OpenBSD Reference Manual                     PDF(1)

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
          argument, a warning 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
          statistics 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
          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 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 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 ssh.

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), ssh(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
     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
     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
