xref: /original-bsd/bin/df/df.1 (revision 333da485)
1.\" Copyright (c) 1989, 1990, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.roff%
5.\"
6.\"     @(#)df.1	8.2 (Berkeley) 01/13/94
7.\"
8.Dd
9.Dt DF 1
10.Os BSD 4
11.Sh NAME
12.Nm df
13.Nd display free disk space
14.Sh SYNOPSIS
15.Nm df
16.Op Fl in
17.Op Fl t Ar type
18.Op Ar file | Ar filesystem ...
19.Sh DESCRIPTION
20.Nm Df
21displays statistics about the amount of free disk space on the specified
22.Ar filesystem
23or on the filesystem of which
24.Ar file
25is a part.
26Values are displayed in 512-byte per block block counts.
27If neither a file or a filesystem operand is specified,
28statistics for all mounted filesystems are displayed
29(subject to the
30.Fl t
31option below).
32.Pp
33The following options are available:
34.Bl -tag -width Ds
35.It Fl i
36Include statistics on the number of free inodes.
37.It Fl n
38Print out the previously obtained statistics from the filesystems.
39This option should be used if it is possible that one or more
40filesystems are in a state such that they will not be able to provide
41statistics without a long delay.
42When this option is specified,
43.Nm df
44will not request new statistics from the filesystems, but will respond
45with the possibly stale statistics that were previously obtained.
46.It Fl t
47Only print out statistics for filesystems of the specified types.
48The recognized types are:
49ufs, nfs, mfs, lfs, msdos, fdesc, portal, kernfs, procfs, afs and isofs.
50along with the aggregates:
51all (the default),
52local (ufs, mfs, lfs, msdos, isofs),
53and misc (fdesc, portal, kernfs, procfs).
54The string ``no'' may be prepending to a type to get its complement
55(e.g. ``nonfs'' to get non-NFS filesystems).  The first
56.Fl t
57option overrides the default, additional such options will add to
58(or subtract from) the current set of types; e.g. either
59``df -t ufs -t lfs''
60or
61``df -t local -t nomfs''
62will display statistics for UFS and LFS filesystems.
63.El
64.Sh ENVIRONMENTAL VARIABLES
65.Bl -tag -width BLOCKSIZE
66.It Ev BLOCKSIZE
67If the environmental variable
68.Ev BLOCKSIZE
69is set, the block counts will be displayed in units of that size block.
70.El
71.Sh BUGS
72The
73.Fl n
74and
75.Fl t
76flags are ignored if a file or filesystem is specified.
77.Sh SEE ALSO
78.Xr quota 1 ,
79.Xr statfs 2 ,
80.Xr fstatfs 2 ,
81.Xr getfsstat 2 ,
82.Xr getmntinfo 3 ,
83.Xr fstab 5 ,
84.Xr mount 8 ,
85.Xr quot 8
86.Sh HISTORY
87A
88.Nm df
89command appeared in
90.At v6 .
91