.TH cvm-qmail 8
.SH NAME
cvm-qmail \- qmail configuration lookup module
.SH SYNOPSIS
cvm-qmail
.SH CREDENTIALS
None, only operates as a lookup module.
.SH DESCRIPTION
This module uses the standard qmail configuration files to determine if an
address is valid, using the same lookups that qmail would.
It first checks
.I control/locals
and then
.I control/virtualdomains
to determine if the domain is valid, and to determine the prefix to add to
virtual domain usernames.
It then looks up the resulting username in
.I users/cdb
(or the system password table if the CDB does not exist) to determine the
correct home directory.
If the address would require a
.I .qmail-something
file, it ensures that that file exists as well, doing
.I \-default
checks as necessary.
.SH CONFIGURATION VARIABLES
.TP
.B CVM_QMAIL_MISSINGDOMAIN \fR(optional)
If this is set and the domain name is not a local or virtual qmail domain,
this domain name is substituted and the lookup succeeds.
This allows for setups where domains listed in
.I control/rcpthosts
and
.I control/morercpthosts.cdb
(which are accepted by the SMTP receiver) are not listed as local or virtual
domains.
If this is set to an empty value, "localhost" is substituted.
.TP
.B CVM_QMAIL_MISSINGUSER \fR(optional)
When missing domain substitution is being done, the value of this variable is
used to replace the username.
The value must exist as a valid system user.
Defaults to "alias" which will normally exist on all qmail systems.
.TP
.B QMAIL_ROOT \fR(optional)
The root directory under which all the qmail configuration files are expected
to be found.
Defaults to "/var/qmail", which is the normal qmail install path.
.SH SEE ALSO
cvm-pwfile(8),
cvm-unix(8),
cvm-sql(8),
cvm-vmailmgr(8),
cvm-benchclient(8),
cvm-checkpassword(8),
cvm-testclient(8)

 http://untroubled.org/cvm/cvm.html