Login or Register to Ask a Question and Join Our Community

Linux and UNIX Man Pages

Linux & Unix Commands - Search Man Pages

qpsmtpd::connection(3pm) [debian man page]

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

NAME

       Qpsmtpd::Connection - A single SMTP connection

SYNOPSIS

	 my $rdns = $qp->connection->remote_host;
	 my $ip = $qp->connection->remote_ip;

DESCRIPTION

       This class contains details about an individual SMTP connection. A connection lasts the lifetime of a TCP connection to the SMTP server.

       See also Qpsmtpd::Transaction which is a class containing details about an individual SMTP transaction. A transaction lasts from "MAIL
       FROM" to the end of the "DATA" marker, or a "RSET" command, whichever comes first, whereas a connection lasts until the client disconnects.

API

       These API docs assume you already have a connection object. See the source code if you need to construct one. You can access the connection
       object via the "Qpsmtpd" object's "$qp->connection" method.

   new ( )
       Instantiates a new Qpsmtpd::Connection object.

   start ( %args )
       Initializes the connection object with %args attribute data.

   remote_host( )
       The remote host connecting to the server as looked up via reverse dns.

   remote_ip( )
       The remote IP address of the connecting host.

   remote_port( )
       The remote port.

   remote_info( )
       If your server does an ident lookup on the remote host, this is the identity of the remote client.

   local_ip( )
       The local ip.

   local_port( )
       The local port.

   hello( )
       Either "helo" or "ehlo" depending on how the remote client greeted your server.

       NOTE: This field is empty during the helo or ehlo hooks, it is only set after a successful return from those hooks.

   hello_host( )
       The host name specified in the "HELO" or "EHLO" command.

       NOTE: This field is empty during the helo or ehlo hooks, it is only set after a successful return from those hooks.

   notes($key [, $value])
       Get or set a note on the connection. This is a piece of data that you wish to attach to the connection and read somewhere else. For example
       you can use this to pass data between plugins.

   clone([%args])
       Returns a copy of the Qpsmtpd::Connection object. The optional args parameter may contain:

       no_reset (1|0)
	   If true, do not reset the original connection object, the author has to care about that: only the cloned connection object is reset at
	   the end of the connection

   relay_client( )
       True if the client is allowed to relay messages.

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

Check Out this Related Man Page

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)
Man Page