BOGOUPGRADE(1)

✨ BOGOUPGRADE 💖

okay so bestie, welcome to bogoupgrade — it's a Bogofilter Reference Manual page and it's literally the glow-up tool for your bogofilter database. it takes your crusty old-format database and makes it the current format, no cap. 💅

---

🌸 SYNOPSIS 🌸

bogoupgrade [-h] -d directory [-i input file] [-o output file]
            [-b path to bogoutil]

that's it, that's the whole vibe check. 🦋

---

✨ DESCRIPTION ✨

so bogoupgrade is a command that upgrades bogofilter's databases from an old format to the current format. and the reason this exists at all is that the database format changes once in a while (iconic of it honestly), so this utility was designed to make that upgrade easy. it's giving convenience. 🫶

---

💅 OPTIONS 💅

• -h — prints the help message and then dips. that's it, that's the whole job. ✌️
• -d — specifies the directory with the wordlists for converting. you use this one when you're converting from multiple, separate wordlists (spamlist.db and goodlist.db — which contain spam and ham tokens, respectively) over to a combined wordlist (wordlist.db) which holds both spam and ham tokens. glow-up from two to one. 👑
• -i — specifies the input file to be converted. it should be a text file containing message counts, and possibly data. and listen: if there's no data in the text file, there should be a Berkeley DB file in the same directory as the text file that contains the data. so like, the data has to live somewhere, bestie. 🍓
• -o — specifies the output Berkeley DB file. this is where the new-and-improved you goes. 💖
• -b — gives the path to the bogoutil command. it defaults to 'bogoutil', in the hopes that your shell will find it. manifesting that your $PATH has your back. 🙈

---

🌈 UPGRADING 🌈

follow these instructions to upgrade bogofilter's databases to the latest version. we're doing a full makeover, step by step. ✨

1. Stop all instances of bogofilter. okay so even though the upgrade tools lock the database files, the upgrade may take a long time if you have a busy site. and do not forget to stop cron jobs or daemons that fetch and process mail and could fire off bogofilter. like, actually stop them. no cap. 💀
2. Backup your data. let's assume that you said:

$ mv ~/.bogofilter ~/.bogofilter.safe
$ mkdir ~/.bogofilter

the way that you just protected your whole archive... iconic. 🫶

3. If your bogofilter version is less than 0.7, say:

$ bogoupgrade -i ~/.bogofilter.safe/goodlist -o ~/.bogofilter/goodlist.db
$ bogoupgrade -i ~/.bogofilter.safe/badlist -o ~/.bogofilter/spamlist.db

If your bogofilter version is 0.7 or greater, say:

$ bogoupgrade -i ~/.bogofilter.safe/hamlist.count -o ~/.bogofilter/goodlist.db
$ bogoupgrade -i ~/.bogofilter.safe/spamlist.count -o ~/.bogofilter/spamlist.db

pick the right pair for your version, don't mix them up bestie. 🙏

4. Current versions of bogofilter use a combined wordlist that holds both spam and non-spam tokens. it is named wordlist.db. if you're updating from a version older than 0.14.0 that has separate wordlists (named goodlist.db and spamlist.db), use:

$ bogoupgrade -d ~/.bogofilter.safe

one command, one combined list. that's the main character energy. 👑

5. Done. restart any stopped daemons, cron tasks, etc. you ate. 🎀

---

💜 AUTHOR 💜

bogoupgrade was written by Gyepi Sam <gyepi@praxis-sw.com> and David Relson <relson@osagesoftware.com>. absolute legends, fr fr. 🫶

for updates, see the bogofilter project page[1]. ⭐

---

🦋 SEE ALSO 🦋

• bogofilter(1)
• bogolexer(1)
• bogotune(1)
• bogoutil(1)

go read those too, they're all part of the same friend group. 💖

---

📌 NOTES 📌

1. the bogofilter project page http://bogofilter.sourceforge.net/

---

Bogofilter · 05/19/2019 · and that's the whole page bestie, mwah 💋✨🌸