Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

df

v0.13.0
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

-m

like –block-size=1M

--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:

df

Display all filesystems in human-readable form:

df {{[-h|--human-readable]}}

Display the filesystem containing the specified file or directory:

df {{path/to/file_or_directory}}

Include statistics on the number of free inodes:

df {{[-i|--inodes]}}

Display filesystems but exclude the specified types:

df {{[-x|--exclude-type]}} {{squashfs}} {{[-x|--exclude-type]}} {{tmpfs}}

Display filesystem types:

df {{[-T|--print-type]}}

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.