be1bbfe16fb9299760a35d5784e9fb52cb941815
[exim.git] / doc / doc-txt / NewStuff
1 $Cambridge: exim/doc/doc-txt/NewStuff,v 1.14 2004/11/22 11:30:03 ph10 Exp $
2
3 New Features in Exim
4 --------------------
5
6 This file contains descriptions of new features that have been added to Exim,
7 but have not yet made it into the main manual (which is most conveniently
8 updated when there is a relatively large batch of changes). The doc/ChangeLog
9 file contains a listing of all changes, including bug fixes.
10
11
12 Version 4.44
13 ------------
14
15  1. There is a new build-time option called CONFIGURE_GROUP which works like
16     CONFIGURE_OWNER. It specifies one additional group that is permitted for
17     the runtime configuration file when the group write permission is set.
18
19  2. The "control=submission" facility has a new option /retain_sender. This
20     has the effect of setting local_sender_retain true and local_from_check
21     false for the incoming message in which it is encountered.
22
23  3. $recipients is now available in the predata ACL (oversight).
24
25  4. The value of address_data from a sender verification is now available in
26     $sender_address_data in subsequent conditions in the ACL statement. Note:
27     this is just like $address_data. The value does not persist after the end
28     of the current ACL statement. If you want to preserve it, you can use one
29     of the ACL variables.
30
31  5. The redirect router has two new options: forbid_sieve_filter and
32     forbid_exim_filter. When filtering is enabled by allow_filter, these
33     options control which type(s) of filtering are permitted. By default, both
34     Exim and Sieve filters are allowed.
35
36  6. A new option for callouts makes it possible to set a different (usually
37     smaller) timeout for making the SMTP connection. The keyword is "connect".
38     For example:
39
40        verify = sender/callout=5s,connect=1s
41
42     If not specified, it defaults to the general timeout value.
43
44  7. The new variables $sender_verify_failure and $recipient_verify_failure
45     contain information about exactly what failed. In an ACL, after one of
46     these failures, the relevant variable contains one of the following words:
47
48       qualify       the address was unqualified (no domain), and the message
49                     was neither local nor came from an exempted host;
50
51       route         routing failed;
52
53       mail          routing succeeded, and a callout was attempted; rejection
54                     occurred at or before the MAIL command (that is, on initial
55                     connection, HELO, or MAIL);
56
57       recipient     the RCPT command in a callout was rejected;
58
59       postmaster    the postmaster check in a callout was rejected.
60
61     The main use of these variables is expected to be to distinguish between
62     rejections of MAIL and rejections of RCPT.
63
64  8. The command line option -dd behaves exactly like -d except when used on a
65     command that starts a daemon process. In that case, debugging is turned off
66     for the subprocesses that the daemon creates. Thus, it is useful for
67     monitoring the behaviour of the daemon without creating as much output as
68     full debugging.
69
70  9. $host_address is now set to the target address during the checking of
71     ignore_target_hosts.
72
73 10. There are four new variables called $spool_space, $log_space,
74     $spool_inodes, and $log_inodes. The first two contain the amount of free
75     space in the disk partitions where Exim has its spool directory and log
76     directory, respectively. (When these are in the same partition, the values
77     will, of course, be the same.) The second two variables contain the numbers
78     of free inodes in the respective partitions.
79
80     NOTE: Because disks can nowadays be very large, the values in the space
81     variables are in kilobytes rather than in bytes. Thus, for example, to
82     check in an ACL that there is at least 50M free on the spool, you would
83     write:
84
85        condition = ${if > {$spool_space}{50000}{yes}{no}}
86
87     The values are recalculated whenever any of these variables is referenced.
88     If the relevant file system does not have the concept of inodes, the value
89     of those variables is -1. If the operating system does not have the ability
90     to find the amount of free space (only true for experimental systems), the
91     space value is -1.
92
93 11. It is now permitted to omit both strings after an "if" condition; if the
94     condition is true, the result is the string "true". As before, when the
95     second string is omitted, a false condition yields an empty string. This
96     makes it less cumbersome to write custom ACL and router conditions. For
97     example, instead of
98
99       condition = ${if eq {$acl_m4}{1}{yes}{no}}
100
101     or the shorter form
102
103       condition = ${if eq {$acl_m4}{1}{yes}}
104
105     (because the second string has always defaulted to ""), you can now write
106
107       condition = ${if eq {$acl_m4}{1}}
108
109     Previously this was a syntax error.
110
111 12. There is now a new "record type" that can be specified in dnsdb lookups. It
112     is "zns" (for "zone NS"). It performs a lookup for NS records on the given
113     domain, but if none are found, it removes the first component of the domain
114     name, and tries again. This process continues until NS records are found
115     or there are no more components left (or there's a DNS error). In other
116     words, it may return the name servers for a top-level domain, but it never
117     returns the root name servers. If there are no NS records for the top-level
118     domain, the lookup fails.
119
120     For example, ${lookup dnsdb{zns=xxx.quercite.com}} returns the name
121     servers for quercite.com, whereas ${lookup dnsdb{zns=xxx.edu}} returns
122     the name servers for edu, assuming in each case that there are no NS
123     records for the full domain name.
124
125     You should be careful about how you use this lookup because, unless the
126     top-level domain does not exist, the lookup will always return some host
127     names. The sort of use to which this might be put is for seeing if the name
128     servers for a given domain are on a blacklist. You can probably assume that
129     the name servers for the high-level domains such as .com or .co.uk are not
130     going to be on such a list.
131
132 13. It is now possible to specify a list of domains or IP addresses to be
133     looked up in a dnsdb lookup. The list is specified in the normal Exim way,
134     with colon as the default separator, but with the ability to change this.
135     For example:
136
137       ${lookup dnsdb{one.domain.com:two.domain.com}}
138       ${lookup dnsdb{a=one.host.com:two.host.com}}
139       ${lookup dnsdb{ptr = <; 1.2.3.4 ; 4.5.6.8}}
140
141     In order to retain backwards compatibility, there is one special case: if
142     the lookup type is PTR and no change of separator is specified, Exim looks
143     to see if the rest of the string is precisely one IPv6 address. In this
144     case, it does not treat it as a list.
145
146     The data from each lookup is concatenated, with newline separators (by
147     default - see 14 below), in the same way that multiple DNS records for a
148     single item are handled.
149
150     The lookup fails only if all the DNS lookups fail. As long as at least one
151     of them yields some data, the lookup succeeds. However, if there is a
152     temporary DNS error for any of them, the lookup defers.
153
154 14. It is now possible to specify the character to be used as a separator when
155     a dnsdb lookup returns data from more than one DNS record. The default is a
156     newline. To specify a different character, put '>' followed by the new
157     character at the start of the query. For example:
158
159       ${lookup dnsdb{>: a=h1.test.ex:h2.test.ex}}
160       ${lookup dnsdb{>| mx=<;m1.test.ex;m2.test.ex}}
161
162     It is permitted to specify a space as the separator character. Note that
163     more than one DNS record can be found for a single lookup item; this
164     feature is relevant even when you do not specify a list.
165
166     The same effect could be achieved by wrapping the lookup in ${tr...}; this
167     feature is just a syntactic simplification.
168
169 15. It is now possible to supply a list of domains and/or IP addresses to be
170     lookup up in a DNS blacklist. Previously, only a single domain name could
171     be given, for example:
172
173       dnslists = black.list.tld/$sender_host_name
174
175     What follows the slash can now be a list. As with all lists, the default
176     separator is a colon. However, because this is a sublist within the list of
177     DNS blacklist domains, it is necessary either to double the separators like
178     this:
179
180       dnslists = black.list.tld/name.1::name.2
181
182     or to change the separator character, like this:
183
184       dnslists = black.list.tld/<;name.1;name.2
185
186     If an item in the list is an IP address, it is inverted before the DNS
187     blacklist domain is appended. If it is not an IP address, no inversion
188     occurs. Consider this condition:
189
190        dnslists = black.list.tls/<;192.168.1.2;a.domain
191
192     The DNS lookups that occur are for
193
194        2.1.168.192.black.list.tld  and  a.domain.black.list.tld
195
196     Once a DNS record has been found (that matches a specific IP return
197     address, if specified), no further lookups are done.
198
199
200 Version 4.43
201 ------------
202
203  1. There is a new Boolean global option called mua_wrapper, defaulting false.
204     This causes Exim to run an a restricted mode, in order to provide a very
205     specific service.
206
207     Background: On a personal computer, it is a common requirement for all
208     email to be sent to a smarthost. There are plenty of MUAs that can be
209     configured to operate that way, for all the popular operating systems.
210     However, there are MUAs for Unix-like systems that cannot be so configured:
211     they submit messages using the command line interface of
212     /usr/sbin/sendmail. In addition, utility programs such as cron submit
213     messages this way.
214
215     Requirement: The requirement is for something that can provide the
216     /usr/sbin/sendmail interface and deliver messages to a smarthost, but not
217     provide any queueing or retrying facilities. Furthermore, the delivery to
218     the smarthost should be synchronous, so that if it fails, the sending MUA
219     is immediately informed. In other words, we want something that in effect
220     converts a command-line MUA into a TCP/SMTP MUA.
221
222     Solutions: There are a number of applications (for example, ssmtp) that do
223     this job. However, people have found them to be lacking in various ways.
224     For instance, some sites want to allow aliasing and forwarding before
225     sending to the smarthost.
226
227     Using Exim: Exim already had the necessary infrastructure for doing this
228     job. Just a few tweaks were needed to make it behave as required, though it
229     is somewhat of an overkill to use a fully-featured MTA for this purpose.
230
231     Setting mua_wrapper=true causes Exim to run in a special mode where it
232     assumes that it is being used to "wrap" a command-line MUA in the manner
233     just described.
234
235     If you set mua_wrapper=true, you also need to provide a compatible router
236     and transport configuration. Typically there will be just one router and
237     one transport, sending everything to a smarthost.
238
239     When run in MUA wrapping mode, the behaviour of Exim changes in the
240     following ways:
241
242     (a) A daemon cannot be run, nor will Exim accept incoming messages from
243         inetd. In other words, the only way to submit messages is via the
244         command line.
245
246     (b) Each message is synchonously delivered as soon as it is received (-odi
247         is assumed). All queueing options (queue_only, queue_smtp_domains,
248         control=queue, control=freeze in an ACL etc.) are quietly ignored. The
249         Exim reception process does not finish until the delivery attempt is
250         complete. If the delivery was successful, a zero return code is given.
251
252     (c) Address redirection is permitted, but the final routing for all
253         addresses must be to the same remote transport, and to the same list of
254         hosts. Furthermore, the return_address must be the same for all
255         recipients, as must any added or deleted header lines. In other words,
256         it must be possible to deliver the message in a single SMTP
257         transaction, however many recipients there are.
258
259     (d) If the conditions in (c) are not met, or if routing any address results
260         in a failure or defer status, or if Exim is unable to deliver all the
261         recipients successfully to one of the hosts immediately, delivery of
262         the entire message fails.
263
264     (e) Because no queueing is allowed, all failures are treated as permanent;
265         there is no distinction between 4xx and 5xx SMTP response codes from
266         the smarthost. Furthermore, because only a single yes/no response can
267         be given to the caller, it is not possible to deliver to some
268         recipients and not others. If there is an error (temporary or
269         permanent) for any recipient, all are failed.
270
271     (f) If more than one host is listed, Exim will try another host after a
272         connection failure or a timeout, in the normal way. However, if this
273         kind of failure happens for all the hosts, the delivery fails.
274
275     (g) When delivery fails, an error message is written to the standard error
276         stream (as well as to Exim's log), and Exim exits to the caller with a
277         return code value 1. The message is expunged from Exim's spool files.
278         No bounce messages are ever generated.
279
280     (h) No retry data is maintained, and any retry rules are ignored.
281
282     (i) A number of Exim options are overridden: deliver_drop_privilege is
283         forced true, max_rcpt in the smtp transport is forced to "unlimited",
284         remote_max_parallel is forced to one, and fallback hosts are ignored.
285
286     The overall effect is that Exim makes a single synchronous attempt to
287     deliver the message, failing if there is any kind of problem. Because no
288     local deliveries are done and no daemon can be run, Exim does not need root
289     privilege. It should be possible to run it setuid=exim instead of
290     setuid=root. See section 48.3 in the 4.40 manual for a general discussion
291     about the advantages and disadvantages of running without root privilege.
292
293  2. There have been problems with DNS servers when SRV records are looked up.
294     Some mis-behaving servers return a DNS error or timeout when a non-existent
295     SRV record is sought. Similar problems have in the past been reported for
296     MX records. The global dns_again_means_nonexist option can help with this
297     problem, but it is heavy-handed because it is a global option. There are
298     now two new options for the dnslookup router. They are called
299     srv_fail_domains and mx_fail_domains. In each case, the value is a domain
300     list. If an attempt to look up an SRV or MX record results in a DNS failure
301     or "try again" response, and the domain matches the relevant list, Exim
302     behaves as if the DNS had responded "no such record". In the case of an SRV
303     lookup, this means that the router proceeds to look for MX records; in the
304     case of an MX lookup, it proceeds to look for A or AAAA records, unless the
305     domain matches mx_domains.
306
307  3. The following functions are now available in the local_scan() API:
308
309     (a) void header_remove(int occurrence, uschar *name)
310
311         This function removes header lines. If "occurrence" is zero or negative,
312         all occurrences of the header are removed. If occurrence is greater
313         than zero, that particular instance of the header is removed. If no
314         header(s) can be found that match the specification, the function does
315         nothing.
316
317     (b) BOOL header_testname(header_line *hdr, uschar *name, int length,
318                              BOOL notdel)
319
320         This function tests whether the given header has the given name. It
321         is not just a string comparison, because whitespace is permitted
322         between the name and the colon. If the "notdel" argument is TRUE, a
323         FALSE return is forced for all "deleted" headers; otherwise they are
324         not treated specially. For example:
325
326            if (header_testname(h, US"X-Spam", 6, TRUE)) ...
327
328     (c) void header_add_at_position(BOOL after, uschar *name, BOOL topnot,
329                                     int type, char *format, ...)
330
331         This function adds a new header line at a specified point in the header
332         chain. If "name" is NULL, the new header is added at the end of the
333         chain if "after" is TRUE, or at the start if "after" is FALSE. If
334         "name" is not NULL, the headers are searched for the first non-deleted
335         header that matches the name. If one is found, the new header is added
336         before it if "after" is FALSE. If "after" is true, the new header is
337         added after the found header and any adjacent subsequent ones with the
338         same name (even if marked "deleted"). If no matching non-deleted header
339         is found, the "topnot" option controls where the header is added. If it
340         is TRUE, addition is at the top; otherwise at the bottom. Thus, to add
341         a header after all the Received: headers, or at the top if there are no
342         Received: headers, you could use
343
344           header_add_at_position(TRUE, US"Received", TRUE, ' ', "X-xxx: ...");
345
346         Normally, there is always at least one non-deleted Received: header,
347         but there may not be if received_header_text expands to an empty
348         string.
349
350     (d) BOOL receive_remove_recipient(uschar *recipient)
351
352         This is a convenience function to remove a named recipient from the
353         list of recipients. It returns TRUE if a recipient was removed, and
354         FALSE if no matching recipient could be found. The argument must be a
355         complete email address.
356
357  4. When an ACL "warn" statement adds one or more header lines to a message,
358     they are added at the end of the existing header lines by default. It is
359     now possible to specify that any particular header line should be added
360     right at the start (before all the Received: lines) or immediately after
361     the first block of Received: lines in the message. This is done by
362     specifying :at_start: or :after_received: (or, for completeness, :at_end:)
363     before the text of the header line. (Header text cannot start with a colon,
364     as there has to be a header name first.) For example:
365
366       warn message = :after_received:X-My-Header: something or other...
367
368     If more than one header is supplied in a single warn statement, each one is
369     treated independently and can therefore be placed differently. If you add
370     more than one line at the start, or after the Received: block, they will
371     end up in reverse order.
372
373     Warning: This facility currently applies only to header lines that are
374     added in an ACL. It does NOT work for header lines that are added in a
375     system filter or in a router or transport.
376
377  5. There is now a new error code that can be used in retry rules. Its name is
378     "rcpt_4xx", and there are three forms. A literal "rcpt_4xx" matches any 4xx
379     error received for an outgoing SMTP RCPT command; alternatively, either the
380     first or both of the x's can be given as digits, for example: "rcpt_45x" or
381     "rcpt_436". If you want (say) to recognize 452 errors given to RCPT
382     commands by a particular host, and have only a one-hour retry for them, you
383     can set up a retry rule of this form:
384
385       the.host.name  rcpt_452   F,1h,10m
386
387     Naturally, this rule must come before any others that would match.
388
389     These new errors apply to both outgoing SMTP (the smtp transport) and
390     outgoing LMTP (either the lmtp transport, or the smtp transport in LMTP
391     mode). Note, however, that they apply only to responses to RCPT commands.
392
393  6. The "postmaster" option of the callout feature of address verification has
394     been extended to make it possible to use a non-empty MAIL FROM address when
395     checking a postmaster address. The new suboption is called "postmaster_
396     mailfrom", and you use it like this:
397
398       require  verify = sender/callout=postmaster_mailfrom=abc@x.y.z
399
400     Providing this suboption causes the postmaster check to be done using the
401     given address. The original "postmaster" option is equivalent to
402
403       require  verify = sender/callout=postmaster_mailfrom=
404
405     If both suboptions are present, the rightmost one overrides.
406
407     Important notes:
408
409     (1) If you use a non-empty sender address for postmaster checking, there is
410         the likelihood that the remote host will itself initiate a callout
411         check back to your host to check that address. As this is a "normal"
412         callout check, the sender will most probably be empty, thus avoiding
413         possible callout loops. However, to be on the safe side it would be
414         best to set up your own ACLs so that they do not do sender verification
415         checks when the recipient is the address you use for postmaster callout
416         checking.
417
418     (2) The caching arrangements for postmaster checking do NOT take account of
419         the sender address. It is assumed that either the empty address, or a
420         fixed non-empty address will be used. All that Exim remembers is that
421         the postmaster check for the domain succeeded or failed.
422
423  7. When verifying addresses in header lines using the verify=header_sender
424     option, Exim behaves by default as if the addresses are envelope sender
425     addresses from a message. Callout verification therefore tests to see
426     whether a bounce message could be delivered, by using an empty address in
427     the MAIL FROM command. However, it is arguable that these addresses might
428     never be used as envelope senders, and could therefore justifiably reject
429     bounce messages (empty senders). There is now an additional callout option
430     for verify=header_sender that allows you to specify what address to use in
431     the MAIL FROM command. You use it as in this example:
432
433       require  verify = header_sender/callout=mailfrom=abcd@x.y.z
434
435     Important notes:
436
437     (1) As in the case of postmaster_mailfrom (see above), you should think
438         about possible loops.
439
440     (2) In this case, as in the case of recipient callouts with non-empty
441         senders (the use_sender option), caching is done on the basis of a
442         recipient/sender pair.
443
444  8. If you build Exim with USE_READLINE=yes in Local/Makefile, it will try to
445     load libreadline dynamically whenever the -be (test expansion) option is
446     used without command line arguments. If successful, it will then use
447     readline() for reading the test data. A line history is supported. By the
448     time Exim does this, it is running as the calling user, so this should not
449     cause any security problems. Security is the reason why this is NOT
450     supported for -bt or -bv, when Exim is running as root or exim,
451     respectively. Note that this option adds to the size of the Exim binary,
452     because the dynamic loading library is not otherwise included. On my
453     desktop it adds about 2.5K. You may need to add -ldl to EXTRA_LIBS when you
454     set USE_READLINE=yes.
455
456  9. Added ${str2b64:<string>} to the expansion operators. This operator
457     converts an arbitrary string into one that is base64 encoded.
458
459 10. A new authenticator, called cyrus_sasl, has been added. This requires
460     the presence of the Cyrus SASL library; it authenticates by calling this
461     library, which supports a number of authentication mechanisms, including
462     PLAIN and LOGIN, but also several others that Exim does not support
463     directly. The code for this authenticator was provided by Matthew
464     Byng-Maddick of A L Digital Ltd (http://www.aldigital.co.uk). Here follows
465     draft documentation:
466
467                     xx. THE CYRUS_SASL AUTHENTICATOR
468
469     The cyrus_sasl authenticator provides server support for the Cyrus library
470     Implementation of the RFC 2222 "Simple Authentication and Security Layer".
471     It provides a gatewaying mechanism directly to the Cyrus interface, so if
472     your Cyrus library can do, for example, CRAM-MD5, then so can the
473     cyrus_sasl authenticator. By default it uses the public name of the driver
474     to determine which mechanism to support.
475
476     Where access to some kind of secret file is required, for example in GSSAPI
477     or CRAM-MD5, it is worth noting that the authenticator runs as the exim
478     user, and that the Cyrus SASL library has no way of escalating privileges
479     by default. You may also find you need to set environment variables,
480     depending on the driver you are using.
481
482     xx.1 Using cyrus_sasl as a server
483
484     The cyrus_sasl authenticator has four private options. It puts the username
485     (on a successful authentication) into $1.
486
487     server_hostname         Type: string*         Default: $primary_hostname
488
489         This option selects the hostname that is used when communicating with
490         the library. It is up to the underlying SASL plug-in what it does with
491         this data.
492
493     server_mech             Type: string                Default: public_name
494
495         This option selects the authentication mechanism this driver should
496         use. It allows you to use a different underlying mechanism from the
497         advertised name. For example:
498
499         sasl:
500           driver = cyrus_sasl
501           public_name = X-ANYTHING
502           server_mech = CRAM-MD5
503           server_set_id = $1
504
505     server_realm            Type: string                      Default: unset
506
507        This is the SASL realm that the server is claiming to be in.
508
509     server_service          Type: string                      Default: "smtp"
510
511        This is the SASL service that the server claims to implement.
512
513     For straigthforward cases, you do not need to set any of the
514     authenticator's private options. All you need to do is to specify an
515     appropriate mechanism as the public name. Thus, if you have a SASL library
516     that supports CRAM-MD5 and PLAIN, you might have two authenticators as
517     follows:
518
519       sasl_cram_md5:
520         driver = cyrus_sasl
521         public_name = CRAM-MD5
522         server_set_id = $1
523
524       sasl_plain:
525         driver = cyrus_sasl
526         public_name = PLAIN
527         server_set_id = $1
528
529 11. There is a new global option called tls_on_connect_ports. Its value must be
530     a list of port numbers; the most common use is expected to be
531
532       tls_on_connect_ports = 465
533
534     Setting this option has the same effect as -tls-on-connect on the command
535     line, but only for the specified ports. It applies to all connections, both
536     via the daemon and via inetd. You still need to specify all the ports for
537     the daemon (using daemon_smtp_ports or local_interfaces or the -X command
538     line option) because this option does not add an extra port -- rather, it
539     specifies different behaviour on a port that is defined elsewhere. The
540     -tls-on-connect command line option overrides tls_on_connect_ports, and
541     forces tls-on-connect for all ports.
542
543 12. There is a new ACL that is run when a DATA command is received, before the
544     data itself is received. The ACL is defined by acl_smtp_predata. (Compare
545     acl_smtp_data, which is run after the data has been received.)
546     This new ACL allows a negative response to be given to the DATA command
547     itself. Header lines added by MAIL or RCPT ACLs are not visible at this
548     time, but any that are defined here are visible when the acl_smtp_data ACL
549     is run.
550
551 13. The "control=submission" ACL modifier has an option "/domain=xxx" which
552     specifies the domain to be used when creating From: or Sender: lines using
553     the authenticated id as a local part. If the option is supplied with an
554     empty domain, that is, just "/domain=", Exim assumes that the authenticated
555     id is a complete email address, and it uses it as is when creating From:
556     or Sender: lines.
557
558 14. It is now possible to make retry rules that apply only when the failing
559     message has a specific sender. In particular, this can be used to define
560     retry rules that apply only to bounce messages. The syntax is to add a new
561     third item to a retry rule, of the form "senders=<address list>". The retry
562     timings themselves then become the fourth item. For example:
563
564       *   *   senders=:   F,1h,30m
565
566     would match all bounce messages. If the address list contains white space,
567     it must be enclosed in quotes. For example:
568
569       a.domain  timeout  senders="x@b.dom : y@c.dom"  G,8h,10m,1.5
570
571     When testing retry rules using -brt, you can supply a sender using the -f
572     command line option, like this:
573
574       exim -f "" -brt user@dom.ain
575
576     If you do not set -f with -brt, a retry rule that contains a senders list
577     will never be matched.
578
579 15. Two new control modifiers have been added to ACLs: "control = enforce_sync"
580     and "control = no_enforce_sync". This makes it possible to be selective
581     about when SMTP synchronization is enforced. The global option
582     smtp_enforce_sync now specifies the default state of the switch. These
583     controls can appear in any ACL, but the most obvious place to put them is
584     in the ACL defined by acl_smtp_connect, which is run at the start of an
585     incoming SMTP connection, before the first synchronization check.
586
587 16. Another two new control modifiers are "control = caseful_local_part" and
588     "control = caselower_local_part". These are permitted only in the ACL
589     specified by acl_smtp_rcpt (i.e. during RCPT processing). By default, the
590     contents of $local_part are lower cased before ACL processing.
591     After "control = caseful_local_part", any uppercase letters in the original
592     local part are restored in $local_part for the rest of the ACL, or until
593     "control = caselower_local_part" is encountered. However, this applies only
594     to local part handling that takes place directly in the ACL (for example,
595     as a key in lookups). If a "verify = recipient" test is obeyed, the
596     case-related handling of the local part during the verification is
597     controlled by the router configuration (see the caseful_local_part generic
598     router option).
599
600     This facility could be used, for example, to add a spam score to local
601     parts containing upper case letters. For example, using $acl_m4 to
602     accumulate the spam score:
603
604       warn  control = caseful_local_part
605             set acl_m4 = ${eval:\
606                            $acl_m4 + \
607                            ${if match{$local_part}{[A-Z]}{1}{0}}\
608                           }
609             control = caselower_local_part
610
611     Notice that we put back the lower cased version afterwards, assuming that
612     is what is wanted for subsequent tests.
613
614 17. The option hosts_connection_nolog is provided so that certain hosts can be
615     excepted from logging when the +smtp_connection log selector is set. For
616     example, you might want not to log SMTP connections from local processes,
617     or from 127.0.0.1, or from your local LAN. The option is a host list with
618     an unset default. Because it is consulted in the main loop of the daemon,
619     you should strive to restrict its value to a short inline list of IP
620     addresses and networks. To disable logging SMTP connections from local
621     processes, you must create a host list with an empty item. For example:
622
623       hosts_connection_nolog = :
624
625     If the +smtp_connection log selector is not set, this option has no effect.
626
627 18. There is now an acl called acl_smtp_quit, which is run for the QUIT
628     command. The outcome of the ACL does not affect the response code to QUIT,
629     which is always 221. Thus, the ACL does not in fact control any access.
630     For this reason, the only verbs that are permitted are "accept" and "warn".
631
632     The ACL can be used for tasks such as custom logging at the end of an SMTP
633     session. For example, you can use ACL variables in other ACLs to count
634     messages, recipients, etc., and log the totals at QUIT time using one or
635     more "logwrite" modifiers on a "warn" command.
636
637     You do not need to have a final "accept", but if you do, you can use a
638     "message" modifier to specify custom text that is sent as part of the 221
639     response.
640
641     This ACL is run only for a "normal" QUIT. For certain kinds of disastrous
642     failure (for example, failure to open a log file, or when Exim is bombing
643     out because it has detected an unrecoverable error), all SMTP commands
644     from the client are given temporary error responses until QUIT is received
645     or the connection is closed. In these special cases, the ACL is not run.
646
647 19. The appendfile transport has two new options, mailbox_size and mailbox_
648     filecount. If either these options are set, it is expanded, and the result
649     is taken as the current size of the mailbox or the number of files in the
650     mailbox, respectively. This makes it possible to use some external means of
651     maintaining the data about the size of a mailbox for enforcing quota
652     limits. The result of expanding these option values must be a decimal
653     number, optionally followed by "K" or "M".
654
655 20. It seems that there are broken clients in use that cannot handle multiline
656     SMTP responses. Can't people who implement these braindead programs read?
657     RFC 821 mentions multiline responses, and it is over 20 years old. They
658     must handle multiline responses for EHLO, or do they still use HELO?
659     Anyway, here is YAWFAB (yet another workaround for asinine brokenness).
660     There's a new ACL switch that can be set by
661
662       control = no_multiline_responses
663
664     If this is set, it suppresses multiline SMTP responses from ACL rejections.
665     One way of doing this would have been just to put out these responses as
666     one long line. However, RFC 2821 specifies a maximum of 512 bytes per
667     response ("use multiline responses for more" it says), and some of the
668     responses might get close to that. So I have implemented this by doing two
669     very easy things:
670
671       (1) Extra information that is normally output as part of a rejection
672           caused by sender verification failure is omitted. Only the final line
673           (typically "sender verification failed") is now sent.
674
675       (2) If a "message" modifier supplies a multiline response, only the first
676           line is output.
677
678     The setting of the switch can, of course, be made conditional on the
679     calling host.
680
681 21. There is now support for the libradius library that comes with FreeBSD.
682     This is an alternative to the radiusclient library that Exim already
683     supports. To use the FreeBSD library, you need to set
684
685       RADIUS_LIB_TYPE=RADLIB
686
687     in Local/Makefile, in addition to RADIUS_CONFIGURE_FILE, and you probably
688     also need -libradius in EXTRALIBS.
689
690
691 Version 4.42
692 ------------
693
694  1. The "personal" filter test is brought up-to-date with recommendations from
695     the Sieve specification: (a) The list of non-personal From: addresses now
696     includes "listserv", "majordomo", and "*-request"; (b) If the message
697     contains any header line starting with "List=-" it is treated as
698     non-personal.
699
700  2. The Sieve functionality has been extended to support the "copy" and
701     "vacation" extensions, and comparison tests.
702
703  3. There is now an overall timeout for performing a callout verification. It
704     defaults to 4 times the callout timeout, which applies to individual SMTP
705     commands during the callout. The overall timeout applies when there is more
706     than one host that can be tried. The timeout is checked before trying the
707     next host. This prevents very long delays if there are a large number of
708     hosts and all are timing out (e.g. when the network connections are timing
709     out). The value of the overall timeout can be changed by specifying an
710     additional sub-option for "callout", called "maxwait". For example:
711
712       verify = sender/callout=5s,maxwait=20s
713
714  4. Changes to the "personal" filter test:
715
716     (1) The list of non-personal local parts in From: addresses has been
717     extended to include "listserv", "majordomo", "*-request", and "owner-*",
718     taken from the Sieve specification recommendations.
719
720     (2) If the message contains any header line starting with "List-" it is
721     treated as non-personal.
722
723     (3) The test for "circular" in the Subject: header line has been removed
724     because it now seems ill-conceived.
725
726  5. The autoreply transport has a new option called never_mail. This is an
727     address list. If any run of the transport creates a message with a
728     recipient that matches any item in the list, that recipient is quietly
729     discarded. If all recipients are discarded, no message is created.
730
731
732 Version 4.40
733 ------------
734
735 The documentation is up-to-date for the 4.40 release. What follows here is a
736 brief list of the new features that have been added since 4.30.
737
738  1. log_incoming_interface affects more log lines.
739
740  2. New ACL modifier "control = submission".
741
742  3. CONFIGURE_OWNER can be set at build time to define an alternative owner for
743     the configuration file, in addition to root and exim.
744
745  4. Added expansion variables $body_zerocount, $recipient_data, and
746     $sender_data.
747
748  5. The time of last modification of the "new" subdirectory is now used as the
749     "mailbox time last read" when there is a quota error for a maildir
750     delivery.
751
752  6. The special item "+ignore_unknown" may now appear in host lists.
753
754  7. The special domain-matching patterns @mx_any, @mx_primary, and
755     @mx_secondary can now be followed by "/ignore=<ip list>".
756
757  8. New expansion conditions: match_domain, match_address, match_local_part,
758     lt, lti, le, lei, gt, gti, ge, and new expansion operators time_interval,
759     eval10, and base62d.
760
761  9. New lookup type called "iplsearch".
762
763 10. New log selectors ident_timeout, tls_certificate_verified, queue_time,
764     deliver_time, outgoing_port, return_path_on_delivery.
765
766 11. New global options smtp_active_hostname and tls_require_ciphers.
767
768 12. Exinext has -C and -D options.
769
770 13. "domainlist_cache" forces caching of an apparently variable list.
771
772 14. For compatibility with Sendmail, the command line option -prval:sval
773     is equivalent to -oMr rval -oMs sval.
774
775 15. New callout options use_sender and use_postmaster for use when verifying
776     recipients.
777
778 16. John Jetmore's "exipick" utility has been added to the distribution.
779
780 17. The TLS code now supports CRLs.
781
782 18. The dnslookup router and the dnsdb lookup type now support the use of SRV
783     records.
784
785 19. The redirect router has a new option called qualify_domain.
786
787 20. exigrep's output now also includes lines that are not related to any
788     particular message, but which do match the pattern.
789
790 21. New global option write_rejectlog. If it is set false, Exim no longer
791     writes anything to the reject log.
792
793 ****