debian man page for apache::qpsmtpd

Apache::Qpsmtpd(3pm)					User Contributed Perl Documentation				      Apache::Qpsmtpd(3pm)

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>

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.

perl v5.14.2							    2009-04-02						      Apache::Qpsmtpd(3pm)