1 /*************************************************
2 * Exim - an Internet mail transport agent *
3 *************************************************/
5 /* Copyright (c) University of Cambridge 1995 - 2014 */
6 /* See the file NOTICE for conditions of use and distribution. */
12 #define PENDING_DEFER (PENDING + DEFER)
13 #define PENDING_OK (PENDING + OK)
16 /* Options specific to the smtp transport. This transport also supports LMTP
17 over TCP/IP. The options must be in alphabetic order (note that "_" comes
18 before the lower case letters). Some live in the transport_instance block so as
19 to be publicly visible; these are flagged with opt_public. */
21 optionlist smtp_transport_options[] = {
22 { "*expand_multi_domain", opt_stringptr | opt_hidden | opt_public,
23 (void *)offsetof(transport_instance, expand_multi_domain) },
24 { "*expand_retry_include_ip_address", opt_stringptr | opt_hidden,
25 (void *)(offsetof(smtp_transport_options_block, expand_retry_include_ip_address)) },
27 { "address_retry_include_sender", opt_bool,
28 (void *)offsetof(smtp_transport_options_block, address_retry_include_sender) },
29 { "allow_localhost", opt_bool,
30 (void *)offsetof(smtp_transport_options_block, allow_localhost) },
31 { "authenticated_sender", opt_stringptr,
32 (void *)offsetof(smtp_transport_options_block, authenticated_sender) },
33 { "authenticated_sender_force", opt_bool,
34 (void *)offsetof(smtp_transport_options_block, authenticated_sender_force) },
35 { "command_timeout", opt_time,
36 (void *)offsetof(smtp_transport_options_block, command_timeout) },
37 { "connect_timeout", opt_time,
38 (void *)offsetof(smtp_transport_options_block, connect_timeout) },
39 { "connection_max_messages", opt_int | opt_public,
40 (void *)offsetof(transport_instance, connection_max_messages) },
41 { "data_timeout", opt_time,
42 (void *)offsetof(smtp_transport_options_block, data_timeout) },
43 { "delay_after_cutoff", opt_bool,
44 (void *)offsetof(smtp_transport_options_block, delay_after_cutoff) },
46 { "dkim_canon", opt_stringptr,
47 (void *)offsetof(smtp_transport_options_block, dkim_canon) },
48 { "dkim_domain", opt_stringptr,
49 (void *)offsetof(smtp_transport_options_block, dkim_domain) },
50 { "dkim_private_key", opt_stringptr,
51 (void *)offsetof(smtp_transport_options_block, dkim_private_key) },
52 { "dkim_selector", opt_stringptr,
53 (void *)offsetof(smtp_transport_options_block, dkim_selector) },
54 { "dkim_sign_headers", opt_stringptr,
55 (void *)offsetof(smtp_transport_options_block, dkim_sign_headers) },
56 { "dkim_strict", opt_stringptr,
57 (void *)offsetof(smtp_transport_options_block, dkim_strict) },
59 { "dns_qualify_single", opt_bool,
60 (void *)offsetof(smtp_transport_options_block, dns_qualify_single) },
61 { "dns_search_parents", opt_bool,
62 (void *)offsetof(smtp_transport_options_block, dns_search_parents) },
63 { "dnssec_request_domains", opt_stringptr,
64 (void *)offsetof(smtp_transport_options_block, dnssec_request_domains) },
65 { "dnssec_require_domains", opt_stringptr,
66 (void *)offsetof(smtp_transport_options_block, dnssec_require_domains) },
67 { "dscp", opt_stringptr,
68 (void *)offsetof(smtp_transport_options_block, dscp) },
69 { "fallback_hosts", opt_stringptr,
70 (void *)offsetof(smtp_transport_options_block, fallback_hosts) },
71 { "final_timeout", opt_time,
72 (void *)offsetof(smtp_transport_options_block, final_timeout) },
73 { "gethostbyname", opt_bool,
74 (void *)offsetof(smtp_transport_options_block, gethostbyname) },
76 /* These are no longer honoured, as of Exim 4.80; for now, we silently
77 ignore; 4.83 will warn, and a later-still release will remove
78 these options, so that using them becomes an error. */
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) },
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) },
95 { "hosts_avoid_tls", opt_stringptr,
96 (void *)offsetof(smtp_transport_options_block, hosts_avoid_tls) },
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) },
103 { "hosts_nopass_tls", opt_stringptr,
104 (void *)offsetof(smtp_transport_options_block, hosts_nopass_tls) },
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 #if defined(SUPPORT_TLS) && !defined(DISABLE_OCSP)
111 { "hosts_request_ocsp", opt_stringptr,
112 (void *)offsetof(smtp_transport_options_block, hosts_request_ocsp) },
114 { "hosts_require_auth", opt_stringptr,
115 (void *)offsetof(smtp_transport_options_block, hosts_require_auth) },
117 # ifdef EXPERIMENTAL_DANE
118 { "hosts_require_dane", opt_stringptr,
119 (void *)offsetof(smtp_transport_options_block, hosts_require_dane) },
121 # ifndef DISABLE_OCSP
122 { "hosts_require_ocsp", opt_stringptr,
123 (void *)offsetof(smtp_transport_options_block, hosts_require_ocsp) },
125 { "hosts_require_tls", opt_stringptr,
126 (void *)offsetof(smtp_transport_options_block, hosts_require_tls) },
128 { "hosts_try_auth", opt_stringptr,
129 (void *)offsetof(smtp_transport_options_block, hosts_try_auth) },
130 #if defined(SUPPORT_TLS) && defined(EXPERIMENTAL_DANE)
131 { "hosts_try_dane", opt_stringptr,
132 (void *)offsetof(smtp_transport_options_block, hosts_try_dane) },
135 { "hosts_try_prdr", opt_stringptr,
136 (void *)offsetof(smtp_transport_options_block, hosts_try_prdr) },
139 { "hosts_verify_avoid_tls", opt_stringptr,
140 (void *)offsetof(smtp_transport_options_block, hosts_verify_avoid_tls) },
142 { "interface", opt_stringptr,
143 (void *)offsetof(smtp_transport_options_block, interface) },
144 { "keepalive", opt_bool,
145 (void *)offsetof(smtp_transport_options_block, keepalive) },
146 { "lmtp_ignore_quota", opt_bool,
147 (void *)offsetof(smtp_transport_options_block, lmtp_ignore_quota) },
148 { "max_rcpt", opt_int | opt_public,
149 (void *)offsetof(transport_instance, max_addresses) },
150 { "multi_domain", opt_expand_bool | opt_public,
151 (void *)offsetof(transport_instance, multi_domain) },
152 { "port", opt_stringptr,
153 (void *)offsetof(smtp_transport_options_block, port) },
154 { "protocol", opt_stringptr,
155 (void *)offsetof(smtp_transport_options_block, protocol) },
156 { "retry_include_ip_address", opt_expand_bool,
157 (void *)offsetof(smtp_transport_options_block, retry_include_ip_address) },
158 { "serialize_hosts", opt_stringptr,
159 (void *)offsetof(smtp_transport_options_block, serialize_hosts) },
160 { "size_addition", opt_int,
161 (void *)offsetof(smtp_transport_options_block, size_addition) }
162 #ifdef EXPERIMENTAL_SOCKS
163 ,{ "socks_proxy", opt_stringptr,
164 (void *)offsetof(smtp_transport_options_block, socks_proxy) }
167 ,{ "tls_certificate", opt_stringptr,
168 (void *)offsetof(smtp_transport_options_block, tls_certificate) },
169 { "tls_crl", opt_stringptr,
170 (void *)offsetof(smtp_transport_options_block, tls_crl) },
171 { "tls_dh_min_bits", opt_int,
172 (void *)offsetof(smtp_transport_options_block, tls_dh_min_bits) },
173 { "tls_privatekey", opt_stringptr,
174 (void *)offsetof(smtp_transport_options_block, tls_privatekey) },
175 { "tls_require_ciphers", opt_stringptr,
176 (void *)offsetof(smtp_transport_options_block, tls_require_ciphers) },
177 { "tls_sni", opt_stringptr,
178 (void *)offsetof(smtp_transport_options_block, tls_sni) },
179 { "tls_tempfail_tryclear", opt_bool,
180 (void *)offsetof(smtp_transport_options_block, tls_tempfail_tryclear) },
181 { "tls_try_verify_hosts", opt_stringptr,
182 (void *)offsetof(smtp_transport_options_block, tls_try_verify_hosts) },
183 { "tls_verify_cert_hostnames", opt_stringptr,
184 (void *)offsetof(smtp_transport_options_block,tls_verify_cert_hostnames)},
185 { "tls_verify_certificates", opt_stringptr,
186 (void *)offsetof(smtp_transport_options_block, tls_verify_certificates) },
187 { "tls_verify_hosts", opt_stringptr,
188 (void *)offsetof(smtp_transport_options_block, tls_verify_hosts) }
192 /* Size of the options list. An extern variable has to be used so that its
193 address can appear in the tables drtables.c. */
195 int smtp_transport_options_count =
196 sizeof(smtp_transport_options)/sizeof(optionlist);
198 /* Default private options block for the smtp transport. */
200 smtp_transport_options_block smtp_transport_option_defaults = {
202 NULL, /* fallback_hosts */
204 NULL, /* fallback_hostlist */
205 NULL, /* authenticated_sender */
206 US"$primary_hostname", /* helo_data */
207 NULL, /* interface */
209 US"smtp", /* protocol */
211 NULL, /* serialize_hosts */
212 NULL, /* hosts_try_auth */
213 NULL, /* hosts_require_auth */
214 #ifdef EXPERIMENTAL_DANE
215 NULL, /* hosts_try_dane */
216 NULL, /* hosts_require_dane */
219 US"*", /* hosts_try_prdr */
222 US"*", /* hosts_request_ocsp (except under DANE; tls_client_start()) */
223 NULL, /* hosts_require_ocsp */
225 NULL, /* hosts_require_tls */
226 NULL, /* hosts_avoid_tls */
227 NULL, /* hosts_verify_avoid_tls */
228 NULL, /* hosts_avoid_pipelining */
229 NULL, /* hosts_avoid_esmtp */
230 NULL, /* hosts_nopass_tls */
231 5*60, /* command_timeout */
232 5*60, /* connect_timeout; shorter system default overrides */
233 5*60, /* data timeout */
234 10*60, /* final timeout */
235 1024, /* size_addition */
236 5, /* hosts_max_try */
237 50, /* hosts_max_try_hardlimit */
238 TRUE, /* address_retry_include_sender */
239 FALSE, /* allow_localhost */
240 FALSE, /* authenticated_sender_force */
241 FALSE, /* gethostbyname */
242 TRUE, /* dns_qualify_single */
243 FALSE, /* dns_search_parents */
244 NULL, /* dnssec_request_domains */
245 NULL, /* dnssec_require_domains */
246 TRUE, /* delay_after_cutoff */
247 FALSE, /* hosts_override */
248 FALSE, /* hosts_randomize */
249 TRUE, /* keepalive */
250 FALSE, /* lmtp_ignore_quota */
251 NULL, /* expand_retry_include_ip_address */
252 TRUE /* retry_include_ip_address */
253 #ifdef EXPERIMENTAL_SOCKS
254 ,NULL /* socks_proxy */
257 ,NULL, /* tls_certificate */
259 NULL, /* tls_privatekey */
260 NULL, /* tls_require_ciphers */
261 NULL, /* gnutls_require_kx */
262 NULL, /* gnutls_require_mac */
263 NULL, /* gnutls_require_proto */
265 US"system", /* tls_verify_certificates */
266 EXIM_CLIENT_DH_DEFAULT_MIN_BITS,
267 /* tls_dh_min_bits */
268 TRUE, /* tls_tempfail_tryclear */
269 NULL, /* tls_verify_hosts */
270 US"*", /* tls_try_verify_hosts */
271 US"*" /* tls_verify_cert_hostnames */
274 ,NULL, /* dkim_canon */
275 NULL, /* dkim_domain */
276 NULL, /* dkim_private_key */
277 NULL, /* dkim_selector */
278 NULL, /* dkim_sign_headers */
279 NULL /* dkim_strict */
283 /* some DSN flags for use later */
285 static int rf_list[] = {rf_notify_never, rf_notify_success,
286 rf_notify_failure, rf_notify_delay };
288 static uschar *rf_names[] = { US"NEVER", US"SUCCESS", US"FAILURE", US"DELAY" };
294 static uschar *smtp_command; /* Points to last cmd for error messages */
295 static uschar *mail_command; /* Points to MAIL cmd for error messages */
296 static BOOL update_waiting; /* TRUE to update the "wait" database */
299 /*************************************************
300 * Setup entry point *
301 *************************************************/
303 /* This function is called when the transport is about to be used,
304 but before running it in a sub-process. It is used for two things:
306 (1) To set the fallback host list in addresses, when delivering.
307 (2) To pass back the interface, port, protocol, and other options, for use
308 during callout verification.
311 tblock pointer to the transport instance block
312 addrlist list of addresses about to be transported
313 tf if not NULL, pointer to block in which to return options
314 uid the uid that will be set (not used)
315 gid the gid that will be set (not used)
316 errmsg place for error message (not used)
318 Returns: OK always (FAIL, DEFER not used)
322 smtp_transport_setup(transport_instance *tblock, address_item *addrlist,
323 transport_feedback *tf, uid_t uid, gid_t gid, uschar **errmsg)
325 smtp_transport_options_block *ob =
326 (smtp_transport_options_block *)(tblock->options_block);
328 errmsg = errmsg; /* Keep picky compilers happy */
332 /* Pass back options if required. This interface is getting very messy. */
336 tf->interface = ob->interface;
338 tf->protocol = ob->protocol;
339 tf->hosts = ob->hosts;
340 tf->hosts_override = ob->hosts_override;
341 tf->hosts_randomize = ob->hosts_randomize;
342 tf->gethostbyname = ob->gethostbyname;
343 tf->qualify_single = ob->dns_qualify_single;
344 tf->search_parents = ob->dns_search_parents;
345 tf->helo_data = ob->helo_data;
348 /* Set the fallback host list for all the addresses that don't have fallback
349 host lists, provided that the local host wasn't present in the original host
352 if (!testflag(addrlist, af_local_host_removed))
354 for (; addrlist != NULL; addrlist = addrlist->next)
355 if (addrlist->fallback_hosts == NULL)
356 addrlist->fallback_hosts = ob->fallback_hostlist;
364 /*************************************************
365 * Initialization entry point *
366 *************************************************/
368 /* Called for each instance, after its options have been read, to
369 enable consistency checks to be done, or anything else that needs
372 Argument: pointer to the transport instance block
377 smtp_transport_init(transport_instance *tblock)
379 smtp_transport_options_block *ob =
380 (smtp_transport_options_block *)(tblock->options_block);
382 /* Retry_use_local_part defaults FALSE if unset */
384 if (tblock->retry_use_local_part == TRUE_UNSET)
385 tblock->retry_use_local_part = FALSE;
387 /* Set the default port according to the protocol */
389 if (ob->port == NULL)
390 ob->port = (strcmpic(ob->protocol, US"lmtp") == 0)? US"lmtp" :
391 (strcmpic(ob->protocol, US"smtps") == 0)? US"smtps" : US"smtp";
393 /* Set up the setup entry point, to be called before subprocesses for this
396 tblock->setup = smtp_transport_setup;
398 /* Complain if any of the timeouts are zero. */
400 if (ob->command_timeout <= 0 || ob->data_timeout <= 0 ||
401 ob->final_timeout <= 0)
402 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
403 "command, data, or final timeout value is zero for %s transport",
406 /* If hosts_override is set and there are local hosts, set the global
407 flag that stops verify from showing router hosts. */
409 if (ob->hosts_override && ob->hosts != NULL) tblock->overrides_hosts = TRUE;
411 /* If there are any fallback hosts listed, build a chain of host items
412 for them, but do not do any lookups at this time. */
414 host_build_hostlist(&(ob->fallback_hostlist), ob->fallback_hosts, FALSE);
417 if ( ob->gnutls_require_kx
418 || ob->gnutls_require_mac
419 || ob->gnutls_require_proto)
420 log_write(0, LOG_MAIN, "WARNING: smtp transport options"
421 " gnutls_require_kx, gnutls_require_mac and gnutls_require_protocols"
430 /*************************************************
431 * Set delivery info into all active addresses *
432 *************************************************/
434 /* Only addresses whose status is >= PENDING are relevant. A lesser
435 status means that an address is not currently being processed.
438 addrlist points to a chain of addresses
439 errno_value to put in each address's errno field
440 msg to put in each address's message field
441 rc to put in each address's transport_return field
442 pass_message if TRUE, set the "pass message" flag in the address
443 host if set, mark addrs as having used this host
445 If errno_value has the special value ERRNO_CONNECTTIMEOUT, ETIMEDOUT is put in
446 the errno field, and RTEF_CTOUT is ORed into the more_errno field, to indicate
447 this particular type of timeout.
453 set_errno(address_item *addrlist, int errno_value, uschar *msg, int rc,
454 BOOL pass_message, host_item * host)
458 if (errno_value == ERRNO_CONNECTTIMEOUT)
460 errno_value = ETIMEDOUT;
461 orvalue = RTEF_CTOUT;
463 for (addr = addrlist; addr != NULL; addr = addr->next)
464 if (addr->transport_return >= PENDING)
466 addr->basic_errno = errno_value;
467 addr->more_errno |= orvalue;
471 if (pass_message) setflag(addr, af_pass_message);
473 addr->transport_return = rc;
475 addr->host_used = host;
481 /*************************************************
482 * Check an SMTP response *
483 *************************************************/
485 /* This function is given an errno code and the SMTP response buffer
486 to analyse, together with the host identification for generating messages. It
487 sets an appropriate message and puts the first digit of the response code into
488 the yield variable. If no response was actually read, a suitable digit is
492 host the current host, to get its name for messages
493 errno_value pointer to the errno value
494 more_errno from the top address for use with ERRNO_FILTER_FAIL
495 buffer the SMTP response buffer
496 yield where to put a one-digit SMTP response code
497 message where to put an errror message
498 pass_message set TRUE if message is an SMTP response
500 Returns: TRUE if an SMTP "QUIT" command should be sent, else FALSE
504 check_response(host_item *host, int *errno_value, int more_errno,
505 uschar *buffer, int *yield, uschar **message, BOOL *pass_message)
509 if (smtp_use_pipelining &&
510 (Ustrcmp(smtp_command, "MAIL") == 0 ||
511 Ustrcmp(smtp_command, "RCPT") == 0 ||
512 Ustrcmp(smtp_command, "DATA") == 0))
515 *yield = '4'; /* Default setting is to give a temporary error */
517 /* Handle response timeout */
519 if (*errno_value == ETIMEDOUT)
521 *message = US string_sprintf("SMTP timeout after %s%s",
523 if (transport_count > 0)
524 *message = US string_sprintf("%s (%d bytes written)", *message,
529 /* Handle malformed SMTP response */
531 if (*errno_value == ERRNO_SMTPFORMAT)
533 const uschar *malfresp = string_printing(buffer);
534 while (isspace(*malfresp)) malfresp++;
535 *message = *malfresp == 0
536 ? string_sprintf("Malformed SMTP reply (an empty line) "
537 "in response to %s%s", pl, smtp_command)
538 : string_sprintf("Malformed SMTP reply in response to %s%s: %s",
539 pl, smtp_command, malfresp);
543 /* Handle a failed filter process error; can't send QUIT as we mustn't
546 if (*errno_value == ERRNO_FILTER_FAIL)
548 *message = US string_sprintf("transport filter process failed (%d)%s",
550 (more_errno == EX_EXECFAILED)? ": unable to execute command" : "");
554 /* Handle a failed add_headers expansion; can't send QUIT as we mustn't
557 if (*errno_value == ERRNO_CHHEADER_FAIL)
560 US string_sprintf("failed to expand headers_add or headers_remove: %s",
561 expand_string_message);
565 /* Handle failure to write a complete data block */
567 if (*errno_value == ERRNO_WRITEINCOMPLETE)
569 *message = US string_sprintf("failed to write a data block");
573 #ifdef EXPERIMENTAL_INTERNATIONAL
574 /* Handle lack of advertised SMTPUTF8, for international message */
575 if (*errno_value == ERRNO_UTF8_FWD)
577 *message = US string_sprintf("utf8 support required but not offered for forwarding");
578 DEBUG(D_deliver|D_transport) debug_printf("%s\n", *message);
583 /* Handle error responses from the remote mailer. */
587 const uschar *s = string_printing(buffer);
588 *message = US string_sprintf("SMTP error from remote mail server after %s%s: "
589 "%s", pl, smtp_command, s);
590 *pass_message = TRUE;
595 /* No data was read. If there is no errno, this must be the EOF (i.e.
596 connection closed) case, which causes deferral. An explicit connection reset
597 error has the same effect. Otherwise, put the host's identity in the message,
598 leaving the errno value to be interpreted as well. In all cases, we have to
599 assume the connection is now dead. */
601 if (*errno_value == 0 || *errno_value == ECONNRESET)
603 *errno_value = ERRNO_SMTPCLOSED;
604 *message = US string_sprintf("Remote host closed connection "
605 "in response to %s%s", pl, smtp_command);
607 else *message = US string_sprintf("%s [%s]", host->name, host->address);
614 /*************************************************
615 * Write error message to logs *
616 *************************************************/
618 /* This writes to the main log and to the message log.
621 addr the address item containing error information
622 host the current host
628 write_logs(address_item *addr, host_item *host)
630 uschar * message = string_sprintf("H=%s [%s]", host->name, host->address);
634 message = string_sprintf("%s: %s", message, addr->message);
635 if (addr->basic_errno > 0)
636 message = string_sprintf("%s: %s", message, strerror(addr->basic_errno));
637 log_write(0, LOG_MAIN, "%s", message);
638 deliver_msglog("%s %s\n", tod_stamp(tod_log), message);
642 if (log_extra_selector & LX_outgoing_port)
643 message = string_sprintf("%s:%d", message,
644 host->port == PORT_NONE ? 25 : host->port);
645 log_write(0, LOG_MAIN, "%s %s", message, strerror(addr->basic_errno));
646 deliver_msglog("%s %s %s\n", tod_stamp(tod_log), message,
647 strerror(addr->basic_errno));
652 msglog_line(host_item * host, uschar * message)
654 deliver_msglog("%s H=%s [%s] %s\n", tod_stamp(tod_log),
655 host->name, host->address, message);
660 #ifdef EXPERIMENTAL_EVENT
661 /*************************************************
662 * Post-defer action *
663 *************************************************/
665 /* This expands an arbitrary per-transport string.
666 It might, for example, be used to write to the database log.
669 addr the address item containing error information
670 host the current host
676 deferred_event_raise(address_item *addr, host_item *host)
678 uschar * action = addr->transport->event_action;
679 const uschar * save_domain;
685 save_domain = deliver_domain;
686 save_local = deliver_localpart;
688 /*XXX would ip & port already be set up? */
689 deliver_host_address = string_copy(host->address);
690 deliver_host_port = host->port == PORT_NONE ? 25 : host->port;
691 event_defer_errno = addr->basic_errno;
693 router_name = addr->router->name;
694 transport_name = addr->transport->name;
695 deliver_domain = addr->domain;
696 deliver_localpart = addr->local_part;
698 (void) event_raise(action, US"msg:host:defer",
700 ? addr->basic_errno > 0
701 ? string_sprintf("%s: %s", addr->message, strerror(addr->basic_errno))
702 : string_copy(addr->message)
703 : addr->basic_errno > 0
704 ? string_copy(US strerror(addr->basic_errno))
707 deliver_localpart = save_local;
708 deliver_domain = save_domain;
709 router_name = transport_name = NULL;
713 /*************************************************
714 * Synchronize SMTP responses *
715 *************************************************/
717 /* This function is called from smtp_deliver() to receive SMTP responses from
718 the server, and match them up with the commands to which they relate. When
719 PIPELINING is not in use, this function is called after every command, and is
720 therefore somewhat over-engineered, but it is simpler to use a single scheme
721 that works both with and without PIPELINING instead of having two separate sets
724 The set of commands that are buffered up with pipelining may start with MAIL
725 and may end with DATA; in between are RCPT commands that correspond to the
726 addresses whose status is PENDING_DEFER. All other commands (STARTTLS, AUTH,
727 etc.) are never buffered.
729 Errors after MAIL or DATA abort the whole process leaving the response in the
730 buffer. After MAIL, pending responses are flushed, and the original command is
731 re-instated in big_buffer for error messages. For RCPT commands, the remote is
732 permitted to reject some recipient addresses while accepting others. However
733 certain errors clearly abort the whole process. Set the value in
734 transport_return to PENDING_OK if the address is accepted. If there is a
735 subsequent general error, it will get reset accordingly. If not, it will get
736 converted to OK at the end.
739 addrlist the complete address list
740 include_affixes TRUE if affixes include in RCPT
741 sync_addr ptr to the ptr of the one to start scanning at (updated)
742 host the host we are connected to
743 count the number of responses to read
745 include_sender true if 4xx retry is to include the sender it its key
746 pending_MAIL true if the first response is for MAIL
747 pending_DATA 0 if last command sent was not DATA
748 +1 if previously had a good recipient
749 -1 if not previously had a good recipient
750 inblock incoming SMTP block
751 timeout timeout value
752 buffer buffer for reading response
753 buffsize size of buffer
755 Returns: 3 if at least one address had 2xx and one had 5xx
756 2 if at least one address had 5xx but none had 2xx
757 1 if at least one host had a 2xx response, but none had 5xx
758 0 no address had 2xx or 5xx but no errors (all 4xx, or just DATA)
759 -1 timeout while reading RCPT response
760 -2 I/O or other non-response error for RCPT
761 -3 DATA or MAIL failed - errno and buffer set
765 sync_responses(address_item *addrlist, BOOL include_affixes,
766 address_item **sync_addr, host_item *host, int count,
767 BOOL address_retry_include_sender, BOOL pending_MAIL,
768 int pending_DATA, smtp_inblock *inblock, int timeout, uschar *buffer,
771 address_item *addr = *sync_addr;
774 /* Handle the response for a MAIL command. On error, reinstate the original
775 command in big_buffer for error message use, and flush any further pending
776 responses before returning, except after I/O errors and timeouts. */
781 if (!smtp_read_response(inblock, buffer, buffsize, '2', timeout))
783 Ustrcpy(big_buffer, mail_command); /* Fits, because it came from there! */
784 if (errno == 0 && buffer[0] != 0)
786 uschar flushbuffer[4096];
788 if (buffer[0] == '4')
790 save_errno = ERRNO_MAIL4XX;
791 addr->more_errno |= ((buffer[1] - '0')*10 + buffer[2] - '0') << 8;
795 if (!smtp_read_response(inblock, flushbuffer, sizeof(flushbuffer),
797 && (errno != 0 || flushbuffer[0] == 0))
803 if (pending_DATA) count--; /* Number of RCPT responses to come */
804 while (count-- > 0) /* Mark any pending addrs with the host used */
806 while (addr->transport_return != PENDING_DEFER) addr = addr->next;
807 addr->host_used = host;
814 if (pending_DATA) count--; /* Number of RCPT responses to come */
816 /* Read and handle the required number of RCPT responses, matching each one up
817 with an address by scanning for the next address whose status is PENDING_DEFER.
822 while (addr->transport_return != PENDING_DEFER) addr = addr->next;
824 /* The address was accepted */
825 addr->host_used = host;
827 if (smtp_read_response(inblock, buffer, buffsize, '2', timeout))
830 addr->transport_return = PENDING_OK;
832 /* If af_dr_retry_exists is set, there was a routing delay on this address;
833 ensure that any address-specific retry record is expunged. We do this both
834 for the basic key and for the version that also includes the sender. */
836 if (testflag(addr, af_dr_retry_exists))
838 uschar *altkey = string_sprintf("%s:<%s>", addr->address_retry_key,
840 retry_add_item(addr, altkey, rf_delete);
841 retry_add_item(addr, addr->address_retry_key, rf_delete);
845 /* Timeout while reading the response */
847 else if (errno == ETIMEDOUT)
849 uschar *message = string_sprintf("SMTP timeout after RCPT TO:<%s>",
850 transport_rcpt_address(addr, include_affixes));
851 set_errno(addrlist, ETIMEDOUT, message, DEFER, FALSE, NULL);
852 retry_add_item(addr, addr->address_retry_key, 0);
853 update_waiting = FALSE;
857 /* Handle other errors in obtaining an SMTP response by returning -1. This
858 will cause all the addresses to be deferred. Restore the SMTP command in
859 big_buffer for which we are checking the response, so the error message
862 else if (errno != 0 || buffer[0] == 0)
864 string_format(big_buffer, big_buffer_size, "RCPT TO:<%s>",
865 transport_rcpt_address(addr, include_affixes));
869 /* Handle SMTP permanent and temporary response codes. */
874 string_sprintf("SMTP error from remote mail server after RCPT TO:<%s>: "
875 "%s", transport_rcpt_address(addr, include_affixes),
876 string_printing(buffer));
877 setflag(addr, af_pass_message);
878 msglog_line(host, addr->message);
880 /* The response was 5xx */
882 if (buffer[0] == '5')
884 addr->transport_return = FAIL;
888 /* The response was 4xx */
892 addr->transport_return = DEFER;
893 addr->basic_errno = ERRNO_RCPT4XX;
894 addr->more_errno |= ((buffer[1] - '0')*10 + buffer[2] - '0') << 8;
896 /* Log temporary errors if there are more hosts to be tried.
897 If not, log this last one in the == line. */
900 log_write(0, LOG_MAIN, "H=%s [%s]: %s", host->name, host->address, addr->message);
902 /* Do not put this message on the list of those waiting for specific
903 hosts, as otherwise it is likely to be tried too often. */
905 update_waiting = FALSE;
907 /* Add a retry item for the address so that it doesn't get tried again
908 too soon. If address_retry_include_sender is true, add the sender address
911 if (address_retry_include_sender)
913 uschar *altkey = string_sprintf("%s:<%s>", addr->address_retry_key,
915 retry_add_item(addr, altkey, 0);
917 else retry_add_item(addr, addr->address_retry_key, 0);
920 } /* Loop for next RCPT response */
922 /* Update where to start at for the next block of responses, unless we
923 have already handled all the addresses. */
925 if (addr != NULL) *sync_addr = addr->next;
927 /* Handle a response to DATA. If we have not had any good recipients, either
928 previously or in this block, the response is ignored. */
930 if (pending_DATA != 0 &&
931 !smtp_read_response(inblock, buffer, buffsize, '3', timeout))
936 if (pending_DATA > 0 || (yield & 1) != 0)
938 if (errno == 0 && buffer[0] == '4')
940 errno = ERRNO_DATA4XX;
941 addrlist->more_errno |= ((buffer[1] - '0')*10 + buffer[2] - '0') << 8;
945 (void)check_response(host, &errno, 0, buffer, &code, &msg, &pass_message);
946 DEBUG(D_transport) debug_printf("%s\nerror for DATA ignored: pipelining "
947 "is in use and there were no good recipients\n", msg);
950 /* All responses read and handled; MAIL (if present) received 2xx and DATA (if
951 present) received 3xx. If any RCPTs were handled and yielded anything other
952 than 4xx, yield will be set non-zero. */
959 /* Do the client side of smtp-level authentication */
962 buffer EHLO response from server (gets overwritten)
963 addrlist chain of potential addresses to deliver
964 host host to deliver to
966 ibp, obp comms channel control blocks
969 OK Success, or failed (but not required): global "smtp_authenticated" set
970 DEFER Failed authentication (and was required)
971 ERROR Internal problem
973 FAIL_SEND Failed communications - transmit
978 smtp_auth(uschar *buffer, unsigned bufsize, address_item *addrlist, host_item *host,
979 smtp_transport_options_block *ob, BOOL is_esmtp,
980 smtp_inblock *ibp, smtp_outblock *obp)
983 uschar *fail_reason = US"server did not advertise AUTH support";
985 smtp_authenticated = FALSE;
986 client_authenticator = client_authenticated_id = client_authenticated_sender = NULL;
987 require_auth = verify_check_given_host(&ob->hosts_require_auth, host);
989 if (is_esmtp && !regex_AUTH) regex_AUTH =
990 regex_must_compile(US"\\n250[\\s\\-]AUTH\\s+([\\-\\w\\s]+)(?:\\n|$)",
993 if (is_esmtp && regex_match_and_setup(regex_AUTH, buffer, 0, -1))
995 uschar *names = string_copyn(expand_nstring[1], expand_nlength[1]);
996 expand_nmax = -1; /* reset */
998 /* Must not do this check until after we have saved the result of the
999 regex match above. */
1001 if (require_auth == OK ||
1002 verify_check_given_host(&ob->hosts_try_auth, host) == OK)
1005 fail_reason = US"no common mechanisms were found";
1007 DEBUG(D_transport) debug_printf("scanning authentication mechanisms\n");
1009 /* Scan the configured authenticators looking for one which is configured
1010 for use as a client, which is not suppressed by client_condition, and
1011 whose name matches an authentication mechanism supported by the server.
1012 If one is found, attempt to authenticate by calling its client function.
1015 for (au = auths; !smtp_authenticated && au != NULL; au = au->next)
1019 (au->client_condition != NULL &&
1020 !expand_check_condition(au->client_condition, au->name,
1021 US"client authenticator")))
1023 DEBUG(D_transport) debug_printf("skipping %s authenticator: %s\n",
1025 (au->client)? "client_condition is false" :
1026 "not configured as a client");
1030 /* Loop to scan supported server mechanisms */
1035 int len = Ustrlen(au->public_name);
1036 while (isspace(*p)) p++;
1038 if (strncmpic(au->public_name, p, len) != 0 ||
1039 (p[len] != 0 && !isspace(p[len])))
1041 while (*p != 0 && !isspace(*p)) p++;
1045 /* Found data for a listed mechanism. Call its client entry. Set
1046 a flag in the outblock so that data is overwritten after sending so
1047 that reflections don't show it. */
1049 fail_reason = US"authentication attempt(s) failed";
1050 obp->authenticating = TRUE;
1051 rc = (au->info->clientcode)(au, ibp, obp,
1052 ob->command_timeout, buffer, bufsize);
1053 obp->authenticating = FALSE;
1054 DEBUG(D_transport) debug_printf("%s authenticator yielded %d\n",
1057 /* A temporary authentication failure must hold up delivery to
1058 this host. After a permanent authentication failure, we carry on
1059 to try other authentication methods. If all fail hard, try to
1060 deliver the message unauthenticated unless require_auth was set. */
1065 smtp_authenticated = TRUE; /* stops the outer loop */
1066 client_authenticator = au->name;
1067 if (au->set_client_id != NULL)
1068 client_authenticated_id = expand_string(au->set_client_id);
1071 /* Failure after writing a command */
1076 /* Failure after reading a response */
1079 if (errno != 0 || buffer[0] != '5') return FAIL;
1080 log_write(0, LOG_MAIN, "%s authenticator failed H=%s [%s] %s",
1081 au->name, host->name, host->address, buffer);
1084 /* Failure by some other means. In effect, the authenticator
1085 decided it wasn't prepared to handle this case. Typically this
1086 is the result of "fail" in an expansion string. Do we need to
1087 log anything here? Feb 2006: a message is now put in the buffer
1088 if logging is required. */
1092 log_write(0, LOG_MAIN, "%s authenticator cancelled "
1093 "authentication H=%s [%s] %s", au->name, host->name,
1094 host->address, buffer);
1097 /* Internal problem, message in buffer. */
1100 set_errno(addrlist, ERRNO_AUTHPROB, string_copy(buffer),
1101 DEFER, FALSE, NULL);
1105 break; /* If not authenticated, try next authenticator */
1106 } /* Loop for scanning supported server mechanisms */
1107 } /* Loop for further authenticators */
1111 /* If we haven't authenticated, but are required to, give up. */
1113 if (require_auth == OK && !smtp_authenticated)
1115 set_errno(addrlist, ERRNO_AUTHFAIL,
1116 string_sprintf("authentication required but %s", fail_reason), DEFER,
1125 /* Construct AUTH appendix string for MAIL TO */
1128 buffer to build string
1129 addrlist chain of potential addresses to deliver
1130 ob transport options
1132 Globals smtp_authenticated
1133 client_authenticated_sender
1134 Return True on error, otherwise buffer has (possibly empty) terminated string
1138 smtp_mail_auth_str(uschar *buffer, unsigned bufsize, address_item *addrlist,
1139 smtp_transport_options_block *ob)
1141 uschar *local_authenticated_sender = authenticated_sender;
1144 debug_printf("smtp_mail_auth_str: as<%s> os<%s> SA<%s>\n", authenticated_sender, ob->authenticated_sender, smtp_authenticated?"Y":"N");
1147 if (ob->authenticated_sender != NULL)
1149 uschar *new = expand_string(ob->authenticated_sender);
1152 if (!expand_string_forcedfail)
1154 uschar *message = string_sprintf("failed to expand "
1155 "authenticated_sender: %s", expand_string_message);
1156 set_errno(addrlist, ERRNO_EXPANDFAIL, message, DEFER, FALSE, NULL);
1160 else if (new[0] != 0) local_authenticated_sender = new;
1163 /* Add the authenticated sender address if present */
1165 if ((smtp_authenticated || ob->authenticated_sender_force) &&
1166 local_authenticated_sender != NULL)
1168 string_format(buffer, bufsize, " AUTH=%s",
1169 auth_xtextencode(local_authenticated_sender,
1170 Ustrlen(local_authenticated_sender)));
1171 client_authenticated_sender = string_copy(local_authenticated_sender);
1181 #ifdef EXPERIMENTAL_DANE
1183 tlsa_lookup(const host_item * host, dns_answer * dnsa,
1184 BOOL dane_required, BOOL * dane)
1186 /* move this out to host.c given the similarity to dns_lookup() ? */
1188 const uschar * fullname = buffer;
1190 /* TLSA lookup string */
1191 (void)sprintf(CS buffer, "_%d._tcp.%.256s", host->port, host->name);
1193 switch (dns_lookup(dnsa, buffer, T_TLSA, &fullname))
1196 return DEFER; /* just defer this TLS'd conn */
1202 log_write(0, LOG_MAIN, "DANE error: TLSA lookup failed");
1208 if (!dns_is_secure(dnsa))
1210 log_write(0, LOG_MAIN, "DANE error: TLSA lookup not DNSSEC");
1222 typedef struct smtp_compare_s
1224 uschar *current_sender_address;
1225 struct transport_instance *tblock;
1229 Create a unique string that identifies this message, it is based on
1230 sender_address, helo_data and tls_certificate if enabled. */
1233 smtp_local_identity(uschar * sender, struct transport_instance * tblock)
1235 address_item * addr1;
1236 uschar * if1 = US"";
1237 uschar * helo1 = US"";
1239 uschar * tlsc1 = US"";
1241 uschar * save_sender_address = sender_address;
1242 uschar * local_identity = NULL;
1243 smtp_transport_options_block * ob =
1244 (smtp_transport_options_block *)tblock->options_block;
1246 sender_address = sender;
1248 addr1 = deliver_make_addr (sender, TRUE);
1249 deliver_set_expansions(addr1);
1252 if1 = expand_string(ob->interface);
1255 helo1 = expand_string(ob->helo_data);
1258 if (ob->tls_certificate)
1259 tlsc1 = expand_string(ob->tls_certificate);
1260 local_identity = string_sprintf ("%s^%s^%s", if1, helo1, tlsc1);
1262 local_identity = string_sprintf ("%s^%s", if1, helo1);
1265 deliver_set_expansions(NULL);
1266 sender_address = save_sender_address;
1268 return local_identity;
1273 /* This routine is a callback that is called from transport_check_waiting.
1274 This function will evaluate the incoming message versus the previous
1275 message. If the incoming message is using a different local identity then
1276 we will veto this new message. */
1279 smtp_are_same_identities(uschar * message_id, smtp_compare_t * s_compare)
1281 uschar * save_sender_address = sender_address;
1282 uschar * current_local_identity =
1283 smtp_local_identity(s_compare->current_sender_address, s_compare->tblock);
1284 uschar * new_sender_address = deliver_get_sender_address(message_id);
1285 uschar * message_local_identity =
1286 smtp_local_identity(new_sender_address, s_compare->tblock);
1288 sender_address = save_sender_address;
1290 return Ustrcmp(current_local_identity, message_local_identity) == 0;
1295 /*************************************************
1296 * Deliver address list to given host *
1297 *************************************************/
1299 /* If continue_hostname is not null, we get here only when continuing to
1300 deliver down an existing channel. The channel was passed as the standard
1301 input. TLS is never active on a passed channel; the previous process always
1302 closes it down before passing the connection on.
1304 Otherwise, we have to make a connection to the remote host, and do the
1305 initial protocol exchange.
1307 When running as an MUA wrapper, if the sender or any recipient is rejected,
1308 temporarily or permanently, we force failure for all recipients.
1311 addrlist chain of potential addresses to deliver; only those whose
1312 transport_return field is set to PENDING_DEFER are currently
1313 being processed; others should be skipped - they have either
1314 been delivered to an earlier host or IP address, or been
1315 failed by one of them.
1316 host host to deliver to
1317 host_af AF_INET or AF_INET6
1318 port default TCP/IP port to use, in host byte order
1319 interface interface to bind to, or NULL
1320 tblock transport instance block
1321 message_defer set TRUE if yield is OK, but all addresses were deferred
1322 because of a non-recipient, non-host failure, that is, a
1323 4xx response to MAIL FROM, DATA, or ".". This is a defer
1324 that is specific to the message.
1325 suppress_tls if TRUE, don't attempt a TLS connection - this is set for
1326 a second attempt after TLS initialization fails
1328 Returns: OK - the connection was made and the delivery attempted;
1329 the result for each address is in its data block.
1330 DEFER - the connection could not be made, or something failed
1331 while setting up the SMTP session, or there was a
1332 non-message-specific error, such as a timeout.
1333 ERROR - a filter command is specified for this transport,
1334 and there was a problem setting it up; OR helo_data
1335 or add_headers or authenticated_sender is specified
1336 for this transport, and the string failed to expand
1340 smtp_deliver(address_item *addrlist, host_item *host, int host_af, int port,
1341 uschar *interface, transport_instance *tblock,
1342 BOOL *message_defer, BOOL suppress_tls)
1345 address_item *sync_addr;
1346 address_item *first_addr = addrlist;
1351 time_t start_delivery_time = time(NULL);
1352 smtp_transport_options_block *ob =
1353 (smtp_transport_options_block *)(tblock->options_block);
1354 BOOL lmtp = strcmpic(ob->protocol, US"lmtp") == 0;
1355 BOOL smtps = strcmpic(ob->protocol, US"smtps") == 0;
1357 BOOL send_rset = TRUE;
1358 BOOL send_quit = TRUE;
1359 BOOL setting_up = TRUE;
1360 BOOL completed_address = FALSE;
1363 BOOL pass_message = FALSE;
1364 #ifndef DISABLE_PRDR
1365 BOOL prdr_offered = FALSE;
1368 #ifdef EXPERIMENTAL_INTERNATIONAL
1369 BOOL utf8_offered = FALSE;
1371 BOOL dsn_all_lasthop = TRUE;
1372 #if defined(SUPPORT_TLS) && defined(EXPERIMENTAL_DANE)
1375 dns_answer tlsa_dnsa;
1377 smtp_inblock inblock;
1378 smtp_outblock outblock;
1379 int max_rcpt = tblock->max_addresses;
1380 uschar *igquotstr = US"";
1382 uschar *helo_data = NULL;
1384 uschar *message = NULL;
1385 uschar new_message_id[MESSAGE_ID_LENGTH + 1];
1387 uschar buffer[4096];
1388 uschar inbuffer[4096];
1389 uschar outbuffer[4096];
1390 address_item * current_address;
1392 suppress_tls = suppress_tls; /* stop compiler warning when no TLS support */
1394 *message_defer = FALSE;
1395 smtp_command = US"initial connection";
1396 if (max_rcpt == 0) max_rcpt = 999999;
1398 /* Set up the buffer for reading SMTP response packets. */
1400 inblock.buffer = inbuffer;
1401 inblock.buffersize = sizeof(inbuffer);
1402 inblock.ptr = inbuffer;
1403 inblock.ptrend = inbuffer;
1405 /* Set up the buffer for holding SMTP commands while pipelining */
1407 outblock.buffer = outbuffer;
1408 outblock.buffersize = sizeof(outbuffer);
1409 outblock.ptr = outbuffer;
1410 outblock.cmd_count = 0;
1411 outblock.authenticating = FALSE;
1413 /* Reset the parameters of a TLS session. */
1416 tls_out.cipher = NULL; /* the one we may use for this transport */
1417 tls_out.ourcert = NULL;
1418 tls_out.peercert = NULL;
1419 tls_out.peerdn = NULL;
1420 #if defined(SUPPORT_TLS) && !defined(USE_GNUTLS)
1423 tls_out.ocsp = OCSP_NOT_REQ;
1425 /* Flip the legacy TLS-related variables over to the outbound set in case
1426 they're used in the context of the transport. Don't bother resetting
1427 afterward as we're in a subprocess. */
1429 tls_modify_variables(&tls_out);
1434 set_errno(addrlist, ERRNO_TLSFAILURE, US"TLS support not available",
1435 DEFER, FALSE, NULL);
1440 /* Make a connection to the host if this isn't a continued delivery, and handle
1441 the initial interaction and HELO/EHLO/LHLO. Connect timeout errors are handled
1442 specially so they can be identified for retries. */
1444 if (continue_hostname == NULL)
1446 /* This puts port into host->port */
1447 inblock.sock = outblock.sock =
1448 smtp_connect(host, host_af, port, interface, ob->connect_timeout, tblock);
1450 if (inblock.sock < 0)
1452 set_errno(addrlist, (errno == ETIMEDOUT)? ERRNO_CONNECTTIMEOUT : errno,
1453 NULL, DEFER, FALSE, NULL);
1457 #if defined(SUPPORT_TLS) && defined(EXPERIMENTAL_DANE)
1459 tls_out.dane_verified = FALSE;
1460 tls_out.tlsa_usage = 0;
1462 dane_required = verify_check_given_host(&ob->hosts_require_dane, host) == OK;
1464 if (host->dnssec == DS_YES)
1467 || verify_check_given_host(&ob->hosts_try_dane, host) == OK
1469 && (rc = tlsa_lookup(host, &tlsa_dnsa, dane_required, &dane)) != OK
1473 else if (dane_required)
1475 log_write(0, LOG_MAIN, "DANE error: %s lookup not DNSSEC", host->name);
1480 ob->tls_tempfail_tryclear = FALSE;
1484 /* Expand the greeting message while waiting for the initial response. (Makes
1485 sense if helo_data contains ${lookup dnsdb ...} stuff). The expansion is
1486 delayed till here so that $sending_interface and $sending_port are set. */
1488 helo_data = expand_string(ob->helo_data);
1490 /* The first thing is to wait for an initial OK response. The dreaded "goto"
1491 is nevertheless a reasonably clean way of programming this kind of logic,
1492 where you want to escape on any error. */
1496 if (!smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
1497 ob->command_timeout)) goto RESPONSE_FAILED;
1499 #ifdef EXPERIMENTAL_EVENT
1502 lookup_dnssec_authenticated = host->dnssec==DS_YES ? US"yes"
1503 : host->dnssec==DS_NO ? US"no" : NULL;
1504 s = event_raise(tblock->event_action, US"smtp:connect", buffer);
1507 set_errno(addrlist, ERRNO_EXPANDFAIL,
1508 string_sprintf("deferred by smtp:connect event expansion: %s", s),
1509 DEFER, FALSE, NULL);
1516 /* Now check if the helo_data expansion went well, and sign off cleanly if
1519 if (helo_data == NULL)
1521 uschar *message = string_sprintf("failed to expand helo_data: %s",
1522 expand_string_message);
1523 set_errno(addrlist, ERRNO_EXPANDFAIL, message, DEFER, FALSE, NULL);
1529 /** Debugging without sending a message
1530 addrlist->transport_return = DEFER;
1534 /* Errors that occur after this point follow an SMTP command, which is
1535 left in big_buffer by smtp_write_command() for use in error messages. */
1537 smtp_command = big_buffer;
1539 /* Tell the remote who we are...
1541 February 1998: A convention has evolved that ESMTP-speaking MTAs include the
1542 string "ESMTP" in their greeting lines, so make Exim send EHLO if the
1543 greeting is of this form. The assumption was that the far end supports it
1544 properly... but experience shows that there are some that give 5xx responses,
1545 even though the banner includes "ESMTP" (there's a bloody-minded one that
1546 says "ESMTP not spoken here"). Cope with that case.
1548 September 2000: Time has passed, and it seems reasonable now to always send
1549 EHLO at the start. It is also convenient to make the change while installing
1552 July 2003: Joachim Wieland met a broken server that advertises "PIPELINING"
1553 but times out after sending MAIL FROM, RCPT TO and DATA all together. There
1554 would be no way to send out the mails, so there is now a host list
1555 "hosts_avoid_esmtp" that disables ESMTP for special hosts and solves the
1556 PIPELINING problem as well. Maybe it can also be useful to cure other
1557 problems with broken servers.
1559 Exim originally sent "Helo" at this point and ran for nearly a year that way.
1560 Then somebody tried it with a Microsoft mailer... It seems that all other
1561 mailers use upper case for some reason (the RFC is quite clear about case
1562 independence) so, for peace of mind, I gave in. */
1564 esmtp = verify_check_given_host(&ob->hosts_avoid_esmtp, host) != OK;
1566 /* Alas; be careful, since this goto is not an error-out, so conceivably
1567 we might set data between here and the target which we assume to exist
1568 and be usable. I can see this coming back to bite us. */
1573 suppress_tls = FALSE;
1574 ob->tls_tempfail_tryclear = FALSE;
1575 smtp_command = US"SSL-on-connect";
1582 if (smtp_write_command(&outblock, FALSE, "%s %s\r\n",
1583 lmtp? "LHLO" : "EHLO", helo_data) < 0)
1585 if (!smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
1586 ob->command_timeout))
1588 if (errno != 0 || buffer[0] == 0 || lmtp) goto RESPONSE_FAILED;
1595 debug_printf("not sending EHLO (host matches hosts_avoid_esmtp)\n");
1600 if (smtp_write_command(&outblock, FALSE, "HELO %s\r\n", helo_data) < 0)
1602 if (!smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
1603 ob->command_timeout)) goto RESPONSE_FAILED;
1606 /* Set IGNOREQUOTA if the response to LHLO specifies support and the
1607 lmtp_ignore_quota option was set. */
1609 igquotstr = (lmtp && ob->lmtp_ignore_quota &&
1610 pcre_exec(regex_IGNOREQUOTA, NULL, CS buffer, Ustrlen(CS buffer), 0,
1611 PCRE_EOPT, NULL, 0) >= 0)? US" IGNOREQUOTA" : US"";
1613 /* Set tls_offered if the response to EHLO specifies support for STARTTLS. */
1616 tls_offered = esmtp &&
1617 pcre_exec(regex_STARTTLS, NULL, CS buffer, Ustrlen(buffer), 0,
1618 PCRE_EOPT, NULL, 0) >= 0;
1621 #ifndef DISABLE_PRDR
1622 prdr_offered = esmtp
1623 && pcre_exec(regex_PRDR, NULL, CS buffer, Ustrlen(buffer), 0,
1624 PCRE_EOPT, NULL, 0) >= 0
1625 && verify_check_given_host(&ob->hosts_try_prdr, host) == OK;
1628 {DEBUG(D_transport) debug_printf("PRDR usable\n");}
1631 #ifdef EXPERIMENTAL_INTERNATIONAL
1632 utf8_offered = esmtp
1633 && addrlist->prop.utf8
1634 && pcre_exec(regex_UTF8, NULL, CS buffer, Ustrlen(buffer), 0,
1635 PCRE_EOPT, NULL, 0) >= 0;
1639 /* For continuing deliveries down the same channel, the socket is the standard
1640 input, and we don't need to redo EHLO here (but may need to do so for TLS - see
1641 below). Set up the pointer to where subsequent commands will be left, for
1642 error messages. Note that smtp_use_size and smtp_use_pipelining will have been
1643 set from the command line if they were set in the process that passed the
1648 inblock.sock = outblock.sock = fileno(stdin);
1649 smtp_command = big_buffer;
1650 host->port = port; /* Record the port that was used */
1653 /* If TLS is available on this connection, whether continued or not, attempt to
1654 start up a TLS session, unless the host is in hosts_avoid_tls. If successful,
1655 send another EHLO - the server may give a different answer in secure mode. We
1656 use a separate buffer for reading the response to STARTTLS so that if it is
1657 negative, the original EHLO data is available for subsequent analysis, should
1658 the client not be required to use TLS. If the response is bad, copy the buffer
1659 for error analysis. */
1664 && verify_check_given_host(&ob->hosts_avoid_tls, host) != OK)
1666 uschar buffer2[4096];
1667 if (smtp_write_command(&outblock, FALSE, "STARTTLS\r\n") < 0)
1670 /* If there is an I/O error, transmission of this message is deferred. If
1671 there is a temporary rejection of STARRTLS and tls_tempfail_tryclear is
1672 false, we also defer. However, if there is a temporary rejection of STARTTLS
1673 and tls_tempfail_tryclear is true, or if there is an outright rejection of
1674 STARTTLS, we carry on. This means we will try to send the message in clear,
1675 unless the host is in hosts_require_tls (tested below). */
1677 if (!smtp_read_response(&inblock, buffer2, sizeof(buffer2), '2',
1678 ob->command_timeout))
1680 if (errno != 0 || buffer2[0] == 0 ||
1681 (buffer2[0] == '4' && !ob->tls_tempfail_tryclear))
1683 Ustrncpy(buffer, buffer2, sizeof(buffer));
1684 goto RESPONSE_FAILED;
1688 /* STARTTLS accepted: try to negotiate a TLS session. */
1693 int rc = tls_client_start(inblock.sock, host, addrlist, tblock
1694 # ifdef EXPERIMENTAL_DANE
1695 , dane ? &tlsa_dnsa : NULL
1699 /* TLS negotiation failed; give an error. From outside, this function may
1700 be called again to try in clear on a new connection, if the options permit
1701 it for this host. */
1705 # ifdef EXPERIMENTAL_DANE
1706 if (rc == DEFER && dane && !dane_required)
1708 log_write(0, LOG_MAIN, "DANE attempt failed;"
1709 " trying CA-root TLS to %s [%s] (not in hosts_require_dane)",
1710 host->name, host->address);
1716 save_errno = ERRNO_TLSFAILURE;
1717 message = US"failure while setting up TLS session";
1722 /* TLS session is set up */
1724 for (addr = addrlist; addr != NULL; addr = addr->next)
1725 if (addr->transport_return == PENDING_DEFER)
1727 addr->cipher = tls_out.cipher;
1728 addr->ourcert = tls_out.ourcert;
1729 addr->peercert = tls_out.peercert;
1730 addr->peerdn = tls_out.peerdn;
1731 addr->ocsp = tls_out.ocsp;
1736 /* if smtps, we'll have smtp_command set to something else; always safe to
1738 smtp_command = big_buffer;
1740 /* If we started TLS, redo the EHLO/LHLO exchange over the secure channel. If
1741 helo_data is null, we are dealing with a connection that was passed from
1742 another process, and so we won't have expanded helo_data above. We have to
1743 expand it here. $sending_ip_address and $sending_port are set up right at the
1744 start of the Exim process (in exim.c). */
1746 if (tls_out.active >= 0)
1749 if (helo_data == NULL)
1751 helo_data = expand_string(ob->helo_data);
1752 if (helo_data == NULL)
1754 uschar *message = string_sprintf("failed to expand helo_data: %s",
1755 expand_string_message);
1756 set_errno(addrlist, ERRNO_EXPANDFAIL, message, DEFER, FALSE, NULL);
1762 /* For SMTPS we need to wait for the initial OK response. */
1765 if (!smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
1766 ob->command_timeout)) goto RESPONSE_FAILED;
1770 greeting_cmd = "EHLO";
1773 greeting_cmd = "HELO";
1775 debug_printf("not sending EHLO (host matches hosts_avoid_esmtp)\n");
1778 if (smtp_write_command(&outblock, FALSE, "%s %s\r\n",
1779 lmtp? "LHLO" : greeting_cmd, helo_data) < 0)
1781 if (!smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
1782 ob->command_timeout))
1783 goto RESPONSE_FAILED;
1786 /* If the host is required to use a secure channel, ensure that we
1790 # ifdef EXPERIMENTAL_DANE
1793 verify_check_given_host(&ob->hosts_require_tls, host) == OK
1796 save_errno = ERRNO_TLSREQUIRED;
1797 message = string_sprintf("a TLS session is required, but %s",
1798 tls_offered? "an attempt to start TLS failed" :
1799 "the server did not offer TLS support");
1802 #endif /*SUPPORT_TLS*/
1804 /* If TLS is active, we have just started it up and re-done the EHLO command,
1805 so its response needs to be analyzed. If TLS is not active and this is a
1806 continued session down a previously-used socket, we haven't just done EHLO, so
1809 if (continue_hostname == NULL
1811 || tls_out.active >= 0
1815 /* Set for IGNOREQUOTA if the response to LHLO specifies support and the
1816 lmtp_ignore_quota option was set. */
1818 igquotstr = (lmtp && ob->lmtp_ignore_quota &&
1819 pcre_exec(regex_IGNOREQUOTA, NULL, CS buffer, Ustrlen(CS buffer), 0,
1820 PCRE_EOPT, NULL, 0) >= 0)? US" IGNOREQUOTA" : US"";
1822 /* If the response to EHLO specified support for the SIZE parameter, note
1823 this, provided size_addition is non-negative. */
1825 smtp_use_size = esmtp && ob->size_addition >= 0 &&
1826 pcre_exec(regex_SIZE, NULL, CS buffer, Ustrlen(CS buffer), 0,
1827 PCRE_EOPT, NULL, 0) >= 0;
1829 /* Note whether the server supports PIPELINING. If hosts_avoid_esmtp matched
1830 the current host, esmtp will be false, so PIPELINING can never be used. If
1831 the current host matches hosts_avoid_pipelining, don't do it. */
1833 smtp_use_pipelining = esmtp
1834 && verify_check_given_host(&ob->hosts_avoid_pipelining, host) != OK
1835 && pcre_exec(regex_PIPELINING, NULL, CS buffer, Ustrlen(CS buffer), 0,
1836 PCRE_EOPT, NULL, 0) >= 0;
1838 DEBUG(D_transport) debug_printf("%susing PIPELINING\n",
1839 smtp_use_pipelining? "" : "not ");
1841 #ifndef DISABLE_PRDR
1842 prdr_offered = esmtp
1843 && pcre_exec(regex_PRDR, NULL, CS buffer, Ustrlen(CS buffer), 0,
1844 PCRE_EOPT, NULL, 0) >= 0
1845 && verify_check_given_host(&ob->hosts_try_prdr, host) == OK;
1848 {DEBUG(D_transport) debug_printf("PRDR usable\n");}
1851 #ifdef EXPERIMENTAL_INTERNATIONAL
1852 utf8_offered = esmtp
1853 && addrlist->prop.utf8
1854 && pcre_exec(regex_UTF8, NULL, CS buffer, Ustrlen(buffer), 0,
1855 PCRE_EOPT, NULL, 0) >= 0;
1858 /* Note if the server supports DSN */
1859 smtp_use_dsn = esmtp
1860 && pcre_exec(regex_DSN, NULL, CS buffer, Ustrlen(CS buffer), 0,
1861 PCRE_EOPT, NULL, 0) >= 0;
1862 DEBUG(D_transport) debug_printf("use_dsn=%d\n", smtp_use_dsn);
1864 /* Note if the response to EHLO specifies support for the AUTH extension.
1865 If it has, check that this host is one we want to authenticate to, and do
1866 the business. The host name and address must be available when the
1867 authenticator's client driver is running. */
1869 switch (yield = smtp_auth(buffer, sizeof(buffer), addrlist, host,
1870 ob, esmtp, &inblock, &outblock))
1872 default: goto SEND_QUIT;
1874 case FAIL_SEND: goto SEND_FAILED;
1875 case FAIL: goto RESPONSE_FAILED;
1879 /* The setting up of the SMTP call is now complete. Any subsequent errors are
1880 message-specific. */
1884 #ifdef EXPERIMENTAL_INTERNATIONAL
1885 /* If this is an international message we need the host to speak SMTPUTF8 */
1886 if (addrlist->prop.utf8 && !utf8_offered)
1888 errno = ERRNO_UTF8_FWD;
1889 goto RESPONSE_FAILED;
1893 /* If there is a filter command specified for this transport, we can now
1894 set it up. This cannot be done until the identify of the host is known. */
1896 if (tblock->filter_command != NULL)
1900 sprintf(CS buffer, "%.50s transport", tblock->name);
1901 rc = transport_set_up_command(&transport_filter_argv, tblock->filter_command,
1902 TRUE, DEFER, addrlist, buffer, NULL);
1903 transport_filter_timeout = tblock->filter_timeout;
1905 /* On failure, copy the error to all addresses, abandon the SMTP call, and
1910 set_errno(addrlist->next, addrlist->basic_errno, addrlist->message, DEFER,
1918 /* For messages that have more than the maximum number of envelope recipients,
1919 we want to send several transactions down the same SMTP connection. (See
1920 comments in deliver.c as to how this reconciles, heuristically, with
1921 remote_max_parallel.) This optimization was added to Exim after the following
1922 code was already working. The simplest way to put it in without disturbing the
1923 code was to use a goto to jump back to this point when there is another
1924 transaction to handle. */
1927 sync_addr = first_addr;
1931 completed_address = FALSE;
1934 /* Initiate a message transfer. If we know the receiving MTA supports the SIZE
1935 qualification, send it, adding something to the message size to allow for
1936 imprecision and things that get added en route. Exim keeps the number of lines
1937 in a message, so we can give an accurate value for the original message, but we
1938 need some additional to handle added headers. (Double "." characters don't get
1939 included in the count.) */
1946 sprintf(CS p, " SIZE=%d", message_size+message_linecount+ob->size_addition);
1950 #ifndef DISABLE_PRDR
1951 prdr_active = FALSE;
1954 for (addr = first_addr; addr; addr = addr->next)
1955 if (addr->transport_return == PENDING_DEFER)
1957 for (addr = addr->next; addr; addr = addr->next)
1958 if (addr->transport_return == PENDING_DEFER)
1959 { /* at least two recipients to send */
1961 sprintf(CS p, " PRDR"); p += 5;
1969 #ifdef EXPERIMENTAL_INTERNATIONAL
1970 if (addrlist->prop.utf8)
1971 sprintf(CS p, " SMTPUTF8"), p += 9;
1974 /* check if all addresses have lasthop flag */
1975 /* do not send RET and ENVID if true */
1976 for (dsn_all_lasthop = TRUE, addr = first_addr;
1977 address_count < max_rcpt && addr != NULL;
1979 if ((addr->dsn_flags & rf_dsnlasthop) != 1)
1981 dsn_all_lasthop = FALSE;
1985 /* Add any DSN flags to the mail command */
1987 if (smtp_use_dsn && !dsn_all_lasthop)
1989 if (dsn_ret == dsn_ret_hdrs)
1991 Ustrcpy(p, " RET=HDRS");
1994 else if (dsn_ret == dsn_ret_full)
1996 Ustrcpy(p, " RET=FULL");
1999 if (dsn_envid != NULL)
2001 string_format(p, sizeof(buffer) - (p-buffer), " ENVID=%s", dsn_envid);
2006 /* If an authenticated_sender override has been specified for this transport
2007 instance, expand it. If the expansion is forced to fail, and there was already
2008 an authenticated_sender for this message, the original value will be used.
2009 Other expansion failures are serious. An empty result is ignored, but there is
2010 otherwise no check - this feature is expected to be used with LMTP and other
2011 cases where non-standard addresses (e.g. without domains) might be required. */
2013 if (smtp_mail_auth_str(p, sizeof(buffer) - (p-buffer), addrlist, ob))
2019 /* From here until we send the DATA command, we can make use of PIPELINING
2020 if the server host supports it. The code has to be able to check the responses
2021 at any point, for when the buffer fills up, so we write it totally generally.
2022 When PIPELINING is off, each command written reports that it has flushed the
2025 pending_MAIL = TRUE; /* The block starts with MAIL */
2027 rc = smtp_write_command(&outblock, smtp_use_pipelining,
2028 "MAIL FROM:<%s>%s\r\n", return_path, buffer);
2029 mail_command = string_copy(big_buffer); /* Save for later error message */
2033 case -1: /* Transmission error */
2036 case +1: /* Block was sent */
2037 if (!smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
2038 ob->command_timeout))
2040 if (errno == 0 && buffer[0] == '4')
2042 errno = ERRNO_MAIL4XX;
2043 addrlist->more_errno |= ((buffer[1] - '0')*10 + buffer[2] - '0') << 8;
2045 goto RESPONSE_FAILED;
2047 pending_MAIL = FALSE;
2051 /* Pass over all the relevant recipient addresses for this host, which are the
2052 ones that have status PENDING_DEFER. If we are using PIPELINING, we can send
2053 several before we have to read the responses for those seen so far. This
2054 checking is done by a subroutine because it also needs to be done at the end.
2055 Send only up to max_rcpt addresses at a time, leaving first_addr pointing to
2056 the next one if not all are sent.
2058 In the MUA wrapper situation, we want to flush the PIPELINING buffer for the
2059 last address because we want to abort if any recipients have any kind of
2060 problem, temporary or permanent. We know that all recipient addresses will have
2061 the PENDING_DEFER status, because only one attempt is ever made, and we know
2062 that max_rcpt will be large, so all addresses will be done at once. */
2064 for (addr = first_addr;
2065 address_count < max_rcpt && addr != NULL;
2071 addr->dsn_aware = smtp_use_dsn ? dsn_support_yes : dsn_support_no;
2073 if (addr->transport_return != PENDING_DEFER) continue;
2076 no_flush = smtp_use_pipelining && (!mua_wrapper || addr->next != NULL);
2078 /* Add any DSN flags to the rcpt command and add to the sent string */
2083 if (smtp_use_dsn && (addr->dsn_flags & rf_dsnlasthop) != 1)
2085 if ((addr->dsn_flags & rf_dsnflags) != 0)
2089 Ustrcpy(p, " NOTIFY=");
2091 for (i = 0; i < 4; i++)
2092 if ((addr->dsn_flags & rf_list[i]) != 0)
2094 if (!first) *p++ = ',';
2096 Ustrcpy(p, rf_names[i]);
2101 if (addr->dsn_orcpt != NULL)
2103 string_format(p, sizeof(buffer) - (p-buffer), " ORCPT=%s",
2109 /* Now send the RCPT command, and process outstanding responses when
2110 necessary. After a timeout on RCPT, we just end the function, leaving the
2111 yield as OK, because this error can often mean that there is a problem with
2112 just one address, so we don't want to delay the host. */
2114 count = smtp_write_command(&outblock, no_flush, "RCPT TO:<%s>%s%s\r\n",
2115 transport_rcpt_address(addr, tblock->rcpt_include_affixes), igquotstr, buffer);
2117 if (count < 0) goto SEND_FAILED;
2120 switch(sync_responses(first_addr, tblock->rcpt_include_affixes,
2121 &sync_addr, host, count, ob->address_retry_include_sender,
2122 pending_MAIL, 0, &inblock, ob->command_timeout, buffer,
2125 case 3: ok = TRUE; /* 2xx & 5xx => OK & progress made */
2126 case 2: completed_address = TRUE; /* 5xx (only) => progress made */
2129 case 1: ok = TRUE; /* 2xx (only) => OK, but if LMTP, */
2130 if (!lmtp) completed_address = TRUE; /* can't tell about progress yet */
2131 case 0: /* No 2xx or 5xx, but no probs */
2134 case -1: goto END_OFF; /* Timeout on RCPT */
2135 default: goto RESPONSE_FAILED; /* I/O error, or any MAIL error */
2137 pending_MAIL = FALSE; /* Dealt with MAIL */
2139 } /* Loop for next address */
2141 /* If we are an MUA wrapper, abort if any RCPTs were rejected, either
2142 permanently or temporarily. We should have flushed and synced after the last
2147 address_item *badaddr;
2148 for (badaddr = first_addr; badaddr; badaddr = badaddr->next)
2149 if (badaddr->transport_return != PENDING_OK)
2151 /*XXX could we find a better errno than 0 here? */
2152 set_errno(addrlist, 0, badaddr->message, FAIL,
2153 testflag(badaddr, af_pass_message), NULL);
2159 /* If ok is TRUE, we know we have got at least one good recipient, and must now
2160 send DATA, but if it is FALSE (in the normal, non-wrapper case), we may still
2161 have a good recipient buffered up if we are pipelining. We don't want to waste
2162 time sending DATA needlessly, so we only send it if either ok is TRUE or if we
2163 are pipelining. The responses are all handled by sync_responses(). */
2165 if (ok || (smtp_use_pipelining && !mua_wrapper))
2167 int count = smtp_write_command(&outblock, FALSE, "DATA\r\n");
2168 if (count < 0) goto SEND_FAILED;
2169 switch(sync_responses(first_addr, tblock->rcpt_include_affixes, &sync_addr,
2170 host, count, ob->address_retry_include_sender, pending_MAIL,
2171 ok? +1 : -1, &inblock, ob->command_timeout, buffer, sizeof(buffer)))
2173 case 3: ok = TRUE; /* 2xx & 5xx => OK & progress made */
2174 case 2: completed_address = TRUE; /* 5xx (only) => progress made */
2177 case 1: ok = TRUE; /* 2xx (only) => OK, but if LMTP, */
2178 if (!lmtp) completed_address = TRUE; /* can't tell about progress yet */
2179 case 0: break; /* No 2xx or 5xx, but no probs */
2181 case -1: goto END_OFF; /* Timeout on RCPT */
2182 default: goto RESPONSE_FAILED; /* I/O error, or any MAIL/DATA error */
2186 /* Save the first address of the next batch. */
2190 /* If there were no good recipients (but otherwise there have been no
2191 problems), just set ok TRUE, since we have handled address-specific errors
2192 already. Otherwise, it's OK to send the message. Use the check/escape mechanism
2193 for handling the SMTP dot-handling protocol, flagging to apply to headers as
2194 well as body. Set the appropriate timeout value to be used for each chunk.
2195 (Haven't been able to make it work using select() for writing yet.) */
2197 if (!ok) ok = TRUE; else
2199 sigalrm_seen = FALSE;
2200 transport_write_timeout = ob->data_timeout;
2201 smtp_command = US"sending data block"; /* For error messages */
2202 DEBUG(D_transport|D_v)
2203 debug_printf(" SMTP>> writing message and terminating \".\"\n");
2204 transport_count = 0;
2206 #ifndef DISABLE_DKIM
2207 ok = dkim_transport_write_message(addrlist, inblock.sock,
2208 topt_use_crlf | topt_end_dot | topt_escape_headers |
2209 (tblock->body_only? topt_no_headers : 0) |
2210 (tblock->headers_only? topt_no_body : 0) |
2211 (tblock->return_path_add? topt_add_return_path : 0) |
2212 (tblock->delivery_date_add? topt_add_delivery_date : 0) |
2213 (tblock->envelope_to_add? topt_add_envelope_to : 0),
2214 0, /* No size limit */
2215 tblock->add_headers, tblock->remove_headers,
2216 US".", US"..", /* Escaping strings */
2217 tblock->rewrite_rules, tblock->rewrite_existflags,
2218 ob->dkim_private_key, ob->dkim_domain, ob->dkim_selector,
2219 ob->dkim_canon, ob->dkim_strict, ob->dkim_sign_headers
2222 ok = transport_write_message(addrlist, inblock.sock,
2223 topt_use_crlf | topt_end_dot | topt_escape_headers |
2224 (tblock->body_only? topt_no_headers : 0) |
2225 (tblock->headers_only? topt_no_body : 0) |
2226 (tblock->return_path_add? topt_add_return_path : 0) |
2227 (tblock->delivery_date_add? topt_add_delivery_date : 0) |
2228 (tblock->envelope_to_add? topt_add_envelope_to : 0),
2229 0, /* No size limit */
2230 tblock->add_headers, tblock->remove_headers,
2231 US".", US"..", /* Escaping strings */
2232 tblock->rewrite_rules, tblock->rewrite_existflags);
2235 /* transport_write_message() uses write() because it is called from other
2236 places to write to non-sockets. This means that under some OS (e.g. Solaris)
2237 it can exit with "Broken pipe" as its error. This really means that the
2238 socket got closed at the far end. */
2240 transport_write_timeout = 0; /* for subsequent transports */
2242 /* Failure can either be some kind of I/O disaster (including timeout),
2243 or the failure of a transport filter or the expansion of added headers. */
2247 buffer[0] = 0; /* There hasn't been a response */
2248 goto RESPONSE_FAILED;
2251 /* We used to send the terminating "." explicitly here, but because of
2252 buffering effects at both ends of TCP/IP connections, you don't gain
2253 anything by keeping it separate, so it might as well go in the final
2254 data buffer for efficiency. This is now done by setting the topt_end_dot
2257 smtp_command = US"end of data";
2259 #ifndef DISABLE_PRDR
2260 /* For PRDR we optionally get a partial-responses warning
2261 * followed by the individual responses, before going on with
2262 * the overall response. If we don't get the warning then deal
2263 * with per non-PRDR. */
2266 ok = smtp_read_response(&inblock, buffer, sizeof(buffer), '3',
2268 if (!ok && errno == 0)
2271 case '2': prdr_active = FALSE;
2274 case '4': errno = ERRNO_DATA4XX;
2275 addrlist->more_errno |= ((buffer[1] - '0')*10 + buffer[2] - '0') << 8;
2282 /* For non-PRDR SMTP, we now read a single response that applies to the
2283 whole message. If it is OK, then all the addresses have been delivered. */
2287 ok = smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
2289 if (!ok && errno == 0 && buffer[0] == '4')
2291 errno = ERRNO_DATA4XX;
2292 addrlist->more_errno |= ((buffer[1] - '0')*10 + buffer[2] - '0') << 8;
2296 /* For LMTP, we get back a response for every RCPT command that we sent;
2297 some may be accepted and some rejected. For those that get a response, their
2298 status is fixed; any that are accepted have been handed over, even if later
2299 responses crash - at least, that's how I read RFC 2033.
2301 If all went well, mark the recipient addresses as completed, record which
2302 host/IPaddress they were delivered to, and cut out RSET when sending another
2303 message down the same channel. Write the completed addresses to the journal
2304 now so that they are recorded in case there is a crash of hardware or
2305 software before the spool gets updated. Also record the final SMTP
2306 confirmation if needed (for SMTP only). */
2311 int delivery_time = (int)(time(NULL) - start_delivery_time);
2313 uschar *conf = NULL;
2316 /* Set up confirmation if needed - applies only to SMTP */
2319 #ifndef EXPERIMENTAL_EVENT
2320 (log_extra_selector & LX_smtp_confirmation) != 0 &&
2325 const uschar *s = string_printing(buffer);
2326 /* deconst cast ok here as string_printing was checked to have alloc'n'copied */
2327 conf = (s == buffer)? (uschar *)string_copy(s) : US s;
2330 /* Process all transported addresses - for LMTP or PRDR, read a status for
2333 for (addr = addrlist; addr != first_addr; addr = addr->next)
2335 if (addr->transport_return != PENDING_OK) continue;
2337 /* LMTP - if the response fails badly (e.g. timeout), use it for all the
2338 remaining addresses. Otherwise, it's a return code for just the one
2339 address. For temporary errors, add a retry item for the address so that
2340 it doesn't get tried again too soon. */
2342 #ifndef DISABLE_PRDR
2343 if (lmtp || prdr_active)
2348 if (!smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
2351 if (errno != 0 || buffer[0] == 0) goto RESPONSE_FAILED;
2352 addr->message = string_sprintf(
2353 #ifndef DISABLE_PRDR
2354 "%s error after %s: %s", prdr_active ? "PRDR":"LMTP",
2356 "LMTP error after %s: %s",
2358 big_buffer, string_printing(buffer));
2359 setflag(addr, af_pass_message); /* Allow message to go to user */
2360 if (buffer[0] == '5')
2361 addr->transport_return = FAIL;
2364 errno = ERRNO_DATA4XX;
2365 addr->more_errno |= ((buffer[1] - '0')*10 + buffer[2] - '0') << 8;
2366 addr->transport_return = DEFER;
2367 #ifndef DISABLE_PRDR
2370 retry_add_item(addr, addr->address_retry_key, 0);
2374 completed_address = TRUE; /* NOW we can set this flag */
2375 if ((log_extra_selector & LX_smtp_confirmation) != 0)
2377 const uschar *s = string_printing(buffer);
2378 /* deconst cast ok here as string_printing was checked to have alloc'n'copied */
2379 conf = (s == buffer)? (uschar *)string_copy(s) : US s;
2383 /* SMTP, or success return from LMTP for this address. Pass back the
2384 actual host that was used. */
2386 addr->transport_return = OK;
2387 addr->more_errno = delivery_time;
2388 addr->host_used = host;
2389 addr->special_action = flag;
2390 addr->message = conf;
2391 #ifndef DISABLE_PRDR
2392 if (prdr_active) addr->flags |= af_prdr_used;
2396 #ifndef DISABLE_PRDR
2400 /* Update the journal. For homonymic addresses, use the base address plus
2401 the transport name. See lots of comments in deliver.c about the reasons
2402 for the complications when homonyms are involved. Just carry on after
2403 write error, as it may prove possible to update the spool file later. */
2405 if (testflag(addr, af_homonym))
2406 sprintf(CS buffer, "%.500s/%s\n", addr->unique + 3, tblock->name);
2408 sprintf(CS buffer, "%.500s\n", addr->unique);
2410 DEBUG(D_deliver) debug_printf("journalling %s", buffer);
2411 len = Ustrlen(CS buffer);
2412 if (write(journal_fd, buffer, len) != len)
2413 log_write(0, LOG_MAIN|LOG_PANIC, "failed to write journal for "
2414 "%s: %s", buffer, strerror(errno));
2418 #ifndef DISABLE_PRDR
2421 /* PRDR - get the final, overall response. For any non-success
2422 upgrade all the address statuses. */
2423 ok = smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
2427 if(errno == 0 && buffer[0] == '4')
2429 errno = ERRNO_DATA4XX;
2430 addrlist->more_errno |= ((buffer[1] - '0')*10 + buffer[2] - '0') << 8;
2432 for (addr = addrlist; addr != first_addr; addr = addr->next)
2433 if (buffer[0] == '5' || addr->transport_return == OK)
2434 addr->transport_return = PENDING_OK; /* allow set_errno action */
2435 goto RESPONSE_FAILED;
2438 /* Update the journal, or setup retry. */
2439 for (addr = addrlist; addr != first_addr; addr = addr->next)
2440 if (addr->transport_return == OK)
2442 if (testflag(addr, af_homonym))
2443 sprintf(CS buffer, "%.500s/%s\n", addr->unique + 3, tblock->name);
2445 sprintf(CS buffer, "%.500s\n", addr->unique);
2447 DEBUG(D_deliver) debug_printf("journalling(PRDR) %s", buffer);
2448 len = Ustrlen(CS buffer);
2449 if (write(journal_fd, buffer, len) != len)
2450 log_write(0, LOG_MAIN|LOG_PANIC, "failed to write journal for "
2451 "%s: %s", buffer, strerror(errno));
2453 else if (addr->transport_return == DEFER)
2454 retry_add_item(addr, addr->address_retry_key, -2);
2458 /* Ensure the journal file is pushed out to disk. */
2460 if (EXIMfsync(journal_fd) < 0)
2461 log_write(0, LOG_MAIN|LOG_PANIC, "failed to fsync journal: %s",
2467 /* Handle general (not specific to one address) failures here. The value of ok
2468 is used to skip over this code on the falling through case. A timeout causes a
2469 deferral. Other errors may defer or fail according to the response code, and
2470 may set up a special errno value, e.g. after connection chopped, which is
2471 assumed if errno == 0 and there is no text in the buffer. If control reaches
2472 here during the setting up phase (i.e. before MAIL FROM) then always defer, as
2473 the problem is not related to this specific message. */
2482 send_quit = check_response(host, &save_errno, addrlist->more_errno,
2483 buffer, &code, &message, &pass_message);
2489 message = US string_sprintf("send() to %s [%s] failed: %s",
2490 host->name, host->address, strerror(save_errno));
2494 /* This label is jumped to directly when a TLS negotiation has failed,
2495 or was not done for a host for which it is required. Values will be set
2496 in message and save_errno, and setting_up will always be true. Treat as
2497 a temporary error. */
2504 /* If the failure happened while setting up the call, see if the failure was
2505 a 5xx response (this will either be on connection, or following HELO - a 5xx
2506 after EHLO causes it to try HELO). If so, fail all addresses, as this host is
2507 never going to accept them. For other errors during setting up (timeouts or
2508 whatever), defer all addresses, and yield DEFER, so that the host is not
2509 tried again for a while. */
2512 ok = FALSE; /* For when reached by GOTO */
2517 set_errno(addrlist, save_errno, message, FAIL, pass_message, host);
2520 set_errno(addrlist, save_errno, message, DEFER, pass_message, host);
2525 /* We want to handle timeouts after MAIL or "." and loss of connection after
2526 "." specially. They can indicate a problem with the sender address or with
2527 the contents of the message rather than a real error on the connection. These
2528 cases are treated in the same way as a 4xx response. This next bit of code
2529 does the classification. */
2537 #ifdef EXPERIMENTAL_INTERNATIONAL
2538 case ERRNO_UTF8_FWD:
2545 message_error = TRUE;
2549 message_error = Ustrncmp(smtp_command,"MAIL",4) == 0 ||
2550 Ustrncmp(smtp_command,"end ",4) == 0;
2553 case ERRNO_SMTPCLOSED:
2554 message_error = Ustrncmp(smtp_command,"end ",4) == 0;
2558 message_error = FALSE;
2562 /* Handle the cases that are treated as message errors. These are:
2564 (a) negative response or timeout after MAIL
2565 (b) negative response after DATA
2566 (c) negative response or timeout or dropped connection after "."
2567 (d) utf8 support required and not offered
2569 It won't be a negative response or timeout after RCPT, as that is dealt
2570 with separately above. The action in all cases is to set an appropriate
2571 error code for all the addresses, but to leave yield set to OK because the
2572 host itself has not failed. Of course, it might in practice have failed
2573 when we've had a timeout, but if so, we'll discover that at the next
2574 delivery attempt. For a temporary error, set the message_defer flag, and
2575 write to the logs for information if this is not the last host. The error
2576 for the last host will be logged as part of the address's log line. */
2580 if (mua_wrapper) code = '5'; /* Force hard failure in wrapper mode */
2581 set_errno(addrlist, save_errno, message, (code == '5')? FAIL : DEFER,
2582 pass_message, host);
2584 /* If there's an errno, the message contains just the identity of
2587 if (code != '5') /* Anything other than 5 is treated as temporary */
2590 message = US string_sprintf("%s: %s", message, strerror(save_errno));
2591 if (host->next != NULL) log_write(0, LOG_MAIN, "%s", message);
2592 msglog_line(host, message);
2593 *message_defer = TRUE;
2597 /* Otherwise, we have an I/O error or a timeout other than after MAIL or
2598 ".", or some other transportation error. We defer all addresses and yield
2599 DEFER, except for the case of failed add_headers expansion, or a transport
2600 filter failure, when the yield should be ERROR, to stop it trying other
2605 yield = (save_errno == ERRNO_CHHEADER_FAIL ||
2606 save_errno == ERRNO_FILTER_FAIL)? ERROR : DEFER;
2607 set_errno(addrlist, save_errno, message, DEFER, pass_message, host);
2613 /* If all has gone well, send_quit will be set TRUE, implying we can end the
2614 SMTP session tidily. However, if there were too many addresses to send in one
2615 message (indicated by first_addr being non-NULL) we want to carry on with the
2616 rest of them. Also, it is desirable to send more than one message down the SMTP
2617 connection if there are several waiting, provided we haven't already sent so
2618 many as to hit the configured limit. The function transport_check_waiting looks
2619 for a waiting message and returns its id. Then transport_pass_socket tries to
2620 set up a continued delivery by passing the socket on to another process. The
2621 variable send_rset is FALSE if a message has just been successfully transfered.
2623 If we are already sending down a continued channel, there may be further
2624 addresses not yet delivered that are aimed at the same host, but which have not
2625 been passed in this run of the transport. In this case, continue_more will be
2626 true, and all we should do is send RSET if necessary, and return, leaving the
2629 However, if no address was disposed of, i.e. all addresses got 4xx errors, we
2630 do not want to continue with other messages down the same channel, because that
2631 can lead to looping between two or more messages, all with the same,
2632 temporarily failing address(es). [The retry information isn't updated yet, so
2633 new processes keep on trying.] We probably also don't want to try more of this
2634 message's addresses either.
2636 If we have started a TLS session, we have to end it before passing the
2637 connection to a new process. However, not all servers can handle this (Exim
2638 can), so we do not pass such a connection on if the host matches
2639 hosts_nopass_tls. */
2642 debug_printf("ok=%d send_quit=%d send_rset=%d continue_more=%d "
2643 "yield=%d first_address is %sNULL\n", ok, send_quit, send_rset,
2644 continue_more, yield, (first_addr == NULL)? "":"not ");
2646 if (completed_address && ok && send_quit)
2649 smtp_compare_t t_compare;
2651 t_compare.tblock = tblock;
2652 t_compare.current_sender_address = sender_address;
2654 if ( first_addr != NULL
2656 || ( ( tls_out.active < 0
2657 || verify_check_given_host(&ob->hosts_nopass_tls, host) != OK
2660 transport_check_waiting(tblock->name, host->name,
2661 tblock->connection_max_messages, new_message_id, &more,
2662 (oicf)smtp_are_same_identities, (void*)&t_compare)
2670 if (! (ok = smtp_write_command(&outblock, FALSE, "RSET\r\n") >= 0))
2672 msg = US string_sprintf("send() to %s [%s] failed: %s", host->name,
2673 host->address, strerror(save_errno));
2676 else if (! (ok = smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
2677 ob->command_timeout)))
2680 send_quit = check_response(host, &errno, 0, buffer, &code, &msg,
2684 DEBUG(D_transport) debug_printf("H=%s [%s] %s\n",
2685 host->name, host->address, msg);
2690 /* Either RSET was not needed, or it succeeded */
2694 if (first_addr != NULL) /* More addresses still to be sent */
2695 { /* in this run of the transport */
2696 continue_sequence++; /* Causes * in logging */
2699 if (continue_more) return yield; /* More addresses for another run */
2701 /* Pass the socket to a new Exim process. Before doing so, we must shut
2702 down TLS. Not all MTAs allow for the continuation of the SMTP session
2703 when TLS is shut down. We test for this by sending a new EHLO. If we
2704 don't get a good response, we don't attempt to pass the socket on. */
2707 if (tls_out.active >= 0)
2709 tls_close(FALSE, TRUE);
2713 ok = smtp_write_command(&outblock,FALSE,"EHLO %s\r\n",helo_data) >= 0 &&
2714 smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
2715 ob->command_timeout);
2719 /* If the socket is successfully passed, we musn't send QUIT (or
2720 indeed anything!) from here. */
2722 if (ok && transport_pass_socket(tblock->name, host->name, host->address,
2723 new_message_id, inblock.sock))
2729 /* If RSET failed and there are addresses left, they get deferred. */
2731 else set_errno(first_addr, errno, msg, DEFER, FALSE, host);
2735 /* End off tidily with QUIT unless the connection has died or the socket has
2736 been passed to another process. There has been discussion on the net about what
2737 to do after sending QUIT. The wording of the RFC suggests that it is necessary
2738 to wait for a response, but on the other hand, there isn't anything one can do
2739 with an error response, other than log it. Exim used to do that. However,
2740 further discussion suggested that it is positively advantageous not to wait for
2741 the response, but to close the session immediately. This is supposed to move
2742 the TCP/IP TIME_WAIT state from the server to the client, thereby removing some
2743 load from the server. (Hosts that are both servers and clients may not see much
2744 difference, of course.) Further discussion indicated that this was safe to do
2745 on Unix systems which have decent implementations of TCP/IP that leave the
2746 connection around for a while (TIME_WAIT) after the application has gone away.
2747 This enables the response sent by the server to be properly ACKed rather than
2748 timed out, as can happen on broken TCP/IP implementations on other OS.
2750 This change is being made on 31-Jul-98. After over a year of trouble-free
2751 operation, the old commented-out code was removed on 17-Sep-99. */
2754 if (send_quit) (void)smtp_write_command(&outblock, FALSE, "QUIT\r\n");
2759 tls_close(FALSE, TRUE);
2762 /* Close the socket, and return the appropriate value, first setting
2763 works because the NULL setting is passed back to the calling process, and
2764 remote_max_parallel is forced to 1 when delivering over an existing connection,
2766 If all went well and continue_more is set, we shouldn't actually get here if
2767 there are further addresses, as the return above will be taken. However,
2768 writing RSET might have failed, or there may be other addresses whose hosts are
2769 specified in the transports, and therefore not visible at top level, in which
2770 case continue_more won't get set. */
2772 (void)close(inblock.sock);
2774 #ifdef EXPERIMENTAL_EVENT
2775 (void) event_raise(tblock->event_action, US"tcp:close", NULL);
2778 continue_transport = NULL;
2779 continue_hostname = NULL;
2786 /*************************************************
2787 * Closedown entry point *
2788 *************************************************/
2790 /* This function is called when exim is passed an open smtp channel
2791 from another incarnation, but the message which it has been asked
2792 to deliver no longer exists. The channel is on stdin.
2794 We might do fancy things like looking for another message to send down
2795 the channel, but if the one we sought has gone, it has probably been
2796 delivered by some other process that itself will seek further messages,
2797 so just close down our connection.
2799 Argument: pointer to the transport instance block
2804 smtp_transport_closedown(transport_instance *tblock)
2806 smtp_transport_options_block *ob =
2807 (smtp_transport_options_block *)(tblock->options_block);
2808 smtp_inblock inblock;
2809 smtp_outblock outblock;
2811 uschar inbuffer[4096];
2812 uschar outbuffer[16];
2814 inblock.sock = fileno(stdin);
2815 inblock.buffer = inbuffer;
2816 inblock.buffersize = sizeof(inbuffer);
2817 inblock.ptr = inbuffer;
2818 inblock.ptrend = inbuffer;
2820 outblock.sock = inblock.sock;
2821 outblock.buffersize = sizeof(outbuffer);
2822 outblock.buffer = outbuffer;
2823 outblock.ptr = outbuffer;
2824 outblock.cmd_count = 0;
2825 outblock.authenticating = FALSE;
2827 (void)smtp_write_command(&outblock, FALSE, "QUIT\r\n");
2828 (void)smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
2829 ob->command_timeout);
2830 (void)close(inblock.sock);
2835 /*************************************************
2836 * Prepare addresses for delivery *
2837 *************************************************/
2839 /* This function is called to flush out error settings from previous delivery
2840 attempts to other hosts. It also records whether we got here via an MX record
2841 or not in the more_errno field of the address. We are interested only in
2842 addresses that are still marked DEFER - others may have got delivered to a
2843 previously considered IP address. Set their status to PENDING_DEFER to indicate
2844 which ones are relevant this time.
2847 addrlist the list of addresses
2848 host the host we are delivering to
2850 Returns: the first address for this delivery
2853 static address_item *
2854 prepare_addresses(address_item *addrlist, host_item *host)
2856 address_item *first_addr = NULL;
2858 for (addr = addrlist; addr != NULL; addr = addr->next)
2859 if (addr->transport_return == DEFER)
2861 if (first_addr == NULL) first_addr = addr;
2862 addr->transport_return = PENDING_DEFER;
2863 addr->basic_errno = 0;
2864 addr->more_errno = (host->mx >= 0)? 'M' : 'A';
2865 addr->message = NULL;
2867 addr->cipher = NULL;
2868 addr->ourcert = NULL;
2869 addr->peercert = NULL;
2870 addr->peerdn = NULL;
2871 addr->ocsp = OCSP_NOT_REQ;
2879 /*************************************************
2880 * Main entry point *
2881 *************************************************/
2883 /* See local README for interface details. As this is a remote transport, it is
2884 given a chain of addresses to be delivered in one connection, if possible. It
2885 always returns TRUE, indicating that each address has its own independent
2886 status set, except if there is a setting up problem, in which case it returns
2890 smtp_transport_entry(
2891 transport_instance *tblock, /* data for this instantiation */
2892 address_item *addrlist) /* addresses we are working on */
2896 int hosts_defer = 0;
2898 int hosts_looked_up = 0;
2899 int hosts_retry = 0;
2900 int hosts_serial = 0;
2901 int hosts_total = 0;
2902 int total_hosts_tried = 0;
2904 BOOL expired = TRUE;
2905 BOOL continuing = continue_hostname != NULL;
2906 uschar *expanded_hosts = NULL;
2908 uschar *tid = string_sprintf("%s transport", tblock->name);
2909 smtp_transport_options_block *ob =
2910 (smtp_transport_options_block *)(tblock->options_block);
2911 host_item *hostlist = addrlist->host_list;
2912 host_item *host = NULL;
2916 debug_printf("%s transport entered\n", tblock->name);
2917 for (addr = addrlist; addr != NULL; addr = addr->next)
2918 debug_printf(" %s\n", addr->address);
2919 if (continuing) debug_printf("already connected to %s [%s]\n",
2920 continue_hostname, continue_host_address);
2923 /* Set the flag requesting that these hosts be added to the waiting
2924 database if the delivery fails temporarily or if we are running with
2925 queue_smtp or a 2-stage queue run. This gets unset for certain
2926 kinds of error, typically those that are specific to the message. */
2928 update_waiting = TRUE;
2930 /* If a host list is not defined for the addresses - they must all have the
2931 same one in order to be passed to a single transport - or if the transport has
2932 a host list with hosts_override set, use the host list supplied with the
2933 transport. It is an error for this not to exist. */
2935 if (hostlist == NULL || (ob->hosts_override && ob->hosts != NULL))
2937 if (ob->hosts == NULL)
2939 addrlist->message = string_sprintf("%s transport called with no hosts set",
2941 addrlist->transport_return = PANIC;
2942 return FALSE; /* Only top address has status */
2945 DEBUG(D_transport) debug_printf("using the transport's hosts: %s\n",
2948 /* If the transport's host list contains no '$' characters, and we are not
2949 randomizing, it is fixed and therefore a chain of hosts can be built once
2950 and for all, and remembered for subsequent use by other calls to this
2951 transport. If, on the other hand, the host list does contain '$', or we are
2952 randomizing its order, we have to rebuild it each time. In the fixed case,
2953 as the hosts string will never be used again, it doesn't matter that we
2954 replace all the : characters with zeros. */
2956 if (ob->hostlist == NULL)
2958 uschar *s = ob->hosts;
2960 if (Ustrchr(s, '$') != NULL)
2962 if (!(expanded_hosts = expand_string(s)))
2964 addrlist->message = string_sprintf("failed to expand list of hosts "
2965 "\"%s\" in %s transport: %s", s, tblock->name, expand_string_message);
2966 addrlist->transport_return = search_find_defer? DEFER : PANIC;
2967 return FALSE; /* Only top address has status */
2969 DEBUG(D_transport) debug_printf("expanded list of hosts \"%s\" to "
2970 "\"%s\"\n", s, expanded_hosts);
2974 if (ob->hosts_randomize) s = expanded_hosts = string_copy(s);
2976 host_build_hostlist(&hostlist, s, ob->hosts_randomize);
2978 /* Check that the expansion yielded something useful. */
2979 if (hostlist == NULL)
2982 string_sprintf("%s transport has empty hosts setting", tblock->name);
2983 addrlist->transport_return = PANIC;
2984 return FALSE; /* Only top address has status */
2987 /* If there was no expansion of hosts, save the host list for
2990 if (!expanded_hosts) ob->hostlist = hostlist;
2993 /* This is not the first time this transport has been run in this delivery;
2994 the host list was built previously. */
2997 hostlist = ob->hostlist;
3000 /* The host list was supplied with the address. If hosts_randomize is set, we
3001 must sort it into a random order if it did not come from MX records and has not
3002 already been randomized (but don't bother if continuing down an existing
3005 else if (ob->hosts_randomize && hostlist->mx == MX_NONE && !continuing)
3007 host_item *newlist = NULL;
3008 while (hostlist != NULL)
3010 host_item *h = hostlist;
3011 hostlist = hostlist->next;
3013 h->sort_key = random_number(100);
3015 if (newlist == NULL)
3020 else if (h->sort_key < newlist->sort_key)
3027 host_item *hh = newlist;
3028 while (hh->next != NULL)
3030 if (h->sort_key < hh->next->sort_key) break;
3038 hostlist = addrlist->host_list = newlist;
3041 /* Sort out the default port. */
3043 if (!smtp_get_port(ob->port, addrlist, &port, tid)) return FALSE;
3045 /* For each host-plus-IP-address on the list:
3047 . If this is a continued delivery and the host isn't the one with the
3048 current connection, skip.
3050 . If the status is unusable (i.e. previously failed or retry checked), skip.
3052 . If no IP address set, get the address, either by turning the name into
3053 an address, calling gethostbyname if gethostbyname is on, or by calling
3054 the DNS. The DNS may yield multiple addresses, in which case insert the
3055 extra ones into the list.
3057 . Get the retry data if not previously obtained for this address and set the
3058 field which remembers the state of this address. Skip if the retry time is
3059 not reached. If not, remember whether retry data was found. The retry string
3060 contains both the name and the IP address.
3062 . Scan the list of addresses and mark those whose status is DEFER as
3063 PENDING_DEFER. These are the only ones that will be processed in this cycle
3066 . Make a delivery attempt - addresses marked PENDING_DEFER will be tried.
3067 Some addresses may be successfully delivered, others may fail, and yet
3068 others may get temporary errors and so get marked DEFER.
3070 . The return from the delivery attempt is OK if a connection was made and a
3071 valid SMTP dialogue was completed. Otherwise it is DEFER.
3073 . If OK, add a "remove" retry item for this host/IPaddress, if any.
3075 . If fail to connect, or other defer state, add a retry item.
3077 . If there are any addresses whose status is still DEFER, carry on to the
3078 next host/IPaddress, unless we have tried the number of hosts given
3079 by hosts_max_try or hosts_max_try_hardlimit; otherwise return. Note that
3080 there is some fancy logic for hosts_max_try that means its limit can be
3081 overstepped in some circumstances.
3083 If we get to the end of the list, all hosts have deferred at least one address,
3084 or not reached their retry times. If delay_after_cutoff is unset, it requests a
3085 delivery attempt to those hosts whose last try was before the arrival time of
3086 the current message. To cope with this, we have to go round the loop a second
3087 time. After that, set the status and error data for any addresses that haven't
3088 had it set already. */
3090 for (cutoff_retry = 0; expired &&
3091 cutoff_retry < ((ob->delay_after_cutoff)? 1 : 2);
3094 host_item *nexthost = NULL;
3095 int unexpired_hosts_tried = 0;
3097 for (host = hostlist;
3099 unexpired_hosts_tried < ob->hosts_max_try &&
3100 total_hosts_tried < ob->hosts_max_try_hardlimit;
3106 BOOL serialized = FALSE;
3107 BOOL host_is_expired = FALSE;
3108 BOOL message_defer = FALSE;
3109 BOOL ifchanges = FALSE;
3110 BOOL some_deferred = FALSE;
3111 address_item *first_addr = NULL;
3112 uschar *interface = NULL;
3113 uschar *retry_host_key = NULL;
3114 uschar *retry_message_key = NULL;
3115 uschar *serialize_key = NULL;
3117 /* Default next host is next host. :-) But this can vary if the
3118 hosts_max_try limit is hit (see below). It may also be reset if a host
3119 address is looked up here (in case the host was multihomed). */
3121 nexthost = host->next;
3123 /* If the address hasn't yet been obtained from the host name, look it up
3124 now, unless the host is already marked as unusable. If it is marked as
3125 unusable, it means that the router was unable to find its IP address (in
3126 the DNS or wherever) OR we are in the 2nd time round the cutoff loop, and
3127 the lookup failed last time. We don't get this far if *all* MX records
3128 point to non-existent hosts; that is treated as a hard error.
3130 We can just skip this host entirely. When the hosts came from the router,
3131 the address will timeout based on the other host(s); when the address is
3132 looked up below, there is an explicit retry record added.
3134 Note that we mustn't skip unusable hosts if the address is not unset; they
3135 may be needed as expired hosts on the 2nd time round the cutoff loop. */
3137 if (host->address == NULL)
3139 int new_port, flags;
3142 if (host->status >= hstatus_unusable)
3144 DEBUG(D_transport) debug_printf("%s has no address and is unusable - skipping\n",
3149 DEBUG(D_transport) debug_printf("getting address for %s\n", host->name);
3151 /* The host name is permitted to have an attached port. Find it, and
3152 strip it from the name. Just remember it for now. */
3154 new_port = host_item_get_port(host);
3156 /* Count hosts looked up */
3160 /* Find by name if so configured, or if it's an IP address. We don't
3161 just copy the IP address, because we need the test-for-local to happen. */
3163 flags = HOST_FIND_BY_A;
3164 if (ob->dns_qualify_single) flags |= HOST_FIND_QUALIFY_SINGLE;
3165 if (ob->dns_search_parents) flags |= HOST_FIND_SEARCH_PARENTS;
3167 if (ob->gethostbyname || string_is_ip_address(host->name, NULL) != 0)
3168 rc = host_find_byname(host, NULL, flags, NULL, TRUE);
3170 rc = host_find_bydns(host, NULL, flags, NULL, NULL, NULL,
3171 ob->dnssec_request_domains, ob->dnssec_require_domains,
3174 /* Update the host (and any additional blocks, resulting from
3175 multihoming) with a host-specific port, if any. */
3177 for (hh = host; hh != nexthost; hh = hh->next) hh->port = new_port;
3179 /* Failure to find the host at this time (usually DNS temporary failure)
3180 is really a kind of routing failure rather than a transport failure.
3181 Therefore we add a retry item of the routing kind, not to stop us trying
3182 to look this name up here again, but to ensure the address gets timed
3183 out if the failures go on long enough. A complete failure at this point
3184 commonly points to a configuration error, but the best action is still
3185 to carry on for the next host. */
3187 if (rc == HOST_FIND_AGAIN || rc == HOST_FIND_FAILED)
3189 retry_add_item(addrlist, string_sprintf("R:%s", host->name), 0);
3191 if (rc == HOST_FIND_AGAIN) hosts_defer++; else hosts_fail++;
3192 DEBUG(D_transport) debug_printf("rc = %s for %s\n", (rc == HOST_FIND_AGAIN)?
3193 "HOST_FIND_AGAIN" : "HOST_FIND_FAILED", host->name);
3194 host->status = hstatus_unusable;
3196 for (addr = addrlist; addr != NULL; addr = addr->next)
3198 if (addr->transport_return != DEFER) continue;
3199 addr->basic_errno = ERRNO_UNKNOWNHOST;
3201 string_sprintf("failed to lookup IP address for %s", host->name);
3206 /* If the host is actually the local host, we may have a problem, or
3207 there may be some cunning configuration going on. In the problem case,
3208 log things and give up. The default transport status is already DEFER. */
3210 if (rc == HOST_FOUND_LOCAL && !ob->allow_localhost)
3212 for (addr = addrlist; addr != NULL; addr = addr->next)
3214 addr->basic_errno = 0;
3215 addr->message = string_sprintf("%s transport found host %s to be "
3216 "local", tblock->name, host->name);
3220 } /* End of block for IP address lookup */
3222 /* If this is a continued delivery, we are interested only in the host
3223 which matches the name of the existing open channel. The check is put
3224 here after the local host lookup, in case the name gets expanded as a
3225 result of the lookup. Set expired FALSE, to save the outer loop executing
3228 if (continuing && (Ustrcmp(continue_hostname, host->name) != 0 ||
3229 Ustrcmp(continue_host_address, host->address) != 0))
3232 continue; /* With next host */
3235 /* Reset the default next host in case a multihomed host whose addresses
3236 are not looked up till just above added to the host list. */
3238 nexthost = host->next;
3240 /* If queue_smtp is set (-odqs or the first part of a 2-stage run), or the
3241 domain is in queue_smtp_domains, we don't actually want to attempt any
3242 deliveries. When doing a queue run, queue_smtp_domains is always unset. If
3243 there is a lookup defer in queue_smtp_domains, proceed as if the domain
3244 were not in it. We don't want to hold up all SMTP deliveries! Except when
3245 doing a two-stage queue run, don't do this if forcing. */
3247 if ((!deliver_force || queue_2stage) && (queue_smtp ||
3248 match_isinlist(addrlist->domain,
3249 (const uschar **)&queue_smtp_domains, 0,
3250 &domainlist_anchor, NULL, MCL_DOMAIN, TRUE, NULL) == OK))
3253 for (addr = addrlist; addr != NULL; addr = addr->next)
3255 if (addr->transport_return != DEFER) continue;
3256 addr->message = US"domain matches queue_smtp_domains, or -odqs set";
3258 continue; /* With next host */
3261 /* Count hosts being considered - purely for an intelligent comment
3262 if none are usable. */
3266 /* Set $host and $host address now in case they are needed for the
3267 interface expansion or the serialize_hosts check; they remain set if an
3268 actual delivery happens. */
3270 deliver_host = host->name;
3271 deliver_host_address = host->address;
3272 lookup_dnssec_authenticated = host->dnssec == DS_YES ? US"yes"
3273 : host->dnssec == DS_NO ? US"no"
3276 /* Set up a string for adding to the retry key if the port number is not
3277 the standard SMTP port. A host may have its own port setting that overrides
3280 pistring = string_sprintf(":%d", (host->port == PORT_NONE)?
3282 if (Ustrcmp(pistring, ":25") == 0) pistring = US"";
3284 /* Select IPv4 or IPv6, and choose an outgoing interface. If the interface
3285 string changes upon expansion, we must add it to the key that is used for
3286 retries, because connections to the same host from a different interface
3287 should be treated separately. */
3289 host_af = (Ustrchr(host->address, ':') == NULL)? AF_INET : AF_INET6;
3290 if (!smtp_get_interface(ob->interface, host_af, addrlist, &ifchanges,
3293 if (ifchanges) pistring = string_sprintf("%s/%s", pistring, interface);
3295 /* The first time round the outer loop, check the status of the host by
3296 inspecting the retry data. The second time round, we are interested only
3297 in expired hosts that haven't been tried since this message arrived. */
3299 if (cutoff_retry == 0)
3302 /* Ensure the status of the address is set by checking retry data if
3303 necessary. There may be host-specific retry data (applicable to all
3304 messages) and also data for retries of a specific message at this host.
3305 If either of these retry records are actually read, the keys used are
3306 returned to save recomputing them later. */
3308 if (exp_bool(addrlist, US"transport", tblock->name, D_transport,
3309 US"retry_include_ip_address", ob->retry_include_ip_address,
3310 ob->expand_retry_include_ip_address, &incl_ip) != OK)
3311 continue; /* with next host */
3313 host_is_expired = retry_check_address(addrlist->domain, host, pistring,
3314 incl_ip, &retry_host_key, &retry_message_key);
3316 DEBUG(D_transport) debug_printf("%s [%s]%s status = %s\n", host->name,
3317 (host->address == NULL)? US"" : host->address, pistring,
3318 (host->status == hstatus_usable)? "usable" :
3319 (host->status == hstatus_unusable)? "unusable" :
3320 (host->status == hstatus_unusable_expired)? "unusable (expired)" : "?");
3322 /* Skip this address if not usable at this time, noting if it wasn't
3323 actually expired, both locally and in the address. */
3325 switch (host->status)
3327 case hstatus_unusable:
3329 setflag(addrlist, af_retry_skipped);
3332 case hstatus_unusable_expired:
3335 case hwhy_retry: hosts_retry++; break;
3336 case hwhy_failed: hosts_fail++; break;
3337 case hwhy_deferred: hosts_defer++; break;
3340 /* If there was a retry message key, implying that previously there
3341 was a message-specific defer, we don't want to update the list of
3342 messages waiting for these hosts. */
3344 if (retry_message_key != NULL) update_waiting = FALSE;
3345 continue; /* With the next host or IP address */
3349 /* Second time round the loop: if the address is set but expired, and
3350 the message is newer than the last try, let it through. */
3354 if (host->address == NULL ||
3355 host->status != hstatus_unusable_expired ||
3356 host->last_try > received_time)
3359 debug_printf("trying expired host %s [%s]%s\n",
3360 host->name, host->address, pistring);
3361 host_is_expired = TRUE;
3364 /* Setting "expired=FALSE" doesn't actually mean not all hosts are expired;
3365 it remains TRUE only if all hosts are expired and none are actually tried.
3370 /* If this host is listed as one to which access must be serialized,
3371 see if another Exim process has a connection to it, and if so, skip
3372 this host. If not, update the database to record our connection to it
3373 and remember this for later deletion. Do not do any of this if we are
3374 sending the message down a pre-existing connection. */
3377 verify_check_given_host(&ob->serialize_hosts, host) == OK)
3379 serialize_key = string_sprintf("host-serialize-%s", host->name);
3380 if (!enq_start(serialize_key))
3383 debug_printf("skipping host %s because another Exim process "
3384 "is connected to it\n", host->name);
3391 /* OK, we have an IP address that is not waiting for its retry time to
3392 arrive (it might be expired) OR (second time round the loop) we have an
3393 expired host that hasn't been tried since the message arrived. Have a go
3394 at delivering the message to it. First prepare the addresses by flushing
3395 out the result of previous attempts, and finding the first address that
3396 is still to be delivered. */
3398 first_addr = prepare_addresses(addrlist, host);
3400 DEBUG(D_transport) debug_printf("delivering %s to %s [%s] (%s%s)\n",
3401 message_id, host->name, host->address, addrlist->address,
3402 (addrlist->next == NULL)? "" : ", ...");
3404 set_process_info("delivering %s to %s [%s] (%s%s)",
3405 message_id, host->name, host->address, addrlist->address,
3406 (addrlist->next == NULL)? "" : ", ...");
3408 /* This is not for real; don't do the delivery. If there are
3409 any remaining hosts, list them. */
3414 set_errno(addrlist, 0, NULL, OK, FALSE, NULL);
3415 for (addr = addrlist; addr != NULL; addr = addr->next)
3417 addr->host_used = host;
3418 addr->special_action = '*';
3419 addr->message = US"delivery bypassed by -N option";
3423 debug_printf("*** delivery by %s transport bypassed by -N option\n"
3424 "*** host and remaining hosts:\n", tblock->name);
3425 for (host2 = host; host2 != NULL; host2 = host2->next)
3426 debug_printf(" %s [%s]\n", host2->name,
3427 (host2->address == NULL)? US"unset" : host2->address);
3432 /* This is for real. If the host is expired, we don't count it for
3433 hosts_max_retry. This ensures that all hosts must expire before an address
3434 is timed out, unless hosts_max_try_hardlimit (which protects against
3435 lunatic DNS configurations) is reached.
3437 If the host is not expired and we are about to hit the hosts_max_retry
3438 limit, check to see if there is a subsequent hosts with a different MX
3439 value. If so, make that the next host, and don't count this one. This is a
3440 heuristic to make sure that different MXs do get tried. With a normal kind
3441 of retry rule, they would get tried anyway when the earlier hosts were
3442 delayed, but if the domain has a "retry every time" type of rule - as is
3443 often used for the the very large ISPs, that won't happen. */
3448 /* Make a copy of the host if it is local to this invocation
3449 of the transport. */
3453 thost = store_get(sizeof(host_item));
3455 thost->name = string_copy(host->name);
3456 thost->address = string_copy(host->address);
3461 if (!host_is_expired && ++unexpired_hosts_tried >= ob->hosts_max_try)
3465 debug_printf("hosts_max_try limit reached with this host\n");
3466 for (h = host; h != NULL; h = h->next)
3467 if (h->mx != host->mx) break;
3471 unexpired_hosts_tried--;
3472 DEBUG(D_transport) debug_printf("however, a higher MX host exists "
3473 "and will be tried\n");
3477 /* Attempt the delivery. */
3479 total_hosts_tried++;
3480 rc = smtp_deliver(addrlist, thost, host_af, port, interface, tblock,
3481 &message_defer, FALSE);
3484 OK => connection made, each address contains its result;
3485 message_defer is set for message-specific defers (when all
3486 recipients are marked defer)
3487 DEFER => there was a non-message-specific delivery problem;
3488 ERROR => there was a problem setting up the arguments for a filter,
3489 or there was a problem with expanding added headers
3492 /* If the result is not OK, there was a non-message-specific problem.
3493 If the result is DEFER, we need to write to the logs saying what happened
3494 for this particular host, except in the case of authentication and TLS
3495 failures, where the log has already been written. If all hosts defer a
3496 general message is written at the end. */
3498 if (rc == DEFER && first_addr->basic_errno != ERRNO_AUTHFAIL &&
3499 first_addr->basic_errno != ERRNO_TLSFAILURE)
3500 write_logs(first_addr, host);
3502 #ifdef EXPERIMENTAL_EVENT
3504 deferred_event_raise(first_addr, host);
3507 /* If STARTTLS was accepted, but there was a failure in setting up the
3508 TLS session (usually a certificate screwup), and the host is not in
3509 hosts_require_tls, and tls_tempfail_tryclear is true, try again, with
3510 TLS forcibly turned off. We have to start from scratch with a new SMTP
3511 connection. That's why the retry is done from here, not from within
3512 smtp_deliver(). [Rejections of STARTTLS itself don't screw up the
3513 session, so the in-clear transmission after those errors, if permitted,
3514 happens inside smtp_deliver().] */
3518 && first_addr->basic_errno == ERRNO_TLSFAILURE
3519 && ob->tls_tempfail_tryclear
3520 && verify_check_given_host(&ob->hosts_require_tls, host) != OK
3523 log_write(0, LOG_MAIN, "TLS session failure: delivering unencrypted "
3524 "to %s [%s] (not in hosts_require_tls)", host->name, host->address);
3525 first_addr = prepare_addresses(addrlist, host);
3526 rc = smtp_deliver(addrlist, thost, host_af, port, interface, tblock,
3527 &message_defer, TRUE);
3528 if (rc == DEFER && first_addr->basic_errno != ERRNO_AUTHFAIL)
3529 write_logs(first_addr, host);
3530 # ifdef EXPERIMENTAL_EVENT
3532 deferred_event_raise(first_addr, host);
3535 #endif /*SUPPORT_TLS*/
3538 /* Delivery attempt finished */
3540 rs = (rc == OK)? US"OK" : (rc == DEFER)? US"DEFER" : (rc == ERROR)?
3543 set_process_info("delivering %s: just tried %s [%s] for %s%s: result %s",
3544 message_id, host->name, host->address, addrlist->address,
3545 (addrlist->next == NULL)? "" : " (& others)", rs);
3547 /* Release serialization if set up */
3549 if (serialized) enq_end(serialize_key);
3551 /* If the result is DEFER, or if a host retry record is known to exist, we
3552 need to add an item to the retry chain for updating the retry database
3553 at the end of delivery. We only need to add the item to the top address,
3554 of course. Also, if DEFER, we mark the IP address unusable so as to skip it
3555 for any other delivery attempts using the same address. (It is copied into
3556 the unusable tree at the outer level, so even if different address blocks
3557 contain the same address, it still won't get tried again.) */
3559 if (rc == DEFER || retry_host_key != NULL)
3561 int delete_flag = (rc != DEFER)? rf_delete : 0;
3562 if (retry_host_key == NULL)
3565 if (exp_bool(addrlist, US"transport", tblock->name, D_transport,
3566 US"retry_include_ip_address", ob->retry_include_ip_address,
3567 ob->expand_retry_include_ip_address, &incl_ip) != OK)
3568 incl_ip = TRUE; /* error; use most-specific retry record */
3570 retry_host_key = incl_ip ?
3571 string_sprintf("T:%S:%s%s", host->name, host->address, pistring) :
3572 string_sprintf("T:%S%s", host->name, pistring);
3575 /* If a delivery of another message over an existing SMTP connection
3576 yields DEFER, we do NOT set up retry data for the host. This covers the
3577 case when there are delays in routing the addresses in the second message
3578 that are so long that the server times out. This is alleviated by not
3579 routing addresses that previously had routing defers when handling an
3580 existing connection, but even so, this case may occur (e.g. if a
3581 previously happily routed address starts giving routing defers). If the
3582 host is genuinely down, another non-continued message delivery will
3583 notice it soon enough. */
3585 if (delete_flag != 0 || !continuing)
3586 retry_add_item(first_addr, retry_host_key, rf_host | delete_flag);
3588 /* We may have tried an expired host, if its retry time has come; ensure
3589 the status reflects the expiry for the benefit of any other addresses. */
3593 host->status = (host_is_expired)?
3594 hstatus_unusable_expired : hstatus_unusable;
3595 host->why = hwhy_deferred;
3599 /* If message_defer is set (host was OK, but every recipient got deferred
3600 because of some message-specific problem), or if that had happened
3601 previously so that a message retry key exists, add an appropriate item
3602 to the retry chain. Note that if there was a message defer but now there is
3603 a host defer, the message defer record gets deleted. That seems perfectly
3604 reasonable. Also, stop the message from being remembered as waiting
3605 for specific hosts. */
3607 if (message_defer || retry_message_key != NULL)
3609 int delete_flag = message_defer? 0 : rf_delete;
3610 if (retry_message_key == NULL)
3613 if (exp_bool(addrlist, US"transport", tblock->name, D_transport,
3614 US"retry_include_ip_address", ob->retry_include_ip_address,
3615 ob->expand_retry_include_ip_address, &incl_ip) != OK)
3616 incl_ip = TRUE; /* error; use most-specific retry record */
3618 retry_message_key = incl_ip ?
3619 string_sprintf("T:%S:%s%s:%s", host->name, host->address, pistring,
3621 string_sprintf("T:%S%s:%s", host->name, pistring, message_id);
3623 retry_add_item(addrlist, retry_message_key,
3624 rf_message | rf_host | delete_flag);
3625 update_waiting = FALSE;
3628 /* Any return other than DEFER (that is, OK or ERROR) means that the
3629 addresses have got their final statuses filled in for this host. In the OK
3630 case, see if any of them are deferred. */
3634 for (addr = addrlist; addr != NULL; addr = addr->next)
3636 if (addr->transport_return == DEFER)
3638 some_deferred = TRUE;
3644 /* If no addresses deferred or the result was ERROR, return. We do this for
3645 ERROR because a failing filter set-up or add_headers expansion is likely to
3646 fail for any host we try. */
3648 if (rc == ERROR || (rc == OK && !some_deferred))
3650 DEBUG(D_transport) debug_printf("Leaving %s transport\n", tblock->name);
3651 return TRUE; /* Each address has its status */
3654 /* If the result was DEFER or some individual addresses deferred, let
3655 the loop run to try other hosts with the deferred addresses, except for the
3656 case when we were trying to deliver down an existing channel and failed.
3657 Don't try any other hosts in this case. */
3659 if (continuing) break;
3661 /* If the whole delivery, or some individual addresses, were deferred and
3662 there are more hosts that could be tried, do not count this host towards
3663 the hosts_max_try limit if the age of the message is greater than the
3664 maximum retry time for this host. This means we may try try all hosts,
3665 ignoring the limit, when messages have been around for some time. This is
3666 important because if we don't try all hosts, the address will never time
3667 out. NOTE: this does not apply to hosts_max_try_hardlimit. */
3669 if ((rc == DEFER || some_deferred) && nexthost != NULL)
3672 retry_config *retry = retry_find_config(host->name, NULL, 0, 0);
3674 if (retry != NULL && retry->rules != NULL)
3676 retry_rule *last_rule;
3677 for (last_rule = retry->rules;
3678 last_rule->next != NULL;
3679 last_rule = last_rule->next);
3680 timedout = time(NULL) - received_time > last_rule->timeout;
3682 else timedout = TRUE; /* No rule => timed out */
3686 unexpired_hosts_tried--;
3687 DEBUG(D_transport) debug_printf("temporary delivery error(s) override "
3688 "hosts_max_try (message older than host's retry time)\n");
3691 } /* End of loop for trying multiple hosts. */
3693 /* This is the end of the loop that repeats iff expired is TRUE and
3694 ob->delay_after_cutoff is FALSE. The second time round we will
3695 try those hosts that haven't been tried since the message arrived. */
3699 debug_printf("all IP addresses skipped or deferred at least one address\n");
3700 if (expired && !ob->delay_after_cutoff && cutoff_retry == 0)
3701 debug_printf("retrying IP addresses not tried since message arrived\n");
3706 /* Get here if all IP addresses are skipped or defer at least one address. In
3707 MUA wrapper mode, this will happen only for connection or other non-message-
3708 specific failures. Force the delivery status for all addresses to FAIL. */
3712 for (addr = addrlist; addr != NULL; addr = addr->next)
3713 addr->transport_return = FAIL;
3717 /* In the normal, non-wrapper case, add a standard message to each deferred
3718 address if there hasn't been an error, that is, if it hasn't actually been
3719 tried this time. The variable "expired" will be FALSE if any deliveries were
3720 actually tried, or if there was at least one host that was not expired. That
3721 is, it is TRUE only if no deliveries were tried and all hosts were expired. If
3722 a delivery has been tried, an error code will be set, and the failing of the
3723 message is handled by the retry code later.
3725 If queue_smtp is set, or this transport was called to send a subsequent message
3726 down an existing TCP/IP connection, and something caused the host not to be
3727 found, we end up here, but can detect these cases and handle them specially. */
3729 for (addr = addrlist; addr != NULL; addr = addr->next)
3731 /* If host is not NULL, it means that we stopped processing the host list
3732 because of hosts_max_try or hosts_max_try_hardlimit. In the former case, this
3733 means we need to behave as if some hosts were skipped because their retry
3734 time had not come. Specifically, this prevents the address from timing out.
3735 However, if we have hit hosts_max_try_hardlimit, we want to behave as if all
3736 hosts were tried. */
3740 if (total_hosts_tried >= ob->hosts_max_try_hardlimit)
3743 debug_printf("hosts_max_try_hardlimit reached: behave as if all "
3744 "hosts were tried\n");
3749 debug_printf("hosts_max_try limit caused some hosts to be skipped\n");
3750 setflag(addr, af_retry_skipped);
3754 if (queue_smtp) /* no deliveries attempted */
3756 addr->transport_return = DEFER;
3757 addr->basic_errno = 0;
3758 addr->message = US"SMTP delivery explicitly queued";
3761 else if (addr->transport_return == DEFER &&
3762 (addr->basic_errno == ERRNO_UNKNOWNERROR || addr->basic_errno == 0) &&
3763 addr->message == NULL)
3765 addr->basic_errno = ERRNO_HRETRY;
3766 if (continue_hostname != NULL)
3768 addr->message = US"no host found for existing SMTP connection";
3772 setflag(addr, af_pass_message); /* This is not a security risk */
3773 addr->message = (ob->delay_after_cutoff)?
3774 US"retry time not reached for any host after a long failure period" :
3775 US"all hosts have been failing for a long time and were last tried "
3776 "after this message arrived";
3778 /* If we are already using fallback hosts, or there are no fallback hosts
3779 defined, convert the result to FAIL to cause a bounce. */
3781 if (addr->host_list == addr->fallback_hosts ||
3782 addr->fallback_hosts == NULL)
3783 addr->transport_return = FAIL;
3787 if (hosts_retry == hosts_total)
3788 addr->message = US"retry time not reached for any host";
3789 else if (hosts_fail == hosts_total)
3790 addr->message = US"all host address lookups failed permanently";
3791 else if (hosts_defer == hosts_total)
3792 addr->message = US"all host address lookups failed temporarily";
3793 else if (hosts_serial == hosts_total)
3794 addr->message = US"connection limit reached for all hosts";
3795 else if (hosts_fail+hosts_defer == hosts_total)
3796 addr->message = US"all host address lookups failed";
3797 else addr->message = US"some host address lookups failed and retry time "
3798 "not reached for other hosts or connection limit reached";
3803 /* Update the database which keeps information about which messages are waiting
3804 for which hosts to become available. For some message-specific errors, the
3805 update_waiting flag is turned off because we don't want follow-on deliveries in
3806 those cases. If this transport instance is explicitly limited to one message
3807 per connection then follow-on deliveries are not possible and there's no need
3808 to create/update the per-transport wait-<transport_name> database. */
3810 if (update_waiting && tblock->connection_max_messages != 1)
3811 transport_update_waiting(hostlist, tblock->name);
3815 DEBUG(D_transport) debug_printf("Leaving %s transport\n", tblock->name);
3817 return TRUE; /* Each address has its status */
3822 /* End of transport/smtp.c */
git://git.exim.org / exim.git / blob