Export body_linecount and body_zerocount in the local_scan API.
[exim.git] / doc / doc-txt / NewStuff
CommitLineData
2b85bce7 1$Cambridge: exim/doc/doc-txt/NewStuff,v 1.147 2007/06/14 13:27:11 ph10 Exp $
495ae4b0
PH
2
3New Features in Exim
4--------------------
5
38a0a95f
PH
6This file contains descriptions of new features that have been added to Exim.
7Before a formal release, there may be quite a lot of detail so that people can
8test from the snapshots or the CVS before the documentation is updated. Once
9the documentation is updated, this file is reduced to a short list.
10
2b85bce7
PH
11Version 4.68
12------------
13
14 1. The body_linecount and body_zerocount C variables are now exported in the
15 local_scan API.
16
17
b4ed4da0
PH
18Version 4.67
19------------
20
21 1. There is a new log selector called smtp_no_mail, which is not included in
22 the default setting. When it is set, a line is written to the main log
23 whenever an accepted SMTP connection terminates without having issued a
4aa45c31 24 MAIL command.
b4ed4da0 25
431b7361 26 2. When an item in a dnslists list is followed by = and & and a list of IP
4aa45c31
PH
27 addresses, the behaviour was not clear when the lookup returned more than
28 one IP address. This has been solved by the addition of == and =& for "all"
29 rather than the defaule "any" matching.
431b7361 30
4aa45c31
PH
31 3. Up till now, the only control over which cipher suites GnuTLS uses has been
32 for the cipher algorithms. New options have been added to allow some of the
33 other parameters to be varied.
431b7361 34
4aa45c31
PH
35 4. There is a new compile-time option called ENABLE_DISABLE_FSYNC. When it is
36 set, Exim compiles a runtime option called disable_fsync.
431b7361 37
4aa45c31 38 5. There is a new variable called $smtp_count_at_connection_start.
431b7361 39
4aa45c31 40 6. There's a new control called no_pipelining.
cf8b11a5 41
41c7c167 42 7. There are two new variables called $sending_ip_address and $sending_port.
4aa45c31 43 These are set whenever an SMTP connection to another host has been set up.
41c7c167
PH
44
45 8. The expansion of the helo_data option in the smtp transport now happens
4aa45c31 46 after the connection to the server has been made.
41c7c167 47
9c57cbc0 48 9. There is a new expansion operator ${rfc2047d: that decodes strings that
4aa45c31 49 are encoded as per RFC 2047.
9c57cbc0 50
f3f065bb
PH
5110. There is a new log selector called "pid", which causes the current process
52 id to be added to every log line, in square brackets, immediately after the
53 time and date.
54
047bdd8c 5511. Exim has been modified so that it flushes SMTP output before implementing
4c590bd1
PH
56 a delay in an ACL. It also flushes the output before performing a callout,
57 as this can take a substantial time. These behaviours can be disabled by
58 obeying control = no_delay_flush or control = no_callout_flush,
4aa45c31 59 respectively, at some earlier stage of the connection.
047bdd8c 60
0ce9abe6 6112. There are two new expansion conditions that iterate over a list. They are
4aa45c31 62 called forany and forall.
0ce9abe6 63
0e22dfd1
PH
6413. There's a new global option called dsn_from that can be used to vary the
65 contents of From: lines in bounces and other automatically generated
66 messages ("delivery status notifications" - hence the name of the option).
0e22dfd1 67
4aa45c31 6814. The smtp transport has a new option called hosts_avoid_pipelining.
c51b8e75 69
75b1493f 7015. By default, exigrep does case-insensitive matches. There is now a -I option
4aa45c31 71 that makes it case-sensitive.
29f89cad 72
4aa45c31
PH
7316. A number of new features ("addresses", "map", "filter", and "reduce") have
74 been added to string expansions to make it easier to process lists of
75 items, typically addresses.
29f89cad 76
c3611384
PH
7717. There's a new ACL modifier called "continue". It does nothing of itself,
78 and processing of the ACL always continues with the next condition or
79 modifier. It is provided so that the side effects of expanding its argument
4aa45c31 80 can be used.
c3611384 81
ec95d1a6 8218. It is now possible to use newline and other control characters (those with
4aa45c31 83 values less than 32, plus DEL) as separators in lists.
ec95d1a6 84
b2d5182b
PH
8519. The exigrep utility now has a -v option, which inverts the matching
86 condition.
87
c456d9bb 8820. The host_find_failed option in the manualroute router can now be set to
4aa45c31 89 "ignore".
c456d9bb 90
b4ed4da0
PH
91
92Version 4.66
93------------
94
95No new features were added to 4.66.
96
97
98Version 4.65
99------------
100
101No new features were added to 4.65.
102
38a0a95f
PH
103
104Version 4.64
105------------
106
af561417
PH
107 1. ACL variables can now be given arbitrary names, as long as they start with
108 "acl_c" or "acl_m" (for connection variables and message variables), are at
109 least six characters long, with the sixth character being either a digit or
883335dc 110 an underscore.
af561417
PH
111
112 2. There is a new ACL modifier called log_reject_target. It makes it possible
883335dc 113 to specify which logs are used for messages about ACL rejections.
af561417
PH
114
115 3. There is a new authenticator called "dovecot". This is an interface to the
116 authentication facility of the Dovecot POP/IMAP server, which can support a
883335dc 117 number of authentication methods.
af561417
PH
118
119 4. The variable $message_headers_raw provides a concatenation of all the
120 messages's headers without any decoding. This is in contrast to
121 $message_headers, which does RFC2047 decoding on the header contents.
122
883335dc
PH
123 5. In a DNS black list, if two domain names, comma-separated, are given, the
124 second is used first to do an initial check, making use of any IP value
125 restrictions that are set. If there is a match, the first domain is used,
126 without any IP value restrictions, to get the TXT record.
af561417 127
883335dc 128 6. All authenticators now have a server_condition option.
af561417
PH
129
130 7. There is a new command-line option called -Mset. It is useful only in
131 conjunction with -be (that is, when testing string expansions). It must be
132 followed by a message id; Exim loads the given message from its spool
883335dc 133 before doing the expansions.
af561417
PH
134
135 8. Another similar new command-line option is called -bem. It operates like
883335dc
PH
136 -be except that it must be followed by the name of a file that contains a
137 message.
af561417
PH
138
139 9. When an address is delayed because of a 4xx response to a RCPT command, it
140 is now the combination of sender and recipient that is delayed in
883335dc 141 subsequent queue runs until its retry time is reached.
af561417
PH
142
14310. Unary negation and the bitwise logical operators and, or, xor, not, and
883335dc 144 shift, have been added to the eval: and eval10: expansion items.
48c7f9e2 145
194cc0e4
PH
14611. The variables $interface_address and $interface_port have been renamed
147 as $received_ip_address and $received_port, to make it clear that they
148 relate to message reception rather than delivery. (The old names remain
149 available for compatibility.)
150
883335dc
PH
15112. The "message" modifier can now be used on "accept" and "discard" acl verbs
152 to vary the message that is sent when an SMTP command is accepted.
4e88a19f 153
495ae4b0 154
4608d683
PH
155Version 4.63
156------------
157
1581. There is a new Boolean option called filter_prepend_home for the redirect
38a0a95f 159 router.
4608d683 160
45b91596
PH
1612. There is a new acl, set by acl_not_smtp_start, which is run right at the
162 start of receiving a non-SMTP message, before any of the message has been
38a0a95f 163 read.
45b91596 164
a5bd321b
PH
1653. When an SMTP error message is specified in a "message" modifier in an ACL,
166 or in a :fail: or :defer: message in a redirect router, Exim now checks the
38a0a95f 167 start of the message for an SMTP error code.
a5bd321b 168
6ec97b1b 1694. There is a new parameter for LDAP lookups called "referrals", which takes
38a0a95f 170 one of the settings "follow" (the default) or "nofollow".
6ec97b1b 171
e22ca4ac
JJ
1725. Version 20070721.2 of exipick now included, offering these new options:
173 --reverse
174 After all other sorting options have bee processed, reverse order
175 before displaying messages (-R is synonym).
176 --random
177 Randomize order of matching messages before displaying.
178 --size
179 Instead of displaying the matching messages, display the sum
180 of their sizes.
181 --sort <variable>[,<variable>...]
182 Before displaying matching messages, sort the messages according to
183 each messages value for each variable.
184 --not
185 Negate the value for every test (returns inverse output from the
186 same criteria without --not).
187
4608d683 188
1cce3af8
PH
189Version 4.62
190------------
191
1921. The ${readsocket expansion item now supports Internet domain sockets as well
193 as Unix domain sockets. If the first argument begins "inet:", it must be of
194 the form "inet:host:port". The port is mandatory; it may be a number or the
195 name of a TCP port in /etc/services. The host may be a name, or it may be an
196 IP address. An ip address may optionally be enclosed in square brackets.
197 This is best for IPv6 addresses. For example:
198
199 ${readsocket{inet:[::1]:1234}{<request data>}...
200
201 Only a single host name may be given, but if looking it up yield more than
202 one IP address, they are each tried in turn until a connection is made. Once
203 a connection has been made, the behaviour is as for ${readsocket with a Unix
204 domain socket.
205
f7fd3850
PH
2062. If a redirect router sets up file or pipe deliveries for more than one
207 incoming address, and the relevant transport has batch_max set greater than
208 one, a batch delivery now occurs.
209
d6629cdc
PH
2103. The appendfile transport has a new option called maildirfolder_create_regex.
211 Its value is a regular expression. For a maildir delivery, this is matched
212 against the maildir directory; if it matches, Exim ensures that a
213 maildirfolder file is created alongside the new, cur, and tmp directories.
214
1cce3af8 215
7e66e54d
PH
216Version 4.61
217------------
218
4f578862
PH
219The documentation is up-to-date for the 4.61 release. Major new features since
220the 4.60 release are:
221
222. An option called disable_ipv6, to disable the use of IPv6 completely.
223
224. An increase in the number of ACL variables to 20 of each type.
225
226. A change to use $auth1, $auth2, and $auth3 in authenticators instead of $1,
227 $2, $3, (though those are still set) because the numeric variables get used
228 for other things in complicated expansions.
229
843a41e8 230. The default for rfc1413_query_timeout has been changed from 30s to 5s.
4f578862
PH
231
232. It is possible to use setclassresources() on some BSD OS to control the
233 resources used in pipe deliveries.
234
235. A new ACL modifier called add_header, which can be used with any verb.
236
237. More errors are detectable in retry rules.
238
239There are a number of other additions too.
71fafd95 240
7e66e54d 241
425ae40f 242Version 4.60
b5aea5e1
PH
243------------
244
425ae40f
PH
245The documentation is up-to-date for the 4.60 release. Major new features since
246the 4.50 release are:
1a46a8c5 247
425ae40f 248. Support for SQLite.
1a46a8c5 249
425ae40f 250. Support for IGNOREQUOTA in LMTP.
1a46a8c5 251
425ae40f 252. Extensions to the "submission mode" features.
1a46a8c5 253
425ae40f 254. Support for Client SMTP Authorization (CSA).
1a46a8c5 255
425ae40f 256. Support for ratelimiting hosts and users.
b5aea5e1 257
425ae40f 258. New expansion items to help with the BATV "prvs" scheme.
b5aea5e1 259
425ae40f 260. A "match_ip" condition, that matches an IP address against a list.
35edf2ff 261
425ae40f 262There are many more minor changes.
495ae4b0
PH
263
264****