lost the SCCS id's...
[unix-history] / usr / src / bin / df / df.1
CommitLineData
f35cac8e 1.\" Copyright (c) 1989, 1990 The Regents of the University of California.
f3f1a429 2.\" All rights reserved.
c11b0d9e 3.\"
27c71911 4.\" %sccs.include.redist.man%
f3f1a429 5.\"
5325ced3 6.\" @(#)df.1 6.7 (Berkeley) %G%
c11b0d9e 7.\"
f35cac8e
CL
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
93e6cf82 21filesystem
f35cac8e 22.Ar filesystem
93e6cf82 23or on the filesystem of which
f35cac8e 24.Ar file
f3f1a429 25is a part.
f35cac8e
CL
26If neither a file or a filesystem argument is given,
27statistics for every filesystem mounted is displayed.
5325ced3 28.Pp
f3f1a429 29The following options are available:
5325ced3 30.Tw Ds
f35cac8e 31.Tp Fl i
f3f1a429 32Include statistics on the number of free inodes.
f35cac8e 33.Tp Fl k
f3f1a429
KB
34By default, all reported numbers are in 512-byte blocks.
35This causes the numbers to be reported in kilobytes.
f35cac8e 36.Tp Fl n
93e6cf82
KM
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,
f35cac8e 43.Nm df
93e6cf82
KM
44will not request new statistics from the filesystems,
45but will respond with the possibly stale statistics
46that were previously obtained.
f35cac8e 47.Sh BUGS
93e6cf82 48The
f35cac8e 49.Fl n
93e6cf82 50flag is ignored if a file or filesystem is specified.
f35cac8e
CL
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.