xref: /original-bsd/bin/df/df.1 (revision bd226a66)
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.9 (Berkeley) 06/17/91
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 ikn
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.
25If neither a file or a filesystem operand is specified,
26statistics for all mounted filesystems are displayed.
27.Pp
28The following options are available:
29.Bl -tag -width Ds
30.It Fl i
31Include statistics on the number of free inodes.
32.It Fl k
33By default, all sizes are reported in 512-byte block counts.
34The
35.Fl k
36option causes the numbers to be reported in kilobyte counts.
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.El
47.Sh BUGS
48The
49.Fl n
50flag is ignored if a file or filesystem is specified.
51.Sh SEE ALSO
52.Xr quota 1 ,
53.Xr statfs 2 ,
54.Xr fstatfs 2 ,
55.Xr getfsstat 2 ,
56.Xr getmntinfo 3 ,
57.Xr fstab 5 ,
58.Xr mount 8 ,
59.Xr quot 8
60.Sh HISTORY
61A
62.Nm df
63command appeared in
64.At v6 .
65