MFDBTOOL(1)

📦
version 9.1 · 5 versions
, in ubuntu resolute, ubuntu stonking

💖 MFDBTOOL(1) — User Commands 💖

okay bestie, welcome to the mfdbtool page, she's the Mailfromd database management tool and she's literally here to keep ur databases from going feral 🦋

✨ SYNOPSIS ✨

mfdbtool [OPTION...]

that's it, that's the whole vibe. options only, no positional args, we keep it clean 💅

🌸 DESCRIPTION 🌸

so mfdbtool is the Mailfromd database management tool — it's giving maintenance-mode main character energy. it runs a bunch of commands on ur databases and also tweaks how the config gets loaded. let's break it down, babes 👑

🎀 Database management commands 🎀

the actual Doing Stuff™ part of the program. this is where the magic happens ✨

  • --compact — compact the database. squish it. make it smol but keep it functional 🫶
  • --delete — delete given entries from the database. bye bye entries, we barely knew u 💀
  • --expire — delete expired entries from the database. expired stuff gets yeeted, no cap 🌈
  • --list — list given database (default cache). like a little show-and-tell for ur DB entries 👑

🦋 Command modifiers 🦋

these lil cuties change how the commands above behave. mix and match, iykyk ✨

  • --[no-]all — with --compact or --expire: apply the operation to all available databases. not just one, ALL of them. full send 🔥
  • -d, --debug=LEVEL — set debugging level. crank it up when u need to see everything 🍓
  • -f, --file=FILE — DB file name to operate upon. tell her which file, bestie 📁
  • -H, --format=FORMAT — format of the DB file to operate upon. gotta know the format ok 💅
  • --[no-]ignore-failed-reads — ignore failed reads while compacting the database. live ur truth, skip the oopsies 🙈
  • --predict=RATE — predict when the user will be able to send next message. she's psychic actually 🔮

💜 Configuration modifiers 💜

for when u need to reshape the config situation itself 🌸

  • -e, --expire-interval=NUMBER — set database expiration interval to NUMBER seconds. numbers, but make them seconds ⏱️
  • --state-directory=DIR — set new program state directory. relocate the state, new home new me 🏠

⭐ Global debugging settings ⭐

the debugging options that aren't tied to one lil command 💖

  • --debug-level=LEVEL — set Mailutils debugging level. yes this is a different debug level than the one up there, they're different things, don't @ me 🫶
  • --[no-]debug-line-info — show source info with debugging messages. like a little map of where everything came from 🗺️

🧚 Configuration handling 🧚

how the config files get found, parsed, and vibed with 🌈

  • --config-file=FILE — load this configuration file; implies --no-config. (yes, it quietly turns off the other config loading, that's just how she is 💅)
  • --config-lint — check configuration file syntax and exit. a vibe check for ur config ✨
  • --config-verbose — verbosely log parsing of the configuration files. narration mode: ON 🎙️
  • --no-site-config, --no-config — do not load site-wide configuration file. skipping the site-wide one entirely 🙈
  • --set=PARAM=VALUE — set configuration parameter. name it, value it, done 💖

👑 Informational options 👑

no changes, just facts. pure information delivery, she ate 📚

  • --config-help — show configuration file summary. the tl;dr of ur config 🎀
  • --show-config-options — show compilation options. what was baked in at build time 🍓
  • -?, --help — give this help list. the classic 🫶
  • --usage — give a short usage message. the speedrun version ⚡
  • -V, --version — print program version. gotta know what era we're in 💅
⚠️ real talk, bestie: Mandatory or optional arguments to long options are also mandatory or optional for any corresponding short options. so if the long one wants an arg, the short one wants it too. they match, always. periodt 💖

💫 AUTHOR 💫

Written by Sergey Poznyakoff. legend behavior, honestly 👑

🐛 REPORTING BUGS 🐛

found a bug? not a vibe, tell the devs!

Report bugs to <bug-mailfromd@gnu.org.ua>.

mailfromd home page: <http://www.gnu.org.ua/software/mailfromd> 🌐

Copyright © 2005-2023 Sergey Poznyakoff

License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>

This is free software: you are free to change and redistribute it.

There is NO WARRANTY, to the extent permitted by law. (she said it, not me 🫶)

🔍 SEE ALSO 🔍

The full documentation for mfdbtool is maintained as a Texinfo manual. If the info and mfdbtool programs are properly installed at your site, the command

info mfdbtool

should give you access to the complete manual. go read it, it's giving thorough 📖✨

and that's the whole page bestie!! this is mailfromd version 9.1, dated December 2025 — mwah, go manage those databases, u absolute icon 💅💖🎀🦋

📦 where this page comes from