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