xref: /original-bsd/bin/df/df.1 (revision f5cc5b3e)
1.\" Copyright (c) 1989, 1990 The Regents of the University of California.
2.\" All rights reserved.
3.\"
4.\" %sccs.include.redist.man%
5.\"
6.\"     @(#)df.1	6.6 (Berkeley) 06/24/90
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 Li \&| Ar filesystem \&...
18.Sh DESCRIPTION
19.Nm Df
20displays statistics about the amount of free disk space on the
21filesystem
22.Ar filesystem
23or on the filesystem of which
24.Ar file
25is a part.
26If neither a file or a filesystem argument is given,
27statistics for every filesystem mounted is displayed.
28The following options are available:
29.Tp Fl i
30Include statistics on the number of free inodes.
31.Tp Fl k
32By default, all reported numbers are in 512-byte blocks.
33This causes the numbers to be reported in kilobytes.
34.Tp Fl n
35Print out the previously obtained statistics from the filesystems.
36This option should be used
37if it is possible that one or more filesystems are
38in a state such that they will not be able
39to provide statistics without a long delay.
40When this option is specified,
41.Nm df
42will not request new statistics from the filesystems,
43but will respond with the possibly stale statistics
44that were previously obtained.
45.Sh BUGS
46The
47.Fl n
48flag is ignored if a file or filesystem is specified.
49.Sh SEE ALSO
50.Xr quota 1 ,
51.Xr statfs 2 ,
52.Xr fstatfs 2 ,
53.Xr getfsstat 2 ,
54.Xr getmntinfo 3 ,
55.Xr fstab 5 ,
56.Xr mount 8 ,
57.Xr quot 8
58.Sh HISTORY
59A
60.Nm df
61command appeared in Version 6 AT&T Unix as
62df(8) and in Version 7 AT&T Unix as df(1m).
63.\" Just for posterity and perspective, the date on the Version 6
64.\" release manual page was 1/20/73.
65