e8354ad7a449b1f88c6f1a945fcccf3abcced536
[exim.git] / src / src / transports / smtp.c
1 /* $Cambridge: exim/src/src/transports/smtp.c,v 1.40 2008/09/05 16:59:48 fanf2 Exp $ */
2
3 /*************************************************
4 *     Exim - an Internet mail transport agent    *
5 *************************************************/
6
7 /* Copyright (c) University of Cambridge 1995 - 2007 */
8 /* See the file NOTICE for conditions of use and distribution. */
9
10 #include "../exim.h"
11 #include "smtp.h"
12
13 #define PENDING          256
14 #define PENDING_DEFER   (PENDING + DEFER)
15 #define PENDING_OK      (PENDING + OK)
16
17
18 /* Options specific to the smtp transport. This transport also supports LMTP
19 over TCP/IP. The options must be in alphabetic order (note that "_" comes
20 before the lower case letters). Some live in the transport_instance block so as
21 to be publicly visible; these are flagged with opt_public. */
22
23 optionlist smtp_transport_options[] = {
24   { "address_retry_include_sender", opt_bool,
25       (void *)offsetof(smtp_transport_options_block, address_retry_include_sender) },
26   { "allow_localhost",      opt_bool,
27       (void *)offsetof(smtp_transport_options_block, allow_localhost) },
28   { "authenticated_sender", opt_stringptr,
29       (void *)offsetof(smtp_transport_options_block, authenticated_sender) },
30   { "authenticated_sender_force", opt_bool,
31       (void *)offsetof(smtp_transport_options_block, authenticated_sender_force) },
32   { "command_timeout",      opt_time,
33       (void *)offsetof(smtp_transport_options_block, command_timeout) },
34   { "connect_timeout",      opt_time,
35       (void *)offsetof(smtp_transport_options_block, connect_timeout) },
36   { "connection_max_messages", opt_int | opt_public,
37       (void *)offsetof(transport_instance, connection_max_messages) },
38   { "data_timeout",         opt_time,
39       (void *)offsetof(smtp_transport_options_block, data_timeout) },
40   { "delay_after_cutoff", opt_bool,
41       (void *)offsetof(smtp_transport_options_block, delay_after_cutoff) },
42   #if (defined EXPERIMENTAL_DOMAINKEYS) || (defined EXPERIMENTAL_DKIM)
43   { "dk_canon", opt_stringptr,
44       (void *)offsetof(smtp_transport_options_block, dk_canon) },
45   { "dk_domain", opt_stringptr,
46       (void *)offsetof(smtp_transport_options_block, dk_domain) },
47   { "dk_headers", opt_stringptr,
48       (void *)offsetof(smtp_transport_options_block, dk_headers) },
49   { "dk_private_key", opt_stringptr,
50       (void *)offsetof(smtp_transport_options_block, dk_private_key) },
51   { "dk_selector", opt_stringptr,
52       (void *)offsetof(smtp_transport_options_block, dk_selector) },
53   { "dk_strict", opt_stringptr,
54       (void *)offsetof(smtp_transport_options_block, dk_strict) },
55   { "dkim_canon", opt_stringptr,
56       (void *)offsetof(smtp_transport_options_block, dkim_canon) },
57   { "dkim_domain", opt_stringptr,
58       (void *)offsetof(smtp_transport_options_block, dkim_domain) },
59   { "dkim_private_key", opt_stringptr,
60       (void *)offsetof(smtp_transport_options_block, dkim_private_key) },
61   { "dkim_selector", opt_stringptr,
62       (void *)offsetof(smtp_transport_options_block, dkim_selector) },
63   { "dkim_sign_headers", opt_stringptr,
64       (void *)offsetof(smtp_transport_options_block, dkim_sign_headers) },
65   { "dkim_strict", opt_stringptr,
66       (void *)offsetof(smtp_transport_options_block, dkim_strict) },
67   #endif
68   { "dns_qualify_single",   opt_bool,
69       (void *)offsetof(smtp_transport_options_block, dns_qualify_single) },
70   { "dns_search_parents",   opt_bool,
71       (void *)offsetof(smtp_transport_options_block, dns_search_parents) },
72   { "fallback_hosts",       opt_stringptr,
73       (void *)offsetof(smtp_transport_options_block, fallback_hosts) },
74   { "final_timeout",        opt_time,
75       (void *)offsetof(smtp_transport_options_block, final_timeout) },
76   { "gethostbyname",        opt_bool,
77       (void *)offsetof(smtp_transport_options_block, gethostbyname) },
78   #ifdef SUPPORT_TLS
79   { "gnutls_require_kx",    opt_stringptr,
80       (void *)offsetof(smtp_transport_options_block, gnutls_require_kx) },
81   { "gnutls_require_mac",   opt_stringptr,
82       (void *)offsetof(smtp_transport_options_block, gnutls_require_mac) },
83   { "gnutls_require_protocols", opt_stringptr,
84       (void *)offsetof(smtp_transport_options_block, gnutls_require_proto) },
85   #endif
86   { "helo_data",            opt_stringptr,
87       (void *)offsetof(smtp_transport_options_block, helo_data) },
88   { "hosts",                opt_stringptr,
89       (void *)offsetof(smtp_transport_options_block, hosts) },
90   { "hosts_avoid_esmtp",    opt_stringptr,
91       (void *)offsetof(smtp_transport_options_block, hosts_avoid_esmtp) },
92   { "hosts_avoid_pipelining", opt_stringptr,
93       (void *)offsetof(smtp_transport_options_block, hosts_avoid_pipelining) },
94   #ifdef SUPPORT_TLS
95   { "hosts_avoid_tls",      opt_stringptr,
96       (void *)offsetof(smtp_transport_options_block, hosts_avoid_tls) },
97   #endif
98   { "hosts_max_try",        opt_int,
99       (void *)offsetof(smtp_transport_options_block, hosts_max_try) },
100   { "hosts_max_try_hardlimit", opt_int,
101       (void *)offsetof(smtp_transport_options_block, hosts_max_try_hardlimit) },
102   #ifdef SUPPORT_TLS
103   { "hosts_nopass_tls",     opt_stringptr,
104       (void *)offsetof(smtp_transport_options_block, hosts_nopass_tls) },
105   #endif
106   { "hosts_override",       opt_bool,
107       (void *)offsetof(smtp_transport_options_block, hosts_override) },
108   { "hosts_randomize",      opt_bool,
109       (void *)offsetof(smtp_transport_options_block, hosts_randomize) },
110   { "hosts_require_auth",   opt_stringptr,
111       (void *)offsetof(smtp_transport_options_block, hosts_require_auth) },
112   #ifdef SUPPORT_TLS
113   { "hosts_require_tls",    opt_stringptr,
114       (void *)offsetof(smtp_transport_options_block, hosts_require_tls) },
115   #endif
116   { "hosts_try_auth",       opt_stringptr,
117       (void *)offsetof(smtp_transport_options_block, hosts_try_auth) },
118   { "interface",            opt_stringptr,
119       (void *)offsetof(smtp_transport_options_block, interface) },
120   { "keepalive",            opt_bool,
121       (void *)offsetof(smtp_transport_options_block, keepalive) },
122   { "lmtp_ignore_quota",    opt_bool,
123       (void *)offsetof(smtp_transport_options_block, lmtp_ignore_quota) },
124   { "max_rcpt",             opt_int | opt_public,
125       (void *)offsetof(transport_instance, max_addresses) },
126   { "multi_domain",         opt_bool | opt_public,
127       (void *)offsetof(transport_instance, multi_domain) },
128   { "port",                 opt_stringptr,
129       (void *)offsetof(smtp_transport_options_block, port) },
130   { "protocol",             opt_stringptr,
131       (void *)offsetof(smtp_transport_options_block, protocol) },
132   { "retry_include_ip_address", opt_bool,
133       (void *)offsetof(smtp_transport_options_block, retry_include_ip_address) },
134   { "serialize_hosts",      opt_stringptr,
135       (void *)offsetof(smtp_transport_options_block, serialize_hosts) },
136   { "size_addition",        opt_int,
137       (void *)offsetof(smtp_transport_options_block, size_addition) }
138   #ifdef SUPPORT_TLS
139  ,{ "tls_certificate",      opt_stringptr,
140       (void *)offsetof(smtp_transport_options_block, tls_certificate) },
141   { "tls_crl",              opt_stringptr,
142       (void *)offsetof(smtp_transport_options_block, tls_crl) },
143   { "tls_privatekey",       opt_stringptr,
144       (void *)offsetof(smtp_transport_options_block, tls_privatekey) },
145   { "tls_require_ciphers",   opt_stringptr,
146       (void *)offsetof(smtp_transport_options_block, tls_require_ciphers) },
147   { "tls_tempfail_tryclear", opt_bool,
148       (void *)offsetof(smtp_transport_options_block, tls_tempfail_tryclear) },
149   { "tls_verify_certificates", opt_stringptr,
150       (void *)offsetof(smtp_transport_options_block, tls_verify_certificates) }
151   #endif
152 };
153
154 /* Size of the options list. An extern variable has to be used so that its
155 address can appear in the tables drtables.c. */
156
157 int smtp_transport_options_count =
158   sizeof(smtp_transport_options)/sizeof(optionlist);
159
160 /* Default private options block for the smtp transport. */
161
162 smtp_transport_options_block smtp_transport_option_defaults = {
163   NULL,                /* hosts */
164   NULL,                /* fallback_hosts */
165   NULL,                /* hostlist */
166   NULL,                /* fallback_hostlist */
167   NULL,                /* authenticated_sender */
168   US"$primary_hostname", /* helo_data */
169   NULL,                /* interface */
170   NULL,                /* port */
171   US"smtp",            /* protocol */
172   NULL,                /* serialize_hosts */
173   NULL,                /* hosts_try_auth */
174   NULL,                /* hosts_require_auth */
175   NULL,                /* hosts_require_tls */
176   NULL,                /* hosts_avoid_tls */
177   NULL,                /* hosts_avoid_pipelining */
178   NULL,                /* hosts_avoid_esmtp */
179   NULL,                /* hosts_nopass_tls */
180   5*60,                /* command_timeout */
181   5*60,                /* connect_timeout; shorter system default overrides */
182   5*60,                /* data timeout */
183   10*60,               /* final timeout */
184   1024,                /* size_addition */
185   5,                   /* hosts_max_try */
186   50,                  /* hosts_max_try_hardlimit */
187   TRUE,                /* address_retry_include_sender */
188   FALSE,               /* allow_localhost */
189   FALSE,               /* authenticated_sender_force */
190   FALSE,               /* gethostbyname */
191   TRUE,                /* dns_qualify_single */
192   FALSE,               /* dns_search_parents */
193   TRUE,                /* delay_after_cutoff */
194   FALSE,               /* hosts_override */
195   FALSE,               /* hosts_randomize */
196   TRUE,                /* keepalive */
197   FALSE,               /* lmtp_ignore_quota */
198   TRUE                 /* retry_include_ip_address */
199   #ifdef SUPPORT_TLS
200  ,NULL,                /* tls_certificate */
201   NULL,                /* tls_crl */
202   NULL,                /* tls_privatekey */
203   NULL,                /* tls_require_ciphers */
204   NULL,                /* gnutls_require_kx */
205   NULL,                /* gnutls_require_mac */
206   NULL,                /* gnutls_require_proto */
207   NULL,                /* tls_verify_certificates */
208   TRUE                 /* tls_tempfail_tryclear */
209   #endif
210   #if (defined EXPERIMENTAL_DOMAINKEYS) || (defined EXPERIMENTAL_DKIM)
211  ,NULL,                /* dk_canon */
212   NULL,                /* dk_domain */
213   NULL,                /* dk_headers */
214   NULL,                /* dk_private_key */
215   NULL,                /* dk_selector */
216   NULL                 /* dk_strict */
217  ,NULL,                /* dkim_canon */
218   NULL,                /* dkim_domain */
219   NULL,                /* dkim_private_key */
220   NULL,                /* dkim_selector */
221   NULL,                /* dkim_sign_headers */
222   NULL                 /* dkim_strict */
223   #endif
224 };
225
226
227 /* Local statics */
228
229 static uschar *smtp_command;   /* Points to last cmd for error messages */
230 static uschar *mail_command;   /* Points to MAIL cmd for error messages */
231 static BOOL    update_waiting; /* TRUE to update the "wait" database */
232
233
234 /*************************************************
235 *             Setup entry point                  *
236 *************************************************/
237
238 /* This function is called when the transport is about to be used,
239 but before running it in a sub-process. It is used for two things:
240
241   (1) To set the fallback host list in addresses, when delivering.
242   (2) To pass back the interface, port, protocol, and other options, for use
243       during callout verification.
244
245 Arguments:
246   tblock    pointer to the transport instance block
247   addrlist  list of addresses about to be transported
248   tf        if not NULL, pointer to block in which to return options
249   uid       the uid that will be set (not used)
250   gid       the gid that will be set (not used)
251   errmsg    place for error message (not used)
252
253 Returns:  OK always (FAIL, DEFER not used)
254 */
255
256 static int
257 smtp_transport_setup(transport_instance *tblock, address_item *addrlist,
258   transport_feedback *tf, uid_t uid, gid_t gid, uschar **errmsg)
259 {
260 smtp_transport_options_block *ob =
261   (smtp_transport_options_block *)(tblock->options_block);
262
263 errmsg = errmsg;    /* Keep picky compilers happy */
264 uid = uid;
265 gid = gid;
266
267 /* Pass back options if required. This interface is getting very messy. */
268
269 if (tf != NULL)
270   {
271   tf->interface = ob->interface;
272   tf->port = ob->port;
273   tf->protocol = ob->protocol;
274   tf->hosts = ob->hosts;
275   tf->hosts_override = ob->hosts_override;
276   tf->hosts_randomize = ob->hosts_randomize;
277   tf->gethostbyname = ob->gethostbyname;
278   tf->qualify_single = ob->dns_qualify_single;
279   tf->search_parents = ob->dns_search_parents;
280   tf->helo_data = ob->helo_data;
281   }
282
283 /* Set the fallback host list for all the addresses that don't have fallback
284 host lists, provided that the local host wasn't present in the original host
285 list. */
286
287 if (!testflag(addrlist, af_local_host_removed))
288   {
289   for (; addrlist != NULL; addrlist = addrlist->next)
290     if (addrlist->fallback_hosts == NULL)
291       addrlist->fallback_hosts = ob->fallback_hostlist;
292   }
293
294 return OK;
295 }
296
297
298
299 /*************************************************
300 *          Initialization entry point            *
301 *************************************************/
302
303 /* Called for each instance, after its options have been read, to
304 enable consistency checks to be done, or anything else that needs
305 to be set up.
306
307 Argument:   pointer to the transport instance block
308 Returns:    nothing
309 */
310
311 void
312 smtp_transport_init(transport_instance *tblock)
313 {
314 smtp_transport_options_block *ob =
315   (smtp_transport_options_block *)(tblock->options_block);
316
317 /* Retry_use_local_part defaults FALSE if unset */
318
319 if (tblock->retry_use_local_part == TRUE_UNSET)
320   tblock->retry_use_local_part = FALSE;
321
322 /* Set the default port according to the protocol */
323
324 if (ob->port == NULL)
325   ob->port = (strcmpic(ob->protocol, US"lmtp") == 0)? US"lmtp" : US"smtp";
326
327 /* Set up the setup entry point, to be called before subprocesses for this
328 transport. */
329
330 tblock->setup = smtp_transport_setup;
331
332 /* Complain if any of the timeouts are zero. */
333
334 if (ob->command_timeout <= 0 || ob->data_timeout <= 0 ||
335     ob->final_timeout <= 0)
336   log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
337     "command, data, or final timeout value is zero for %s transport",
338       tblock->name);
339
340 /* If hosts_override is set and there are local hosts, set the global
341 flag that stops verify from showing router hosts. */
342
343 if (ob->hosts_override && ob->hosts != NULL) tblock->overrides_hosts = TRUE;
344
345 /* If there are any fallback hosts listed, build a chain of host items
346 for them, but do not do any lookups at this time. */
347
348 host_build_hostlist(&(ob->fallback_hostlist), ob->fallback_hosts, FALSE);
349 }
350
351
352
353
354
355 /*************************************************
356 *   Set delivery info into all active addresses  *
357 *************************************************/
358
359 /* Only addresses whose status is >= PENDING are relevant. A lesser
360 status means that an address is not currently being processed.
361
362 Arguments:
363   addrlist       points to a chain of addresses
364   errno_value    to put in each address's errno field
365   msg            to put in each address's message field
366   rc             to put in each address's transport_return field
367   pass_message   if TRUE, set the "pass message" flag in the address
368
369 If errno_value has the special value ERRNO_CONNECTTIMEOUT, ETIMEDOUT is put in
370 the errno field, and RTEF_CTOUT is ORed into the more_errno field, to indicate
371 this particular type of timeout.
372
373 Returns:       nothing
374 */
375
376 static void
377 set_errno(address_item *addrlist, int errno_value, uschar *msg, int rc,
378   BOOL pass_message)
379 {
380 address_item *addr;
381 int orvalue = 0;
382 if (errno_value == ERRNO_CONNECTTIMEOUT)
383   {
384   errno_value = ETIMEDOUT;
385   orvalue = RTEF_CTOUT;
386   }
387 for (addr = addrlist; addr != NULL; addr = addr->next)
388   {
389   if (addr->transport_return < PENDING) continue;
390   addr->basic_errno = errno_value;
391   addr->more_errno |= orvalue;
392   if (msg != NULL)
393     {
394     addr->message = msg;
395     if (pass_message) setflag(addr, af_pass_message);
396     }
397   addr->transport_return = rc;
398   }
399 }
400
401
402
403 /*************************************************
404 *          Check an SMTP response                *
405 *************************************************/
406
407 /* This function is given an errno code and the SMTP response buffer
408 to analyse, together with the host identification for generating messages. It
409 sets an appropriate message and puts the first digit of the response code into
410 the yield variable. If no response was actually read, a suitable digit is
411 chosen.
412
413 Arguments:
414   host           the current host, to get its name for messages
415   errno_value    pointer to the errno value
416   more_errno     from the top address for use with ERRNO_FILTER_FAIL
417   buffer         the SMTP response buffer
418   yield          where to put a one-digit SMTP response code
419   message        where to put an errror message
420   pass_message   set TRUE if message is an SMTP response
421
422 Returns:         TRUE if an SMTP "QUIT" command should be sent, else FALSE
423 */
424
425 static BOOL check_response(host_item *host, int *errno_value, int more_errno,
426   uschar *buffer, int *yield, uschar **message, BOOL *pass_message)
427 {
428 uschar *pl = US"";
429
430 if (smtp_use_pipelining &&
431     (Ustrcmp(smtp_command, "MAIL") == 0 ||
432      Ustrcmp(smtp_command, "RCPT") == 0 ||
433      Ustrcmp(smtp_command, "DATA") == 0))
434   pl = US"pipelined ";
435
436 *yield = '4';    /* Default setting is to give a temporary error */
437
438 /* Handle response timeout */
439
440 if (*errno_value == ETIMEDOUT)
441   {
442   *message = US string_sprintf("SMTP timeout while connected to %s [%s] "
443     "after %s%s", host->name, host->address, pl, smtp_command);
444   if (transport_count > 0)
445     *message = US string_sprintf("%s (%d bytes written)", *message,
446       transport_count);
447   return FALSE;
448   }
449
450 /* Handle malformed SMTP response */
451
452 if (*errno_value == ERRNO_SMTPFORMAT)
453   {
454   uschar *malfresp = string_printing(buffer);
455   while (isspace(*malfresp)) malfresp++;
456   if (*malfresp == 0)
457     *message = string_sprintf("Malformed SMTP reply (an empty line) from "
458       "%s [%s] in response to %s%s", host->name, host->address, pl,
459       smtp_command);
460   else
461     *message = string_sprintf("Malformed SMTP reply from %s [%s] in response "
462       "to %s%s: %s", host->name, host->address, pl, smtp_command, malfresp);
463   return FALSE;
464   }
465
466 /* Handle a failed filter process error; can't send QUIT as we mustn't
467 end the DATA. */
468
469 if (*errno_value == ERRNO_FILTER_FAIL)
470   {
471   *message = US string_sprintf("transport filter process failed (%d)%s",
472     more_errno,
473     (more_errno == EX_EXECFAILED)? ": unable to execute command" : "");
474   return FALSE;
475   }
476
477 /* Handle a failed add_headers expansion; can't send QUIT as we mustn't
478 end the DATA. */
479
480 if (*errno_value == ERRNO_CHHEADER_FAIL)
481   {
482   *message =
483     US string_sprintf("failed to expand headers_add or headers_remove: %s",
484       expand_string_message);
485   return FALSE;
486   }
487
488 /* Handle failure to write a complete data block */
489
490 if (*errno_value == ERRNO_WRITEINCOMPLETE)
491   {
492   *message = US string_sprintf("failed to write a data block");
493   return FALSE;
494   }
495
496 /* Handle error responses from the remote mailer. */
497
498 if (buffer[0] != 0)
499   {
500   uschar *s = string_printing(buffer);
501   *message = US string_sprintf("SMTP error from remote mail server after %s%s: "
502     "host %s [%s]: %s", pl, smtp_command, host->name, host->address, s);
503   *pass_message = TRUE;
504   *yield = buffer[0];
505   return TRUE;
506   }
507
508 /* No data was read. If there is no errno, this must be the EOF (i.e.
509 connection closed) case, which causes deferral. An explicit connection reset
510 error has the same effect. Otherwise, put the host's identity in the message,
511 leaving the errno value to be interpreted as well. In all cases, we have to
512 assume the connection is now dead. */
513
514 if (*errno_value == 0 || *errno_value == ECONNRESET)
515   {
516   *errno_value = ERRNO_SMTPCLOSED;
517   *message = US string_sprintf("Remote host %s [%s] closed connection "
518     "in response to %s%s", host->name, host->address, pl, smtp_command);
519   }
520 else *message = US string_sprintf("%s [%s]", host->name, host->address);
521
522 return FALSE;
523 }
524
525
526
527 /*************************************************
528 *          Write error message to logs           *
529 *************************************************/
530
531 /* This writes to the main log and to the message log.
532
533 Arguments:
534   addr     the address item containing error information
535   host     the current host
536
537 Returns:   nothing
538 */
539
540 static void
541 write_logs(address_item *addr, host_item *host)
542 {
543 if (addr->message != NULL)
544   {
545   uschar *message = addr->message;
546   if (addr->basic_errno > 0)
547     message = string_sprintf("%s: %s", message, strerror(addr->basic_errno));
548   log_write(0, LOG_MAIN, "%s", message);
549   deliver_msglog("%s %s\n", tod_stamp(tod_log), message);
550   }
551 else
552   {
553   uschar *msg =
554     ((log_extra_selector & LX_outgoing_port) != 0)?
555     string_sprintf("%s [%s]:%d", host->name, host->address,
556       (host->port == PORT_NONE)? 25 : host->port)
557     :
558     string_sprintf("%s [%s]", host->name, host->address);
559   log_write(0, LOG_MAIN, "%s %s", msg, strerror(addr->basic_errno));
560   deliver_msglog("%s %s %s\n", tod_stamp(tod_log), msg,
561     strerror(addr->basic_errno));
562   }
563 }
564
565
566
567 /*************************************************
568 *           Synchronize SMTP responses           *
569 *************************************************/
570
571 /* This function is called from smtp_deliver() to receive SMTP responses from
572 the server, and match them up with the commands to which they relate. When
573 PIPELINING is not in use, this function is called after every command, and is
574 therefore somewhat over-engineered, but it is simpler to use a single scheme
575 that works both with and without PIPELINING instead of having two separate sets
576 of code.
577
578 The set of commands that are buffered up with pipelining may start with MAIL
579 and may end with DATA; in between are RCPT commands that correspond to the
580 addresses whose status is PENDING_DEFER. All other commands (STARTTLS, AUTH,
581 etc.) are never buffered.
582
583 Errors after MAIL or DATA abort the whole process leaving the response in the
584 buffer. After MAIL, pending responses are flushed, and the original command is
585 re-instated in big_buffer for error messages. For RCPT commands, the remote is
586 permitted to reject some recipient addresses while accepting others. However
587 certain errors clearly abort the whole process. Set the value in
588 transport_return to PENDING_OK if the address is accepted. If there is a
589 subsequent general error, it will get reset accordingly. If not, it will get
590 converted to OK at the end.
591
592 Arguments:
593   addrlist          the complete address list
594   include_affixes   TRUE if affixes include in RCPT
595   sync_addr         ptr to the ptr of the one to start scanning at (updated)
596   host              the host we are connected to
597   count             the number of responses to read
598   address_retry_
599     include_sender  true if 4xx retry is to include the sender it its key
600   pending_MAIL      true if the first response is for MAIL
601   pending_DATA      0 if last command sent was not DATA
602                    +1 if previously had a good recipient
603                    -1 if not previously had a good recipient
604   inblock           incoming SMTP block
605   timeout           timeout value
606   buffer            buffer for reading response
607   buffsize          size of buffer
608
609 Returns:      3 if at least one address had 2xx and one had 5xx
610               2 if at least one address had 5xx but none had 2xx
611               1 if at least one host had a 2xx response, but none had 5xx
612               0 no address had 2xx or 5xx but no errors (all 4xx, or just DATA)
613              -1 timeout while reading RCPT response
614              -2 I/O or other non-response error for RCPT
615              -3 DATA or MAIL failed - errno and buffer set
616 */
617
618 static int
619 sync_responses(address_item *addrlist, BOOL include_affixes,
620   address_item **sync_addr, host_item *host, int count,
621   BOOL address_retry_include_sender, BOOL pending_MAIL,
622   int pending_DATA, smtp_inblock *inblock, int timeout, uschar *buffer,
623   int buffsize)
624 {
625 address_item *addr = *sync_addr;
626 int yield = 0;
627
628 /* Handle the response for a MAIL command. On error, reinstate the original
629 command in big_buffer for error message use, and flush any further pending
630 responses before returning, except after I/O errors and timeouts. */
631
632 if (pending_MAIL)
633   {
634   count--;
635   if (!smtp_read_response(inblock, buffer, buffsize, '2', timeout))
636     {
637     Ustrcpy(big_buffer, mail_command);  /* Fits, because it came from there! */
638     if (errno == 0 && buffer[0] != 0)
639       {
640       uschar flushbuffer[4096];
641       int save_errno = 0;
642       if (buffer[0] == '4')
643         {
644         save_errno = ERRNO_MAIL4XX;
645         addr->more_errno |= ((buffer[1] - '0')*10 + buffer[2] - '0') << 8;
646         }
647       while (count-- > 0)
648         {
649         if (!smtp_read_response(inblock, flushbuffer, sizeof(flushbuffer),
650                    '2', timeout)
651             && (errno != 0 || flushbuffer[0] == 0))
652           break;
653         }
654       errno = save_errno;
655       }
656     return -3;
657     }
658   }
659
660 if (pending_DATA) count--;  /* Number of RCPT responses to come */
661
662 /* Read and handle the required number of RCPT responses, matching each one up
663 with an address by scanning for the next address whose status is PENDING_DEFER.
664 */
665
666 while (count-- > 0)
667   {
668   while (addr->transport_return != PENDING_DEFER) addr = addr->next;
669
670   /* The address was accepted */
671
672   if (smtp_read_response(inblock, buffer, buffsize, '2', timeout))
673     {
674     yield |= 1;
675     addr->transport_return = PENDING_OK;
676
677     /* If af_dr_retry_exists is set, there was a routing delay on this address;
678     ensure that any address-specific retry record is expunged. We do this both
679     for the basic key and for the version that also includes the sender. */
680
681     if (testflag(addr, af_dr_retry_exists))
682       {
683       uschar *altkey = string_sprintf("%s:<%s>", addr->address_retry_key,
684         sender_address);
685       retry_add_item(addr, altkey, rf_delete);
686       retry_add_item(addr, addr->address_retry_key, rf_delete);
687       }
688     }
689
690   /* Timeout while reading the response */
691
692   else if (errno == ETIMEDOUT)
693     {
694     int save_errno = errno;
695     uschar *message = string_sprintf("SMTP timeout while connected to %s [%s] "
696       "after RCPT TO:<%s>", host->name, host->address,
697       transport_rcpt_address(addr, include_affixes));
698     set_errno(addrlist, save_errno, message, DEFER, FALSE);
699     retry_add_item(addr, addr->address_retry_key, 0);
700     update_waiting = FALSE;
701     return -1;
702     }
703
704   /* Handle other errors in obtaining an SMTP response by returning -1. This
705   will cause all the addresses to be deferred. Restore the SMTP command in
706   big_buffer for which we are checking the response, so the error message
707   makes sense. */
708
709   else if (errno != 0 || buffer[0] == 0)
710     {
711     string_format(big_buffer, big_buffer_size, "RCPT TO:<%s>",
712       transport_rcpt_address(addr, include_affixes));
713     return -2;
714     }
715
716   /* Handle SMTP permanent and temporary response codes. */
717
718   else
719     {
720     addr->message =
721       string_sprintf("SMTP error from remote mail server after RCPT TO:<%s>: "
722         "host %s [%s]: %s", transport_rcpt_address(addr, include_affixes),
723         host->name, host->address, string_printing(buffer));
724     setflag(addr, af_pass_message);
725     deliver_msglog("%s %s\n", tod_stamp(tod_log), addr->message);
726
727     /* The response was 5xx */
728
729     if (buffer[0] == '5')
730       {
731       addr->transport_return = FAIL;
732       yield |= 2;
733       }
734
735     /* The response was 4xx */
736
737     else
738       {
739       addr->transport_return = DEFER;
740       addr->basic_errno = ERRNO_RCPT4XX;
741       addr->more_errno |= ((buffer[1] - '0')*10 + buffer[2] - '0') << 8;
742
743       /* Log temporary errors if there are more hosts to be tried. */
744
745       if (host->next != NULL) log_write(0, LOG_MAIN, "%s", addr->message);
746
747       /* Do not put this message on the list of those waiting for specific
748       hosts, as otherwise it is likely to be tried too often. */
749
750       update_waiting = FALSE;
751
752       /* Add a retry item for the address so that it doesn't get tried again
753       too soon. If address_retry_include_sender is true, add the sender address
754       to the retry key. */
755
756       if (address_retry_include_sender)
757         {
758         uschar *altkey = string_sprintf("%s:<%s>", addr->address_retry_key,
759           sender_address);
760         retry_add_item(addr, altkey, 0);
761         }
762       else retry_add_item(addr, addr->address_retry_key, 0);
763       }
764     }
765   }       /* Loop for next RCPT response */
766
767 /* Update where to start at for the next block of responses, unless we
768 have already handled all the addresses. */
769
770 if (addr != NULL) *sync_addr = addr->next;
771
772 /* Handle a response to DATA. If we have not had any good recipients, either
773 previously or in this block, the response is ignored. */
774
775 if (pending_DATA != 0 &&
776     !smtp_read_response(inblock, buffer, buffsize, '3', timeout))
777   {
778   int code;
779   uschar *msg;
780   BOOL pass_message;
781   if (pending_DATA > 0 || (yield & 1) != 0)
782     {
783     if (errno == 0 && buffer[0] == '4')
784       {
785       errno = ERRNO_DATA4XX;
786       addrlist->more_errno |= ((buffer[1] - '0')*10 + buffer[2] - '0') << 8;
787       }
788     return -3;
789     }
790   (void)check_response(host, &errno, 0, buffer, &code, &msg, &pass_message);
791   DEBUG(D_transport) debug_printf("%s\nerror for DATA ignored: pipelining "
792     "is in use and there were no good recipients\n", msg);
793   }
794
795 /* All responses read and handled; MAIL (if present) received 2xx and DATA (if
796 present) received 3xx. If any RCPTs were handled and yielded anything other
797 than 4xx, yield will be set non-zero. */
798
799 return yield;
800 }
801
802
803
804 /*************************************************
805 *       Deliver address list to given host       *
806 *************************************************/
807
808 /* If continue_hostname is not null, we get here only when continuing to
809 deliver down an existing channel. The channel was passed as the standard
810 input. TLS is never active on a passed channel; the previous process always
811 closes it down before passing the connection on.
812
813 Otherwise, we have to make a connection to the remote host, and do the
814 initial protocol exchange.
815
816 When running as an MUA wrapper, if the sender or any recipient is rejected,
817 temporarily or permanently, we force failure for all recipients.
818
819 Arguments:
820   addrlist        chain of potential addresses to deliver; only those whose
821                   transport_return field is set to PENDING_DEFER are currently
822                   being processed; others should be skipped - they have either
823                   been delivered to an earlier host or IP address, or been
824                   failed by one of them.
825   host            host to deliver to
826   host_af         AF_INET or AF_INET6
827   port            default TCP/IP port to use, in host byte order
828   interface       interface to bind to, or NULL
829   tblock          transport instance block
830   copy_host       TRUE if host set in addr->host_used must be copied, because
831                     it is specific to this call of the transport
832   message_defer   set TRUE if yield is OK, but all addresses were deferred
833                     because of a non-recipient, non-host failure, that is, a
834                     4xx response to MAIL FROM, DATA, or ".". This is a defer
835                     that is specific to the message.
836   suppress_tls    if TRUE, don't attempt a TLS connection - this is set for
837                     a second attempt after TLS initialization fails
838
839 Returns:          OK    - the connection was made and the delivery attempted;
840                           the result for each address is in its data block.
841                   DEFER - the connection could not be made, or something failed
842                           while setting up the SMTP session, or there was a
843                           non-message-specific error, such as a timeout.
844                   ERROR - a filter command is specified for this transport,
845                           and there was a problem setting it up; OR helo_data
846                           or add_headers or authenticated_sender is specified
847                           for this transport, and the string failed to expand
848 */
849
850 static int
851 smtp_deliver(address_item *addrlist, host_item *host, int host_af, int port,
852   uschar *interface, transport_instance *tblock, BOOL copy_host,
853   BOOL *message_defer, BOOL suppress_tls)
854 {
855 address_item *addr;
856 address_item *sync_addr;
857 address_item *first_addr = addrlist;
858 int yield = OK;
859 int address_count;
860 int save_errno;
861 int rc;
862 time_t start_delivery_time = time(NULL);
863 smtp_transport_options_block *ob =
864   (smtp_transport_options_block *)(tblock->options_block);
865 BOOL lmtp = strcmpic(ob->protocol, US"lmtp") == 0;
866 BOOL ok = FALSE;
867 BOOL send_rset = TRUE;
868 BOOL send_quit = TRUE;
869 BOOL setting_up = TRUE;
870 BOOL completed_address = FALSE;
871 BOOL esmtp = TRUE;
872 BOOL pending_MAIL;
873 BOOL pass_message = FALSE;
874 smtp_inblock inblock;
875 smtp_outblock outblock;
876 int max_rcpt = tblock->max_addresses;
877 uschar *igquotstr = US"";
878 uschar *local_authenticated_sender = authenticated_sender;
879 uschar *helo_data = NULL;
880 uschar *message = NULL;
881 uschar new_message_id[MESSAGE_ID_LENGTH + 1];
882 uschar *p;
883 uschar buffer[4096];
884 uschar inbuffer[4096];
885 uschar outbuffer[1024];
886
887 suppress_tls = suppress_tls;  /* stop compiler warning when no TLS support */
888
889 *message_defer = FALSE;
890 smtp_command = US"initial connection";
891 if (max_rcpt == 0) max_rcpt = 999999;
892
893 /* Set up the buffer for reading SMTP response packets. */
894
895 inblock.buffer = inbuffer;
896 inblock.buffersize = sizeof(inbuffer);
897 inblock.ptr = inbuffer;
898 inblock.ptrend = inbuffer;
899
900 /* Set up the buffer for holding SMTP commands while pipelining */
901
902 outblock.buffer = outbuffer;
903 outblock.buffersize = sizeof(outbuffer);
904 outblock.ptr = outbuffer;
905 outblock.cmd_count = 0;
906 outblock.authenticating = FALSE;
907
908 /* Reset the parameters of a TLS session. */
909
910 tls_cipher = NULL;
911 tls_peerdn = NULL;
912
913 /* If an authenticated_sender override has been specified for this transport
914 instance, expand it. If the expansion is forced to fail, and there was already
915 an authenticated_sender for this message, the original value will be used.
916 Other expansion failures are serious. An empty result is ignored, but there is
917 otherwise no check - this feature is expected to be used with LMTP and other
918 cases where non-standard addresses (e.g. without domains) might be required. */
919
920 if (ob->authenticated_sender != NULL)
921   {
922   uschar *new = expand_string(ob->authenticated_sender);
923   if (new == NULL)
924     {
925     if (!expand_string_forcedfail)
926       {
927       uschar *message = string_sprintf("failed to expand "
928         "authenticated_sender: %s", expand_string_message);
929       set_errno(addrlist, 0, message, DEFER, FALSE);
930       return ERROR;
931       }
932     }
933   else if (new[0] != 0) local_authenticated_sender = new;
934   }
935
936 /* Make a connection to the host if this isn't a continued delivery, and handle
937 the initial interaction and HELO/EHLO/LHLO. Connect timeout errors are handled
938 specially so they can be identified for retries. */
939
940 if (continue_hostname == NULL)
941   {
942   inblock.sock = outblock.sock =
943     smtp_connect(host, host_af, port, interface, ob->connect_timeout,
944       ob->keepalive);   /* This puts port into host->port */
945
946   if (inblock.sock < 0)
947     {
948     set_errno(addrlist, (errno == ETIMEDOUT)? ERRNO_CONNECTTIMEOUT : errno,
949       NULL, DEFER, FALSE);
950     return DEFER;
951     }
952
953   /* Expand the greeting message while waiting for the initial response. (Makes
954   sense if helo_data contains ${lookup dnsdb ...} stuff). The expansion is
955   delayed till here so that $sending_interface and $sending_port are set. */
956
957   helo_data = expand_string(ob->helo_data);
958
959   /* The first thing is to wait for an initial OK response. The dreaded "goto"
960   is nevertheless a reasonably clean way of programming this kind of logic,
961   where you want to escape on any error. */
962
963   if (!smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
964     ob->command_timeout)) goto RESPONSE_FAILED;
965
966   /* Now check if the helo_data expansion went well, and sign off cleanly if it
967   didn't. */
968
969   if (helo_data == NULL)
970     {
971     uschar *message = string_sprintf("failed to expand helo_data: %s",
972       expand_string_message);
973     set_errno(addrlist, 0, message, DEFER, FALSE);
974     yield = DEFER;
975     goto SEND_QUIT;
976     }
977
978 /** Debugging without sending a message
979 addrlist->transport_return = DEFER;
980 goto SEND_QUIT;
981 **/
982
983   /* Errors that occur after this point follow an SMTP command, which is
984   left in big_buffer by smtp_write_command() for use in error messages. */
985
986   smtp_command = big_buffer;
987
988   /* Tell the remote who we are...
989
990   February 1998: A convention has evolved that ESMTP-speaking MTAs include the
991   string "ESMTP" in their greeting lines, so make Exim send EHLO if the
992   greeting is of this form. The assumption was that the far end supports it
993   properly... but experience shows that there are some that give 5xx responses,
994   even though the banner includes "ESMTP" (there's a bloody-minded one that
995   says "ESMTP not spoken here"). Cope with that case.
996
997   September 2000: Time has passed, and it seems reasonable now to always send
998   EHLO at the start. It is also convenient to make the change while installing
999   the TLS stuff.
1000
1001   July 2003: Joachim Wieland met a broken server that advertises "PIPELINING"
1002   but times out after sending MAIL FROM, RCPT TO and DATA all together. There
1003   would be no way to send out the mails, so there is now a host list
1004   "hosts_avoid_esmtp" that disables ESMTP for special hosts and solves the
1005   PIPELINING problem as well. Maybe it can also be useful to cure other
1006   problems with broken servers.
1007
1008   Exim originally sent "Helo" at this point and ran for nearly a year that way.
1009   Then somebody tried it with a Microsoft mailer... It seems that all other
1010   mailers use upper case for some reason (the RFC is quite clear about case
1011   independence) so, for peace of mind, I gave in. */
1012
1013   esmtp = verify_check_this_host(&(ob->hosts_avoid_esmtp), NULL,
1014      host->name, host->address, NULL) != OK;
1015
1016   if (esmtp)
1017     {
1018     if (smtp_write_command(&outblock, FALSE, "%s %s\r\n",
1019          lmtp? "LHLO" : "EHLO", helo_data) < 0)
1020       goto SEND_FAILED;
1021     if (!smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
1022            ob->command_timeout))
1023       {
1024       if (errno != 0 || buffer[0] == 0 || lmtp) goto RESPONSE_FAILED;
1025       esmtp = FALSE;
1026       }
1027     }
1028   else
1029     {
1030     DEBUG(D_transport)
1031       debug_printf("not sending EHLO (host matches hosts_avoid_esmtp)\n");
1032     }
1033
1034   if (!esmtp)
1035     {
1036     if (smtp_write_command(&outblock, FALSE, "HELO %s\r\n", helo_data) < 0)
1037       goto SEND_FAILED;
1038     if (!smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
1039       ob->command_timeout)) goto RESPONSE_FAILED;
1040     }
1041
1042   /* Set IGNOREQUOTA if the response to LHLO specifies support and the
1043   lmtp_ignore_quota option was set. */
1044
1045   igquotstr = (lmtp && ob->lmtp_ignore_quota &&
1046     pcre_exec(regex_IGNOREQUOTA, NULL, CS buffer, Ustrlen(CS buffer), 0,
1047       PCRE_EOPT, NULL, 0) >= 0)? US" IGNOREQUOTA" : US"";
1048
1049   /* Set tls_offered if the response to EHLO specifies support for STARTTLS. */
1050
1051   #ifdef SUPPORT_TLS
1052   tls_offered = esmtp &&
1053     pcre_exec(regex_STARTTLS, NULL, CS buffer, Ustrlen(buffer), 0,
1054       PCRE_EOPT, NULL, 0) >= 0;
1055   #endif
1056   }
1057
1058 /* For continuing deliveries down the same channel, the socket is the standard
1059 input, and we don't need to redo EHLO here (but may need to do so for TLS - see
1060 below). Set up the pointer to where subsequent commands will be left, for
1061 error messages. Note that smtp_use_size and smtp_use_pipelining will have been
1062 set from the command line if they were set in the process that passed the
1063 connection on. */
1064
1065 else
1066   {
1067   inblock.sock = outblock.sock = fileno(stdin);
1068   smtp_command = big_buffer;
1069   host->port = port;    /* Record the port that was used */
1070   }
1071
1072 /* If TLS is available on this connection, whether continued or not, attempt to
1073 start up a TLS session, unless the host is in hosts_avoid_tls. If successful,
1074 send another EHLO - the server may give a different answer in secure mode. We
1075 use a separate buffer for reading the response to STARTTLS so that if it is
1076 negative, the original EHLO data is available for subsequent analysis, should
1077 the client not be required to use TLS. If the response is bad, copy the buffer
1078 for error analysis. */
1079
1080 #ifdef SUPPORT_TLS
1081 if (tls_offered && !suppress_tls &&
1082       verify_check_this_host(&(ob->hosts_avoid_tls), NULL, host->name,
1083         host->address, NULL) != OK)
1084   {
1085   uschar buffer2[4096];
1086   if (smtp_write_command(&outblock, FALSE, "STARTTLS\r\n") < 0)
1087     goto SEND_FAILED;
1088
1089   /* If there is an I/O error, transmission of this message is deferred. If
1090   there is a temporary rejection of STARRTLS and tls_tempfail_tryclear is
1091   false, we also defer. However, if there is a temporary rejection of STARTTLS
1092   and tls_tempfail_tryclear is true, or if there is an outright rejection of
1093   STARTTLS, we carry on. This means we will try to send the message in clear,
1094   unless the host is in hosts_require_tls (tested below). */
1095
1096   if (!smtp_read_response(&inblock, buffer2, sizeof(buffer2), '2',
1097       ob->command_timeout))
1098     {
1099     Ustrncpy(buffer, buffer2, sizeof(buffer));
1100     if (errno != 0 || buffer2[0] == 0 ||
1101          (buffer2[0] == '4' && !ob->tls_tempfail_tryclear))
1102       goto RESPONSE_FAILED;
1103     }
1104
1105   /* STARTTLS accepted: try to negotiate a TLS session. */
1106
1107   else
1108     {
1109     int rc = tls_client_start(inblock.sock,
1110       host,
1111       addrlist,
1112       NULL,                    /* No DH param */
1113       ob->tls_certificate,
1114       ob->tls_privatekey,
1115       ob->tls_verify_certificates,
1116       ob->tls_crl,
1117       ob->tls_require_ciphers,
1118       ob->gnutls_require_mac,
1119       ob->gnutls_require_kx,
1120       ob->gnutls_require_proto,
1121       ob->command_timeout);
1122
1123     /* TLS negotiation failed; give an error. From outside, this function may
1124     be called again to try in clear on a new connection, if the options permit
1125     it for this host. */
1126
1127     if (rc != OK)
1128       {
1129       save_errno = ERRNO_TLSFAILURE;
1130       message = US"failure while setting up TLS session";
1131       send_quit = FALSE;
1132       goto TLS_FAILED;
1133       }
1134
1135     /* TLS session is set up */
1136
1137     for (addr = addrlist; addr != NULL; addr = addr->next)
1138       {
1139       if (addr->transport_return == PENDING_DEFER)
1140         {
1141         addr->cipher = tls_cipher;
1142         addr->peerdn = tls_peerdn;
1143         }
1144       }
1145     }
1146   }
1147
1148 /* If we started TLS, redo the EHLO/LHLO exchange over the secure channel. If
1149 helo_data is null, we are dealing with a connection that was passed from
1150 another process, and so we won't have expanded helo_data above. We have to
1151 expand it here. $sending_ip_address and $sending_port are set up right at the
1152 start of the Exim process (in exim.c). */
1153
1154 if (tls_active >= 0)
1155   {
1156   if (helo_data == NULL)
1157     {
1158     helo_data = expand_string(ob->helo_data);
1159     if (helo_data == NULL)
1160       {
1161       uschar *message = string_sprintf("failed to expand helo_data: %s",
1162         expand_string_message);
1163       set_errno(addrlist, 0, message, DEFER, FALSE);
1164       yield = DEFER;
1165       goto SEND_QUIT;
1166       }
1167     }
1168
1169   if (smtp_write_command(&outblock, FALSE, "%s %s\r\n", lmtp? "LHLO" : "EHLO",
1170         helo_data) < 0)
1171     goto SEND_FAILED;
1172   if (!smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
1173        ob->command_timeout))
1174     goto RESPONSE_FAILED;
1175   }
1176
1177 /* If the host is required to use a secure channel, ensure that we
1178 have one. */
1179
1180 else if (verify_check_this_host(&(ob->hosts_require_tls), NULL, host->name,
1181           host->address, NULL) == OK)
1182   {
1183   save_errno = ERRNO_TLSREQUIRED;
1184   message = string_sprintf("a TLS session is required for %s [%s], but %s",
1185     host->name, host->address,
1186     tls_offered? "an attempt to start TLS failed" :
1187                  "the server did not offer TLS support");
1188   goto TLS_FAILED;
1189   }
1190 #endif
1191
1192 /* If TLS is active, we have just started it up and re-done the EHLO command,
1193 so its response needs to be analyzed. If TLS is not active and this is a
1194 continued session down a previously-used socket, we haven't just done EHLO, so
1195 we skip this. */
1196
1197 if (continue_hostname == NULL
1198     #ifdef SUPPORT_TLS
1199     || tls_active >= 0
1200     #endif
1201     )
1202   {
1203   int require_auth;
1204   uschar *fail_reason = US"server did not advertise AUTH support";
1205
1206   /* Set for IGNOREQUOTA if the response to LHLO specifies support and the
1207   lmtp_ignore_quota option was set. */
1208
1209   igquotstr = (lmtp && ob->lmtp_ignore_quota &&
1210     pcre_exec(regex_IGNOREQUOTA, NULL, CS buffer, Ustrlen(CS buffer), 0,
1211       PCRE_EOPT, NULL, 0) >= 0)? US" IGNOREQUOTA" : US"";
1212
1213   /* If the response to EHLO specified support for the SIZE parameter, note
1214   this, provided size_addition is non-negative. */
1215
1216   smtp_use_size = esmtp && ob->size_addition >= 0 &&
1217     pcre_exec(regex_SIZE, NULL, CS buffer, Ustrlen(CS buffer), 0,
1218       PCRE_EOPT, NULL, 0) >= 0;
1219
1220   /* Note whether the server supports PIPELINING. If hosts_avoid_esmtp matched
1221   the current host, esmtp will be false, so PIPELINING can never be used. If
1222   the current host matches hosts_avoid_pipelining, don't do it. */
1223
1224   smtp_use_pipelining = esmtp &&
1225     verify_check_this_host(&(ob->hosts_avoid_pipelining), NULL, host->name,
1226       host->address, NULL) != OK &&
1227     pcre_exec(regex_PIPELINING, NULL, CS buffer, Ustrlen(CS buffer), 0,
1228       PCRE_EOPT, NULL, 0) >= 0;
1229
1230   DEBUG(D_transport) debug_printf("%susing PIPELINING\n",
1231     smtp_use_pipelining? "" : "not ");
1232
1233   /* Note if the response to EHLO specifies support for the AUTH extension.
1234   If it has, check that this host is one we want to authenticate to, and do
1235   the business. The host name and address must be available when the
1236   authenticator's client driver is running. */
1237
1238   smtp_authenticated = FALSE;
1239   require_auth = verify_check_this_host(&(ob->hosts_require_auth), NULL,
1240     host->name, host->address, NULL);
1241
1242   if (esmtp && regex_match_and_setup(regex_AUTH, buffer, 0, -1))
1243     {
1244     uschar *names = string_copyn(expand_nstring[1], expand_nlength[1]);
1245     expand_nmax = -1;                          /* reset */
1246
1247     /* Must not do this check until after we have saved the result of the
1248     regex match above. */
1249
1250     if (require_auth == OK ||
1251         verify_check_this_host(&(ob->hosts_try_auth), NULL, host->name,
1252           host->address, NULL) == OK)
1253       {
1254       auth_instance *au;
1255       fail_reason = US"no common mechanisms were found";
1256
1257       DEBUG(D_transport) debug_printf("scanning authentication mechanisms\n");
1258
1259       /* Scan the configured authenticators looking for one which is configured
1260       for use as a client, which is not suppressed by client_condition, and
1261       whose name matches an authentication mechanism supported by the server.
1262       If one is found, attempt to authenticate by calling its client function.
1263       */
1264
1265       for (au = auths; !smtp_authenticated && au != NULL; au = au->next)
1266         {
1267         uschar *p = names;
1268         if (!au->client ||
1269             (au->client_condition != NULL &&
1270              !expand_check_condition(au->client_condition, au->name,
1271                US"client authenticator")))
1272           {
1273           DEBUG(D_transport) debug_printf("skipping %s authenticator: %s\n",
1274             au->name,
1275             (au->client)? "client_condition is false" :
1276                           "not configured as a client");
1277           continue;
1278           }
1279
1280         /* Loop to scan supported server mechanisms */
1281
1282         while (*p != 0)
1283           {
1284           int rc;
1285           int len = Ustrlen(au->public_name);
1286           while (isspace(*p)) p++;
1287
1288           if (strncmpic(au->public_name, p, len) != 0 ||
1289               (p[len] != 0 && !isspace(p[len])))
1290             {
1291             while (*p != 0 && !isspace(*p)) p++;
1292             continue;
1293             }
1294
1295           /* Found data for a listed mechanism. Call its client entry. Set
1296           a flag in the outblock so that data is overwritten after sending so
1297           that reflections don't show it. */
1298
1299           fail_reason = US"authentication attempt(s) failed";
1300           outblock.authenticating = TRUE;
1301           rc = (au->info->clientcode)(au, &inblock, &outblock,
1302             ob->command_timeout, buffer, sizeof(buffer));
1303           outblock.authenticating = FALSE;
1304           DEBUG(D_transport) debug_printf("%s authenticator yielded %d\n",
1305             au->name, rc);
1306
1307           /* A temporary authentication failure must hold up delivery to
1308           this host. After a permanent authentication failure, we carry on
1309           to try other authentication methods. If all fail hard, try to
1310           deliver the message unauthenticated unless require_auth was set. */
1311
1312           switch(rc)
1313             {
1314             case OK:
1315             smtp_authenticated = TRUE;   /* stops the outer loop */
1316             break;
1317
1318             /* Failure after writing a command */
1319
1320             case FAIL_SEND:
1321             goto SEND_FAILED;
1322
1323             /* Failure after reading a response */
1324
1325             case FAIL:
1326             if (errno != 0 || buffer[0] != '5') goto RESPONSE_FAILED;
1327             log_write(0, LOG_MAIN, "%s authenticator failed H=%s [%s] %s",
1328               au->name, host->name, host->address, buffer);
1329             break;
1330
1331             /* Failure by some other means. In effect, the authenticator
1332             decided it wasn't prepared to handle this case. Typically this
1333             is the result of "fail" in an expansion string. Do we need to
1334             log anything here? Feb 2006: a message is now put in the buffer
1335             if logging is required. */
1336
1337             case CANCELLED:
1338             if (*buffer != 0)
1339               log_write(0, LOG_MAIN, "%s authenticator cancelled "
1340                 "authentication H=%s [%s] %s", au->name, host->name,
1341                 host->address, buffer);
1342             break;
1343
1344             /* Internal problem, message in buffer. */
1345
1346             case ERROR:
1347             yield = ERROR;
1348             set_errno(addrlist, 0, string_copy(buffer), DEFER, FALSE);
1349             goto SEND_QUIT;
1350             }
1351
1352           break;  /* If not authenticated, try next authenticator */
1353           }       /* Loop for scanning supported server mechanisms */
1354         }         /* Loop for further authenticators */
1355       }
1356     }
1357
1358   /* If we haven't authenticated, but are required to, give up. */
1359
1360   if (require_auth == OK && !smtp_authenticated)
1361     {
1362     yield = DEFER;
1363     set_errno(addrlist, ERRNO_AUTHFAIL,
1364       string_sprintf("authentication required but %s", fail_reason), DEFER,
1365       FALSE);
1366     goto SEND_QUIT;
1367     }
1368   }
1369
1370 /* The setting up of the SMTP call is now complete. Any subsequent errors are
1371 message-specific. */
1372
1373 setting_up = FALSE;
1374
1375 /* If there is a filter command specified for this transport, we can now
1376 set it up. This cannot be done until the identify of the host is known. */
1377
1378 if (tblock->filter_command != NULL)
1379   {
1380   BOOL rc;
1381   uschar buffer[64];
1382   sprintf(CS buffer, "%.50s transport", tblock->name);
1383   rc = transport_set_up_command(&transport_filter_argv, tblock->filter_command,
1384     TRUE, DEFER, addrlist, buffer, NULL);
1385
1386   /* On failure, copy the error to all addresses, abandon the SMTP call, and
1387   yield ERROR. */
1388
1389   if (!rc)
1390     {
1391     set_errno(addrlist->next, addrlist->basic_errno, addrlist->message, DEFER,
1392       FALSE);
1393     yield = ERROR;
1394     goto SEND_QUIT;
1395     }
1396   }
1397
1398
1399 /* For messages that have more than the maximum number of envelope recipients,
1400 we want to send several transactions down the same SMTP connection. (See
1401 comments in deliver.c as to how this reconciles, heuristically, with
1402 remote_max_parallel.) This optimization was added to Exim after the following
1403 code was already working. The simplest way to put it in without disturbing the
1404 code was to use a goto to jump back to this point when there is another
1405 transaction to handle. */
1406
1407 SEND_MESSAGE:
1408 sync_addr = first_addr;
1409 address_count = 0;
1410 ok = FALSE;
1411 send_rset = TRUE;
1412 completed_address = FALSE;
1413
1414
1415 /* Initiate a message transfer. If we know the receiving MTA supports the SIZE
1416 qualification, send it, adding something to the message size to allow for
1417 imprecision and things that get added en route. Exim keeps the number of lines
1418 in a message, so we can give an accurate value for the original message, but we
1419 need some additional to handle added headers. (Double "." characters don't get
1420 included in the count.) */
1421
1422 p = buffer;
1423 *p = 0;
1424
1425 if (smtp_use_size)
1426   {
1427   sprintf(CS p, " SIZE=%d", message_size+message_linecount+ob->size_addition);
1428   while (*p) p++;
1429   }
1430
1431 /* Add the authenticated sender address if present */
1432
1433 if ((smtp_authenticated || ob->authenticated_sender_force) &&
1434     local_authenticated_sender != NULL)
1435   {
1436   string_format(p, sizeof(buffer) - (p-buffer), " AUTH=%s",
1437     auth_xtextencode(local_authenticated_sender,
1438     Ustrlen(local_authenticated_sender)));
1439   }
1440
1441 /* From here until we send the DATA command, we can make use of PIPELINING
1442 if the server host supports it. The code has to be able to check the responses
1443 at any point, for when the buffer fills up, so we write it totally generally.
1444 When PIPELINING is off, each command written reports that it has flushed the
1445 buffer. */
1446
1447 pending_MAIL = TRUE;     /* The block starts with MAIL */
1448
1449 rc = smtp_write_command(&outblock, smtp_use_pipelining,
1450        "MAIL FROM:<%s>%s\r\n", return_path, buffer);
1451 mail_command = string_copy(big_buffer);  /* Save for later error message */
1452
1453 switch(rc)
1454   {
1455   case -1:                /* Transmission error */
1456   goto SEND_FAILED;
1457
1458   case +1:                /* Block was sent */
1459   if (!smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
1460        ob->command_timeout))
1461     {
1462     if (errno == 0 && buffer[0] == '4')
1463       {
1464       errno = ERRNO_MAIL4XX;
1465       addrlist->more_errno |= ((buffer[1] - '0')*10 + buffer[2] - '0') << 8;
1466       }
1467     goto RESPONSE_FAILED;
1468     }
1469   pending_MAIL = FALSE;
1470   break;
1471   }
1472
1473 /* Pass over all the relevant recipient addresses for this host, which are the
1474 ones that have status PENDING_DEFER. If we are using PIPELINING, we can send
1475 several before we have to read the responses for those seen so far. This
1476 checking is done by a subroutine because it also needs to be done at the end.
1477 Send only up to max_rcpt addresses at a time, leaving first_addr pointing to
1478 the next one if not all are sent.
1479
1480 In the MUA wrapper situation, we want to flush the PIPELINING buffer for the
1481 last address because we want to abort if any recipients have any kind of
1482 problem, temporary or permanent. We know that all recipient addresses will have
1483 the PENDING_DEFER status, because only one attempt is ever made, and we know
1484 that max_rcpt will be large, so all addresses will be done at once. */
1485
1486 for (addr = first_addr;
1487      address_count < max_rcpt && addr != NULL;
1488      addr = addr->next)
1489   {
1490   int count;
1491   BOOL no_flush;
1492
1493   if (addr->transport_return != PENDING_DEFER) continue;
1494
1495   address_count++;
1496   no_flush = smtp_use_pipelining && (!mua_wrapper || addr->next != NULL);
1497
1498   /* Now send the RCPT command, and process outstanding responses when
1499   necessary. After a timeout on RCPT, we just end the function, leaving the
1500   yield as OK, because this error can often mean that there is a problem with
1501   just one address, so we don't want to delay the host. */
1502
1503   count = smtp_write_command(&outblock, no_flush, "RCPT TO:<%s>%s\r\n",
1504     transport_rcpt_address(addr, tblock->rcpt_include_affixes), igquotstr);
1505   if (count < 0) goto SEND_FAILED;
1506   if (count > 0)
1507     {
1508     switch(sync_responses(first_addr, tblock->rcpt_include_affixes,
1509              &sync_addr, host, count, ob->address_retry_include_sender,
1510              pending_MAIL, 0, &inblock, ob->command_timeout, buffer,
1511              sizeof(buffer)))
1512       {
1513       case 3: ok = TRUE;                   /* 2xx & 5xx => OK & progress made */
1514       case 2: completed_address = TRUE;    /* 5xx (only) => progress made */
1515       break;
1516
1517       case 1: ok = TRUE;                   /* 2xx (only) => OK, but if LMTP, */
1518       if (!lmtp) completed_address = TRUE; /* can't tell about progress yet */
1519       case 0:                              /* No 2xx or 5xx, but no probs */
1520       break;
1521
1522       case -1: goto END_OFF;               /* Timeout on RCPT */
1523       default: goto RESPONSE_FAILED;       /* I/O error, or any MAIL error */
1524       }
1525     pending_MAIL = FALSE;                  /* Dealt with MAIL */
1526     }
1527   }      /* Loop for next address */
1528
1529 /* If we are an MUA wrapper, abort if any RCPTs were rejected, either
1530 permanently or temporarily. We should have flushed and synced after the last
1531 RCPT. */
1532
1533 if (mua_wrapper)
1534   {
1535   address_item *badaddr;
1536   for (badaddr = first_addr; badaddr != NULL; badaddr = badaddr->next)
1537     {
1538     if (badaddr->transport_return != PENDING_OK) break;
1539     }
1540   if (badaddr != NULL)
1541     {
1542     set_errno(addrlist, 0, badaddr->message, FAIL,
1543       testflag(badaddr, af_pass_message));
1544     ok = FALSE;
1545     }
1546   }
1547
1548 /* If ok is TRUE, we know we have got at least one good recipient, and must now
1549 send DATA, but if it is FALSE (in the normal, non-wrapper case), we may still
1550 have a good recipient buffered up if we are pipelining. We don't want to waste
1551 time sending DATA needlessly, so we only send it if either ok is TRUE or if we
1552 are pipelining. The responses are all handled by sync_responses(). */
1553
1554 if (ok || (smtp_use_pipelining && !mua_wrapper))
1555   {
1556   int count = smtp_write_command(&outblock, FALSE, "DATA\r\n");
1557   if (count < 0) goto SEND_FAILED;
1558   switch(sync_responses(first_addr, tblock->rcpt_include_affixes, &sync_addr,
1559            host, count, ob->address_retry_include_sender, pending_MAIL,
1560            ok? +1 : -1, &inblock, ob->command_timeout, buffer, sizeof(buffer)))
1561     {
1562     case 3: ok = TRUE;                   /* 2xx & 5xx => OK & progress made */
1563     case 2: completed_address = TRUE;    /* 5xx (only) => progress made */
1564     break;
1565
1566     case 1: ok = TRUE;                   /* 2xx (only) => OK, but if LMTP, */
1567     if (!lmtp) completed_address = TRUE; /* can't tell about progress yet */
1568     case 0: break;                       /* No 2xx or 5xx, but no probs */
1569
1570     case -1: goto END_OFF;               /* Timeout on RCPT */
1571     default: goto RESPONSE_FAILED;       /* I/O error, or any MAIL/DATA error */
1572     }
1573   }
1574
1575 /* Save the first address of the next batch. */
1576
1577 first_addr = addr;
1578
1579 /* If there were no good recipients (but otherwise there have been no
1580 problems), just set ok TRUE, since we have handled address-specific errors
1581 already. Otherwise, it's OK to send the message. Use the check/escape mechanism
1582 for handling the SMTP dot-handling protocol, flagging to apply to headers as
1583 well as body. Set the appropriate timeout value to be used for each chunk.
1584 (Haven't been able to make it work using select() for writing yet.) */
1585
1586 if (!ok) ok = TRUE; else
1587   {
1588   sigalrm_seen = FALSE;
1589   transport_write_timeout = ob->data_timeout;
1590   smtp_command = US"sending data block";   /* For error messages */
1591   DEBUG(D_transport|D_v)
1592     debug_printf("  SMTP>> writing message and terminating \".\"\n");
1593   transport_count = 0;
1594 #if (defined EXPERIMENTAL_DOMAINKEYS) || (defined EXPERIMENTAL_DKIM)
1595   ok = dkim_transport_write_message(addrlist, inblock.sock,
1596     topt_use_crlf | topt_end_dot | topt_escape_headers |
1597       (tblock->body_only? topt_no_headers : 0) |
1598       (tblock->headers_only? topt_no_body : 0) |
1599       (tblock->return_path_add? topt_add_return_path : 0) |
1600       (tblock->delivery_date_add? topt_add_delivery_date : 0) |
1601       (tblock->envelope_to_add? topt_add_envelope_to : 0),
1602     0,            /* No size limit */
1603     tblock->add_headers, tblock->remove_headers,
1604     US".", US"..",    /* Escaping strings */
1605     tblock->rewrite_rules, tblock->rewrite_existflags,
1606     ob->dkim_private_key, ob->dkim_domain, ob->dkim_selector,
1607     ob->dkim_canon, ob->dkim_strict, ob->dkim_sign_headers,
1608     ob->dk_private_key, ob->dk_domain, ob->dk_selector,
1609     ob->dk_canon, ob->dk_headers, ob->dk_strict
1610     );
1611 #else
1612   ok = transport_write_message(addrlist, inblock.sock,
1613     topt_use_crlf | topt_end_dot | topt_escape_headers |
1614       (tblock->body_only? topt_no_headers : 0) |
1615       (tblock->headers_only? topt_no_body : 0) |
1616       (tblock->return_path_add? topt_add_return_path : 0) |
1617       (tblock->delivery_date_add? topt_add_delivery_date : 0) |
1618       (tblock->envelope_to_add? topt_add_envelope_to : 0),
1619     0,            /* No size limit */
1620     tblock->add_headers, tblock->remove_headers,
1621     US".", US"..",    /* Escaping strings */
1622     tblock->rewrite_rules, tblock->rewrite_existflags);
1623 #endif
1624
1625   /* transport_write_message() uses write() because it is called from other
1626   places to write to non-sockets. This means that under some OS (e.g. Solaris)
1627   it can exit with "Broken pipe" as its error. This really means that the
1628   socket got closed at the far end. */
1629
1630   transport_write_timeout = 0;   /* for subsequent transports */
1631
1632   /* Failure can either be some kind of I/O disaster (including timeout),
1633   or the failure of a transport filter or the expansion of added headers. */
1634
1635   if (!ok)
1636     {
1637     buffer[0] = 0;              /* There hasn't been a response */
1638     goto RESPONSE_FAILED;
1639     }
1640
1641   /* We used to send the terminating "." explicitly here, but because of
1642   buffering effects at both ends of TCP/IP connections, you don't gain
1643   anything by keeping it separate, so it might as well go in the final
1644   data buffer for efficiency. This is now done by setting the topt_end_dot
1645   flag above. */
1646
1647   smtp_command = US"end of data";
1648
1649   /* For SMTP, we now read a single response that applies to the whole message.
1650   If it is OK, then all the addresses have been delivered. */
1651
1652   if (!lmtp)
1653     {
1654     ok = smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
1655       ob->final_timeout);
1656     if (!ok && errno == 0 && buffer[0] == '4')
1657       {
1658       errno = ERRNO_DATA4XX;
1659       addrlist->more_errno |= ((buffer[1] - '0')*10 + buffer[2] - '0') << 8;
1660       }
1661     }
1662
1663   /* For LMTP, we get back a response for every RCPT command that we sent;
1664   some may be accepted and some rejected. For those that get a response, their
1665   status is fixed; any that are accepted have been handed over, even if later
1666   responses crash - at least, that's how I read RFC 2033.
1667
1668   If all went well, mark the recipient addresses as completed, record which
1669   host/IPaddress they were delivered to, and cut out RSET when sending another
1670   message down the same channel. Write the completed addresses to the journal
1671   now so that they are recorded in case there is a crash of hardware or
1672   software before the spool gets updated. Also record the final SMTP
1673   confirmation if needed (for SMTP only). */
1674
1675   if (ok)
1676     {
1677     int flag = '=';
1678     int delivery_time = (int)(time(NULL) - start_delivery_time);
1679     int len;
1680     host_item *thost;
1681     uschar *conf = NULL;
1682     send_rset = FALSE;
1683
1684     /* Make a copy of the host if it is local to this invocation
1685     of the transport. */
1686
1687     if (copy_host)
1688       {
1689       thost = store_get(sizeof(host_item));
1690       *thost = *host;
1691       thost->name = string_copy(host->name);
1692       thost->address = string_copy(host->address);
1693       }
1694     else thost = host;
1695
1696     /* Set up confirmation if needed - applies only to SMTP */
1697
1698     if ((log_extra_selector & LX_smtp_confirmation) != 0 && !lmtp)
1699       {
1700       uschar *s = string_printing(buffer);
1701       conf = (s == buffer)? (uschar *)string_copy(s) : s;
1702       }
1703
1704     /* Process all transported addresses - for LMTP, read a status for
1705     each one. */
1706
1707     for (addr = addrlist; addr != first_addr; addr = addr->next)
1708       {
1709       if (addr->transport_return != PENDING_OK) continue;
1710
1711       /* LMTP - if the response fails badly (e.g. timeout), use it for all the
1712       remaining addresses. Otherwise, it's a return code for just the one
1713       address. For temporary errors, add a retry item for the address so that
1714       it doesn't get tried again too soon. */
1715
1716       if (lmtp)
1717         {
1718         if (!smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
1719             ob->final_timeout))
1720           {
1721           if (errno != 0 || buffer[0] == 0) goto RESPONSE_FAILED;
1722           addr->message = string_sprintf("LMTP error after %s: %s",
1723             big_buffer, string_printing(buffer));
1724           setflag(addr, af_pass_message);   /* Allow message to go to user */
1725           if (buffer[0] == '5')
1726             addr->transport_return = FAIL;
1727           else
1728             {
1729             errno = ERRNO_DATA4XX;
1730             addr->more_errno |= ((buffer[1] - '0')*10 + buffer[2] - '0') << 8;
1731             addr->transport_return = DEFER;
1732             retry_add_item(addr, addr->address_retry_key, 0);
1733             }
1734           continue;
1735           }
1736         completed_address = TRUE;   /* NOW we can set this flag */
1737         }
1738
1739       /* SMTP, or success return from LMTP for this address. Pass back the
1740       actual host that was used. */
1741
1742       addr->transport_return = OK;
1743       addr->more_errno = delivery_time;
1744       addr->host_used = thost;
1745       addr->special_action = flag;
1746       addr->message = conf;
1747       flag = '-';
1748
1749       /* Update the journal. For homonymic addresses, use the base address plus
1750       the transport name. See lots of comments in deliver.c about the reasons
1751       for the complications when homonyms are involved. Just carry on after
1752       write error, as it may prove possible to update the spool file later. */
1753
1754       if (testflag(addr, af_homonym))
1755         sprintf(CS buffer, "%.500s/%s\n", addr->unique + 3, tblock->name);
1756       else
1757         sprintf(CS buffer, "%.500s\n", addr->unique);
1758
1759       DEBUG(D_deliver) debug_printf("journalling %s", buffer);
1760       len = Ustrlen(CS buffer);
1761       if (write(journal_fd, buffer, len) != len)
1762         log_write(0, LOG_MAIN|LOG_PANIC, "failed to write journal for "
1763           "%s: %s", buffer, strerror(errno));
1764       }
1765
1766     /* Ensure the journal file is pushed out to disk. */
1767
1768     if (EXIMfsync(journal_fd) < 0)
1769       log_write(0, LOG_MAIN|LOG_PANIC, "failed to fsync journal: %s",
1770         strerror(errno));
1771     }
1772   }
1773
1774
1775 /* Handle general (not specific to one address) failures here. The value of ok
1776 is used to skip over this code on the falling through case. A timeout causes a
1777 deferral. Other errors may defer or fail according to the response code, and
1778 may set up a special errno value, e.g. after connection chopped, which is
1779 assumed if errno == 0 and there is no text in the buffer. If control reaches
1780 here during the setting up phase (i.e. before MAIL FROM) then always defer, as
1781 the problem is not related to this specific message. */
1782
1783 if (!ok)
1784   {
1785   int code;
1786
1787   RESPONSE_FAILED:
1788   save_errno = errno;
1789   message = NULL;
1790   send_quit = check_response(host, &save_errno, addrlist->more_errno,
1791     buffer, &code, &message, &pass_message);
1792   goto FAILED;
1793
1794   SEND_FAILED:
1795   save_errno = errno;
1796   code = '4';
1797   message = US string_sprintf("send() to %s [%s] failed: %s",
1798     host->name, host->address, strerror(save_errno));
1799   send_quit = FALSE;
1800   goto FAILED;
1801
1802   /* This label is jumped to directly when a TLS negotiation has failed,
1803   or was not done for a host for which it is required. Values will be set
1804   in message and save_errno, and setting_up will always be true. Treat as
1805   a temporary error. */
1806
1807   #ifdef SUPPORT_TLS
1808   TLS_FAILED:
1809   code = '4';
1810   #endif
1811
1812   /* If the failure happened while setting up the call, see if the failure was
1813   a 5xx response (this will either be on connection, or following HELO - a 5xx
1814   after EHLO causes it to try HELO). If so, fail all addresses, as this host is
1815   never going to accept them. For other errors during setting up (timeouts or
1816   whatever), defer all addresses, and yield DEFER, so that the host is not
1817   tried again for a while. */
1818
1819   FAILED:
1820   ok = FALSE;                /* For when reached by GOTO */
1821
1822   if (setting_up)
1823     {
1824     if (code == '5')
1825       {
1826       set_errno(addrlist, save_errno, message, FAIL, pass_message);
1827       }
1828     else
1829       {
1830       set_errno(addrlist, save_errno, message, DEFER, pass_message);
1831       yield = DEFER;
1832       }
1833     }
1834
1835   /* We want to handle timeouts after MAIL or "." and loss of connection after
1836   "." specially. They can indicate a problem with the sender address or with
1837   the contents of the message rather than a real error on the connection. These
1838   cases are treated in the same way as a 4xx response. This next bit of code
1839   does the classification. */
1840
1841   else
1842     {
1843     BOOL message_error;
1844
1845     switch(save_errno)
1846       {
1847       case 0:
1848       case ERRNO_MAIL4XX:
1849       case ERRNO_DATA4XX:
1850       message_error = TRUE;
1851       break;
1852
1853       case ETIMEDOUT:
1854       message_error = Ustrncmp(smtp_command,"MAIL",4) == 0 ||
1855                       Ustrncmp(smtp_command,"end ",4) == 0;
1856       break;
1857
1858       case ERRNO_SMTPCLOSED:
1859       message_error = Ustrncmp(smtp_command,"end ",4) == 0;
1860       break;
1861
1862       default:
1863       message_error = FALSE;
1864       break;
1865       }
1866
1867     /* Handle the cases that are treated as message errors. These are:
1868
1869       (a) negative response or timeout after MAIL
1870       (b) negative response after DATA
1871       (c) negative response or timeout or dropped connection after "."
1872
1873     It won't be a negative response or timeout after RCPT, as that is dealt
1874     with separately above. The action in all cases is to set an appropriate
1875     error code for all the addresses, but to leave yield set to OK because the
1876     host itself has not failed. Of course, it might in practice have failed
1877     when we've had a timeout, but if so, we'll discover that at the next
1878     delivery attempt. For a temporary error, set the message_defer flag, and
1879     write to the logs for information if this is not the last host. The error
1880     for the last host will be logged as part of the address's log line. */
1881
1882     if (message_error)
1883       {
1884       if (mua_wrapper) code = '5';  /* Force hard failure in wrapper mode */
1885       set_errno(addrlist, save_errno, message, (code == '5')? FAIL : DEFER,
1886         pass_message);
1887
1888       /* If there's an errno, the message contains just the identity of
1889       the host. */
1890
1891       if (code != '5')     /* Anything other than 5 is treated as temporary */
1892         {
1893         if (save_errno > 0)
1894           message = US string_sprintf("%s: %s", message, strerror(save_errno));
1895         if (host->next != NULL) log_write(0, LOG_MAIN, "%s", message);
1896         deliver_msglog("%s %s\n", tod_stamp(tod_log), message);
1897         *message_defer = TRUE;
1898         }
1899       }
1900
1901     /* Otherwise, we have an I/O error or a timeout other than after MAIL or
1902     ".", or some other transportation error. We defer all addresses and yield
1903     DEFER, except for the case of failed add_headers expansion, or a transport
1904     filter failure, when the yield should be ERROR, to stop it trying other
1905     hosts. */
1906
1907     else
1908       {
1909       yield = (save_errno == ERRNO_CHHEADER_FAIL ||
1910                save_errno == ERRNO_FILTER_FAIL)? ERROR : DEFER;
1911       set_errno(addrlist, save_errno, message, DEFER, pass_message);
1912       }
1913     }
1914   }
1915
1916
1917 /* If all has gone well, send_quit will be set TRUE, implying we can end the
1918 SMTP session tidily. However, if there were too many addresses to send in one
1919 message (indicated by first_addr being non-NULL) we want to carry on with the
1920 rest of them. Also, it is desirable to send more than one message down the SMTP
1921 connection if there are several waiting, provided we haven't already sent so
1922 many as to hit the configured limit. The function transport_check_waiting looks
1923 for a waiting message and returns its id. Then transport_pass_socket tries to
1924 set up a continued delivery by passing the socket on to another process. The
1925 variable send_rset is FALSE if a message has just been successfully transfered.
1926
1927 If we are already sending down a continued channel, there may be further
1928 addresses not yet delivered that are aimed at the same host, but which have not
1929 been passed in this run of the transport. In this case, continue_more will be
1930 true, and all we should do is send RSET if necessary, and return, leaving the
1931 channel open.
1932
1933 However, if no address was disposed of, i.e. all addresses got 4xx errors, we
1934 do not want to continue with other messages down the same channel, because that
1935 can lead to looping between two or more messages, all with the same,
1936 temporarily failing address(es). [The retry information isn't updated yet, so
1937 new processes keep on trying.] We probably also don't want to try more of this
1938 message's addresses either.
1939
1940 If we have started a TLS session, we have to end it before passing the
1941 connection to a new process. However, not all servers can handle this (Exim
1942 can), so we do not pass such a connection on if the host matches
1943 hosts_nopass_tls. */
1944
1945 DEBUG(D_transport)
1946   debug_printf("ok=%d send_quit=%d send_rset=%d continue_more=%d "
1947     "yield=%d first_address is %sNULL\n", ok, send_quit, send_rset,
1948     continue_more, yield, (first_addr == NULL)? "":"not ");
1949
1950 if (completed_address && ok && send_quit)
1951   {
1952   BOOL more;
1953   if (first_addr != NULL || continue_more ||
1954         (
1955            (tls_active < 0 ||
1956            verify_check_this_host(&(ob->hosts_nopass_tls), NULL, host->name,
1957              host->address, NULL) != OK)
1958         &&
1959            transport_check_waiting(tblock->name, host->name,
1960              tblock->connection_max_messages, new_message_id, &more)
1961         ))
1962     {
1963     uschar *msg;
1964     BOOL pass_message;
1965
1966     if (send_rset)
1967       {
1968       if (! (ok = smtp_write_command(&outblock, FALSE, "RSET\r\n") >= 0))
1969         {
1970         msg = US string_sprintf("send() to %s [%s] failed: %s", host->name,
1971           host->address, strerror(save_errno));
1972         send_quit = FALSE;
1973         }
1974       else if (! (ok = smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
1975                   ob->command_timeout)))
1976         {
1977         int code;
1978         send_quit = check_response(host, &errno, 0, buffer, &code, &msg,
1979           &pass_message);
1980         if (!send_quit)
1981           {
1982           DEBUG(D_transport) debug_printf("%s\n", msg);
1983           }
1984         }
1985       }
1986
1987     /* Either RSET was not needed, or it succeeded */
1988
1989     if (ok)
1990       {
1991       if (first_addr != NULL)            /* More addresses still to be sent */
1992         {                                /*   in this run of the transport */
1993         continue_sequence++;             /* Causes * in logging */
1994         goto SEND_MESSAGE;
1995         }
1996       if (continue_more) return yield;   /* More addresses for another run */
1997
1998       /* Pass the socket to a new Exim process. Before doing so, we must shut
1999       down TLS. Not all MTAs allow for the continuation of the SMTP session
2000       when TLS is shut down. We test for this by sending a new EHLO. If we
2001       don't get a good response, we don't attempt to pass the socket on. */
2002
2003       #ifdef SUPPORT_TLS
2004       if (tls_active >= 0)
2005         {
2006         tls_close(TRUE);
2007         ok = smtp_write_command(&outblock,FALSE,"EHLO %s\r\n",helo_data) >= 0 &&
2008              smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
2009                ob->command_timeout);
2010         }
2011       #endif
2012
2013       /* If the socket is successfully passed, we musn't send QUIT (or
2014       indeed anything!) from here. */
2015
2016       if (ok && transport_pass_socket(tblock->name, host->name, host->address,
2017             new_message_id, inblock.sock))
2018         {
2019         send_quit = FALSE;
2020         }
2021       }
2022
2023     /* If RSET failed and there are addresses left, they get deferred. */
2024
2025     else set_errno(first_addr, errno, msg, DEFER, FALSE);
2026     }
2027   }
2028
2029 /* End off tidily with QUIT unless the connection has died or the socket has
2030 been passed to another process. There has been discussion on the net about what
2031 to do after sending QUIT. The wording of the RFC suggests that it is necessary
2032 to wait for a response, but on the other hand, there isn't anything one can do
2033 with an error response, other than log it. Exim used to do that. However,
2034 further discussion suggested that it is positively advantageous not to wait for
2035 the response, but to close the session immediately. This is supposed to move
2036 the TCP/IP TIME_WAIT state from the server to the client, thereby removing some
2037 load from the server. (Hosts that are both servers and clients may not see much
2038 difference, of course.) Further discussion indicated that this was safe to do
2039 on Unix systems which have decent implementations of TCP/IP that leave the
2040 connection around for a while (TIME_WAIT) after the application has gone away.
2041 This enables the response sent by the server to be properly ACKed rather than
2042 timed out, as can happen on broken TCP/IP implementations on other OS.
2043
2044 This change is being made on 31-Jul-98. After over a year of trouble-free
2045 operation, the old commented-out code was removed on 17-Sep-99. */
2046
2047 SEND_QUIT:
2048 if (send_quit) (void)smtp_write_command(&outblock, FALSE, "QUIT\r\n");
2049
2050 END_OFF:
2051
2052 #ifdef SUPPORT_TLS
2053 tls_close(TRUE);
2054 #endif
2055
2056 /* Close the socket, and return the appropriate value, first setting
2057 continue_transport and continue_hostname NULL to prevent any other addresses
2058 that may include the host from trying to re-use a continuation socket. This
2059 works because the NULL setting is passed back to the calling process, and
2060 remote_max_parallel is forced to 1 when delivering over an existing connection,
2061
2062 If all went well and continue_more is set, we shouldn't actually get here if
2063 there are further addresses, as the return above will be taken. However,
2064 writing RSET might have failed, or there may be other addresses whose hosts are
2065 specified in the transports, and therefore not visible at top level, in which
2066 case continue_more won't get set. */
2067
2068 (void)close(inblock.sock);
2069 continue_transport = NULL;
2070 continue_hostname = NULL;
2071 return yield;
2072 }
2073
2074
2075
2076
2077 /*************************************************
2078 *              Closedown entry point             *
2079 *************************************************/
2080
2081 /* This function is called when exim is passed an open smtp channel
2082 from another incarnation, but the message which it has been asked
2083 to deliver no longer exists. The channel is on stdin.
2084
2085 We might do fancy things like looking for another message to send down
2086 the channel, but if the one we sought has gone, it has probably been
2087 delivered by some other process that itself will seek further messages,
2088 so just close down our connection.
2089
2090 Argument:   pointer to the transport instance block
2091 Returns:    nothing
2092 */
2093
2094 void
2095 smtp_transport_closedown(transport_instance *tblock)
2096 {
2097 smtp_transport_options_block *ob =
2098   (smtp_transport_options_block *)(tblock->options_block);
2099 smtp_inblock inblock;
2100 smtp_outblock outblock;
2101 uschar buffer[256];
2102 uschar inbuffer[4096];
2103 uschar outbuffer[16];
2104
2105 inblock.sock = fileno(stdin);
2106 inblock.buffer = inbuffer;
2107 inblock.buffersize = sizeof(inbuffer);
2108 inblock.ptr = inbuffer;
2109 inblock.ptrend = inbuffer;
2110
2111 outblock.sock = inblock.sock;
2112 outblock.buffersize = sizeof(outbuffer);
2113 outblock.buffer = outbuffer;
2114 outblock.ptr = outbuffer;
2115 outblock.cmd_count = 0;
2116 outblock.authenticating = FALSE;
2117
2118 (void)smtp_write_command(&outblock, FALSE, "QUIT\r\n");
2119 (void)smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
2120   ob->command_timeout);
2121 (void)close(inblock.sock);
2122 }
2123
2124
2125
2126 /*************************************************
2127 *            Prepare addresses for delivery      *
2128 *************************************************/
2129
2130 /* This function is called to flush out error settings from previous delivery
2131 attempts to other hosts. It also records whether we got here via an MX record
2132 or not in the more_errno field of the address. We are interested only in
2133 addresses that are still marked DEFER - others may have got delivered to a
2134 previously considered IP address. Set their status to PENDING_DEFER to indicate
2135 which ones are relevant this time.
2136
2137 Arguments:
2138   addrlist     the list of addresses
2139   host         the host we are delivering to
2140
2141 Returns:       the first address for this delivery
2142 */
2143
2144 static address_item *
2145 prepare_addresses(address_item *addrlist, host_item *host)
2146 {
2147 address_item *first_addr = NULL;
2148 address_item *addr;
2149 for (addr = addrlist; addr != NULL; addr = addr->next)
2150   {
2151   if (addr->transport_return != DEFER) continue;
2152   if (first_addr == NULL) first_addr = addr;
2153   addr->transport_return = PENDING_DEFER;
2154   addr->basic_errno = 0;
2155   addr->more_errno = (host->mx >= 0)? 'M' : 'A';
2156   addr->message = NULL;
2157   #ifdef SUPPORT_TLS
2158   addr->cipher = NULL;
2159   addr->peerdn = NULL;
2160   #endif
2161   }
2162 return first_addr;
2163 }
2164
2165
2166
2167 /*************************************************
2168 *              Main entry point                  *
2169 *************************************************/
2170
2171 /* See local README for interface details. As this is a remote transport, it is
2172 given a chain of addresses to be delivered in one connection, if possible. It
2173 always returns TRUE, indicating that each address has its own independent
2174 status set, except if there is a setting up problem, in which case it returns
2175 FALSE. */
2176
2177 BOOL
2178 smtp_transport_entry(
2179   transport_instance *tblock,      /* data for this instantiation */
2180   address_item *addrlist)          /* addresses we are working on */
2181 {
2182 int cutoff_retry;
2183 int port;
2184 int hosts_defer = 0;
2185 int hosts_fail  = 0;
2186 int hosts_looked_up = 0;
2187 int hosts_retry = 0;
2188 int hosts_serial = 0;
2189 int hosts_total = 0;
2190 int total_hosts_tried = 0;
2191 address_item *addr;
2192 BOOL expired = TRUE;
2193 BOOL continuing = continue_hostname != NULL;
2194 uschar *expanded_hosts = NULL;
2195 uschar *pistring;
2196 uschar *tid = string_sprintf("%s transport", tblock->name);
2197 smtp_transport_options_block *ob =
2198   (smtp_transport_options_block *)(tblock->options_block);
2199 host_item *hostlist = addrlist->host_list;
2200 host_item *host = NULL;
2201
2202 DEBUG(D_transport)
2203   {
2204   debug_printf("%s transport entered\n", tblock->name);
2205   for (addr = addrlist; addr != NULL; addr = addr->next)
2206     debug_printf("  %s\n", addr->address);
2207   if (continuing) debug_printf("already connected to %s [%s]\n",
2208       continue_hostname, continue_host_address);
2209   }
2210
2211 /* Set the flag requesting that these hosts be added to the waiting
2212 database if the delivery fails temporarily or if we are running with
2213 queue_smtp or a 2-stage queue run. This gets unset for certain
2214 kinds of error, typically those that are specific to the message. */
2215
2216 update_waiting =  TRUE;
2217
2218 /* If a host list is not defined for the addresses - they must all have the
2219 same one in order to be passed to a single transport - or if the transport has
2220 a host list with hosts_override set, use the host list supplied with the
2221 transport. It is an error for this not to exist. */
2222
2223 if (hostlist == NULL || (ob->hosts_override && ob->hosts != NULL))
2224   {
2225   if (ob->hosts == NULL)
2226     {
2227     addrlist->message = string_sprintf("%s transport called with no hosts set",
2228       tblock->name);
2229     addrlist->transport_return = PANIC;
2230     return FALSE;   /* Only top address has status */
2231     }
2232
2233   DEBUG(D_transport) debug_printf("using the transport's hosts: %s\n",
2234     ob->hosts);
2235
2236   /* If the transport's host list contains no '$' characters, and we are not
2237   randomizing, it is fixed and therefore a chain of hosts can be built once
2238   and for all, and remembered for subsequent use by other calls to this
2239   transport. If, on the other hand, the host list does contain '$', or we are
2240   randomizing its order, we have to rebuild it each time. In the fixed case,
2241   as the hosts string will never be used again, it doesn't matter that we
2242   replace all the : characters with zeros. */
2243
2244   if (ob->hostlist == NULL)
2245     {
2246     uschar *s = ob->hosts;
2247
2248     if (Ustrchr(s, '$') != NULL)
2249       {
2250       expanded_hosts = expand_string(s);
2251       if (expanded_hosts == NULL)
2252         {
2253         addrlist->message = string_sprintf("failed to expand list of hosts "
2254           "\"%s\" in %s transport: %s", s, tblock->name, expand_string_message);
2255         addrlist->transport_return = search_find_defer? DEFER : PANIC;
2256         return FALSE;     /* Only top address has status */
2257         }
2258       DEBUG(D_transport) debug_printf("expanded list of hosts \"%s\" to "
2259         "\"%s\"\n", s, expanded_hosts);
2260       s = expanded_hosts;
2261       }
2262     else
2263       if (ob->hosts_randomize) s = expanded_hosts = string_copy(s);
2264
2265     host_build_hostlist(&hostlist, s, ob->hosts_randomize);
2266
2267     /* Check that the expansion yielded something useful. */
2268     if (hostlist == NULL)
2269       {
2270       addrlist->message =
2271         string_sprintf("%s transport has empty hosts setting", tblock->name);
2272       addrlist->transport_return = PANIC;
2273       return FALSE;   /* Only top address has status */
2274       }
2275
2276     /* If there was no expansion of hosts, save the host list for
2277     next time. */
2278
2279     if (expanded_hosts == NULL) ob->hostlist = hostlist;
2280     }
2281
2282   /* This is not the first time this transport has been run in this delivery;
2283   the host list was built previously. */
2284
2285   else hostlist = ob->hostlist;
2286   }
2287
2288 /* The host list was supplied with the address. If hosts_randomize is set, we
2289 must sort it into a random order if it did not come from MX records and has not
2290 already been randomized (but don't bother if continuing down an existing
2291 connection). */
2292
2293 else if (ob->hosts_randomize && hostlist->mx == MX_NONE && !continuing)
2294   {
2295   host_item *newlist = NULL;
2296   while (hostlist != NULL)
2297     {
2298     host_item *h = hostlist;
2299     hostlist = hostlist->next;
2300
2301     h->sort_key = random_number(100);
2302
2303     if (newlist == NULL)
2304       {
2305       h->next = NULL;
2306       newlist = h;
2307       }
2308     else if (h->sort_key < newlist->sort_key)
2309       {
2310       h->next = newlist;
2311       newlist = h;
2312       }
2313     else
2314       {
2315       host_item *hh = newlist;
2316       while (hh->next != NULL)
2317         {
2318         if (h->sort_key < hh->next->sort_key) break;
2319         hh = hh->next;
2320         }
2321       h->next = hh->next;
2322       hh->next = h;
2323       }
2324     }
2325
2326   hostlist = addrlist->host_list = newlist;
2327   }
2328
2329
2330 /* Sort out the default port.  */
2331
2332 if (!smtp_get_port(ob->port, addrlist, &port, tid)) return FALSE;
2333
2334
2335 /* For each host-plus-IP-address on the list:
2336
2337 .  If this is a continued delivery and the host isn't the one with the
2338    current connection, skip.
2339
2340 .  If the status is unusable (i.e. previously failed or retry checked), skip.
2341
2342 .  If no IP address set, get the address, either by turning the name into
2343    an address, calling gethostbyname if gethostbyname is on, or by calling
2344    the DNS. The DNS may yield multiple addresses, in which case insert the
2345    extra ones into the list.
2346
2347 .  Get the retry data if not previously obtained for this address and set the
2348    field which remembers the state of this address. Skip if the retry time is
2349    not reached. If not, remember whether retry data was found. The retry string
2350    contains both the name and the IP address.
2351
2352 .  Scan the list of addresses and mark those whose status is DEFER as
2353    PENDING_DEFER. These are the only ones that will be processed in this cycle
2354    of the hosts loop.
2355
2356 .  Make a delivery attempt - addresses marked PENDING_DEFER will be tried.
2357    Some addresses may be successfully delivered, others may fail, and yet
2358    others may get temporary errors and so get marked DEFER.
2359
2360 .  The return from the delivery attempt is OK if a connection was made and a
2361    valid SMTP dialogue was completed. Otherwise it is DEFER.
2362
2363 .  If OK, add a "remove" retry item for this host/IPaddress, if any.
2364
2365 .  If fail to connect, or other defer state, add a retry item.
2366
2367 .  If there are any addresses whose status is still DEFER, carry on to the
2368    next host/IPaddress, unless we have tried the number of hosts given
2369    by hosts_max_try or hosts_max_try_hardlimit; otherwise return. Note that
2370    there is some fancy logic for hosts_max_try that means its limit can be
2371    overstepped in some circumstances.
2372
2373 If we get to the end of the list, all hosts have deferred at least one address,
2374 or not reached their retry times. If delay_after_cutoff is unset, it requests a
2375 delivery attempt to those hosts whose last try was before the arrival time of
2376 the current message. To cope with this, we have to go round the loop a second
2377 time. After that, set the status and error data for any addresses that haven't
2378 had it set already. */
2379
2380 for (cutoff_retry = 0; expired &&
2381      cutoff_retry < ((ob->delay_after_cutoff)? 1 : 2);
2382      cutoff_retry++)
2383   {
2384   host_item *nexthost = NULL;
2385   int unexpired_hosts_tried = 0;
2386
2387   for (host = hostlist;
2388        host != NULL &&
2389          unexpired_hosts_tried < ob->hosts_max_try &&
2390          total_hosts_tried < ob->hosts_max_try_hardlimit;
2391        host = nexthost)
2392     {
2393     int rc;
2394     int host_af;
2395     uschar *rs;
2396     BOOL serialized = FALSE;
2397     BOOL host_is_expired = FALSE;
2398     BOOL message_defer = FALSE;
2399     BOOL ifchanges = FALSE;
2400     BOOL some_deferred = FALSE;
2401     address_item *first_addr = NULL;
2402     uschar *interface = NULL;
2403     uschar *retry_host_key = NULL;
2404     uschar *retry_message_key = NULL;
2405     uschar *serialize_key = NULL;
2406
2407     /* Default next host is next host. :-) But this can vary if the
2408     hosts_max_try limit is hit (see below). It may also be reset if a host
2409     address is looked up here (in case the host was multihomed). */
2410
2411     nexthost = host->next;
2412
2413     /* If the address hasn't yet been obtained from the host name, look it up
2414     now, unless the host is already marked as unusable. If it is marked as
2415     unusable, it means that the router was unable to find its IP address (in
2416     the DNS or wherever) OR we are in the 2nd time round the cutoff loop, and
2417     the lookup failed last time. We don't get this far if *all* MX records
2418     point to non-existent hosts; that is treated as a hard error.
2419
2420     We can just skip this host entirely. When the hosts came from the router,
2421     the address will timeout based on the other host(s); when the address is
2422     looked up below, there is an explicit retry record added.
2423
2424     Note that we mustn't skip unusable hosts if the address is not unset; they
2425     may be needed as expired hosts on the 2nd time round the cutoff loop. */
2426
2427     if (host->address == NULL)
2428       {
2429       int new_port, flags;
2430       host_item *hh;
2431       uschar *canonical_name;
2432
2433       if (host->status >= hstatus_unusable)
2434         {
2435         DEBUG(D_transport) debug_printf("%s has no address and is unusable - skipping\n",
2436           host->name);
2437         continue;
2438         }
2439
2440       DEBUG(D_transport) debug_printf("getting address for %s\n", host->name);
2441
2442       /* The host name is permitted to have an attached port. Find it, and
2443       strip it from the name. Just remember it for now. */
2444
2445       new_port = host_item_get_port(host);
2446
2447       /* Count hosts looked up */
2448
2449       hosts_looked_up++;
2450
2451       /* Find by name if so configured, or if it's an IP address. We don't
2452       just copy the IP address, because we need the test-for-local to happen. */
2453
2454       flags = HOST_FIND_BY_A;
2455       if (ob->dns_qualify_single) flags |= HOST_FIND_QUALIFY_SINGLE;
2456       if (ob->dns_search_parents) flags |= HOST_FIND_SEARCH_PARENTS;
2457
2458       if (ob->gethostbyname || string_is_ip_address(host->name, NULL) != 0)
2459         rc = host_find_byname(host, NULL, flags, &canonical_name, TRUE);
2460       else
2461         rc = host_find_bydns(host, NULL, flags, NULL, NULL, NULL,
2462           &canonical_name, NULL);
2463
2464       /* Update the host (and any additional blocks, resulting from
2465       multihoming) with a host-specific port, if any. */
2466
2467       for (hh = host; hh != nexthost; hh = hh->next) hh->port = new_port;
2468
2469       /* Failure to find the host at this time (usually DNS temporary failure)
2470       is really a kind of routing failure rather than a transport failure.
2471       Therefore we add a retry item of the routing kind, not to stop us trying
2472       to look this name up here again, but to ensure the address gets timed
2473       out if the failures go on long enough. A complete failure at this point
2474       commonly points to a configuration error, but the best action is still
2475       to carry on for the next host. */
2476
2477       if (rc == HOST_FIND_AGAIN || rc == HOST_FIND_FAILED)
2478         {
2479         retry_add_item(addrlist, string_sprintf("R:%s", host->name), 0);
2480         expired = FALSE;
2481         if (rc == HOST_FIND_AGAIN) hosts_defer++; else hosts_fail++;
2482         DEBUG(D_transport) debug_printf("rc = %s for %s\n", (rc == HOST_FIND_AGAIN)?
2483           "HOST_FIND_AGAIN" : "HOST_FIND_FAILED", host->name);
2484         host->status = hstatus_unusable;
2485
2486         for (addr = addrlist; addr != NULL; addr = addr->next)
2487           {
2488           if (addr->transport_return != DEFER) continue;
2489           addr->basic_errno = ERRNO_UNKNOWNHOST;
2490           addr->message =
2491             string_sprintf("failed to lookup IP address for %s", host->name);
2492           }
2493         continue;
2494         }
2495
2496       /* If the host is actually the local host, we may have a problem, or
2497       there may be some cunning configuration going on. In the problem case,
2498       log things and give up. The default transport status is already DEFER. */
2499
2500       if (rc == HOST_FOUND_LOCAL && !ob->allow_localhost)
2501         {
2502         for (addr = addrlist; addr != NULL; addr = addr->next)
2503           {
2504           addr->basic_errno = 0;
2505           addr->message = string_sprintf("%s transport found host %s to be "
2506             "local", tblock->name, host->name);
2507           }
2508         goto END_TRANSPORT;
2509         }
2510       }   /* End of block for IP address lookup */
2511
2512     /* If this is a continued delivery, we are interested only in the host
2513     which matches the name of the existing open channel. The check is put
2514     here after the local host lookup, in case the name gets expanded as a
2515     result of the lookup. Set expired FALSE, to save the outer loop executing
2516     twice. */
2517
2518     if (continuing && (Ustrcmp(continue_hostname, host->name) != 0 ||
2519                        Ustrcmp(continue_host_address, host->address) != 0))
2520       {
2521       expired = FALSE;
2522       continue;      /* With next host */
2523       }
2524
2525     /* Reset the default next host in case a multihomed host whose addresses
2526     are not looked up till just above added to the host list. */
2527
2528     nexthost = host->next;
2529
2530     /* If queue_smtp is set (-odqs or the first part of a 2-stage run), or the
2531     domain is in queue_smtp_domains, we don't actually want to attempt any
2532     deliveries. When doing a queue run, queue_smtp_domains is always unset. If
2533     there is a lookup defer in queue_smtp_domains, proceed as if the domain
2534     were not in it. We don't want to hold up all SMTP deliveries! Except when
2535     doing a two-stage queue run, don't do this if forcing. */
2536
2537     if ((!deliver_force || queue_2stage) && (queue_smtp ||
2538         match_isinlist(addrlist->domain, &queue_smtp_domains, 0,
2539           &domainlist_anchor, NULL, MCL_DOMAIN, TRUE, NULL) == OK))
2540       {
2541       expired = FALSE;
2542       for (addr = addrlist; addr != NULL; addr = addr->next)
2543         {
2544         if (addr->transport_return != DEFER) continue;
2545         addr->message = US"domain matches queue_smtp_domains, or -odqs set";
2546         }
2547       continue;      /* With next host */
2548       }
2549
2550     /* Count hosts being considered - purely for an intelligent comment
2551     if none are usable. */
2552
2553     hosts_total++;
2554
2555     /* Set $host and $host address now in case they are needed for the
2556     interface expansion or the serialize_hosts check; they remain set if an
2557     actual delivery happens. */
2558
2559     deliver_host = host->name;
2560     deliver_host_address = host->address;
2561
2562     /* Set up a string for adding to the retry key if the port number is not
2563     the standard SMTP port. A host may have its own port setting that overrides
2564     the default. */
2565
2566     pistring = string_sprintf(":%d", (host->port == PORT_NONE)?
2567       port : host->port);
2568     if (Ustrcmp(pistring, ":25") == 0) pistring = US"";
2569
2570     /* Select IPv4 or IPv6, and choose an outgoing interface. If the interface
2571     string changes upon expansion, we must add it to the key that is used for
2572     retries, because connections to the same host from a different interface
2573     should be treated separately. */
2574
2575     host_af = (Ustrchr(host->address, ':') == NULL)? AF_INET : AF_INET6;
2576     if (!smtp_get_interface(ob->interface, host_af, addrlist, &ifchanges,
2577          &interface, tid))
2578       return FALSE;
2579     if (ifchanges) pistring = string_sprintf("%s/%s", pistring, interface);
2580
2581     /* The first time round the outer loop, check the status of the host by
2582     inspecting the retry data. The second time round, we are interested only
2583     in expired hosts that haven't been tried since this message arrived. */
2584
2585     if (cutoff_retry == 0)
2586       {
2587       /* Ensure the status of the address is set by checking retry data if
2588       necessary. There maybe host-specific retry data (applicable to all
2589       messages) and also data for retries of a specific message at this host.
2590       If either of these retry records are actually read, the keys used are
2591       returned to save recomputing them later. */
2592
2593       host_is_expired = retry_check_address(addrlist->domain, host, pistring,
2594         ob->retry_include_ip_address, &retry_host_key, &retry_message_key);
2595
2596       DEBUG(D_transport) debug_printf("%s [%s]%s status = %s\n", host->name,
2597         (host->address == NULL)? US"" : host->address, pistring,
2598         (host->status == hstatus_usable)? "usable" :
2599         (host->status == hstatus_unusable)? "unusable" :
2600         (host->status == hstatus_unusable_expired)? "unusable (expired)" : "?");
2601
2602       /* Skip this address if not usable at this time, noting if it wasn't
2603       actually expired, both locally and in the address. */
2604
2605       switch (host->status)
2606         {
2607         case hstatus_unusable:
2608         expired = FALSE;
2609         setflag(addrlist, af_retry_skipped);
2610         /* Fall through */
2611
2612         case hstatus_unusable_expired:
2613         switch (host->why)
2614           {
2615           case hwhy_retry: hosts_retry++; break;
2616           case hwhy_failed:  hosts_fail++; break;
2617           case hwhy_deferred: hosts_defer++; break;
2618           }
2619
2620         /* If there was a retry message key, implying that previously there
2621         was a message-specific defer, we don't want to update the list of
2622         messages waiting for these hosts. */
2623
2624         if (retry_message_key != NULL) update_waiting = FALSE;
2625         continue;   /* With the next host or IP address */
2626         }
2627       }
2628
2629     /* Second time round the loop: if the address is set but expired, and
2630     the message is newer than the last try, let it through. */
2631
2632     else
2633       {
2634       if (host->address == NULL ||
2635           host->status != hstatus_unusable_expired ||
2636           host->last_try > received_time)
2637         continue;
2638       DEBUG(D_transport)
2639         debug_printf("trying expired host %s [%s]%s\n",
2640           host->name, host->address, pistring);
2641       host_is_expired = TRUE;
2642       }
2643
2644     /* Setting "expired=FALSE" doesn't actually mean not all hosts are expired;
2645     it remains TRUE only if all hosts are expired and none are actually tried.
2646     */
2647
2648     expired = FALSE;
2649
2650     /* If this host is listed as one to which access must be serialized,
2651     see if another Exim process has a connection to it, and if so, skip
2652     this host. If not, update the database to record our connection to it
2653     and remember this for later deletion. Do not do any of this if we are
2654     sending the message down a pre-existing connection. */
2655
2656     if (!continuing &&
2657         verify_check_this_host(&(ob->serialize_hosts), NULL, host->name,
2658           host->address, NULL) == OK)
2659       {
2660       serialize_key = string_sprintf("host-serialize-%s", host->name);
2661       if (!enq_start(serialize_key))
2662         {
2663         DEBUG(D_transport)
2664           debug_printf("skipping host %s because another Exim process "
2665             "is connected to it\n", host->name);
2666         hosts_serial++;
2667         continue;
2668         }
2669       serialized = TRUE;
2670       }
2671
2672     /* OK, we have an IP address that is not waiting for its retry time to
2673     arrive (it might be expired) OR (second time round the loop) we have an
2674     expired host that hasn't been tried since the message arrived. Have a go
2675     at delivering the message to it. First prepare the addresses by flushing
2676     out the result of previous attempts, and finding the first address that
2677     is still to be delivered. */
2678
2679     first_addr = prepare_addresses(addrlist, host);
2680
2681     DEBUG(D_transport) debug_printf("delivering %s to %s [%s] (%s%s)\n",
2682       message_id, host->name, host->address, addrlist->address,
2683       (addrlist->next == NULL)? "" : ", ...");
2684
2685     set_process_info("delivering %s to %s [%s] (%s%s)",
2686       message_id, host->name, host->address, addrlist->address,
2687       (addrlist->next == NULL)? "" : ", ...");
2688
2689     /* This is not for real; don't do the delivery. If there are
2690     any remaining hosts, list them. */
2691
2692     if (dont_deliver)
2693       {
2694       host_item *host2;
2695       set_errno(addrlist, 0, NULL, OK, FALSE);
2696       for (addr = addrlist; addr != NULL; addr = addr->next)
2697         {
2698         addr->host_used = host;
2699         addr->special_action = '*';
2700         addr->message = US"delivery bypassed by -N option";
2701         }
2702       DEBUG(D_transport)
2703         {
2704         debug_printf("*** delivery by %s transport bypassed by -N option\n"
2705                      "*** host and remaining hosts:\n", tblock->name);
2706         for (host2 = host; host2 != NULL; host2 = host2->next)
2707           debug_printf("    %s [%s]\n", host2->name,
2708             (host2->address == NULL)? US"unset" : host2->address);
2709         }
2710       rc = OK;
2711       }
2712
2713     /* This is for real. If the host is expired, we don't count it for
2714     hosts_max_retry. This ensures that all hosts must expire before an address
2715     is timed out, unless hosts_max_try_hardlimit (which protects against
2716     lunatic DNS configurations) is reached.
2717
2718     If the host is not expired and we are about to hit the hosts_max_retry
2719     limit, check to see if there is a subsequent hosts with a different MX
2720     value. If so, make that the next host, and don't count this one. This is a
2721     heuristic to make sure that different MXs do get tried. With a normal kind
2722     of retry rule, they would get tried anyway when the earlier hosts were
2723     delayed, but if the domain has a "retry every time" type of rule - as is
2724     often used for the the very large ISPs, that won't happen. */
2725
2726     else
2727       {
2728       if (!host_is_expired && ++unexpired_hosts_tried >= ob->hosts_max_try)
2729         {
2730         host_item *h;
2731         DEBUG(D_transport)
2732           debug_printf("hosts_max_try limit reached with this host\n");
2733         for (h = host; h != NULL; h = h->next)
2734           if (h->mx != host->mx) break;
2735         if (h != NULL)
2736           {
2737           nexthost = h;
2738           unexpired_hosts_tried--;
2739           DEBUG(D_transport) debug_printf("however, a higher MX host exists "
2740             "and will be tried\n");
2741           }
2742         }
2743
2744       /* Attempt the delivery. */
2745
2746       total_hosts_tried++;
2747       rc = smtp_deliver(addrlist, host, host_af, port, interface, tblock,
2748         expanded_hosts != NULL, &message_defer, FALSE);
2749
2750       /* Yield is one of:
2751          OK     => connection made, each address contains its result;
2752                      message_defer is set for message-specific defers (when all
2753                      recipients are marked defer)
2754          DEFER  => there was a non-message-specific delivery problem;
2755          ERROR  => there was a problem setting up the arguments for a filter,
2756                    or there was a problem with expanding added headers
2757       */
2758
2759       /* If the result is not OK, there was a non-message-specific problem.
2760       If the result is DEFER, we need to write to the logs saying what happened
2761       for this particular host, except in the case of authentication and TLS
2762       failures, where the log has already been written. If all hosts defer a
2763       general message is written at the end. */
2764
2765       if (rc == DEFER && first_addr->basic_errno != ERRNO_AUTHFAIL &&
2766                          first_addr->basic_errno != ERRNO_TLSFAILURE)
2767         write_logs(first_addr, host);
2768
2769       /* If STARTTLS was accepted, but there was a failure in setting up the
2770       TLS session (usually a certificate screwup), and the host is not in
2771       hosts_require_tls, and tls_tempfail_tryclear is true, try again, with
2772       TLS forcibly turned off. We have to start from scratch with a new SMTP
2773       connection. That's why the retry is done from here, not from within
2774       smtp_deliver(). [Rejections of STARTTLS itself don't screw up the
2775       session, so the in-clear transmission after those errors, if permitted,
2776       happens inside smtp_deliver().] */
2777
2778       #ifdef SUPPORT_TLS
2779       if (rc == DEFER && first_addr->basic_errno == ERRNO_TLSFAILURE &&
2780            ob->tls_tempfail_tryclear &&
2781            verify_check_this_host(&(ob->hosts_require_tls), NULL, host->name,
2782              host->address, NULL) != OK)
2783         {
2784         log_write(0, LOG_MAIN, "TLS session failure: delivering unencrypted "
2785           "to %s [%s] (not in hosts_require_tls)", host->name, host->address);
2786         first_addr = prepare_addresses(addrlist, host);
2787         rc = smtp_deliver(addrlist, host, host_af, port, interface, tblock,
2788           expanded_hosts != NULL, &message_defer, TRUE);
2789         if (rc == DEFER && first_addr->basic_errno != ERRNO_AUTHFAIL)
2790           write_logs(first_addr, host);
2791         }
2792       #endif
2793       }
2794
2795     /* Delivery attempt finished */
2796
2797     rs = (rc == OK)? US"OK" : (rc == DEFER)? US"DEFER" : (rc == ERROR)?
2798       US"ERROR" : US"?";
2799
2800     set_process_info("delivering %s: just tried %s [%s] for %s%s: result %s",
2801       message_id, host->name, host->address, addrlist->address,
2802       (addrlist->next == NULL)? "" : " (& others)", rs);
2803
2804     /* Release serialization if set up */
2805
2806     if (serialized) enq_end(serialize_key);
2807
2808     /* If the result is DEFER, or if a host retry record is known to exist, we
2809     need to add an item to the retry chain for updating the retry database
2810     at the end of delivery. We only need to add the item to the top address,
2811     of course. Also, if DEFER, we mark the IP address unusable so as to skip it
2812     for any other delivery attempts using the same address. (It is copied into
2813     the unusable tree at the outer level, so even if different address blocks
2814     contain the same address, it still won't get tried again.) */
2815
2816     if (rc == DEFER || retry_host_key != NULL)
2817       {
2818       int delete_flag = (rc != DEFER)? rf_delete : 0;
2819       if (retry_host_key == NULL)
2820         {
2821         retry_host_key = ob->retry_include_ip_address?
2822           string_sprintf("T:%S:%s%s", host->name, host->address, pistring) :
2823           string_sprintf("T:%S%s", host->name, pistring);
2824         }
2825
2826       /* If a delivery of another message over an existing SMTP connection
2827       yields DEFER, we do NOT set up retry data for the host. This covers the
2828       case when there are delays in routing the addresses in the second message
2829       that are so long that the server times out. This is alleviated by not
2830       routing addresses that previously had routing defers when handling an
2831       existing connection, but even so, this case may occur (e.g. if a
2832       previously happily routed address starts giving routing defers). If the
2833       host is genuinely down, another non-continued message delivery will
2834       notice it soon enough. */
2835
2836       if (delete_flag != 0 || !continuing)
2837         retry_add_item(first_addr, retry_host_key, rf_host | delete_flag);
2838
2839       /* We may have tried an expired host, if its retry time has come; ensure
2840       the status reflects the expiry for the benefit of any other addresses. */
2841
2842       if (rc == DEFER)
2843         {
2844         host->status = (host_is_expired)?
2845           hstatus_unusable_expired : hstatus_unusable;
2846         host->why = hwhy_deferred;
2847         }
2848       }
2849
2850     /* If message_defer is set (host was OK, but every recipient got deferred
2851     because of some message-specific problem), or if that had happened
2852     previously so that a message retry key exists, add an appropriate item
2853     to the retry chain. Note that if there was a message defer but now there is
2854     a host defer, the message defer record gets deleted. That seems perfectly
2855     reasonable. Also, stop the message from being remembered as waiting
2856     for specific hosts. */
2857
2858     if (message_defer || retry_message_key != NULL)
2859       {
2860       int delete_flag = message_defer? 0 : rf_delete;
2861       if (retry_message_key == NULL)
2862         {
2863         retry_message_key = ob->retry_include_ip_address?
2864           string_sprintf("T:%S:%s%s:%s", host->name, host->address, pistring,
2865             message_id) :
2866           string_sprintf("T:%S%s:%s", host->name, pistring, message_id);
2867         }
2868       retry_add_item(addrlist, retry_message_key,
2869         rf_message | rf_host | delete_flag);
2870       update_waiting = FALSE;
2871       }
2872
2873     /* Any return other than DEFER (that is, OK or ERROR) means that the
2874     addresses have got their final statuses filled in for this host. In the OK
2875     case, see if any of them are deferred. */
2876
2877     if (rc == OK)
2878       {
2879       for (addr = addrlist; addr != NULL; addr = addr->next)
2880         {
2881         if (addr->transport_return == DEFER)
2882           {
2883           some_deferred = TRUE;
2884           break;
2885           }
2886         }
2887       }
2888
2889     /* If no addresses deferred or the result was ERROR, return. We do this for
2890     ERROR because a failing filter set-up or add_headers expansion is likely to
2891     fail for any host we try. */
2892
2893     if (rc == ERROR || (rc == OK && !some_deferred))
2894       {
2895       DEBUG(D_transport) debug_printf("Leaving %s transport\n", tblock->name);
2896       return TRUE;    /* Each address has its status */
2897       }
2898
2899     /* If the result was DEFER or some individual addresses deferred, let
2900     the loop run to try other hosts with the deferred addresses, except for the
2901     case when we were trying to deliver down an existing channel and failed.
2902     Don't try any other hosts in this case. */
2903
2904     if (continuing) break;
2905
2906     /* If the whole delivery, or some individual addresses, were deferred and
2907     there are more hosts that could be tried, do not count this host towards
2908     the hosts_max_try limit if the age of the message is greater than the
2909     maximum retry time for this host. This means we may try try all hosts,
2910     ignoring the limit, when messages have been around for some time. This is
2911     important because if we don't try all hosts, the address will never time
2912     out. NOTE: this does not apply to hosts_max_try_hardlimit. */
2913
2914     if ((rc == DEFER || some_deferred) && nexthost != NULL)
2915       {
2916       BOOL timedout;
2917       retry_config *retry = retry_find_config(host->name, NULL, 0, 0);
2918
2919       if (retry != NULL && retry->rules != NULL)
2920         {
2921         retry_rule *last_rule;
2922         for (last_rule = retry->rules;
2923              last_rule->next != NULL;
2924              last_rule = last_rule->next);
2925         timedout = time(NULL) - received_time > last_rule->timeout;
2926         }
2927       else timedout = TRUE;    /* No rule => timed out */
2928
2929       if (timedout)
2930         {
2931         unexpired_hosts_tried--;
2932         DEBUG(D_transport) debug_printf("temporary delivery error(s) override "
2933           "hosts_max_try (message older than host's retry time)\n");
2934         }
2935       }
2936     }   /* End of loop for trying multiple hosts. */
2937
2938   /* This is the end of the loop that repeats iff expired is TRUE and
2939   ob->delay_after_cutoff is FALSE. The second time round we will
2940   try those hosts that haven't been tried since the message arrived. */
2941
2942   DEBUG(D_transport)
2943     {
2944     debug_printf("all IP addresses skipped or deferred at least one address\n");
2945     if (expired && !ob->delay_after_cutoff && cutoff_retry == 0)
2946       debug_printf("retrying IP addresses not tried since message arrived\n");
2947     }
2948   }
2949
2950
2951 /* Get here if all IP addresses are skipped or defer at least one address. In
2952 MUA wrapper mode, this will happen only for connection or other non-message-
2953 specific failures. Force the delivery status for all addresses to FAIL. */
2954
2955 if (mua_wrapper)
2956   {
2957   for (addr = addrlist; addr != NULL; addr = addr->next)
2958     addr->transport_return = FAIL;
2959   goto END_TRANSPORT;
2960   }
2961
2962 /* In the normal, non-wrapper case, add a standard message to each deferred
2963 address if there hasn't been an error, that is, if it hasn't actually been
2964 tried this time. The variable "expired" will be FALSE if any deliveries were
2965 actually tried, or if there was at least one host that was not expired. That
2966 is, it is TRUE only if no deliveries were tried and all hosts were expired. If
2967 a delivery has been tried, an error code will be set, and the failing of the
2968 message is handled by the retry code later.
2969
2970 If queue_smtp is set, or this transport was called to send a subsequent message
2971 down an existing TCP/IP connection, and something caused the host not to be
2972 found, we end up here, but can detect these cases and handle them specially. */
2973
2974 for (addr = addrlist; addr != NULL; addr = addr->next)
2975   {
2976   /* If host is not NULL, it means that we stopped processing the host list
2977   because of hosts_max_try or hosts_max_try_hardlimit. In the former case, this
2978   means we need to behave as if some hosts were skipped because their retry
2979   time had not come. Specifically, this prevents the address from timing out.
2980   However, if we have hit hosts_max_try_hardlimit, we want to behave as if all
2981   hosts were tried. */
2982
2983   if (host != NULL)
2984     {
2985     if (total_hosts_tried >= ob->hosts_max_try_hardlimit)
2986       {
2987       DEBUG(D_transport)
2988         debug_printf("hosts_max_try_hardlimit reached: behave as if all "
2989           "hosts were tried\n");
2990       }
2991     else
2992       {
2993       DEBUG(D_transport)
2994         debug_printf("hosts_max_try limit caused some hosts to be skipped\n");
2995       setflag(addr, af_retry_skipped);
2996       }
2997     }
2998
2999   if (queue_smtp)    /* no deliveries attempted */
3000     {
3001     addr->transport_return = DEFER;
3002     addr->basic_errno = 0;
3003     addr->message = US"SMTP delivery explicitly queued";
3004     }
3005
3006   else if (addr->transport_return == DEFER &&
3007        (addr->basic_errno == ERRNO_UNKNOWNERROR || addr->basic_errno == 0) &&
3008        addr->message == NULL)
3009     {
3010     addr->basic_errno = ERRNO_HRETRY;
3011     if (continue_hostname != NULL)
3012       {
3013       addr->message = US"no host found for existing SMTP connection";
3014       }
3015     else if (expired)
3016       {
3017       setflag(addr, af_pass_message);   /* This is not a security risk */
3018       addr->message = (ob->delay_after_cutoff)?
3019         US"retry time not reached for any host after a long failure period" :
3020         US"all hosts have been failing for a long time and were last tried "
3021           "after this message arrived";
3022
3023       /* If we are already using fallback hosts, or there are no fallback hosts
3024       defined, convert the result to FAIL to cause a bounce. */
3025
3026       if (addr->host_list == addr->fallback_hosts ||
3027           addr->fallback_hosts == NULL)
3028         addr->transport_return = FAIL;
3029       }
3030     else
3031       {
3032       if (hosts_retry == hosts_total)
3033         addr->message = US"retry time not reached for any host";
3034       else if (hosts_fail == hosts_total)
3035         addr->message = US"all host address lookups failed permanently";
3036       else if (hosts_defer == hosts_total)
3037         addr->message = US"all host address lookups failed temporarily";
3038       else if (hosts_serial == hosts_total)
3039         addr->message = US"connection limit reached for all hosts";
3040       else if (hosts_fail+hosts_defer == hosts_total)
3041         addr->message = US"all host address lookups failed";
3042       else addr->message = US"some host address lookups failed and retry time "
3043         "not reached for other hosts or connection limit reached";
3044       }
3045     }
3046   }
3047
3048 /* Update the database which keeps information about which messages are waiting
3049 for which hosts to become available. For some message-specific errors, the
3050 update_waiting flag is turned off because we don't want follow-on deliveries in
3051 those cases. */
3052
3053 if (update_waiting) transport_update_waiting(hostlist, tblock->name);
3054
3055 END_TRANSPORT:
3056
3057 DEBUG(D_transport) debug_printf("Leaving %s transport\n", tblock->name);
3058
3059 return TRUE;   /* Each address has its status */
3060 }
3061
3062 /* End of transport/smtp.c */