DF(1)

📦 version 0.12.0, in arch rolling

💾 DF(1) — like, the manual page for df (General Commands Manual) ✨

okay so bestie, welcome to df(1) — the General Commands Manual entry that tells you everything about your disk space situation. it's giving "financial advisor but for your filesystem" 💅

🌸 NAME

df — show information about the file system on which each FILE resides, or all file systems by default. no cap, that's literally the whole job 🫶

✨ SYNOPSIS

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

🎀 DESCRIPTION

Show information about the file system on which each FILE resides, or all file systems by default. that's it, that's the vibe. you point it at stuff, it tells you where that stuff lives and how much room is left 🦋

💅 OPTIONS

  • --help — print help information. your little cheat sheet, slay.
  • -a, --all — include dummy file systems. yes, even the fake ones get an invite to the party 🙈
  • -B, --block-size <SIZE> — scale sizes by SIZE before printing them; e.g. '-BM' prints sizes in units of 1,048,576 bytes. math but make it cute 🧚
  • --total — produce a grand total. the final boss number, periodt 👑
  • -h, --human-readable — print sizes in human readable format (e.g., 1K 234M 2G). honestly the moment it stops being a wall of digits 💖
  • -H, --si — likewise, but use powers of 1000 not 1024. same energy, different base, iykyk.
  • -i, --inodes — list inode information instead of block usage. plot twist: it's not about bytes anymore 🔥
  • -k — like --block-size=1K. tiny flag, big shortcut.
  • -l, --local — limit listing to local file systems. no network nonsense, just home 🏠 (well, the filesystems that live locally, anyway)
  • --no-sync — do not invoke sync before getting usage info (default). it just... doesn't bother. and that's the default, so.
  • --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. you literally get to pick your own layout, main character energy forreal 🎀

Possible values:

  • source
  • fstype
  • itotal
  • iused
  • iavail
  • ipcent
  • size
  • used
  • avail
  • pcent
  • file
  • target
  • -P, --portability — use the POSIX output format. classic, proper, respectful 💅
  • --sync — invoke sync before getting usage info (non-windows only). note the caveat bestie, it's non-windows only ⭐
  • -t, --type <TYPE> — limit listing to file systems of type TYPE. filter era 🌈
  • -T, --print-type — print file system type. now you know what kind of filesystem you're dealing with 🔍
  • -x, --exclude-type <TYPE> — limit listing to file systems not of type TYPE. the inverse filter, we love a boundary-setter 💜
  • -V, --version — print version. hi, what's your sign, what's your build number.
  • [paths] — the paths you can pass along, because sometimes you want specifics, not the whole world 🌍

🦋 EXTRA

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). so it checks in order — iconique priority list fr fr 📋

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. so many flavours, and they're all valid, no gatekeeping 💀✨

⚠️ heads up bestie: the ordering of all these sources is the whole deal here — first available wins, so if you set multiple, the first one in that chain is the one that actually runs the show.

👑 VERSION

v(uutils coreutils) 0.12.0 — that's the version, and it's serving 🌟

and that's the page!! dated 2026-09-17, from the General Commands Manual, DF(1) — mwah, go check your disk space, ily, bye 🫶💖

📦 where this page comes from