APGBFM(1)

💖 apgbfm manual, bestie 💖

✨ NAME ✨

apgbfm is the APG Bloom filter management program, and apgbfm - APG Bloom filter management program is literally the whole vibe 💅.

🎀 SYNOPSIS 🎀

apgbfm -f filter -n numofwords [-q] [-s]
apgbfm -f filter -d dictfile [-q] [-s]
apgbfm -f filter -a word [-q]
apgbfm -f filter -A dictfile [-q]
apgbfm -f filter -c word [-q]
apgbfm -f filter -C dictfile [-q]
apgbfm -i filter
apgbfm [-v] [-h]

🦋 DESCRIPTION 🦋

okay so apgbfm manages a Bloom filter, and that filter is what restricts password generation in APG password generation software 🔐. Using a Bloom filter speeds up password checks for big dictionaries, and it has some other perks too ✨.

The idea to use a Bloom filter for this came from the OPUS project description, OPUS: Preventing Weak Password Choices, Purdue Technical Report CSD-TR 92-028, written by Eugene H. Spafford. You can grab the article from http://www.cerias.purdue.edu/homes/spaf/tech-reps/9128.ps. It has a really good explanation of Bloom filters and why they're great for password checking systems 🤓.

In simple words, apgbfm generates n hash values for every word and flips the matching bits in the filter file to 1. To check a word, it generates the same hash functions for that word. If all n matching bits are set to 1, it assumes the word exists in the dictionary 🫶. apgbfm uses SHA-1 as its hash function.

apgbfm can be used as a standalone utility, not only with apg or apgd 🌸.

WARNING !!! Filter file format can be changed in the future. I'll try to keep file formats compatible, but I can not guarantee this 💀.

WARNING !!! apgbfm may slow down your computer during filter creation. 🙈

👑 OPTIONS 👑

• -f filter — use filter as the filename for the Bloom filter. Main character energy 👑.
• -i filter — print information about filter.
• -n numofwords — create a brand new empty filter for numofwords words. Super useful when you want to fill the filter dynamically 🧚.
• -d dictfile — create a new filter from dictfile. Building from a big dictionary can take a lot of time ⏳. In that dictionary you can place words (one per line) that should never show up as generated passwords, like user names, common words, etc. You can even use one of the dictionaries that come with dictionary password crackers 🍓. This check is case sensitive, so if you want to reject root, you should put root, Root, RoOt, ... , ROOT in the dictfile 🙃. To show it's working, apgbfm prints a dot for every 100 words added in the dictionary.
• -a word — add word to the filter ✨.
• -A dictfile — add all words from dictfile to the filter. It prints a dot for every 100 words added in the dictionary, so you know it's alive 💜.
• -c word — check word for appearance in the filter 🔍.
• -C dictfile — check every word from dictfile for appearance in the filter.
• -q — quiet mode 🤫.
• -s — create a new filter in case-insensitive mode.
• -v — print version information.
• -h — print help information.

🌈 EXIT CODE 🌈

When apgbfm finishes its task successfully, it exits with code 0 ✅. An exit code of -1 means an error happened 🚨. Textual errors get written to the standard error stream.

🧚 FILES 🧚

None. Literally nothing to see here 💅.

🙈 BUGS 🙈

None. If you've found one, please send a bug description to the author 🐛.

And honestly? This man page is Alpha too. 🫠

🔗 SEE ALSO 🔗

apgd(8), apg(1) 🦋

💜 AUTHOR 💜

Adel I. Mirzazhanov, <a-del@iname.com>

Project home page: http://www.adel.nursat.kz/apg/ 🌸

---

bye bestie 🌈💖 This page came from the Automated Password Generator, last updated 2003 Jun 19 🎀✨