1.\"- 2.\" Copyright (c) 1989, 1990, 1993 3.\" The Regents of the University of California. All rights reserved. 4.\" 5.\" Redistribution and use in source and binary forms, with or without 6.\" modification, are permitted provided that the following conditions 7.\" are met: 8.\" 1. Redistributions of source code must retain the above copyright 9.\" notice, this list of conditions and the following disclaimer. 10.\" 2. Redistributions in binary form must reproduce the above copyright 11.\" notice, this list of conditions and the following disclaimer in the 12.\" documentation and/or other materials provided with the distribution. 13.\" 3. Neither the name of the University nor the names of its contributors 14.\" may be used to endorse or promote products derived from this software 15.\" without specific prior written permission. 16.\" 17.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND 18.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 19.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE 20.\" ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE 21.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 22.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS 23.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 24.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT 25.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY 26.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF 27.\" SUCH DAMAGE. 28.\" 29.\" @(#)df.1 8.3 (Berkeley) 5/8/95 30.\" $FreeBSD$ 31.\" 32.Dd August 8, 2017 33.Dt DF 1 34.Os 35.Sh NAME 36.Nm df 37.Nd display free disk space 38.Sh SYNOPSIS 39.Nm 40.Op Fl -libxo 41.Op Fl b | g | H | h | k | m | P 42.Op Fl acilnT 43.Op Fl \&, 44.Op Fl t Ar type 45.Op Ar file | filesystem ... 46.Sh DESCRIPTION 47The 48.Nm 49utility 50displays statistics about the amount of free disk space on the specified 51.Ar file system 52or on the file system of which 53.Ar file 54is a part. 55By default block counts are displayed with an assumed block size of 56512 bytes. 57If neither a file or a file system operand is specified, 58statistics for all mounted file systems are displayed 59(subject to the 60.Fl t 61option below). 62.Pp 63The following options are available: 64.Bl -tag -width indent 65.It Fl -libxo 66Generate output via 67.Xr libxo 3 68in a selection of different human and machine readable formats. 69See 70.Xr xo_parse_args 3 71for details on command line arguments. 72.It Fl a 73Show all mount points, including those that were mounted with the 74.Dv MNT_IGNORE 75flag. 76This is implied for file systems specified on the command line. 77.It Fl b 78Explicitly use 512 byte blocks, overriding any 79.Ev BLOCKSIZE 80specification from the environment. 81This is the same as the 82.Fl P 83option. 84The 85.Fl k 86option overrides this option. 87.It Fl c 88Display a grand total. 89.It Fl g 90Use 1073741824 byte (1 Gibibyte) blocks rather than the default. 91This overrides any 92.Ev BLOCKSIZE 93specification from the environment. 94.It Fl h 95.Dq Human-readable 96output. 97Use unit suffixes: Byte, Kibibyte, Mebibyte, Gibibyte, Tebibyte and 98Pebibyte (based on powers of 1024) in order to reduce the number of 99digits to four or fewer. 100.It Fl H , Fl Fl si 101.Dq Human-readable 102output. 103Use unit suffixes: Byte, Kilobyte, Megabyte, 104Gigabyte, Terabyte and Petabyte (based on powers of 1000) in order to 105reduce the number of 106digits to four or fewer. 107.It Fl i 108Include statistics on the number of free and used inodes. 109In conjunction with the 110.Fl h 111or 112.Fl H 113options, the number of inodes is scaled by powers of 1000. 114.It Fl k 115Use 1024 byte (1 Kibibyte) blocks rather than the default. 116This overrides the 117.Fl P 118option and any 119.Ev BLOCKSIZE 120specification from the environment. 121.It Fl l 122Only display information about locally-mounted file systems. 123.It Fl m 124Use 1048576 byte (1 Mebibyte) blocks rather than the default. 125This overrides any 126.Ev BLOCKSIZE 127specification from the environment. 128.It Fl n 129Print out the previously obtained statistics from the file systems. 130This option should be used if it is possible that one or more 131file systems are in a state such that they will not be able to provide 132statistics without a long delay. 133When this option is specified, 134.Nm 135will not request new statistics from the file systems, but will respond 136with the possibly stale statistics that were previously obtained. 137.It Fl P 138Explicitly use 512 byte blocks, overriding any 139.Ev BLOCKSIZE 140specification from the environment. 141This is the same as the 142.Fl b 143option. 144The 145.Fl k 146option overrides this option. 147.It Fl t 148Only print out statistics for file systems of the specified types. 149More than one type may be specified in a comma separated list. 150The list of file system types can be prefixed with 151.Dq no 152to specify the file system types for which action should 153.Em not 154be taken. 155For example, the 156.Nm 157command: 158.Bd -literal -offset indent 159df -t nonfs,nullfs 160.Ed 161.Pp 162lists all file systems except those of type 163.Tn NFS 164and 165.Tn NULLFS . 166The 167.Xr lsvfs 1 168command can be used to find out the types of file systems 169that are available on the system. 170.It Fl T 171Include file system type. 172.It Fl , 173(Comma) Print sizes grouped and separated by thousands using the 174non-monetary separator returned by 175.Xr localeconv 3 , 176typically a comma or period. 177If no locale is set, or the locale does not have a non-monetary separator, this 178option has no effect. 179.El 180.Sh ENVIRONMENT 181.Bl -tag -width BLOCKSIZE 182.It Ev BLOCKSIZE 183Specifies the units in which to report block counts. 184This uses 185.Xr getbsize 3 , 186which allows units of bytes or numbers scaled with the letters 187.Em k 188(for multiples of 1024 bytes), 189.Em m 190(for multiples of 1048576 bytes) or 191.Em g 192(for gibibytes). 193The allowed range is 512 bytes to 1 GB. 194If the value is outside, it will be set to the appropriate limit. 195.El 196.Sh SEE ALSO 197.Xr lsvfs 1 , 198.Xr quota 1 , 199.Xr fstatfs 2 , 200.Xr getfsstat 2 , 201.Xr statfs 2 , 202.Xr getbsize 3 , 203.Xr getmntinfo 3 , 204.Xr libxo 3 , 205.Xr localeconv 3 , 206.Xr xo_parse_args 3 , 207.Xr fstab 5 , 208.Xr mount 8 , 209.Xr pstat 8 , 210.Xr quot 8 , 211.Xr swapinfo 8 212.Sh STANDARDS 213With the exception of most options, 214the 215.Nm 216utility conforms to 217.St -p1003.1-2004 , 218which defines only the 219.Fl k , P 220and 221.Fl t 222options. 223.Sh HISTORY 224A 225.Nm 226command appeared in 227.At v1 . 228.Sh BUGS 229The 230.Fl n 231flag is ignored if a file or file system is specified. 232Also, if a mount 233point is not accessible by the user, it is possible that the file system 234information could be stale. 235.Pp 236The 237.Fl b 238and 239.Fl P 240options are identical. 241The former comes from the BSD tradition, and the latter is required 242for 243.St -p1003.1-2004 244conformity. 245