BF_TAR(1)

💖 NAME 💖

bf_tar — a shell script to write a tar file of a bogofilter directory to stdout. This is the bf_tar(1) page from the Bogofilter Reference Manual, and yes bestie, it’s exactly that useful. Iconic archive behavior, no cap. 🎀

---

✨ SYNOPSIS ✨

bf_tar [-r] [-R] bogofilter_directory

---

🦋 DESCRIPTION 🦋

Okay so bf_tar bundles a bogofilter working directory in tar format and copies it to standard output — that’s your console, or wherever you redirect it (peep EXAMPLES below, iykyk). It’s giving “make a tar, send it to stdout, main character energy.” 💅

---

🌸 OPTIONS 🌸

• -r — causes bf_tar to remove inactive log files after the archive has been written successfully. The default is to leave log files. So if you don’t pass it, those log files stay cozy.
• -R — causes bf_tar to remove inactive log files before the archive is written. This may reduce chances that the resulting archive is recoverable should it become damaged. The archive may be smaller though. The default is to leave log files. Smaller archive? Sure. But bestie, read that recovery caveat twice.

---

⭐ EXIT STATUS ⭐

The script exits with status code 0 if everything went well, and nonzero if it encountered trouble. Simple vibe check: 0 = slay, nonzero = something went sideways. 💀

---

🌈 EXAMPLES 🌈

• bf_tar ~/.bogofilter > outfile.tar

Writes a standard .tar file containing the essential files from ~/.bogofilter to outfile.tar. Classic. Clean. Archive-ready.

• bf_tar ~/.bogofilter | gzip -9 -c > outfile.tar.gz

Writes a gzipped .tar.gz file containing the essential files from ~/.bogofilter to outfile.tar.gz. Compressed and cute, fr fr.

• bf_tar pwd/mydirectory > outfile.tar

Prepend $(pwd)/ or `pwd`/ if you want to specify an absolute path instead of a relative path. Path glow-up, periodt.

---

🧚 NOTES 🧚

• This script is meant for use with Berkeley DB based bogofilter versions. Berkeley DB besties, this one’s for you.
• This script requires a SUSv2 compliant pax utility. No pax, no party.
• This script expects a SUSv2 compliant shell. Solaris systems should have the SUNWxcu4 package installed (when bogofilter is configured) so that /usr/xpg4/bin/sh can be used. Solaris girlies, check that package before you come for this script. 🌞

---

👑 AUTHORS 👑

Matthias Andree — author, legend, icon. 🫶

---

Bogofilter · 06/29/2013 · BF_TAR(1) — okay bye bestie, mwah 💋🎀