summaryrefslogtreecommitdiff
path: root/static/openbsd/man8/spamd-setup.8
diff options
context:
space:
mode:
authorJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 19:54:44 -0400
committerJacob McDonnell <jacob@jacobmcdonnell.com>2026-04-25 19:54:44 -0400
commita9157ce950dfe2fc30795d43b9d79b9d1bffc48b (patch)
tree9df484304b560466d145e662c1c254ff0e9ae0ba /static/openbsd/man8/spamd-setup.8
parent160aa82b2d39c46ad33723d7d909cb4972efbb03 (diff)
docs: Added All OpenBSD Manuals
Diffstat (limited to 'static/openbsd/man8/spamd-setup.8')
-rw-r--r--static/openbsd/man8/spamd-setup.8123
1 files changed, 123 insertions, 0 deletions
diff --git a/static/openbsd/man8/spamd-setup.8 b/static/openbsd/man8/spamd-setup.8
new file mode 100644
index 00000000..4d9ec339
--- /dev/null
+++ b/static/openbsd/man8/spamd-setup.8
@@ -0,0 +1,123 @@
+.\" $OpenBSD: spamd-setup.8,v 1.21 2016/03/31 15:54:17 schwarze Exp $
+.\"
+.\" Copyright (c) 2003 Jason L. Wright (jason@thought.net)
+.\" All rights reserved.
+.\"
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\" notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\" notice, this list of conditions and the following disclaimer in the
+.\" documentation and/or other materials provided with the distribution.
+.\"
+.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
+.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
+.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
+.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT,
+.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+.\" POSSIBILITY OF SUCH DAMAGE.
+.\"
+.Dd $Mdocdate: March 31 2016 $
+.Dt SPAMD-SETUP 8
+.Os
+.Sh NAME
+.Nm spamd-setup
+.Nd parse and load file of spammer addresses
+.Sh SYNOPSIS
+.Nm spamd-setup
+.Op Fl bDdn
+.Sh DESCRIPTION
+The
+.Nm
+utility sends blacklist data to
+.Xr spamd 8 ,
+as well as configuring mail rejection messages for
+blacklist entries.
+.Pp
+When
+.Nm
+is run in blacklist only mode,
+it also sends blacklist data to the
+.Xr pf 4
+table
+.Pf < Ar spamd Ns > .
+The
+.Pf < Ar spamd Ns >
+table must then be used in conjunction with a
+.Xr pf 4
+redirection rule to selectively redirect mail connections
+to
+.Xr spamd 8 .
+.Pp
+The options are as follows:
+.Bl -tag -width Ds
+.It Fl b
+Blacklisting only mode.
+Blacklist data is normally stored only in
+.Xr spamd 8 .
+With this flag, data is stored in both
+.Xr spamd 8
+and
+.Xr pf 4 .
+Use this flag if
+.Xr spamd 8
+is running with the
+.Fl b
+flag too.
+.It Fl D
+Daemonize;
+run
+.Nm
+in the background.
+.It Fl d
+Debug mode reports a few pieces of information.
+.It Fl n
+Dry-run mode.
+No data is shipped.
+.El
+.Pp
+Lists are specified in the configuration file
+.Pa /etc/mail/spamd.conf
+and are processed in the order specified in the
+.Ar all
+tag.
+Output is concatenated and sent to a running
+.Xr spamd 8 .
+Addresses are sent
+along with the message spamd will give on mail rejection when a
+matching client connects.
+The configuration port for
+.Xr spamd 8
+is found from
+.Xr services 5 ,
+by looking for the named service
+.Em spamd-cfg .
+.Pp
+.Nm
+reads all configuration information from the
+.Xr spamd.conf 5
+file.
+.Sh FILES
+.Pa /etc/mail/spamd.conf
+.Sh SEE ALSO
+.Xr pf.conf 5 ,
+.Xr services 5 ,
+.Xr spamd.conf 5 ,
+.Xr spamd 8
+.Sh BUGS
+Blacklists removed from
+.Pa /etc/mail/spamd.conf
+are not automatically removed from the running
+.Xr spamd 8 .
+If an entry is removed from
+.Pa /etc/mail/spamd.conf
+that is currently in use, it is necessary to restart
+.Xr spamd 8 .
+This applies only to blacklists that are removed entirely, not those
+that are simply modified.