Provided by: greylistd_0.8.8.6_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