spamd-dnsbld/spamd-dnsbld.8

.\" 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 8
.Os
.Sh NAME
.Nm spamd-dnsbld
.Nd daemon watching the
.Xr spamd 8
logs and trapping hosts on dns black lists
.Sh SYNOPSIS
.Nm
.Bk -words
.Op Fl dnv
.Op Fl f Ar file
.Ek
.Sh DESCRIPTION
The
.Nm
daemon watches the
.Xr spamd 8
log entries and does black list lookups for the
IP addresses logged. If one of the configured black lists returns a
match
.Xr spamdb 8
is used to trap the offending IP address. Optional if no
match occurs the IP address can be whitelisted automatically.
.Pp
The options are as follows:
.Bl -tag -width "-f fileXXX"
.It Fl d
Do not daemonize.
If this option is specified,
.Nm
will run in the foreground and log to
.Em stderr .
.It Fl f Ar file
Use
.Ar file
as the configuration file, instead of the default
.Pa /etc/mail/spamd-dnsbld.conf .
.It Fl n
Configtest mode.
Only check the configuration file for validity.
.It Fl v
This option allows
.Nm
to send DEBUG priority messages to syslog.
.El
.Pp
When
.Nm
starts up, it reads settings from its configuration file, typically
.Xr spamd-dnsbld.conf 5 .
.Pp
Each time
.Xr spamd 8
logs an IP connecting, DNS lookups are done using all the configured lists.
If one of the lists return an IP address the connecting IP is trapped
by calling
.Pa /usr/sbin/spamdb -t -a IP .
If automatic whitelisting is configured the IP will be whitelisted using
.Xr spamdb 8
in case no list returned a valid result.
.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 8 ,
.Xr spamdb 8