xref: /original-bsd/bin/df/df.1 (revision 5b560bbe)
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.7 (Berkeley) 07/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.
28.Pp
29The following options are available:
30.Tw Ds
31.Tp Fl i
32Include statistics on the number of free inodes.
33.Tp Fl k
34By default, all reported numbers are in 512-byte blocks.
35This causes the numbers to be reported in kilobytes.
36.Tp Fl n
37Print out the previously obtained statistics from the filesystems.
38This option should be used
39if it is possible that one or more filesystems are
40in a state such that they will not be able
41to provide statistics without a long delay.
42When this option is specified,
43.Nm df
44will not request new statistics from the filesystems,
45but will respond with the possibly stale statistics
46that were previously obtained.
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 Version 6 AT&T Unix as
64df(8) and in Version 7 AT&T Unix as df(1m).
65.\" Just for posterity and perspective, the date on the Version 6
66.\" release manual page was 1/20/73.
67