Provided by: greylistd_0.9.0.2+nmu1_all bug

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 © 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