spamd-dnsbld/spamd-dnsbld.conf.5

.\" Copyright (c) 2019 Markus Hennecke <markus-hennecke@markus-hennecke.de>
.\"
.\" Permission to use, copy, modify, and distribute this software for any
.\" purpose with or without fee is hereby granted, provided that the above
.\" copyright notice and this permission notice appear in all copies.
.\"
.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN
.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF
.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
.\"
.Dd $Mdocdate: April 18 2019 $
.Dt SPAMD-DNSBLD.CONF 5
.Os
.Sh NAME
.Nm spamd-dnsbld.conf
.Nd spamd-dnsbld configuration file
.Sh DESCRIPTION
This manual page describes the format of the
.Xr spamd-dnsbld 8
configuration file.
.Pp
.Nm
has the following format:
.Pp
Empty lines and lines beginning with the
.Sq #
character are ignored.
.Pp
.Bl -tag -width Ds
.It Ic set autowhitelist Ar { on / off }
Enables or disables automatic whitelisting. The default setting is to not
whitelist IPs automatically.
.It Ic list Ar NAME Ic has dns Ar FQDN
Specifies the base domain used for the black list lookups. The IP address
$1.$2.$3.$4 is prepended to the $basedn for the lookup: $4.$3.$2.$1.$basedn .
The IP is listed in the list if a valid result matchin 127.0.x.y is
returned.
.Pp
At least one list definition is required for the configuration to be valid.
.It Ic spamd logfile Ar spamdlog
Specifies the file
.Xr spamd 8
logs the connection attempts. The default is
.Pa /var/log/spamd .
At this time it is not possible to specify a logfile outside of the
.Ar /var/log
directory.
.Sh FILES
.Bl -tag -width "/etc/mail/spamd-dnsbld.conf" -compact
.It Pa /etc/mail/spamd-dnsbld.conf
Default configuration file.
.El
.Sh SEE ALSO
.Xr spamd-dnsbld 8 ,
.Xr spamd 8 ,
.Xr spamdb 8 ,