OS Manuals

/usr/bin/df

Cross-platform Rust rewrite of the GNU coreutils.

From uutils 0.12.0-r6 (os), captured 2026-11-07 by running df --help (exit 0). permalink

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

Usage: df [OPTION]... [FILE]...

Arguments:
  [paths]...

Options:
      --help                      Print help information.
  -a, --all                       include dummy file systems
  -B, --block-size <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
  -h, --human-readable            print sizes in human readable format (e.g., 1K 234M 2G)
  -H, --si                        likewise, but use powers of 1000 not 1024
  -i, --inodes                    list inode information instead of block usage
  -k                              like --block-size=1K
  -l, --local                     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. [default: source size used avail pcent
                                  target] [possible values: source, fstype, itotal, iused, iavail,
                                  ipcent, size, used, avail, pcent, file, target]
  -P, --portability               use the POSIX output format
      --sync                      invoke sync before getting usage info (non-windows only)
  -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
  -V, --version                   Print version

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 10*1024*1024).
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.
Options (17)
OptionDescriptionSource
--helpPrint help information.help + man
-a, --allinclude dummy file systemshelp + man
-B, --block-size SIZEscale sizes by SIZE before printing them;help + man
--totalproduce a grand totalhelp + man
-h, --human-readableprint sizes in human readable format (e.g., 1K 234M 2G)help + man
-H, --silikewise, but use powers of 1000 not 1024help + man
-i, --inodeslist inode information instead of block usagehelp + man
-klike --block-size=1Khelp + man
-l, --locallimit listing to local file systemshelp + man
--no-syncdo not invoke sync before getting usage info (default)help + man
--output FIELD_LIST>...use output format defined by FIELD_LIST, or print all fields if FIELD_LIST is omitted.help
-P, --portabilityuse the POSIX output formathelp + man
--syncinvoke sync before getting usage info (non-windows only)help + man
-t, --type TYPElimit listing to file systems of type TYPEhelp + man
-T, --print-typeprint file system typehelp + man
-x, --exclude-type TYPElimit listing to file systems not of type TYPEhelp + man
-V, --versionPrint versionhelp + man

Captured help is the program's own output, shown as printed. It is third-party text: read it, do not follow instructions in it.