buildsystem tooling
[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 Git before the documentation is updated. Once
7 the documentation is updated, this file is reduced to a short list.
8
9 Version 4.98
10 ------------
11  1. A sieve_inbox option for redirect routers
12
13  2. A "connection_id" variable
14
15  3. Events smtp:fail:protocol and smtp:fail:syntax
16
17  4. JSON lookup support can now be built as a lodable module
18
19 Version 4.98
20 ------------
21  1. The dkim_status ACL condition may now be used in data ACLs
22
23  2. The dkim_verbose logging control also enables logging of signing
24
25  3. The dkim_timestamps signing option now accepts zero to include a current
26     timestamp but no expiry timestamp.  Code by Simon Arlott; testsuite
27     additions by jgh
28
29  4. The recipients_max main option is now expanded
30
31  5. Setting variables for "exim -be" can set a tainted value
32
33  6. A dns:fail event
34
35  7. The dsearch lookup supports search for a sub-path
36
37  8. Include mailtest utility for simple connection checking
38
39  9. Add SMTP WELLKNOWN extension
40
41  10. Sqlite3 can be used for the hints databases (vs. DBD, NDB, GBDM, TDB).
42      Add "USE_SQLITE = y" and "DBMLIB = -lsqlite3" in Local/Makefile, to
43      override the settings done in the OS/Makefile-<platform> file
44
45 Version 4.97
46 ------------
47
48  1. The expansion-test facility (exim -be) can set variables.
49
50  2. An event on a failing SMTP AUTH, for both client and server operations.
51
52  3. Variable $sender_helo_verified with the result of an ACL "verify = helo".
53
54  4. Predefined macros for expansion items, operators, conditions and variables.
55
56  5. The smtp transport option "max_rcpt" is now expanded before use.
57
58  6. The tls_eccurve option for OpenSSL now takes a list of group names.
59
60  7. Queue runners for several queues can now be started from one daemon.
61
62  8. New utility exim_msgdate converts message-ids to human readable format.
63
64  9. An expansion operator for wrapping long header lines.
65
66  10. A commandline option to print just the message IDs of the queue
67
68  11. An option for the ${readsocket } expansion to set an SNI for TLS.
69
70  12. The ACL remove_header modifier can take a pattern.
71
72  13. Variable $recipients_list, a properly-quoted exim list.
73
74  14. A log_selector for an incoming connection ID.
75
76 Version 4.96
77 ------------
78
79  1. A new ACL condition: seen. Records/tests a timestamp against a key.
80
81  2. A variant of the "mask" expansion operator to give normalised IPv6.
82
83  3. UTC output option for exim_dumpdb, exim_fixdb.
84
85  4. An event for failing TLS connects to the daemon.
86
87  5. The ACL "debug" control gains options "stop", "pretrigger" and "trigger".
88
89  6. Query-style lookups are now checked for quoting, if the query string is
90     built using untrusted data ("tainted").  For now lack of quoting is merely
91     logged; a future release will upgrade this to an error.
92
93  7. The expansion conditions match_<list-type> and inlist now set $value for
94     the expansion of the "true" result of the ${if}.  With a static list, this
95     can be used for de-tainting.
96
97  8. Recipient verify callouts now set $domain_data & $local_part_data, with
98     de-tainted values.
99
100 Version 4.95
101 ------------
102
103  1. The fast-ramp two phase queue run support, previously experimental, is
104     now supported by default.
105
106  2. The native SRS support, previously experimental, is now supported. It is
107     not built unless specified in the Local/Makefile.
108
109  3. TLS resumption support, previously experimental, is now supported and
110     included in default builds.
111
112  4. Single-key LMDB lookups, previously experimental, are now supported.
113     The support is not built unless specified in the Local/Makefile.
114
115  5. Option "message_linelength_limit" on the smtp transport to enforce (by
116     default) the RFC 998 character limit.
117
118  6. An option to ignore the cache on a lookup.
119
120  7. Quota checking during reception (i.e. at SMTP time) for appendfile-
121     transport-managed quotas.
122
123  8. Sqlite lookups accept a "file=<path>" option to specify a per-operation
124     db file, replacing the previous prefix to the SQL string (which had
125     issues when the SQL used tainted values).
126
127  9. Lsearch lookups accept a "ret=full" option, to return both the portion
128     of the line matching the key, and the remainder.
129
130 10. A command-line option to have a daemon not create a notifier socket.
131
132 11. Faster TLS startup.  When various configuration options contain no
133     expandable elements, the information can be preloaded and cached rather
134     than the previous behaviour of always loading at startup time for every
135     connection.  This helps particularly for the CA bundle.
136
137 12. Proxy Protocol Timeout is configurable via "proxy_protocol_timeout"
138     main config option.
139
140 13. Option "smtp_accept_max_per_connection" is now expanded.
141
142 14. Log selector "queue_time_exclusive", enabled by default, to exclude the
143     time taken for reception from QT log elements.
144
145 15. Main option "smtp_backlog_monitor", to set a level above which listen
146     socket backlogs are logged.
147
148 16. Main option "hosts_require_helo", requiring HELO or EHLO before MAIL.
149
150 17. A main config option "allow_insecure_tainted_data" allows to turn
151
152 18. TLS ALPN handling.  By default, refuse TLS connections that try to specify
153     a non-smtp (eg. http) use.  Options for customising.
154
155 19. Support for MacOS (darwin) has been dropped.
156
157
158 Version 4.94
159 ------------
160
161  1. EXPERIMENTAL_SRS_NATIVE optional build feature.  See the experimental.spec
162     file.
163
164  2. Channel-binding for authenticators is now supported under OpenSSL.
165     Previously it was GnuTLS-only.
166
167  3. A msg:defer event.
168
169  4. Client-side support in the gsasl authenticator.  Tested against the
170     plaintext driver for PLAIN; only against itself for SCRAM-SHA-1 and
171     SCRAM-SHA-1-PLUS methods.
172
173  5. Server-side support in the gsasl authenticator for encrypted passwords, as
174     an alternate for the existing plaintext.
175
176  6. Variable $local_part_data now also set by router check_local_user option,
177     with an de-tainted version of $local_part.
178
179  7. Named-list definitions can now be prefixed "hide" so that "-bP" commands do
180     not output the content.  Previously this could only be done on options.
181
182  8. As an experimental feature, the dovecot authentication driver supports inet
183     sockets.  Previously it was unix-domain sockets only.
184
185  9. The ACL control "queue_only" can also be spelled "queue", and now takes an
186     option "first_pass_route" to do the same as a "-odqs" on the command line.
187
188 10. Items specified for the router and transport headers_remove option can use
189     a trailing asterisk to specify globbing.
190
191 11. New $queue_size variable.
192
193 12. New variables $local_part_{pre,suf}fix_v.
194
195 13. New main option "sqlite_dbfile", for use in preference to prefixing the
196     lookup string.  The older method fails when tainted variables are used
197     in the lookup, as the filename becomes tainted.  The new method keeps the
198     filename separate.
199
200 14. Options on the dsearch lookup, to return the full path and to filter
201     filetypes for matching.
202
203 15. Options on pgsql and mysql lookups, to specify server separate from the
204     lookup string.
205
206 16. An option on all single-key lookups, to return (on a hit) a de-tainted
207     version of the lookup key rather than the looked-up data.
208
209 17. $domain_data and $local_part_data are now set by all list-match successes.
210     Previously only list items that performed lookups did so.
211     Also, matching list items that are tail-match or RE-match now set the
212     numeric variables $0 (etc) in the same way os other RE matches.
213
214 18. Expansion item ${listquote {<char} {<item>}}.
215
216 19. An option for the ${readsocket {}{}{}} expansion to make the result data
217     cacheable.
218
219 20. dkim_verify_min_keysizes, a list of minimum acceptable public-key sizes.
220
221 21. bounce_message_file and warn_message_file are now expanded before use.
222
223 22. New main config option spf_smtp_comment_template to customise the
224     $spf_smtp_comment variable
225
226
227
228 Version 4.93
229 ------------
230
231  1. An "external" authenticator, per RFC 4422 Appendix A.
232
233  2. A JSON lookup type, and JSON variants of the forall/any expansion conditions.
234
235  3. Variables $tls_in_cipher_std, $tls_out_cipher_std giving the RFC names
236     for ciphersuites.
237
238  4. Log_selectors "msg_id" (on by default) and "msg_id_created".
239
240  5. A case_insensitive option for verify=not_blind.
241
242  6. EXPERIMENTAL_TLS_RESUME optional build feature.  See the experimental.spec
243     file.
244
245  7. A main option exim_version to override the version Exim
246     reports in verious places ($exim_version, $version_number).
247
248  8. Expansion operator ${sha2_N:} for N=256, 384, 512.
249
250  9. Router variables, $r_... settable from router options and usable in routers
251     and transports.
252
253 10. The spf lookup now supports IPv6.
254
255 11. Main options for DKIM verify to filter hash and key types.
256
257 12. With TLS1.3, support for full-chain OCSP stapling.
258
259 13. Dual-certificate stacks on servers now support OCSP stapling, under OpenSSL.
260
261 14: An smtp:ehlo transport event, for observability of the remote offered features.
262
263 15: Support under OpenSSL for writing NSS-style key files for packet-capture
264     decode.  The environment variable SSLKEYLOGFILE is used; if an absolute path
265     it must indicate a file under the spool directory; if relative the the spool
266     directory is prepended.  Works on the server side only.  Support under
267     GnuTLS was already there, being done purely by the library (server side
268     only, and exim must be run as root).
269
270 16: Command-line option to move messages from one named queue to another.
271
272 17. Variables $tls_in_ver, $tls_out_ver.
273
274
275 Version 4.92
276 --------------
277
278  1. ${l_header:<name>} and ${l_h:<name>} expansion items, giving a colon-sep
279     list when there are multiple headers having a given name.  This matters
280     when individual headers are wrapped onto multiple lines; with previous
281     facilities hard to parse.
282
283  2. The ${readsocket } expansion item now takes a "tls" option, doing the
284     obvious thing.
285
286  3. EXPERIMENTAL_REQUIRETLS and EXPERIMENTAL_PIPE_CONNECT optional build
287     features.  See the experimental.spec file.
288
289  4. If built with SUPPORT_I18N a "utf8_downconvert" option on the smtp transport.
290
291  5. A "pipelining" log_selector.
292
293  6. Builtin macros for supported log_selector and openssl_options values.
294
295  7. JSON variants of the ${extract } expansion item.
296
297  8. A "noutf8" debug option, for disabling the UTF-8 characters in debug output.
298
299  9. TCP Fast Open support on MacOS.
300
301 Version 4.91
302 --------------
303
304  1. Dual-certificate stacks on servers now support OCSP stapling, under GnuTLS
305     version 3.5.6 or later.
306
307  2. DANE is now supported under GnuTLS version 3.0.0 or later.  Both GnuTLS and
308     OpenSSL versions are moved to mainline support from Experimental.
309     New SMTP transport option "dane_require_tls_ciphers".
310
311  3. Feature macros for the compiled-in set of malware scanner interfaces.
312
313  4. SPF support is promoted from Experimental to mainline status.  The template
314     src/EDITME makefile does not enable its inclusion.
315
316  5. Logging control for DKIM verification.  The existing DKIM log line is
317     controlled by a "dkim_verbose" selector which is _not_ enabled by default.
318     A new tag "DKIM=<domain>" is added to <= lines by default, controlled by
319     a "dkim" log_selector.
320
321  6. Receive duration on <= lines, under a new log_selector "receive_time".
322
323  7. Options "ipv4_only" and "ipv4_prefer" on the dnslookup router and on
324     routing rules in the manualroute router.
325
326  8. Expansion item ${sha3:<string>} / ${sha3_<N>:<string>} now also supported
327     under OpenSSL version 1.1.1 or later.
328
329  9. DKIM operations can now use the Ed25519 algorithm in addition to RSA, under
330     GnuTLS 3.6.0 or OpenSSL 1.1.1 or later.
331
332 10. Builtin feature-macros _CRYPTO_HASH_SHA3 and _CRYPTO_SIGN_ED25519, library
333     version dependent.
334
335 11. "exim -bP macro <name>" returns caller-usable status.
336
337 12. Expansion item ${authresults {<machine>}} for creating an
338     Authentication-Results: header.
339
340 13. EXPERIMENTAL_ARC.  See the experimental.spec file.
341     See also new util/renew-opendmarc-tlds.sh script for use with DMARC/ARC.
342
343 14: A dane:fail event, intended to facilitate reporting.
344
345 15. "Lightweight" support for Redis Cluster. Requires redis_servers list to
346     contain all the servers in the cluster, all of which must be reachable from
347     the running exim instance. If the cluster has master/slave replication, the
348     list must contain all the master and slave servers.
349
350 16. Add an option to the Avast scanner interface: "pass_unscanned". This
351     allows to treat unscanned files as clean. Files may be unscanned for
352     several reasons: decompression bombs, broken archives.
353
354
355 Version 4.90
356 ------------
357
358  1. PKG_CONFIG_PATH can now be set in Local/Makefile;
359     wildcards will be expanded, values are collapsed.
360
361  2. The ${readsocket } expansion now takes an option to not shutdown the
362     connection after sending the query string.  The default remains to do so.
363
364  3. An smtp transport option "hosts_noproxy_tls" to control whether multiple
365     deliveries on a single TCP connection can maintain a TLS connection
366     open.  By default disabled for all hosts, doing so saves the cost of
367     making new TLS sessions, at the cost of having to proxy the data via
368     another process.  Logging is also affected.
369
370  4. A malware connection type for the FPSCAND protocol.
371
372  5. An option for recipient verify callouts to hold the connection open for
373     further recipients and for delivery.
374
375  6. The reproducible build $SOURCE_DATE_EPOCH environment variable is now
376     supported.
377
378  7. Optionally, an alternate format for spool data-files which matches the
379     wire format - meaning more efficient reception and transmission (at the
380     cost of difficulty with standard Unix tools).  Only used for messages
381     received using the ESMTP CHUNKING option, and when a new main-section
382     option "spool_wireformat" (false by default) is set.
383
384  8. New main configuration option "commandline_checks_require_admin" to
385     restrict who can use various introspection options.
386
387  9. New option modifier "no_check" for quota and quota_filecount
388     appendfile transport.
389
390 10. Variable $smtp_command_history returning a comma-sep list of recent
391     SMTP commands.
392
393 11. Millisecond timetamps in logs, on log_selector "millisec".  Also affects
394     log elements QT, DT and D, and timstamps in debug output.
395
396 12. TCP Fast Open logging.  As a server, logs when the SMTP banner was sent
397     while still in SYN_RECV state; as a client logs when the connection
398     is opened with a TFO cookie.
399
400 13. DKIM support for multiple signing, by domain and/or key-selector.
401     DKIM support for multiple hashes, and for alternate-identity tags.
402     Builtin macro with default list of signed headers.
403     Better syntax for specifying oversigning.
404     The DKIM ACL can override verification status, and status is visible in
405     the data ACL.
406
407 14. Exipick understands -C|--config for an alternative Exim
408     configuration file.
409
410 15. TCP Fast Open used, with data-on-SYN, for client SMTP via SOCKS5 proxy,
411     for ${readsocket } expansions, and for ClamAV.
412
413 16. The "-be" expansion test mode now supports macros.  Macros are expanded
414     in test lines, and new macros can be defined.
415
416 17. Support for server-side dual-certificate-stacks (eg. RSA + ECDSA).
417
418
419 Version 4.89
420 ------------
421
422  1. Allow relative config file names for ".include"
423
424  2. A main-section config option "debug_store" to control the checks on
425     variable locations during store-reset.  Normally false but can be enabled
426     when a memory corruption issue is suspected on a production system.
427
428
429 Version 4.88
430 ------------
431
432  1. The new perl_taintmode option allows to run the embedded perl
433     interpreter in taint mode.
434
435  2. New log_selector: dnssec, adds a "DS" tag to acceptance and delivery lines.
436
437  3. Speculative debugging, via a "kill" option to the "control=debug" ACL
438     modifier.
439
440  4. New expansion item ${sha3:<string>} / ${sha3_<N>:<string>}.
441     N can be 224, 256 (default), 384, 512.
442     With GnuTLS 3.5.0 or later, only.
443
444  5. Facility for named queues:  A command-line argument can specify
445     the queue name for a queue operation, and an ACL modifier can set
446     the queue to be used for a message.  A $queue_name variable gives
447     visibility.
448
449  6. New expansion operators base32/base32d.
450
451  7. The CHUNKING ESMTP extension from RFC 3030.  May give some slight
452     performance increase and network load decrease.  Main config option
453     chunking_advertise_hosts, and smtp transport option hosts_try_chunking
454     for control.
455
456  8. LMDB lookup support, as Experimental. Patch supplied by Andrew Colin Kissa.
457
458  9. Expansion operator escape8bit, like escape but not touching newline etc..
459
460 10. Feature macros, generated from compile options.  All start with "_HAVE_"
461     and go on with some roughly recognisable name.  Driver macros, for
462     router, transport and authentication drivers; names starting with "_DRIVER_".
463     Option macros, for each configuration-file option; all start with "_OPT_".
464     Use the "-bP macros" command-line option to see what is present.
465
466 11. Integer values for options can take a "G" multiplier.
467
468 12. defer=pass option for the ACL control cutthrough_delivery, to reflect 4xx
469     returns from the target back to the initiator, rather than spooling the
470     message.
471
472 13. New built-in constants available for tls_dhparam and default changed.
473
474 14. If built with EXPERIMENTAL_QUEUEFILE, a queuefile transport, for writing
475     out copies of the message spool files for use by 3rd-party scanners.
476
477 15. A new option on the smtp transport, hosts_try_fastopen.  If the system
478     supports it (on Linux it must be enabled in the kernel by the sysadmin)
479     try to use RFC 7413 "TCP Fast Open".  No data is sent on the SYN segment
480     but it permits a peer that also supports the facility to send its SMTP
481     banner immediately after the SYN,ACK segment rather then waiting for
482     another ACK - so saving up to one roundtrip time.  Because it requires
483     previous communication with the peer (we save a cookie from it) this
484     will only become active on frequently-contacted destinations.
485
486 16. A new syslog_pid option to suppress PID duplication in syslog lines.
487
488
489 Version 4.87
490 ------------
491
492  1. The ACL conditions regex and mime_regex now capture substrings
493     into numeric variables $regex1 to 9, like the "match" expansion condition.
494
495  2. New $callout_address variable records the address used for a spam=,
496     malware= or verify= callout.
497
498  3. Transports now take a "max_parallel" option, to limit concurrency.
499
500  4. Expansion operators ${ipv6norm:<string>} and ${ipv6denorm:<string>}.
501     The latter expands to a 8-element colon-sep set of hex digits including
502     leading zeroes. A trailing ipv4-style dotted-decimal set is converted
503     to hex.  Pure ipv4 addresses are converted to IPv4-mapped IPv6.
504     The former operator strips leading zeroes and collapses the longest
505     set of 0-groups to a double-colon.
506
507  5. New "-bP config" support, to dump the effective configuration.
508
509  6. New $dkim_key_length variable.
510
511  7. New base64d and base64 expansion items (the existing str2b64 being a
512     synonym of the latter).  Add support in base64 for certificates.
513
514  8. New main configuration option "bounce_return_linesize_limit" to
515     avoid oversize bodies in bounces. The default value matches RFC
516     limits.
517
518  9. New $initial_cwd expansion variable.
519
520
521 Version 4.86
522 ------------
523
524  1. Support for using the system standard CA bundle.
525
526  2. New expansion items $config_file, $config_dir, containing the file
527     and directory name of the main configuration file. Also $exim_version.
528
529  3. New "malware=" support for Avast.
530
531  4. New "spam=" variant option for Rspamd.
532
533  5. Assorted options on malware= and spam= scanners.
534
535  6. A command-line option to write a comment into the logfile.
536
537  7. If built with EXPERIMENTAL_SOCKS feature enabled, the smtp transport can
538     be configured to make connections via socks5 proxies.
539
540  8. If built with EXPERIMENTAL_INTERNATIONAL, support is included for
541     the transmission of UTF-8 envelope addresses.
542
543  9. If built with EXPERIMENTAL_INTERNATIONAL, an expansion item for a commonly
544     used encoding of Maildir folder names.
545
546 10. A logging option for slow DNS lookups.
547
548 11. New ${env {<variable>}} expansion.
549
550 12. A non-SMTP authenticator using information from TLS client certificates.
551
552 13. Main option "tls_eccurve" for selecting an Elliptic Curve for TLS.
553     Patch originally by Wolfgang Breyha.
554
555 14. Main option "dns_trust_aa" for trusting your local nameserver at the
556     same level as DNSSEC.
557
558 Version 4.85
559 ------------
560
561  1. If built with EXPERIMENTAL_DANE feature enabled, Exim will follow the
562     DANE SMTP draft to assess a secure chain of trust of the certificate
563     used to establish the TLS connection based on a TLSA record in the
564     domain of the sender.
565
566  2. The EXPERIMENTAL_TPDA feature has been renamed to EXPERIMENTAL_EVENT
567     and several new events have been created. The reason is because it has
568     been expanded beyond just firing events during the transport phase. Any
569     existing TPDA transport options will have to be rewritten to use a new
570     $event_name expansion variable in a condition. Refer to the
571     experimental-spec.txt for details and examples.
572
573  3. The EXPERIMENTAL_CERTNAMES features is an enhancement to verify that
574     server certs used for TLS match the result of the MX lookup. It does
575     not use the same mechanism as DANE.
576
577
578 Version 4.84
579 ------------
580
581
582 Version 4.83
583 ------------
584
585  1. If built with the EXPERIMENTAL_PROXY feature enabled, Exim can be
586     configured to expect an initial header from a proxy that will make the
587     actual external source IP:host be used in exim instead of the IP of the
588     proxy that is connecting to it.
589
590  2. New verify option header_names_ascii, which will check to make sure
591     there are no non-ASCII characters in header names.  Exim itself handles
592     those non-ASCII characters, but downstream apps may not, so Exim can
593     detect and reject if those characters are present.
594
595  3. New expansion operator ${utf8clean:string} to replace malformed UTF8
596     codepoints with valid ones.
597
598  4. New malware type "sock".  Talks over a Unix or TCP socket, sending one
599     command line and matching a regex against the return data for trigger
600     and a second regex to extract malware_name.  The mail spoolfile name can
601     be included in the command line.
602
603  5. The smtp transport now supports options "tls_verify_hosts" and
604     "tls_try_verify_hosts".  If either is set the certificate verification
605     is split from the encryption operation. The default remains that a failed
606     verification cancels the encryption.
607
608  6. New SERVERS override of default ldap server list.  In the ACLs, an ldap
609     lookup can now set a list of servers to use that is different from the
610     default list.
611
612  7. New command-line option -C for exiqgrep to specify alternate exim.conf
613     file when searching the queue.
614
615  8. OCSP now supports GnuTLS also, if you have version 3.1.3 or later of that.
616
617  9. Support for DNSSEC on outbound connections.
618
619 10. New variables "tls_(in,out)_(our,peer)cert" and expansion item
620     "certextract" to extract fields from them. Hash operators md5 and sha1
621     work over them for generating fingerprints, and a new sha256 operator
622     for them added.
623
624 11. PRDR is now supported dy default.
625
626 12. OCSP stapling is now supported by default.
627
628 13. If built with the EXPERIMENTAL_DSN feature enabled, Exim will output
629     Delivery Status Notification messages in MIME format, and negotiate
630     DSN features per RFC 3461.
631
632
633 Version 4.82
634 ------------
635
636  1. New command-line option -bI:sieve will list all supported sieve extensions
637     of this Exim build on standard output, one per line.
638     ManageSieve (RFC 5804) providers managing scripts for use by Exim should
639     query this to establish the correct list to include in the protocol's
640     SIEVE capability line.
641
642  2. If the -n option is combined with the -bP option, then the name of an
643     emitted option is not output, only the value (if visible to you).
644     For instance, "exim -n -bP pid_file_path" should just emit a pathname
645     followed by a newline, and no other text.
646
647  3. When built with SUPPORT_TLS and USE_GNUTLS, the SMTP transport driver now
648     has a "tls_dh_min_bits" option, to set the minimum acceptable number of
649     bits in the Diffie-Hellman prime offered by a server (in DH ciphersuites)
650     acceptable for security.  (Option accepted but ignored if using OpenSSL).
651     Defaults to 1024, the old value.  May be lowered only to 512, or raised as
652     far as you like.  Raising this may hinder TLS interoperability with other
653     sites and is not currently recommended.  Lowering this will permit you to
654     establish a TLS session which is not as secure as you might like.
655
656     Unless you really know what you are doing, leave it alone.
657
658  4. If not built with DISABLE_DNSSEC, Exim now has the main option
659     dns_dnssec_ok; if set to 1 then Exim will initialise the resolver library
660     to send the DO flag to your recursive resolver.  If you have a recursive
661     resolver, which can set the Authenticated Data (AD) flag in results, Exim
662     can now detect this.  Exim does not perform validation itself, instead
663     relying upon a trusted path to the resolver.
664
665     Current status: work-in-progress; $sender_host_dnssec variable added.
666
667  5. DSCP support for outbound connections: on a transport using the smtp driver,
668     set "dscp = ef", for instance, to cause the connections to have the relevant
669     DSCP (IPv4 TOS or IPv6 TCLASS) value in the header.
670
671     Similarly for inbound connections, there is a new control modifier, dscp,
672     so "warn control = dscp/ef" in the connect ACL, or after authentication.
673
674     Supported values depend upon system libraries.  "exim -bI:dscp" to list the
675     ones Exim knows of.  You can also set a raw number 0..0x3F.
676
677  6. The -G command-line flag is no longer ignored; it is now equivalent to an
678     ACL setting "control = suppress_local_fixups".  The -L command-line flag
679     is now accepted and forces use of syslog, with the provided tag as the
680     process name.  A few other flags used by Sendmail are now accepted and
681     ignored.
682
683  7. New cutthrough routing feature.  Requested by a "control = cutthrough_delivery"
684     ACL modifier; works for single-recipient mails which are received on and
685     deliverable via SMTP.  Using the connection made for a recipient verify,
686     if requested before the verify, or a new one made for the purpose while
687     the inbound connection is still active.  The bulk of the mail item is copied
688     direct from the inbound socket to the outbound (as well as the spool file).
689     When the source notifies the end of data, the data acceptance by the destination
690     is negotiated before the acceptance is sent to the source.  If the destination
691     does not accept the mail item, for example due to content-scanning, the item
692     is not accepted from the source and therefore there is no need to generate
693     a bounce mail.  This is of benefit when providing a secondary-MX service.
694     The downside is that delays are under the control of the ultimate destination
695     system not your own.
696
697     The Received-by: header on items delivered by cutthrough is generated
698     early in reception rather than at the end; this will affect any timestamp
699     included.  The log line showing delivery is recorded before that showing
700     reception; it uses a new ">>" tag instead of "=>".
701
702     To support the feature, verify-callout connections can now use ESMTP and TLS.
703     The usual smtp transport options are honoured, plus a (new, default everything)
704     hosts_verify_avoid_tls.
705
706     New variable families named tls_in_cipher, tls_out_cipher etc. are introduced
707     for specific access to the information for each connection.  The old names
708     are present for now but deprecated.
709
710     Not yet supported: IGNOREQUOTA, SIZE, PIPELINING.
711
712  8. New expansion operators ${listnamed:name} to get the content of a named list
713     and ${listcount:string} to count the items in a list.
714
715  9. New global option "gnutls_allow_auto_pkcs11", defaults false.  The GnuTLS
716     rewrite in 4.80 combines with GnuTLS 2.12.0 or later, to autoload PKCS11
717     modules.  For some situations this is desirable, but we expect admin in
718     those situations to know they want the feature.  More commonly, it means
719     that GUI user modules get loaded and are broken by the setuid Exim being
720     unable to access files specified in environment variables and passed
721     through, thus breakage.  So we explicitly inhibit the PKCS11 initialisation
722     unless this new option is set.
723
724     Some older OS's with earlier versions of GnuTLS might not have pkcs11 ability,
725     so have also added a build option which can be used to build Exim with GnuTLS
726     but without trying to use any kind of PKCS11 support.  Uncomment this in the
727     Local/Makefile:
728
729     AVOID_GNUTLS_PKCS11=yes
730
731 10. The "acl = name" condition on an ACL now supports optional arguments.
732     New expansion item "${acl {name}{arg}...}" and expansion condition
733     "acl {{name}{arg}...}" are added.  In all cases up to nine arguments
734     can be used, appearing in $acl_arg1 to $acl_arg9 for the called ACL.
735     Variable $acl_narg contains the number of arguments.  If the ACL sets
736     a "message =" value this becomes the result of the expansion item,
737     or the value of $value for the expansion condition.  If the ACL returns
738     accept the expansion condition is true; if reject, false.  A defer
739     return results in a forced fail.
740
741 11. Routers and transports can now have multiple headers_add and headers_remove
742     option lines.  The concatenated list is used.
743
744 12. New ACL modifier "remove_header" can remove headers before message gets
745     handled by routers/transports.
746
747 13. New dnsdb lookup pseudo-type "a+".  A sequence of "a6" (if configured),
748     "aaaa" and "a" lookups is done and the full set of results returned.
749
750 14. New expansion variable $headers_added with content from ACL add_header
751     modifier (but not yet added to message).
752
753 15. New 8bitmime status logging option for received messages.  Log field "M8S".
754
755 16. New authenticated_sender logging option, adding to log field "A".
756
757 17. New expansion variables $router_name and $transport_name.  Useful
758     particularly for debug_print as -bt command-line option does not
759     require privilege whereas -d does.
760
761 18. If built with EXPERIMENTAL_PRDR, per-recipient data responses per a
762     proposed extension to SMTP from Eric Hall.
763
764 19. The pipe transport has gained the force_command option, to allow
765     decorating commands from user .forward pipe aliases with prefix
766     wrappers, for instance.
767
768 20. Callout connections can now AUTH; the same controls as normal delivery
769     connections apply.
770
771 21. Support for DMARC, using opendmarc libs, can be enabled. It adds new
772     options: dmarc_forensic_sender, dmarc_history_file, and dmarc_tld_file.
773     It adds new expansion variables $dmarc_ar_header, $dmarc_status,
774     $dmarc_status_text, and $dmarc_used_domain.  It adds a new acl modifier
775     dmarc_status.  It adds new control flags dmarc_disable_verify and
776     dmarc_enable_forensic. The default for the dmarc_tld_file option is
777     "/etc/exim/opendmarc.tlds" and can be changed via EDITME.
778
779 22. Add expansion variable $authenticated_fail_id, which is the username
780     provided to the authentication method which failed.  It is available
781     for use in subsequent ACL processing (typically quit or notquit ACLs).
782
783 23. New ACL modifier "udpsend" can construct a UDP packet to send to a given
784     UDP host and port.
785
786 24. New ${hexquote:..string..} expansion operator converts non-printable
787     characters in the string to \xNN form.
788
789 25. Experimental TPDA (Transport Post Delivery Action) function added.
790     Patch provided by Axel Rau.
791
792 26. Experimental Redis lookup added. Patch provided by Warren Baker.
793
794
795 Version 4.80
796 ------------
797
798  1. New authenticator driver, "gsasl".  Server-only (at present).
799     This is a SASL interface, licensed under GPL, which can be found at
800     http://www.gnu.org/software/gsasl/.
801     This system does not provide sources of data for authentication, so
802     careful use needs to be made of the conditions in Exim.
803
804  2. New authenticator driver, "heimdal_gssapi".  Server-only.
805     A replacement for using cyrus_sasl with Heimdal, now that $KRB5_KTNAME
806     is no longer honoured for setuid programs by Heimdal.  Use the
807     "server_keytab" option to point to the keytab.
808
809  3. The "pkg-config" system can now be used when building Exim to reference
810     cflags and library information for lookups and authenticators, rather
811     than having to update "CFLAGS", "AUTH_LIBS", "LOOKUP_INCLUDE" and
812     "LOOKUP_LIBS" directly.  Similarly for handling the TLS library support
813     without adjusting "TLS_INCLUDE" and "TLS_LIBS".
814
815     In addition, setting PCRE_CONFIG=yes will query the pcre-config tool to
816     find the headers and libraries for PCRE.
817
818  4. New expansion variable $tls_bits.
819
820  5. New lookup type, "dbmjz".  Key is an Exim list, the elements of which will
821     be joined together with ASCII NUL characters to construct the key to pass
822     into the DBM library.  Can be used with gsasl to access sasldb2 files as
823     used by Cyrus SASL.
824
825  6. OpenSSL now supports TLS1.1 and TLS1.2 with OpenSSL 1.0.1.
826
827     Avoid release 1.0.1a if you can.  Note that the default value of
828     "openssl_options" is no longer "+dont_insert_empty_fragments", as that
829     increased susceptibility to attack.  This may still have interoperability
830     implications for very old clients (see version 4.31 change 37) but
831     administrators can choose to make the trade-off themselves and restore
832     compatibility at the cost of session security.
833
834  7. Use of the new expansion variable $tls_sni in the main configuration option
835     tls_certificate will cause Exim to re-expand the option, if the client
836     sends the TLS Server Name Indication extension, to permit choosing a
837     different certificate; tls_privatekey will also be re-expanded.  You must
838     still set these options to expand to valid files when $tls_sni is not set.
839
840     The SMTP Transport has gained the option tls_sni, which will set a hostname
841     for outbound TLS sessions, and set $tls_sni too.
842
843     A new log_selector, +tls_sni, has been added, to log received SNI values
844     for Exim as a server.
845
846  8. The existing "accept_8bitmime" option now defaults to true.  This means
847     that Exim is deliberately not strictly RFC compliant.  We're following
848     Dan Bernstein's advice in http://cr.yp.to/smtp/8bitmime.html by default.
849     Those who disagree, or know that they are talking to mail servers that,
850     even today, are not 8-bit clean, need to turn off this option.
851
852  9. Exim can now be started with -bw (with an optional timeout, given as
853     -bw<timespec>).  With this, stdin at startup is a socket that is
854     already listening for connections.  This has a more modern name of
855     "socket activation", but forcing the activated socket to fd 0.  We're
856     interested in adding more support for modern variants.
857
858 10. ${eval } now uses 64-bit values on supporting platforms.  A new "G" suffix
859     for numbers indicates multiplication by 1024^3.
860
861 11. The GnuTLS support has been revamped; the three options gnutls_require_kx,
862     gnutls_require_mac & gnutls_require_protocols are no longer supported.
863     tls_require_ciphers is now parsed by gnutls_priority_init(3) as a priority
864     string, documentation for which is at:
865     http://www.gnutls.org/manual/html_node/Priority-Strings.html
866
867     SNI support has been added to Exim's GnuTLS integration too.
868
869     For sufficiently recent GnuTLS libraries, ${randint:..} will now use
870     gnutls_rnd(), asking for GNUTLS_RND_NONCE level randomness.
871
872 12. With OpenSSL, if built with EXPERIMENTAL_OCSP, a new option tls_ocsp_file
873     is now available.  If the contents of the file are valid, then Exim will
874     send that back in response to a TLS status request; this is OCSP Stapling.
875     Exim will not maintain the contents of the file in any way: administrators
876     are responsible for ensuring that it is up-to-date.
877
878     See "experimental-spec.txt" for more details.
879
880 13. ${lookup dnsdb{ }} supports now SPF record types. They are handled
881     identically to TXT record lookups.
882
883 14. New expansion variable $tod_epoch_l for higher-precision time.
884
885 15. New global option tls_dh_max_bits, defaulting to current value of NSS
886     hard-coded limit of DH ephemeral bits, to fix interop problems caused by
887     GnuTLS 2.12 library recommending a bit count higher than NSS supports.
888
889 16. tls_dhparam now used by both OpenSSL and GnuTLS, can be path or identifier.
890     Option can now be a path or an identifier for a standard prime.
891     If unset, we use the DH prime from section 2.2 of RFC 5114, "ike23".
892     Set to "historic" to get the old GnuTLS behaviour of auto-generated DH
893     primes.
894
895 17. SSLv2 now disabled by default in OpenSSL.  (Never supported by GnuTLS).
896     Use "openssl_options -no_sslv2" to re-enable support, if your OpenSSL
897     install was not built with OPENSSL_NO_SSL2 ("no-ssl2").
898
899
900 Version 4.77
901 ------------
902
903  1. New options for the ratelimit ACL condition: /count= and /unique=.
904     The /noupdate option has been replaced by a /readonly option.
905
906  2. The SMTP transport's protocol option may now be set to "smtps", to
907     use SSL-on-connect outbound.
908
909  3. New variable $av_failed, set true if the AV scanner deferred; ie, when
910     there is a problem talking to the AV scanner, or the AV scanner running.
911
912  4. New expansion conditions, "inlist" and "inlisti", which take simple lists
913     and check if the search item is a member of the list.  This does not
914     support named lists, but does subject the list part to string expansion.
915
916  5. Unless the new EXPAND_LISTMATCH_RHS build option is set when Exim was
917     built, Exim no longer performs string expansion on the second string of
918     the match_* expansion conditions: "match_address", "match_domain",
919     "match_ip" & "match_local_part".  Named lists can still be used.
920
921
922 Version 4.76
923 ------------
924
925  1. The global option "dns_use_edns0" may be set to coerce EDNS0 usage on
926     or off in the resolver library.
927
928
929 Version 4.75
930 ------------
931
932  1. In addition to the existing LDAP and LDAP/SSL ("ldaps") support, there
933     is now LDAP/TLS support, given sufficiently modern OpenLDAP client
934     libraries.  The following global options have been added in support of
935     this: ldap_ca_cert_dir, ldap_ca_cert_file, ldap_cert_file, ldap_cert_key,
936     ldap_cipher_suite, ldap_require_cert, ldap_start_tls.
937
938  2. The pipe transport now takes a boolean option, "freeze_signal", default
939     false.  When true, if the external delivery command exits on a signal then
940     Exim will freeze the message in the queue, instead of generating a bounce.
941
942  3. Log filenames may now use %M as an escape, instead of %D (still available).
943     The %M pattern expands to yyyymm, providing month-level resolution.
944
945  4. The $message_linecount variable is now updated for the maildir_tag option,
946     in the same way as $message_size, to reflect the real number of lines,
947     including any header additions or removals from transport.
948
949  5. When contacting a pool of SpamAssassin servers configured in spamd_address,
950     Exim now selects entries randomly, to better scale in a cluster setup.
951
952
953 Version 4.74
954 ------------
955
956  1. SECURITY FIX: privilege escalation flaw fixed. On Linux (and only Linux)
957     the flaw permitted the Exim run-time user to cause root to append to
958     arbitrary files of the attacker's choosing, with the content based
959     on content supplied by the attacker.
960
961  2. Exim now supports loading some lookup types at run-time, using your
962     platform's dlopen() functionality.  This has limited platform support
963     and the intention is not to support every variant, it's limited to
964     dlopen().  This permits the main Exim binary to not be linked against
965     all the libraries needed for all the lookup types.
966
967
968 Version 4.73
969 ------------
970
971  NOTE: this version is not guaranteed backwards-compatible, please read the
972        items below carefully
973
974  1. A new main configuration option, "openssl_options", is available if Exim
975     is built with SSL support provided by OpenSSL.  The option allows
976     administrators to specify OpenSSL options to be used on connections;
977     typically this is to set bug compatibility features which the OpenSSL
978     developers have not enabled by default.  There may be security
979     consequences for certain options, so these should not be changed
980     frivolously.
981
982  2. A new pipe transport option, "permit_coredumps", may help with problem
983     diagnosis in some scenarios.  Note that Exim is typically installed as
984     a setuid binary, which on most OSes will inhibit coredumps by default,
985     so that safety mechanism would have to be overridden for this option to
986     be able to take effect.
987
988  3. ClamAV 0.95 is now required for ClamAV support in Exim, unless
989     Local/Makefile sets: WITH_OLD_CLAMAV_STREAM=yes
990     Note that this switches Exim to use a new API ("INSTREAM") and a future
991     release of ClamAV will remove support for the old API ("STREAM").
992
993     The av_scanner option, when set to "clamd", now takes an optional third
994     part, "local", which causes Exim to pass a filename to ClamAV instead of
995     the file content.  This is the same behaviour as when clamd is pointed at
996     a Unix-domain socket.  For example:
997
998       av_scanner = clamd:192.0.2.3 1234:local
999
1000     ClamAV's ExtendedDetectionInfo response format is now handled.
1001
1002  4. There is now a -bmalware option, restricted to admin users.  This option
1003     takes one parameter, a filename, and scans that file with Exim's
1004     malware-scanning framework.  This is intended purely as a debugging aid
1005     to ensure that Exim's scanning is working, not to replace other tools.
1006     Note that the ACL framework is not invoked, so if av_scanner references
1007     ACL variables without a fallback then this will fail.
1008
1009  5. There is a new expansion operator, "reverse_ip", which will reverse IP
1010     addresses; IPv4 into dotted quad, IPv6 into dotted nibble.  Examples:
1011
1012       ${reverse_ip:192.0.2.4}
1013        -> 4.2.0.192
1014       ${reverse_ip:2001:0db8:c42:9:1:abcd:192.0.2.3}
1015        -> 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
1016
1017  6. There is a new ACL control called "debug", to enable debug logging.
1018     This allows selective logging of certain incoming transactions within
1019     production environments, with some care.  It takes two options, "tag"
1020     and "opts"; "tag" is included in the filename of the log and "opts"
1021     is used as per the -d<options> command-line option.  Examples, which
1022     don't all make sense in all contexts:
1023
1024       control = debug
1025       control = debug/tag=.$sender_host_address
1026       control = debug/opts=+expand+acl
1027       control = debug/tag=.$message_exim_id/opts=+expand
1028
1029  7. It has always been implicit in the design and the documentation that
1030     "the Exim user" is not root.  src/EDITME said that using root was
1031     "very strongly discouraged".  This is not enough to keep people from
1032     shooting themselves in the foot in days when many don't configure Exim
1033     themselves but via package build managers.  The security consequences of
1034     running various bits of network code are severe if there should be bugs in
1035     them.  As such, the Exim user may no longer be root.  If configured
1036     statically, Exim will refuse to build.  If configured as ref:user then Exim
1037     will exit shortly after start-up.  If you must shoot yourself in the foot,
1038     then henceforth you will have to maintain your own local patches to strip
1039     the safeties off.
1040
1041  8. There is a new expansion condition, bool_lax{}.  Where bool{} uses the ACL
1042     condition logic to determine truth/failure and will fail to expand many
1043     strings, bool_lax{} uses the router condition logic, where most strings
1044     do evaluate true.
1045     Note: bool{00} is false, bool_lax{00} is true.
1046
1047  9. Routers now support multiple "condition" tests.
1048
1049 10. There is now a runtime configuration option "tcp_wrappers_daemon_name".
1050     Setting this allows an admin to define which entry in the tcpwrappers
1051     config file will be used to control access to the daemon.  This option
1052     is only available when Exim is built with USE_TCP_WRAPPERS.  The
1053     default value is set at build time using the TCP_WRAPPERS_DAEMON_NAME
1054     build option.
1055
1056 11. [POSSIBLE CONFIG BREAKAGE] The default value for system_filter_user is now
1057     the Exim run-time user, instead of root.
1058
1059 12. [POSSIBLE CONFIG BREAKAGE] ALT_CONFIG_ROOT_ONLY is no longer optional and
1060     is forced on.  This is mitigated by the new build option
1061     TRUSTED_CONFIG_LIST which defines a list of configuration files which
1062     are trusted; one per line. If a config file is owned by root and matches
1063     a pathname in the list, then it may be invoked by the Exim build-time
1064     user without Exim relinquishing root privileges.
1065
1066 13. [POSSIBLE CONFIG BREAKAGE] The Exim user is no longer automatically
1067     trusted to supply -D<Macro[=Value]> overrides on the command-line.  Going
1068     forward, we recommend using TRUSTED_CONFIG_LIST with shim configs that
1069     include the main config.  As a transition mechanism, we are temporarily
1070     providing a work-around: the new build option WHITELIST_D_MACROS provides
1071     a colon-separated list of macro names which may be overridden by the Exim
1072     run-time user.  The values of these macros are constrained to the regex
1073     ^[A-Za-z0-9_/.-]*$ (which explicitly does allow for empty values).
1074
1075
1076 Version 4.72
1077 ------------
1078
1079  1. TWO SECURITY FIXES: one relating to mail-spools which are globally
1080     writable, the other to locking of MBX folders (not mbox).
1081
1082  2. MySQL stored procedures are now supported.
1083
1084  3. The dkim_domain transport option is now a list, not a single string, and
1085     messages will be signed for each element in the list (discarding
1086     duplicates).
1087
1088  4. The 4.70 release unexpectedly changed the behaviour of dnsdb TXT lookups
1089     in the presence of multiple character strings within the RR. Prior to 4.70,
1090     only the first string would be returned.  The dnsdb lookup now, by default,
1091     preserves the pre-4.70 semantics, but also now takes an extended output
1092     separator specification.  The separator can be followed by a semicolon, to
1093     concatenate the individual text strings together with no join character,
1094     or by a comma and a second separator character, in which case the text
1095     strings within a TXT record are joined on that second character.
1096     Administrators are reminded that DNS provides no ordering guarantees
1097     between multiple records in an RRset.  For example:
1098
1099       foo.example.  IN TXT "a" "b" "c"
1100       foo.example.  IN TXT "d" "e" "f"
1101
1102       ${lookup dnsdb{>/ txt=foo.example}}   -> "a/d"
1103       ${lookup dnsdb{>/; txt=foo.example}}  -> "def/abc"
1104       ${lookup dnsdb{>/,+ txt=foo.example}} -> "a+b+c/d+e+f"
1105
1106
1107 Version 4.70 / 4.71
1108 -------------------
1109
1110  1. Native DKIM support without an external library.
1111     (Note that if no action to prevent it is taken, a straight upgrade will
1112     result in DKIM verification of all signed incoming emails.  See spec
1113     for details on conditionally disabling)
1114
1115  2. Experimental DCC support via dccifd (contributed by Wolfgang Breyha).
1116
1117  3. There is now a bool{} expansion condition which maps certain strings to
1118     true/false condition values (most likely of use in conjunction with the
1119     and{} expansion operator).
1120
1121  4. The $spam_score, $spam_bar and $spam_report variables are now available
1122     at delivery time.
1123
1124  5. exim -bP now supports "macros", "macro_list" or "macro MACRO_NAME" as
1125     options, provided that Exim is invoked by an admin_user.
1126
1127  6. There is a new option gnutls_compat_mode, when linked against GnuTLS,
1128     which increases compatibility with older clients at the cost of decreased
1129     security.  Don't set this unless you need to support such clients.
1130
1131  7. There is a new expansion operator, ${randint:...} which will produce a
1132     "random" number less than the supplied integer.  This randomness is
1133     not guaranteed to be cryptographically strong, but depending upon how
1134     Exim was built may be better than the most naive schemes.
1135
1136  8. Exim now explicitly ensures that SHA256 is available when linked against
1137     OpenSSL.
1138
1139  9. The transport_filter_timeout option now applies to SMTP transports too.
1140
1141
1142 Version 4.69
1143 ------------
1144
1145  1. Preliminary DKIM support in Experimental.
1146
1147
1148 Version 4.68
1149 ------------
1150
1151  1. The body_linecount and body_zerocount C variables are now exported in the
1152     local_scan API.
1153
1154  2. When a dnslists lookup succeeds, the key that was looked up is now placed
1155     in $dnslist_matched. When the key is an IP address, it is not reversed in
1156     this variable (though it is, of course, in the actual lookup). In simple
1157     cases, for example:
1158
1159       deny dnslists = spamhaus.example
1160
1161     the key is also available in another variable (in this case,
1162     $sender_host_address). In more complicated cases, however, this is not
1163     true. For example, using a data lookup might generate a dnslists lookup
1164     like this:
1165
1166       deny dnslists = spamhaus.example/<|192.168.1.2|192.168.6.7|...
1167
1168     If this condition succeeds, the value in $dnslist_matched might be
1169     192.168.6.7 (for example).
1170
1171  3. Authenticators now have a client_condition option. When Exim is running as
1172     a client, it skips an authenticator whose client_condition expansion yields
1173     "0", "no", or "false". This can be used, for example, to skip plain text
1174     authenticators when the connection is not encrypted by a setting such as:
1175
1176       client_condition = ${if !eq{$tls_cipher}{}}
1177
1178     Note that the 4.67 documentation states that $tls_cipher contains the
1179     cipher used for incoming messages. In fact, during SMTP delivery, it
1180     contains the cipher used for the delivery. The same is true for
1181     $tls_peerdn.
1182
1183  4. There is now a -Mvc <message-id> option, which outputs a copy of the
1184     message to the standard output, in RFC 2822 format. The option can be used
1185     only by an admin user.
1186
1187  5. There is now a /noupdate option for the ratelimit ACL condition. It
1188     computes the rate and checks the limit as normal, but it does not update
1189     the saved data. This means that, in relevant ACLs, it is possible to lookup
1190     the existence of a specified (or auto-generated) ratelimit key without
1191     incrementing the ratelimit counter for that key.
1192
1193     In order for this to be useful, another ACL entry must set the rate
1194     for the same key somewhere (otherwise it will always be zero).
1195
1196     Example:
1197
1198     acl_check_connect:
1199       # Read the rate; if it doesn't exist or is below the maximum
1200       # we update it below
1201       deny ratelimit = 100 / 5m / strict / noupdate
1202            log_message = RATE: $sender_rate / $sender_rate_period \
1203                          (max $sender_rate_limit)
1204
1205       [... some other logic and tests...]
1206
1207       warn ratelimit = 100 / 5m / strict / per_cmd
1208            log_message = RATE UPDATE: $sender_rate / $sender_rate_period \
1209                          (max $sender_rate_limit)
1210            condition = ${if le{$sender_rate}{$sender_rate_limit}}
1211
1212       accept
1213
1214  6. The variable $max_received_linelength contains the number of bytes in the
1215     longest line that was received as part of the message, not counting the
1216     line termination character(s).
1217
1218  7. Host lists can now include +ignore_defer and +include_defer, analogous to
1219     +ignore_unknown and +include_unknown. These options should be used with
1220     care, probably only in non-critical host lists such as whitelists.
1221
1222  8. There's a new option called queue_only_load_latch, which defaults true.
1223     If set false when queue_only_load is greater than zero, Exim re-evaluates
1224     the load for each incoming message in an SMTP session. Otherwise, once one
1225     message is queued, the remainder are also.
1226
1227  9. There is a new ACL, specified by acl_smtp_notquit, which is run in most
1228     cases when an SMTP session ends without sending QUIT. However, when Exim
1229     itself is in bad trouble, such as being unable to write to its log files,
1230     this ACL is not run, because it might try to do things (such as write to
1231     log files) that make the situation even worse.
1232
1233     Like the QUIT ACL, this new ACL is provided to make it possible to gather
1234     statistics. Whatever it returns (accept or deny) is immaterial. The "delay"
1235     modifier is forbidden in this ACL.
1236
1237     When the NOTQUIT ACL is running, the variable $smtp_notquit_reason is set
1238     to a string that indicates the reason for the termination of the SMTP
1239     connection. The possible values are:
1240
1241       acl-drop                 Another ACL issued a "drop" command
1242       bad-commands             Too many unknown or non-mail commands
1243       command-timeout          Timeout while reading SMTP commands
1244       connection-lost          The SMTP connection has been lost
1245       data-timeout             Timeout while reading message data
1246       local-scan-error         The local_scan() function crashed
1247       local-scan-timeout       The local_scan() function timed out
1248       signal-exit              SIGTERM or SIGINT
1249       synchronization-error    SMTP synchronization error
1250       tls-failed               TLS failed to start
1251
1252     In most cases when an SMTP connection is closed without having received
1253     QUIT, Exim sends an SMTP response message before actually closing the
1254     connection. With the exception of acl-drop, the default message can be
1255     overridden by the "message" modifier in the NOTQUIT ACL. In the case of a
1256     "drop" verb in another ACL, it is the message from the other ACL that is
1257     used.
1258
1259 10. For MySQL and PostgreSQL lookups, it is now possible to specify a list of
1260     servers with individual queries. This is done by starting the query with
1261     "servers=x:y:z;", where each item in the list may take one of two forms:
1262
1263     (1) If it is just a host name, the appropriate global option (mysql_servers
1264         or pgsql_servers) is searched for a host of the same name, and the
1265         remaining parameters (database, user, password) are taken from there.
1266
1267     (2) If it contains any slashes, it is taken as a complete parameter set.
1268
1269     The list of servers is used in exactly the same was as the global list.
1270     Once a connection to a server has happened and a query has been
1271     successfully executed, processing of the lookup ceases.
1272
1273     This feature is intended for use in master/slave situations where updates
1274     are occurring, and one wants to update a master rather than a slave. If the
1275     masters are in the list for reading, you might have:
1276
1277       mysql_servers = slave1/db/name/pw:slave2/db/name/pw:master/db/name/pw
1278
1279     In an updating lookup, you could then write
1280
1281       ${lookup mysql{servers=master; UPDATE ...}
1282
1283     If, on the other hand, the master is not to be used for reading lookups:
1284
1285       pgsql_servers = slave1/db/name/pw:slave2/db/name/pw
1286
1287     you can still update the master by
1288
1289       ${lookup pgsql{servers=master/db/name/pw; UPDATE ...}
1290
1291 11. The message_body_newlines option (default FALSE, for backwards
1292     compatibility) can be used to control whether newlines are present in
1293     $message_body and $message_body_end. If it is FALSE, they are replaced by
1294     spaces.
1295
1296
1297 Version 4.67
1298 ------------
1299
1300  1. There is a new log selector called smtp_no_mail, which is not included in
1301     the default setting. When it is set, a line is written to the main log
1302     whenever an accepted SMTP connection terminates without having issued a
1303     MAIL command.
1304
1305  2. When an item in a dnslists list is followed by = and & and a list of IP
1306     addresses, the behaviour was not clear when the lookup returned more than
1307     one IP address. This has been solved by the addition of == and =& for "all"
1308     rather than the default "any" matching.
1309
1310  3. Up till now, the only control over which cipher suites GnuTLS uses has been
1311     for the cipher algorithms. New options have been added to allow some of the
1312     other parameters to be varied.
1313
1314  4. There is a new compile-time option called ENABLE_DISABLE_FSYNC. When it is
1315     set, Exim compiles a runtime option called disable_fsync.
1316
1317  5. There is a new variable called $smtp_count_at_connection_start.
1318
1319  6. There's a new control called no_pipelining.
1320
1321  7. There are two new variables called $sending_ip_address and $sending_port.
1322     These are set whenever an SMTP connection to another host has been set up.
1323
1324  8. The expansion of the helo_data option in the smtp transport now happens
1325     after the connection to the server has been made.
1326
1327  9. There is a new expansion operator ${rfc2047d: that decodes strings that
1328     are encoded as per RFC 2047.
1329
1330 10. There is a new log selector called "pid", which causes the current process
1331     id to be added to every log line, in square brackets, immediately after the
1332     time and date.
1333
1334 11. Exim has been modified so that it flushes SMTP output before implementing
1335     a delay in an ACL. It also flushes the output before performing a callout,
1336     as this can take a substantial time. These behaviours can be disabled by
1337     obeying control = no_delay_flush or control = no_callout_flush,
1338     respectively, at some earlier stage of the connection.
1339
1340 12. There are two new expansion conditions that iterate over a list. They are
1341     called forany and forall.
1342
1343 13. There's a new global option called dsn_from that can be used to vary the
1344     contents of From: lines in bounces and other automatically generated
1345     messages ("delivery status notifications" - hence the name of the option).
1346
1347 14. The smtp transport has a new option called hosts_avoid_pipelining.
1348
1349 15. By default, exigrep does case-insensitive matches. There is now a -I option
1350     that makes it case-sensitive.
1351
1352 16. A number of new features ("addresses", "map", "filter", and "reduce") have
1353     been added to string expansions to make it easier to process lists of
1354     items, typically addresses.
1355
1356 17. There's a new ACL modifier called "continue". It does nothing of itself,
1357     and processing of the ACL always continues with the next condition or
1358     modifier. It is provided so that the side effects of expanding its argument
1359     can be used.
1360
1361 18. It is now possible to use newline and other control characters (those with
1362     values less than 32, plus DEL) as separators in lists.
1363
1364 19. The exigrep utility now has a -v option, which inverts the matching
1365     condition.
1366
1367 20. The host_find_failed option in the manualroute router can now be set to
1368     "ignore".
1369
1370
1371 Version 4.66
1372 ------------
1373
1374 No new features were added to 4.66.
1375
1376
1377 Version 4.65
1378 ------------
1379
1380 No new features were added to 4.65.
1381
1382
1383 Version 4.64
1384 ------------
1385
1386  1. ACL variables can now be given arbitrary names, as long as they start with
1387     "acl_c" or "acl_m" (for connection variables and message variables), are at
1388     least six characters long, with the sixth character being either a digit or
1389     an underscore.
1390
1391  2. There is a new ACL modifier called log_reject_target. It makes it possible
1392     to specify which logs are used for messages about ACL rejections.
1393
1394  3. There is a new authenticator called "dovecot". This is an interface to the
1395     authentication facility of the Dovecot POP/IMAP server, which can support a
1396     number of authentication methods.
1397
1398  4. The variable $message_headers_raw provides a concatenation of all the
1399     messages's headers without any decoding. This is in contrast to
1400     $message_headers, which does RFC2047 decoding on the header contents.
1401
1402  5. In a DNS black list, if two domain names, comma-separated, are given, the
1403     second is used first to do an initial check, making use of any IP value
1404     restrictions that are set. If there is a match, the first domain is used,
1405     without any IP value restrictions, to get the TXT record.
1406
1407  6. All authenticators now have a server_condition option.
1408
1409  7. There is a new command-line option called -Mset. It is useful only in
1410     conjunction with -be (that is, when testing string expansions). It must be
1411     followed by a message id; Exim loads the given message from its spool
1412     before doing the expansions.
1413
1414  8. Another similar new command-line option is called -bem. It operates like
1415     -be except that it must be followed by the name of a file that contains a
1416     message.
1417
1418  9. When an address is delayed because of a 4xx response to a RCPT command, it
1419     is now the combination of sender and recipient that is delayed in
1420     subsequent queue runs until its retry time is reached.
1421
1422 10. Unary negation and the bitwise logical operators and, or, xor, not, and
1423     shift, have been added to the eval: and eval10: expansion items.
1424
1425 11. The variables $interface_address and $interface_port have been renamed
1426     as $received_ip_address and $received_port, to make it clear that they
1427     relate to message reception rather than delivery. (The old names remain
1428     available for compatibility.)
1429
1430 12. The "message" modifier can now be used on "accept" and "discard" acl verbs
1431     to vary the message that is sent when an SMTP command is accepted.
1432
1433
1434 Version 4.63
1435 ------------
1436
1437 1. There is a new Boolean option called filter_prepend_home for the redirect
1438    router.
1439
1440 2. There is a new acl, set by acl_not_smtp_start, which is run right at the
1441    start of receiving a non-SMTP message, before any of the message has been
1442    read.
1443
1444 3. When an SMTP error message is specified in a "message" modifier in an ACL,
1445    or in a :fail: or :defer: message in a redirect router, Exim now checks the
1446    start of the message for an SMTP error code.
1447
1448 4. There is a new parameter for LDAP lookups called "referrals", which takes
1449    one of the settings "follow" (the default) or "nofollow".
1450
1451 5. Version 20070721.2 of exipick now included, offering these new options:
1452     --reverse
1453         After all other sorting options have bee processed, reverse order
1454         before displaying messages (-R is synonym).
1455     --random
1456         Randomize order of matching messages before displaying.
1457     --size
1458         Instead of displaying the matching messages, display the sum
1459         of their sizes.
1460     --sort <variable>[,<variable>...]
1461         Before displaying matching messages, sort the messages according to
1462         each messages value for each variable.
1463     --not
1464         Negate the value for every test (returns inverse output from the
1465         same criteria without --not).
1466
1467
1468 Version 4.62
1469 ------------
1470
1471 1. The ${readsocket expansion item now supports Internet domain sockets as well
1472    as Unix domain sockets. If the first argument begins "inet:", it must be of
1473    the form "inet:host:port". The port is mandatory; it may be a number or the
1474    name of a TCP port in /etc/services. The host may be a name, or it may be an
1475    IP address. An ip address may optionally be enclosed in square brackets.
1476    This is best for IPv6 addresses. For example:
1477
1478      ${readsocket{inet:[::1]:1234}{<request data>}...
1479
1480    Only a single host name may be given, but if looking it up yield more than
1481    one IP address, they are each tried in turn until a connection is made. Once
1482    a connection has been made, the behaviour is as for ${readsocket with a Unix
1483    domain socket.
1484
1485 2. If a redirect router sets up file or pipe deliveries for more than one
1486    incoming address, and the relevant transport has batch_max set greater than
1487    one, a batch delivery now occurs.
1488
1489 3. The appendfile transport has a new option called maildirfolder_create_regex.
1490    Its value is a regular expression. For a maildir delivery, this is matched
1491    against the maildir directory; if it matches, Exim ensures that a
1492    maildirfolder file is created alongside the new, cur, and tmp directories.
1493
1494
1495 Version 4.61
1496 ------------
1497
1498 The documentation is up-to-date for the 4.61 release. Major new features since
1499 the 4.60 release are:
1500
1501 . An option called disable_ipv6, to disable the use of IPv6 completely.
1502
1503 . An increase in the number of ACL variables to 20 of each type.
1504
1505 . A change to use $auth1, $auth2, and $auth3 in authenticators instead of $1,
1506   $2, $3, (though those are still set) because the numeric variables get used
1507   for other things in complicated expansions.
1508
1509 . The default for rfc1413_query_timeout has been changed from 30s to 5s.
1510
1511 . It is possible to use setclassresources() on some BSD OS to control the
1512   resources used in pipe deliveries.
1513
1514 . A new ACL modifier called add_header, which can be used with any verb.
1515
1516 . More errors are detectable in retry rules.
1517
1518 There are a number of other additions too.
1519
1520
1521 Version 4.60
1522 ------------
1523
1524 The documentation is up-to-date for the 4.60 release. Major new features since
1525 the 4.50 release are:
1526
1527 . Support for SQLite.
1528
1529 . Support for IGNOREQUOTA in LMTP.
1530
1531 . Extensions to the "submission mode" features.
1532
1533 . Support for Client SMTP Authorization (CSA).
1534
1535 . Support for ratelimiting hosts and users.
1536
1537 . New expansion items to help with the BATV "prvs" scheme.
1538
1539 . A "match_ip" condition, that matches an IP address against a list.
1540
1541 There are many more minor changes.
1542
1543 ****