Commit | Line | Data |
---|---|---|
ba5e8546 KB |
1 | .\" Copyright (c) 1989, 1990, 1993 |
2 | .\" The Regents of the University of California. All rights reserved. | |
c11b0d9e | 3 | .\" |
ad787160 C |
4 | .\" Redistribution and use in source and binary forms, with or without |
5 | .\" modification, are permitted provided that the following conditions | |
6 | .\" are met: | |
7 | .\" 1. Redistributions of source code must retain the above copyright | |
8 | .\" notice, this list of conditions and the following disclaimer. | |
9 | .\" 2. Redistributions in binary form must reproduce the above copyright | |
10 | .\" notice, this list of conditions and the following disclaimer in the | |
11 | .\" documentation and/or other materials provided with the distribution. | |
12 | .\" 3. All advertising materials mentioning features or use of this software | |
13 | .\" must display the following acknowledgement: | |
14 | .\" This product includes software developed by the University of | |
15 | .\" California, Berkeley and its contributors. | |
16 | .\" 4. Neither the name of the University nor the names of its contributors | |
17 | .\" may be used to endorse or promote products derived from this software | |
18 | .\" without specific prior written permission. | |
f3f1a429 | 19 | .\" |
ad787160 C |
20 | .\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND |
21 | .\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE | |
22 | .\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE | |
23 | .\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE | |
24 | .\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL | |
25 | .\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS | |
26 | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | |
27 | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | |
28 | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | |
29 | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | |
30 | .\" SUCH DAMAGE. | |
c11b0d9e | 31 | .\" |
ed554bc5 | 32 | .\" @(#)df.1 8.2 (Berkeley) 1/13/94 |
ad787160 | 33 | .\" |
ed554bc5 | 34 | .Dd January 13, 1994 |
f35cac8e CL |
35 | .Dt DF 1 |
36 | .Os BSD 4 | |
37 | .Sh NAME | |
38 | .Nm df | |
39 | .Nd display free disk space | |
40 | .Sh SYNOPSIS | |
41 | .Nm df | |
4933888a | 42 | .Op Fl in |
48f775d1 | 43 | .Op Fl t Ar type |
26424782 | 44 | .Op Ar file | Ar filesystem ... |
f35cac8e CL |
45 | .Sh DESCRIPTION |
46 | .Nm Df | |
26424782 | 47 | displays statistics about the amount of free disk space on the specified |
f35cac8e | 48 | .Ar filesystem |
93e6cf82 | 49 | or on the filesystem of which |
f35cac8e | 50 | .Ar file |
f3f1a429 | 51 | is a part. |
4933888a | 52 | Values are displayed in 512-byte per block block counts. |
6df676a5 | 53 | If neither a file or a filesystem operand is specified, |
48f775d1 KM |
54 | statistics for all mounted filesystems are displayed |
55 | (subject to the | |
56 | .Fl t | |
57 | option below). | |
5325ced3 | 58 | .Pp |
f3f1a429 | 59 | The following options are available: |
26424782 CL |
60 | .Bl -tag -width Ds |
61 | .It Fl i | |
f3f1a429 | 62 | Include statistics on the number of free inodes. |
26424782 | 63 | .It Fl n |
93e6cf82 | 64 | Print out the previously obtained statistics from the filesystems. |
6df676a5 KB |
65 | This option should be used if it is possible that one or more |
66 | filesystems are in a state such that they will not be able to provide | |
67 | statistics without a long delay. | |
93e6cf82 | 68 | When this option is specified, |
f35cac8e | 69 | .Nm df |
6df676a5 KB |
70 | will not request new statistics from the filesystems, but will respond |
71 | with the possibly stale statistics that were previously obtained. | |
48f775d1 KM |
72 | .It Fl t |
73 | Only print out statistics for filesystems of the specified types. | |
74 | The recognized types are: | |
b357cc71 | 75 | ufs, nfs, mfs, lfs, msdos, fdesc, portal, kernfs, procfs, afs and isofs. |
48f775d1 KM |
76 | along with the aggregates: |
77 | all (the default), | |
b357cc71 MH |
78 | local (ufs, mfs, lfs, msdos, isofs), |
79 | and misc (fdesc, portal, kernfs, procfs). | |
48f775d1 KM |
80 | The string ``no'' may be prepending to a type to get its complement |
81 | (e.g. ``nonfs'' to get non-NFS filesystems). The first | |
82 | .Fl t | |
83 | option overrides the default, additional such options will add to | |
84 | (or subtract from) the current set of types; e.g. either | |
85 | ``df -t ufs -t lfs'' | |
86 | or | |
87 | ``df -t local -t nomfs'' | |
88 | will display statistics for UFS and LFS filesystems. | |
26424782 | 89 | .El |
4933888a KB |
90 | .Sh ENVIRONMENTAL VARIABLES |
91 | .Bl -tag -width BLOCKSIZE | |
92 | .It Ev BLOCKSIZE | |
93 | If the environmental variable | |
94 | .Ev BLOCKSIZE | |
95 | is set, the block counts will be displayed in units of that size block. | |
96 | .El | |
f35cac8e | 97 | .Sh BUGS |
93e6cf82 | 98 | The |
f35cac8e | 99 | .Fl n |
48f775d1 KM |
100 | and |
101 | .Fl t | |
102 | flags are ignored if a file or filesystem is specified. | |
f35cac8e CL |
103 | .Sh SEE ALSO |
104 | .Xr quota 1 , | |
105 | .Xr statfs 2 , | |
106 | .Xr fstatfs 2 , | |
107 | .Xr getfsstat 2 , | |
108 | .Xr getmntinfo 3 , | |
109 | .Xr fstab 5 , | |
110 | .Xr mount 8 , | |
111 | .Xr quot 8 | |
112 | .Sh HISTORY | |
113 | A | |
114 | .Nm df | |
26424782 CL |
115 | command appeared in |
116 | .At v6 . |