NAME
greylistd-setup-exim4 - add/remove support for greylistd in Exim 4
SYNOPSIS
greylistd-setup-exim4 {add|remove|test} [file acl_name] [-option ...]
DESCRIPTION
This utility configures, deconfigures, or tests for greylistd support
in the given Exim 4 configuration file and Access Control List (ACL).
If no file or ACL name is supplied, changes are made to the default
configuration files and ACLs for your distribution.
USAGE
The following commands are available:
add Adds greylistd statement(s).
remove Removes existing greylistd statement(s).
test Tests for the presence of greylistd statement(s), without making
any changes. A zero exit status indicates that the statement(s)
exist(s).
The following options are available:
-quiet Normally, the result of the operation is printed on standard
error; this option inhibits output.
-no-fail
Always exit with a zero status, even on failure. If this option
is given, only the result of successful operations are printed.
-no-reload
Normally, if any changes were made to the Exim 4 configuration
files, greylistd-setup-exim4 invokes the Exim 4 init script,
telling Exim to reload its configuration files. This option
inhibits this behavior.
-netmask=size
In the statement that is inserted in the Exim 4 configuration
file, the remote host address is one of the items that is passed
on to greylistd. This option causes the host address to be
filtered through a netmask of the given size first. Useful
values are between 16 and 31 for IPv4.
-acltype={rcpt|data}
Used in conjunction with the add command to insert a statement
suitable for use in an ACL used to validate the SMTP RCPT TO:
command or the message DATA, respectively. This is implicit
when the supplied ACL name contains either of the substrings
"rcpt" or "data" (such as Debian's default "acl_check_rcpt" and
"acl_check_data" ACLs). Otherwise, this option has to be
present for the add command.
EXAMPLES
greylistd-setup-exim4 add -netmask=24
Adds greylistd statements to any acl_check_rcpt and
acl_check_data ACLs found in any of the following files:
- /etc/exim4/exim4.conf.template
- /etc/exim4/conf.d/acl/30_exim4-config_check_rcpt
- /etc/exim4/conf.d/acl/40_exim4-config_check_data
In these statements, the data passed to greylistd includes the
host address filtered through a 24-bit netmask, rather than the
host's unique IP address. This allows for pools of several Mail
Sending Agents (MSAs) within a given network to be treated as a
single host.
If successful, Exim 4 is told to reload its configuration files.
If a statement already exists, nothing happens - but the program
exits unsuccessfully (non-zero return code).
greylistd-setup-exim4 remove -quiet
Remove greylisting support from the above configuration files
and ACLs. If greylistd statements exist in these files and
ACLs, they are removed, and Exim 4 will reload its configuration
files. The exit code indicates whether the statements were
present and are now successfully removed; but no results are
printed.
greylistd-setup-exim4 add /etc/exim4/exim4.conf.template acl_check_rcpt
-no-reload
If no greylistd statements already exists in the acl_check_rcpt
ACL in the file /etc/exim4/exim4.conf.template, one is inserted.
In this case, the Exim 4 daemon is then NOT told to reload its
configuration files.
BUGS
The statement that is inserted by this utility presumes that the Exim 4
configuration comes from Debian's "exim4-config" package.
Specifically, it makes use of the +relay_from_hosts host list, the
+local_domains and +relay_to_domains domain lists, and the
acl_local_deny_exceptions ACL. A more generalized approach is on my,
ahem, to-do list.
AUTHOR
This python script and manual page is written by Tor Slettnes,
originally for Debian GNU/Linux.
COPYRIGHT
Copyright (C) 2004-2005 Tor Slettnes.
This program is free software; you can redistribute it and/or modify it
under the terms of the GNU General Public License as published by the
Free Software Foundation; either version 2 of the License, or (at your
option) any later version.
This program is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
General Public License for more details.
On a Debian GNU/Linux system, the full text of the GPL is available in
/usr/share/common-licenses/GPL. It is also available at:
http://www.gnu.org/licenses/gpl.html
SEE ALSO
greylist(1), greylistd(8), /usr/share/doc/exim4/spec.txt.gz