dsbl.conf(5)							File Formats Manual						      dsbl.conf(5)

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  connec-
	      tions.

AUTHOR

       Ian Gulliver <ian@penguinhosting.net>

								    2002-04-03							      dsbl.conf(5)