'\"macro stdmacro
.if n .pH g1.df @(#)df	40.2 of 9/15/89
.\" @(#)df.1 1.4 89/05/14 SMI;
'\"macro stdmacro
.\" Copyright (c) 1988 Sun Microsystems, Inc. - All Rights Reserved
.nr X
.if \nX=0 .ds x} df 1 "BSD Compatibility Package" "\&"
.if \nX=1 .ds x} df 1 "BSD Compatibility Package"
.if \nX=2 .ds x} df 1 "" "\&"
.if \nX=3 .ds x} df "" "" "\&"
.TH \*(x}
.SH NAME
\f4df\f1 \- report free disk space on file systems
.SH SYNOPSIS
\f4/usr/ucb/df\f1
[
\f4\-beglntvV\f1
]
[
.IR directory \||\| special
]
.SH DESCRIPTION
.P
\f4df\f1
displays the amount of disk space occupied by currently
mounted file systems, the amount of used and available space,
and how much of the file system's total
capacity has been used.
.P
If arguments to
\f4df\f1
are path names,
\f4df\f1
produces a report on the
file system containing the named file.
Thus
\f1`\f4df\ \ .\f1'
shows the amount of space on the file system
containing the current directory.
.P
The following options are available:
.TP
\f4\-b\f1
Print only the number of kilobytes free.
.TP
\f4\-e\f1
Print only the number of file entries free.
.TP
\f4\-g\f1
Print the entire
\f4statvfs\f1
structure.
Not valid with any other option, except the
\f4\-l \f1
option.
.TP
\f4\-l\f1
Report on local file systems only.
.TP
\f4\-n\f1
Print only the file system type name.
.TP
\f4\-t\f1
Report figures for total allocated blocks and
files as well as free blocks and files.
.TP
\f4\-v\f1
Print allocations in kilobytes.
.TP
\f4\-V\f1
Verbose. 
Echo complete command line.
.SH EXAMPLE
.P
A sample of output for
\f4df\f1
looks like:
.sp .5v
.RS
.nf
.ft 4
df
.ta \w'Filesystem'u+2n +\w'kbytes'u+2n +\w'used'u+2n +\w'avail'u+2n +\w'capacity'u+2n
Filesystem	kbytes	used	avail	capacity	Mounted on
sparky:/	 7445	 4714	1986	70%		/
sparky:/usr	42277	35291	2758	93%		/usr
.fi
.ft 1
.RE
.sp .5v
.SH FILES
.PD 0
.TP 20
\f4/etc/mnttab\f1
list of file systems currently mounted
.TP
\f4/etc/vfstab\f1
list of default parameters for each file system
.PD
.SH "SEE ALSO"
\f4du\fP(1M),
\f4quot\fP(1M),
\f4tunefs\fP(1M),
\f4mnttab\fP(4)
in the \f2System Administrator's Reference Manual\f1.
