1 /*************************************************
2 * Exim - an Internet mail transport agent *
3 *************************************************/
5 /* Copyright (c) University of Cambridge 1995 - 2017 */
6 /* See the file NOTICE for conditions of use and distribution. */
12 /* Options specific to the smtp transport. This transport also supports LMTP
13 over TCP/IP. The options must be in alphabetic order (note that "_" comes
14 before the lower case letters). Some live in the transport_instance block so as
15 to be publicly visible; these are flagged with opt_public. */
17 optionlist smtp_transport_options[] = {
18 { "*expand_multi_domain", opt_stringptr | opt_hidden | opt_public,
19 (void *)offsetof(transport_instance, expand_multi_domain) },
20 { "*expand_retry_include_ip_address", opt_stringptr | opt_hidden,
21 (void *)(offsetof(smtp_transport_options_block, expand_retry_include_ip_address)) },
23 { "address_retry_include_sender", opt_bool,
24 (void *)offsetof(smtp_transport_options_block, address_retry_include_sender) },
25 { "allow_localhost", opt_bool,
26 (void *)offsetof(smtp_transport_options_block, allow_localhost) },
27 { "authenticated_sender", opt_stringptr,
28 (void *)offsetof(smtp_transport_options_block, authenticated_sender) },
29 { "authenticated_sender_force", opt_bool,
30 (void *)offsetof(smtp_transport_options_block, authenticated_sender_force) },
31 { "command_timeout", opt_time,
32 (void *)offsetof(smtp_transport_options_block, command_timeout) },
33 { "connect_timeout", opt_time,
34 (void *)offsetof(smtp_transport_options_block, connect_timeout) },
35 { "connection_max_messages", opt_int | opt_public,
36 (void *)offsetof(transport_instance, connection_max_messages) },
37 { "data_timeout", opt_time,
38 (void *)offsetof(smtp_transport_options_block, data_timeout) },
39 { "delay_after_cutoff", opt_bool,
40 (void *)offsetof(smtp_transport_options_block, delay_after_cutoff) },
42 { "dkim_canon", opt_stringptr,
43 (void *)offsetof(smtp_transport_options_block, dkim.dkim_canon) },
44 { "dkim_domain", opt_stringptr,
45 (void *)offsetof(smtp_transport_options_block, dkim.dkim_domain) },
46 { "dkim_private_key", opt_stringptr,
47 (void *)offsetof(smtp_transport_options_block, dkim.dkim_private_key) },
48 { "dkim_selector", opt_stringptr,
49 (void *)offsetof(smtp_transport_options_block, dkim.dkim_selector) },
50 { "dkim_sign_headers", opt_stringptr,
51 (void *)offsetof(smtp_transport_options_block, dkim.dkim_sign_headers) },
52 { "dkim_strict", opt_stringptr,
53 (void *)offsetof(smtp_transport_options_block, dkim.dkim_strict) },
55 { "dns_qualify_single", opt_bool,
56 (void *)offsetof(smtp_transport_options_block, dns_qualify_single) },
57 { "dns_search_parents", opt_bool,
58 (void *)offsetof(smtp_transport_options_block, dns_search_parents) },
59 { "dnssec_request_domains", opt_stringptr,
60 (void *)offsetof(smtp_transport_options_block, dnssec.request) },
61 { "dnssec_require_domains", opt_stringptr,
62 (void *)offsetof(smtp_transport_options_block, dnssec.require) },
63 { "dscp", opt_stringptr,
64 (void *)offsetof(smtp_transport_options_block, dscp) },
65 { "fallback_hosts", opt_stringptr,
66 (void *)offsetof(smtp_transport_options_block, fallback_hosts) },
67 { "final_timeout", opt_time,
68 (void *)offsetof(smtp_transport_options_block, final_timeout) },
69 { "gethostbyname", opt_bool,
70 (void *)offsetof(smtp_transport_options_block, gethostbyname) },
71 { "helo_data", opt_stringptr,
72 (void *)offsetof(smtp_transport_options_block, helo_data) },
73 { "hosts", opt_stringptr,
74 (void *)offsetof(smtp_transport_options_block, hosts) },
75 { "hosts_avoid_esmtp", opt_stringptr,
76 (void *)offsetof(smtp_transport_options_block, hosts_avoid_esmtp) },
77 { "hosts_avoid_pipelining", opt_stringptr,
78 (void *)offsetof(smtp_transport_options_block, hosts_avoid_pipelining) },
80 { "hosts_avoid_tls", opt_stringptr,
81 (void *)offsetof(smtp_transport_options_block, hosts_avoid_tls) },
83 { "hosts_max_try", opt_int,
84 (void *)offsetof(smtp_transport_options_block, hosts_max_try) },
85 { "hosts_max_try_hardlimit", opt_int,
86 (void *)offsetof(smtp_transport_options_block, hosts_max_try_hardlimit) },
88 { "hosts_nopass_tls", opt_stringptr,
89 (void *)offsetof(smtp_transport_options_block, hosts_nopass_tls) },
91 { "hosts_override", opt_bool,
92 (void *)offsetof(smtp_transport_options_block, hosts_override) },
93 { "hosts_randomize", opt_bool,
94 (void *)offsetof(smtp_transport_options_block, hosts_randomize) },
95 #if defined(SUPPORT_TLS) && !defined(DISABLE_OCSP)
96 { "hosts_request_ocsp", opt_stringptr,
97 (void *)offsetof(smtp_transport_options_block, hosts_request_ocsp) },
99 { "hosts_require_auth", opt_stringptr,
100 (void *)offsetof(smtp_transport_options_block, hosts_require_auth) },
102 # ifdef EXPERIMENTAL_DANE
103 { "hosts_require_dane", opt_stringptr,
104 (void *)offsetof(smtp_transport_options_block, hosts_require_dane) },
106 # ifndef DISABLE_OCSP
107 { "hosts_require_ocsp", opt_stringptr,
108 (void *)offsetof(smtp_transport_options_block, hosts_require_ocsp) },
110 { "hosts_require_tls", opt_stringptr,
111 (void *)offsetof(smtp_transport_options_block, hosts_require_tls) },
113 { "hosts_try_auth", opt_stringptr,
114 (void *)offsetof(smtp_transport_options_block, hosts_try_auth) },
115 { "hosts_try_chunking", opt_stringptr,
116 (void *)offsetof(smtp_transport_options_block, hosts_try_chunking) },
117 #if defined(SUPPORT_TLS) && defined(EXPERIMENTAL_DANE)
118 { "hosts_try_dane", opt_stringptr,
119 (void *)offsetof(smtp_transport_options_block, hosts_try_dane) },
121 { "hosts_try_fastopen", opt_stringptr,
122 (void *)offsetof(smtp_transport_options_block, hosts_try_fastopen) },
124 { "hosts_try_prdr", opt_stringptr,
125 (void *)offsetof(smtp_transport_options_block, hosts_try_prdr) },
128 { "hosts_verify_avoid_tls", opt_stringptr,
129 (void *)offsetof(smtp_transport_options_block, hosts_verify_avoid_tls) },
131 { "interface", opt_stringptr,
132 (void *)offsetof(smtp_transport_options_block, interface) },
133 { "keepalive", opt_bool,
134 (void *)offsetof(smtp_transport_options_block, keepalive) },
135 { "lmtp_ignore_quota", opt_bool,
136 (void *)offsetof(smtp_transport_options_block, lmtp_ignore_quota) },
137 { "max_rcpt", opt_int | opt_public,
138 (void *)offsetof(transport_instance, max_addresses) },
139 { "multi_domain", opt_expand_bool | opt_public,
140 (void *)offsetof(transport_instance, multi_domain) },
141 { "port", opt_stringptr,
142 (void *)offsetof(smtp_transport_options_block, port) },
143 { "protocol", opt_stringptr,
144 (void *)offsetof(smtp_transport_options_block, protocol) },
145 { "retry_include_ip_address", opt_expand_bool,
146 (void *)offsetof(smtp_transport_options_block, retry_include_ip_address) },
147 { "serialize_hosts", opt_stringptr,
148 (void *)offsetof(smtp_transport_options_block, serialize_hosts) },
149 { "size_addition", opt_int,
150 (void *)offsetof(smtp_transport_options_block, size_addition) }
152 ,{ "socks_proxy", opt_stringptr,
153 (void *)offsetof(smtp_transport_options_block, socks_proxy) }
156 ,{ "tls_certificate", opt_stringptr,
157 (void *)offsetof(smtp_transport_options_block, tls_certificate) },
158 { "tls_crl", opt_stringptr,
159 (void *)offsetof(smtp_transport_options_block, tls_crl) },
160 { "tls_dh_min_bits", opt_int,
161 (void *)offsetof(smtp_transport_options_block, tls_dh_min_bits) },
162 { "tls_privatekey", opt_stringptr,
163 (void *)offsetof(smtp_transport_options_block, tls_privatekey) },
164 { "tls_require_ciphers", opt_stringptr,
165 (void *)offsetof(smtp_transport_options_block, tls_require_ciphers) },
166 { "tls_sni", opt_stringptr,
167 (void *)offsetof(smtp_transport_options_block, tls_sni) },
168 { "tls_tempfail_tryclear", opt_bool,
169 (void *)offsetof(smtp_transport_options_block, tls_tempfail_tryclear) },
170 { "tls_try_verify_hosts", opt_stringptr,
171 (void *)offsetof(smtp_transport_options_block, tls_try_verify_hosts) },
172 { "tls_verify_cert_hostnames", opt_stringptr,
173 (void *)offsetof(smtp_transport_options_block,tls_verify_cert_hostnames)},
174 { "tls_verify_certificates", opt_stringptr,
175 (void *)offsetof(smtp_transport_options_block, tls_verify_certificates) },
176 { "tls_verify_hosts", opt_stringptr,
177 (void *)offsetof(smtp_transport_options_block, tls_verify_hosts) }
181 /* Size of the options list. An extern variable has to be used so that its
182 address can appear in the tables drtables.c. */
184 int smtp_transport_options_count =
185 sizeof(smtp_transport_options)/sizeof(optionlist);
187 /* Default private options block for the smtp transport. */
189 smtp_transport_options_block smtp_transport_option_defaults = {
191 NULL, /* fallback_hosts */
193 NULL, /* fallback_hostlist */
194 NULL, /* authenticated_sender */
195 US"$primary_hostname", /* helo_data */
196 NULL, /* interface */
198 US"smtp", /* protocol */
200 NULL, /* serialize_hosts */
201 NULL, /* hosts_try_auth */
202 NULL, /* hosts_require_auth */
203 US"*", /* hosts_try_chunking */
204 #ifdef EXPERIMENTAL_DANE
205 NULL, /* hosts_try_dane */
206 NULL, /* hosts_require_dane */
208 NULL, /* hosts_try_fastopen */
210 US"*", /* hosts_try_prdr */
213 US"*", /* hosts_request_ocsp (except under DANE; tls_client_start()) */
214 NULL, /* hosts_require_ocsp */
216 NULL, /* hosts_require_tls */
217 NULL, /* hosts_avoid_tls */
218 NULL, /* hosts_verify_avoid_tls */
219 NULL, /* hosts_avoid_pipelining */
220 NULL, /* hosts_avoid_esmtp */
221 NULL, /* hosts_nopass_tls */
222 5*60, /* command_timeout */
223 5*60, /* connect_timeout; shorter system default overrides */
224 5*60, /* data timeout */
225 10*60, /* final timeout */
226 1024, /* size_addition */
227 5, /* hosts_max_try */
228 50, /* hosts_max_try_hardlimit */
229 TRUE, /* address_retry_include_sender */
230 FALSE, /* allow_localhost */
231 FALSE, /* authenticated_sender_force */
232 FALSE, /* gethostbyname */
233 TRUE, /* dns_qualify_single */
234 FALSE, /* dns_search_parents */
235 { NULL, NULL }, /* dnssec_domains {request,require} */
236 TRUE, /* delay_after_cutoff */
237 FALSE, /* hosts_override */
238 FALSE, /* hosts_randomize */
239 TRUE, /* keepalive */
240 FALSE, /* lmtp_ignore_quota */
241 NULL, /* expand_retry_include_ip_address */
242 TRUE /* retry_include_ip_address */
244 ,NULL /* socks_proxy */
247 ,NULL, /* tls_certificate */
249 NULL, /* tls_privatekey */
250 NULL, /* tls_require_ciphers */
252 US"system", /* tls_verify_certificates */
253 EXIM_CLIENT_DH_DEFAULT_MIN_BITS,
254 /* tls_dh_min_bits */
255 TRUE, /* tls_tempfail_tryclear */
256 NULL, /* tls_verify_hosts */
257 US"*", /* tls_try_verify_hosts */
258 US"*" /* tls_verify_cert_hostnames */
261 , {NULL, /* dkim_canon */
262 NULL, /* dkim_domain */
263 NULL, /* dkim_private_key */
264 NULL, /* dkim_selector */
265 NULL, /* dkim_sign_headers */
266 NULL, /* dkim_strict */
267 FALSE} /* dot_stuffed */
271 /* some DSN flags for use later */
273 static int rf_list[] = {rf_notify_never, rf_notify_success,
274 rf_notify_failure, rf_notify_delay };
276 static uschar *rf_names[] = { US"NEVER", US"SUCCESS", US"FAILURE", US"DELAY" };
282 static uschar *smtp_command; /* Points to last cmd for error messages */
283 static uschar *mail_command; /* Points to MAIL cmd for error messages */
284 static uschar *data_command = US""; /* Points to DATA cmd for error messages */
285 static BOOL update_waiting; /* TRUE to update the "wait" database */
286 static BOOL pipelining_active; /* current transaction is in pipe mode */
289 /*************************************************
290 * Setup entry point *
291 *************************************************/
293 /* This function is called when the transport is about to be used,
294 but before running it in a sub-process. It is used for two things:
296 (1) To set the fallback host list in addresses, when delivering.
297 (2) To pass back the interface, port, protocol, and other options, for use
298 during callout verification.
301 tblock pointer to the transport instance block
302 addrlist list of addresses about to be transported
303 tf if not NULL, pointer to block in which to return options
304 uid the uid that will be set (not used)
305 gid the gid that will be set (not used)
306 errmsg place for error message (not used)
308 Returns: OK always (FAIL, DEFER not used)
312 smtp_transport_setup(transport_instance *tblock, address_item *addrlist,
313 transport_feedback *tf, uid_t uid, gid_t gid, uschar **errmsg)
315 smtp_transport_options_block *ob =
316 (smtp_transport_options_block *)(tblock->options_block);
318 errmsg = errmsg; /* Keep picky compilers happy */
322 /* Pass back options if required. This interface is getting very messy. */
326 tf->interface = ob->interface;
328 tf->protocol = ob->protocol;
329 tf->hosts = ob->hosts;
330 tf->hosts_override = ob->hosts_override;
331 tf->hosts_randomize = ob->hosts_randomize;
332 tf->gethostbyname = ob->gethostbyname;
333 tf->qualify_single = ob->dns_qualify_single;
334 tf->search_parents = ob->dns_search_parents;
335 tf->helo_data = ob->helo_data;
338 /* Set the fallback host list for all the addresses that don't have fallback
339 host lists, provided that the local host wasn't present in the original host
342 if (!testflag(addrlist, af_local_host_removed))
343 for (; addrlist; addrlist = addrlist->next)
344 if (!addrlist->fallback_hosts) addrlist->fallback_hosts = ob->fallback_hostlist;
351 /*************************************************
352 * Initialization entry point *
353 *************************************************/
355 /* Called for each instance, after its options have been read, to
356 enable consistency checks to be done, or anything else that needs
359 Argument: pointer to the transport instance block
364 smtp_transport_init(transport_instance *tblock)
366 smtp_transport_options_block *ob =
367 (smtp_transport_options_block *)(tblock->options_block);
369 /* Retry_use_local_part defaults FALSE if unset */
371 if (tblock->retry_use_local_part == TRUE_UNSET)
372 tblock->retry_use_local_part = FALSE;
374 /* Set the default port according to the protocol */
376 if (ob->port == NULL)
377 ob->port = (strcmpic(ob->protocol, US"lmtp") == 0)? US"lmtp" :
378 (strcmpic(ob->protocol, US"smtps") == 0)? US"smtps" : US"smtp";
380 /* Set up the setup entry point, to be called before subprocesses for this
383 tblock->setup = smtp_transport_setup;
385 /* Complain if any of the timeouts are zero. */
387 if (ob->command_timeout <= 0 || ob->data_timeout <= 0 ||
388 ob->final_timeout <= 0)
389 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
390 "command, data, or final timeout value is zero for %s transport",
393 /* If hosts_override is set and there are local hosts, set the global
394 flag that stops verify from showing router hosts. */
396 if (ob->hosts_override && ob->hosts != NULL) tblock->overrides_hosts = TRUE;
398 /* If there are any fallback hosts listed, build a chain of host items
399 for them, but do not do any lookups at this time. */
401 host_build_hostlist(&(ob->fallback_hostlist), ob->fallback_hosts, FALSE);
408 /*************************************************
409 * Set delivery info into all active addresses *
410 *************************************************/
412 /* Only addresses whose status is >= PENDING are relevant. A lesser
413 status means that an address is not currently being processed.
416 addrlist points to a chain of addresses
417 errno_value to put in each address's errno field
418 msg to put in each address's message field
419 rc to put in each address's transport_return field
420 pass_message if TRUE, set the "pass message" flag in the address
421 host if set, mark addrs as having used this host
422 smtp_greeting from peer
423 helo_response from peer
425 If errno_value has the special value ERRNO_CONNECTTIMEOUT, ETIMEDOUT is put in
426 the errno field, and RTEF_CTOUT is ORed into the more_errno field, to indicate
427 this particular type of timeout.
433 set_errno(address_item *addrlist, int errno_value, uschar *msg, int rc,
434 BOOL pass_message, host_item * host
435 #ifdef EXPERIMENTAL_DSN_INFO
436 , const uschar * smtp_greeting, const uschar * helo_response
442 if (errno_value == ERRNO_CONNECTTIMEOUT)
444 errno_value = ETIMEDOUT;
445 orvalue = RTEF_CTOUT;
447 for (addr = addrlist; addr; addr = addr->next)
448 if (addr->transport_return >= PENDING)
450 addr->basic_errno = errno_value;
451 addr->more_errno |= orvalue;
455 if (pass_message) setflag(addr, af_pass_message);
457 addr->transport_return = rc;
460 addr->host_used = host;
461 #ifdef EXPERIMENTAL_DSN_INFO
463 {uschar * s = Ustrchr(smtp_greeting, '\n'); if (s) *s = '\0';}
464 addr->smtp_greeting = smtp_greeting;
467 {uschar * s = Ustrchr(helo_response, '\n'); if (s) *s = '\0';}
468 addr->helo_response = helo_response;
475 set_errno_nohost(address_item *addrlist, int errno_value, uschar *msg, int rc,
478 set_errno(addrlist, errno_value, msg, rc, pass_message, NULL
479 #ifdef EXPERIMENTAL_DSN_INFO
486 /*************************************************
487 * Check an SMTP response *
488 *************************************************/
490 /* This function is given an errno code and the SMTP response buffer
491 to analyse, together with the host identification for generating messages. It
492 sets an appropriate message and puts the first digit of the response code into
493 the yield variable. If no response was actually read, a suitable digit is
497 host the current host, to get its name for messages
498 errno_value pointer to the errno value
499 more_errno from the top address for use with ERRNO_FILTER_FAIL
500 buffer the SMTP response buffer
501 yield where to put a one-digit SMTP response code
502 message where to put an error message
503 pass_message set TRUE if message is an SMTP response
505 Returns: TRUE if an SMTP "QUIT" command should be sent, else FALSE
509 check_response(host_item *host, int *errno_value, int more_errno,
510 uschar *buffer, int *yield, uschar **message, BOOL *pass_message)
512 uschar * pl = pipelining_active ? US"pipelined " : US"";
515 *yield = '4'; /* Default setting is to give a temporary error */
519 case ETIMEDOUT: /* Handle response timeout */
520 *message = US string_sprintf("SMTP timeout after %s%s",
522 if (transport_count > 0)
523 *message = US string_sprintf("%s (%d bytes written)", *message,
527 case ERRNO_SMTPFORMAT: /* Handle malformed SMTP response */
528 s = string_printing(buffer);
529 while (isspace(*s)) s++;
531 ? string_sprintf("Malformed SMTP reply (an empty line) "
532 "in response to %s%s", pl, smtp_command)
533 : string_sprintf("Malformed SMTP reply in response to %s%s: %s",
534 pl, smtp_command, s);
537 case ERRNO_FILTER_FAIL: /* Handle a failed filter process error;
538 can't send QUIT as we mustn't end the DATA. */
539 *message = string_sprintf("transport filter process failed (%d)%s",
541 more_errno == EX_EXECFAILED ? ": unable to execute command" : "");
544 case ERRNO_CHHEADER_FAIL: /* Handle a failed add_headers expansion;
545 can't send QUIT as we mustn't end the DATA. */
547 string_sprintf("failed to expand headers_add or headers_remove: %s",
548 expand_string_message);
551 case ERRNO_WRITEINCOMPLETE: /* failure to write a complete data block */
552 *message = string_sprintf("failed to write a data block");
556 case ERRNO_UTF8_FWD: /* no advertised SMTPUTF8, for international message */
557 *message = US"utf8 support required but not offered for forwarding";
558 DEBUG(D_deliver|D_transport) debug_printf("%s\n", *message);
563 /* Handle error responses from the remote mailer. */
567 *message = string_sprintf("SMTP error from remote mail server after %s%s: "
568 "%s", pl, smtp_command, s = string_printing(buffer));
569 *pass_message = TRUE;
574 /* No data was read. If there is no errno, this must be the EOF (i.e.
575 connection closed) case, which causes deferral. An explicit connection reset
576 error has the same effect. Otherwise, put the host's identity in the message,
577 leaving the errno value to be interpreted as well. In all cases, we have to
578 assume the connection is now dead. */
580 if (*errno_value == 0 || *errno_value == ECONNRESET)
582 *errno_value = ERRNO_SMTPCLOSED;
583 *message = US string_sprintf("Remote host closed connection "
584 "in response to %s%s", pl, smtp_command);
587 *message = US string_sprintf("%s [%s]", host->name, host->address);
594 /*************************************************
595 * Write error message to logs *
596 *************************************************/
598 /* This writes to the main log and to the message log.
601 addr the address item containing error information
602 host the current host
608 write_logs(address_item *addr, host_item *host)
610 uschar * message = LOGGING(outgoing_port)
611 ? string_sprintf("H=%s [%s]:%d", host->name, host->address,
612 host->port == PORT_NONE ? 25 : host->port)
613 : string_sprintf("H=%s [%s]", host->name, host->address);
617 message = string_sprintf("%s: %s", message, addr->message);
618 if (addr->basic_errno > 0)
619 message = string_sprintf("%s: %s", message, strerror(addr->basic_errno));
620 log_write(0, LOG_MAIN, "%s", message);
621 deliver_msglog("%s %s\n", tod_stamp(tod_log), message);
625 const uschar * s = exim_errstr(addr->basic_errno);
626 log_write(0, LOG_MAIN, "%s %s", message, s);
627 deliver_msglog("%s %s %s\n", tod_stamp(tod_log), message, s);
632 msglog_line(host_item * host, uschar * message)
634 deliver_msglog("%s H=%s [%s] %s\n", tod_stamp(tod_log),
635 host->name, host->address, message);
640 #ifndef DISABLE_EVENT
641 /*************************************************
642 * Post-defer action *
643 *************************************************/
645 /* This expands an arbitrary per-transport string.
646 It might, for example, be used to write to the database log.
649 addr the address item containing error information
650 host the current host
656 deferred_event_raise(address_item *addr, host_item *host)
658 uschar * action = addr->transport->event_action;
659 const uschar * save_domain;
665 save_domain = deliver_domain;
666 save_local = deliver_localpart;
668 /*XXX would ip & port already be set up? */
669 deliver_host_address = string_copy(host->address);
670 deliver_host_port = host->port == PORT_NONE ? 25 : host->port;
671 event_defer_errno = addr->basic_errno;
673 router_name = addr->router->name;
674 transport_name = addr->transport->name;
675 deliver_domain = addr->domain;
676 deliver_localpart = addr->local_part;
678 (void) event_raise(action, US"msg:host:defer",
680 ? addr->basic_errno > 0
681 ? string_sprintf("%s: %s", addr->message, strerror(addr->basic_errno))
682 : string_copy(addr->message)
683 : addr->basic_errno > 0
684 ? string_copy(US strerror(addr->basic_errno))
687 deliver_localpart = save_local;
688 deliver_domain = save_domain;
689 router_name = transport_name = NULL;
693 /*************************************************
694 * Synchronize SMTP responses *
695 *************************************************/
697 /* This function is called from smtp_deliver() to receive SMTP responses from
698 the server, and match them up with the commands to which they relate. When
699 PIPELINING is not in use, this function is called after every command, and is
700 therefore somewhat over-engineered, but it is simpler to use a single scheme
701 that works both with and without PIPELINING instead of having two separate sets
704 The set of commands that are buffered up with pipelining may start with MAIL
705 and may end with DATA; in between are RCPT commands that correspond to the
706 addresses whose status is PENDING_DEFER. All other commands (STARTTLS, AUTH,
707 etc.) are never buffered.
709 Errors after MAIL or DATA abort the whole process leaving the response in the
710 buffer. After MAIL, pending responses are flushed, and the original command is
711 re-instated in big_buffer for error messages. For RCPT commands, the remote is
712 permitted to reject some recipient addresses while accepting others. However
713 certain errors clearly abort the whole process. Set the value in
714 transport_return to PENDING_OK if the address is accepted. If there is a
715 subsequent general error, it will get reset accordingly. If not, it will get
716 converted to OK at the end.
719 sx smtp connection context
720 count the number of responses to read
721 pending_DATA 0 if last command sent was not DATA
722 +1 if previously had a good recipient
723 -1 if not previously had a good recipient
725 Returns: 3 if at least one address had 2xx and one had 5xx
726 2 if at least one address had 5xx but none had 2xx
727 1 if at least one host had a 2xx response, but none had 5xx
728 0 no address had 2xx or 5xx but no errors (all 4xx, or just DATA)
729 -1 timeout while reading RCPT response
730 -2 I/O or other non-response error for RCPT
731 -3 DATA or MAIL failed - errno and buffer set
735 sync_responses(smtp_context * sx, int count, int pending_DATA)
737 address_item *addr = sx->sync_addr;
738 smtp_transport_options_block *ob =
739 (smtp_transport_options_block *)sx->tblock->options_block;
742 /* Handle the response for a MAIL command. On error, reinstate the original
743 command in big_buffer for error message use, and flush any further pending
744 responses before returning, except after I/O errors and timeouts. */
746 if (sx->pending_MAIL)
749 if (!smtp_read_response(&sx->inblock, sx->buffer, sizeof(sx->buffer),
750 '2', ob->command_timeout))
752 DEBUG(D_transport) debug_printf("bad response for MAIL\n");
753 Ustrcpy(big_buffer, mail_command); /* Fits, because it came from there! */
754 if (errno == 0 && sx->buffer[0] != 0)
756 uschar flushbuffer[4096];
758 if (sx->buffer[0] == '4')
760 save_errno = ERRNO_MAIL4XX;
761 addr->more_errno |= ((sx->buffer[1] - '0')*10 + sx->buffer[2] - '0') << 8;
765 if (!smtp_read_response(&sx->inblock, flushbuffer, sizeof(flushbuffer),
766 '2', ob->command_timeout)
767 && (errno != 0 || flushbuffer[0] == 0))
773 if (pending_DATA) count--; /* Number of RCPT responses to come */
774 while (count-- > 0) /* Mark any pending addrs with the host used */
776 while (addr->transport_return != PENDING_DEFER) addr = addr->next;
777 addr->host_used = sx->host;
784 if (pending_DATA) count--; /* Number of RCPT responses to come */
786 /* Read and handle the required number of RCPT responses, matching each one up
787 with an address by scanning for the next address whose status is PENDING_DEFER.
792 while (addr->transport_return != PENDING_DEFER)
793 if (!(addr = addr->next))
796 /* The address was accepted */
797 addr->host_used = sx->host;
799 if (smtp_read_response(&sx->inblock, sx->buffer, sizeof(sx->buffer),
800 '2', ob->command_timeout))
803 addr->transport_return = PENDING_OK;
805 /* If af_dr_retry_exists is set, there was a routing delay on this address;
806 ensure that any address-specific retry record is expunged. We do this both
807 for the basic key and for the version that also includes the sender. */
809 if (testflag(addr, af_dr_retry_exists))
811 uschar *altkey = string_sprintf("%s:<%s>", addr->address_retry_key,
813 retry_add_item(addr, altkey, rf_delete);
814 retry_add_item(addr, addr->address_retry_key, rf_delete);
818 /* Timeout while reading the response */
820 else if (errno == ETIMEDOUT)
822 uschar *message = string_sprintf("SMTP timeout after RCPT TO:<%s>",
823 transport_rcpt_address(addr, sx->tblock->rcpt_include_affixes));
824 set_errno_nohost(sx->first_addr, ETIMEDOUT, message, DEFER, FALSE);
825 retry_add_item(addr, addr->address_retry_key, 0);
826 update_waiting = FALSE;
830 /* Handle other errors in obtaining an SMTP response by returning -1. This
831 will cause all the addresses to be deferred. Restore the SMTP command in
832 big_buffer for which we are checking the response, so the error message
835 else if (errno != 0 || sx->buffer[0] == 0)
837 string_format(big_buffer, big_buffer_size, "RCPT TO:<%s>",
838 transport_rcpt_address(addr, sx->tblock->rcpt_include_affixes));
842 /* Handle SMTP permanent and temporary response codes. */
847 string_sprintf("SMTP error from remote mail server after RCPT TO:<%s>: "
848 "%s", transport_rcpt_address(addr, sx->tblock->rcpt_include_affixes),
849 string_printing(sx->buffer));
850 setflag(addr, af_pass_message);
852 msglog_line(sx->host, addr->message);
854 /* The response was 5xx */
856 if (sx->buffer[0] == '5')
858 addr->transport_return = FAIL;
862 /* The response was 4xx */
866 addr->transport_return = DEFER;
867 addr->basic_errno = ERRNO_RCPT4XX;
868 addr->more_errno |= ((sx->buffer[1] - '0')*10 + sx->buffer[2] - '0') << 8;
872 #ifndef DISABLE_EVENT
873 event_defer_errno = addr->more_errno;
874 msg_event_raise(US"msg:rcpt:host:defer", addr);
877 /* Log temporary errors if there are more hosts to be tried.
878 If not, log this last one in the == line. */
881 log_write(0, LOG_MAIN, "H=%s [%s]: %s",
882 sx->host->name, sx->host->address, addr->message);
884 #ifndef DISABLE_EVENT
886 msg_event_raise(US"msg:rcpt:defer", addr);
889 /* Do not put this message on the list of those waiting for specific
890 hosts, as otherwise it is likely to be tried too often. */
892 update_waiting = FALSE;
894 /* Add a retry item for the address so that it doesn't get tried again
895 too soon. If address_retry_include_sender is true, add the sender address
899 ob->address_retry_include_sender
900 ? string_sprintf("%s:<%s>", addr->address_retry_key, sender_address)
901 : addr->address_retry_key,
906 } /* Loop for next RCPT response */
908 /* Update where to start at for the next block of responses, unless we
909 have already handled all the addresses. */
911 if (addr) sx->sync_addr = addr->next;
913 /* Handle a response to DATA. If we have not had any good recipients, either
914 previously or in this block, the response is ignored. */
916 if (pending_DATA != 0 &&
917 !smtp_read_response(&sx->inblock, sx->buffer, sizeof(sx->buffer),
918 '3', ob->command_timeout))
923 if (pending_DATA > 0 || (yield & 1) != 0)
925 if (errno == 0 && sx->buffer[0] == '4')
927 errno = ERRNO_DATA4XX;
928 sx->first_addr->more_errno |= ((sx->buffer[1] - '0')*10 + sx->buffer[2] - '0') << 8;
932 (void)check_response(sx->host, &errno, 0, sx->buffer, &code, &msg, &pass_message);
933 DEBUG(D_transport) debug_printf("%s\nerror for DATA ignored: pipelining "
934 "is in use and there were no good recipients\n", msg);
937 /* All responses read and handled; MAIL (if present) received 2xx and DATA (if
938 present) received 3xx. If any RCPTs were handled and yielded anything other
939 than 4xx, yield will be set non-zero. */
946 /* Do the client side of smtp-level authentication */
949 buffer EHLO response from server (gets overwritten)
950 addrlist chain of potential addresses to deliver
951 host host to deliver to
953 ibp, obp comms channel control blocks
956 OK Success, or failed (but not required): global "smtp_authenticated" set
957 DEFER Failed authentication (and was required)
958 ERROR Internal problem
960 FAIL_SEND Failed communications - transmit
965 smtp_auth(uschar *buffer, unsigned bufsize, address_item *addrlist, host_item *host,
966 smtp_transport_options_block *ob, BOOL is_esmtp,
967 smtp_inblock *ibp, smtp_outblock *obp)
970 uschar *fail_reason = US"server did not advertise AUTH support";
972 smtp_authenticated = FALSE;
973 client_authenticator = client_authenticated_id = client_authenticated_sender = NULL;
974 require_auth = verify_check_given_host(&ob->hosts_require_auth, host);
976 if (is_esmtp && !regex_AUTH) regex_AUTH =
977 regex_must_compile(US"\\n250[\\s\\-]AUTH\\s+([\\-\\w\\s]+)(?:\\n|$)",
980 if (is_esmtp && regex_match_and_setup(regex_AUTH, buffer, 0, -1))
982 uschar *names = string_copyn(expand_nstring[1], expand_nlength[1]);
983 expand_nmax = -1; /* reset */
985 /* Must not do this check until after we have saved the result of the
986 regex match above. */
988 if (require_auth == OK ||
989 verify_check_given_host(&ob->hosts_try_auth, host) == OK)
992 fail_reason = US"no common mechanisms were found";
994 DEBUG(D_transport) debug_printf("scanning authentication mechanisms\n");
996 /* Scan the configured authenticators looking for one which is configured
997 for use as a client, which is not suppressed by client_condition, and
998 whose name matches an authentication mechanism supported by the server.
999 If one is found, attempt to authenticate by calling its client function.
1002 for (au = auths; !smtp_authenticated && au != NULL; au = au->next)
1006 (au->client_condition != NULL &&
1007 !expand_check_condition(au->client_condition, au->name,
1008 US"client authenticator")))
1010 DEBUG(D_transport) debug_printf("skipping %s authenticator: %s\n",
1012 (au->client)? "client_condition is false" :
1013 "not configured as a client");
1017 /* Loop to scan supported server mechanisms */
1022 int len = Ustrlen(au->public_name);
1023 while (isspace(*p)) p++;
1025 if (strncmpic(au->public_name, p, len) != 0 ||
1026 (p[len] != 0 && !isspace(p[len])))
1028 while (*p != 0 && !isspace(*p)) p++;
1032 /* Found data for a listed mechanism. Call its client entry. Set
1033 a flag in the outblock so that data is overwritten after sending so
1034 that reflections don't show it. */
1036 fail_reason = US"authentication attempt(s) failed";
1037 obp->authenticating = TRUE;
1038 rc = (au->info->clientcode)(au, ibp, obp,
1039 ob->command_timeout, buffer, bufsize);
1040 obp->authenticating = FALSE;
1041 DEBUG(D_transport) debug_printf("%s authenticator yielded %d\n",
1044 /* A temporary authentication failure must hold up delivery to
1045 this host. After a permanent authentication failure, we carry on
1046 to try other authentication methods. If all fail hard, try to
1047 deliver the message unauthenticated unless require_auth was set. */
1052 smtp_authenticated = TRUE; /* stops the outer loop */
1053 client_authenticator = au->name;
1054 if (au->set_client_id != NULL)
1055 client_authenticated_id = expand_string(au->set_client_id);
1058 /* Failure after writing a command */
1063 /* Failure after reading a response */
1066 if (errno != 0 || buffer[0] != '5') return FAIL;
1067 log_write(0, LOG_MAIN, "%s authenticator failed H=%s [%s] %s",
1068 au->name, host->name, host->address, buffer);
1071 /* Failure by some other means. In effect, the authenticator
1072 decided it wasn't prepared to handle this case. Typically this
1073 is the result of "fail" in an expansion string. Do we need to
1074 log anything here? Feb 2006: a message is now put in the buffer
1075 if logging is required. */
1079 log_write(0, LOG_MAIN, "%s authenticator cancelled "
1080 "authentication H=%s [%s] %s", au->name, host->name,
1081 host->address, buffer);
1084 /* Internal problem, message in buffer. */
1087 set_errno_nohost(addrlist, ERRNO_AUTHPROB, string_copy(buffer),
1092 break; /* If not authenticated, try next authenticator */
1093 } /* Loop for scanning supported server mechanisms */
1094 } /* Loop for further authenticators */
1098 /* If we haven't authenticated, but are required to, give up. */
1100 if (require_auth == OK && !smtp_authenticated)
1102 set_errno_nohost(addrlist, ERRNO_AUTHFAIL,
1103 string_sprintf("authentication required but %s", fail_reason), DEFER,
1112 /* Construct AUTH appendix string for MAIL TO */
1115 buffer to build string
1116 addrlist chain of potential addresses to deliver
1117 ob transport options
1119 Globals smtp_authenticated
1120 client_authenticated_sender
1121 Return True on error, otherwise buffer has (possibly empty) terminated string
1125 smtp_mail_auth_str(uschar *buffer, unsigned bufsize, address_item *addrlist,
1126 smtp_transport_options_block *ob)
1128 uschar *local_authenticated_sender = authenticated_sender;
1131 debug_printf("smtp_mail_auth_str: as<%s> os<%s> SA<%s>\n", authenticated_sender, ob->authenticated_sender, smtp_authenticated?"Y":"N");
1134 if (ob->authenticated_sender != NULL)
1136 uschar *new = expand_string(ob->authenticated_sender);
1139 if (!expand_string_forcedfail)
1141 uschar *message = string_sprintf("failed to expand "
1142 "authenticated_sender: %s", expand_string_message);
1143 set_errno_nohost(addrlist, ERRNO_EXPANDFAIL, message, DEFER, FALSE);
1147 else if (new[0] != 0) local_authenticated_sender = new;
1150 /* Add the authenticated sender address if present */
1152 if ((smtp_authenticated || ob->authenticated_sender_force) &&
1153 local_authenticated_sender != NULL)
1155 string_format(buffer, bufsize, " AUTH=%s",
1156 auth_xtextencode(local_authenticated_sender,
1157 Ustrlen(local_authenticated_sender)));
1158 client_authenticated_sender = string_copy(local_authenticated_sender);
1168 #ifdef EXPERIMENTAL_DANE
1169 /* Lookup TLSA record for host/port.
1170 Return: OK success with dnssec; DANE mode
1171 DEFER Do not use this host now, may retry later
1172 FAIL_FORCED No TLSA record; DANE not usable
1173 FAIL Do not use this connection
1177 tlsa_lookup(const host_item * host, dns_answer * dnsa, BOOL dane_required)
1179 /* move this out to host.c given the similarity to dns_lookup() ? */
1181 const uschar * fullname = buffer;
1183 /* TLSA lookup string */
1184 (void)sprintf(CS buffer, "_%d._tcp.%.256s", host->port, host->name);
1186 switch (dns_lookup(dnsa, buffer, T_TLSA, &fullname))
1189 if (!dns_is_secure(dnsa))
1191 log_write(0, LOG_MAIN, "DANE error: TLSA lookup not DNSSEC");
1197 return DEFER; /* just defer this TLS'd conn */
1199 case DNS_NODATA: /* no TLSA RR for this lookup */
1200 case DNS_NOMATCH: /* no records at all for this lookup */
1201 return dane_required ? FAIL : FAIL_FORCED;
1205 return dane_required ? FAIL : DEFER;
1212 typedef struct smtp_compare_s
1214 uschar *current_sender_address;
1215 struct transport_instance *tblock;
1219 /* Create a unique string that identifies this message, it is based on
1220 sender_address, helo_data and tls_certificate if enabled.
1224 smtp_local_identity(uschar * sender, struct transport_instance * tblock)
1226 address_item * addr1;
1227 uschar * if1 = US"";
1228 uschar * helo1 = US"";
1230 uschar * tlsc1 = US"";
1232 uschar * save_sender_address = sender_address;
1233 uschar * local_identity = NULL;
1234 smtp_transport_options_block * ob =
1235 (smtp_transport_options_block *)tblock->options_block;
1237 sender_address = sender;
1239 addr1 = deliver_make_addr (sender, TRUE);
1240 deliver_set_expansions(addr1);
1243 if1 = expand_string(ob->interface);
1246 helo1 = expand_string(ob->helo_data);
1249 if (ob->tls_certificate)
1250 tlsc1 = expand_string(ob->tls_certificate);
1251 local_identity = string_sprintf ("%s^%s^%s", if1, helo1, tlsc1);
1253 local_identity = string_sprintf ("%s^%s", if1, helo1);
1256 deliver_set_expansions(NULL);
1257 sender_address = save_sender_address;
1259 return local_identity;
1264 /* This routine is a callback that is called from transport_check_waiting.
1265 This function will evaluate the incoming message versus the previous
1266 message. If the incoming message is using a different local identity then
1267 we will veto this new message. */
1270 smtp_are_same_identities(uschar * message_id, smtp_compare_t * s_compare)
1272 uschar * message_local_identity,
1273 * current_local_identity,
1274 * new_sender_address;
1276 current_local_identity =
1277 smtp_local_identity(s_compare->current_sender_address, s_compare->tblock);
1279 if (!(new_sender_address = deliver_get_sender_address(message_id)))
1282 message_local_identity =
1283 smtp_local_identity(new_sender_address, s_compare->tblock);
1285 return Ustrcmp(current_local_identity, message_local_identity) == 0;
1291 ehlo_response(uschar * buf, uschar checks)
1293 size_t bsize = Ustrlen(buf);
1296 if ( checks & OPTION_TLS
1297 && pcre_exec(regex_STARTTLS, NULL, CS buf, bsize, 0, PCRE_EOPT, NULL, 0) < 0)
1298 checks &= ~OPTION_TLS;
1301 if ( checks & OPTION_IGNQ
1302 && pcre_exec(regex_IGNOREQUOTA, NULL, CS buf, bsize, 0,
1303 PCRE_EOPT, NULL, 0) < 0)
1304 checks &= ~OPTION_IGNQ;
1306 if ( checks & OPTION_CHUNKING
1307 && pcre_exec(regex_CHUNKING, NULL, CS buf, bsize, 0, PCRE_EOPT, NULL, 0) < 0)
1308 checks &= ~OPTION_CHUNKING;
1310 #ifndef DISABLE_PRDR
1311 if ( checks & OPTION_PRDR
1312 && pcre_exec(regex_PRDR, NULL, CS buf, bsize, 0, PCRE_EOPT, NULL, 0) < 0)
1313 checks &= ~OPTION_PRDR;
1317 if ( checks & OPTION_UTF8
1318 && pcre_exec(regex_UTF8, NULL, CS buf, bsize, 0, PCRE_EOPT, NULL, 0) < 0)
1319 checks &= ~OPTION_UTF8;
1322 if ( checks & OPTION_DSN
1323 && pcre_exec(regex_DSN, NULL, CS buf, bsize, 0, PCRE_EOPT, NULL, 0) < 0)
1324 checks &= ~OPTION_DSN;
1326 if ( checks & OPTION_PIPE
1327 && pcre_exec(regex_PIPELINING, NULL, CS buf, bsize, 0,
1328 PCRE_EOPT, NULL, 0) < 0)
1329 checks &= ~OPTION_PIPE;
1331 if ( checks & OPTION_SIZE
1332 && pcre_exec(regex_SIZE, NULL, CS buf, bsize, 0, PCRE_EOPT, NULL, 0) < 0)
1333 checks &= ~OPTION_SIZE;
1340 /* Callback for emitting a BDAT data chunk header.
1342 If given a nonzero size, first flush any buffered SMTP commands
1343 then emit the command.
1345 Reap previous SMTP command responses if requested.
1346 Reap one SMTP command response if requested.
1348 Returns: OK or ERROR
1352 smtp_chunk_cmd_callback(int fd, transport_ctx * tctx,
1353 unsigned chunk_size, unsigned flags)
1355 smtp_transport_options_block * ob =
1356 (smtp_transport_options_block *)(tctx->tblock->options_block);
1357 smtp_context * sx = tctx->smtp_context;
1361 /* Write SMTP chunk header command */
1365 if((cmd_count = smtp_write_command(&sx->outblock, FALSE, "BDAT %u%s\r\n",
1367 flags & tc_chunk_last ? " LAST" : "")
1368 ) < 0) return ERROR;
1369 if (flags & tc_chunk_last)
1370 data_command = string_copy(big_buffer); /* Save for later error message */
1373 prev_cmd_count = cmd_count += sx->cmd_count;
1375 /* Reap responses for any previous, but not one we just emitted */
1379 if (sx->pending_BDAT)
1382 if (flags & tc_reap_prev && prev_cmd_count > 0)
1384 DEBUG(D_transport) debug_printf("look for %d responses"
1385 " for previous pipelined cmds\n", prev_cmd_count);
1387 switch(sync_responses(sx, prev_cmd_count, 0))
1389 case 1: /* 2xx (only) => OK */
1390 case 3: sx->good_RCPT = TRUE; /* 2xx & 5xx => OK & progress made */
1391 case 2: sx->completed_addr = TRUE; /* 5xx (only) => progress made */
1392 case 0: break; /* No 2xx or 5xx, but no probs */
1394 case -1: /* Timeout on RCPT */
1395 default: return ERROR; /* I/O error, or any MAIL/DATA error */
1398 if (!sx->pending_BDAT)
1399 pipelining_active = FALSE;
1402 /* Reap response for an outstanding BDAT */
1404 if (sx->pending_BDAT)
1406 DEBUG(D_transport) debug_printf("look for one response for BDAT\n");
1408 if (!smtp_read_response(&sx->inblock, sx->buffer, sizeof(sx->buffer), '2',
1409 ob->command_timeout))
1411 if (errno == 0 && sx->buffer[0] == '4')
1413 errno = ERRNO_DATA4XX; /*XXX does this actually get used? */
1414 sx->addrlist->more_errno |=
1415 ((sx->buffer[1] - '0')*10 + sx->buffer[2] - '0') << 8;
1420 sx->pending_BDAT = FALSE;
1421 pipelining_active = FALSE;
1423 else if (chunk_size > 0)
1424 sx->pending_BDAT = TRUE;
1427 sx->cmd_count = cmd_count;
1433 /*************************************************
1434 * Make connection for given message *
1435 *************************************************/
1439 ctx connection context
1440 suppress_tls if TRUE, don't attempt a TLS connection - this is set for
1441 a second attempt after TLS initialization fails
1443 Returns: OK - the connection was made and the delivery attempted;
1444 fd is set in the conn context, tls_out set up.
1445 DEFER - the connection could not be made, or something failed
1446 while setting up the SMTP session, or there was a
1447 non-message-specific error, such as a timeout.
1448 ERROR - helo_data or add_headers or authenticated_sender is
1449 specified for this transport, and the string failed
1453 smtp_setup_conn(smtp_context * sx, BOOL suppress_tls)
1455 #if defined(SUPPORT_TLS) && defined(EXPERIMENTAL_DANE)
1456 dns_answer tlsa_dnsa;
1458 BOOL pass_message = FALSE;
1459 uschar * message = NULL;
1463 sx->ob = (smtp_transport_options_block *) sx->tblock->options_block;
1465 sx->lmtp = strcmpic(sx->ob->protocol, US"lmtp") == 0;
1466 sx->smtps = strcmpic(sx->ob->protocol, US"smtps") == 0;
1468 sx->send_rset = TRUE;
1469 sx->send_quit = TRUE;
1470 sx->setting_up = TRUE;
1472 sx->esmtp_sent = FALSE;
1474 sx->utf8_needed = FALSE;
1476 sx->dsn_all_lasthop = TRUE;
1477 #if defined(SUPPORT_TLS) && defined(EXPERIMENTAL_DANE)
1479 sx->dane_required = verify_check_given_host(&sx->ob->hosts_require_dane, sx->host) == OK;
1482 if ((sx->max_rcpt = sx->tblock->max_addresses) == 0) sx->max_rcpt = 999999;
1483 sx->peer_offered = 0;
1484 sx->avoid_option = 0;
1485 sx->igquotstr = US"";
1486 if (!sx->helo_data) sx->helo_data = sx->ob->helo_data;
1487 #ifdef EXPERIMENTAL_DSN_INFO
1488 sx->smtp_greeting = NULL;
1489 sx->helo_response = NULL;
1492 smtp_command = US"initial connection";
1493 sx->buffer[0] = '\0';
1495 /* Set up the buffer for reading SMTP response packets. */
1497 sx->inblock.buffer = sx->inbuffer;
1498 sx->inblock.buffersize = sizeof(sx->inbuffer);
1499 sx->inblock.ptr = sx->inbuffer;
1500 sx->inblock.ptrend = sx->inbuffer;
1502 /* Set up the buffer for holding SMTP commands while pipelining */
1504 sx->outblock.buffer = sx->outbuffer;
1505 sx->outblock.buffersize = sizeof(sx->outbuffer);
1506 sx->outblock.ptr = sx->outbuffer;
1507 sx->outblock.cmd_count = 0;
1508 sx->outblock.authenticating = FALSE;
1510 /* Reset the parameters of a TLS session. */
1513 tls_out.cipher = NULL; /* the one we may use for this transport */
1514 tls_out.ourcert = NULL;
1515 tls_out.peercert = NULL;
1516 tls_out.peerdn = NULL;
1517 #if defined(SUPPORT_TLS) && !defined(USE_GNUTLS)
1520 tls_out.ocsp = OCSP_NOT_REQ;
1522 /* Flip the legacy TLS-related variables over to the outbound set in case
1523 they're used in the context of the transport. Don't bother resetting
1524 afterward (when being used by a transport) as we're in a subprocess.
1525 For verify, unflipped once the callout is dealt with */
1527 tls_modify_variables(&tls_out);
1532 set_errno_nohost(sx->addrlist, ERRNO_TLSFAILURE, US"TLS support not available",
1538 /* Make a connection to the host if this isn't a continued delivery, and handle
1539 the initial interaction and HELO/EHLO/LHLO. Connect timeout errors are handled
1540 specially so they can be identified for retries. */
1542 if (continue_hostname == NULL)
1545 HDEBUG(D_verify) debug_printf("interface=%s port=%d\n", sx->interface, sx->port);
1547 /* This puts port into host->port */
1548 sx->inblock.sock = sx->outblock.sock =
1549 smtp_connect(sx->host, sx->host_af, sx->port, sx->interface,
1550 sx->ob->connect_timeout, sx->tblock);
1552 if (sx->inblock.sock < 0)
1554 uschar * msg = NULL;
1557 msg = US strerror(errno);
1558 HDEBUG(D_verify) debug_printf("connect: %s\n", msg);
1560 set_errno_nohost(sx->addrlist,
1561 errno == ETIMEDOUT ? ERRNO_CONNECTTIMEOUT : errno,
1562 sx->verify ? string_sprintf("could not connect: %s", msg)
1565 sx->send_quit = FALSE;
1569 #if defined(SUPPORT_TLS) && defined(EXPERIMENTAL_DANE)
1571 tls_out.dane_verified = FALSE;
1572 tls_out.tlsa_usage = 0;
1574 if (sx->host->dnssec == DS_YES)
1576 if( sx->dane_required
1577 || verify_check_given_host(&sx->ob->hosts_try_dane, sx->host) == OK
1579 switch (rc = tlsa_lookup(sx->host, &tlsa_dnsa, sx->dane_required))
1581 case OK: sx->dane = TRUE; break;
1582 case FAIL_FORCED: break;
1583 default: set_errno_nohost(sx->addrlist, ERRNO_DNSDEFER,
1584 string_sprintf("DANE error: tlsa lookup %s",
1585 rc == DEFER ? "DEFER" : "FAIL"),
1590 else if (sx->dane_required)
1592 set_errno_nohost(sx->addrlist, ERRNO_DNSDEFER,
1593 string_sprintf("DANE error: %s lookup not DNSSEC", sx->host->name),
1599 sx->ob->tls_tempfail_tryclear = FALSE;
1603 /* Expand the greeting message while waiting for the initial response. (Makes
1604 sense if helo_data contains ${lookup dnsdb ...} stuff). The expansion is
1605 delayed till here so that $sending_interface and $sending_port are set. */
1608 if (!(sx->helo_data = expand_string(sx->helo_data)))
1610 log_write(0, LOG_MAIN|LOG_PANIC,
1611 "<%s>: failed to expand transport's helo_data value for callout: %s",
1612 sx->addrlist->address, expand_string_message);
1617 expand_string_message = NULL;
1618 if ((sx->helo_data = string_domain_utf8_to_alabel(sx->helo_data,
1619 &expand_string_message)),
1620 expand_string_message)
1622 log_write(0, LOG_MAIN|LOG_PANIC,
1623 "<%s>: failed to expand transport's helo_data value for callout: %s",
1624 sx->addrlist->address, expand_string_message);
1626 sx->helo_data = NULL;
1630 /* The first thing is to wait for an initial OK response. The dreaded "goto"
1631 is nevertheless a reasonably clean way of programming this kind of logic,
1632 where you want to escape on any error. */
1639 (void) setsockopt(sx->inblock.sock, IPPROTO_TCP, TCP_QUICKACK, US &off, sizeof(off));
1641 good_response = smtp_read_response(&sx->inblock, sx->buffer, sizeof(sx->buffer),
1642 '2', sx->ob->command_timeout);
1643 #ifdef EXPERIMENTAL_DSN_INFO
1644 sx->smtp_greeting = string_copy(sx->buffer);
1646 if (!good_response) goto RESPONSE_FAILED;
1648 #ifndef DISABLE_EVENT
1651 lookup_dnssec_authenticated = sx->host->dnssec==DS_YES ? US"yes"
1652 : sx->host->dnssec==DS_NO ? US"no" : NULL;
1653 s = event_raise(sx->tblock->event_action, US"smtp:connect", sx->buffer);
1656 set_errno_nohost(sx->addrlist, ERRNO_EXPANDFAIL,
1657 string_sprintf("deferred by smtp:connect event expansion: %s", s),
1665 /* Now check if the helo_data expansion went well, and sign off cleanly if
1670 message = string_sprintf("failed to expand helo_data: %s",
1671 expand_string_message);
1672 set_errno_nohost(sx->addrlist, ERRNO_EXPANDFAIL, message, DEFER, FALSE);
1678 /** Debugging without sending a message
1679 sx->addrlist->transport_return = DEFER;
1683 /* Errors that occur after this point follow an SMTP command, which is
1684 left in big_buffer by smtp_write_command() for use in error messages. */
1686 smtp_command = big_buffer;
1688 /* Tell the remote who we are...
1690 February 1998: A convention has evolved that ESMTP-speaking MTAs include the
1691 string "ESMTP" in their greeting lines, so make Exim send EHLO if the
1692 greeting is of this form. The assumption was that the far end supports it
1693 properly... but experience shows that there are some that give 5xx responses,
1694 even though the banner includes "ESMTP" (there's a bloody-minded one that
1695 says "ESMTP not spoken here"). Cope with that case.
1697 September 2000: Time has passed, and it seems reasonable now to always send
1698 EHLO at the start. It is also convenient to make the change while installing
1701 July 2003: Joachim Wieland met a broken server that advertises "PIPELINING"
1702 but times out after sending MAIL FROM, RCPT TO and DATA all together. There
1703 would be no way to send out the mails, so there is now a host list
1704 "hosts_avoid_esmtp" that disables ESMTP for special hosts and solves the
1705 PIPELINING problem as well. Maybe it can also be useful to cure other
1706 problems with broken servers.
1708 Exim originally sent "Helo" at this point and ran for nearly a year that way.
1709 Then somebody tried it with a Microsoft mailer... It seems that all other
1710 mailers use upper case for some reason (the RFC is quite clear about case
1711 independence) so, for peace of mind, I gave in. */
1713 sx->esmtp = verify_check_given_host(&sx->ob->hosts_avoid_esmtp, sx->host) != OK;
1715 /* Alas; be careful, since this goto is not an error-out, so conceivably
1716 we might set data between here and the target which we assume to exist
1717 and be usable. I can see this coming back to bite us. */
1721 smtp_peer_options |= OPTION_TLS;
1722 suppress_tls = FALSE;
1723 sx->ob->tls_tempfail_tryclear = FALSE;
1724 smtp_command = US"SSL-on-connect";
1731 if (smtp_write_command(&sx->outblock, FALSE, "%s %s\r\n",
1732 sx->lmtp ? "LHLO" : "EHLO", sx->helo_data) < 0)
1734 sx->esmtp_sent = TRUE;
1735 if (!smtp_read_response(&sx->inblock, sx->buffer, sizeof(sx->buffer), '2',
1736 sx->ob->command_timeout))
1738 if (errno != 0 || sx->buffer[0] == 0 || sx->lmtp)
1740 #ifdef EXPERIMENTAL_DSN_INFO
1741 sx->helo_response = string_copy(sx->buffer);
1743 goto RESPONSE_FAILED;
1747 #ifdef EXPERIMENTAL_DSN_INFO
1748 sx->helo_response = string_copy(sx->buffer);
1753 debug_printf("not sending EHLO (host matches hosts_avoid_esmtp)\n");
1758 int n = sizeof(sx->buffer);
1759 uschar * rsp = sx->buffer;
1761 if (sx->esmtp_sent && (n = Ustrlen(sx->buffer)) < sizeof(sx->buffer)/2)
1762 { rsp = sx->buffer + n + 1; n = sizeof(sx->buffer) - n; }
1764 if (smtp_write_command(&sx->outblock, FALSE, "HELO %s\r\n", sx->helo_data) < 0)
1766 good_response = smtp_read_response(&sx->inblock, rsp, n,
1767 '2', sx->ob->command_timeout);
1768 #ifdef EXPERIMENTAL_DSN_INFO
1769 sx->helo_response = string_copy(rsp);
1773 /* Handle special logging for a closed connection after HELO
1774 when had previously sent EHLO */
1776 if (rsp != sx->buffer && rsp[0] == 0 && (errno == 0 || errno == ECONNRESET))
1778 errno = ERRNO_SMTPCLOSED;
1779 goto EHLOHELO_FAILED;
1781 Ustrncpy(sx->buffer, rsp, sizeof(sx->buffer)/2);
1782 goto RESPONSE_FAILED;
1786 sx->avoid_option = sx->peer_offered = smtp_peer_options = 0;
1788 if (sx->esmtp || sx->lmtp)
1790 sx->peer_offered = ehlo_response(sx->buffer,
1791 OPTION_TLS /* others checked later */
1794 /* Set tls_offered if the response to EHLO specifies support for STARTTLS. */
1797 smtp_peer_options |= sx->peer_offered & OPTION_TLS;
1802 /* For continuing deliveries down the same channel, the socket is the standard
1803 input, and we don't need to redo EHLO here (but may need to do so for TLS - see
1804 below). Set up the pointer to where subsequent commands will be left, for
1805 error messages. Note that smtp_peer_options will have been
1806 set from the command line if they were set in the process that passed the
1809 /*XXX continue case needs to propagate DSN_INFO, prob. in deliver.c
1810 as the continue goes via transport_pass_socket() and doublefork and exec.
1811 It does not wait. Unclear how we keep separate host's responses
1812 separate - we could match up by host ip+port as a bodge. */
1816 sx->inblock.sock = sx->outblock.sock = fileno(stdin);
1817 smtp_command = big_buffer;
1818 sx->host->port = sx->port; /* Record the port that was used */
1819 sx->helo_data = NULL; /* ensure we re-expand ob->helo_data */
1822 /* If TLS is available on this connection, whether continued or not, attempt to
1823 start up a TLS session, unless the host is in hosts_avoid_tls. If successful,
1824 send another EHLO - the server may give a different answer in secure mode. We
1825 use a separate buffer for reading the response to STARTTLS so that if it is
1826 negative, the original EHLO data is available for subsequent analysis, should
1827 the client not be required to use TLS. If the response is bad, copy the buffer
1828 for error analysis. */
1831 if ( smtp_peer_options & OPTION_TLS
1833 && verify_check_given_host(&sx->ob->hosts_avoid_tls, sx->host) != OK
1835 || verify_check_given_host(&sx->ob->hosts_verify_avoid_tls, sx->host) != OK
1838 uschar buffer2[4096];
1839 if (smtp_write_command(&sx->outblock, FALSE, "STARTTLS\r\n") < 0)
1842 /* If there is an I/O error, transmission of this message is deferred. If
1843 there is a temporary rejection of STARRTLS and tls_tempfail_tryclear is
1844 false, we also defer. However, if there is a temporary rejection of STARTTLS
1845 and tls_tempfail_tryclear is true, or if there is an outright rejection of
1846 STARTTLS, we carry on. This means we will try to send the message in clear,
1847 unless the host is in hosts_require_tls (tested below). */
1849 if (!smtp_read_response(&sx->inblock, buffer2, sizeof(buffer2), '2',
1850 sx->ob->command_timeout))
1854 || (buffer2[0] == '4' && !sx->ob->tls_tempfail_tryclear)
1857 Ustrncpy(sx->buffer, buffer2, sizeof(sx->buffer));
1858 sx->buffer[sizeof(sx->buffer)-1] = '\0';
1859 goto RESPONSE_FAILED;
1863 /* STARTTLS accepted: try to negotiate a TLS session. */
1868 address_item * addr;
1869 int rc = tls_client_start(sx->inblock.sock, sx->host, sx->addrlist, sx->tblock
1870 # ifdef EXPERIMENTAL_DANE
1871 , sx->dane ? &tlsa_dnsa : NULL
1875 /* TLS negotiation failed; give an error. From outside, this function may
1876 be called again to try in clear on a new connection, if the options permit
1877 it for this host. */
1881 # ifdef EXPERIMENTAL_DANE
1882 if (sx->dane) log_write(0, LOG_MAIN,
1883 "DANE attempt failed; no TLS connection to %s [%s]",
1884 sx->host->name, sx->host->address);
1887 errno = ERRNO_TLSFAILURE;
1888 message = US"failure while setting up TLS session";
1889 sx->send_quit = FALSE;
1893 /* TLS session is set up */
1895 smtp_peer_options_wrap = smtp_peer_options;
1896 for (addr = sx->addrlist; addr; addr = addr->next)
1897 if (addr->transport_return == PENDING_DEFER)
1899 addr->cipher = tls_out.cipher;
1900 addr->ourcert = tls_out.ourcert;
1901 addr->peercert = tls_out.peercert;
1902 addr->peerdn = tls_out.peerdn;
1903 addr->ocsp = tls_out.ocsp;
1908 /* if smtps, we'll have smtp_command set to something else; always safe to
1910 smtp_command = big_buffer;
1912 /* If we started TLS, redo the EHLO/LHLO exchange over the secure channel. If
1913 helo_data is null, we are dealing with a connection that was passed from
1914 another process, and so we won't have expanded helo_data above. We have to
1915 expand it here. $sending_ip_address and $sending_port are set up right at the
1916 start of the Exim process (in exim.c). */
1918 if (tls_out.active >= 0)
1923 if (!sx->helo_data && !(sx->helo_data = expand_string(sx->ob->helo_data)))
1925 uschar *message = string_sprintf("failed to expand helo_data: %s",
1926 expand_string_message);
1927 set_errno_nohost(sx->addrlist, ERRNO_EXPANDFAIL, message, DEFER, FALSE);
1932 /* For SMTPS we need to wait for the initial OK response. */
1935 good_response = smtp_read_response(&sx->inblock, sx->buffer, sizeof(sx->buffer),
1936 '2', sx->ob->command_timeout);
1937 #ifdef EXPERIMENTAL_DSN_INFO
1938 sx->smtp_greeting = string_copy(sx->buffer);
1940 if (!good_response) goto RESPONSE_FAILED;
1944 greeting_cmd = "EHLO";
1947 greeting_cmd = "HELO";
1949 debug_printf("not sending EHLO (host matches hosts_avoid_esmtp)\n");
1952 if (smtp_write_command(&sx->outblock, FALSE, "%s %s\r\n",
1953 sx->lmtp ? "LHLO" : greeting_cmd, sx->helo_data) < 0)
1955 good_response = smtp_read_response(&sx->inblock, sx->buffer, sizeof(sx->buffer),
1956 '2', sx->ob->command_timeout);
1957 #ifdef EXPERIMENTAL_DSN_INFO
1958 sx->helo_response = string_copy(sx->buffer);
1960 if (!good_response) goto RESPONSE_FAILED;
1961 smtp_peer_options = 0;
1964 /* If the host is required to use a secure channel, ensure that we
1968 # ifdef EXPERIMENTAL_DANE
1971 || verify_check_given_host(&sx->ob->hosts_require_tls, sx->host) == OK
1974 errno = ERRNO_TLSREQUIRED;
1975 message = string_sprintf("a TLS session is required, but %s",
1976 smtp_peer_options & OPTION_TLS
1977 ? "an attempt to start TLS failed" : "the server did not offer TLS support");
1980 #endif /*SUPPORT_TLS*/
1982 /* If TLS is active, we have just started it up and re-done the EHLO command,
1983 so its response needs to be analyzed. If TLS is not active and this is a
1984 continued session down a previously-used socket, we haven't just done EHLO, so
1987 if (continue_hostname == NULL
1989 || tls_out.active >= 0
1993 if (sx->esmtp || sx->lmtp)
1995 sx->peer_offered = ehlo_response(sx->buffer,
1997 | (sx->lmtp && sx->ob->lmtp_ignore_quota ? OPTION_IGNQ : 0)
2001 | (sx->addrlist->prop.utf8_msg ? OPTION_UTF8 : 0)
2002 /*XXX if we hand peercaps on to continued-conn processes,
2003 must not depend on this addr */
2007 | (sx->ob->size_addition >= 0 ? OPTION_SIZE : 0)
2010 /* Set for IGNOREQUOTA if the response to LHLO specifies support and the
2011 lmtp_ignore_quota option was set. */
2013 sx->igquotstr = sx->peer_offered & OPTION_IGNQ ? US" IGNOREQUOTA" : US"";
2015 /* If the response to EHLO specified support for the SIZE parameter, note
2016 this, provided size_addition is non-negative. */
2018 smtp_peer_options |= sx->peer_offered & OPTION_SIZE;
2020 /* Note whether the server supports PIPELINING. If hosts_avoid_esmtp matched
2021 the current host, esmtp will be false, so PIPELINING can never be used. If
2022 the current host matches hosts_avoid_pipelining, don't do it. */
2024 if ( sx->peer_offered & OPTION_PIPE
2025 && verify_check_given_host(&sx->ob->hosts_avoid_pipelining, sx->host) != OK)
2026 smtp_peer_options |= OPTION_PIPE;
2028 DEBUG(D_transport) debug_printf("%susing PIPELINING\n",
2029 smtp_peer_options & OPTION_PIPE ? "" : "not ");
2031 if ( sx->peer_offered & OPTION_CHUNKING
2032 && verify_check_given_host(&sx->ob->hosts_try_chunking, sx->host) != OK)
2033 sx->peer_offered &= ~OPTION_CHUNKING;
2035 if (sx->peer_offered & OPTION_CHUNKING)
2036 {DEBUG(D_transport) debug_printf("CHUNKING usable\n");}
2038 #ifndef DISABLE_PRDR
2039 if ( sx->peer_offered & OPTION_PRDR
2040 && verify_check_given_host(&sx->ob->hosts_try_prdr, sx->host) != OK)
2041 sx->peer_offered &= ~OPTION_PRDR;
2043 if (sx->peer_offered & OPTION_PRDR)
2044 {DEBUG(D_transport) debug_printf("PRDR usable\n");}
2047 /* Note if the server supports DSN */
2048 smtp_peer_options |= sx->peer_offered & OPTION_DSN;
2049 DEBUG(D_transport) debug_printf("%susing DSN\n",
2050 sx->peer_offered & OPTION_DSN ? "" : "not ");
2052 /* Note if the response to EHLO specifies support for the AUTH extension.
2053 If it has, check that this host is one we want to authenticate to, and do
2054 the business. The host name and address must be available when the
2055 authenticator's client driver is running. */
2057 switch (yield = smtp_auth(sx->buffer, sizeof(sx->buffer), sx->addrlist, sx->host,
2058 sx->ob, sx->esmtp, &sx->inblock, &sx->outblock))
2060 default: goto SEND_QUIT;
2062 case FAIL_SEND: goto SEND_FAILED;
2063 case FAIL: goto RESPONSE_FAILED;
2067 pipelining_active = !!(smtp_peer_options & OPTION_PIPE);
2069 /* The setting up of the SMTP call is now complete. Any subsequent errors are
2070 message-specific. */
2072 sx->setting_up = FALSE;
2075 if (sx->addrlist->prop.utf8_msg)
2077 sx->utf8_needed = !sx->addrlist->prop.utf8_downcvt
2078 && !sx->addrlist->prop.utf8_downcvt_maybe;
2079 DEBUG(D_transport) if (!sx->utf8_needed)
2080 debug_printf("utf8: %s downconvert\n",
2081 sx->addrlist->prop.utf8_downcvt ? "mandatory" : "optional");
2084 /* If this is an international message we need the host to speak SMTPUTF8 */
2085 if (sx->utf8_needed && !(sx->peer_offered & OPTION_UTF8))
2087 errno = ERRNO_UTF8_FWD;
2088 goto RESPONSE_FAILED;
2100 sx->send_quit = check_response(sx->host, &errno, sx->addrlist->more_errno,
2101 sx->buffer, &code, &message, &pass_message);
2106 message = US string_sprintf("send() to %s [%s] failed: %s",
2107 sx->host->name, sx->host->address, strerror(errno));
2108 sx->send_quit = FALSE;
2111 /* This label is jumped to directly when a TLS negotiation has failed,
2112 or was not done for a host for which it is required. Values will be set
2113 in message and errno, and setting_up will always be true. Treat as
2114 a temporary error. */
2118 message = string_sprintf("Remote host closed connection in response to %s"
2119 " (EHLO response was: %s)", smtp_command, sx->buffer);
2120 sx->send_quit = FALSE;
2129 /* The failure happened while setting up the call; see if the failure was
2130 a 5xx response (this will either be on connection, or following HELO - a 5xx
2131 after EHLO causes it to try HELO). If so, fail all addresses, as this host is
2132 never going to accept them. For other errors during setting up (timeouts or
2133 whatever), defer all addresses, and yield DEFER, so that the host is not
2134 tried again for a while. */
2137 sx->ok = FALSE; /* For when reached by GOTO */
2141 || errno == ERRNO_UTF8_FWD
2145 set_errno(sx->addrlist, errno, message, yield, pass_message, sx->host
2146 #ifdef EXPERIMENTAL_DSN_INFO
2147 , sx->smtp_greeting, sx->helo_response
2156 (void)smtp_write_command(&sx->outblock, FALSE, "QUIT\r\n");
2159 tls_close(FALSE, TRUE);
2162 /* Close the socket, and return the appropriate value, first setting
2163 works because the NULL setting is passed back to the calling process, and
2164 remote_max_parallel is forced to 1 when delivering over an existing connection,
2166 If all went well and continue_more is set, we shouldn't actually get here if
2167 there are further addresses, as the return above will be taken. However,
2168 writing RSET might have failed, or there may be other addresses whose hosts are
2169 specified in the transports, and therefore not visible at top level, in which
2170 case continue_more won't get set. */
2172 HDEBUG(D_transport|D_acl|D_v) debug_printf_indent(" SMTP(close)>>\n");
2175 shutdown(sx->outblock.sock, SHUT_WR);
2176 if (fcntl(sx->inblock.sock, F_SETFL, O_NONBLOCK) == 0)
2177 for (rc = 16; read(sx->inblock.sock, sx->inbuffer, sizeof(sx->inbuffer)) > 0 && rc > 0;)
2178 rc--; /* drain socket */
2179 sx->send_quit = FALSE;
2181 (void)close(sx->inblock.sock);
2182 sx->inblock.sock = sx->outblock.sock = -1;
2184 #ifndef DISABLE_EVENT
2185 (void) event_raise(sx->tblock->event_action, US"tcp:close", NULL);
2188 continue_transport = NULL;
2189 continue_hostname = NULL;
2196 /* Create the string of options that will be appended to the MAIL FROM:
2197 in the connection context buffer */
2200 build_mailcmd_options(smtp_context * sx, address_item * addrlist)
2202 uschar * p = sx->buffer;
2203 address_item * addr;
2208 /* If we know the receiving MTA supports the SIZE qualification, and we know it,
2209 send it, adding something to the message size to allow for imprecision
2210 and things that get added en route. Exim keeps the number of lines
2211 in a message, so we can give an accurate value for the original message, but we
2212 need some additional to handle added headers. (Double "." characters don't get
2213 included in the count.) */
2215 if ( message_size > 0
2216 && sx->peer_offered & OPTION_SIZE && !(sx->avoid_option & OPTION_SIZE))
2218 sprintf(CS p, " SIZE=%d", message_size+message_linecount+sx->ob->size_addition);
2222 #ifndef DISABLE_PRDR
2223 /* If it supports Per-Recipient Data Reponses, and we have omre than one recipient,
2226 sx->prdr_active = FALSE;
2227 if (sx->peer_offered & OPTION_PRDR)
2228 for (addr = addrlist; addr; addr = addr->next)
2229 if (addr->transport_return == PENDING_DEFER)
2231 for (addr = addr->next; addr; addr = addr->next)
2232 if (addr->transport_return == PENDING_DEFER)
2233 { /* at least two recipients to send */
2234 sx->prdr_active = TRUE;
2235 sprintf(CS p, " PRDR"); p += 5;
2243 /* If it supports internationalised messages, and this meesage need that,
2246 if ( sx->peer_offered & OPTION_UTF8
2247 && addrlist->prop.utf8_msg
2248 && !addrlist->prop.utf8_downcvt
2250 Ustrcpy(p, " SMTPUTF8"), p += 9;
2253 /* check if all addresses have DSN-lasthop flag; do not send RET and ENVID if so */
2254 for (sx->dsn_all_lasthop = TRUE, addr = addrlist, address_count = 0;
2255 addr && address_count < sx->max_rcpt;
2256 addr = addr->next) if (addr->transport_return == PENDING_DEFER)
2259 if (!(addr->dsn_flags & rf_dsnlasthop))
2261 sx->dsn_all_lasthop = FALSE;
2266 /* Add any DSN flags to the mail command */
2268 if (sx->peer_offered & OPTION_DSN && !sx->dsn_all_lasthop)
2270 if (dsn_ret == dsn_ret_hdrs)
2271 { Ustrcpy(p, " RET=HDRS"); p += 9; }
2272 else if (dsn_ret == dsn_ret_full)
2273 { Ustrcpy(p, " RET=FULL"); p += 9; }
2277 string_format(p, sizeof(sx->buffer) - (p-sx->buffer), " ENVID=%s", dsn_envid);
2282 /* If an authenticated_sender override has been specified for this transport
2283 instance, expand it. If the expansion is forced to fail, and there was already
2284 an authenticated_sender for this message, the original value will be used.
2285 Other expansion failures are serious. An empty result is ignored, but there is
2286 otherwise no check - this feature is expected to be used with LMTP and other
2287 cases where non-standard addresses (e.g. without domains) might be required. */
2289 if (smtp_mail_auth_str(p, sizeof(sx->buffer) - (p-sx->buffer), addrlist, sx->ob))
2297 build_rcptcmd_options(smtp_context * sx, const address_item * addr)
2299 uschar * p = sx->buffer;
2302 /* Add any DSN flags to the rcpt command */
2304 if (sx->peer_offered & OPTION_DSN && !(addr->dsn_flags & rf_dsnlasthop))
2306 if (addr->dsn_flags & rf_dsnflags)
2311 Ustrcpy(p, " NOTIFY=");
2313 for (i = 0; i < nelem(rf_list); i++) if (addr->dsn_flags & rf_list[i])
2315 if (!first) *p++ = ',';
2317 Ustrcpy(p, rf_names[i]);
2322 if (addr->dsn_orcpt)
2324 string_format(p, sizeof(sx->buffer) - (p-sx->buffer), " ORCPT=%s",
2335 0 good, rcpt results in addr->transport_return (PENDING_OK, DEFER, FAIL)
2336 -1 MAIL response error
2337 -2 any non-MAIL read i/o error
2338 -3 non-MAIL response timeout
2339 -4 internal error; channel still usable
2344 smtp_write_mail_and_rcpt_cmds(smtp_context * sx, int * yield)
2346 address_item * addr;
2350 if (build_mailcmd_options(sx, sx->first_addr) != OK)
2356 /* From here until we send the DATA command, we can make use of PIPELINING
2357 if the server host supports it. The code has to be able to check the responses
2358 at any point, for when the buffer fills up, so we write it totally generally.
2359 When PIPELINING is off, each command written reports that it has flushed the
2362 sx->pending_MAIL = TRUE; /* The block starts with MAIL */
2365 uschar * s = sx->from_addr;
2367 uschar * errstr = NULL;
2369 /* If we must downconvert, do the from-address here. Remember we had to
2370 for the to-addresses (done below), and also (ugly) for re-doing when building
2371 the delivery log line. */
2373 if ( sx->addrlist->prop.utf8_msg
2374 && (sx->addrlist->prop.utf8_downcvt || !(sx->peer_offered & OPTION_UTF8))
2377 if (s = string_address_utf8_to_alabel(s, &errstr), errstr)
2379 set_errno_nohost(sx->addrlist, ERRNO_EXPANDFAIL, errstr, DEFER, FALSE);
2383 setflag(sx->addrlist, af_utf8_downcvt);
2387 rc = smtp_write_command(&sx->outblock, pipelining_active,
2388 "MAIL FROM:<%s>%s\r\n", s, sx->buffer);
2391 mail_command = string_copy(big_buffer); /* Save for later error message */
2395 case -1: /* Transmission error */
2398 case +1: /* Cmd was sent */
2399 if (!smtp_read_response(&sx->inblock, sx->buffer, sizeof(sx->buffer), '2',
2400 sx->ob->command_timeout))
2402 if (errno == 0 && sx->buffer[0] == '4')
2404 errno = ERRNO_MAIL4XX;
2405 sx->addrlist->more_errno |= ((sx->buffer[1] - '0')*10 + sx->buffer[2] - '0') << 8;
2409 sx->pending_MAIL = FALSE;
2412 /* otherwise zero: command queued for pipeline */
2415 /* Pass over all the relevant recipient addresses for this host, which are the
2416 ones that have status PENDING_DEFER. If we are using PIPELINING, we can send
2417 several before we have to read the responses for those seen so far. This
2418 checking is done by a subroutine because it also needs to be done at the end.
2419 Send only up to max_rcpt addresses at a time, leaving next_addr pointing to
2420 the next one if not all are sent.
2422 In the MUA wrapper situation, we want to flush the PIPELINING buffer for the
2423 last address because we want to abort if any recipients have any kind of
2424 problem, temporary or permanent. We know that all recipient addresses will have
2425 the PENDING_DEFER status, because only one attempt is ever made, and we know
2426 that max_rcpt will be large, so all addresses will be done at once.
2428 For verify we flush the pipeline after any (the only) rcpt address. */
2430 for (addr = sx->first_addr, address_count = 0;
2431 addr && address_count < sx->max_rcpt;
2432 addr = addr->next) if (addr->transport_return == PENDING_DEFER)
2438 addr->dsn_aware = sx->peer_offered & OPTION_DSN
2439 ? dsn_support_yes : dsn_support_no;
2442 no_flush = pipelining_active && !sx->verify
2443 && (!mua_wrapper || addr->next && address_count < sx->max_rcpt);
2445 build_rcptcmd_options(sx, addr);
2447 /* Now send the RCPT command, and process outstanding responses when
2448 necessary. After a timeout on RCPT, we just end the function, leaving the
2449 yield as OK, because this error can often mean that there is a problem with
2450 just one address, so we don't want to delay the host. */
2452 rcpt_addr = transport_rcpt_address(addr, sx->tblock->rcpt_include_affixes);
2455 if ( testflag(sx->addrlist, af_utf8_downcvt)
2456 && !(rcpt_addr = string_address_utf8_to_alabel(rcpt_addr, NULL))
2459 /*XXX could we use a per-address errstr here? Not fail the whole send? */
2460 errno = ERRNO_EXPANDFAIL;
2461 return -5; /*XXX too harsh? */
2465 count = smtp_write_command(&sx->outblock, no_flush, "RCPT TO:<%s>%s%s\r\n",
2466 rcpt_addr, sx->igquotstr, sx->buffer);
2468 if (count < 0) return -5;
2471 switch(sync_responses(sx, count, 0))
2473 case 3: sx->ok = TRUE; /* 2xx & 5xx => OK & progress made */
2474 case 2: sx->completed_addr = TRUE; /* 5xx (only) => progress made */
2477 case 1: sx->ok = TRUE; /* 2xx (only) => OK, but if LMTP, */
2478 if (!sx->lmtp) /* can't tell about progress yet */
2479 sx->completed_addr = TRUE;
2480 case 0: /* No 2xx or 5xx, but no probs */
2483 case -1: return -3; /* Timeout on RCPT */
2484 case -2: return -2; /* non-MAIL read i/o error */
2485 default: return -1; /* any MAIL error */
2487 sx->pending_MAIL = FALSE; /* Dealt with MAIL */
2489 } /* Loop for next address */
2491 sx->next_addr = addr;
2496 /*************************************************
2497 * Deliver address list to given host *
2498 *************************************************/
2500 /* If continue_hostname is not null, we get here only when continuing to
2501 deliver down an existing channel. The channel was passed as the standard
2502 input. TLS is never active on a passed channel; the previous process always
2503 closes it down before passing the connection on.
2505 Otherwise, we have to make a connection to the remote host, and do the
2506 initial protocol exchange.
2508 When running as an MUA wrapper, if the sender or any recipient is rejected,
2509 temporarily or permanently, we force failure for all recipients.
2512 addrlist chain of potential addresses to deliver; only those whose
2513 transport_return field is set to PENDING_DEFER are currently
2514 being processed; others should be skipped - they have either
2515 been delivered to an earlier host or IP address, or been
2516 failed by one of them.
2517 host host to deliver to
2518 host_af AF_INET or AF_INET6
2519 port default TCP/IP port to use, in host byte order
2520 interface interface to bind to, or NULL
2521 tblock transport instance block
2522 message_defer set TRUE if yield is OK, but all addresses were deferred
2523 because of a non-recipient, non-host failure, that is, a
2524 4xx response to MAIL FROM, DATA, or ".". This is a defer
2525 that is specific to the message.
2526 suppress_tls if TRUE, don't attempt a TLS connection - this is set for
2527 a second attempt after TLS initialization fails
2529 Returns: OK - the connection was made and the delivery attempted;
2530 the result for each address is in its data block.
2531 DEFER - the connection could not be made, or something failed
2532 while setting up the SMTP session, or there was a
2533 non-message-specific error, such as a timeout.
2534 ERROR - a filter command is specified for this transport,
2535 and there was a problem setting it up; OR helo_data
2536 or add_headers or authenticated_sender is specified
2537 for this transport, and the string failed to expand
2541 smtp_deliver(address_item *addrlist, host_item *host, int host_af, int port,
2542 uschar *interface, transport_instance *tblock,
2543 BOOL *message_defer, BOOL suppress_tls)
2549 time_t start_delivery_time = time(NULL);
2551 BOOL pass_message = FALSE;
2552 uschar *message = NULL;
2553 uschar new_message_id[MESSAGE_ID_LENGTH + 1];
2558 suppress_tls = suppress_tls; /* stop compiler warning when no TLS support */
2559 *message_defer = FALSE;
2561 sx.addrlist = addrlist;
2563 sx.host_af = host_af,
2565 sx.interface = interface;
2566 sx.helo_data = NULL;
2570 /* Get the channel set up ready for a message (MAIL FROM being the next
2571 SMTP command to send */
2573 if ((rc = smtp_setup_conn(&sx, suppress_tls)) != OK)
2576 /* If there is a filter command specified for this transport, we can now
2577 set it up. This cannot be done until the identify of the host is known. */
2579 if (tblock->filter_command)
2583 sprintf(CS fbuf, "%.50s transport", tblock->name);
2584 rc = transport_set_up_command(&transport_filter_argv, tblock->filter_command,
2585 TRUE, DEFER, addrlist, fbuf, NULL);
2586 transport_filter_timeout = tblock->filter_timeout;
2588 /* On failure, copy the error to all addresses, abandon the SMTP call, and
2593 set_errno_nohost(addrlist->next, addrlist->basic_errno, addrlist->message, DEFER,
2599 if ( transport_filter_argv
2600 && *transport_filter_argv
2601 && **transport_filter_argv
2602 && sx.peer_offered & OPTION_CHUNKING
2605 sx.peer_offered &= ~OPTION_CHUNKING;
2606 DEBUG(D_transport) debug_printf("CHUNKING not usable due to transport filter\n");
2611 /* For messages that have more than the maximum number of envelope recipients,
2612 we want to send several transactions down the same SMTP connection. (See
2613 comments in deliver.c as to how this reconciles, heuristically, with
2614 remote_max_parallel.) This optimization was added to Exim after the following
2615 code was already working. The simplest way to put it in without disturbing the
2616 code was to use a goto to jump back to this point when there is another
2617 transaction to handle. */
2620 sx.from_addr = return_path;
2621 sx.first_addr = sx.sync_addr = addrlist;
2623 sx.send_rset = TRUE;
2624 sx.completed_addr = FALSE;
2627 /* Initiate a message transfer. */
2629 switch(smtp_write_mail_and_rcpt_cmds(&sx, &yield))
2632 case -1: case -2: goto RESPONSE_FAILED;
2633 case -3: goto END_OFF;
2634 case -4: goto SEND_QUIT;
2635 default: goto SEND_FAILED;
2638 /* If we are an MUA wrapper, abort if any RCPTs were rejected, either
2639 permanently or temporarily. We should have flushed and synced after the last
2647 for (a = sx.first_addr, cnt = 0; a && cnt < sx.max_rcpt; a = a->next, cnt++)
2648 if (a->transport_return != PENDING_OK)
2650 /*XXX could we find a better errno than 0 here? */
2651 set_errno_nohost(addrlist, 0, a->message, FAIL,
2652 testflag(a, af_pass_message));
2658 /* If ok is TRUE, we know we have got at least one good recipient, and must now
2659 send DATA, but if it is FALSE (in the normal, non-wrapper case), we may still
2660 have a good recipient buffered up if we are pipelining. We don't want to waste
2661 time sending DATA needlessly, so we only send it if either ok is TRUE or if we
2662 are pipelining. The responses are all handled by sync_responses().
2663 If using CHUNKING, do not send a BDAT until we know how big a chunk we want
2666 if ( !(sx.peer_offered & OPTION_CHUNKING)
2667 && (sx.ok || (pipelining_active && !mua_wrapper)))
2669 int count = smtp_write_command(&sx.outblock, FALSE, "DATA\r\n");
2671 if (count < 0) goto SEND_FAILED;
2672 switch(sync_responses(&sx, count, sx.ok ? +1 : -1))
2674 case 3: sx.ok = TRUE; /* 2xx & 5xx => OK & progress made */
2675 case 2: sx.completed_addr = TRUE; /* 5xx (only) => progress made */
2678 case 1: sx.ok = TRUE; /* 2xx (only) => OK, but if LMTP, */
2679 if (!sx.lmtp) sx.completed_addr = TRUE; /* can't tell about progress yet */
2680 case 0: break; /* No 2xx or 5xx, but no probs */
2682 case -1: goto END_OFF; /* Timeout on RCPT */
2683 default: goto RESPONSE_FAILED; /* I/O error, or any MAIL/DATA error */
2685 pipelining_active = FALSE;
2686 data_command = string_copy(big_buffer); /* Save for later error message */
2689 /* If there were no good recipients (but otherwise there have been no
2690 problems), just set ok TRUE, since we have handled address-specific errors
2691 already. Otherwise, it's OK to send the message. Use the check/escape mechanism
2692 for handling the SMTP dot-handling protocol, flagging to apply to headers as
2693 well as body. Set the appropriate timeout value to be used for each chunk.
2694 (Haven't been able to make it work using select() for writing yet.) */
2696 if (!(sx.peer_offered & OPTION_CHUNKING) && !sx.ok)
2698 /* Save the first address of the next batch. */
2699 sx.first_addr = sx.next_addr;
2705 transport_ctx tctx = {
2708 US".", US"..", /* Escaping strings */
2709 topt_use_crlf | topt_escape_headers
2710 | (tblock->body_only ? topt_no_headers : 0)
2711 | (tblock->headers_only ? topt_no_body : 0)
2712 | (tblock->return_path_add ? topt_add_return_path : 0)
2713 | (tblock->delivery_date_add ? topt_add_delivery_date : 0)
2714 | (tblock->envelope_to_add ? topt_add_envelope_to : 0)
2717 /* If using CHUNKING we need a callback from the generic transport
2718 support to us, for the sending of BDAT smtp commands and the reaping
2719 of responses. The callback needs a whole bunch of state so set up
2720 a transport-context structure to be passed around. */
2722 if (sx.peer_offered & OPTION_CHUNKING)
2724 tctx.check_string = tctx.escape_string = NULL;
2725 tctx.options |= topt_use_bdat;
2726 tctx.chunk_cb = smtp_chunk_cmd_callback;
2727 sx.pending_BDAT = FALSE;
2728 sx.good_RCPT = sx.ok;
2730 tctx.smtp_context = &sx;
2733 tctx.options |= topt_end_dot;
2735 /* Save the first address of the next batch. */
2736 sx.first_addr = sx.next_addr;
2738 /* Responses from CHUNKING commands go in buffer. Otherwise,
2739 there has not been a response. */
2743 sigalrm_seen = FALSE;
2744 transport_write_timeout = sx.ob->data_timeout;
2745 smtp_command = US"sending data block"; /* For error messages */
2746 DEBUG(D_transport|D_v)
2747 if (sx.peer_offered & OPTION_CHUNKING)
2748 debug_printf(" will write message using CHUNKING\n");
2750 debug_printf(" SMTP>> writing message and terminating \".\"\n");
2751 transport_count = 0;
2753 #ifndef DISABLE_DKIM
2754 sx.ok = dkim_transport_write_message(sx.inblock.sock, &tctx, &sx.ob->dkim);
2756 sx.ok = transport_write_message(sx.inblock.sock, &tctx, 0);
2759 /* transport_write_message() uses write() because it is called from other
2760 places to write to non-sockets. This means that under some OS (e.g. Solaris)
2761 it can exit with "Broken pipe" as its error. This really means that the
2762 socket got closed at the far end. */
2764 transport_write_timeout = 0; /* for subsequent transports */
2766 /* Failure can either be some kind of I/O disaster (including timeout),
2767 or the failure of a transport filter or the expansion of added headers.
2768 Or, when CHUNKING, it can be a protocol-detected failure. */
2771 goto RESPONSE_FAILED;
2773 /* We used to send the terminating "." explicitly here, but because of
2774 buffering effects at both ends of TCP/IP connections, you don't gain
2775 anything by keeping it separate, so it might as well go in the final
2776 data buffer for efficiency. This is now done by setting the topt_end_dot
2779 smtp_command = US"end of data";
2781 if (sx.peer_offered & OPTION_CHUNKING && sx.cmd_count > 1)
2783 /* Reap any outstanding MAIL & RCPT commands, but not a DATA-go-ahead */
2784 switch(sync_responses(&sx, sx.cmd_count-1, 0))
2786 case 3: sx.ok = TRUE; /* 2xx & 5xx => OK & progress made */
2787 case 2: sx.completed_addr = TRUE; /* 5xx (only) => progress made */
2790 case 1: sx.ok = TRUE; /* 2xx (only) => OK, but if LMTP, */
2791 if (!sx.lmtp) sx.completed_addr = TRUE; /* can't tell about progress yet */
2792 case 0: break; /* No 2xx or 5xx, but no probs */
2794 case -1: goto END_OFF; /* Timeout on RCPT */
2795 default: goto RESPONSE_FAILED; /* I/O error, or any MAIL/DATA error */
2799 #ifndef DISABLE_PRDR
2800 /* For PRDR we optionally get a partial-responses warning
2801 * followed by the individual responses, before going on with
2802 * the overall response. If we don't get the warning then deal
2803 * with per non-PRDR. */
2806 sx.ok = smtp_read_response(&sx.inblock, sx.buffer, sizeof(sx.buffer), '3',
2807 sx.ob->final_timeout);
2808 if (!sx.ok && errno == 0) switch(sx.buffer[0])
2810 case '2': sx.prdr_active = FALSE;
2813 case '4': errno = ERRNO_DATA4XX;
2814 addrlist->more_errno |=
2815 ((sx.buffer[1] - '0')*10 + sx.buffer[2] - '0') << 8;
2822 /* For non-PRDR SMTP, we now read a single response that applies to the
2823 whole message. If it is OK, then all the addresses have been delivered. */
2827 sx.ok = smtp_read_response(&sx.inblock, sx.buffer, sizeof(sx.buffer), '2',
2828 sx.ob->final_timeout);
2829 if (!sx.ok && errno == 0 && sx.buffer[0] == '4')
2831 errno = ERRNO_DATA4XX;
2832 addrlist->more_errno |= ((sx.buffer[1] - '0')*10 + sx.buffer[2] - '0') << 8;
2836 /* For LMTP, we get back a response for every RCPT command that we sent;
2837 some may be accepted and some rejected. For those that get a response, their
2838 status is fixed; any that are accepted have been handed over, even if later
2839 responses crash - at least, that's how I read RFC 2033.
2841 If all went well, mark the recipient addresses as completed, record which
2842 host/IPaddress they were delivered to, and cut out RSET when sending another
2843 message down the same channel. Write the completed addresses to the journal
2844 now so that they are recorded in case there is a crash of hardware or
2845 software before the spool gets updated. Also record the final SMTP
2846 confirmation if needed (for SMTP only). */
2851 int delivery_time = (int)(time(NULL) - start_delivery_time);
2853 uschar *conf = NULL;
2855 sx.send_rset = FALSE;
2856 pipelining_active = FALSE;
2858 /* Set up confirmation if needed - applies only to SMTP */
2861 #ifdef DISABLE_EVENT
2862 LOGGING(smtp_confirmation) &&
2867 const uschar *s = string_printing(sx.buffer);
2868 /* deconst cast ok here as string_printing was checked to have alloc'n'copied */
2869 conf = (s == sx.buffer)? (uschar *)string_copy(s) : US s;
2872 /* Process all transported addresses - for LMTP or PRDR, read a status for
2875 for (addr = addrlist; addr != sx.first_addr; addr = addr->next)
2877 if (addr->transport_return != PENDING_OK) continue;
2879 /* LMTP - if the response fails badly (e.g. timeout), use it for all the
2880 remaining addresses. Otherwise, it's a return code for just the one
2881 address. For temporary errors, add a retry item for the address so that
2882 it doesn't get tried again too soon. */
2884 #ifndef DISABLE_PRDR
2885 if (sx.lmtp || sx.prdr_active)
2890 if (!smtp_read_response(&sx.inblock, sx.buffer, sizeof(sx.buffer), '2',
2891 sx.ob->final_timeout))
2893 if (errno != 0 || sx.buffer[0] == 0) goto RESPONSE_FAILED;
2894 addr->message = string_sprintf(
2895 #ifndef DISABLE_PRDR
2896 "%s error after %s: %s", sx.prdr_active ? "PRDR":"LMTP",
2898 "LMTP error after %s: %s",
2900 data_command, string_printing(sx.buffer));
2901 setflag(addr, af_pass_message); /* Allow message to go to user */
2902 if (sx.buffer[0] == '5')
2903 addr->transport_return = FAIL;
2906 errno = ERRNO_DATA4XX;
2907 addr->more_errno |= ((sx.buffer[1] - '0')*10 + sx.buffer[2] - '0') << 8;
2908 addr->transport_return = DEFER;
2909 #ifndef DISABLE_PRDR
2910 if (!sx.prdr_active)
2912 retry_add_item(addr, addr->address_retry_key, 0);
2916 sx.completed_addr = TRUE; /* NOW we can set this flag */
2917 if (LOGGING(smtp_confirmation))
2919 const uschar *s = string_printing(sx.buffer);
2920 /* deconst cast ok here as string_printing was checked to have alloc'n'copied */
2921 conf = (s == sx.buffer) ? US string_copy(s) : US s;
2925 /* SMTP, or success return from LMTP for this address. Pass back the
2926 actual host that was used. */
2928 addr->transport_return = OK;
2929 addr->more_errno = delivery_time;
2930 addr->host_used = host;
2931 addr->special_action = flag;
2932 addr->message = conf;
2933 #ifndef DISABLE_PRDR
2934 if (sx.prdr_active) addr->flags |= af_prdr_used;
2936 if (sx.peer_offered & OPTION_CHUNKING) addr->flags |= af_chunking_used;
2939 #ifndef DISABLE_PRDR
2940 if (!sx.prdr_active)
2943 /* Update the journal. For homonymic addresses, use the base address plus
2944 the transport name. See lots of comments in deliver.c about the reasons
2945 for the complications when homonyms are involved. Just carry on after
2946 write error, as it may prove possible to update the spool file later. */
2948 if (testflag(addr, af_homonym))
2949 sprintf(CS sx.buffer, "%.500s/%s\n", addr->unique + 3, tblock->name);
2951 sprintf(CS sx.buffer, "%.500s\n", addr->unique);
2953 DEBUG(D_deliver) debug_printf("journalling %s\n", sx.buffer);
2954 len = Ustrlen(CS sx.buffer);
2955 if (write(journal_fd, sx.buffer, len) != len)
2956 log_write(0, LOG_MAIN|LOG_PANIC, "failed to write journal for "
2957 "%s: %s", sx.buffer, strerror(errno));
2961 #ifndef DISABLE_PRDR
2964 /* PRDR - get the final, overall response. For any non-success
2965 upgrade all the address statuses. */
2966 sx.ok = smtp_read_response(&sx.inblock, sx.buffer, sizeof(sx.buffer), '2',
2967 sx.ob->final_timeout);
2970 if(errno == 0 && sx.buffer[0] == '4')
2972 errno = ERRNO_DATA4XX;
2973 addrlist->more_errno |= ((sx.buffer[1] - '0')*10 + sx.buffer[2] - '0') << 8;
2975 for (addr = addrlist; addr != sx.first_addr; addr = addr->next)
2976 if (sx.buffer[0] == '5' || addr->transport_return == OK)
2977 addr->transport_return = PENDING_OK; /* allow set_errno action */
2978 goto RESPONSE_FAILED;
2981 /* Update the journal, or setup retry. */
2982 for (addr = addrlist; addr != sx.first_addr; addr = addr->next)
2983 if (addr->transport_return == OK)
2985 if (testflag(addr, af_homonym))
2986 sprintf(CS sx.buffer, "%.500s/%s\n", addr->unique + 3, tblock->name);
2988 sprintf(CS sx.buffer, "%.500s\n", addr->unique);
2990 DEBUG(D_deliver) debug_printf("journalling(PRDR) %s\n", sx.buffer);
2991 len = Ustrlen(CS sx.buffer);
2992 if (write(journal_fd, sx.buffer, len) != len)
2993 log_write(0, LOG_MAIN|LOG_PANIC, "failed to write journal for "
2994 "%s: %s", sx.buffer, strerror(errno));
2996 else if (addr->transport_return == DEFER)
2997 retry_add_item(addr, addr->address_retry_key, -2);
3001 /* Ensure the journal file is pushed out to disk. */
3003 if (EXIMfsync(journal_fd) < 0)
3004 log_write(0, LOG_MAIN|LOG_PANIC, "failed to fsync journal: %s",
3010 /* Handle general (not specific to one address) failures here. The value of ok
3011 is used to skip over this code on the falling through case. A timeout causes a
3012 deferral. Other errors may defer or fail according to the response code, and
3013 may set up a special errno value, e.g. after connection chopped, which is
3014 assumed if errno == 0 and there is no text in the buffer. If control reaches
3015 here during the setting up phase (i.e. before MAIL FROM) then always defer, as
3016 the problem is not related to this specific message. */
3021 uschar * set_message;
3027 sx.send_quit = check_response(host, &save_errno, addrlist->more_errno,
3028 sx.buffer, &code, &message, &pass_message);
3036 message = US string_sprintf("send() to %s [%s] failed: %s",
3037 host->name, host->address, strerror(save_errno));
3038 sx.send_quit = FALSE;
3046 sx.ok = FALSE; /* For when reached by GOTO */
3047 set_message = message;
3049 /* We want to handle timeouts after MAIL or "." and loss of connection after
3050 "." specially. They can indicate a problem with the sender address or with
3051 the contents of the message rather than a real error on the connection. These
3052 cases are treated in the same way as a 4xx response. This next bit of code
3053 does the classification. */
3060 message_error = TRUE;
3064 message_error = Ustrncmp(smtp_command,"MAIL",4) == 0 ||
3065 Ustrncmp(smtp_command,"end ",4) == 0;
3068 case ERRNO_SMTPCLOSED:
3069 message_error = Ustrncmp(smtp_command,"end ",4) == 0;
3073 message_error = FALSE;
3077 /* Handle the cases that are treated as message errors. These are:
3079 (a) negative response or timeout after MAIL
3080 (b) negative response after DATA
3081 (c) negative response or timeout or dropped connection after "."
3082 (d) utf8 support required and not offered
3084 It won't be a negative response or timeout after RCPT, as that is dealt
3085 with separately above. The action in all cases is to set an appropriate
3086 error code for all the addresses, but to leave yield set to OK because the
3087 host itself has not failed. Of course, it might in practice have failed
3088 when we've had a timeout, but if so, we'll discover that at the next
3089 delivery attempt. For a temporary error, set the message_defer flag, and
3090 write to the logs for information if this is not the last host. The error
3091 for the last host will be logged as part of the address's log line. */
3095 if (mua_wrapper) code = '5'; /* Force hard failure in wrapper mode */
3097 /* If there's an errno, the message contains just the identity of
3102 else /* Anything other than 5 is treated as temporary */
3106 message = US string_sprintf("%s: %s", message, strerror(save_errno));
3107 if (host->next != NULL) log_write(0, LOG_MAIN, "%s", message);
3108 msglog_line(host, message);
3109 *message_defer = TRUE;
3113 /* Otherwise, we have an I/O error or a timeout other than after MAIL or
3114 ".", or some other transportation error. We defer all addresses and yield
3115 DEFER, except for the case of failed add_headers expansion, or a transport
3116 filter failure, when the yield should be ERROR, to stop it trying other
3122 yield = (save_errno == ERRNO_CHHEADER_FAIL ||
3123 save_errno == ERRNO_FILTER_FAIL)? ERROR : DEFER;
3127 set_errno(addrlist, save_errno, set_message, set_rc, pass_message, host
3128 #ifdef EXPERIMENTAL_DSN_INFO
3129 , sx.smtp_greeting, sx.helo_response
3135 /* If all has gone well, send_quit will be set TRUE, implying we can end the
3136 SMTP session tidily. However, if there were too many addresses to send in one
3137 message (indicated by first_addr being non-NULL) we want to carry on with the
3138 rest of them. Also, it is desirable to send more than one message down the SMTP
3139 connection if there are several waiting, provided we haven't already sent so
3140 many as to hit the configured limit. The function transport_check_waiting looks
3141 for a waiting message and returns its id. Then transport_pass_socket tries to
3142 set up a continued delivery by passing the socket on to another process. The
3143 variable send_rset is FALSE if a message has just been successfully transfered.
3145 If we are already sending down a continued channel, there may be further
3146 addresses not yet delivered that are aimed at the same host, but which have not
3147 been passed in this run of the transport. In this case, continue_more will be
3148 true, and all we should do is send RSET if necessary, and return, leaving the
3151 However, if no address was disposed of, i.e. all addresses got 4xx errors, we
3152 do not want to continue with other messages down the same channel, because that
3153 can lead to looping between two or more messages, all with the same,
3154 temporarily failing address(es). [The retry information isn't updated yet, so
3155 new processes keep on trying.] We probably also don't want to try more of this
3156 message's addresses either.
3158 If we have started a TLS session, we have to end it before passing the
3159 connection to a new process. However, not all servers can handle this (Exim
3160 can), so we do not pass such a connection on if the host matches
3161 hosts_nopass_tls. */
3164 debug_printf("ok=%d send_quit=%d send_rset=%d continue_more=%d "
3165 "yield=%d first_address is %sNULL\n", sx.ok, sx.send_quit,
3166 sx.send_rset, continue_more, yield, sx.first_addr ? "not " : "");
3168 if (sx.completed_addr && sx.ok && sx.send_quit)
3171 smtp_compare_t t_compare;
3173 t_compare.tblock = tblock;
3174 t_compare.current_sender_address = sender_address;
3176 if ( sx.first_addr != NULL
3178 || ( ( tls_out.active < 0
3179 || verify_check_given_host(&sx.ob->hosts_nopass_tls, host) != OK
3182 transport_check_waiting(tblock->name, host->name,
3183 tblock->connection_max_messages, new_message_id, &more,
3184 (oicf)smtp_are_same_identities, (void*)&t_compare)
3191 if (! (sx.ok = smtp_write_command(&sx.outblock, FALSE, "RSET\r\n") >= 0))
3193 msg = US string_sprintf("send() to %s [%s] failed: %s", host->name,
3194 host->address, strerror(errno));
3195 sx.send_quit = FALSE;
3197 else if (! (sx.ok = smtp_read_response(&sx.inblock, sx.buffer,
3198 sizeof(sx.buffer), '2', sx.ob->command_timeout)))
3201 sx.send_quit = check_response(host, &errno, 0, sx.buffer, &code, &msg,
3205 DEBUG(D_transport) debug_printf("H=%s [%s] %s\n",
3206 host->name, host->address, msg);
3210 /* Either RSET was not needed, or it succeeded */
3214 if (sx.first_addr != NULL) /* More addresses still to be sent */
3215 { /* in this run of the transport */
3216 continue_sequence++; /* Causes * in logging */
3219 if (continue_more) return yield; /* More addresses for another run */
3221 /* Pass the socket to a new Exim process. Before doing so, we must shut
3222 down TLS. Not all MTAs allow for the continuation of the SMTP session
3223 when TLS is shut down. We test for this by sending a new EHLO. If we
3224 don't get a good response, we don't attempt to pass the socket on. */
3227 if (tls_out.active >= 0)
3229 tls_close(FALSE, TRUE);
3230 smtp_peer_options = smtp_peer_options_wrap;
3232 && smtp_write_command(&sx.outblock, FALSE,
3233 "EHLO %s\r\n", sx.helo_data) >= 0
3234 && smtp_read_response(&sx.inblock, sx.buffer, sizeof(sx.buffer),
3235 '2', sx.ob->command_timeout);
3239 /* If the socket is successfully passed, we mustn't send QUIT (or
3240 indeed anything!) from here. */
3242 /*XXX DSN_INFO: assume likely to do new HELO; but for greet we'll want to
3243 propagate it from the initial
3245 if (sx.ok && transport_pass_socket(tblock->name, host->name,
3246 host->address, new_message_id, sx.inblock.sock))
3247 sx.send_quit = FALSE;
3250 /* If RSET failed and there are addresses left, they get deferred. */
3252 else set_errno(sx.first_addr, errno, msg, DEFER, FALSE, host
3253 #ifdef EXPERIMENTAL_DSN_INFO
3254 , sx.smtp_greeting, sx.helo_response
3260 /* End off tidily with QUIT unless the connection has died or the socket has
3261 been passed to another process. There has been discussion on the net about what
3262 to do after sending QUIT. The wording of the RFC suggests that it is necessary
3263 to wait for a response, but on the other hand, there isn't anything one can do
3264 with an error response, other than log it. Exim used to do that. However,
3265 further discussion suggested that it is positively advantageous not to wait for
3266 the response, but to close the session immediately. This is supposed to move
3267 the TCP/IP TIME_WAIT state from the server to the client, thereby removing some
3268 load from the server. (Hosts that are both servers and clients may not see much
3269 difference, of course.) Further discussion indicated that this was safe to do
3270 on Unix systems which have decent implementations of TCP/IP that leave the
3271 connection around for a while (TIME_WAIT) after the application has gone away.
3272 This enables the response sent by the server to be properly ACKed rather than
3273 timed out, as can happen on broken TCP/IP implementations on other OS.
3275 This change is being made on 31-Jul-98. After over a year of trouble-free
3276 operation, the old commented-out code was removed on 17-Sep-99. */
3279 if (sx.send_quit) (void)smtp_write_command(&sx.outblock, FALSE, "QUIT\r\n");
3284 tls_close(FALSE, TRUE);
3287 /* Close the socket, and return the appropriate value, first setting
3288 works because the NULL setting is passed back to the calling process, and
3289 remote_max_parallel is forced to 1 when delivering over an existing connection,
3291 If all went well and continue_more is set, we shouldn't actually get here if
3292 there are further addresses, as the return above will be taken. However,
3293 writing RSET might have failed, or there may be other addresses whose hosts are
3294 specified in the transports, and therefore not visible at top level, in which
3295 case continue_more won't get set. */
3297 HDEBUG(D_transport|D_acl|D_v) debug_printf_indent(" SMTP(close)>>\n");
3300 shutdown(sx.outblock.sock, SHUT_WR);
3301 if (fcntl(sx.inblock.sock, F_SETFL, O_NONBLOCK) == 0)
3302 for (rc = 16; read(sx.inblock.sock, sx.inbuffer, sizeof(sx.inbuffer)) > 0 && rc > 0;)
3303 rc--; /* drain socket */
3305 (void)close(sx.inblock.sock);
3307 #ifndef DISABLE_EVENT
3308 (void) event_raise(tblock->event_action, US"tcp:close", NULL);
3311 continue_transport = NULL;
3312 continue_hostname = NULL;
3319 /*************************************************
3320 * Closedown entry point *
3321 *************************************************/
3323 /* This function is called when exim is passed an open smtp channel
3324 from another incarnation, but the message which it has been asked
3325 to deliver no longer exists. The channel is on stdin.
3327 We might do fancy things like looking for another message to send down
3328 the channel, but if the one we sought has gone, it has probably been
3329 delivered by some other process that itself will seek further messages,
3330 so just close down our connection.
3332 Argument: pointer to the transport instance block
3337 smtp_transport_closedown(transport_instance *tblock)
3339 smtp_transport_options_block *ob =
3340 (smtp_transport_options_block *)tblock->options_block;
3341 smtp_inblock inblock;
3342 smtp_outblock outblock;
3344 uschar inbuffer[4096];
3345 uschar outbuffer[16];
3347 inblock.sock = fileno(stdin);
3348 inblock.buffer = inbuffer;
3349 inblock.buffersize = sizeof(inbuffer);
3350 inblock.ptr = inbuffer;
3351 inblock.ptrend = inbuffer;
3353 outblock.sock = inblock.sock;
3354 outblock.buffersize = sizeof(outbuffer);
3355 outblock.buffer = outbuffer;
3356 outblock.ptr = outbuffer;
3357 outblock.cmd_count = 0;
3358 outblock.authenticating = FALSE;
3360 (void)smtp_write_command(&outblock, FALSE, "QUIT\r\n");
3361 (void)smtp_read_response(&inblock, buffer, sizeof(buffer), '2',
3362 ob->command_timeout);
3363 (void)close(inblock.sock);
3368 /*************************************************
3369 * Prepare addresses for delivery *
3370 *************************************************/
3372 /* This function is called to flush out error settings from previous delivery
3373 attempts to other hosts. It also records whether we got here via an MX record
3374 or not in the more_errno field of the address. We are interested only in
3375 addresses that are still marked DEFER - others may have got delivered to a
3376 previously considered IP address. Set their status to PENDING_DEFER to indicate
3377 which ones are relevant this time.
3380 addrlist the list of addresses
3381 host the host we are delivering to
3383 Returns: the first address for this delivery
3386 static address_item *
3387 prepare_addresses(address_item *addrlist, host_item *host)
3389 address_item *first_addr = NULL;
3391 for (addr = addrlist; addr; addr = addr->next)
3392 if (addr->transport_return == DEFER)
3394 if (!first_addr) first_addr = addr;
3395 addr->transport_return = PENDING_DEFER;
3396 addr->basic_errno = 0;
3397 addr->more_errno = (host->mx >= 0)? 'M' : 'A';
3398 addr->message = NULL;
3400 addr->cipher = NULL;
3401 addr->ourcert = NULL;
3402 addr->peercert = NULL;
3403 addr->peerdn = NULL;
3404 addr->ocsp = OCSP_NOT_REQ;
3406 #ifdef EXPERIMENTAL_DSN_INFO
3407 addr->smtp_greeting = NULL;
3408 addr->helo_response = NULL;
3416 /*************************************************
3417 * Main entry point *
3418 *************************************************/
3420 /* See local README for interface details. As this is a remote transport, it is
3421 given a chain of addresses to be delivered in one connection, if possible. It
3422 always returns TRUE, indicating that each address has its own independent
3423 status set, except if there is a setting up problem, in which case it returns
3427 smtp_transport_entry(
3428 transport_instance *tblock, /* data for this instantiation */
3429 address_item *addrlist) /* addresses we are working on */
3433 int hosts_defer = 0;
3435 int hosts_looked_up = 0;
3436 int hosts_retry = 0;
3437 int hosts_serial = 0;
3438 int hosts_total = 0;
3439 int total_hosts_tried = 0;
3441 BOOL expired = TRUE;
3442 uschar *expanded_hosts = NULL;
3444 uschar *tid = string_sprintf("%s transport", tblock->name);
3445 smtp_transport_options_block *ob =
3446 (smtp_transport_options_block *)(tblock->options_block);
3447 host_item *hostlist = addrlist->host_list;
3448 host_item *host = NULL;
3452 debug_printf("%s transport entered\n", tblock->name);
3453 for (addr = addrlist; addr; addr = addr->next)
3454 debug_printf(" %s\n", addr->address);
3457 debug_printf("hostlist:\n");
3458 for (host = hostlist; host; host = host->next)
3459 debug_printf(" %s:%d\n", host->name, host->port);
3461 if (continue_hostname) debug_printf("already connected to %s [%s]\n",
3462 continue_hostname, continue_host_address);
3465 /* Set the flag requesting that these hosts be added to the waiting
3466 database if the delivery fails temporarily or if we are running with
3467 queue_smtp or a 2-stage queue run. This gets unset for certain
3468 kinds of error, typically those that are specific to the message. */
3470 update_waiting = TRUE;
3472 /* If a host list is not defined for the addresses - they must all have the
3473 same one in order to be passed to a single transport - or if the transport has
3474 a host list with hosts_override set, use the host list supplied with the
3475 transport. It is an error for this not to exist. */
3477 if (!hostlist || (ob->hosts_override && ob->hosts))
3481 addrlist->message = string_sprintf("%s transport called with no hosts set",
3483 addrlist->transport_return = PANIC;
3484 return FALSE; /* Only top address has status */
3487 DEBUG(D_transport) debug_printf("using the transport's hosts: %s\n",
3490 /* If the transport's host list contains no '$' characters, and we are not
3491 randomizing, it is fixed and therefore a chain of hosts can be built once
3492 and for all, and remembered for subsequent use by other calls to this
3493 transport. If, on the other hand, the host list does contain '$', or we are
3494 randomizing its order, we have to rebuild it each time. In the fixed case,
3495 as the hosts string will never be used again, it doesn't matter that we
3496 replace all the : characters with zeros. */
3500 uschar *s = ob->hosts;
3502 if (Ustrchr(s, '$') != NULL)
3504 if (!(expanded_hosts = expand_string(s)))
3506 addrlist->message = string_sprintf("failed to expand list of hosts "
3507 "\"%s\" in %s transport: %s", s, tblock->name, expand_string_message);
3508 addrlist->transport_return = search_find_defer ? DEFER : PANIC;
3509 return FALSE; /* Only top address has status */
3511 DEBUG(D_transport) debug_printf("expanded list of hosts \"%s\" to "
3512 "\"%s\"\n", s, expanded_hosts);
3516 if (ob->hosts_randomize) s = expanded_hosts = string_copy(s);
3518 host_build_hostlist(&hostlist, s, ob->hosts_randomize);
3520 /* Check that the expansion yielded something useful. */
3524 string_sprintf("%s transport has empty hosts setting", tblock->name);
3525 addrlist->transport_return = PANIC;
3526 return FALSE; /* Only top address has status */
3529 /* If there was no expansion of hosts, save the host list for
3532 if (!expanded_hosts) ob->hostlist = hostlist;
3535 /* This is not the first time this transport has been run in this delivery;
3536 the host list was built previously. */
3539 hostlist = ob->hostlist;
3542 /* The host list was supplied with the address. If hosts_randomize is set, we
3543 must sort it into a random order if it did not come from MX records and has not
3544 already been randomized (but don't bother if continuing down an existing
3547 else if (ob->hosts_randomize && hostlist->mx == MX_NONE && !continue_hostname)
3549 host_item *newlist = NULL;
3552 host_item *h = hostlist;
3553 hostlist = hostlist->next;
3555 h->sort_key = random_number(100);
3562 else if (h->sort_key < newlist->sort_key)
3569 host_item *hh = newlist;
3572 if (h->sort_key < hh->next->sort_key) break;
3580 hostlist = addrlist->host_list = newlist;
3583 /* Sort out the default port. */
3585 if (!smtp_get_port(ob->port, addrlist, &port, tid)) return FALSE;
3587 /* For each host-plus-IP-address on the list:
3589 . If this is a continued delivery and the host isn't the one with the
3590 current connection, skip.
3592 . If the status is unusable (i.e. previously failed or retry checked), skip.
3594 . If no IP address set, get the address, either by turning the name into
3595 an address, calling gethostbyname if gethostbyname is on, or by calling
3596 the DNS. The DNS may yield multiple addresses, in which case insert the
3597 extra ones into the list.
3599 . Get the retry data if not previously obtained for this address and set the
3600 field which remembers the state of this address. Skip if the retry time is
3601 not reached. If not, remember whether retry data was found. The retry string
3602 contains both the name and the IP address.
3604 . Scan the list of addresses and mark those whose status is DEFER as
3605 PENDING_DEFER. These are the only ones that will be processed in this cycle
3608 . Make a delivery attempt - addresses marked PENDING_DEFER will be tried.
3609 Some addresses may be successfully delivered, others may fail, and yet
3610 others may get temporary errors and so get marked DEFER.
3612 . The return from the delivery attempt is OK if a connection was made and a
3613 valid SMTP dialogue was completed. Otherwise it is DEFER.
3615 . If OK, add a "remove" retry item for this host/IPaddress, if any.
3617 . If fail to connect, or other defer state, add a retry item.
3619 . If there are any addresses whose status is still DEFER, carry on to the
3620 next host/IPaddress, unless we have tried the number of hosts given
3621 by hosts_max_try or hosts_max_try_hardlimit; otherwise return. Note that
3622 there is some fancy logic for hosts_max_try that means its limit can be
3623 overstepped in some circumstances.
3625 If we get to the end of the list, all hosts have deferred at least one address,
3626 or not reached their retry times. If delay_after_cutoff is unset, it requests a
3627 delivery attempt to those hosts whose last try was before the arrival time of
3628 the current message. To cope with this, we have to go round the loop a second
3629 time. After that, set the status and error data for any addresses that haven't
3630 had it set already. */
3632 for (cutoff_retry = 0;
3633 expired && cutoff_retry < (ob->delay_after_cutoff ? 1 : 2);
3636 host_item *nexthost = NULL;
3637 int unexpired_hosts_tried = 0;
3639 for (host = hostlist;
3641 && unexpired_hosts_tried < ob->hosts_max_try
3642 && total_hosts_tried < ob->hosts_max_try_hardlimit;
3648 BOOL host_is_expired = FALSE;
3649 BOOL message_defer = FALSE;
3650 BOOL some_deferred = FALSE;
3651 address_item *first_addr = NULL;
3652 uschar *interface = NULL;
3653 uschar *retry_host_key = NULL;
3654 uschar *retry_message_key = NULL;
3655 uschar *serialize_key = NULL;
3657 /* Default next host is next host. :-) But this can vary if the
3658 hosts_max_try limit is hit (see below). It may also be reset if a host
3659 address is looked up here (in case the host was multihomed). */
3661 nexthost = host->next;
3663 /* If the address hasn't yet been obtained from the host name, look it up
3664 now, unless the host is already marked as unusable. If it is marked as
3665 unusable, it means that the router was unable to find its IP address (in
3666 the DNS or wherever) OR we are in the 2nd time round the cutoff loop, and
3667 the lookup failed last time. We don't get this far if *all* MX records
3668 point to non-existent hosts; that is treated as a hard error.
3670 We can just skip this host entirely. When the hosts came from the router,
3671 the address will timeout based on the other host(s); when the address is
3672 looked up below, there is an explicit retry record added.
3674 Note that we mustn't skip unusable hosts if the address is not unset; they
3675 may be needed as expired hosts on the 2nd time round the cutoff loop. */
3679 int new_port, flags;
3682 if (host->status >= hstatus_unusable)
3684 DEBUG(D_transport) debug_printf("%s has no address and is unusable - skipping\n",
3689 DEBUG(D_transport) debug_printf("getting address for %s\n", host->name);
3691 /* The host name is permitted to have an attached port. Find it, and
3692 strip it from the name. Just remember it for now. */
3694 new_port = host_item_get_port(host);
3696 /* Count hosts looked up */
3700 /* Find by name if so configured, or if it's an IP address. We don't
3701 just copy the IP address, because we need the test-for-local to happen. */
3703 flags = HOST_FIND_BY_A;
3704 if (ob->dns_qualify_single) flags |= HOST_FIND_QUALIFY_SINGLE;
3705 if (ob->dns_search_parents) flags |= HOST_FIND_SEARCH_PARENTS;
3707 if (ob->gethostbyname || string_is_ip_address(host->name, NULL) != 0)
3708 rc = host_find_byname(host, NULL, flags, NULL, TRUE);
3710 rc = host_find_bydns(host, NULL, flags, NULL, NULL, NULL,
3711 &ob->dnssec, /* domains for request/require */
3714 /* Update the host (and any additional blocks, resulting from
3715 multihoming) with a host-specific port, if any. */
3717 for (hh = host; hh != nexthost; hh = hh->next) hh->port = new_port;
3719 /* Failure to find the host at this time (usually DNS temporary failure)
3720 is really a kind of routing failure rather than a transport failure.
3721 Therefore we add a retry item of the routing kind, not to stop us trying
3722 to look this name up here again, but to ensure the address gets timed
3723 out if the failures go on long enough. A complete failure at this point
3724 commonly points to a configuration error, but the best action is still
3725 to carry on for the next host. */
3727 if (rc == HOST_FIND_AGAIN || rc == HOST_FIND_FAILED)
3729 retry_add_item(addrlist, string_sprintf("R:%s", host->name), 0);
3731 if (rc == HOST_FIND_AGAIN) hosts_defer++; else hosts_fail++;
3732 DEBUG(D_transport) debug_printf("rc = %s for %s\n", (rc == HOST_FIND_AGAIN)?
3733 "HOST_FIND_AGAIN" : "HOST_FIND_FAILED", host->name);
3734 host->status = hstatus_unusable;
3736 for (addr = addrlist; addr; addr = addr->next)
3738 if (addr->transport_return != DEFER) continue;
3739 addr->basic_errno = ERRNO_UNKNOWNHOST;
3741 string_sprintf("failed to lookup IP address for %s", host->name);
3746 /* If the host is actually the local host, we may have a problem, or
3747 there may be some cunning configuration going on. In the problem case,
3748 log things and give up. The default transport status is already DEFER. */
3750 if (rc == HOST_FOUND_LOCAL && !ob->allow_localhost)
3752 for (addr = addrlist; addr; addr = addr->next)
3754 addr->basic_errno = 0;
3755 addr->message = string_sprintf("%s transport found host %s to be "
3756 "local", tblock->name, host->name);
3760 } /* End of block for IP address lookup */
3762 /* If this is a continued delivery, we are interested only in the host
3763 which matches the name of the existing open channel. The check is put
3764 here after the local host lookup, in case the name gets expanded as a
3765 result of the lookup. Set expired FALSE, to save the outer loop executing
3768 if ( continue_hostname
3769 && ( Ustrcmp(continue_hostname, host->name) != 0
3770 || Ustrcmp(continue_host_address, host->address) != 0
3774 continue; /* With next host */
3777 /* Reset the default next host in case a multihomed host whose addresses
3778 are not looked up till just above added to the host list. */
3780 nexthost = host->next;
3782 /* If queue_smtp is set (-odqs or the first part of a 2-stage run), or the
3783 domain is in queue_smtp_domains, we don't actually want to attempt any
3784 deliveries. When doing a queue run, queue_smtp_domains is always unset. If
3785 there is a lookup defer in queue_smtp_domains, proceed as if the domain
3786 were not in it. We don't want to hold up all SMTP deliveries! Except when
3787 doing a two-stage queue run, don't do this if forcing. */
3789 if ((!deliver_force || queue_2stage) && (queue_smtp ||
3790 match_isinlist(addrlist->domain,
3791 (const uschar **)&queue_smtp_domains, 0,
3792 &domainlist_anchor, NULL, MCL_DOMAIN, TRUE, NULL) == OK))
3795 for (addr = addrlist; addr; addr = addr->next)
3796 if (addr->transport_return == DEFER)
3797 addr->message = US"domain matches queue_smtp_domains, or -odqs set";
3798 continue; /* With next host */
3801 /* Count hosts being considered - purely for an intelligent comment
3802 if none are usable. */
3806 /* Set $host and $host address now in case they are needed for the
3807 interface expansion or the serialize_hosts check; they remain set if an
3808 actual delivery happens. */
3810 deliver_host = host->name;
3811 deliver_host_address = host->address;
3812 lookup_dnssec_authenticated = host->dnssec == DS_YES ? US"yes"
3813 : host->dnssec == DS_NO ? US"no"
3816 /* Set up a string for adding to the retry key if the port number is not
3817 the standard SMTP port. A host may have its own port setting that overrides
3820 pistring = string_sprintf(":%d", host->port == PORT_NONE
3821 ? port : host->port);
3822 if (Ustrcmp(pistring, ":25") == 0) pistring = US"";
3824 /* Select IPv4 or IPv6, and choose an outgoing interface. If the interface
3825 string is set, even if constant (as different transports can have different
3826 constant settings), we must add it to the key that is used for retries,
3827 because connections to the same host from a different interface should be
3828 treated separately. */
3830 host_af = Ustrchr(host->address, ':') == NULL ? AF_INET : AF_INET6;
3831 if ((rs = ob->interface) && *rs)
3833 if (!smtp_get_interface(rs, host_af, addrlist, &interface, tid))
3835 pistring = string_sprintf("%s/%s", pistring, interface);
3838 /* The first time round the outer loop, check the status of the host by
3839 inspecting the retry data. The second time round, we are interested only
3840 in expired hosts that haven't been tried since this message arrived. */
3842 if (cutoff_retry == 0)
3845 /* Ensure the status of the address is set by checking retry data if
3846 necessary. There may be host-specific retry data (applicable to all
3847 messages) and also data for retries of a specific message at this host.
3848 If either of these retry records are actually read, the keys used are
3849 returned to save recomputing them later. */
3851 if (exp_bool(addrlist, US"transport", tblock->name, D_transport,
3852 US"retry_include_ip_address", ob->retry_include_ip_address,
3853 ob->expand_retry_include_ip_address, &incl_ip) != OK)
3854 continue; /* with next host */
3856 host_is_expired = retry_check_address(addrlist->domain, host, pistring,
3857 incl_ip, &retry_host_key, &retry_message_key);
3859 DEBUG(D_transport) debug_printf("%s [%s]%s status = %s\n", host->name,
3860 (host->address == NULL)? US"" : host->address, pistring,
3861 (host->status == hstatus_usable)? "usable" :
3862 (host->status == hstatus_unusable)? "unusable" :
3863 (host->status == hstatus_unusable_expired)? "unusable (expired)" : "?");
3865 /* Skip this address if not usable at this time, noting if it wasn't
3866 actually expired, both locally and in the address. */
3868 switch (host->status)
3870 case hstatus_unusable:
3872 setflag(addrlist, af_retry_skipped);
3875 case hstatus_unusable_expired:
3878 case hwhy_retry: hosts_retry++; break;
3879 case hwhy_failed: hosts_fail++; break;
3880 case hwhy_deferred: hosts_defer++; break;
3883 /* If there was a retry message key, implying that previously there
3884 was a message-specific defer, we don't want to update the list of
3885 messages waiting for these hosts. */
3887 if (retry_message_key) update_waiting = FALSE;
3888 continue; /* With the next host or IP address */
3892 /* Second time round the loop: if the address is set but expired, and
3893 the message is newer than the last try, let it through. */
3898 || host->status != hstatus_unusable_expired
3899 || host->last_try > received_time)
3901 DEBUG(D_transport) debug_printf("trying expired host %s [%s]%s\n",
3902 host->name, host->address, pistring);
3903 host_is_expired = TRUE;
3906 /* Setting "expired=FALSE" doesn't actually mean not all hosts are expired;
3907 it remains TRUE only if all hosts are expired and none are actually tried.
3912 /* If this host is listed as one to which access must be serialized,
3913 see if another Exim process has a connection to it, and if so, skip
3914 this host. If not, update the database to record our connection to it
3915 and remember this for later deletion. Do not do any of this if we are
3916 sending the message down a pre-existing connection. */
3918 if ( !continue_hostname
3919 && verify_check_given_host(&ob->serialize_hosts, host) == OK)
3921 serialize_key = string_sprintf("host-serialize-%s", host->name);
3922 if (!enq_start(serialize_key, 1))
3925 debug_printf("skipping host %s because another Exim process "
3926 "is connected to it\n", host->name);
3932 /* OK, we have an IP address that is not waiting for its retry time to
3933 arrive (it might be expired) OR (second time round the loop) we have an
3934 expired host that hasn't been tried since the message arrived. Have a go
3935 at delivering the message to it. First prepare the addresses by flushing
3936 out the result of previous attempts, and finding the first address that
3937 is still to be delivered. */
3939 first_addr = prepare_addresses(addrlist, host);
3941 DEBUG(D_transport) debug_printf("delivering %s to %s [%s] (%s%s)\n",
3942 message_id, host->name, host->address, addrlist->address,
3943 addrlist->next ? ", ..." : "");
3945 set_process_info("delivering %s to %s [%s] (%s%s)",
3946 message_id, host->name, host->address, addrlist->address,
3947 addrlist->next ? ", ..." : "");
3949 /* This is not for real; don't do the delivery. If there are
3950 any remaining hosts, list them. */
3955 set_errno_nohost(addrlist, 0, NULL, OK, FALSE);
3956 for (addr = addrlist; addr; addr = addr->next)
3958 addr->host_used = host;
3959 addr->special_action = '*';
3960 addr->message = US"delivery bypassed by -N option";
3964 debug_printf("*** delivery by %s transport bypassed by -N option\n"
3965 "*** host and remaining hosts:\n", tblock->name);
3966 for (host2 = host; host2; host2 = host2->next)
3967 debug_printf(" %s [%s]\n", host2->name,
3968 host2->address ? host2->address : US"unset");
3973 /* This is for real. If the host is expired, we don't count it for
3974 hosts_max_retry. This ensures that all hosts must expire before an address
3975 is timed out, unless hosts_max_try_hardlimit (which protects against
3976 lunatic DNS configurations) is reached.
3978 If the host is not expired and we are about to hit the hosts_max_retry
3979 limit, check to see if there is a subsequent hosts with a different MX
3980 value. If so, make that the next host, and don't count this one. This is a
3981 heuristic to make sure that different MXs do get tried. With a normal kind
3982 of retry rule, they would get tried anyway when the earlier hosts were
3983 delayed, but if the domain has a "retry every time" type of rule - as is
3984 often used for the the very large ISPs, that won't happen. */
3989 /* Make a copy of the host if it is local to this invocation
3990 of the transport. */
3994 thost = store_get(sizeof(host_item));
3996 thost->name = string_copy(host->name);
3997 thost->address = string_copy(host->address);
4002 if (!host_is_expired && ++unexpired_hosts_tried >= ob->hosts_max_try)
4006 debug_printf("hosts_max_try limit reached with this host\n");
4007 for (h = host; h; h = h->next) if (h->mx != host->mx)
4010 unexpired_hosts_tried--;
4011 DEBUG(D_transport) debug_printf("however, a higher MX host exists "
4012 "and will be tried\n");
4017 /* Attempt the delivery. */
4019 total_hosts_tried++;
4020 rc = smtp_deliver(addrlist, thost, host_af, port, interface, tblock,
4021 &message_defer, FALSE);
4024 OK => connection made, each address contains its result;
4025 message_defer is set for message-specific defers (when all
4026 recipients are marked defer)
4027 DEFER => there was a non-message-specific delivery problem;
4028 ERROR => there was a problem setting up the arguments for a filter,
4029 or there was a problem with expanding added headers
4032 /* If the result is not OK, there was a non-message-specific problem.
4033 If the result is DEFER, we need to write to the logs saying what happened
4034 for this particular host, except in the case of authentication and TLS
4035 failures, where the log has already been written. If all hosts defer a
4036 general message is written at the end. */
4038 if (rc == DEFER && first_addr->basic_errno != ERRNO_AUTHFAIL
4039 && first_addr->basic_errno != ERRNO_TLSFAILURE)
4040 write_logs(first_addr, host);
4042 #ifndef DISABLE_EVENT
4044 deferred_event_raise(first_addr, host);
4047 /* If STARTTLS was accepted, but there was a failure in setting up the
4048 TLS session (usually a certificate screwup), and the host is not in
4049 hosts_require_tls, and tls_tempfail_tryclear is true, try again, with
4050 TLS forcibly turned off. We have to start from scratch with a new SMTP
4051 connection. That's why the retry is done from here, not from within
4052 smtp_deliver(). [Rejections of STARTTLS itself don't screw up the
4053 session, so the in-clear transmission after those errors, if permitted,
4054 happens inside smtp_deliver().] */
4058 && first_addr->basic_errno == ERRNO_TLSFAILURE
4059 && ob->tls_tempfail_tryclear
4060 && verify_check_given_host(&ob->hosts_require_tls, host) != OK
4063 log_write(0, LOG_MAIN, "TLS session failure: delivering unencrypted "
4064 "to %s [%s] (not in hosts_require_tls)", host->name, host->address);
4065 first_addr = prepare_addresses(addrlist, host);
4066 rc = smtp_deliver(addrlist, thost, host_af, port, interface, tblock,
4067 &message_defer, TRUE);
4068 if (rc == DEFER && first_addr->basic_errno != ERRNO_AUTHFAIL)
4069 write_logs(first_addr, host);
4070 # ifndef DISABLE_EVENT
4072 deferred_event_raise(first_addr, host);
4075 #endif /*SUPPORT_TLS*/
4078 /* Delivery attempt finished */
4080 rs = rc == OK ? US"OK"
4081 : rc == DEFER ? US"DEFER"
4082 : rc == ERROR ? US"ERROR"
4085 set_process_info("delivering %s: just tried %s [%s] for %s%s: result %s",
4086 message_id, host->name, host->address, addrlist->address,
4087 addrlist->next ? " (& others)" : "", rs);
4089 /* Release serialization if set up */
4091 if (serialize_key) enq_end(serialize_key);
4093 /* If the result is DEFER, or if a host retry record is known to exist, we
4094 need to add an item to the retry chain for updating the retry database
4095 at the end of delivery. We only need to add the item to the top address,
4096 of course. Also, if DEFER, we mark the IP address unusable so as to skip it
4097 for any other delivery attempts using the same address. (It is copied into
4098 the unusable tree at the outer level, so even if different address blocks
4099 contain the same address, it still won't get tried again.) */
4101 if (rc == DEFER || retry_host_key)
4103 int delete_flag = rc != DEFER ? rf_delete : 0;
4104 if (!retry_host_key)
4107 if (exp_bool(addrlist, US"transport", tblock->name, D_transport,
4108 US"retry_include_ip_address", ob->retry_include_ip_address,
4109 ob->expand_retry_include_ip_address, &incl_ip) != OK)
4110 incl_ip = TRUE; /* error; use most-specific retry record */
4112 retry_host_key = incl_ip
4113 ? string_sprintf("T:%S:%s%s", host->name, host->address, pistring)
4114 : string_sprintf("T:%S%s", host->name, pistring);
4117 /* If a delivery of another message over an existing SMTP connection
4118 yields DEFER, we do NOT set up retry data for the host. This covers the
4119 case when there are delays in routing the addresses in the second message
4120 that are so long that the server times out. This is alleviated by not
4121 routing addresses that previously had routing defers when handling an
4122 existing connection, but even so, this case may occur (e.g. if a
4123 previously happily routed address starts giving routing defers). If the
4124 host is genuinely down, another non-continued message delivery will
4125 notice it soon enough. */
4127 if (delete_flag != 0 || !continue_hostname)
4128 retry_add_item(first_addr, retry_host_key, rf_host | delete_flag);
4130 /* We may have tried an expired host, if its retry time has come; ensure
4131 the status reflects the expiry for the benefit of any other addresses. */
4135 host->status = host_is_expired
4136 ? hstatus_unusable_expired : hstatus_unusable;
4137 host->why = hwhy_deferred;
4141 /* If message_defer is set (host was OK, but every recipient got deferred
4142 because of some message-specific problem), or if that had happened
4143 previously so that a message retry key exists, add an appropriate item
4144 to the retry chain. Note that if there was a message defer but now there is
4145 a host defer, the message defer record gets deleted. That seems perfectly
4146 reasonable. Also, stop the message from being remembered as waiting
4147 for specific hosts. */
4149 if (message_defer || retry_message_key)
4151 int delete_flag = message_defer ? 0 : rf_delete;
4152 if (!retry_message_key)
4155 if (exp_bool(addrlist, US"transport", tblock->name, D_transport,
4156 US"retry_include_ip_address", ob->retry_include_ip_address,
4157 ob->expand_retry_include_ip_address, &incl_ip) != OK)
4158 incl_ip = TRUE; /* error; use most-specific retry record */
4160 retry_message_key = incl_ip
4161 ? string_sprintf("T:%S:%s%s:%s", host->name, host->address, pistring,
4163 : string_sprintf("T:%S%s:%s", host->name, pistring, message_id);
4165 retry_add_item(addrlist, retry_message_key,
4166 rf_message | rf_host | delete_flag);
4167 update_waiting = FALSE;
4170 /* Any return other than DEFER (that is, OK or ERROR) means that the
4171 addresses have got their final statuses filled in for this host. In the OK
4172 case, see if any of them are deferred. */
4175 for (addr = addrlist; addr; addr = addr->next)
4176 if (addr->transport_return == DEFER)
4178 some_deferred = TRUE;
4182 /* If no addresses deferred or the result was ERROR, return. We do this for
4183 ERROR because a failing filter set-up or add_headers expansion is likely to
4184 fail for any host we try. */
4186 if (rc == ERROR || (rc == OK && !some_deferred))
4188 DEBUG(D_transport) debug_printf("Leaving %s transport\n", tblock->name);
4189 return TRUE; /* Each address has its status */
4192 /* If the result was DEFER or some individual addresses deferred, let
4193 the loop run to try other hosts with the deferred addresses, except for the
4194 case when we were trying to deliver down an existing channel and failed.
4195 Don't try any other hosts in this case. */
4197 if (continue_hostname) break;
4199 /* If the whole delivery, or some individual addresses, were deferred and
4200 there are more hosts that could be tried, do not count this host towards
4201 the hosts_max_try limit if the age of the message is greater than the
4202 maximum retry time for this host. This means we may try try all hosts,
4203 ignoring the limit, when messages have been around for some time. This is
4204 important because if we don't try all hosts, the address will never time
4205 out. NOTE: this does not apply to hosts_max_try_hardlimit. */
4207 if ((rc == DEFER || some_deferred) && nexthost)
4210 retry_config *retry = retry_find_config(host->name, NULL, 0, 0);
4212 if (retry && retry->rules)
4214 retry_rule *last_rule;
4215 for (last_rule = retry->rules;
4217 last_rule = last_rule->next);
4218 timedout = time(NULL) - received_time > last_rule->timeout;
4220 else timedout = TRUE; /* No rule => timed out */
4224 unexpired_hosts_tried--;
4225 DEBUG(D_transport) debug_printf("temporary delivery error(s) override "
4226 "hosts_max_try (message older than host's retry time)\n");
4229 } /* End of loop for trying multiple hosts. */
4231 /* This is the end of the loop that repeats iff expired is TRUE and
4232 ob->delay_after_cutoff is FALSE. The second time round we will
4233 try those hosts that haven't been tried since the message arrived. */
4237 debug_printf("all IP addresses skipped or deferred at least one address\n");
4238 if (expired && !ob->delay_after_cutoff && cutoff_retry == 0)
4239 debug_printf("retrying IP addresses not tried since message arrived\n");
4244 /* Get here if all IP addresses are skipped or defer at least one address. In
4245 MUA wrapper mode, this will happen only for connection or other non-message-
4246 specific failures. Force the delivery status for all addresses to FAIL. */
4250 for (addr = addrlist; addr; addr = addr->next)
4251 addr->transport_return = FAIL;
4255 /* In the normal, non-wrapper case, add a standard message to each deferred
4256 address if there hasn't been an error, that is, if it hasn't actually been
4257 tried this time. The variable "expired" will be FALSE if any deliveries were
4258 actually tried, or if there was at least one host that was not expired. That
4259 is, it is TRUE only if no deliveries were tried and all hosts were expired. If
4260 a delivery has been tried, an error code will be set, and the failing of the
4261 message is handled by the retry code later.
4263 If queue_smtp is set, or this transport was called to send a subsequent message
4264 down an existing TCP/IP connection, and something caused the host not to be
4265 found, we end up here, but can detect these cases and handle them specially. */
4267 for (addr = addrlist; addr; addr = addr->next)
4269 /* If host is not NULL, it means that we stopped processing the host list
4270 because of hosts_max_try or hosts_max_try_hardlimit. In the former case, this
4271 means we need to behave as if some hosts were skipped because their retry
4272 time had not come. Specifically, this prevents the address from timing out.
4273 However, if we have hit hosts_max_try_hardlimit, we want to behave as if all
4274 hosts were tried. */
4277 if (total_hosts_tried >= ob->hosts_max_try_hardlimit)
4280 debug_printf("hosts_max_try_hardlimit reached: behave as if all "
4281 "hosts were tried\n");
4286 debug_printf("hosts_max_try limit caused some hosts to be skipped\n");
4287 setflag(addr, af_retry_skipped);
4290 if (queue_smtp) /* no deliveries attempted */
4292 addr->transport_return = DEFER;
4293 addr->basic_errno = 0;
4294 addr->message = US"SMTP delivery explicitly queued";
4297 else if ( addr->transport_return == DEFER
4298 && (addr->basic_errno == ERRNO_UNKNOWNERROR || addr->basic_errno == 0)
4302 addr->basic_errno = ERRNO_HRETRY;
4303 if (continue_hostname)
4304 addr->message = US"no host found for existing SMTP connection";
4307 setflag(addr, af_pass_message); /* This is not a security risk */
4308 addr->message = string_sprintf(
4309 "all hosts%s have been failing for a long time %s",
4310 addr->domain ? string_sprintf(" for '%s'", addr->domain) : US"",
4311 ob->delay_after_cutoff
4312 ? US"(and retry time not reached)"
4313 : US"and were last tried after this message arrived");
4315 /* If we are already using fallback hosts, or there are no fallback hosts
4316 defined, convert the result to FAIL to cause a bounce. */
4318 if (addr->host_list == addr->fallback_hosts || !addr->fallback_hosts)
4319 addr->transport_return = FAIL;
4324 if (hosts_retry == hosts_total)
4325 s = "retry time not reached for any host%s";
4326 else if (hosts_fail == hosts_total)
4327 s = "all host address lookups%s failed permanently";
4328 else if (hosts_defer == hosts_total)
4329 s = "all host address lookups%s failed temporarily";
4330 else if (hosts_serial == hosts_total)
4331 s = "connection limit reached for all hosts%s";
4332 else if (hosts_fail+hosts_defer == hosts_total)
4333 s = "all host address lookups%s failed";
4335 s = "some host address lookups failed and retry time "
4336 "not reached for other hosts or connection limit reached%s";
4338 addr->message = string_sprintf(s,
4339 addr->domain ? string_sprintf(" for '%s'", addr->domain) : US"");
4344 /* Update the database which keeps information about which messages are waiting
4345 for which hosts to become available. For some message-specific errors, the
4346 update_waiting flag is turned off because we don't want follow-on deliveries in
4347 those cases. If this transport instance is explicitly limited to one message
4348 per connection then follow-on deliveries are not possible and there's no need
4349 to create/update the per-transport wait-<transport_name> database. */
4351 if (update_waiting && tblock->connection_max_messages != 1)
4352 transport_update_waiting(hostlist, tblock->name);
4356 DEBUG(D_transport) debug_printf("Leaving %s transport\n", tblock->name);
4358 return TRUE; /* Each address has its status */
4363 /* End of transport/smtp.c */