INSTALL INSTRUCTIONS FOR THE pl-SaPd DAEMON                                    
rev. 1, 07/18/2001

Step 1: Configure sendmail
You must have a sendmail system with the feature "access db" enabled. Identifiy
this feature by looking at your sendmail configuration file and note the 
location of the database (usually /etc/mail/access.db).

Step 2: Qpopper configuration
pl-SaPd works only with the current version 4.x of the Qualcomm POP3 daemon.
If you're running an older version, do a little update first. Qpopper must 
be configured for statistical logging to a specified file. This means that
you have to add "-s" and "-t <LOGFILE>" in /etc/inetd.conf. Example:

pop3    stream  tcp     nowait  root    /usr/sbin/tcpd  /usr/local/bin/popper -s -t /var/log/qpopper

Step 3: Configure the script
Save the script where you like and make it executable (ie. chmod 700 as root)
Some of the first lines in the script may need modification to fit your system:

location of perl
#!/usr/bin/perl -w 	

logfile location
$logfile="/var/log/qpopper" ;

addresses are vaild for n seconds (3600 = 1 hour)
$seconds_valid=7200;

location of files
$temp_list="/tmp/pl-SaPd.map";
$access_db="/etc/mail/access.db";

let this address always relay
$always_relay="127";

Step 4: Configure the init script
In the init script, you must specify the location of the script (where you put it in step 3).
Then, you can alter the logfile location or set it to /dev/null to get rid of all messages.
Place the init script where they all are stored on your box (often /etc/rc.d or init.d) and place
"K" and "S"-links in the runlevel directories you like.
The script contains some stuff like ". /etc/rc.config" and "return=$rc_failed". This only works on 
SuSE systems, on others you should remove this entries.

Step 5: Test if it works
Start by running the init script as root with arument "start". 
Check your pop3 mailbox. You should see a line like this in /var/log/mail or wherever mail.notice
goes whith your syslog configuration:

Jul 17 23:19:06 yourhostname pl-SaPd[9685]: DB rebuildt

Now, your client should be able to relay trough your server.