df -- report filesystem disk space usage


df is as specified in the SUS but with the variations listed in the Differences section below, and as follows.

Disk space is shown in 1K blocks by default, unless the environment variable POSIXLY_CORRECT is set, in which case 512-byte blocks are used.

If an argument is the absolute file name of a disk device node containing a mounted filesystem, df shows the space available on that filesystem rather than on the filesystem containing the device node (which is always the root filesystem).


-a, --all

includes filesystems having 0 blocks.


uses SIZE-byte blocks.

-h, --human-readable

prints sizes in human-readable format (e.g., 1K, 234M, 2G).

-H, --si

prints sizes in human-readable format, but uses powers of 1000 (not 1024).

-i, --inodes

lists inode information instead of block usage.

-l, --local

limits listing to local filesystems.

-m, --megabytes

is like --block-size=1048576


does not invoke sync before getting usage info. (default)

-P, --portability

uses the POSIX output format.


invokes sync before getting usage info.

-t, --type=TYPE

has implementation-dependent behavior.


is same as -P as specified in the SUS.


invokes sync before getting usage info.

-t, --type=TYPE

limits listing to filesystems of type TYPE. (Different from behavior as specified in the SUS.)

-T, --print-type

prints filesystem type.

-x, --exclude-type=TYPE

limits listing to filesystems not of type TYPE.