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 kills itself after a timeout:
       % env TCPREMOTEIP=127.0.0.2 rblsmtpd -t 2 echo whoops
       rblsmtpd: pid 5838: 451 Blackholed ...
       220 rblsmtpd.local
    -t 2 means that rblsmtpd will die 2 seconds after sending the 220.
    (The normal timeout is 60 seconds.)

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

 6. 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

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


How to reject mail from sites listed on the RBL:

 8. 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 for various options you may want to set.

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

10. 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.
