xref: /original-bsd/bin/df/df.1 (revision 7c7c9d58)
1.\" Copyright (c) 1989, 1990 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.roff%
5.\"
6.\"     @(#)df.1	6.10 (Berkeley) 03/01/92
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 Ar file | Ar filesystem ...
18.Sh DESCRIPTION
19.Nm Df
20displays statistics about the amount of free disk space on the specified
21.Ar filesystem
22or on the filesystem of which
23.Ar file
24is a part.
25Values are displayed in 512-byte per block block counts.
26If neither a file or a filesystem operand is specified,
27statistics for all mounted filesystems are displayed.
28.Pp
29The following options are available:
30.Bl -tag -width Ds
31.It Fl i
32Include statistics on the number of free inodes.
33.It Fl n
34Print out the previously obtained statistics from the filesystems.
35This option should be used if it is possible that one or more
36filesystems are in a state such that they will not be able to provide
37statistics without a long delay.
38When this option is specified,
39.Nm df
40will not request new statistics from the filesystems, but will respond
41with the possibly stale statistics that were previously obtained.
42.El
43.Sh ENVIRONMENTAL VARIABLES
44.Bl -tag -width BLOCKSIZE
45.It Ev BLOCKSIZE
46If the environmental variable
47.Ev BLOCKSIZE
48is set, the block counts will be displayed in units of that size block.
49.El
50.Sh BUGS
51The
52.Fl n
53flag is ignored if a file or filesystem is specified.
54.Sh SEE ALSO
55.Xr quota 1 ,
56.Xr statfs 2 ,
57.Xr fstatfs 2 ,
58.Xr getfsstat 2 ,
59.Xr getmntinfo 3 ,
60.Xr fstab 5 ,
61.Xr mount 8 ,
62.Xr quot 8
63.Sh HISTORY
64A
65.Nm df
66command appeared in
67.At v6 .
68