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