Add recognition of SMTP error codes in bespoke messages.
[exim.git] / doc / doc-txt / NewStuff
1 $Cambridge: exim/doc/doc-txt/NewStuff,v 1.105 2006/07/13 13:53:32 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 but have not yet made it into the main manual (which is most conveniently
8 updated when there is a relatively large batch of changes). The doc/ChangeLog
9 file contains a listing of all changes, including bug fixes.
10
11 Version 4.63
12 ------------
13
14 1. There is a new Boolean option called filter_prepend_home for the redirect
15 router. It defaults true, for backward compatibility. If a "save" command in
16 an Exim filter has a relative path for its argument, and $home is defined,
17 it is automatically prepended to the relative path. This action can now be
18 prevented by setting filter_prepend_home false.
19
20 2. There is a new acl, set by acl_not_smtp_start, which is run right at the
21 start of receiving a non-SMTP message, before any of the message has been
22 read. (This is the analogue of the acl_smtp_predata ACL for SMTP input.) The
23 result of this ACL is ignored; it cannot be used to reject a message. If
24 you really need to, you could set a value in an ACL variable here and reject
25 based on that in the acl_not_smtp ACL. However, this ACL can be used to set
26 controls, and in particular, it can be used to set control=suppress_local_
27 fixups, which cannot be used in the acl_not_smtp ACL because by the time
28 that ACL is run, it is too late. When the acl_not_smtp_start ACL is run, the
29 sender and recipients are known, so the "senders" and "sender_domains"
30 conditions and $sender_address and $recipients variables can be used.
31 Variables such as $authenticated_ sender are also available. It is possible
32 to specify added header lines in this ACL.
33
34 3. When an SMTP error message is specified in a "message" modifier in an ACL,
35 or in a :fail: or :defer: message in a redirect router, Exim now checks the
36 start of the message for an SMTP error code. This consists of three digits
37 followed by a space, optionally followed by an extended code of the form
38 n.n.n, also followed by a space. If this is the case and the very first
39 digit is the same as the default error code, the code from the message is
40 used instead. If the very first digit is incorrect, a panic error is logged,
41 and the default code is used. This is an incompatible change, but it is not
42 expected to affect many (if any) configurations. It is possible to suppress
43 the use of the supplied code in a redirect router by setting the
44 smtp_error_code option false. In this case, any SMTP code is quietly
45 ignored.
46
47
48 Version 4.62
49 ------------
50
51 1. The ${readsocket expansion item now supports Internet domain sockets as well
52 as Unix domain sockets. If the first argument begins "inet:", it must be of
53 the form "inet:host:port". The port is mandatory; it may be a number or the
54 name of a TCP port in /etc/services. The host may be a name, or it may be an
55 IP address. An ip address may optionally be enclosed in square brackets.
56 This is best for IPv6 addresses. For example:
57
58 ${readsocket{inet:[::1]:1234}{<request data>}...
59
60 Only a single host name may be given, but if looking it up yield more than
61 one IP address, they are each tried in turn until a connection is made. Once
62 a connection has been made, the behaviour is as for ${readsocket with a Unix
63 domain socket.
64
65 2. If a redirect router sets up file or pipe deliveries for more than one
66 incoming address, and the relevant transport has batch_max set greater than
67 one, a batch delivery now occurs.
68
69 3. The appendfile transport has a new option called maildirfolder_create_regex.
70 Its value is a regular expression. For a maildir delivery, this is matched
71 against the maildir directory; if it matches, Exim ensures that a
72 maildirfolder file is created alongside the new, cur, and tmp directories.
73
74
75 Version 4.61
76 ------------
77
78 The documentation is up-to-date for the 4.61 release. Major new features since
79 the 4.60 release are:
80
81 . An option called disable_ipv6, to disable the use of IPv6 completely.
82
83 . An increase in the number of ACL variables to 20 of each type.
84
85 . A change to use $auth1, $auth2, and $auth3 in authenticators instead of $1,
86 $2, $3, (though those are still set) because the numeric variables get used
87 for other things in complicated expansions.
88
89 . The default for rfc1413_query_timeout has been changed from 30s to 5s.
90
91 . It is possible to use setclassresources() on some BSD OS to control the
92 resources used in pipe deliveries.
93
94 . A new ACL modifier called add_header, which can be used with any verb.
95
96 . More errors are detectable in retry rules.
97
98 There are a number of other additions too.
99
100
101 Version 4.60
102 ------------
103
104 The documentation is up-to-date for the 4.60 release. Major new features since
105 the 4.50 release are:
106
107 . Support for SQLite.
108
109 . Support for IGNOREQUOTA in LMTP.
110
111 . Extensions to the "submission mode" features.
112
113 . Support for Client SMTP Authorization (CSA).
114
115 . Support for ratelimiting hosts and users.
116
117 . New expansion items to help with the BATV "prvs" scheme.
118
119 . A "match_ip" condition, that matches an IP address against a list.
120
121 There are many more minor changes.
122
123 ****