Provided by: dsbltesters_0.9.5-4_i386 bug

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)