NAME

       dsbl.conf - configuration file for all DSBL testers

SYNOPSIS

       vi /usr/local/etc/dsbl.conf
       vi ~/.dsblrc

DESCRIPTION

       dsbl.conf  and  .dsblrc  both  control  the functioning of the DSBL test programs and DSBL
       server programs.  ~/.dsblrc is read if it exists, otherwise dsbl.conf  in  $PREFIX/etc  is
       read.  (PREFIX is set at compile time and is /usr/local by default.

       These files are in the format:
              variable_name="value"
              variable_name2="value2"

       Test program variables:
              sender_user
              If you were sending tests as test@example.com, you would set sender_user to "test".

              sender_domain
              If  you  were  sending  tests  as  test@example.com, you would set sender_domain to
              "example.com".

              cookie_host
              Host to retrieve testing cookies from (cookie.dsbl.org for the DSBL).

              cookie_user
              Username  to  provide  to  the  cookie  server  to  retrieve  a  cookie.   To  test
              anonymously, set this to "".

              cookie_pass
              Password  to  provide  to  the  cookie  server  to  retrieve  a  cookie.   To  test
              anonymously, set this to "".

              target_user
              If the listing address is listme@dsbl.org, you would set target_user to "listme".

              target_domain
              If  the  listing  address  is  listme@dsbl.org,  you  would  set  target_domain  to
              "dsbl.org".

              statedir
              The directory to store the current state (last test date) of IPs.  Must be writable
              by spamtrap(1).

              checklist
              The list to check against before testing hosts.  If you are  an  untrusted  tester,
              this should be unconfirmed.dsbl.org, otherwise it should be list.dsbl.org.

              excluded_ip
              Each  excluded_ip  entry  is checked against the beginning of an IP before testing.
              You should list IPs that are local to you and therefor shouldn't be tested.

              http_port
              An array of configuration variables to specify which ports HTTP proxies  should  be
              tested for on.

              socks_port
              An  array  of  configuration variables to specify which ports SOCKS 4 and 5 proxies
              should be tested for on.

              message
              The actual message to send when relay testing.

              parallel
              A positive integer representing the number of test processes to run simultaneously.

              verbosity
              The amount of information to log to standard output.  The options are:

                      0  No logging
                      1  Log IP addresses as they are tested
                     10  Debugging level; log everything

       Server program variables:
              mysql_host
              The hostname to use to connect to the MySQL server.

              mysql_user
              The username to use to connect to the MySQL server.

              mysql_pass
              The password to use to connect to the MySQL server.

              mysql_db
              The name of the DSBL-compliant database on the MySQL server.

              tempdir
              The temporary directory in which to store zones while they are being  built.   This
              must be on the same filesystem as zonedir.

              zonedir
              The directory in which to store the zones once they are built.  This must be on the
              same filesystem as tempdir.

              unconfirmed_zone
              The fully qualified domain name of the unconfirmed zone.

              confirmed_zone
              The fully qualified domain name of the confirmed (trusted) singlehop zone.

              multihop_zone
              The fully qualified domain name of the confirmed (trusted) multihop zone.

              unconfirmed_nameserver
              The nameserver of the unconfirmed zone that will be provided in SOA record.

              confirmed_nameserver
              The nameserver of the confirmed (trusted) singlehop zone that will be  provided  in
              the SOA record.

              multihop_nameserver
              The  nameserver  of  the confirmed (trusted) multihop zone that will be provided in
              the SOA record.

              zone_contact
              The contact email address to be provided in the SOA records of  both  zones.   This
              should have a period (.) instead of an at sign (@).

              zone_message
              The TXT message to provide for each IP in the zones.  This should end in the dollar
              sign character ($) which is replaced by the IP in question.

              listenip
              The IP address, in dotted quad notation, for the SMTP server to listen on.

              clientsperip
              The maximum number of clients per source IP address that will be  accepted  by  the
              SMTP  server.   Additional  clients from this IP address will be turned away with a
              temporary error.  This is used to prevent attacks from tying up the entire server.

              idletimeout
              The time, in seconds, before an idle SMTP session is terminated.  This is  used  to
              keep server resources available for other connections.

AUTHOR

       Ian Gulliver <ian@penguinhosting.net>

                                            2002-04-03                               dsbl.conf(5)