HOLES(1)

📦 version 0.1, in debian bookworm, ubuntu jammy, ubuntu noble, ubuntu resolute

💖 HOLES 💖

okay bestie, so this is the manual page for holes — the little tool that finds runs of zero bytes. yeah. it's giving forensic file detective. let's get into it 🕵️♀️✨

✨ SYNOPSIS ✨

holes [-b byte] [-n minlen] [-s] [files ...]

🌸 DESCRIPTION 🌸

so holes goes looking for runs of zero bytes (a.k.a. holes, hence the name, the branding is immaculate) inside the input files you give it — or in the standard input if you don't give it any files at all, she's flexible like that 💅

then she prints out:

  • the start addresses — in hexadecimal
  • the lengths — in decimal

and when you hand her multiple input files, she's gonna prefix each line with the file name so you actually know which file is which. organized queen. 👑

the options are as follows, and yes we're going through every single one, no skips:

  • -b byte — instead of counting runs of zero bytes, count runs of byte, which has to be a number between 0 and 255. custom hole flavor, obsessed 🍓
  • -n minlen — changes the minimum size of holes reported. by default, only holes of at least 64 bytes get reported. so like, tiny baby holes? not invited. 🙈
  • -s — prints a summary at the end telling you how many percent of the file are runs of zeroes. the vibe check at the end of the journey 📊✨

💀 EXIT STATUS 💀

the holes utility exits 0 on success, and >0 if an error occurs. slay = 0, not slay = bigger than 0. no in between. periodt.

🦋 SEE ALSO 🦋

go read those too, bestie, they're all in the same friend group 🫶

👑 AUTHORS 👑

Leah Neukirchen <leah@vuxu.org> — the icon, the legend, the moment. 🌈⭐

💜 LICENSE 💜

holes is in the public domain. literally free, no strings, no cap. 🎀

to the extent possible under law, the creator of this work has waived all copyright and related or neighboring rights to this work.

http://creativecommons.org/publicdomain/zero/1.0/

and that's the whole page, bestie 💖 this beauty shipped with Debian, dated November 8, 2017 — a classic that still eats, no notes. now go find some holes. 🕳️✨

📦 where this page comes from