df

df [OPTION]... [FILE]...

Show information about the file system on which each FILE resides, or all file systems by default.

Options

--help

Print help information.

--all, -a

include dummy file systems

--block-size=<SIZE>, -B <SIZE>

scale sizes by SIZE before printing them; e.g. ‘-BM’ prints sizes in units of 1,048,576 bytes

--total

produce a grand total

--human-readable, -h

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

--si, -H

likewise, but use powers of 1000 not 1024

--inodes, -i

list inode information instead of block usage

-k

like –block-size=1K

--local, -l

limit listing to local file systems

--no-sync

do not invoke sync before getting usage info (default)

--output=<FIELD_LIST>

use output format defined by FIELD_LIST, or print all fields if FIELD_LIST is omitted.

--portability, -P

use the POSIX output format

--sync

invoke sync before getting usage info (non-windows only)

--type=<TYPE>, -t <TYPE>

limit listing to file systems of type TYPE

--print-type, -T

print file system type

--exclude-type=<TYPE>, -x <TYPE>

limit listing to file systems not of type TYPE

Display values are in units of the first available SIZE from –block-size, and the DF_BLOCK_SIZE, BLOCK_SIZE and BLOCKSIZE environment variables. Otherwise, units default to 1024 bytes (or 512 if POSIXLY_CORRECT is set).

SIZE is an integer and optional unit (example: 10M is 1010241024). Units are K, M, G, T, P, E, Z, Y (powers of 1024) or KB, MB,… (powers of 1000). Units can be decimal, hexadecimal, octal, binary.

Examples

Display all filesystems and their disk usage (using 512-byte units):

df

Display the filesystem containing the specified file or directory:

df {{path/to/file_or_directory}}

Use [k]ibibyte (1024 byte) units when showing size figures:

df -k

Display information in a portable way:

df -P

The examples are provided by the tldr-pages project under the CC BY 4.0 License.

Please note that, as uutils is a work in progress, some examples might fail.