greylistd-setup-exim4(8)

1greylistd-setup-exim4(8)      Mail Administration     greylistd-setup-exim4(8)
2
3
4

NAME

6       greylistd-setup-exim4 - add/remove support for greylistd in Exim 4
7

SYNOPSIS

9       greylistd-setup-exim4 {add|remove|test} [file acl_name] [-option ...]
10

DESCRIPTION

12       This  utility  configures, deconfigures, or tests for greylistd support
13       in the given Exim 4 configuration file and Access Control List (ACL).
14
15       If no file or ACL name is supplied, changes are  made  to  the  default
16       configuration files and ACLs for your distribution.
17

USAGE

19       The following commands are available:
20
21       add    Adds greylistd statement(s).
22
23       remove Removes existing greylistd statement(s).
24
25       test   Tests for the presence of greylistd statement(s), without making
26              any changes.  A zero exit status indicates that the statement(s)
27              exist(s).
28
29       The following options are available:
30
31       -quiet Normally,  the  result  of  the operation is printed on standard
32              error; this option inhibits output.
33
34       -no-fail
35              Always exit with a zero status, even on failure. If this  option
36              is given, only the result of successful operations are printed.
37
38       -no-reload
39              Normally,  if  any changes were made to the Exim 4 configuration
40              files, greylistd-setup-exim4 invokes the  Exim  4  init  script,
41              telling  Exim  to  reload  its configuration files.  This option
42              inhibits this behavior.
43
44       -netmask=size
45              In the statement that is inserted in the  Exim  4  configuration
46              file, the remote host address is one of the items that is passed
47              on to greylistd.  This option causes the host address to be fil‐
48              tered  through a netmask of the given size first.  Useful values
49              are between 16 and 31 for IPv4.
50
51       -acltype={rcpt|data}
52              Used in conjunction with the add command to insert  a  statement
53              suitable  for  use  in an ACL used to validate the SMTP RCPT TO:
54              command or the message DATA,  respectively.   This  is  implicit
55              when  the  supplied  ACL  name contains either of the substrings
56              "rcpt" or "data" (such as Debian's default "acl_check_rcpt"  and
57              "acl_check_data"  ACLs).   Otherwise,  this  option  has  to  be
58              present for the add command.
59

EXAMPLES

61       greylistd-setup-exim4 add -netmask=24
62              Adds   greylistd   statements   to   any   acl_check_rcpt    and
63              acl_check_data ACLs found in any of the following files:
64
65                - /etc/exim4/exim4.conf.template
66                - /etc/exim4/conf.d/acl/30_exim4-config_check_rcpt
67                - /etc/exim4/conf.d/acl/40_exim4-config_check_data
68
69              In  these  statements, the data passed to greylistd includes the
70              host address filtered through a 24-bit netmask, rather than  the
71              host's unique IP address.  This allows for pools of several Mail
72              Sending Agents (MSAs) within a given network to be treated as  a
73              single host.
74
75              If successful, Exim 4 is told to reload its configuration files.
76              If a statement already exists, nothing happens - but the program
77              exits unsuccessfully (non-zero return code).
78
79       greylistd-setup-exim4 remove -quiet
80              Remove  greylisting  support  from the above configuration files
81              and ACLs.  If greylistd statements  exist  in  these  files  and
82              ACLs, they are removed, and Exim 4 will reload its configuration
83              files.  The exit code  indicates  whether  the  statements  were
84              present  and  are  now  successfully removed; but no results are
85              printed.
86
87       greylistd-setup-exim4 add /etc/exim4/exim4.conf.template acl_check_rcpt
88       -no-reload
89              If  no greylistd statements already exists in the acl_check_rcpt
90              ACL in the file /etc/exim4/exim4.conf.template, one is inserted.
91              In  this  case, the Exim 4 daemon is then NOT told to reload its
92              configuration files.
93

BUGS

95       The statement that is inserted by this utility presumes that the Exim 4
96       configuration  comes  from  Debian's  "exim4-config" package.  Specifi‐
97       cally,  it  makes  use  of  the  +relay_from_hosts   host   list,   the
98       +local_domains    and   +relay_to_domains   domain   lists,   and   the
99       acl_whitelist_local_deny ACL.  A more generalized approach  is  on  my,
100       ahem, to-do list.
101

AUTHOR

103       This  python  script and manual page is written by Tor Slettnes, origi‐
104       nally for Debian GNU/Linux.
105

COPYRIGHT

107       Copyright © 2004-2005 Tor Slettnes.
108
109       This program is free software; you can redistribute it and/or modify it
110       under  the  terms of the GNU General Public License as published by the
111       Free Software Foundation; either version 2 of the License, or (at  your
112       option) any later version.
113
114       This  program  is  distributed  in the hope that it will be useful, but
115       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER‐
116       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
117       Public License for more details.
118
119       On a Debian GNU/Linux system, the full text of the GPL is available  in
120       /usr/share/common-licenses/GPL.  It is also available at:
121
122           http://www.gnu.org/licenses/gpl.html
123