Relayer - Control SMTP relaying

NAME

Relayer - Control SMTP relaying


FUNCTION

Relayer - launched by modified Qpopper, maintains access_db function for Sendmail


DESCRIPTION

Relayer is launched by Qualcomm's Qpopper POP3 daemon. Qpopper must have it's source code modified appropriately, see CONFIGURATION below. Sendmail must be using the access_db feature. Relayer maintains the state of two hash databases. One for the actual entries in the access_db, and one for the timestamps of those entries. The time a user is allowed to relay mail is configurable within Relayer.


REQUIREMENTS

relayer requires PERL 5.x, and DB_File. Relayer has been tested on Linux and Solaris, and the source code modification works on both platforms. The access_db feature is a standard option with Sendmail. A new configuration file must be generated if this capability is not present.


USAGE

relayer has been tested with:

        Version 8.9.x, 8.11.x of Sendmail
        Linux
        Solaris 2.6
        BSDI
        Qpopper 2.53
        Qpopper 3.x
        Qpopper 3.1
        Berkeley DB 2.6.4
        Berkeley DB 3.x
        PERL 5.6
        PERL 5.005x


CONFIGURATION

qpopper must have it's source code modified. Three patches are included:

        v2.53
        v3.x prior to version 3.1
        v3.1

Please see the INSTALL file for more current information regarding installation, and patching.

Qpopper must be compiled with -DAUTH_SPECIAL, and your OS must support AUTH_SPECIAL if your version is less than Qpopper 3.1, otherwise it must be configured with --enable-specialauth

Sendmail must use the access_db feature. Relayer must be modified to reflect the location of this database. Both Sendmail and Relayer MUST be compiled against the SAME DB version. This was designed using Berkeley DB 2.6.4, and Berkeley DB 3.x. Do not use this program with Berkeley DB 1.85.

Relayer should be run with the -init flag after it's variables have been properly modified for your site.

Relayer plays very well with a stock installation of Redhat 7.0. Nothing particularly special is required beyond patching and installing Qpopper.

A cron entry should be created to execute relayer -expire every 5 minutes or so.


LICENSE

All versions prior to 1.9: Copyright 1998-1999 by Interliant

               http://www.interliant.com/

All Versions beyond and including 1.9:

               All Rights Reserved
               Copyright 2000 by ps-ax, Inc. 
               http://ps-ax.com

This was designed and written by Brad Doctor (bdoctor@ps-ax.com) Redistribution and use are permitted under the terms of the GNU Public License.


Modifications

Modifications are expressly allowed per the GPL. If you are using this at your site, please let me know as I will notify you of updates.


Author / Maintainer

 Brad Doctor
 http://ps-ax.com/
 bdoctor@ps-ax.com