Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SPAMD.CONF(5)		      File Formats Manual		 SPAMD.CONF(5)

NAME
       spamd.conf -- spamd configuration file

SYNOPSIS
       /usr/local/etc/spamd/spamd.conf

DESCRIPTION
       The  spamd.conf	file is	read by	spamd-setup(8) to configure blacklists
       for spamd(8).  Blacklists are lists of addresses	 of  likely  spammers.
       Mail  from these	addresses never	reaches	the actual mail	server,	but is
       instead redirected to spamd(8) and tarpitted.

       spamd.conf follows the syntax of	configuration databases	as  documented
       in getcap(3).  Here is an example:

	     all:\
		     :spews1:override:myblack:

	     spews1:\
		     :black:\
		     :msg="SPAM. Your address %A is in the spews\
		     level 1 database\nsee http://www.spews.org/ask.cgi?x=%A\n":\
		     :method=http:\
		     :file=www.spews.org/spews_list_level1.txt:

	     override:\
		     :white:\
		     :method=file:\
		     :file=/var/mail/override.txt:

	     myblack:\
		     :black:\
		     :msg=/var/mail/myblackmsg.txt:\
		     :method=file:\
		     :file=/var/mail/myblack.txt:

       The default configuration file must include the entry all, which	speci-
       fies the	order in which lists are to be applied.	 Lists are constructed
       by  name:  blacklists  are  identified by the capability	:black:.  If a
       list is instead given the :white: capability, addresses in it will  not
       be blacklisted.	The addresses in such a	list are removed from the pre-
       ceding blacklist.

       In  the	above  example,	 if an address was present in all three	lists,
       blacklists spews1 and myblack, as well as the exceptions	list override,
       the address would  be  removed  from  list  spews1  by  the  subsequent
       override	 list.	 However,  the	address	 would not be removed from the
       myblack list.  To remove	all the	addresses in  override	from  myblack,
       the following configuration would be used instead:

	     all:\
		     :spews1:override:myblack:override:

       The source of the addresses for lists is	specified using	the method and
       file capability entries.

       method  specifies  the  method by which to retrieve a file containing a
       list of addresses and may be one	of http,  ftp,	file,  or  exec.   The
       http, ftp, and file methods will	make spamd.conf	retrieve the file from
       the  location  specified	 by the	file capability.  The exec method will
       make spamd.conf spawn the program with arguments	indicated in the  file
       capability  for the list, and reads a list of addresses from the	output
       of the program.

       The format of the list of addresses is expected to consist of one  net-
       work block or address per line (optionally followed by a	space and text
       that is ignored).  Comment lines	beginning with # are ignored.  Network
       blocks may be specified in any of the formats as	in the following exam-
       ple:

	     # CIDR format
	     192.168.20.0/24
	     # A start - end range
	     192.168.21.0 - 192.168.21.255
	     # As a single IP address
	     192.168.23.1

       Each  blacklist must include a message, specified in the	msg capability
       as a string.  If	the msg	string is enclosed in double quotes, the char-
       acters in the quoted string are escaped as specified in getcap(3)  with
       the  exception  that  a colon (:) is allowed in the quoted string.  The
       resulting string	is used	as the message.	  Alternatively,  if  the  msg
       string is not specified in quotes, it is	assumed	to be a	local filename
       from which the message text may be read.

       The  message is configured in spamd(8) to be displayed in the SMTP dia-
       logue to	any connections	that match addresses in	 the  blacklist.   The
       sequence	 \"  in	the message will produce a double quote	in the output.
       The sequence %% will produce a single % in the output, and the sequence
       %A will be expanded in the message by spamd(8) to display the  connect-
       ing IP address in the output.

SEE ALSO
       ftp(1), spamd(8), spamd-setup(8)

FreeBSD	Ports 14.quarterly	 May 31, 2007			 SPAMD.CONF(5)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=spamd.conf&sektion=5&manpath=FreeBSD+Ports+14.3.quarterly>

home | help