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 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 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.