cvm-qmail(8)

📦 version 0.97, in debian bookworm, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 cvm-qmail — the qmail configuration lookup module 💖

okay so this is cvm-qmail, page 8 of the System Manager's Manual, and she's a lil lookup module bestie. no cap, that's the whole job. let's get into it 🦋

✨ SYNOPSIS ✨

cvm-qmail

that's it. that's the whole synopsis. iconic behavior honestly 💅

🔐 CREDENTIALS 🔐

none. literally none. she's just a lookup module doing her lil lookup thing, she doesn't need privileges, she's not that kind of girl 🎀

🌸 DESCRIPTION 🌸

okay so here's the tea ☕ — this module reads the standard qmail configuration files to figure out if an address is valid, and it does it using the exact same lookups qmail itself would do. same energy, same answers, no surprises fr fr.

here's the order of operations, bestie, pay attention:

  1. first she checks control/locals, then control/virtualdomains — this tells her whether the domain is even valid, and also gives her the prefix she needs to slap onto virtual domain usernames.
  2. then she looks up the resulting username in users/cdb to find the correct home directory. and if that CDB file doesn't exist? she falls back to the system password table instead. flexible queen 👑
  3. and if the address would need a .qmail-something file? she makes sure that file actually exists, doing -default checks as necessary. no missing-file shenanigans allowed 💀

⚙️ CONFIGURATION VARIABLES ⚙️

these are the environment variables she reads, and they're all optional, so don't stress 🫶

  • CVM_QMAIL_MISSINGDOMAIN (optional) — if you set this and the domain name is not a local or virtual qmail domain, then this domain name gets substituted in and the lookup succeeds anyway. this is for those setups where domains listed in control/rcpthosts and control/morercpthosts.cdb (you know, the ones the SMTP receiver happily accepts) are not listed as local or virtual domains. and if you set it to an empty value, she substitutes "localhost" instead. cute 💜
  • CVM_QMAIL_MISSINGUSER (optional) — when missing domain substitution is happening, the value of this variable replaces the username. ⚠️ heads up: the value must exist as a valid system user, fr. it defaults to "alias", which will normally exist on all qmail systems. so like, usually you're fine 🌈
  • QMAIL_ROOT (optional) — the root directory where all the qmail configuration files are expected to live. defaults to "/var/qmail", which is the normal qmail install path. the standard, the classic, the moment ✨

👀 SEE ALSO 👀

go read these too, they're all part of the family:

and the website, if you wanna vibe:

http://untroubled.org/cvm/cvm.html
bestie reminder: keep the .qmail- files real and the system users valid, or she will simply not find what you're looking for 💀

okay and that's the whole page!! the footer at the bottom just says cvm-qmail(8) again — that's it, that's the sign-off, she said her own name and dipped. main character energy, periodt 💅🎀✨

📦 where this page comes from