df(1)

✨ df(1) — bestie edition ✨

ok so this is df, from the uutils coreutils girlies 💖 it's the little tool that tells you how much space your file systems are eating. she's iconic, she's simple, she's about to become your best friend. let's go 🫶

---

🌸 NAME 🌸

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

no cap, that's literally it. she peeks at the filesystem and reports back 💅

---

🎀 SYNOPSIS 🎀

df [--help] [-a|--all] [-B|--block-size] [--total] [-h|--human-readable]
[-H|--si] [-i|--inodes] [-k ] [-l|--local] [--no-sync] [--output]
[-P|--portability] [--sync] [-t|--type] [-T|--print-type]
[-x|--exclude-type] [-V|--version] [paths]

---

🦋 DESCRIPTION 🦋

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

that's the whole vibe. you point her at files, or you don't, and she tells you what's up with the disk space. main character energy honestly ⭐

---

💅 OPTIONS 💅

• --help — print help information. she's helpful like that 🥰
• -a, --all — include dummy file systems. yes bestie, even the fake ones get a moment 🌈
• -B, --block-size <SIZE> — scale sizes by SIZE before printing them; e.g. '-BM' prints sizes in units of 1,048,576 bytes. big numbers deserve a glow-up ✨
• --total — produce a grand total. a lil sum-sum at the end, obsessed 🧮
• -h, --human-readable — print sizes in human readable format (e.g., 1K 234M 2G). so your brain doesn't have to do math, we love her for that 💖
• -H, --si — likewise, but use powers of 1000 not 1024. metric girlies rise 🫶
• -i, --inodes — list inode information instead of block usage. different flavor, same slay 🎀
• -k — like --block-size=1K. tiny option, big energy 💅
• -l, --local — limit listing to local file systems. keep it close to home 🏠
• --no-sync — do not invoke sync before getting usage info (default). chill mode, no extra work 💤
• --output[=<FIELD_LIST>...] — [default: source,size,used,avail,pcent,target]

use output format defined by FIELD_LIST, or print all fields if FIELD_LIST is omitted. you're the director, you pick the columns 🎬

Possible values:

• source
• fstype
• itotal
• iused
• iavail
• ipcent
• size
• used
• avail
• pcent
• file
• target

• -P, --portability — use the POSIX output format. for when you gotta be ✨professional✨
• --sync — invoke sync before getting usage info (non-windows only). flush it first bestie, no shortcuts 🚿
• -t, --type <TYPE> — limit listing to file systems of type TYPE. filter queen 👑
• -T, --print-type — print file system type. say it loud, say it proud 📣
• -x, --exclude-type <TYPE> — limit listing to file systems not of type TYPE. bye felicia 👋
• -V, --version — print version. gotta know which era of her you're dealing with 💜
• [paths] — the files/dirs you wanna ask about. optional, she'll do the whole system if you don't say anything 🌸

---

🔥 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.

ngl the precedence order here is a whole thing — env vars, --block-size, then the defaults. read it twice, it's giving ✨subtle✨. and yes, decimal AND hex AND octal AND binary units are all valid, she contains multitudes 💀

---

💖 VERSION 💖

v(uutils coreutils) 0.7.0

---

and that's the tea ☕ this was df (uutils coreutils) 0.7.0, page df(1) — go check your disk space bestie, she's waiting 🦋💖 periodt ✨