# man > df

---
type: CommandReference
command: df
mode: man
section: 1
source: man-pages
---

## Quick Reference
- `df` — Display all filesystems and their disk usage (default 1K-blocks)
- `df /path/to/file` — Display the filesystem containing the specified file
- `df -k` — Use 1024-byte (kibibyte) units
- `df -h` — Human-readable sizes (powers of 1024)
- `df -i` — Show inode usage instead of blocks
- `df -T` — Include filesystem type
- `df -P` — POSIX portable output format

## Name
df — report file system disk space usage

## Synopsis
`df [OPTION]... [FILE]...`

## Options
- `-a, --all` — include pseudo, duplicate, inaccessible file systems
- `-B, --block-size=SIZE` — scale sizes by SIZE (e.g., `-BM` for 1,048,576 bytes). Defaults to 1K unless `POSIXLY_CORRECT` is set, then 512.
- `-h, --human-readable` — print sizes in powers of 1024 (e.g., 1023M)
- `-H, --si` — print sizes in powers of 1000 (e.g., 1.1G)
- `-i, --inodes` — list inode information instead of block usage
- `-k` — equivalent to `--block-size=1K`
- `-l, --local` — limit listing to local file systems
- `-P, --portability` — use POSIX output format
- `-t, --type=TYPE` — limit listing to file systems of type TYPE
- `-T, --print-type` — print file system type
- `-x, --exclude-type=TYPE` — limit listing to file systems not of type TYPE
- `--total` — produce a grand total (elide insignificant entries)
- `--output[=FIELD_LIST]` — use custom output format; valid fields: `source`, `fstype`, `itotal`, `iused`, `iavail`, `ipcent`, `size`, `used`, `avail`, `pcent`, `file`, `target`
- `--sync` — invoke sync before getting usage info
- `--no-sync` — do not invoke sync (default)
- `--help` — display help and exit
- `--version` — output version information and exit

**SIZE format**: integer optionally followed by unit: K, M, G, T, P, E, Z, Y (powers of 1024) or KB, MB, … (powers of 1000). Binary prefixes: KiB=K, MiB=M, etc.

## See Also
- Full documentation: [GNU coreutils df](https://www.gnu.org/software/coreutils/df)
- Local info: `info '(coreutils) df invocation'`