Merge branch 'experimental_ocsp'
[exim.git] / doc / doc-txt / NewStuff
CommitLineData
495ae4b0
PH
1New Features in Exim
2--------------------
3
38a0a95f
PH
4This file contains descriptions of new features that have been added to Exim.
5Before a formal release, there may be quite a lot of detail so that people can
6test from the snapshots or the CVS before the documentation is updated. Once
7the documentation is updated, this file is reduced to a short list.
8
c1e794ba
PP
9Version 4.78
10------------
11
12 1. New authenticator driver, "gsasl". Server-only (at present).
13 This is a SASL interface, licensed under GPL, which can be found at
14 http://www.gnu.org/software/gsasl/.
15 This system does not provide sources of data for authentication, so
3b4f55a3 16 careful use needs to be made of the conditions in Exim.
c1e794ba 17
97753960
PP
18 2. New authenticator driver, "heimdal_gssapi". Server-only.
19 A replacement for using cyrus_sasl with Heimdal, now that $KRB5_KTNAME
20 is no longer honoured for setuid programs by Heimdal. Use the
21 "server_keytab" option to point to the keytab.
22
252e0c7b
PP
23 3. The "pkg-config" system can now be used when building Exim to reference
24 cflags and library information for lookups and authenticators, rather
25 than having to update "CFLAGS", "AUTH_LIBS", "LOOKUP_INCLUDE" and
7e6a8985
PP
26 "LOOKUP_LIBS" directly. Similarly for handling the TLS library support
27 without adjusting "TLS_INCLUDE" and "TLS_LIBS".
252e0c7b 28
6a6084f8
PP
29 In addition, setting PCRE_CONFIG=yes will query the pcre-config tool to
30 find the headers and libraries for PCRE.
31
f1e05cc7 32 4. New expansion variable $tls_bits.
20aa9dbd 33
4a6a987a
PP
34 5. New lookup type, "dbmjz". Key is an Exim list, the elements of which will
35 be joined together with ASCII NUL characters to construct the key to pass
3b4f55a3
PP
36 into the DBM library. Can be used with gsasl to access sasldb2 files as
37 used by Cyrus SASL.
4a6a987a 38
da3ad30d
PP
39 6. OpenSSL now supports TLS1.1 and TLS1.2 with OpenSSL 1.0.1.
40
41 Avoid release 1.0.1a if you can. Note that the default value of
42 "openssl_options" is no longer "+dont_insert_empty_fragments", as that
43 increased susceptibility to attack. This may still have interoperability
44 implications for very old clients (see version 4.31 change 37) but
45 administrators can choose to make the trade-off themselves and restore
46 compatibility at the cost of session security.
47
7be682ca
PP
48 7. Use of the new expansion variable $tls_sni in the main configuration option
49 tls_certificate will cause Exim to re-expand the option, if the client
50 sends the TLS Server Name Indication extension, to permit choosing a
51 different certificate; tls_privatekey will also be re-expanded. You must
52 still set these options to expand to valid files when $tls_sni is not set.
3f0945ff
PP
53
54 The SMTP Transport has gained the option tls_sni, which will set a hostname
55 for outbound TLS sessions, and set $tls_sni too.
56
57 A new log_selector, +tls_sni, has been added, to log received SNI values
58 for Exim as a server.
59
9cbad13b
PP
60 8. The existing "accept_8bitmime" option now defaults to true. This means
61 that Exim is deliberately not strictly RFC compliant. We're following
62 Dan Bernstein's advice in http://cr.yp.to/smtp/8bitmime.html by default.
63 Those who disagree, or know that they are talking to mail servers that,
64 even today, are not 8-bit clean, need to turn off this option.
65
9ee44efb
PP
66 9. Exim can now be started with -bw (with an optional timeout, given as
67 -bw<timespec>). With this, stdin at startup is a socket that is
68 already listening for connections. This has a more modern name of
69 "socket activation", but forcing the activated socket to fd 0. We're
70 interested in adding more support for modern variants.
71
97d17305
JH
7210. ${eval } now uses 64-bit values on supporting platforms. A new "G" suffux
73 for numbers indicates multiplication by 1024^3.
74
17c76198
PP
7511. The GnuTLS support has been revamped; the three options gnutls_require_kx,
76 gnutls_require_mac & gnutls_require_protocols are no longer supported.
77 tls_require_ciphers is now parsed by gnutls_priority_init(3) as a priority
78 string, documentation for which is at:
79 http://www.gnu.org/software/gnutls/manual/html_node/Priority-Strings.html
80
81 SNI support has been added to Exim's GnuTLS integration too.
82
53947857 8312. With OpenSSL, if built with EXPERIMENTAL_OCSP, a new option tls_ocsp_file
3f7eeb86
PP
84 is now available. If the contents of the file are valid, then Exim will
85 send that back in response to a TLS status request; this is OCSP Stapling.
86 Exim will not maintain the contents of the file in any way: administrators
87 are responsible for ensuring that it is up-to-date.
88
89 See "experimental-spec.txt" for more details.
90
c1e794ba 91
3ce96ada
TF
92Version 4.77
93------------
94
95 1. New options for the ratelimit ACL condition: /count= and /unique=.
96 The /noupdate option has been replaced by a /readonly option.
97
061b7ebd
PP
98 2. The SMTP transport's protocol option may now be set to "smtps", to
99 use SSL-on-connect outbound.
100
9e949f00
PP
101 3. New variable $av_failed, set true if the AV scanner deferred; ie, when
102 there is a problem talking to the AV scanner, or the AV scanner running.
103
39257585
PP
104 4. New expansion conditions, "inlist" and "inlisti", which take simple lists
105 and check if the search item is a member of the list. This does not
106 support named lists, but does subject the list part to string expansion.
107
108 5. Unless the new EXPAND_LISTMATCH_RHS build option is set when Exim was
109 built, Exim no longer performs string expansion on the second string of
110 the match_* expansion conditions: "match_address", "match_domain",
111 "match_ip" & "match_local_part". Named lists can still be used.
112
7c6d71af 113
e97d1f08
PP
114Version 4.76
115------------
116
117 1. The global option "dns_use_edns0" may be set to coerce EDNS0 usage on
118 or off in the resolver library.
119
120
bc19a55b
PP
121Version 4.75
122------------
123
124 1. In addition to the existing LDAP and LDAP/SSL ("ldaps") support, there
125 is now LDAP/TLS support, given sufficiently modern OpenLDAP client
126 libraries. The following global options have been added in support of
127 this: ldap_ca_cert_dir, ldap_ca_cert_file, ldap_cert_file, ldap_cert_key,
128 ldap_cipher_suite, ldap_require_cert, ldap_start_tls.
129
2fe76745
PP
130 2. The pipe transport now takes a boolean option, "freeze_signal", default
131 false. When true, if the external delivery command exits on a signal then
132 Exim will freeze the message in the queue, instead of generating a bounce.
133
f1e5fef5
PP
134 3. Log filenames may now use %M as an escape, instead of %D (still available).
135 The %M pattern expands to yyyymm, providing month-level resolution.
136
332f5cf3
PP
137 4. The $message_linecount variable is now updated for the maildir_tag option,
138 in the same way as $message_size, to reflect the real number of lines,
139 including any header additions or removals from transport.
140
29cfeb94
PP
141 5. When contacting a pool of SpamAssassin servers configured in spamd_address,
142 Exim now selects entries randomly, to better scale in a cluster setup.
143
bc19a55b 144
a01ba081
PP
145Version 4.74
146------------
147
1670ef10
PP
148 1. SECURITY FIX: privilege escalation flaw fixed. On Linux (and only Linux)
149 the flaw permitted the Exim run-time user to cause root to append to
150 arbitrary files of the attacker's choosing, with the content based
151 on content supplied by the attacker.
152
153 2. Exim now supports loading some lookup types at run-time, using your
a01ba081
PP
154 platform's dlopen() functionality. This has limited platform support
155 and the intention is not to support every variant, it's limited to
156 dlopen(). This permits the main Exim binary to not be linked against
157 all the libraries needed for all the lookup types.
158
159
77bb000f
PP
160Version 4.73
161------------
162
2cfd3221
PP
163 NOTE: this version is not guaranteed backwards-compatible, please read the
164 items below carefully
165
77bb000f
PP
166 1. A new main configuration option, "openssl_options", is available if Exim
167 is built with SSL support provided by OpenSSL. The option allows
168 administrators to specify OpenSSL options to be used on connections;
169 typically this is to set bug compatibility features which the OpenSSL
170 developers have not enabled by default. There may be security
171 consequences for certain options, so these should not be changed
172 frivolously.
173
a29e5231
PP
174 2. A new pipe transport option, "permit_coredumps", may help with problem
175 diagnosis in some scenarios. Note that Exim is typically installed as
176 a setuid binary, which on most OSes will inhibit coredumps by default,
43236f35 177 so that safety mechanism would have to be overridden for this option to
a29e5231
PP
178 be able to take effect.
179
8544e77a
PP
180 3. ClamAV 0.95 is now required for ClamAV support in Exim, unless
181 Local/Makefile sets: WITH_OLD_CLAMAV_STREAM=yes
182 Note that this switches Exim to use a new API ("INSTREAM") and a future
183 release of ClamAV will remove support for the old API ("STREAM").
184
185 The av_scanner option, when set to "clamd", now takes an optional third
186 part, "local", which causes Exim to pass a filename to ClamAV instead of
187 the file content. This is the same behaviour as when clamd is pointed at
188 a Unix-domain socket. For example:
189
190 av_scanner = clamd:192.0.2.3 1234:local
191
491fab4c
PP
192 ClamAV's ExtendedDetectionInfo response format is now handled.
193
8544e77a
PP
194 4. There is now a -bmalware option, restricted to admin users. This option
195 takes one parameter, a filename, and scans that file with Exim's
196 malware-scanning framework. This is intended purely as a debugging aid
197 to ensure that Exim's scanning is working, not to replace other tools.
a9622bc6
PP
198 Note that the ACL framework is not invoked, so if av_scanner references
199 ACL variables without a fallback then this will fail.
8544e77a 200
83e029d5
PP
201 5. There is a new expansion operator, "reverse_ip", which will reverse IP
202 addresses; IPv4 into dotted quad, IPv6 into dotted nibble. Examples:
203
204 ${reverse_ip:192.0.2.4}
205 -> 4.2.0.192
206 ${reverse_ip:2001:0db8:c42:9:1:abcd:192.0.2.3}
207 -> 3.0.2.0.0.0.0.c.d.c.b.a.1.0.0.0.9.0.0.0.2.4.c.0.8.b.d.0.1.0.0.2
208
ed7f7860
PP
209 6. There is a new ACL control called "debug", to enable debug logging.
210 This allows selective logging of certain incoming transactions within
211 production environments, with some care. It takes two options, "tag"
212 and "opts"; "tag" is included in the filename of the log and "opts"
213 is used as per the -d<options> command-line option. Examples, which
214 don't all make sense in all contexts:
215
216 control = debug
217 control = debug/tag=.$sender_host_address
218 control = debug/opts=+expand+acl
219 control = debug/tag=.$message_exim_id/opts=+expand
220
10385c15
PP
221 7. It has always been implicit in the design and the documentation that
222 "the Exim user" is not root. src/EDITME said that using root was
223 "very strongly discouraged". This is not enough to keep people from
224 shooting themselves in the foot in days when many don't configure Exim
225 themselves but via package build managers. The security consequences of
226 running various bits of network code are severe if there should be bugs in
227 them. As such, the Exim user may no longer be root. If configured
228 statically, Exim will refuse to build. If configured as ref:user then Exim
229 will exit shortly after start-up. If you must shoot yourself in the foot,
230 then henceforth you will have to maintain your own local patches to strip
231 the safeties off.
232
6a8de854
PP
233 8. There is a new expansion operator, bool_lax{}. Where bool{} uses the ACL
234 condition logic to determine truth/failure and will fail to expand many
235 strings, bool_lax{} uses the router condition logic, where most strings
236 do evaluate true.
237 Note: bool{00} is false, bool_lax{00} is true.
238
239 9. Routers now support multiple "condition" tests,
532be449 240
5dc43717
JJ
24110. There is now a runtime configuration option "tcp_wrappers_daemon_name".
242 Setting this allows an admin to define which entry in the tcpwrappers
243 config file will be used to control access to the daemon. This option
244 is only available when Exim is built with USE_TCP_WRAPPERS. The
245 default value is set at build time using the TCP_WRAPPERS_DAEMON_NAME
246 build option.
247
79d4bc3d
PP
24811. [POSSIBLE CONFIG BREAKAGE] The default value for system_filter_user is now
249 the Exim run-time user, instead of root.
250
2cfd3221
PP
25112. [POSSIBLE CONFIG BREAKAGE] ALT_CONFIG_ROOT_ONLY is no longer optional and
252 is forced on. This is mitigated by the new build option
90b6341f 253 TRUSTED_CONFIG_LIST which defines a list of configuration files which
7f7f0545
DW
254 are trusted; one per line. If a config file is owned by root and matches
255 a pathname in the list, then it may be invoked by the Exim build-time
256 user without Exim relinquishing root privileges.
2cfd3221
PP
257
25813. [POSSIBLE CONFIG BREAKAGE] The Exim user is no longer automatically
259 trusted to supply -D<Macro[=Value]> overrides on the command-line. Going
90b6341f
DW
260 forward, we recommend using TRUSTED_CONFIG_LIST with shim configs that
261 include the main config. As a transition mechanism, we are temporarily
262 providing a work-around: the new build option WHITELIST_D_MACROS provides
43236f35 263 a colon-separated list of macro names which may be overridden by the Exim
90b6341f
DW
264 run-time user. The values of these macros are constrained to the regex
265 ^[A-Za-z0-9_/.-]*$ (which explicitly does allow for empty values).
2cfd3221 266
77bb000f 267
3fc596e4
NM
268Version 4.72
269------------
270
b26eacf1
PP
271 1. TWO SECURITY FIXES: one relating to mail-spools which are globally
272 writable, the other to locking of MBX folders (not mbox).
273
274 2. MySQL stored procedures are now supported.
275
276 3. The dkim_domain transport option is now a list, not a single string, and
277 messages will be signed for each element in the list (discarding
278 duplicates).
279
280 4. The 4.70 release unexpectedly changed the behaviour of dnsdb TXT lookups
281 in the presence of multiple character strings within the RR. Prior to 4.70,
282 only the first string would be returned. The dnsdb lookup now, by default,
283 preserves the pre-4.70 semantics, but also now takes an extended output
8f425947
PP
284 separator specification. The separator can be followed by a semicolon, to
285 concatenate the individual text strings together with no join character,
286 or by a comma and a second separator character, in which case the text
287 strings within a TXT record are joined on that second character.
288 Administrators are reminded that DNS provides no ordering guarantees
289 between multiple records in an RRset. For example:
b26eacf1
PP
290
291 foo.example. IN TXT "a" "b" "c"
292 foo.example. IN TXT "d" "e" "f"
293
294 ${lookup dnsdb{>/ txt=foo.example}} -> "a/d"
295 ${lookup dnsdb{>/; txt=foo.example}} -> "def/abc"
8f425947 296 ${lookup dnsdb{>/,+ txt=foo.example}} -> "a+b+c/d+e+f"
b26eacf1 297
3fc596e4 298
f33253cc
NM
299Version 4.70 / 4.71
300-------------------
65a7d8c3 301
7c6d71af 302 1. Native DKIM support without an external library.
a8c8d6b5
JJ
303 (Note that if no action to prevent it is taken, a straight upgrade will
304 result in DKIM verification of all signed incoming emails. See spec
305 for details on conditionally disabling)
7c6d71af
NM
306
307 2. Experimental DCC support via dccifd (contributed by Wolfgang Breyha).
65a7d8c3 308
f33253cc 309 3. There is now a bool{} expansion condition which maps certain strings to
7d9f747b 310 true/false condition values (most likely of use in conjunction with the
f33253cc
NM
311 and{} expansion operator).
312
313 4. The $spam_score, $spam_bar and $spam_report variables are now available
314 at delivery time.
315
316 5. exim -bP now supports "macros", "macro_list" or "macro MACRO_NAME" as
317 options, provided that Exim is invoked by an admin_user.
318
319 6. There is a new option gnutls_compat_mode, when linked against GnuTLS,
320 which increases compatibility with older clients at the cost of decreased
321 security. Don't set this unless you need to support such clients.
322
323 7. There is a new expansion operator, ${randint:...} which will produce a
324 "random" number less than the supplied integer. This randomness is
325 not guaranteed to be cryptographically strong, but depending upon how
326 Exim was built may be better than the most naive schemes.
327
328 8. Exim now explicitly ensures that SHA256 is available when linked against
329 OpenSSL.
330
331 9. The transport_filter_timeout option now applies to SMTP transports too.
332
65a7d8c3 333
7d9f747b
PP
334Version 4.69
335------------
336
337 1. Preliminary DKIM support in Experimental.
338
339
2b85bce7
PH
340Version 4.68
341------------
342
343 1. The body_linecount and body_zerocount C variables are now exported in the
344 local_scan API.
345
93655c46
PH
346 2. When a dnslists lookup succeeds, the key that was looked up is now placed
347 in $dnslist_matched. When the key is an IP address, it is not reversed in
348 this variable (though it is, of course, in the actual lookup). In simple
349 cases, for example:
350
351 deny dnslists = spamhaus.example
352
353 the key is also available in another variable (in this case,
354 $sender_host_address). In more complicated cases, however, this is not
355 true. For example, using a data lookup might generate a dnslists lookup
356 like this:
357
358 deny dnslists = spamhaus.example/<|192.168.1.2|192.168.6.7|...
359
360 If this condition succeeds, the value in $dnslist_matched might be
361 192.168.6.7 (for example).
362
6c512171
PH
363 3. Authenticators now have a client_condition option. When Exim is running as
364 a client, it skips an authenticator whose client_condition expansion yields
365 "0", "no", or "false". This can be used, for example, to skip plain text
366 authenticators when the connection is not encrypted by a setting such as:
367
368 client_condition = ${if !eq{$tls_cipher}{}}
369
370 Note that the 4.67 documentation states that $tls_cipher contains the
371 cipher used for incoming messages. In fact, during SMTP delivery, it
372 contains the cipher used for the delivery. The same is true for
373 $tls_peerdn.
374
a96603a0
PH
375 4. There is now a -Mvc <message-id> option, which outputs a copy of the
376 message to the standard output, in RFC 2822 format. The option can be used
377 only by an admin user.
378
8f240103
PH
379 5. There is now a /noupdate option for the ratelimit ACL condition. It
380 computes the rate and checks the limit as normal, but it does not update
381 the saved data. This means that, in relevant ACLs, it is possible to lookup
382 the existence of a specified (or auto-generated) ratelimit key without
383 incrementing the ratelimit counter for that key.
384
385 In order for this to be useful, another ACL entry must set the rate
386 for the same key somewhere (otherwise it will always be zero).
387
388 Example:
389
390 acl_check_connect:
391 # Read the rate; if it doesn't exist or is below the maximum
392 # we update it below
393 deny ratelimit = 100 / 5m / strict / noupdate
394 log_message = RATE: $sender_rate / $sender_rate_period \
395 (max $sender_rate_limit)
396
397 [... some other logic and tests...]
398
399 warn ratelimit = 100 / 5m / strict / per_cmd
400 log_message = RATE UPDATE: $sender_rate / $sender_rate_period \
401 (max $sender_rate_limit)
402 condition = ${if le{$sender_rate}{$sender_rate_limit}}
403
404 accept
405
d677b2f2
PH
406 6. The variable $max_received_linelength contains the number of bytes in the
407 longest line that was received as part of the message, not counting the
408 line termination character(s).
409
d52120f2
PH
410 7. Host lists can now include +ignore_defer and +include_defer, analagous to
411 +ignore_unknown and +include_unknown. These options should be used with
412 care, probably only in non-critical host lists such as whitelists.
413
8669f003
PH
414 8. There's a new option called queue_only_load_latch, which defaults true.
415 If set false when queue_only_load is greater than zero, Exim re-evaluates
416 the load for each incoming message in an SMTP session. Otherwise, once one
417 message is queued, the remainder are also.
418
4f054c63 419 9. There is a new ACL, specified by acl_smtp_notquit, which is run in most
8f128379
PH
420 cases when an SMTP session ends without sending QUIT. However, when Exim
421 itself is is bad trouble, such as being unable to write to its log files,
422 this ACL is not run, because it might try to do things (such as write to
423 log files) that make the situation even worse.
424
425 Like the QUIT ACL, this new ACL is provided to make it possible to gather
426 statistics. Whatever it returns (accept or deny) is immaterial. The "delay"
427 modifier is forbidden in this ACL.
428
429 When the NOTQUIT ACL is running, the variable $smtp_notquit_reason is set
430 to a string that indicates the reason for the termination of the SMTP
431 connection. The possible values are:
432
433 acl-drop Another ACL issued a "drop" command
434 bad-commands Too many unknown or non-mail commands
435 command-timeout Timeout while reading SMTP commands
436 connection-lost The SMTP connection has been lost
437 data-timeout Timeout while reading message data
438 local-scan-error The local_scan() function crashed
439 local-scan-timeout The local_scan() function timed out
440 signal-exit SIGTERM or SIGINT
441 synchronization-error SMTP synchronization error
442 tls-failed TLS failed to start
443
444 In most cases when an SMTP connection is closed without having received
445 QUIT, Exim sends an SMTP response message before actually closing the
446 connection. With the exception of acl-drop, the default message can be
447 overridden by the "message" modifier in the NOTQUIT ACL. In the case of a
448 "drop" verb in another ACL, it is the message from the other ACL that is
449 used.
450
b7670459
PH
45110. For MySQL and PostgreSQL lookups, it is now possible to specify a list of
452 servers with individual queries. This is done by starting the query with
453 "servers=x:y:z;", where each item in the list may take one of two forms:
454
455 (1) If it is just a host name, the appropriate global option (mysql_servers
456 or pgsql_servers) is searched for a host of the same name, and the
457 remaining parameters (database, user, password) are taken from there.
458
459 (2) If it contains any slashes, it is taken as a complete parameter set.
460
461 The list of servers is used in exactly the same was as the global list.
462 Once a connection to a server has happened and a query has been
463 successfully executed, processing of the lookup ceases.
464
465 This feature is intended for use in master/slave situations where updates
466 are occurring, and one wants to update a master rather than a slave. If the
467 masters are in the list for reading, you might have:
468
469 mysql_servers = slave1/db/name/pw:slave2/db/name/pw:master/db/name/pw
470
471 In an updating lookup, you could then write
472
473 ${lookup mysql{servers=master; UPDATE ...}
474
475 If, on the other hand, the master is not to be used for reading lookups:
476
477 pgsql_servers = slave1/db/name/pw:slave2/db/name/pw
478
479 you can still update the master by
480
481 ${lookup pgsql{servers=master/db/name/pw; UPDATE ...}
482
ddea74fa
PH
48311. The message_body_newlines option (default FALSE, for backwards
484 compatibility) can be used to control whether newlines are present in
485 $message_body and $message_body_end. If it is FALSE, they are replaced by
486 spaces.
487
2b85bce7 488
b4ed4da0
PH
489Version 4.67
490------------
491
492 1. There is a new log selector called smtp_no_mail, which is not included in
493 the default setting. When it is set, a line is written to the main log
494 whenever an accepted SMTP connection terminates without having issued a
4aa45c31 495 MAIL command.
b4ed4da0 496
431b7361 497 2. When an item in a dnslists list is followed by = and & and a list of IP
4aa45c31
PH
498 addresses, the behaviour was not clear when the lookup returned more than
499 one IP address. This has been solved by the addition of == and =& for "all"
93655c46 500 rather than the default "any" matching.
431b7361 501
4aa45c31
PH
502 3. Up till now, the only control over which cipher suites GnuTLS uses has been
503 for the cipher algorithms. New options have been added to allow some of the
504 other parameters to be varied.
431b7361 505
4aa45c31
PH
506 4. There is a new compile-time option called ENABLE_DISABLE_FSYNC. When it is
507 set, Exim compiles a runtime option called disable_fsync.
431b7361 508
4aa45c31 509 5. There is a new variable called $smtp_count_at_connection_start.
431b7361 510
4aa45c31 511 6. There's a new control called no_pipelining.
cf8b11a5 512
41c7c167 513 7. There are two new variables called $sending_ip_address and $sending_port.
4aa45c31 514 These are set whenever an SMTP connection to another host has been set up.
41c7c167
PH
515
516 8. The expansion of the helo_data option in the smtp transport now happens
4aa45c31 517 after the connection to the server has been made.
41c7c167 518
9c57cbc0 519 9. There is a new expansion operator ${rfc2047d: that decodes strings that
4aa45c31 520 are encoded as per RFC 2047.
9c57cbc0 521
f3f065bb
PH
52210. There is a new log selector called "pid", which causes the current process
523 id to be added to every log line, in square brackets, immediately after the
524 time and date.
525
047bdd8c 52611. Exim has been modified so that it flushes SMTP output before implementing
4c590bd1
PH
527 a delay in an ACL. It also flushes the output before performing a callout,
528 as this can take a substantial time. These behaviours can be disabled by
529 obeying control = no_delay_flush or control = no_callout_flush,
4aa45c31 530 respectively, at some earlier stage of the connection.
047bdd8c 531
0ce9abe6 53212. There are two new expansion conditions that iterate over a list. They are
4aa45c31 533 called forany and forall.
0ce9abe6 534
0e22dfd1
PH
53513. There's a new global option called dsn_from that can be used to vary the
536 contents of From: lines in bounces and other automatically generated
537 messages ("delivery status notifications" - hence the name of the option).
0e22dfd1 538
4aa45c31 53914. The smtp transport has a new option called hosts_avoid_pipelining.
c51b8e75 540
75b1493f 54115. By default, exigrep does case-insensitive matches. There is now a -I option
4aa45c31 542 that makes it case-sensitive.
29f89cad 543
4aa45c31
PH
54416. A number of new features ("addresses", "map", "filter", and "reduce") have
545 been added to string expansions to make it easier to process lists of
546 items, typically addresses.
29f89cad 547
c3611384
PH
54817. There's a new ACL modifier called "continue". It does nothing of itself,
549 and processing of the ACL always continues with the next condition or
550 modifier. It is provided so that the side effects of expanding its argument
4aa45c31 551 can be used.
c3611384 552
ec95d1a6 55318. It is now possible to use newline and other control characters (those with
4aa45c31 554 values less than 32, plus DEL) as separators in lists.
ec95d1a6 555
b2d5182b
PH
55619. The exigrep utility now has a -v option, which inverts the matching
557 condition.
558
c456d9bb 55920. The host_find_failed option in the manualroute router can now be set to
4aa45c31 560 "ignore".
c456d9bb 561
b4ed4da0
PH
562
563Version 4.66
564------------
565
566No new features were added to 4.66.
567
568
569Version 4.65
570------------
571
572No new features were added to 4.65.
573
38a0a95f
PH
574
575Version 4.64
576------------
577
af561417
PH
578 1. ACL variables can now be given arbitrary names, as long as they start with
579 "acl_c" or "acl_m" (for connection variables and message variables), are at
580 least six characters long, with the sixth character being either a digit or
883335dc 581 an underscore.
af561417
PH
582
583 2. There is a new ACL modifier called log_reject_target. It makes it possible
883335dc 584 to specify which logs are used for messages about ACL rejections.
af561417
PH
585
586 3. There is a new authenticator called "dovecot". This is an interface to the
587 authentication facility of the Dovecot POP/IMAP server, which can support a
883335dc 588 number of authentication methods.
af561417
PH
589
590 4. The variable $message_headers_raw provides a concatenation of all the
591 messages's headers without any decoding. This is in contrast to
592 $message_headers, which does RFC2047 decoding on the header contents.
593
883335dc
PH
594 5. In a DNS black list, if two domain names, comma-separated, are given, the
595 second is used first to do an initial check, making use of any IP value
596 restrictions that are set. If there is a match, the first domain is used,
597 without any IP value restrictions, to get the TXT record.
af561417 598
883335dc 599 6. All authenticators now have a server_condition option.
af561417
PH
600
601 7. There is a new command-line option called -Mset. It is useful only in
602 conjunction with -be (that is, when testing string expansions). It must be
603 followed by a message id; Exim loads the given message from its spool
883335dc 604 before doing the expansions.
af561417
PH
605
606 8. Another similar new command-line option is called -bem. It operates like
883335dc
PH
607 -be except that it must be followed by the name of a file that contains a
608 message.
af561417
PH
609
610 9. When an address is delayed because of a 4xx response to a RCPT command, it
611 is now the combination of sender and recipient that is delayed in
883335dc 612 subsequent queue runs until its retry time is reached.
af561417
PH
613
61410. Unary negation and the bitwise logical operators and, or, xor, not, and
883335dc 615 shift, have been added to the eval: and eval10: expansion items.
48c7f9e2 616
194cc0e4
PH
61711. The variables $interface_address and $interface_port have been renamed
618 as $received_ip_address and $received_port, to make it clear that they
619 relate to message reception rather than delivery. (The old names remain
620 available for compatibility.)
621
883335dc
PH
62212. The "message" modifier can now be used on "accept" and "discard" acl verbs
623 to vary the message that is sent when an SMTP command is accepted.
4e88a19f 624
495ae4b0 625
4608d683
PH
626Version 4.63
627------------
628
6291. There is a new Boolean option called filter_prepend_home for the redirect
38a0a95f 630 router.
4608d683 631
45b91596
PH
6322. There is a new acl, set by acl_not_smtp_start, which is run right at the
633 start of receiving a non-SMTP message, before any of the message has been
38a0a95f 634 read.
45b91596 635
a5bd321b
PH
6363. When an SMTP error message is specified in a "message" modifier in an ACL,
637 or in a :fail: or :defer: message in a redirect router, Exim now checks the
38a0a95f 638 start of the message for an SMTP error code.
a5bd321b 639
6ec97b1b 6404. There is a new parameter for LDAP lookups called "referrals", which takes
38a0a95f 641 one of the settings "follow" (the default) or "nofollow".
6ec97b1b 642
e22ca4ac
JJ
6435. Version 20070721.2 of exipick now included, offering these new options:
644 --reverse
645 After all other sorting options have bee processed, reverse order
646 before displaying messages (-R is synonym).
647 --random
648 Randomize order of matching messages before displaying.
649 --size
650 Instead of displaying the matching messages, display the sum
651 of their sizes.
652 --sort <variable>[,<variable>...]
653 Before displaying matching messages, sort the messages according to
654 each messages value for each variable.
655 --not
656 Negate the value for every test (returns inverse output from the
657 same criteria without --not).
658
4608d683 659
1cce3af8
PH
660Version 4.62
661------------
662
6631. The ${readsocket expansion item now supports Internet domain sockets as well
664 as Unix domain sockets. If the first argument begins "inet:", it must be of
665 the form "inet:host:port". The port is mandatory; it may be a number or the
666 name of a TCP port in /etc/services. The host may be a name, or it may be an
667 IP address. An ip address may optionally be enclosed in square brackets.
668 This is best for IPv6 addresses. For example:
669
670 ${readsocket{inet:[::1]:1234}{<request data>}...
671
672 Only a single host name may be given, but if looking it up yield more than
673 one IP address, they are each tried in turn until a connection is made. Once
674 a connection has been made, the behaviour is as for ${readsocket with a Unix
675 domain socket.
676
f7fd3850
PH
6772. If a redirect router sets up file or pipe deliveries for more than one
678 incoming address, and the relevant transport has batch_max set greater than
679 one, a batch delivery now occurs.
680
d6629cdc
PH
6813. The appendfile transport has a new option called maildirfolder_create_regex.
682 Its value is a regular expression. For a maildir delivery, this is matched
683 against the maildir directory; if it matches, Exim ensures that a
684 maildirfolder file is created alongside the new, cur, and tmp directories.
685
1cce3af8 686
7e66e54d
PH
687Version 4.61
688------------
689
4f578862
PH
690The documentation is up-to-date for the 4.61 release. Major new features since
691the 4.60 release are:
692
693. An option called disable_ipv6, to disable the use of IPv6 completely.
694
695. An increase in the number of ACL variables to 20 of each type.
696
697. A change to use $auth1, $auth2, and $auth3 in authenticators instead of $1,
698 $2, $3, (though those are still set) because the numeric variables get used
699 for other things in complicated expansions.
700
843a41e8 701. The default for rfc1413_query_timeout has been changed from 30s to 5s.
4f578862
PH
702
703. It is possible to use setclassresources() on some BSD OS to control the
704 resources used in pipe deliveries.
705
706. A new ACL modifier called add_header, which can be used with any verb.
707
708. More errors are detectable in retry rules.
709
710There are a number of other additions too.
71fafd95 711
7e66e54d 712
425ae40f 713Version 4.60
b5aea5e1
PH
714------------
715
425ae40f
PH
716The documentation is up-to-date for the 4.60 release. Major new features since
717the 4.50 release are:
1a46a8c5 718
425ae40f 719. Support for SQLite.
1a46a8c5 720
425ae40f 721. Support for IGNOREQUOTA in LMTP.
1a46a8c5 722
425ae40f 723. Extensions to the "submission mode" features.
1a46a8c5 724
425ae40f 725. Support for Client SMTP Authorization (CSA).
1a46a8c5 726
425ae40f 727. Support for ratelimiting hosts and users.
b5aea5e1 728
425ae40f 729. New expansion items to help with the BATV "prvs" scheme.
b5aea5e1 730
425ae40f 731. A "match_ip" condition, that matches an IP address against a list.
35edf2ff 732
425ae40f 733There are many more minor changes.
495ae4b0
PH
734
735****