disk(1)

📦
version 2021-03 · 2 versions
, in nixos 26.05

💾 disk(1) — get disk usage information 💾

hey bestie, welcome to disk(1) from the General Commands Manual ✨ this little icon is gonna show you how much disk space your devices are using, and it is lowkey obsessed with formats and patterns.

🦋 NAME 🦋

disk — get disk usage information 💽

🔥 SYNOPSIS 🔥

disk [format] [pattern]

💅 DESCRIPTION 💅

disk retrieves the disk usage information for all devices that match PATTERN and displays it in the format specified by FORMAT. periodt 💖

✨ FORMAT SPECIFIERS ✨

okay so these are the little format besties you can drop into FORMAT, and each one is giving a different unit or filesystem detail 🎀

  • ${fs} — filesystem name, like '/dev/sda5' 🗂️
  • ${mnt} — filesystem mount point, like '/home' 🏠
  • ${b_used} — used space in bytes 📦
  • ${b_free} — available space in bytes 🫶
  • ${b_total} — total space in bytes 👑
  • ${kb_used} — used space in KiB 🌸
  • ${kb_free} — available space in KiB 🌈
  • ${kb_total} — total space in KiB ⭐
  • ${mb_used} — used space in MiB 🍓
  • ${mb_free} — available space in MiB 🧚
  • ${mb_total} — total space in MiB 💜
  • ${gb_used} — used space in GiB 🔥
  • ${gb_free} — available space in GiB 🦋
  • ${gb_total} — total space in GiB 💎

🌸 EXAMPLES 🌸

so if you run disk with no format, like this:

disk

it runs disk with the default format, '${gb_used}G / ${gb_total}G'. sample result: '89G / 981G' 😌✨

a custom format can be used too, e.g.:

disk '${fs} (${mnt}): ${gb_used}GiB / ${gb_total}GiB \
                ($(((gb_used*100)/gb_total))%)' '/$'

sample result: '/dev/sda2 (/): 150GiB / 983GiB (15%)' 💅

note how the pattern must be specified if a custom format is used. bestie, you cannot skip it — the pattern is required when you go custom 🫶

also note that parenthesis must be escaped in the format string; this is mainly due to the format string being an actual sh expression that is evaluated to expand it. see fetchutils(1) for more info 🔍

😭 REPORTING BUGS 😭

please report any bugs to https://github.com/lptstr/fetchutils/issues or to kiedtl@tilde.team 🙈

👑 SEE ALSO 👑

fetchutils(1) 🌟

the full documentation for disk is not maintained as a Texinfo manual. if the info and disk programs are properly installed on your system, the command

info disk

should not give you access to the complete manual. yeah, it's giving "not the whole manual" energy 💀

💜 LICENSE 💜

Copyright © 2020 Kiëd Llaentenn and contributors

this utility is licensed under the MIT license 🎀

okay bye bestie — disk(1) from the General Commands Manual, dated 1980-01-01 💖🫶

📦 where this page comes from