xref: /freebsd/bin/df/df.1 (revision d0bc27e435790010108d3b39f6e5ca600adc9a2e)
19ddb49cbSWarner Losh.\"-
24b88c807SRodney W. Grimes.\" Copyright (c) 1989, 1990, 1993
34b88c807SRodney W. Grimes.\"	The Regents of the University of California.  All rights reserved.
44b88c807SRodney W. Grimes.\"
54b88c807SRodney W. Grimes.\" Redistribution and use in source and binary forms, with or without
64b88c807SRodney W. Grimes.\" modification, are permitted provided that the following conditions
74b88c807SRodney W. Grimes.\" are met:
84b88c807SRodney W. Grimes.\" 1. Redistributions of source code must retain the above copyright
94b88c807SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer.
104b88c807SRodney W. Grimes.\" 2. Redistributions in binary form must reproduce the above copyright
114b88c807SRodney W. Grimes.\"    notice, this list of conditions and the following disclaimer in the
124b88c807SRodney W. Grimes.\"    documentation and/or other materials provided with the distribution.
13fbbd9655SWarner Losh.\" 3. Neither the name of the University nor the names of its contributors
144b88c807SRodney W. Grimes.\"    may be used to endorse or promote products derived from this software
154b88c807SRodney W. Grimes.\"    without specific prior written permission.
164b88c807SRodney W. Grimes.\"
174b88c807SRodney W. Grimes.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
184b88c807SRodney W. Grimes.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
194b88c807SRodney W. Grimes.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
204b88c807SRodney W. Grimes.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
214b88c807SRodney W. Grimes.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
224b88c807SRodney W. Grimes.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
234b88c807SRodney W. Grimes.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
244b88c807SRodney W. Grimes.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
254b88c807SRodney W. Grimes.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
264b88c807SRodney W. Grimes.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
274b88c807SRodney W. Grimes.\" SUCH DAMAGE.
284b88c807SRodney W. Grimes.\"
298a166df9SSteve Price.\"     @(#)df.1	8.3 (Berkeley) 5/8/95
302a456239SPeter Wemm.\" $FreeBSD$
314b88c807SRodney W. Grimes.\"
32*d0bc27e4SKyle Evans.Dd August 8, 2017
334b88c807SRodney W. Grimes.Dt DF 1
34caa2db3bSRuslan Ermilov.Os
354b88c807SRodney W. Grimes.Sh NAME
364b88c807SRodney W. Grimes.Nm df
374b88c807SRodney W. Grimes.Nd display free disk space
384b88c807SRodney W. Grimes.Sh SYNOPSIS
39be8b1497SRuslan Ermilov.Nm
406fea8dc8SMarcel Moolenaar.Op Fl -libxo
412360f509SRuslan Ermilov.Op Fl b | g | H | h | k | m | P
42b56ca465SPawel Jakub Dawidek.Op Fl acilnT
437eb55d4dSXin LI.Op Fl \&,
444b88c807SRodney W. Grimes.Op Fl t Ar type
45d0353b83SRuslan Ermilov.Op Ar file | filesystem ...
464b88c807SRodney W. Grimes.Sh DESCRIPTION
47e004acc8SPhilippe CharnierThe
48e004acc8SPhilippe Charnier.Nm
49e004acc8SPhilippe Charnierutility
504b88c807SRodney W. Grimesdisplays statistics about the amount of free disk space on the specified
514b88c807SRodney W. Grimes.Ar file system
524b88c807SRodney W. Grimesor on the file system of which
534b88c807SRodney W. Grimes.Ar file
544b88c807SRodney W. Grimesis a part.
5571cfc678SGreg LeheyBy default block counts are displayed with an assumed block size of
5671cfc678SGreg Lehey512 bytes.
574b88c807SRodney W. GrimesIf neither a file or a file system operand is specified,
584b88c807SRodney W. Grimesstatistics for all mounted file systems are displayed
594b88c807SRodney W. Grimes(subject to the
604b88c807SRodney W. Grimes.Fl t
614b88c807SRodney W. Grimesoption below).
624b88c807SRodney W. Grimes.Pp
634b88c807SRodney W. GrimesThe following options are available:
64975ab359SRuslan Ermilov.Bl -tag -width indent
6506691045SCraig Rodrigues.It Fl -libxo
6606691045SCraig RodriguesGenerate output via
6706691045SCraig Rodrigues.Xr libxo 3
6806691045SCraig Rodriguesin a selection of different human and machine readable formats.
6906691045SCraig RodriguesSee
7006691045SCraig Rodrigues.Xr xo_parse_args 3
7106691045SCraig Rodriguesfor details on command line arguments.
725b42dac8SJulian Elischer.It Fl a
73975ab359SRuslan ErmilovShow all mount points, including those that were mounted with the
74975ab359SRuslan Ermilov.Dv MNT_IGNORE
755b42dac8SJulian Elischerflag.
7616352ac8SDag-Erling SmørgravThis is implied for file systems specified on the command line.
77dd6d33e8SMichael Haro.It Fl b
7871cfc678SGreg LeheyExplicitly use 512 byte blocks, overriding any
79dd6d33e8SMichael Haro.Ev BLOCKSIZE
80dd6d33e8SMichael Harospecification from the environment.
8171cfc678SGreg LeheyThis is the same as the
8271cfc678SGreg Lehey.Fl P
8371cfc678SGreg Leheyoption.
8471cfc678SGreg LeheyThe
8571cfc678SGreg Lehey.Fl k
8671cfc678SGreg Leheyoption overrides this option.
87076419d2SDavid E. O'Brien.It Fl c
88076419d2SDavid E. O'BrienDisplay a grand total.
8993a3fa19SJohn W. De Boskey.It Fl g
9071cfc678SGreg LeheyUse 1073741824 byte (1 Gibibyte) blocks rather than the default.
9171cfc678SGreg LeheyThis overrides any
9293a3fa19SJohn W. De Boskey.Ev BLOCKSIZE
9393a3fa19SJohn W. De Boskeyspecification from the environment.
943a97f8afSWarren Block.It Fl h
95b93ce3b7SSimon L. B. Nielsen.Dq Human-readable
96b93ce3b7SSimon L. B. Nielsenoutput.
9771cfc678SGreg LeheyUse unit suffixes: Byte, Kibibyte, Mebibyte, Gibibyte, Tebibyte and
9871cfc678SGreg LeheyPebibyte (based on powers of 1024) in order to reduce the number of
9971cfc678SGreg Leheydigits to four or fewer.
100*d0bc27e4SKyle Evans.It Fl H , Fl Fl si
101b93ce3b7SSimon L. B. Nielsen.Dq Human-readable
102b93ce3b7SSimon L. B. Nielsenoutput.
103eccea571SRuslan ErmilovUse unit suffixes: Byte, Kilobyte, Megabyte,
10471cfc678SGreg LeheyGigabyte, Terabyte and Petabyte (based on powers of 1000) in order to
10571cfc678SGreg Leheyreduce the number of
10671cfc678SGreg Leheydigits to four or fewer.
1074b88c807SRodney W. Grimes.It Fl i
10871cfc678SGreg LeheyInclude statistics on the number of free and used inodes.
10971cfc678SGreg LeheyIn conjunction with the
11071cfc678SGreg Lehey.Fl h
11171cfc678SGreg Leheyor
11271cfc678SGreg Lehey.Fl H
11371cfc678SGreg Leheyoptions, the number of inodes is scaled by powers of 1000.
1147f0eabfdSGarrett Wollman.It Fl k
11571cfc678SGreg LeheyUse 1024 byte (1 Kibibyte) blocks rather than the default.
116019e4a53SGreg LeheyThis overrides the
117019e4a53SGreg Lehey.Fl P
11871cfc678SGreg Leheyoption and any
11971cfc678SGreg Lehey.Ev BLOCKSIZE
12071cfc678SGreg Leheyspecification from the environment.
121a25695c3SJim Pirzyk.It Fl l
122a25695c3SJim PirzykOnly display information about locally-mounted file systems.
123dd6d33e8SMichael Haro.It Fl m
12471cfc678SGreg LeheyUse 1048576 byte (1 Mebibyte) blocks rather than the default.
12571cfc678SGreg LeheyThis overrides any
126dd6d33e8SMichael Haro.Ev BLOCKSIZE
127dd6d33e8SMichael Harospecification from the environment.
1284b88c807SRodney W. Grimes.It Fl n
1294b88c807SRodney W. GrimesPrint out the previously obtained statistics from the file systems.
1304b88c807SRodney W. GrimesThis option should be used if it is possible that one or more
1314b88c807SRodney W. Grimesfile systems are in a state such that they will not be able to provide
1324b88c807SRodney W. Grimesstatistics without a long delay.
1334b88c807SRodney W. GrimesWhen this option is specified,
134d072138aSPhilippe Charnier.Nm
1354b88c807SRodney W. Grimeswill not request new statistics from the file systems, but will respond
1364b88c807SRodney W. Grimeswith the possibly stale statistics that were previously obtained.
137dd6d33e8SMichael Haro.It Fl P
13871cfc678SGreg LeheyExplicitly use 512 byte blocks, overriding any
139dd6d33e8SMichael Haro.Ev BLOCKSIZE
140dd6d33e8SMichael Harospecification from the environment.
14171cfc678SGreg LeheyThis is the same as the
14271cfc678SGreg Lehey.Fl b
14371cfc678SGreg Leheyoption.
144019e4a53SGreg LeheyThe
145019e4a53SGreg Lehey.Fl k
146019e4a53SGreg Leheyoption overrides this option.
1474b88c807SRodney W. Grimes.It Fl t
1484b88c807SRodney W. GrimesOnly print out statistics for file systems of the specified types.
149611d1296SBruce EvansMore than one type may be specified in a comma separated list.
150611d1296SBruce EvansThe list of file system types can be prefixed with
151611d1296SBruce Evans.Dq no
152611d1296SBruce Evansto specify the file system types for which action should
153611d1296SBruce Evans.Em not
154611d1296SBruce Evansbe taken.
155611d1296SBruce EvansFor example, the
156d072138aSPhilippe Charnier.Nm
157611d1296SBruce Evanscommand:
158611d1296SBruce Evans.Bd -literal -offset indent
1590b381bf1SRuslan Ermilovdf -t nonfs,nullfs
160611d1296SBruce Evans.Ed
161611d1296SBruce Evans.Pp
162611d1296SBruce Evanslists all file systems except those of type
163611d1296SBruce Evans.Tn NFS
164611d1296SBruce Evansand
1650b381bf1SRuslan Ermilov.Tn NULLFS .
166611d1296SBruce EvansThe
167b84897d1SSheldon Hearn.Xr lsvfs 1
168611d1296SBruce Evanscommand can be used to find out the types of file systems
169b84897d1SSheldon Hearnthat are available on the system.
170b56ca465SPawel Jakub Dawidek.It Fl T
171b56ca465SPawel Jakub DawidekInclude file system type.
172019e4a53SGreg Lehey.It Fl ,
173019e4a53SGreg Lehey(Comma) Print sizes grouped and separated by thousands using the
174019e4a53SGreg Leheynon-monetary separator returned by
175019e4a53SGreg Lehey.Xr localeconv 3 ,
176019e4a53SGreg Leheytypically a comma or period.
177019e4a53SGreg LeheyIf no locale is set, or the locale does not have a non-monetary separator, this
178019e4a53SGreg Leheyoption has no effect.
1794b88c807SRodney W. Grimes.El
18084717b42SPoul-Henning Kamp.Sh ENVIRONMENT
1814b88c807SRodney W. Grimes.Bl -tag -width BLOCKSIZE
1824b88c807SRodney W. Grimes.It Ev BLOCKSIZE
18371cfc678SGreg LeheySpecifies the units in which to report block counts.
18471cfc678SGreg LeheyThis uses
18571cfc678SGreg Lehey.Xr getbsize 3 ,
18671cfc678SGreg Leheywhich allows units of bytes or numbers scaled with the letters
18771cfc678SGreg Lehey.Em k
18871cfc678SGreg Lehey(for multiples of 1024 bytes),
18971cfc678SGreg Lehey.Em m
19071cfc678SGreg Lehey(for multiples of 1048576 bytes) or
19171cfc678SGreg Lehey.Em g
19271cfc678SGreg Lehey(for gibibytes).
19371cfc678SGreg LeheyThe allowed range is 512 bytes to 1 GB.
19471cfc678SGreg LeheyIf the value is outside, it will be set to the appropriate limit.
1954b88c807SRodney W. Grimes.El
1964b88c807SRodney W. Grimes.Sh SEE ALSO
197b84897d1SSheldon Hearn.Xr lsvfs 1 ,
1984b88c807SRodney W. Grimes.Xr quota 1 ,
1994b88c807SRodney W. Grimes.Xr fstatfs 2 ,
2004b88c807SRodney W. Grimes.Xr getfsstat 2 ,
201af202156SWolfram Schneider.Xr statfs 2 ,
20271cfc678SGreg Lehey.Xr getbsize 3 ,
2034b88c807SRodney W. Grimes.Xr getmntinfo 3 ,
2046fea8dc8SMarcel Moolenaar.Xr libxo 3 ,
205019e4a53SGreg Lehey.Xr localeconv 3 ,
2066fea8dc8SMarcel Moolenaar.Xr xo_parse_args 3 ,
2074b88c807SRodney W. Grimes.Xr fstab 5 ,
2084b88c807SRodney W. Grimes.Xr mount 8 ,
209c9e571feSGreg Lehey.Xr pstat 8 ,
210c9e571feSGreg Lehey.Xr quot 8 ,
211b5a8b741SChristian Brueffer.Xr swapinfo 8
212019e4a53SGreg Lehey.Sh STANDARDS
213019e4a53SGreg LeheyWith the exception of most options,
214019e4a53SGreg Leheythe
215019e4a53SGreg Lehey.Nm
216019e4a53SGreg Leheyutility conforms to
217019e4a53SGreg Lehey.St -p1003.1-2004 ,
218019e4a53SGreg Leheywhich defines only the
219019e4a53SGreg Lehey.Fl k , P
220019e4a53SGreg Leheyand
221019e4a53SGreg Lehey.Fl t
222019e4a53SGreg Leheyoptions.
2234b88c807SRodney W. Grimes.Sh HISTORY
2244b88c807SRodney W. GrimesA
225d072138aSPhilippe Charnier.Nm
2264b88c807SRodney W. Grimescommand appeared in
227b8923d4cSWolfram Schneider.At v1 .
2286fca4c7cSRuslan Ermilov.Sh BUGS
2296fca4c7cSRuslan ErmilovThe
2306fca4c7cSRuslan Ermilov.Fl n
2316fca4c7cSRuslan Ermilovflag is ignored if a file or file system is specified.
2326fca4c7cSRuslan ErmilovAlso, if a mount
2336fca4c7cSRuslan Ermilovpoint is not accessible by the user, it is possible that the file system
2346fca4c7cSRuslan Ermilovinformation could be stale.
23571cfc678SGreg Lehey.Pp
23671cfc678SGreg LeheyThe
23771cfc678SGreg Lehey.Fl b
23871cfc678SGreg Leheyand
23971cfc678SGreg Lehey.Fl P
24071cfc678SGreg Leheyoptions are identical.
24171cfc678SGreg LeheyThe former comes from the BSD tradition, and the latter is required
24271cfc678SGreg Leheyfor
24371cfc678SGreg Lehey.St -p1003.1-2004
24471cfc678SGreg Leheyconformity.
245