NAME

       cvm-qmail - qmail configuration lookup module

SYNOPSIS

       cvm-qmail

CREDENTIALS

       None, only operates as a lookup module.

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  control/locals  and  then  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 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 .qmail-something file, it
       ensures that that file exists as well, doing -default checks as necessary.

CONFIGURATION VARIABLES

       CVM_QMAIL_MISSINGDOMAIN (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
              control/rcpthosts  and 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.

       CVM_QMAIL_MISSINGUSER (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.

       QMAIL_ROOT (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.

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

                                                                                                    cvm-qmail(8)