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

FreeBSD Manual Pages


home | help
PDF(1)			  BSD General Commands Manual			PDF(1)

     pdf -- display free disk space across a group of machines

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

     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 spec-
     ified, 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
     following options are available:

     -l	  Display statistics only about	mounted	file systems with the MNT_LO-
	  CAL 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 re-
	  spond	with the possibly stale	statistics that	were previously	ob-

     -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	run-
	  ning 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	envi-
	  ronment 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 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.

     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 cho-
	       sen must	be able	to connect with	no password to the remote
	       host.  Defaults to rsh

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

	   pdf -m 90

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

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

     The pdf command appeared in clusterit 1.0.	It is based on the pdf command
     in	IBM PSSP.

     Pdf was written by	Tim Rightnour.

     Output is formatted for 80	columns.  This means that mount	points and
     filesystems with long names (> 20 characters) will	be truncated.  In ad-
     dition, 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


Want to link to this manual page? Use this URL:

home | help