DF(1)                      OpenBSD Reference Manual                      DF(1)

NAME
     df - display free disk space

SYNOPSIS
     df [-hiklnP] [-t type] [[file | file_system] ...]

DESCRIPTION
     The df utility displays statistics about the amount of free disk space on
     the specified file_system or on the file system of which file is a part.
     By default, values are displayed as 512-byte block counts.  If neither a
     file nor a file_system operand is specified, statistics for all mounted
     file systems are displayed (subject to the -l and -t options below).

     The options are as follows:

     -h      "Human-readable" output.  Use unit suffixes: Byte, Kilobyte,
             Megabyte, Gigabyte, Terabyte, Petabyte, Exabyte in order to re-
             duce the number of digits to four or less.  This option is incom-
             patible with the -P option.

     -i      Include statistics on the number of free inodes.  This option is
             incompatible with the -P option.

     -k      By default, all sizes are reported in 512-byte block counts.  The
             -k option causes the numbers to be reported in kilobyte counts.

     -l      Display statistics only about mounted file systems with the
             MNT_LOCAL flag set.  If a non-local file system is given as an
             argument, a warning is issued and no information is given on that
             file system.

     -n      Print out the previously obtained statistics from the file sys-
             tems.  This option should be used if it is possible that one or
             more file systems are in a state such that they will not be able
             to provide statistics without a long delay.  When this option is
             specified, df will not request new statistics from the file sys-
             tems, but will respond with the possibly stale statistics that
             were previously obtained.

     -P      Print out information in a stricter format designed to be parsed
             by portable scripts.

     -t type
             Indicate the actions should only be taken on file systems of the
             specified type.  More than one type may be specified in a comma-
             separated list.  The list of file system types can be prefixed
             with ``no'' to specify the file system types for which action
             should not be taken.  If a file system is given on the command
             line that is not of the specified type, a warning is issued and
             no information is given on that file system.

     It is not an error to specify more than one of the mutually exclusive op-
     tions -h and -k.  Where more than one of these options is specified, the
     last option given overrides the others.

     The df utility exits 0 on success, and >0 if an error occurs.

ENVIRONMENT
     BLOCKSIZE  If the environment variable BLOCKSIZE is set, and the -h or -k
                options are not specified, the block counts will be displayed
                in units of that size block.

EXAMPLES
     Output, in a strict format suitable for portable scripts, disk space
     statistics for the /usr file system using kilobyte block sizes:

           $ df -kP /usr

SEE ALSO
     quota(1), getfsstat(2), statfs(2), getmntinfo(3), fstab(5), mount(8),
     quot(8)

STANDARDS
     The df utility is compliant with the IEEE Std 1003.1-2008 (``POSIX'')
     specification.

     The flags [-hiln] are extensions to that specification.

     Behaviour for the -t flag differs between this implementation and IEEE
     Std 1003.1-2008 (``POSIX'').

HISTORY
     A df utility appeared in Version 3 AT&T UNIX.

OpenBSD 4.7                      June 4, 2009                                2
