note a caveat about print_topbitchars
[exim.git] / doc / doc-txt / NewStuff
1 $Cambridge: exim/doc/doc-txt/NewStuff,v 1.107 2006/07/21 16:48:42 jetmore 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 4. There is a new parameter for LDAP lookups called "referrals", which takes
48    one of the settings "follow" (the default) or "nofollow". The latter stops
49    the LDAP library from trying to follow referrals issued by the LDAP server.
50
51 5. Version 20070721.2 of exipick now included, offering these new options:
52     --reverse
53         After all other sorting options have bee processed, reverse order
54         before displaying messages (-R is synonym).
55     --random
56         Randomize order of matching messages before displaying.
57     --size
58         Instead of displaying the matching messages, display the sum
59         of their sizes.
60     --sort <variable>[,<variable>...]
61         Before displaying matching messages, sort the messages according to
62         each messages value for each variable.
63     --not
64         Negate the value for every test (returns inverse output from the
65         same criteria without --not).
66
67
68 Version 4.62
69 ------------
70
71 1. The ${readsocket expansion item now supports Internet domain sockets as well
72    as Unix domain sockets. If the first argument begins "inet:", it must be of
73    the form "inet:host:port". The port is mandatory; it may be a number or the
74    name of a TCP port in /etc/services. The host may be a name, or it may be an
75    IP address. An ip address may optionally be enclosed in square brackets.
76    This is best for IPv6 addresses. For example:
77
78      ${readsocket{inet:[::1]:1234}{<request data>}...
79
80    Only a single host name may be given, but if looking it up yield more than
81    one IP address, they are each tried in turn until a connection is made. Once
82    a connection has been made, the behaviour is as for ${readsocket with a Unix
83    domain socket.
84
85 2. If a redirect router sets up file or pipe deliveries for more than one
86    incoming address, and the relevant transport has batch_max set greater than
87    one, a batch delivery now occurs.
88
89 3. The appendfile transport has a new option called maildirfolder_create_regex.
90    Its value is a regular expression. For a maildir delivery, this is matched
91    against the maildir directory; if it matches, Exim ensures that a
92    maildirfolder file is created alongside the new, cur, and tmp directories.
93
94
95 Version 4.61
96 ------------
97
98 The documentation is up-to-date for the 4.61 release. Major new features since
99 the 4.60 release are:
100
101 . An option called disable_ipv6, to disable the use of IPv6 completely.
102
103 . An increase in the number of ACL variables to 20 of each type.
104
105 . A change to use $auth1, $auth2, and $auth3 in authenticators instead of $1,
106   $2, $3, (though those are still set) because the numeric variables get used
107   for other things in complicated expansions.
108
109 . The default for rfc1413_query_timeout has been changed from 30s to 5s.
110
111 . It is possible to use setclassresources() on some BSD OS to control the
112   resources used in pipe deliveries.
113
114 . A new ACL modifier called add_header, which can be used with any verb.
115
116 . More errors are detectable in retry rules.
117
118 There are a number of other additions too.
119
120
121 Version 4.60
122 ------------
123
124 The documentation is up-to-date for the 4.60 release. Major new features since
125 the 4.50 release are:
126
127 . Support for SQLite.
128
129 . Support for IGNOREQUOTA in LMTP.
130
131 . Extensions to the "submission mode" features.
132
133 . Support for Client SMTP Authorization (CSA).
134
135 . Support for ratelimiting hosts and users.
136
137 . New expansion items to help with the BATV "prvs" scheme.
138
139 . A "match_ip" condition, that matches an IP address against a list.
140
141 There are many more minor changes.
142
143 ****