1.\" $OpenBSD: spamd-setup.8,v 1.14 2007/03/08 07:55:05 jmc Exp $ 2.\" 3.\" Copyright (c) 2003 Jason L. Wright (jason@thought.net) 4.\" All rights reserved. 5.\" 6.\" Redistribution and use in source and binary forms, with or without 7.\" modification, are permitted provided that the following conditions 8.\" are met: 9.\" 1. Redistributions of source code must retain the above copyright 10.\" notice, this list of conditions and the following disclaimer. 11.\" 2. Redistributions in binary form must reproduce the above copyright 12.\" notice, this list of conditions and the following disclaimer in the 13.\" documentation and/or other materials provided with the distribution. 14.\" 15.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR 16.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 17.\" WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 18.\" DISCLAIMED. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, 19.\" INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 20.\" (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 21.\" SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) 22.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, 23.\" STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN 24.\" POSSIBILITY OF SUCH DAMAGE. 25.\" 26.Dd February 14, 2003 27.Dt SPAMD-SETUP 8 28.Os 29.Sh NAME 30.Nm spamd-setup 31.Nd parse and load file of spammer addresses 32.Sh SYNOPSIS 33.Nm spamd-setup 34.Op Fl bdn 35.Sh DESCRIPTION 36The 37.Nm 38utility sends blacklist data to 39.Xr spamd 8 , 40as well as configuring mail rejection messages for 41blacklist entries. 42.Pp 43When 44.Nm 45is run in blacklist only mode, 46instead of sending blacklist data directly to 47.Xr spamd 8 , 48it sends it to the 49.Xr pf 4 50table 51.Aq Ar spamd . 52The 53.Aq Ar spamd 54table must then be used in conjunction with a 55.Xr pf 4 56redirection rule to selectively redirect mail connections 57to 58.Xr spamd 8 . 59.Pp 60The options are as follows: 61.Bl -tag -width Ds 62.It Fl b 63Blacklisting only mode. 64Blacklist data is normally stored only in 65.Xr spamd 8 . 66With this flag, data is stored in both 67.Xr spamd 8 68and 69.Xr pf 4 . 70Use this flag if 71.Xr spamd 8 72is running with the 73.Fl b 74flag too. 75.It Fl d 76Debug mode reports a few pieces of information. 77.It Fl n 78Dry-run mode. 79No data is shipped. 80.El 81.Pp 82Lists are specified in the configuration file 83.Pa /etc/mail/spamd.conf 84and are processed in the order specified in the 85.Ar all 86tag. 87Output is concatenated and sent to a running 88.Xr spamd 8 . 89Addresses are sent 90along with the message spamd will give on mail rejection when a 91matching client connects. 92The configuration port for 93.Xr spamd 8 94is found from 95.Xr services 5 , 96by looking for the named service 97.Em spamd-cfg . 98.Pp 99.Nm 100reads all configuration information from the 101.Xr spamd.conf 5 102file. 103.Sh FILES 104.Bd -literal 105/etc/mail/spamd.conf 106.Ed 107.Sh SEE ALSO 108.Xr pf.conf 5 , 109.Xr services 5 , 110.Xr spamd.conf 5 , 111.Xr spamd 8 112.Sh BUGS 113Blacklists removed from 114.Pa /etc/mail/spamd.conf 115are not automatically removed from the running 116.Xr spamd 8 . 117If an entry is removed from 118.Pa /etc/mail/spamd.conf 119that is currently in use, it is necessary to restart 120.Xr spamd 8 . 121This applies only to blacklists that are removed entirely, not those 122that are simply modified. 123