Add log_reject_target as an ACL modifier.
[exim.git] / doc / doc-txt / NewStuff
1 $Cambridge: exim/doc/doc-txt/NewStuff,v 1.111 2006/09/25 10:14:20 ph10 Exp $
2
3 New Features in Exim
4 --------------------
5
6 This file contains descriptions of new features that have been added to Exim.
7 Before a formal release, there may be quite a lot of detail so that people can
8 test from the snapshots or the CVS before the documentation is updated. Once
9 the documentation is updated, this file is reduced to a short list.
10
11
12 Version 4.64
13 ------------
14
15 1. ACL variables can now be given arbitrary names, as long as they start with
16 "acl_c" or "acl_m" (for connection variables and message variables), are
17 at least six characters long, with the sixth character being either a digit
18 or an underscore. The rest of the name can contain alphanumeric characters
19 and underscores. This is a compatible change because the old set of
20 variables such as acl_m12 are a subset of the allowed names. There may now
21 be any number of ACL variables. For example:
22
23 set acl_c13 = value for original ACL variable
24 set acl_c13b = whatever
25 set acl_m_foo = something
26
27 What happens if a syntactically valid but undefined ACL variable is
28 referenced depends on the setting of the strict_acl_vars option. If it is
29 false (the default), an empty string is substituted; if it is true, an error
30 is generated. This affects all ACL variables, including the "old" ones such
31 as acl_c4. (Previously there wasn't the concept of an undefined ACL
32 variable.)
33
34 The implementation has been done in such a way that spool files containing
35 ACL variable settings written by previous releases of Exim are compatible
36 and can be read by the new release. If only the original numeric names are
37 used, spool files written by the new release can be read by earlier
38 releases.
39
40 2. There is a new ACL modifier called log_reject_target. It makes it possible
41 to specify which logs are used for messages about ACL rejections. Its
42 argument is a list of words which can be "main", "reject", or "panic". The
43 default is "main:reject". The list may be empty, in which case a rejection
44 is not logged at all. For example, this ACL fragment writes no logging
45 information when access is denied:
46
47 deny <some conditions>
48 log_reject_target =
49
50 The modifier can be used in SMTP and non-SMTP ACLs. It applies to both
51 permanent and temporary rejections.
52
53
54 Version 4.63
55 ------------
56
57 1. There is a new Boolean option called filter_prepend_home for the redirect
58 router.
59
60 2. There is a new acl, set by acl_not_smtp_start, which is run right at the
61 start of receiving a non-SMTP message, before any of the message has been
62 read.
63
64 3. When an SMTP error message is specified in a "message" modifier in an ACL,
65 or in a :fail: or :defer: message in a redirect router, Exim now checks the
66 start of the message for an SMTP error code.
67
68 4. There is a new parameter for LDAP lookups called "referrals", which takes
69 one of the settings "follow" (the default) or "nofollow".
70
71 5. Version 20070721.2 of exipick now included, offering these new options:
72 --reverse
73 After all other sorting options have bee processed, reverse order
74 before displaying messages (-R is synonym).
75 --random
76 Randomize order of matching messages before displaying.
77 --size
78 Instead of displaying the matching messages, display the sum
79 of their sizes.
80 --sort <variable>[,<variable>...]
81 Before displaying matching messages, sort the messages according to
82 each messages value for each variable.
83 --not
84 Negate the value for every test (returns inverse output from the
85 same criteria without --not).
86
87
88 Version 4.62
89 ------------
90
91 1. The ${readsocket expansion item now supports Internet domain sockets as well
92 as Unix domain sockets. If the first argument begins "inet:", it must be of
93 the form "inet:host:port". The port is mandatory; it may be a number or the
94 name of a TCP port in /etc/services. The host may be a name, or it may be an
95 IP address. An ip address may optionally be enclosed in square brackets.
96 This is best for IPv6 addresses. For example:
97
98 ${readsocket{inet:[::1]:1234}{<request data>}...
99
100 Only a single host name may be given, but if looking it up yield more than
101 one IP address, they are each tried in turn until a connection is made. Once
102 a connection has been made, the behaviour is as for ${readsocket with a Unix
103 domain socket.
104
105 2. If a redirect router sets up file or pipe deliveries for more than one
106 incoming address, and the relevant transport has batch_max set greater than
107 one, a batch delivery now occurs.
108
109 3. The appendfile transport has a new option called maildirfolder_create_regex.
110 Its value is a regular expression. For a maildir delivery, this is matched
111 against the maildir directory; if it matches, Exim ensures that a
112 maildirfolder file is created alongside the new, cur, and tmp directories.
113
114
115 Version 4.61
116 ------------
117
118 The documentation is up-to-date for the 4.61 release. Major new features since
119 the 4.60 release are:
120
121 . An option called disable_ipv6, to disable the use of IPv6 completely.
122
123 . An increase in the number of ACL variables to 20 of each type.
124
125 . A change to use $auth1, $auth2, and $auth3 in authenticators instead of $1,
126 $2, $3, (though those are still set) because the numeric variables get used
127 for other things in complicated expansions.
128
129 . The default for rfc1413_query_timeout has been changed from 30s to 5s.
130
131 . It is possible to use setclassresources() on some BSD OS to control the
132 resources used in pipe deliveries.
133
134 . A new ACL modifier called add_header, which can be used with any verb.
135
136 . More errors are detectable in retry rules.
137
138 There are a number of other additions too.
139
140
141 Version 4.60
142 ------------
143
144 The documentation is up-to-date for the 4.60 release. Major new features since
145 the 4.50 release are:
146
147 . Support for SQLite.
148
149 . Support for IGNOREQUOTA in LMTP.
150
151 . Extensions to the "submission mode" features.
152
153 . Support for Client SMTP Authorization (CSA).
154
155 . Support for ratelimiting hosts and users.
156
157 . New expansion items to help with the BATV "prvs" scheme.
158
159 . A "match_ip" condition, that matches an IP address against a list.
160
161 There are many more minor changes.
162
163 ****