cvm-vmailmgr(8)

✨ cvm-vmailmgr ✨

okay bestie, gather round, because this one is literally the cvm-vmailmgr module — the vmailmgr virtual user validation module — and she is here to do exactly one job and do it gorgeously. 💅

🌸 SYNOPSIS 🌸

cvm-vmailmgr

that's it. that's the whole synopsis. no flags, no arguments, no drama. she just is. 👑

🔑 CREDENTIALS 🔑

• Pass phrase

yep, that's the credential type, and that's the whole list. a pass phrase. slay. 💖

💖 DESCRIPTION 💖

so what does she actually do? this module validates credentials using accounts in a vmailmgr system. that's the whole vibe.

the way she does domain lookups? exactly the same way qmail would. no cap. she's out here figuring out which system account and which virtual account to use, and she's doing it the qmail way, because that's the way. 🦋

🎀 CONFIGURATION VARIABLES 🎀

these are the little knobs you can turn. all of them are optional, all of them have defaults, and the defaults are honestly pretty reasonable. iykyk.

• QMAIL_ROOT (optional) — the root directory under which all the qmail configuration files are expected to be found. if you don't set it, she defaults to "/var/qmail", which is the normal qmail install path, aka where qmail usually lives. 🏠
• VMAILMGR_PWFILE (optional) — the relative path to the password file, and it's relative to the virtual domain's home directory. defaults to "passwd.cdb". cute, short, does the job. 🍓
• VMAILMGR_DEFAULT (optional) — the name of the default, aka the "catch-all", account to look up if no match is found for the virtual account name. defaults to "+". heads up though: this one is only used in lookup mode, so don't expect her to pull it out in other situations. 💀

🌈 SEE ALSO 🌈

go read these next, bestie, they're all part of the same friend group:

• cvm-pwfile(8)
• cvm-qmail(8)
• cvm-unix(8)
• cvm-sql(8)
• cvm-benchclient(8)
• cvm-checkpassword(8)
• cvm-testclient(8)

and if you want the whole lore: http://untroubled.org/cvm/cvm.html ✨

aww and that's the page, bestie 🫶 this little icon came out of the System Manager's Manual — it's cvm-vmailmgr(8), and that's the whole sign-off. mwah. 💋