Like any other piece of software (and information generally), rblsmtpd
comes with NO WARRANTY.


Things you have to decide before starting:

* The rblsmtpd home directory, normally /usr/local. To change this
directory, edit conf-home now.


How to install:

 1. Compile the programs and format the man pages:
       % make

 2. Install the programs and man pages:
       # make setup check


How to test:

 3. See if rblsmtpd notices that 127.0.0.2 is on the RBL:
       % env TCPREMOTEIP=127.0.0.2 rblsmtpd echo whoops
       rblsmtpd: pid ...: 451 Blackholed ...
       220 rblsmtpd.local
       help
       451 Blackholed - see <URL:http://maps.vix.com/cgi-bin/lookup?127.0.0.2>
       quit
       221 rblsmtpd.local

 4. See if rblsmtpd -b uses a permanent error code:
       % env TCPREMOTEIP=127.0.0.2 rblsmtpd -b echo whoops
       rblsmtpd: pid ...: 553 Blackholed ...
       220 rblsmtpd.local
       help
       553 Blackholed - see <URL:http://maps.vix.com/cgi-bin/lookup?127.0.0.2>
       quit
       221 rblsmtpd.local

 5. See if rblsmtpd kills itself after a timeout:
       % env TCPREMOTEIP=127.0.0.2 rblsmtpd -t2 echo whoops
       rblsmtpd: pid ...: 451 Blackholed ...
       220 rblsmtpd.local
    -t2 means that rblsmtpd will die 2 seconds after sending the 220.
    (The normal timeout is 60 seconds.)

 6. See if rblsmtpd allows mail from 127.0.0.1:
       % env TCPREMOTEIP=127.0.0.1 rblsmtpd echo ok
       ok

 7. See if rblsmtpd understands an empty $RBLSMTPD:
       % env RBLSMTPD= TCPREMOTEIP=127.0.0.2 rblsmtpd echo ok
       ok

 8. See if rblsmtpd understands a nonempty $RBLSMTPD:
       % env RBLSMTPD=Error TCPREMOTEIP=127.0.0.1 rblsmtpd echo whoops
       rblsmtpd: pid ...: 451 Error
       220 rblsmtpd.local
       help
       451 Error
       quit
       221 rblsmtpd.local

 9. See if rblsmtpd understands a nonempty $RBLSMTPD with a permanent
    error code:
       % env RBLSMTPD=-Error TCPREMOTEIP=127.0.0.1 rblsmtpd echo whoops
       rblsmtpd: pid ...: 553 Error
       220 rblsmtpd.local
       help
       553 Error
       quit
       221 rblsmtpd.local


How to reject mail from sites listed on the RBL:

10. Insert rblsmtpd before the real SMTP server in your tcpserver line.
    For example, with sendmail, you can run
       # tcpserver -v 0 25 rblsmtpd sendmail -bs &
    See rblsmtpd.0 and antirbl.0 for further documentation.

11. Send some test messages from other hosts to make sure that normal
    mail still works.

12. Send a test message to nelson-rbl-test@crynwr.com from the same
    host. You should receive one response message showing a blocked SMTP
    conversation.


That's it! To report success:
       % ( echo 'First M. Last'; cat `cat SYSDEPS` ) | mail djb-qst@cr.yp.to
Replace First M. Last with your name.
