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