Added $dnslist_matched.
[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 ****