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: stable/12/bin/df/df.1 372028 2022-04-18 11:13:53Z se $ 31.\" 32.Dd October 5, 2020 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 101Same as 102.Fl h 103but based on powers of 1000. 104.It Fl i 105Include statistics on the number of free and used inodes. 106In conjunction with the 107.Fl h 108or 109.Fl H 110options, the number of inodes is scaled by powers of 1000. 111.It Fl k 112Use 1024 byte (1 Kibibyte) blocks rather than the default. 113This overrides the 114.Fl P 115option and any 116.Ev BLOCKSIZE 117specification from the environment. 118.It Fl l 119Select locally-mounted file system for display. 120If used in combination with the 121.Fl t Ar type 122option, file system types will be added or excluded acccording to the 123parameters of that option. 124.It Fl m 125Use 1048576 byte (1 Mebibyte) blocks rather than the default. 126This overrides any 127.Ev BLOCKSIZE 128specification from the environment. 129.It Fl n 130Print out the previously obtained statistics from the file systems. 131This option should be used if it is possible that one or more 132file systems are in a state such that they will not be able to provide 133statistics without a long delay. 134When this option is specified, 135.Nm 136will not request new statistics from the file systems, but will respond 137with the possibly stale statistics that were previously obtained. 138.It Fl P 139Explicitly use 512 byte blocks, overriding any 140.Ev BLOCKSIZE 141specification from the environment. 142This is the same as the 143.Fl b 144option. 145The 146.Fl k 147option overrides this option. 148.It Fl t Ar type 149Select file systems to display. 150More than one type may be specified in a comma separated list. 151The list of file system types can be prefixed with 152.Dq no 153to specify the file system types for which action should 154.Em not 155be taken. 156If used in combination with the 157.Fl l 158option, the parameters of this option will modify the list of 159locally-mounted file systems selected by the 160.Fl l 161option. 162For example, the 163.Nm 164command: 165.Bd -literal -offset indent 166df -t nonfs,nullfs 167.Ed 168.Pp 169lists all file systems except those of type NFS and NULLFS. 170The 171.Xr lsvfs 1 172command can be used to find out the types of file systems 173that are available on the system. 174.It Fl T 175Include file system type. 176.It Fl , 177(Comma) Print sizes grouped and separated by thousands using the 178non-monetary separator returned by 179.Xr localeconv 3 , 180typically a comma or period. 181If no locale is set, or the locale does not have a non-monetary separator, this 182option has no effect. 183.El 184.Sh ENVIRONMENT 185.Bl -tag -width BLOCKSIZE 186.It Ev BLOCKSIZE 187Specifies the units in which to report block counts. 188This uses 189.Xr getbsize 3 , 190which allows units of bytes or numbers scaled with the letters 191.Em k 192(for multiples of 1024 bytes), 193.Em m 194(for multiples of 1048576 bytes) or 195.Em g 196(for gibibytes). 197The allowed range is 512 bytes to 1 GB. 198If the value is outside, it will be set to the appropriate limit. 199.El 200.Sh EXAMPLES 201Show human readable free disk space for all mount points including file system 202type: 203.Bd -literal -offset indent 204$ df -ahT 205Filesystem Type Size Used Avail Capacity Mounted on 206/dev/ada1p2 ufs 213G 152G 44G 78% / 207devfs devfs 1.0K 1.0K 0B 100% /dev 208/dev/ada0p1 ufs 1.8T 168G 1.5T 10% /data 209linsysfs linsysfs 4.0K 4.0K 0B 100% /compat/linux/sys 210/dev/da0 msdosfs 7.6G 424M 7.2G 5% /mnt/usb 211.Ed 212.Pp 213Show previously collected data including inode statistics except for devfs or 214linsysfs file systems. 215Note that the 216.Dq no 217prefix affects all the file systems in the list and the 218.Fl t 219option can be specified only once: 220.Bd -literal -offset indent 221$ df -i -n -t nodevfs,linsysfs 222Filesystem 1K-blocks Used Avail Capacity iused ifree %iused 223Mounted on 224/dev/ada1p2 223235736 159618992 45757888 78% 1657590 27234568 6% / 225/dev/ada0p1 1892163184 176319420 1564470712 10% 1319710 243300576 1% 226/data 227/dev/da0 7989888 433664 7556224 5% 0 0 100% 228/mnt/usb 229.Ed 230.Pp 231Show human readable information for the file system containing the file 232.Pa /etc/rc.conf 233: 234.Bd -literal -offset indent 235$ df -h /etc/rc.conf 236Filesystem Size Used Avail Capacity Mounted on 237/dev/ada1p2 213G 152G 44G 78% / 238.Ed 239.Pp 240Same as above but specifying some file system: 241.Bd -literal -offset indent 242$ df -h /dev/ada1p2 243Filesystem Size Used Avail Capacity Mounted on 244/dev/ada1p2 213G 152G 44G 78% / 245.Ed 246.Sh SEE ALSO 247.Xr lsvfs 1 , 248.Xr quota 1 , 249.Xr fstatfs 2 , 250.Xr getfsstat 2 , 251.Xr statfs 2 , 252.Xr getbsize 3 , 253.Xr getmntinfo 3 , 254.Xr libxo 3 , 255.Xr localeconv 3 , 256.Xr xo_parse_args 3 , 257.Xr fstab 5 , 258.Xr mount 8 , 259.Xr pstat 8 , 260.Xr quot 8 , 261.Xr swapinfo 8 262.Sh STANDARDS 263With the exception of most options, 264the 265.Nm 266utility conforms to 267.St -p1003.1-2004 , 268which defines only the 269.Fl k , P 270and 271.Fl t 272options. 273.Sh HISTORY 274A 275.Nm 276command appeared in 277.At v1 . 278.Sh BUGS 279The 280.Fl n 281flag is ignored if a file or file system is specified. 282Also, if a mount 283point is not accessible by the user, it is possible that the file system 284information could be stale. 285.Pp 286The 287.Fl b 288and 289.Fl P 290options are identical. 291The former comes from the BSD tradition, and the latter is required 292for 293.St -p1003.1-2004 294conformity. 295