DF(1)

📦
version 0.12.0 · 7 versions
, in ubuntu stonking

💖 df — like, tell me about my file systems bestie 💖

okay so this is df from the General Commands Manual — it's the little tool you hit up when you wanna know how much space your disks are actually using, and she always delivers ✨

🌸 NAME 🌸

df — bestie, this shows you info about the file system that each FILE lives on, or like, literally every file system by default 💅

🦋 SYNOPSIS 🦋

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

✨ DESCRIPTION ✨

Show info about the file system on which each FILE resides — or, if you don't name any files at all, she just shows you all the file systems. main character energy fr fr 👑

🎀 OPTIONS 🎀

  • --help — prints help info, the lil "here's what I can do" moment 🫶
  • -a, --all — includes the dummy file systems too, no one gets left out 💖
  • -B, --block-size <SIZE> — scales sizes by SIZE before printing them; like, -BM prints sizes in units of 1,048,576 bytes 🔢
  • --total — produces a grand total, the big finale, the slay 💅
  • -h, --human-readable — prints sizes in a human readable format (e.g., 1K 234M 2G) so your eyes don't die 😭
  • -H, --si — same vibe as above but uses powers of 1000, not 1024 🌈
  • -i, --inodes — lists inode info instead of block usage 👀
  • -k — literally just like --block-size=1K ⭐
  • -l, --local — limits the listing to local file systems only, keep it close to home 🏠
  • --no-sync — does not invoke sync before grabbing usage info (this is the default, so like, she's just being upfront about it) 🙈
  • --output[=<FIELD_LIST>...] [default: source,size,used,avail,pcent,target] — uses the output format defined by FIELD_LIST, or prints all the fields if FIELD_LIST is omitted. you get to pick your own adventure bestie ✨

Possible values:

  • source
  • fstype
  • itotal
  • iused
  • iavail
  • ipcent
  • size
  • used
  • avail
  • pcent
  • file
  • target
  • -P, --portability — uses the POSIX output format, for when you gotta be ✨portable✨
  • --sync — invokes sync before getting usage info (non-windows only, so windows girlies sit this one out) 🪟
  • -t, --type <TYPE> — limits the listing to file systems of type TYPE 🎯
  • -T, --print-type — prints the file system type, so you know exactly what you're dealing with 🔍
  • -x, --exclude-type <TYPE> — limits the listing to file systems not of type TYPE — the anti-TYPE agenda 🚫
  • -V, --version — prints the version 📌
  • [paths] — you can hand her some paths, she'll handle it 🫶

💜 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) 💫

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 — she's flexible like that 💅

🌟 VERSION 🌟

v(uutils coreutils) 0.12.0

🔥 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 <https://tldr.sh> under the CC BY 4.0 License. Please note that, as uutils is a work in progress, some examples might fail. 😭

ok real talk bestie — 2026-09-25, DF(1), that's the whole vibe, go check your disk space, you ate 💖✨👑
📦 where this page comes from