bz3grep(1)

💖 bz3grep(1) — bestie's guide to grepping your bzip3 files 💖

okay so real talk, this is the bz3grep manual page, and honestly? it's giving tiny but mighty. it lives in the General Commands Manual section of the man pages, and it's about to make your compressed-file life so much easier. ✨

---

🌸 NAME 🌸

bz3grep — print lines matching a pattern in bzip3-compressed files 💅

like. it greps. but for bzip3 files. no decompressing by hand, no whole song and dance. iconic behavior fr fr.

---

🎀 SYNOPSIS 🎀

bz3grep [grep-flags] [--] pattern [files ...]

that's the whole thing bestie, look at her. so small. so powerful. 🫶

---

✨ DESCRIPTION ✨

so here's the tea ☕ — bz3grep runs grep(1) on your files, and if you don't hand it any files at all, it just goes with stdin. but before any of that grepping happens, it decompresses everything with bz3cat(1). pipeline queen. she does the boring part so you don't have to. 😌

the grep-flags and the pattern argument? those get passed straight on to grep(1), untouched, unbothered, exactly as you meant them. 💯

⚠️ one (1) important plot twist: if there's an -e flag hiding somewhere in your grep-flags, then bz3grep will not go looking for a pattern argument. like, she takes the hint. the pattern's already in the -e, she knows. don't confuse her. 🙈

---

🔥 EXIT STATUS 🔥

here's the vibe check on how she bows out:

• if arguments are missing, or the pattern is missing → she returns 1 😭
• literally any other case → she returns 0 🎉

periodt. no in-between, no drama.

---

🦋 SEE ALSO 🦋

• bzip3(1)

go say hi to the parent program, she's cool too. 💜

---

👑 AUTHORS 👑

this masterpiece was brought to you by Thomas Klausner wiz@NetBSD.org — absolute legend, we stan. 🌟

---

🍓 one more thing, bestie: this very page is version v1.5.5, dated 22 October 2026. treasure it. write it down. put it in the group chat. 💌✨

now go forth and grep your bzip3 files, you gorgeous genius. 💖🎀🦋