FILTER-MONKEY.CONF(5)

NAME
filter-monkey.conf - filter-monkey configuration file

DESCRIPTION
filter-monkey.conf is the configuration file for filter-monkey(8).

The file consists of rules that, when matched, cause filter-monkey(8) to delay or reject mails.

Comments can be put anywhere in the file using a hash mark (‘#’), and extend to the end of the current line. Emtpy lines and lines starting with ‘#’ are ignored, as well as leading whitespaces.

The syntax of filter-monkey.conf is described below.

    delay <min>:<max> on <command> Add a random delay (between min and max milliseconds before sending the response for the given command.

    reject <n>% on <command> [<code> <status>] Reject the given command with a probability of n percent. A response code and status line may be specified. Multiple reject rules can be registered for the same command, but the total probability must not exceed 100%.

    close <n>% on <command> [<code> <status>] Same as reject, but forces the SMTP engine to close the session after sending the status line.

EXAMPLES
The default filter-monkey.conf file which ships with OpenSMTPD-extras contains commented examples.

FILES
/etc/filter-monkey.conf
    Default filter-monkey.conf configuration file.

SEE ALSO
filter_api(3), smtpd.conf(5), filter-monkey(8), smtpd(8)

HISTORY
The first version of filter-monkey.conf was written in 2013.

AUTHORS
Eric Faurot <eric@openbsd.org>