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