Add client_condition to authenticators.
[users/jgh/exim.git] / doc / doc-txt / NewStuff
1 $Cambridge: exim/doc/doc-txt/NewStuff,v 1.149 2007/06/18 13:57:49 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 Before a formal release, there may be quite a lot of detail so that people can
8 test from the snapshots or the CVS before the documentation is updated. Once
9 the documentation is updated, this file is reduced to a short list.
10
11 Version 4.68
12 ------------
13
14  1. The body_linecount and body_zerocount C variables are now exported in the
15     local_scan API.
16
17  2. When a dnslists lookup succeeds, the key that was looked up is now placed
18     in $dnslist_matched. When the key is an IP address, it is not reversed in
19     this variable (though it is, of course, in the actual lookup). In simple
20     cases, for example:
21
22       deny dnslists = spamhaus.example
23
24     the key is also available in another variable (in this case,
25     $sender_host_address). In more complicated cases, however, this is not
26     true. For example, using a data lookup might generate a dnslists lookup
27     like this:
28
29       deny dnslists = spamhaus.example/<|192.168.1.2|192.168.6.7|...
30
31     If this condition succeeds, the value in $dnslist_matched might be
32     192.168.6.7 (for example).
33
34  3. Authenticators now have a client_condition option. When Exim is running as
35     a client, it skips an authenticator whose client_condition expansion yields
36     "0", "no", or "false". This can be used, for example, to skip plain text
37     authenticators when the connection is not encrypted by a setting such as:
38
39       client_condition = ${if !eq{$tls_cipher}{}}
40
41     Note that the 4.67 documentation states that $tls_cipher contains the
42     cipher used for incoming messages. In fact, during SMTP delivery, it
43     contains the cipher used for the delivery. The same is true for
44     $tls_peerdn.
45
46
47 Version 4.67
48 ------------
49
50  1. There is a new log selector called smtp_no_mail, which is not included in
51     the default setting. When it is set, a line is written to the main log
52     whenever an accepted SMTP connection terminates without having issued a
53     MAIL command.
54
55  2. When an item in a dnslists list is followed by = and & and a list of IP
56     addresses, the behaviour was not clear when the lookup returned more than
57     one IP address. This has been solved by the addition of == and =& for "all"
58     rather than the default "any" matching.
59
60  3. Up till now, the only control over which cipher suites GnuTLS uses has been
61     for the cipher algorithms. New options have been added to allow some of the
62     other parameters to be varied.
63
64  4. There is a new compile-time option called ENABLE_DISABLE_FSYNC. When it is
65     set, Exim compiles a runtime option called disable_fsync.
66
67  5. There is a new variable called $smtp_count_at_connection_start.
68
69  6. There's a new control called no_pipelining.
70
71  7. There are two new variables called $sending_ip_address and $sending_port.
72     These are set whenever an SMTP connection to another host has been set up.
73
74  8. The expansion of the helo_data option in the smtp transport now happens
75     after the connection to the server has been made.
76
77  9. There is a new expansion operator ${rfc2047d: that decodes strings that
78     are encoded as per RFC 2047.
79
80 10. There is a new log selector called "pid", which causes the current process
81     id to be added to every log line, in square brackets, immediately after the
82     time and date.
83
84 11. Exim has been modified so that it flushes SMTP output before implementing
85     a delay in an ACL. It also flushes the output before performing a callout,
86     as this can take a substantial time. These behaviours can be disabled by
87     obeying control = no_delay_flush or control = no_callout_flush,
88     respectively, at some earlier stage of the connection.
89
90 12. There are two new expansion conditions that iterate over a list. They are
91     called forany and forall.
92
93 13. There's a new global option called dsn_from that can be used to vary the
94     contents of From: lines in bounces and other automatically generated
95     messages ("delivery status notifications" - hence the name of the option).
96
97 14. The smtp transport has a new option called hosts_avoid_pipelining.
98
99 15. By default, exigrep does case-insensitive matches. There is now a -I option
100     that makes it case-sensitive.
101
102 16. A number of new features ("addresses", "map", "filter", and "reduce") have
103     been added to string expansions to make it easier to process lists of
104     items, typically addresses.
105
106 17. There's a new ACL modifier called "continue". It does nothing of itself,
107     and processing of the ACL always continues with the next condition or
108     modifier. It is provided so that the side effects of expanding its argument
109     can be used.
110
111 18. It is now possible to use newline and other control characters (those with
112     values less than 32, plus DEL) as separators in lists.
113
114 19. The exigrep utility now has a -v option, which inverts the matching
115     condition.
116
117 20. The host_find_failed option in the manualroute router can now be set to
118     "ignore".
119
120
121 Version 4.66
122 ------------
123
124 No new features were added to 4.66.
125
126
127 Version 4.65
128 ------------
129
130 No new features were added to 4.65.
131
132
133 Version 4.64
134 ------------
135
136  1. ACL variables can now be given arbitrary names, as long as they start with
137     "acl_c" or "acl_m" (for connection variables and message variables), are at
138     least six characters long, with the sixth character being either a digit or
139     an underscore.
140
141  2. There is a new ACL modifier called log_reject_target. It makes it possible
142     to specify which logs are used for messages about ACL rejections.
143
144  3. There is a new authenticator called "dovecot". This is an interface to the
145     authentication facility of the Dovecot POP/IMAP server, which can support a
146     number of authentication methods.
147
148  4. The variable $message_headers_raw provides a concatenation of all the
149     messages's headers without any decoding. This is in contrast to
150     $message_headers, which does RFC2047 decoding on the header contents.
151
152  5. In a DNS black list, if two domain names, comma-separated, are given, the
153     second is used first to do an initial check, making use of any IP value
154     restrictions that are set. If there is a match, the first domain is used,
155     without any IP value restrictions, to get the TXT record.
156
157  6. All authenticators now have a server_condition option.
158
159  7. There is a new command-line option called -Mset. It is useful only in
160     conjunction with -be (that is, when testing string expansions). It must be
161     followed by a message id; Exim loads the given message from its spool
162     before doing the expansions.
163
164  8. Another similar new command-line option is called -bem. It operates like
165     -be except that it must be followed by the name of a file that contains a
166     message.
167
168  9. When an address is delayed because of a 4xx response to a RCPT command, it
169     is now the combination of sender and recipient that is delayed in
170     subsequent queue runs until its retry time is reached.
171
172 10. Unary negation and the bitwise logical operators and, or, xor, not, and
173     shift, have been added to the eval: and eval10: expansion items.
174
175 11. The variables $interface_address and $interface_port have been renamed
176     as $received_ip_address and $received_port, to make it clear that they
177     relate to message reception rather than delivery. (The old names remain
178     available for compatibility.)
179
180 12. The "message" modifier can now be used on "accept" and "discard" acl verbs
181     to vary the message that is sent when an SMTP command is accepted.
182
183
184 Version 4.63
185 ------------
186
187 1. There is a new Boolean option called filter_prepend_home for the redirect
188    router.
189
190 2. There is a new acl, set by acl_not_smtp_start, which is run right at the
191    start of receiving a non-SMTP message, before any of the message has been
192    read.
193
194 3. When an SMTP error message is specified in a "message" modifier in an ACL,
195    or in a :fail: or :defer: message in a redirect router, Exim now checks the
196    start of the message for an SMTP error code.
197
198 4. There is a new parameter for LDAP lookups called "referrals", which takes
199    one of the settings "follow" (the default) or "nofollow".
200
201 5. Version 20070721.2 of exipick now included, offering these new options:
202     --reverse
203         After all other sorting options have bee processed, reverse order
204         before displaying messages (-R is synonym).
205     --random
206         Randomize order of matching messages before displaying.
207     --size
208         Instead of displaying the matching messages, display the sum
209         of their sizes.
210     --sort <variable>[,<variable>...]
211         Before displaying matching messages, sort the messages according to
212         each messages value for each variable.
213     --not
214         Negate the value for every test (returns inverse output from the
215         same criteria without --not).
216
217
218 Version 4.62
219 ------------
220
221 1. The ${readsocket expansion item now supports Internet domain sockets as well
222    as Unix domain sockets. If the first argument begins "inet:", it must be of
223    the form "inet:host:port". The port is mandatory; it may be a number or the
224    name of a TCP port in /etc/services. The host may be a name, or it may be an
225    IP address. An ip address may optionally be enclosed in square brackets.
226    This is best for IPv6 addresses. For example:
227
228      ${readsocket{inet:[::1]:1234}{<request data>}...
229
230    Only a single host name may be given, but if looking it up yield more than
231    one IP address, they are each tried in turn until a connection is made. Once
232    a connection has been made, the behaviour is as for ${readsocket with a Unix
233    domain socket.
234
235 2. If a redirect router sets up file or pipe deliveries for more than one
236    incoming address, and the relevant transport has batch_max set greater than
237    one, a batch delivery now occurs.
238
239 3. The appendfile transport has a new option called maildirfolder_create_regex.
240    Its value is a regular expression. For a maildir delivery, this is matched
241    against the maildir directory; if it matches, Exim ensures that a
242    maildirfolder file is created alongside the new, cur, and tmp directories.
243
244
245 Version 4.61
246 ------------
247
248 The documentation is up-to-date for the 4.61 release. Major new features since
249 the 4.60 release are:
250
251 . An option called disable_ipv6, to disable the use of IPv6 completely.
252
253 . An increase in the number of ACL variables to 20 of each type.
254
255 . A change to use $auth1, $auth2, and $auth3 in authenticators instead of $1,
256   $2, $3, (though those are still set) because the numeric variables get used
257   for other things in complicated expansions.
258
259 . The default for rfc1413_query_timeout has been changed from 30s to 5s.
260
261 . It is possible to use setclassresources() on some BSD OS to control the
262   resources used in pipe deliveries.
263
264 . A new ACL modifier called add_header, which can be used with any verb.
265
266 . More errors are detectable in retry rules.
267
268 There are a number of other additions too.
269
270
271 Version 4.60
272 ------------
273
274 The documentation is up-to-date for the 4.60 release. Major new features since
275 the 4.50 release are:
276
277 . Support for SQLite.
278
279 . Support for IGNOREQUOTA in LMTP.
280
281 . Extensions to the "submission mode" features.
282
283 . Support for Client SMTP Authorization (CSA).
284
285 . Support for ratelimiting hosts and users.
286
287 . New expansion items to help with the BATV "prvs" scheme.
288
289 . A "match_ip" condition, that matches an IP address against a list.
290
291 There are many more minor changes.
292
293 ****