---
name: "dsbl.conf"
section: "5"
platform: "linux"
package: "dsbltesters"
version: "0.9.5-4"
release: "Debian 8 (Jessie)"
platforms: ["linux"]
url: "https://new.carta.tech/dsbl.conf"
---

# dsbl.conf(5)

configuration file for all DSBL testers

## 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)](/spamtrap/1.md).

**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\>