.\" (C) 2002 Ian Gulliver .TH dsbl.conf 5 2002-04-03 .SH NAME dsbl.conf \- configuration file for all DSBL testers .SH SYNOPSIS vi /usr/local/etc/dsbl.conf .br vi ~/.dsblrc .SH 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 .IR $PREFIX /etc is read. .RI ( PREFIX is set at compile time and is .B /usr/local by default. .HP These files are in the format: .br .BR variable_name =" value """" .br .BR variable_name2 =" value2 """" .HP Test program variables: .br .B sender_user .br If you were sending tests as test@example.com, you would set .B sender_user to "test". .B sender_domain .br If you were sending tests as test@example.com, you would set .B sender_domain to "example.com". .B cookie_host .br Host to retrieve testing cookies from .RI ( cookie.dsbl.org for the DSBL). .B cookie_user .br Username to provide to the cookie server to retrieve a cookie. To test anonymously, set this to "". .B cookie_pass .br Password to provide to the cookie server to retrieve a cookie. To test anonymously, set this to "". .B target_user .br If the listing address is listme@dsbl.org, you would set .B target_user to "listme". .B target_domain .br If the listing address is listme@dsbl.org, you would set .B target_domain to "dsbl.org". .B statedir .br The directory to store the current state (last test date) of IPs. Must be writable by .IR spamtrap (1). .B checklist .br The list to check against before testing hosts. If you are an untrusted tester, this should be .IR unconfirmed.dsbl.org , otherwise it should be .IR list.dsbl.org . .B excluded_ip .br Each .B 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. .B http_port .br An array of configuration variables to specify which ports HTTP proxies should be tested for on. .B socks_port .br An array of configuration variables to specify which ports SOCKS 4 and 5 proxies should be tested for on. .B message .br The actual message to send when relay testing. .B parallel .br A positive integer representing the number of test processes to run simultaneously. .B verbosity .br The amount of information to log to standard output. The options are: .IP 0 No logging 1 Log IP addresses as they are tested 10 Debugging level; log everything .HP Server program variables: .br .B mysql_host .br The hostname to use to connect to the MySQL server. .B mysql_user .br The username to use to connect to the MySQL server. .B mysql_pass .br The password to use to connect to the MySQL server. .B mysql_db .br The name of the DSBL-compliant database on the MySQL server. .B tempdir .br The temporary directory in which to store zones while they are being built. This must be on the same filesystem as .BR zonedir . .B zonedir .br The directory in which to store the zones once they are built. This must be on the same filesystem as .BR tempdir . .B unconfirmed_zone .br The fully qualified domain name of the unconfirmed zone. .B confirmed_zone .br The fully qualified domain name of the confirmed (trusted) singlehop zone. .B multihop_zone .br The fully qualified domain name of the confirmed (trusted) multihop zone. .B unconfirmed_nameserver .br The nameserver of the unconfirmed zone that will be provided in SOA record. .B confirmed_nameserver .br The nameserver of the confirmed (trusted) singlehop zone that will be provided in the SOA record. .B multihop_nameserver .br The nameserver of the confirmed (trusted) multihop zone that will be provided in the SOA record. .B zone_contact .br The contact email address to be provided in the SOA records of both zones. This should have a period (.) instead of an at sign (@). .B zone_message .br 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. .B listenip .br The IP address, in dotted quad notation, for the SMTP server to listen on. .B clientsperip .br 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. .B idletimeout .br The time, in seconds, before an idle SMTP session is terminated. This is used to keep server resources available for other connections. .SH AUTHOR Ian Gulliver