xref: /original-bsd/bin/df/df.1 (revision b3c06cab)
1.\" Copyright (c) 1989, 1990, 1993
2.\"	The Regents of the University of California.  All rights reserved.
3.\"
4.\" %sccs.include.redist.roff%
5.\"
6.\"     @(#)df.1	8.3 (Berkeley) 05/08/95
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 Fl t Ar type
18.Op Ar file | Ar filesystem ...
19.Sh DESCRIPTION
20.Nm Df
21displays statistics about the amount of free disk space on the specified
22.Ar filesystem
23or on the filesystem of which
24.Ar file
25is a part.
26Values are displayed in 512-byte per block block counts.
27If neither a file or a filesystem operand is specified,
28statistics for all mounted filesystems are displayed
29(subject to the
30.Fl t
31option below).
32.Pp
33The following options are available:
34.Bl -tag -width Ds
35.It Fl i
36Include statistics on the number of free inodes.
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.It Fl t
47Only print out statistics for filesystems of the specified types.
48More than one type may be specified in a comma separated list.
49The list of filesystem types can be prefixed with
50.Dq no
51to specify the filesystem types for which action should
52.Em not
53be taken.
54For example, the
55.Nm df
56command:
57.Bd -literal -offset indent
58df -t nonfs,mfs
59.Ed
60.Pp
61lists all filesystems except those of type
62.Tn NFS
63and
64.Tn MFS .
65The
66.Xr sysctl 8
67command can be used to find out the types of filesystems
68that are available on the system:
69.Bd -literal -offset indent
70sysctl vfs
71.Ed
72.El
73.Sh ENVIRONMENTAL VARIABLES
74.Bl -tag -width BLOCKSIZE
75.It Ev BLOCKSIZE
76If the environmental variable
77.Ev BLOCKSIZE
78is set, the block counts will be displayed in units of that size block.
79.El
80.Sh BUGS
81The
82.Fl n
83and
84.Fl t
85flags are ignored if a file or filesystem is specified.
86.Sh SEE ALSO
87.Xr quota 1 ,
88.Xr statfs 2 ,
89.Xr fstatfs 2 ,
90.Xr getfsstat 2 ,
91.Xr getmntinfo 3 ,
92.Xr fstab 5 ,
93.Xr mount 8 ,
94.Xr quot 8 ,
95.Xr sysctl 8
96.Sh HISTORY
97A
98.Nm df
99command appeared in
100.At v6 .
101