NAME

       Apache::Qpsmtpd - a mod_perl-2 connection handler for qpsmtpd

SYNOPSIS

         Listen 0.0.0.0:25 smtp
         AcceptFilter smtp none
         ## "smtp" and the AcceptFilter are required for Linux, FreeBSD
         ## with apache >= 2.1.5, for others it doesn't hurt. See also
         ## http://httpd.apache.org/docs/2.2/mod/core.html#acceptfilter
         ## and http://httpd.apache.org/docs/2.2/mod/mpm_common.html#listen

         LoadModule perl_module modules/mod_perl.so

         <Perl>
         use lib qw( /path/to/qpsmtpd/lib );
         use Apache::Qpsmtpd;
         $ENV{QPSMTPD_CONFIG} = "/path/to/qpsmtpd/config";
         </Perl>

         <VirtualHost _default_:25>
         PerlModule Apache::Qpsmtpd
         PerlProcessConnectionHandler Apache::Qpsmtpd
         # can specify this in config/plugin_dirs if you wish:
         PerlSetVar qpsmtpd.plugin_dirs /path/to/qpsmtpd/plugins
         PerlSetVar qpsmtpd.loglevel 4
         </VirtualHost>

       Using multiple instances of Qpsmtpd on the same server is also possible by setting:

         $ENV{QPSMTPD_CONFIG} = "USE-VIRTUAL-DOMAINS";

       Then in the VirtualHost of each config define the configuration directory:

         PerlSetVar qpsmtpd.config_dir /path/to/qpsmtpd/config

       Several different configurations can be running on the same server.

DESCRIPTION

       This module implements a mod_perl/apache 2.0 connection handler that turns Apache into an
       SMTP server using Qpsmtpd.

       It also allows you to set single-valued config options (such as loglevel, as seen above)
       using "PerlSetVar" in httpd.conf.

       This module should be considered beta software as it is not yet widely tested. However it
       is currently the fastest way to run Qpsmtpd, so if performance is important to you then
       consider this module.

BUGS

       Probably a few. Make sure you test your plugins carefully.

       The Apache scoreboard (/server-status/) mostly works and shows connections, but could do
       with some enhancements specific to SMTP.

AUTHOR

       Matt Sergeant, <matt@sergeant.org>

       Some credit goes to <mock@obscurity.org> for Apache::SMTP which gave me the inspiration to
       do this.  <peter@boku.net> added the virtual host support.