1 /*************************************************
2 * Exim - an Internet mail transport agent *
3 *************************************************/
5 /* Copyright (c) University of Cambridge 1995 - 2015 */
6 /* See the file NOTICE for conditions of use and distribution. */
8 /* Functions concerned with verifying things. The original code for callout
9 caching was contributed by Kevin Fleming (but I hacked it around a bit). */
13 #include "transports/smtp.h"
15 #define CUTTHROUGH_CMD_TIMEOUT 30 /* timeout for cutthrough-routing calls */
16 #define CUTTHROUGH_DATA_TIMEOUT 60 /* timeout for cutthrough-routing calls */
17 static smtp_outblock ctblock;
18 uschar ctbuffer[8192];
21 /* Structure for caching DNSBL lookups */
23 typedef struct dnsbl_cache_block {
32 /* Anchor for DNSBL cache */
34 static tree_node *dnsbl_cache = NULL;
37 /* Bits for match_type in one_check_dnsbl() */
42 static uschar cutthrough_response(char, uschar **);
45 /*************************************************
46 * Retrieve a callout cache record *
47 *************************************************/
49 /* If a record exists, check whether it has expired.
52 dbm_file an open hints file
54 type "address" or "domain"
55 positive_expire expire time for positive records
56 negative_expire expire time for negative records
58 Returns: the cache record if a non-expired one exists, else NULL
61 static dbdata_callout_cache *
62 get_callout_cache_record(open_db *dbm_file, const uschar *key, uschar *type,
63 int positive_expire, int negative_expire)
68 dbdata_callout_cache *cache_record;
70 cache_record = dbfn_read_with_length(dbm_file, key, &length);
72 if (cache_record == NULL)
74 HDEBUG(D_verify) debug_printf("callout cache: no %s record found for %s\n", type, key);
78 /* We treat a record as "negative" if its result field is not positive, or if
79 it is a domain record and the postmaster field is negative. */
81 negative = cache_record->result != ccache_accept ||
82 (type[0] == 'd' && cache_record->postmaster_result == ccache_reject);
83 expire = negative? negative_expire : positive_expire;
86 if (now - cache_record->time_stamp > expire)
88 HDEBUG(D_verify) debug_printf("callout cache: %s record expired for %s\n", type, key);
92 /* If this is a non-reject domain record, check for the obsolete format version
93 that doesn't have the postmaster and random timestamps, by looking at the
94 length. If so, copy it to a new-style block, replicating the record's
95 timestamp. Then check the additional timestamps. (There's no point wasting
96 effort if connections are rejected.) */
98 if (type[0] == 'd' && cache_record->result != ccache_reject)
100 if (length == sizeof(dbdata_callout_cache_obs))
102 dbdata_callout_cache *new = store_get(sizeof(dbdata_callout_cache));
103 memcpy(new, cache_record, length);
104 new->postmaster_stamp = new->random_stamp = new->time_stamp;
108 if (now - cache_record->postmaster_stamp > expire)
109 cache_record->postmaster_result = ccache_unknown;
111 if (now - cache_record->random_stamp > expire)
112 cache_record->random_result = ccache_unknown;
115 HDEBUG(D_verify) debug_printf("callout cache: found %s record for %s\n", type, key);
121 /*************************************************
122 * Do callout verification for an address *
123 *************************************************/
125 /* This function is called from verify_address() when the address has routed to
126 a host list, and a callout has been requested. Callouts are expensive; that is
127 why a cache is used to improve the efficiency.
130 addr the address that's been routed
131 host_list the list of hosts to try
132 tf the transport feedback block
134 ifstring "interface" option from transport, or NULL
135 portstring "port" option from transport, or NULL
136 protocolstring "protocol" option from transport, or NULL
137 callout the per-command callout timeout
138 callout_overall the overall callout timeout (if < 0 use 4*callout)
139 callout_connect the callout connection timeout (if < 0 use callout)
140 options the verification options - these bits are used:
141 vopt_is_recipient => this is a recipient address
142 vopt_callout_no_cache => don't use callout cache
143 vopt_callout_fullpm => if postmaster check, do full one
144 vopt_callout_random => do the "random" thing
145 vopt_callout_recipsender => use real sender for recipient
146 vopt_callout_recippmaster => use postmaster for recipient
147 se_mailfrom MAIL FROM address for sender verify; NULL => ""
148 pm_mailfrom if non-NULL, do the postmaster check with this sender
150 Returns: OK/FAIL/DEFER
154 do_callout(address_item *addr, host_item *host_list, transport_feedback *tf,
155 int callout, int callout_overall, int callout_connect, int options,
156 uschar *se_mailfrom, uschar *pm_mailfrom)
158 BOOL is_recipient = (options & vopt_is_recipient) != 0;
159 BOOL callout_no_cache = (options & vopt_callout_no_cache) != 0;
160 BOOL callout_random = (options & vopt_callout_random) != 0;
163 int old_domain_cache_result = ccache_accept;
166 uschar *from_address;
167 uschar *random_local_part = NULL;
168 const uschar *save_deliver_domain = deliver_domain;
169 uschar **failure_ptr = is_recipient?
170 &recipient_verify_failure : &sender_verify_failure;
172 open_db *dbm_file = NULL;
173 dbdata_callout_cache new_domain_record;
174 dbdata_callout_cache_address new_address_record;
176 time_t callout_start_time;
178 BOOL utf8_offered = FALSE;
181 new_domain_record.result = ccache_unknown;
182 new_domain_record.postmaster_result = ccache_unknown;
183 new_domain_record.random_result = ccache_unknown;
185 memset(&new_address_record, 0, sizeof(new_address_record));
187 /* For a recipient callout, the key used for the address cache record must
188 include the sender address if we are using the real sender in the callout,
189 because that may influence the result of the callout. */
191 address_key = addr->address;
196 if (options & vopt_callout_recipsender)
198 address_key = string_sprintf("%s/<%s>", addr->address, sender_address);
199 from_address = sender_address;
201 else if (options & vopt_callout_recippmaster)
203 address_key = string_sprintf("%s/<postmaster@%s>", addr->address,
204 qualify_domain_sender);
205 from_address = string_sprintf("postmaster@%s", qualify_domain_sender);
209 /* For a sender callout, we must adjust the key if the mailfrom address is not
214 from_address = (se_mailfrom == NULL)? US"" : se_mailfrom;
215 if (from_address[0] != 0)
216 address_key = string_sprintf("%s/<%s>", addr->address, from_address);
219 /* Open the callout cache database, it it exists, for reading only at this
220 stage, unless caching has been disabled. */
222 if (callout_no_cache)
224 HDEBUG(D_verify) debug_printf("callout cache: disabled by no_cache\n");
226 else if ((dbm_file = dbfn_open(US"callout", O_RDWR, &dbblock, FALSE)) == NULL)
228 HDEBUG(D_verify) debug_printf("callout cache: not available\n");
231 /* If a cache database is available see if we can avoid the need to do an
232 actual callout by making use of previously-obtained data. */
234 if (dbm_file != NULL)
236 dbdata_callout_cache_address *cache_address_record;
237 dbdata_callout_cache *cache_record = get_callout_cache_record(dbm_file,
238 addr->domain, US"domain",
239 callout_cache_domain_positive_expire,
240 callout_cache_domain_negative_expire);
242 /* If an unexpired cache record was found for this domain, see if the callout
243 process can be short-circuited. */
245 if (cache_record != NULL)
247 /* In most cases, if an early command (up to and including MAIL FROM:<>)
248 was rejected, there is no point carrying on. The callout fails. However, if
249 we are doing a recipient verification with use_sender or use_postmaster
250 set, a previous failure of MAIL FROM:<> doesn't count, because this time we
251 will be using a non-empty sender. We have to remember this situation so as
252 not to disturb the cached domain value if this whole verification succeeds
253 (we don't want it turning into "accept"). */
255 old_domain_cache_result = cache_record->result;
257 if (cache_record->result == ccache_reject ||
258 (*from_address == 0 && cache_record->result == ccache_reject_mfnull))
260 setflag(addr, af_verify_nsfail);
262 debug_printf("callout cache: domain gave initial rejection, or "
263 "does not accept HELO or MAIL FROM:<>\n");
264 setflag(addr, af_verify_nsfail);
265 addr->user_message = US"(result of an earlier callout reused).";
267 *failure_ptr = US"mail";
271 /* If a previous check on a "random" local part was accepted, we assume
272 that the server does not do any checking on local parts. There is therefore
273 no point in doing the callout, because it will always be successful. If a
274 random check previously failed, arrange not to do it again, but preserve
275 the data in the new record. If a random check is required but hasn't been
276 done, skip the remaining cache processing. */
278 if (callout_random) switch(cache_record->random_result)
282 debug_printf("callout cache: domain accepts random addresses\n");
283 goto END_CALLOUT; /* Default yield is OK */
287 debug_printf("callout cache: domain rejects random addresses\n");
288 callout_random = FALSE;
289 new_domain_record.random_result = ccache_reject;
290 new_domain_record.random_stamp = cache_record->random_stamp;
295 debug_printf("callout cache: need to check random address handling "
296 "(not cached or cache expired)\n");
300 /* If a postmaster check is requested, but there was a previous failure,
301 there is again no point in carrying on. If a postmaster check is required,
302 but has not been done before, we are going to have to do a callout, so skip
303 remaining cache processing. */
305 if (pm_mailfrom != NULL)
307 if (cache_record->postmaster_result == ccache_reject)
309 setflag(addr, af_verify_pmfail);
311 debug_printf("callout cache: domain does not accept "
312 "RCPT TO:<postmaster@domain>\n");
314 *failure_ptr = US"postmaster";
315 setflag(addr, af_verify_pmfail);
316 addr->user_message = US"(result of earlier verification reused).";
319 if (cache_record->postmaster_result == ccache_unknown)
322 debug_printf("callout cache: need to check RCPT "
323 "TO:<postmaster@domain> (not cached or cache expired)\n");
327 /* If cache says OK, set pm_mailfrom NULL to prevent a redundant
328 postmaster check if the address itself has to be checked. Also ensure
329 that the value in the cache record is preserved (with its old timestamp).
332 HDEBUG(D_verify) debug_printf("callout cache: domain accepts RCPT "
333 "TO:<postmaster@domain>\n");
335 new_domain_record.postmaster_result = ccache_accept;
336 new_domain_record.postmaster_stamp = cache_record->postmaster_stamp;
340 /* We can't give a result based on information about the domain. See if there
341 is an unexpired cache record for this specific address (combined with the
342 sender address if we are doing a recipient callout with a non-empty sender).
345 cache_address_record = (dbdata_callout_cache_address *)
346 get_callout_cache_record(dbm_file,
347 address_key, US"address",
348 callout_cache_positive_expire,
349 callout_cache_negative_expire);
351 if (cache_address_record != NULL)
353 if (cache_address_record->result == ccache_accept)
356 debug_printf("callout cache: address record is positive\n");
361 debug_printf("callout cache: address record is negative\n");
362 addr->user_message = US"Previous (cached) callout verification failure";
363 *failure_ptr = US"recipient";
369 /* Close the cache database while we actually do the callout for real. */
372 dbfn_close(dbm_file);
376 if (!addr->transport)
378 HDEBUG(D_verify) debug_printf("cannot callout via null transport\n");
380 else if (Ustrcmp(addr->transport->driver_name, "smtp") != 0)
381 log_write(0, LOG_MAIN|LOG_PANIC|LOG_CONFIG_FOR, "callout transport '%s': %s is non-smtp",
382 addr->transport->name, addr->transport->driver_name);
385 smtp_transport_options_block *ob =
386 (smtp_transport_options_block *)addr->transport->options_block;
388 /* The information wasn't available in the cache, so we have to do a real
389 callout and save the result in the cache for next time, unless no_cache is set,
390 or unless we have a previously cached negative random result. If we are to test
391 with a random local part, ensure that such a local part is available. If not,
392 log the fact, but carry on without randomming. */
394 if (callout_random && callout_random_local_part != NULL)
395 if (!(random_local_part = expand_string(callout_random_local_part)))
396 log_write(0, LOG_MAIN|LOG_PANIC, "failed to expand "
397 "callout_random_local_part: %s", expand_string_message);
399 /* Default the connect and overall callout timeouts if not set, and record the
400 time we are starting so that we can enforce it. */
402 if (callout_overall < 0) callout_overall = 4 * callout;
403 if (callout_connect < 0) callout_connect = callout;
404 callout_start_time = time(NULL);
406 /* Before doing a real callout, if this is an SMTP connection, flush the SMTP
407 output because a callout might take some time. When PIPELINING is active and
408 there are many recipients, the total time for doing lots of callouts can add up
409 and cause the client to time out. So in this case we forgo the PIPELINING
412 if (smtp_out != NULL && !disable_callout_flush) mac_smtp_fflush();
414 /* cutthrough-multi: if a nonfirst rcpt has the same routing as the first,
415 and we are holding a cutthrough conn open, we can just append the rcpt to
416 that conn for verification purposes (and later delivery also). Simplest
417 coding means skipping this whole loop and doing the append separately.
419 We will need to remember it has been appended so that rcpt-acl tail code
420 can do it there for the non-rcpt-verify case. For this we keep an addresscount.
423 /* Can we re-use an open cutthrough connection? */
424 if ( cutthrough.fd >= 0
425 && (options & (vopt_callout_recipsender | vopt_callout_recippmaster))
426 == vopt_callout_recipsender
427 && !random_local_part
431 if (addr->transport == cutthrough.addr.transport)
432 for (host = host_list; host; host = host->next)
433 if (Ustrcmp(host->address, cutthrough.host.address) == 0)
436 uschar *interface = NULL; /* Outgoing interface to use; NULL => any */
439 deliver_host = host->name;
440 deliver_host_address = host->address;
441 deliver_host_port = host->port;
442 deliver_domain = addr->domain;
443 transport_name = addr->transport->name;
445 host_af = (Ustrchr(host->address, ':') == NULL)? AF_INET:AF_INET6;
447 if (!smtp_get_interface(tf->interface, host_af, addr, &interface,
449 !smtp_get_port(tf->port, addr, &port, US"callout"))
450 log_write(0, LOG_MAIN|LOG_PANIC, "<%s>: %s", addr->address,
453 if ( ( interface == cutthrough.interface
455 && cutthrough.interface
456 && Ustrcmp(interface, cutthrough.interface) == 0
458 && port == cutthrough.host.port
463 /* Match! Send the RCPT TO, append the addr, set done */
465 smtp_write_command(&ctblock, FALSE, "RCPT TO:<%.1000s>\r\n",
466 transport_rcpt_address(addr,
467 (addr->transport == NULL)? FALSE :
468 addr->transport->rcpt_include_affixes)) >= 0 &&
469 cutthrough_response('2', &resp) == '2';
471 /* This would go horribly wrong if a callout fail was ignored by ACL.
472 We punt by abandoning cutthrough on a reject, like the
477 address_item * na = store_get(sizeof(address_item));
478 *na = cutthrough.addr;
479 cutthrough.addr = *addr;
480 cutthrough.addr.host_used = &cutthrough.host;
481 cutthrough.addr.next = na;
487 cancel_cutthrough_connection("recipient rejected");
488 if (errno == ETIMEDOUT)
490 HDEBUG(D_verify) debug_printf("SMTP timeout\n");
495 Ustrcpy(resp, US"connection dropped");
498 string_sprintf("response to \"%s\" from %s [%s] was: %s",
499 big_buffer, host->name, host->address,
500 string_printing(resp));
503 string_sprintf("Callout verification failed:\n%s", resp);
505 /* Hard rejection ends the process */
507 if (resp[0] == '5') /* Address rejected */
518 cancel_cutthrough_connection("incompatible connection");
521 /* Now make connections to the hosts and do real callouts. The list of hosts
522 is passed in as an argument. */
524 for (host = host_list; host != NULL && !done; host = host->next)
526 smtp_inblock inblock;
527 smtp_outblock outblock;
530 BOOL send_quit = TRUE;
531 uschar *active_hostname = smtp_active_hostname;
535 BOOL suppress_tls = FALSE;
536 uschar *interface = NULL; /* Outgoing interface to use; NULL => any */
537 #if defined(SUPPORT_TLS) && defined(EXPERIMENTAL_DANE)
540 dns_answer tlsa_dnsa;
542 uschar inbuffer[4096];
543 uschar outbuffer[1024];
544 uschar responsebuffer[4096];
546 clearflag(addr, af_verify_pmfail); /* postmaster callout flag */
547 clearflag(addr, af_verify_nsfail); /* null sender callout flag */
549 /* Skip this host if we don't have an IP address for it. */
551 if (host->address == NULL)
553 DEBUG(D_verify) debug_printf("no IP address for host name %s: skipping\n",
558 /* Check the overall callout timeout */
560 if (time(NULL) - callout_start_time >= callout_overall)
562 HDEBUG(D_verify) debug_printf("overall timeout for callout exceeded\n");
566 /* Set IPv4 or IPv6 */
568 host_af = (Ustrchr(host->address, ':') == NULL)? AF_INET:AF_INET6;
570 /* Expand and interpret the interface and port strings. The latter will not
571 be used if there is a host-specific port (e.g. from a manualroute router).
572 This has to be delayed till now, because they may expand differently for
573 different hosts. If there's a failure, log it, but carry on with the
576 deliver_host = host->name;
577 deliver_host_address = host->address;
578 deliver_host_port = host->port;
579 deliver_domain = addr->domain;
580 transport_name = addr->transport->name;
582 if ( !smtp_get_interface(tf->interface, host_af, addr, &interface,
584 || !smtp_get_port(tf->port, addr, &port, US"callout")
586 log_write(0, LOG_MAIN|LOG_PANIC, "<%s>: %s", addr->address,
589 /* Set HELO string according to the protocol */
590 lmtp= Ustrcmp(tf->protocol, "lmtp") == 0;
591 smtps= Ustrcmp(tf->protocol, "smtps") == 0;
594 HDEBUG(D_verify) debug_printf("interface=%s port=%d\n", interface, port);
596 /* Set up the buffer for reading SMTP response packets. */
598 inblock.buffer = inbuffer;
599 inblock.buffersize = sizeof(inbuffer);
600 inblock.ptr = inbuffer;
601 inblock.ptrend = inbuffer;
603 /* Set up the buffer for holding SMTP commands while pipelining */
605 outblock.buffer = outbuffer;
606 outblock.buffersize = sizeof(outbuffer);
607 outblock.ptr = outbuffer;
608 outblock.cmd_count = 0;
609 outblock.authenticating = FALSE;
611 /* Connect to the host; on failure, just loop for the next one, but we
612 set the error for the last one. Use the callout_connect timeout. */
614 tls_retry_connection:
616 /* Reset the parameters of a TLS session */
617 tls_out.cipher = tls_out.peerdn = tls_out.peercert = NULL;
619 inblock.sock = outblock.sock =
620 smtp_connect(host, host_af, port, interface, callout_connect,
622 if (inblock.sock < 0)
624 addr->message = string_sprintf("could not connect to %s [%s]: %s",
625 host->name, host->address, strerror(errno));
626 transport_name = NULL;
627 deliver_host = deliver_host_address = NULL;
628 deliver_domain = save_deliver_domain;
632 #if defined(SUPPORT_TLS) && defined(EXPERIMENTAL_DANE)
636 tls_out.dane_verified = FALSE;
637 tls_out.tlsa_usage = 0;
640 verify_check_given_host(&ob->hosts_require_dane, host) == OK;
642 if (host->dnssec == DS_YES)
645 || verify_check_given_host(&ob->hosts_try_dane, host) == OK
647 && (rc = tlsa_lookup(host, &tlsa_dnsa, dane_required, &dane)) != OK
651 else if (dane_required)
653 log_write(0, LOG_MAIN, "DANE error: %s lookup not DNSSEC", host->name);
658 ob->tls_tempfail_tryclear = FALSE;
662 /* Expand the helo_data string to find the host name to use. */
664 if (tf->helo_data != NULL)
666 uschar *s = expand_string(tf->helo_data);
668 log_write(0, LOG_MAIN|LOG_PANIC, "<%s>: failed to expand transport's "
669 "helo_data value for callout: %s", addr->address,
670 expand_string_message);
671 else active_hostname = s;
674 /* Wait for initial response, and send HELO. The smtp_write_command()
675 function leaves its command in big_buffer. This is used in error responses.
676 Initialize it in case the connection is rejected. */
678 Ustrcpy(big_buffer, "initial connection");
680 /* Unless ssl-on-connect, wait for the initial greeting */
684 if (!smtps || (smtps && tls_out.active >= 0))
687 if (!(done= smtp_read_response(&inblock, responsebuffer, sizeof(responsebuffer), '2', callout)))
688 goto RESPONSE_FAILED;
690 #ifndef DISABLE_EVENT
691 lookup_dnssec_authenticated = host->dnssec==DS_YES ? US"yes"
692 : host->dnssec==DS_NO ? US"no" : NULL;
693 if (event_raise(addr->transport->event_action,
694 US"smtp:connect", responsebuffer))
696 lookup_dnssec_authenticated = NULL;
697 /* Logging? Debug? */
698 goto RESPONSE_FAILED;
700 lookup_dnssec_authenticated = NULL;
704 /* Not worth checking greeting line for ESMTP support */
705 if (!(esmtp = verify_check_given_host(&ob->hosts_avoid_esmtp, host) != OK))
707 debug_printf("not sending EHLO (host matches hosts_avoid_esmtp)\n");
712 if (smtps && tls_out.active < 0) /* ssl-on-connect, first pass */
715 ob->tls_tempfail_tryclear = FALSE;
717 else /* all other cases */
722 if (!(done= smtp_write_command(&outblock, FALSE, "%s %s\r\n",
723 !esmtp? "HELO" : lmtp? "LHLO" : "EHLO", active_hostname) >= 0))
725 if (!smtp_read_response(&inblock, responsebuffer, sizeof(responsebuffer), '2', callout))
727 if (errno != 0 || responsebuffer[0] == 0 || lmtp || !esmtp || tls_out.active >= 0)
730 goto RESPONSE_FAILED;
736 goto esmtp_retry; /* fallback to HELO */
739 /* Set tls_offered if the response to EHLO specifies support for STARTTLS. */
741 if (esmtp && !suppress_tls && tls_out.active < 0)
743 if (regex_STARTTLS == NULL) regex_STARTTLS =
744 regex_must_compile(US"\\n250[\\s\\-]STARTTLS(\\s|\\n|$)", FALSE, TRUE);
746 tls_offered = pcre_exec(regex_STARTTLS, NULL, CS responsebuffer,
747 Ustrlen(responsebuffer), 0, PCRE_EOPT, NULL, 0) >= 0;
754 /* If TLS is available on this connection attempt to
755 start up a TLS session, unless the host is in hosts_avoid_tls. If successful,
756 send another EHLO - the server may give a different answer in secure mode. We
757 use a separate buffer for reading the response to STARTTLS so that if it is
758 negative, the original EHLO data is available for subsequent analysis, should
759 the client not be required to use TLS. If the response is bad, copy the buffer
760 for error analysis. */
764 && verify_check_given_host(&ob->hosts_avoid_tls, host) != OK
765 && verify_check_given_host(&ob->hosts_verify_avoid_tls, host) != OK
768 uschar buffer2[4096];
770 && !(done= smtp_write_command(&outblock, FALSE, "STARTTLS\r\n") >= 0))
773 /* If there is an I/O error, transmission of this message is deferred. If
774 there is a temporary rejection of STARRTLS and tls_tempfail_tryclear is
775 false, we also defer. However, if there is a temporary rejection of STARTTLS
776 and tls_tempfail_tryclear is true, or if there is an outright rejection of
777 STARTTLS, we carry on. This means we will try to send the message in clear,
778 unless the host is in hosts_require_tls (tested below). */
780 if (!smtps && !smtp_read_response(&inblock, buffer2, sizeof(buffer2), '2',
781 ob->command_timeout))
783 if (errno != 0 || buffer2[0] == 0 ||
784 (buffer2[0] == '4' && !ob->tls_tempfail_tryclear))
786 Ustrncpy(responsebuffer, buffer2, sizeof(responsebuffer));
788 goto RESPONSE_FAILED;
792 /* STARTTLS accepted or ssl-on-connect: try to negotiate a TLS session. */
795 int oldtimeout = ob->command_timeout;
799 ob->command_timeout = callout;
800 rc = tls_client_start(inblock.sock, host, addr, addr->transport
801 # ifdef EXPERIMENTAL_DANE
802 , dane ? &tlsa_dnsa : NULL
805 ob->command_timeout = oldtimeout;
807 /* TLS negotiation failed; give an error. Try in clear on a new
808 connection, if the options permit it for this host. */
813 (void)close(inblock.sock);
814 # ifndef DISABLE_EVENT
815 (void) event_raise(addr->transport->event_action,
816 US"tcp:close", NULL);
818 # ifdef EXPERIMENTAL_DANE
823 log_write(0, LOG_MAIN, "DANE attempt failed;"
824 " trying CA-root TLS to %s [%s] (not in hosts_require_dane)",
825 host->name, host->address);
832 if ( ob->tls_tempfail_tryclear
834 && verify_check_given_host(&ob->hosts_require_tls, host) != OK
837 log_write(0, LOG_MAIN, "TLS session failure:"
838 " delivering unencrypted to %s [%s] (not in hosts_require_tls)",
839 host->name, host->address);
841 goto tls_retry_connection;
845 /*save_errno = ERRNO_TLSFAILURE;*/
846 /*message = US"failure while setting up TLS session";*/
852 /* TLS session is set up. Copy info for logging. */
853 addr->cipher = tls_out.cipher;
854 addr->peerdn = tls_out.peerdn;
856 /* For SMTPS we need to wait for the initial OK response, then do HELO. */
858 goto smtps_redo_greeting;
860 /* For STARTTLS we need to redo EHLO */
865 /* If the host is required to use a secure channel, ensure that we have one. */
866 if (tls_out.active < 0)
868 # ifdef EXPERIMENTAL_DANE
871 verify_check_given_host(&ob->hosts_require_tls, host) == OK
874 /*save_errno = ERRNO_TLSREQUIRED;*/
875 log_write(0, LOG_MAIN,
876 "H=%s [%s]: a TLS session is required for this host, but %s",
877 host->name, host->address,
878 tls_offered ? "an attempt to start TLS failed"
879 : "the server did not offer TLS support");
884 #endif /*SUPPORT_TLS*/
886 done = TRUE; /* so far so good; have response to HELO */
888 /*XXX the EHLO response would be analyzed here for IGNOREQUOTA, SIZE, PIPELINING */
890 /* For now, transport_filter by cutthrough-delivery is not supported */
891 /* Need proper integration with the proper transport mechanism. */
892 if (cutthrough.delivery)
894 if (addr->transport->filter_command)
896 cutthrough.delivery = FALSE;
897 HDEBUG(D_acl|D_v) debug_printf("Cutthrough cancelled by presence of transport filter\n");
902 cutthrough.delivery = FALSE;
903 HDEBUG(D_acl|D_v) debug_printf("Cutthrough cancelled by presence of DKIM signing\n");
912 /* Clear down of the TLS, SMTP and TCP layers on error is handled below. */
914 /* Failure to accept HELO is cached; this blocks the whole domain for all
915 senders. I/O errors and defer responses are not cached. */
919 *failure_ptr = US"mail"; /* At or before MAIL */
920 if (errno == 0 && responsebuffer[0] == '5')
922 setflag(addr, af_verify_nsfail);
923 new_domain_record.result = ccache_reject;
928 else if ( addr->prop.utf8_msg
929 && !addr->prop.utf8_downcvt
932 || ( (regex_UTF8 = regex_must_compile(
933 US"\\n250[\\s\\-]SMTPUTF8(\\s|\\n|$)", FALSE, TRUE)),
936 && ( (utf8_offered = pcre_exec(regex_UTF8, NULL,
937 CS responsebuffer, Ustrlen(responsebuffer),
938 0, PCRE_EOPT, NULL, 0) >= 0)
939 || addr->prop.utf8_downcvt_maybe
942 HDEBUG(D_acl|D_v) debug_printf("utf8 required but not offered\n");
943 errno = ERRNO_UTF8_FWD;
944 setflag(addr, af_verify_nsfail);
947 else if ( addr->prop.utf8_msg
948 && (addr->prop.utf8_downcvt || !utf8_offered)
949 && (setflag(addr, af_utf8_downcvt),
950 from_address = string_address_utf8_to_alabel(from_address,
955 errno = ERRNO_EXPANDFAIL;
956 setflag(addr, af_verify_nsfail);
961 /* If we haven't authenticated, but are required to, give up. */
964 else done = smtp_auth(responsebuffer, sizeof(responsebuffer),
965 addr, host, ob, esmtp, &inblock, &outblock) == OK &&
967 /* Copy AUTH info for logging */
968 ( (addr->authenticator = client_authenticator),
969 (addr->auth_id = client_authenticated_id),
971 /* Build a mail-AUTH string (re-using responsebuffer for convenience */
972 !smtp_mail_auth_str(responsebuffer, sizeof(responsebuffer), addr, ob)
975 ( (addr->auth_sndr = client_authenticated_sender),
977 /* Send the MAIL command */
978 (smtp_write_command(&outblock, FALSE,
980 addr->prop.utf8_msg && !addr->prop.utf8_downcvt
981 ? "MAIL FROM:<%s>%s SMTPUTF8\r\n"
984 "MAIL FROM:<%s>%s\r\n",
985 from_address, responsebuffer) >= 0)
988 smtp_read_response(&inblock, responsebuffer, sizeof(responsebuffer),
991 deliver_host = deliver_host_address = NULL;
992 deliver_domain = save_deliver_domain;
994 /* If the host does not accept MAIL FROM:<>, arrange to cache this
995 information, but again, don't record anything for an I/O error or a defer. Do
996 not cache rejections of MAIL when a non-empty sender has been used, because
997 that blocks the whole domain for all senders. */
1001 *failure_ptr = US"mail"; /* At or before MAIL */
1002 if (errno == 0 && responsebuffer[0] == '5')
1004 setflag(addr, af_verify_nsfail);
1005 if (from_address[0] == 0)
1006 new_domain_record.result = ccache_reject_mfnull;
1010 /* Otherwise, proceed to check a "random" address (if required), then the
1011 given address, and the postmaster address (if required). Between each check,
1012 issue RSET, because some servers accept only one recipient after MAIL
1015 Before doing this, set the result in the domain cache record to "accept",
1016 unless its previous value was ccache_reject_mfnull. In that case, the domain
1017 rejects MAIL FROM:<> and we want to continue to remember that. When that is
1018 the case, we have got here only in the case of a recipient verification with
1019 a non-null sender. */
1023 const uschar * rcpt_domain = addr->domain;
1026 uschar * errstr = NULL;
1027 if ( testflag(addr, af_utf8_downcvt)
1028 && (rcpt_domain = string_domain_utf8_to_alabel(rcpt_domain,
1032 addr->message = errstr;
1033 errno = ERRNO_EXPANDFAIL;
1034 setflag(addr, af_verify_nsfail);
1036 rcpt_domain = US""; /*XXX errorhandling! */
1040 new_domain_record.result =
1041 (old_domain_cache_result == ccache_reject_mfnull)?
1042 ccache_reject_mfnull: ccache_accept;
1044 /* Do the random local part check first */
1046 if (random_local_part != NULL)
1048 uschar randombuffer[1024];
1050 smtp_write_command(&outblock, FALSE,
1051 "RCPT TO:<%.1000s@%.1000s>\r\n", random_local_part,
1052 rcpt_domain) >= 0 &&
1053 smtp_read_response(&inblock, randombuffer,
1054 sizeof(randombuffer), '2', callout);
1056 /* Remember when we last did a random test */
1058 new_domain_record.random_stamp = time(NULL);
1060 /* If accepted, we aren't going to do any further tests below. */
1063 new_domain_record.random_result = ccache_accept;
1065 /* Otherwise, cache a real negative response, and get back to the right
1066 state to send RCPT. Unless there's some problem such as a dropped
1067 connection, we expect to succeed, because the commands succeeded above.
1068 However, some servers drop the connection after responding to an
1069 invalid recipient, so on (any) error we drop and remake the connection.
1072 else if (errno == 0)
1074 /* This would be ok for 1st rcpt a cutthrough, but no way to
1075 handle a subsequent. So refuse to support any */
1076 cancel_cutthrough_connection("random-recipient");
1078 if (randombuffer[0] == '5')
1079 new_domain_record.random_result = ccache_reject;
1082 smtp_write_command(&outblock, FALSE, "RSET\r\n") >= 0 &&
1083 smtp_read_response(&inblock, responsebuffer, sizeof(responsebuffer),
1086 smtp_write_command(&outblock, FALSE,
1088 addr->prop.utf8_msg && !addr->prop.utf8_downcvt
1089 ? "MAIL FROM:<%s> SMTPUTF8\r\n"
1092 "MAIL FROM:<%s>\r\n",
1093 from_address) >= 0 &&
1094 smtp_read_response(&inblock, responsebuffer, sizeof(responsebuffer),
1100 debug_printf("problem after random/rset/mfrom; reopen conn\n");
1101 random_local_part = NULL;
1103 tls_close(FALSE, TRUE);
1105 (void)close(inblock.sock);
1106 #ifndef DISABLE_EVENT
1107 (void) event_raise(addr->transport->event_action,
1108 US"tcp:close", NULL);
1110 goto tls_retry_connection;
1113 else done = FALSE; /* Some timeout/connection problem */
1114 } /* Random check */
1116 /* If the host is accepting all local parts, as determined by the "random"
1117 check, we don't need to waste time doing any further checking. */
1119 if (new_domain_record.random_result != ccache_accept && done)
1121 /* Get the rcpt_include_affixes flag from the transport if there is one,
1122 but assume FALSE if there is not. */
1124 uschar * rcpt = transport_rcpt_address(addr,
1125 addr->transport ? addr->transport->rcpt_include_affixes : FALSE);
1128 /*XXX should the conversion be moved into transport_rcpt_address() ? */
1129 uschar * dummy_errstr = NULL;
1130 if ( testflag(addr, af_utf8_downcvt)
1131 && (rcpt = string_address_utf8_to_alabel(rcpt, &dummy_errstr),
1135 errno = ERRNO_EXPANDFAIL;
1136 *failure_ptr = US"recipient";
1143 smtp_write_command(&outblock, FALSE, "RCPT TO:<%.1000s>\r\n",
1145 smtp_read_response(&inblock, responsebuffer, sizeof(responsebuffer),
1149 new_address_record.result = ccache_accept;
1150 else if (errno == 0 && responsebuffer[0] == '5')
1152 *failure_ptr = US"recipient";
1153 new_address_record.result = ccache_reject;
1156 /* Do postmaster check if requested; if a full check is required, we
1157 check for RCPT TO:<postmaster> (no domain) in accordance with RFC 821. */
1159 if (done && pm_mailfrom != NULL)
1161 /* Could possibly shift before main verify, just above, and be ok
1162 for cutthrough. But no way to handle a subsequent rcpt, so just
1164 cancel_cutthrough_connection("postmaster verify");
1165 HDEBUG(D_acl|D_v) debug_printf("Cutthrough cancelled by presence of postmaster verify\n");
1168 smtp_write_command(&outblock, FALSE, "RSET\r\n") >= 0 &&
1169 smtp_read_response(&inblock, responsebuffer,
1170 sizeof(responsebuffer), '2', callout) &&
1172 smtp_write_command(&outblock, FALSE,
1173 "MAIL FROM:<%s>\r\n", pm_mailfrom) >= 0 &&
1174 smtp_read_response(&inblock, responsebuffer,
1175 sizeof(responsebuffer), '2', callout) &&
1177 /* First try using the current domain */
1180 smtp_write_command(&outblock, FALSE,
1181 "RCPT TO:<postmaster@%.1000s>\r\n", rcpt_domain) >= 0 &&
1182 smtp_read_response(&inblock, responsebuffer,
1183 sizeof(responsebuffer), '2', callout)
1188 /* If that doesn't work, and a full check is requested,
1189 try without the domain. */
1192 (options & vopt_callout_fullpm) != 0 &&
1193 smtp_write_command(&outblock, FALSE,
1194 "RCPT TO:<postmaster>\r\n") >= 0 &&
1195 smtp_read_response(&inblock, responsebuffer,
1196 sizeof(responsebuffer), '2', callout)
1199 /* Sort out the cache record */
1201 new_domain_record.postmaster_stamp = time(NULL);
1204 new_domain_record.postmaster_result = ccache_accept;
1205 else if (errno == 0 && responsebuffer[0] == '5')
1207 *failure_ptr = US"postmaster";
1208 setflag(addr, af_verify_pmfail);
1209 new_domain_record.postmaster_result = ccache_reject;
1212 } /* Random not accepted */
1213 } /* MAIL FROM: accepted */
1215 /* For any failure of the main check, other than a negative response, we just
1216 close the connection and carry on. We can identify a negative response by the
1217 fact that errno is zero. For I/O errors it will be non-zero
1219 Set up different error texts for logging and for sending back to the caller
1220 as an SMTP response. Log in all cases, using a one-line format. For sender
1221 callouts, give a full response to the caller, but for recipient callouts,
1222 don't give the IP address because this may be an internal host whose identity
1223 is not to be widely broadcast. */
1227 if (errno == ETIMEDOUT)
1229 HDEBUG(D_verify) debug_printf("SMTP timeout\n");
1233 else if (errno == ERRNO_UTF8_FWD)
1235 extern int acl_where; /* src/acl.c */
1237 addr->message = string_sprintf(
1238 "response to \"%s\" from %s [%s] did not include SMTPUTF8",
1239 big_buffer, host->name, host->address);
1240 addr->user_message = acl_where == ACL_WHERE_RCPT
1241 ? US"533 mailbox name not allowed"
1242 : US"550 mailbox unavailable";
1247 else if (errno == 0)
1249 if (*responsebuffer == 0) Ustrcpy(responsebuffer, US"connection dropped");
1252 string_sprintf("response to \"%s\" from %s [%s] was: %s",
1253 big_buffer, host->name, host->address,
1254 string_printing(responsebuffer));
1256 addr->user_message = is_recipient?
1257 string_sprintf("Callout verification failed:\n%s", responsebuffer)
1259 string_sprintf("Called: %s\nSent: %s\nResponse: %s",
1260 host->address, big_buffer, responsebuffer);
1262 /* Hard rejection ends the process */
1264 if (responsebuffer[0] == '5') /* Address rejected */
1272 /* End the SMTP conversation and close the connection. */
1274 /* Cutthrough - on a successfull connect and recipient-verify with
1275 use-sender and we are 1st rcpt and have no cutthrough conn so far
1276 here is where we want to leave the conn open */
1277 if ( cutthrough.delivery
1281 && (options & (vopt_callout_recipsender|vopt_callout_recippmaster)) == vopt_callout_recipsender
1282 && !random_local_part
1284 && cutthrough.fd < 0
1288 cutthrough.fd = outblock.sock; /* We assume no buffer in use in the outblock */
1289 cutthrough.nrcpt = 1;
1290 cutthrough.interface = interface;
1291 cutthrough.host = *host;
1292 cutthrough.addr = *addr; /* Save the address_item for later logging */
1293 cutthrough.addr.next = NULL;
1294 cutthrough.addr.host_used = &cutthrough.host;
1296 *(cutthrough.addr.parent = store_get(sizeof(address_item))) =
1298 ctblock.buffer = ctbuffer;
1299 ctblock.buffersize = sizeof(ctbuffer);
1300 ctblock.ptr = ctbuffer;
1301 /* ctblock.cmd_count = 0; ctblock.authenticating = FALSE; */
1302 ctblock.sock = cutthrough.fd;
1306 /* Ensure no cutthrough on multiple address verifies */
1307 if (options & vopt_callout_recipsender)
1308 cancel_cutthrough_connection("multiple verify calls");
1309 if (send_quit) (void)smtp_write_command(&outblock, FALSE, "QUIT\r\n");
1312 tls_close(FALSE, TRUE);
1314 (void)close(inblock.sock);
1315 #ifndef DISABLE_EVENT
1316 (void) event_raise(addr->transport->event_action, US"tcp:close", NULL);
1320 } /* Loop through all hosts, while !done */
1323 /* If we get here with done == TRUE, a successful callout happened, and yield
1324 will be set OK or FAIL according to the response to the RCPT command.
1325 Otherwise, we looped through the hosts but couldn't complete the business.
1326 However, there may be domain-specific information to cache in both cases.
1328 The value of the result field in the new_domain record is ccache_unknown if
1329 there was an error before or with MAIL FROM:, and errno was not zero,
1330 implying some kind of I/O error. We don't want to write the cache in that case.
1331 Otherwise the value is ccache_accept, ccache_reject, or ccache_reject_mfnull. */
1333 if (!callout_no_cache && new_domain_record.result != ccache_unknown)
1335 if ((dbm_file = dbfn_open(US"callout", O_RDWR|O_CREAT, &dbblock, FALSE))
1338 HDEBUG(D_verify) debug_printf("callout cache: not available\n");
1342 (void)dbfn_write(dbm_file, addr->domain, &new_domain_record,
1343 (int)sizeof(dbdata_callout_cache));
1344 HDEBUG(D_verify) debug_printf("wrote callout cache domain record:\n"
1345 " result=%d postmaster=%d random=%d\n",
1346 new_domain_record.result,
1347 new_domain_record.postmaster_result,
1348 new_domain_record.random_result);
1352 /* If a definite result was obtained for the callout, cache it unless caching
1357 if (!callout_no_cache && new_address_record.result != ccache_unknown)
1359 if (dbm_file == NULL)
1360 dbm_file = dbfn_open(US"callout", O_RDWR|O_CREAT, &dbblock, FALSE);
1361 if (dbm_file == NULL)
1363 HDEBUG(D_verify) debug_printf("no callout cache available\n");
1367 (void)dbfn_write(dbm_file, address_key, &new_address_record,
1368 (int)sizeof(dbdata_callout_cache_address));
1369 HDEBUG(D_verify) debug_printf("wrote %s callout cache address record\n",
1370 (new_address_record.result == ccache_accept)? "positive" : "negative");
1375 /* Failure to connect to any host, or any response other than 2xx or 5xx is a
1376 temporary error. If there was only one host, and a response was received, leave
1377 it alone if supplying details. Otherwise, give a generic response. */
1381 uschar *dullmsg = string_sprintf("Could not complete %s verify callout",
1382 is_recipient? "recipient" : "sender");
1385 if (host_list->next != NULL || addr->message == NULL) addr->message = dullmsg;
1387 addr->user_message = (!smtp_return_error_details)? dullmsg :
1388 string_sprintf("%s for <%s>.\n"
1389 "The mail server(s) for the domain may be temporarily unreachable, or\n"
1390 "they may be permanently unreachable from this server. In the latter case,\n%s",
1391 dullmsg, addr->address,
1393 "the address will never be accepted."
1395 "you need to change the address or create an MX record for its domain\n"
1396 "if it is supposed to be generally accessible from the Internet.\n"
1397 "Talk to your mail administrator for details.");
1399 /* Force a specific error code */
1401 addr->basic_errno = ERRNO_CALLOUTDEFER;
1404 /* Come here from within the cache-reading code on fast-track exit. */
1407 if (dbm_file != NULL) dbfn_close(dbm_file);
1413 /* Called after recipient-acl to get a cutthrough connection open when
1414 one was requested and a recipient-verify wasn't subsequently done.
1417 open_cutthrough_connection( address_item * addr )
1422 /* Use a recipient-verify-callout to set up the cutthrough connection. */
1423 /* We must use a copy of the address for verification, because it might
1427 HDEBUG(D_acl) debug_printf("----------- %s cutthrough setup ------------\n",
1428 rcpt_count > 1 ? "more" : "start");
1429 rc= verify_address(&addr2, NULL,
1430 vopt_is_recipient | vopt_callout_recipsender | vopt_callout_no_cache,
1431 CUTTHROUGH_CMD_TIMEOUT, -1, -1,
1433 HDEBUG(D_acl) debug_printf("----------- end cutthrough setup ------------\n");
1439 /* Send given number of bytes from the buffer */
1441 cutthrough_send(int n)
1443 if(cutthrough.fd < 0)
1448 (tls_out.active == cutthrough.fd) ? tls_write(FALSE, ctblock.buffer, n) :
1450 send(cutthrough.fd, ctblock.buffer, n, 0) > 0
1453 transport_count += n;
1454 ctblock.ptr= ctblock.buffer;
1458 HDEBUG(D_transport|D_acl) debug_printf("cutthrough_send failed: %s\n", strerror(errno));
1465 _cutthrough_puts(uschar * cp, int n)
1469 if(ctblock.ptr >= ctblock.buffer+ctblock.buffersize)
1470 if(!cutthrough_send(ctblock.buffersize))
1473 *ctblock.ptr++ = *cp++;
1478 /* Buffered output of counted data block. Return boolean success */
1480 cutthrough_puts(uschar * cp, int n)
1482 if (cutthrough.fd < 0) return TRUE;
1483 if (_cutthrough_puts(cp, n)) return TRUE;
1484 cancel_cutthrough_connection("transmit failed");
1490 _cutthrough_flush_send(void)
1492 int n= ctblock.ptr-ctblock.buffer;
1495 if(!cutthrough_send(n))
1501 /* Send out any bufferred output. Return boolean success. */
1503 cutthrough_flush_send(void)
1505 if (_cutthrough_flush_send()) return TRUE;
1506 cancel_cutthrough_connection("transmit failed");
1512 cutthrough_put_nl(void)
1514 return cutthrough_puts(US"\r\n", 2);
1518 /* Get and check response from cutthrough target */
1520 cutthrough_response(char expect, uschar ** copy)
1522 smtp_inblock inblock;
1523 uschar inbuffer[4096];
1524 uschar responsebuffer[4096];
1526 inblock.buffer = inbuffer;
1527 inblock.buffersize = sizeof(inbuffer);
1528 inblock.ptr = inbuffer;
1529 inblock.ptrend = inbuffer;
1530 inblock.sock = cutthrough.fd;
1531 /* this relies on (inblock.sock == tls_out.active) */
1532 if(!smtp_read_response(&inblock, responsebuffer, sizeof(responsebuffer), expect, CUTTHROUGH_DATA_TIMEOUT))
1533 cancel_cutthrough_connection("target timeout on read");
1538 *copy = cp = string_copy(responsebuffer);
1539 /* Trim the trailing end of line */
1540 cp += Ustrlen(responsebuffer);
1541 if(cp > *copy && cp[-1] == '\n') *--cp = '\0';
1542 if(cp > *copy && cp[-1] == '\r') *--cp = '\0';
1545 return responsebuffer[0];
1549 /* Negotiate dataphase with the cutthrough target, returning success boolean */
1551 cutthrough_predata(void)
1553 if(cutthrough.fd < 0)
1556 HDEBUG(D_transport|D_acl|D_v) debug_printf(" SMTP>> DATA\n");
1557 cutthrough_puts(US"DATA\r\n", 6);
1558 cutthrough_flush_send();
1560 /* Assume nothing buffered. If it was it gets ignored. */
1561 return cutthrough_response('3', NULL) == '3';
1565 /* fd and use_crlf args only to match write_chunk() */
1567 cutthrough_write_chunk(int fd, uschar * s, int len, BOOL use_crlf)
1570 while(s && (s2 = Ustrchr(s, '\n')))
1572 if(!cutthrough_puts(s, s2-s) || !cutthrough_put_nl())
1580 /* Buffered send of headers. Return success boolean. */
1581 /* Expands newlines to wire format (CR,NL). */
1582 /* Also sends header-terminating blank line. */
1584 cutthrough_headers_send(void)
1586 if(cutthrough.fd < 0)
1589 /* We share a routine with the mainline transport to handle header add/remove/rewrites,
1590 but having a separate buffered-output function (for now)
1592 HDEBUG(D_acl) debug_printf("----------- start cutthrough headers send -----------\n");
1594 if (!transport_headers_send(&cutthrough.addr, cutthrough.fd,
1595 cutthrough.addr.transport->add_headers,
1596 cutthrough.addr.transport->remove_headers,
1597 &cutthrough_write_chunk, TRUE,
1598 cutthrough.addr.transport->rewrite_rules,
1599 cutthrough.addr.transport->rewrite_existflags))
1602 HDEBUG(D_acl) debug_printf("----------- done cutthrough headers send ------------\n");
1608 close_cutthrough_connection(const char * why)
1610 if(cutthrough.fd >= 0)
1612 /* We could be sending this after a bunch of data, but that is ok as
1613 the only way to cancel the transfer in dataphase is to drop the tcp
1614 conn before the final dot.
1616 ctblock.ptr = ctbuffer;
1617 HDEBUG(D_transport|D_acl|D_v) debug_printf(" SMTP>> QUIT\n");
1618 _cutthrough_puts(US"QUIT\r\n", 6); /* avoid recursion */
1619 _cutthrough_flush_send();
1620 /* No wait for response */
1623 tls_close(FALSE, TRUE);
1625 (void)close(cutthrough.fd);
1627 HDEBUG(D_acl) debug_printf("----------- cutthrough shutdown (%s) ------------\n", why);
1629 ctblock.ptr = ctbuffer;
1633 cancel_cutthrough_connection(const char * why)
1635 close_cutthrough_connection(why);
1636 cutthrough.delivery = FALSE;
1642 /* Have senders final-dot. Send one to cutthrough target, and grab the response.
1643 Log an OK response as a transmission.
1644 Close the connection.
1645 Return smtp response-class digit.
1648 cutthrough_finaldot(void)
1651 address_item * addr;
1652 HDEBUG(D_transport|D_acl|D_v) debug_printf(" SMTP>> .\n");
1654 /* Assume data finshed with new-line */
1655 if( !cutthrough_puts(US".", 1)
1656 || !cutthrough_put_nl()
1657 || !cutthrough_flush_send()
1659 return cutthrough.addr.message;
1661 res = cutthrough_response('2', &cutthrough.addr.message);
1662 for (addr = &cutthrough.addr; addr; addr = addr->next)
1664 addr->message = cutthrough.addr.message;
1668 delivery_log(LOG_MAIN, addr, (int)'>', NULL);
1669 close_cutthrough_connection("delivered");
1673 delivery_log(LOG_MAIN, addr, 0,
1674 US"tmp-reject from cutthrough after DATA:");
1678 delivery_log(LOG_MAIN|LOG_REJECT, addr, 0,
1679 US"rejected after DATA:");
1686 return cutthrough.addr.message;
1691 /*************************************************
1692 * Copy error to toplevel address *
1693 *************************************************/
1695 /* This function is used when a verify fails or defers, to ensure that the
1696 failure or defer information is in the original toplevel address. This applies
1697 when an address is redirected to a single new address, and the failure or
1698 deferral happens to the child address.
1701 vaddr the verify address item
1702 addr the final address item
1705 Returns: the value of YIELD
1709 copy_error(address_item *vaddr, address_item *addr, int yield)
1713 vaddr->message = addr->message;
1714 vaddr->user_message = addr->user_message;
1715 vaddr->basic_errno = addr->basic_errno;
1716 vaddr->more_errno = addr->more_errno;
1717 vaddr->prop.address_data = addr->prop.address_data;
1718 copyflag(vaddr, addr, af_pass_message);
1726 /**************************************************
1727 * printf that automatically handles TLS if needed *
1728 ***************************************************/
1730 /* This function is used by verify_address() as a substitute for all fprintf()
1731 calls; a direct fprintf() will not produce output in a TLS SMTP session, such
1732 as a response to an EXPN command. smtp_in.c makes smtp_printf available but
1733 that assumes that we always use the smtp_out FILE* when not using TLS or the
1734 ssl buffer when we are. Instead we take a FILE* parameter and check to see if
1735 that is smtp_out; if so, smtp_printf() with TLS support, otherwise regular
1739 f the candidate FILE* to write to
1740 format format string
1741 ... optional arguments
1747 static void PRINTF_FUNCTION(2,3)
1748 respond_printf(FILE *f, const char *format, ...)
1752 va_start(ap, format);
1753 if (smtp_out && (f == smtp_out))
1754 smtp_vprintf(format, ap);
1756 vfprintf(f, format, ap);
1762 /*************************************************
1763 * Verify an email address *
1764 *************************************************/
1766 /* This function is used both for verification (-bv and at other times) and
1767 address testing (-bt), which is indicated by address_test_mode being set.
1770 vaddr contains the address to verify; the next field in this block
1772 f if not NULL, write the result to this file
1773 options various option bits:
1774 vopt_fake_sender => this sender verify is not for the real
1775 sender (it was verify=sender=xxxx or an address from a
1776 header line) - rewriting must not change sender_address
1777 vopt_is_recipient => this is a recipient address, otherwise
1778 it's a sender address - this affects qualification and
1779 rewriting and messages from callouts
1780 vopt_qualify => qualify an unqualified address; else error
1781 vopt_expn => called from SMTP EXPN command
1782 vopt_success_on_redirect => when a new address is generated
1783 the verification instantly succeeds
1785 These ones are used by do_callout() -- the options variable
1788 vopt_callout_fullpm => if postmaster check, do full one
1789 vopt_callout_no_cache => don't use callout cache
1790 vopt_callout_random => do the "random" thing
1791 vopt_callout_recipsender => use real sender for recipient
1792 vopt_callout_recippmaster => use postmaster for recipient
1794 callout if > 0, specifies that callout is required, and gives timeout
1795 for individual commands
1796 callout_overall if > 0, gives overall timeout for the callout function;
1797 if < 0, a default is used (see do_callout())
1798 callout_connect the connection timeout for callouts
1799 se_mailfrom when callout is requested to verify a sender, use this
1800 in MAIL FROM; NULL => ""
1801 pm_mailfrom when callout is requested, if non-NULL, do the postmaster
1802 thing and use this as the sender address (may be "")
1804 routed if not NULL, set TRUE if routing succeeded, so we can
1805 distinguish between routing failed and callout failed
1807 Returns: OK address verified
1808 FAIL address failed to verify
1809 DEFER can't tell at present
1813 verify_address(address_item *vaddr, FILE *f, int options, int callout,
1814 int callout_overall, int callout_connect, uschar *se_mailfrom,
1815 uschar *pm_mailfrom, BOOL *routed)
1818 BOOL full_info = (f == NULL)? FALSE : (debug_selector != 0);
1819 BOOL is_recipient = (options & vopt_is_recipient) != 0;
1820 BOOL expn = (options & vopt_expn) != 0;
1821 BOOL success_on_redirect = (options & vopt_success_on_redirect) != 0;
1824 int verify_type = expn? v_expn :
1825 address_test_mode? v_none :
1826 is_recipient? v_recipient : v_sender;
1827 address_item *addr_list;
1828 address_item *addr_new = NULL;
1829 address_item *addr_remote = NULL;
1830 address_item *addr_local = NULL;
1831 address_item *addr_succeed = NULL;
1832 uschar **failure_ptr = is_recipient?
1833 &recipient_verify_failure : &sender_verify_failure;
1834 uschar *ko_prefix, *cr;
1835 uschar *address = vaddr->address;
1836 uschar *save_sender;
1837 uschar null_sender[] = { 0 }; /* Ensure writeable memory */
1839 /* Clear, just in case */
1841 *failure_ptr = NULL;
1843 /* Set up a prefix and suffix for error message which allow us to use the same
1844 output statements both in EXPN mode (where an SMTP response is needed) and when
1845 debugging with an output file. */
1849 ko_prefix = US"553 ";
1852 else ko_prefix = cr = US"";
1854 /* Add qualify domain if permitted; otherwise an unqualified address fails. */
1856 if (parse_find_at(address) == NULL)
1858 if ((options & vopt_qualify) == 0)
1861 respond_printf(f, "%sA domain is required for \"%s\"%s\n",
1862 ko_prefix, address, cr);
1863 *failure_ptr = US"qualify";
1866 address = rewrite_address_qualify(address, is_recipient);
1871 debug_printf(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n");
1872 debug_printf("%s %s\n", address_test_mode? "Testing" : "Verifying", address);
1875 /* Rewrite and report on it. Clear the domain and local part caches - these
1876 may have been set by domains and local part tests during an ACL. */
1878 if (global_rewrite_rules != NULL)
1880 uschar *old = address;
1881 address = rewrite_address(address, is_recipient, FALSE,
1882 global_rewrite_rules, rewrite_existflags);
1885 for (i = 0; i < (MAX_NAMED_LIST * 2)/32; i++) vaddr->localpart_cache[i] = 0;
1886 for (i = 0; i < (MAX_NAMED_LIST * 2)/32; i++) vaddr->domain_cache[i] = 0;
1887 if (f != NULL && !expn) fprintf(f, "Address rewritten as: %s\n", address);
1891 /* If this is the real sender address, we must update sender_address at
1892 this point, because it may be referred to in the routers. */
1894 if ((options & (vopt_fake_sender|vopt_is_recipient)) == 0)
1895 sender_address = address;
1897 /* If the address was rewritten to <> no verification can be done, and we have
1898 to return OK. This rewriting is permitted only for sender addresses; for other
1899 addresses, such rewriting fails. */
1901 if (address[0] == 0) return OK;
1903 /* Flip the legacy TLS-related variables over to the outbound set in case
1904 they're used in the context of a transport used by verification. Reset them
1905 at exit from this routine. */
1907 tls_modify_variables(&tls_out);
1909 /* Save a copy of the sender address for re-instating if we change it to <>
1910 while verifying a sender address (a nice bit of self-reference there). */
1912 save_sender = sender_address;
1914 /* Update the address structure with the possibly qualified and rewritten
1915 address. Set it up as the starting address on the chain of new addresses. */
1917 vaddr->address = address;
1920 /* We need a loop, because an address can generate new addresses. We must also
1921 cope with generated pipes and files at the top level. (See also the code and
1922 comment in deliver.c.) However, it is usually the case that the router for
1923 user's .forward files has its verify flag turned off.
1925 If an address generates more than one child, the loop is used only when
1926 full_info is set, and this can only be set locally. Remote enquiries just get
1927 information about the top level address, not anything that it generated. */
1929 while (addr_new != NULL)
1932 address_item *addr = addr_new;
1934 addr_new = addr->next;
1939 debug_printf(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n");
1940 debug_printf("Considering %s\n", addr->address);
1943 /* Handle generated pipe, file or reply addresses. We don't get these
1944 when handling EXPN, as it does only one level of expansion. */
1946 if (testflag(addr, af_pfr))
1953 if (addr->address[0] == '>')
1955 allow = testflag(addr, af_allow_reply);
1956 fprintf(f, "%s -> mail %s", addr->parent->address, addr->address + 1);
1960 allow = (addr->address[0] == '|')?
1961 testflag(addr, af_allow_pipe) : testflag(addr, af_allow_file);
1962 fprintf(f, "%s -> %s", addr->parent->address, addr->address);
1965 if (addr->basic_errno == ERRNO_BADTRANSPORT)
1966 fprintf(f, "\n*** Error in setting up pipe, file, or autoreply:\n"
1967 "%s\n", addr->message);
1969 fprintf(f, "\n transport = %s\n", addr->transport->name);
1971 fprintf(f, " *** forbidden ***\n");
1976 /* Just in case some router parameter refers to it. */
1978 return_path = (addr->prop.errors_address != NULL)?
1979 addr->prop.errors_address : sender_address;
1981 /* Split the address into domain and local part, handling the %-hack if
1982 necessary, and then route it. While routing a sender address, set
1983 $sender_address to <> because that is what it will be if we were trying to
1984 send a bounce to the sender. */
1986 if (routed != NULL) *routed = FALSE;
1987 if ((rc = deliver_split_address(addr)) == OK)
1989 if (!is_recipient) sender_address = null_sender;
1990 rc = route_address(addr, &addr_local, &addr_remote, &addr_new,
1991 &addr_succeed, verify_type);
1992 sender_address = save_sender; /* Put back the real sender */
1995 /* If routing an address succeeded, set the flag that remembers, for use when
1996 an ACL cached a sender verify (in case a callout fails). Then if routing set
1997 up a list of hosts or the transport has a host list, and the callout option
1998 is set, and we aren't in a host checking run, do the callout verification,
1999 and set another flag that notes that a callout happened. */
2003 if (routed != NULL) *routed = TRUE;
2006 host_item *host_list = addr->host_list;
2007 transport_instance * tp;
2009 /* Make up some data for use in the case where there is no remote
2012 transport_feedback tf = {
2013 NULL, /* interface (=> any) */
2014 US"smtp", /* port */
2015 US"smtp", /* protocol */
2017 US"$smtp_active_hostname", /* helo_data */
2018 FALSE, /* hosts_override */
2019 FALSE, /* hosts_randomize */
2020 FALSE, /* gethostbyname */
2021 TRUE, /* qualify_single */
2022 FALSE /* search_parents */
2025 /* If verification yielded a remote transport, we want to use that
2026 transport's options, so as to mimic what would happen if we were really
2027 sending a message to this address. */
2029 if ((tp = addr->transport) && !tp->info->local)
2031 (void)(tp->setup)(tp, addr, &tf, 0, 0, NULL);
2033 /* If the transport has hosts and the router does not, or if the
2034 transport is configured to override the router's hosts, we must build a
2035 host list of the transport's hosts, and find the IP addresses */
2037 if (tf.hosts != NULL && (host_list == NULL || tf.hosts_override))
2040 const uschar *save_deliver_domain = deliver_domain;
2041 uschar *save_deliver_localpart = deliver_localpart;
2043 host_list = NULL; /* Ignore the router's hosts */
2045 deliver_domain = addr->domain;
2046 deliver_localpart = addr->local_part;
2047 s = expand_string(tf.hosts);
2048 deliver_domain = save_deliver_domain;
2049 deliver_localpart = save_deliver_localpart;
2053 log_write(0, LOG_MAIN|LOG_PANIC, "failed to expand list of hosts "
2054 "\"%s\" in %s transport for callout: %s", tf.hosts,
2055 tp->name, expand_string_message);
2060 host_item *host, *nexthost;
2061 host_build_hostlist(&host_list, s, tf.hosts_randomize);
2063 /* Just ignore failures to find a host address. If we don't manage
2064 to find any addresses, the callout will defer. Note that more than
2065 one address may be found for a single host, which will result in
2066 additional host items being inserted into the chain. Hence we must
2067 save the next host first. */
2069 flags = HOST_FIND_BY_A;
2070 if (tf.qualify_single) flags |= HOST_FIND_QUALIFY_SINGLE;
2071 if (tf.search_parents) flags |= HOST_FIND_SEARCH_PARENTS;
2073 for (host = host_list; host != NULL; host = nexthost)
2075 nexthost = host->next;
2076 if (tf.gethostbyname ||
2077 string_is_ip_address(host->name, NULL) != 0)
2078 (void)host_find_byname(host, NULL, flags, NULL, TRUE);
2081 dnssec_domains * dnssec_domains = NULL;
2082 if (Ustrcmp(tp->driver_name, "smtp") == 0)
2084 smtp_transport_options_block * ob =
2085 (smtp_transport_options_block *) tp->options_block;
2086 dnssec_domains = &ob->dnssec;
2089 (void)host_find_bydns(host, NULL, flags, NULL, NULL, NULL,
2090 dnssec_domains, NULL, NULL);
2097 /* Can only do a callout if we have at least one host! If the callout
2098 fails, it will have set ${sender,recipient}_verify_failure. */
2100 if (host_list != NULL)
2102 HDEBUG(D_verify) debug_printf("Attempting full verification using callout\n");
2103 if (host_checking && !host_checking_callout)
2106 debug_printf("... callout omitted by default when host testing\n"
2107 "(Use -bhc if you want the callouts to happen.)\n");
2112 deliver_set_expansions(addr);
2114 verify_mode = is_recipient ? US"R" : US"S";
2115 rc = do_callout(addr, host_list, &tf, callout, callout_overall,
2116 callout_connect, options, se_mailfrom, pm_mailfrom);
2122 HDEBUG(D_verify) debug_printf("Cannot do callout: neither router nor "
2123 "transport provided a host list\n");
2128 /* Otherwise, any failure is a routing failure */
2130 else *failure_ptr = US"route";
2132 /* A router may return REROUTED if it has set up a child address as a result
2133 of a change of domain name (typically from widening). In this case we always
2134 want to continue to verify the new child. */
2136 if (rc == REROUTED) continue;
2138 /* Handle hard failures */
2145 address_item *p = addr->parent;
2147 respond_printf(f, "%s%s %s", ko_prefix,
2148 full_info? addr->address : address,
2149 address_test_mode? "is undeliverable" : "failed to verify");
2150 if (!expn && admin_user)
2152 if (addr->basic_errno > 0)
2153 respond_printf(f, ": %s", strerror(addr->basic_errno));
2154 if (addr->message != NULL)
2155 respond_printf(f, ": %s", addr->message);
2158 /* Show parents iff doing full info */
2160 if (full_info) while (p != NULL)
2162 respond_printf(f, "%s\n <-- %s", cr, p->address);
2165 respond_printf(f, "%s\n", cr);
2167 cancel_cutthrough_connection("routing hard fail");
2171 yield = copy_error(vaddr, addr, FAIL);
2179 else if (rc == DEFER)
2184 address_item *p = addr->parent;
2185 respond_printf(f, "%s%s cannot be resolved at this time", ko_prefix,
2186 full_info? addr->address : address);
2187 if (!expn && admin_user)
2189 if (addr->basic_errno > 0)
2190 respond_printf(f, ": %s", strerror(addr->basic_errno));
2191 if (addr->message != NULL)
2192 respond_printf(f, ": %s", addr->message);
2193 else if (addr->basic_errno <= 0)
2194 respond_printf(f, ": unknown error");
2197 /* Show parents iff doing full info */
2199 if (full_info) while (p != NULL)
2201 respond_printf(f, "%s\n <-- %s", cr, p->address);
2204 respond_printf(f, "%s\n", cr);
2206 cancel_cutthrough_connection("routing soft fail");
2210 yield = copy_error(vaddr, addr, DEFER);
2213 else if (yield == OK) yield = DEFER;
2216 /* If we are handling EXPN, we do not want to continue to route beyond
2217 the top level (whose address is in "address"). */
2221 uschar *ok_prefix = US"250-";
2222 if (addr_new == NULL)
2224 if (addr_local == NULL && addr_remote == NULL)
2225 respond_printf(f, "250 mail to <%s> is discarded\r\n", address);
2227 respond_printf(f, "250 <%s>\r\n", address);
2229 else while (addr_new != NULL)
2231 address_item *addr2 = addr_new;
2232 addr_new = addr2->next;
2233 if (addr_new == NULL) ok_prefix = US"250 ";
2234 respond_printf(f, "%s<%s>\r\n", ok_prefix, addr2->address);
2240 /* Successful routing other than EXPN. */
2244 /* Handle successful routing when short info wanted. Otherwise continue for
2245 other (generated) addresses. Short info is the operational case. Full info
2246 can be requested only when debug_selector != 0 and a file is supplied.
2248 There is a conflict between the use of aliasing as an alternate email
2249 address, and as a sort of mailing list. If an alias turns the incoming
2250 address into just one address (e.g. J.Caesar->jc44) you may well want to
2251 carry on verifying the generated address to ensure it is valid when
2252 checking incoming mail. If aliasing generates multiple addresses, you
2253 probably don't want to do this. Exim therefore treats the generation of
2254 just a single new address as a special case, and continues on to verify the
2255 generated address. */
2257 if (!full_info && /* Stop if short info wanted AND */
2258 (((addr_new == NULL || /* No new address OR */
2259 addr_new->next != NULL || /* More than one new address OR */
2260 testflag(addr_new, af_pfr))) /* New address is pfr */
2262 (addr_new != NULL && /* At least one new address AND */
2263 success_on_redirect))) /* success_on_redirect is set */
2265 if (f != NULL) fprintf(f, "%s %s\n", address,
2266 address_test_mode? "is deliverable" : "verified");
2268 /* If we have carried on to verify a child address, we want the value
2269 of $address_data to be that of the child */
2271 vaddr->prop.address_data = addr->prop.address_data;
2276 } /* Loop for generated addresses */
2278 /* Display the full results of the successful routing, including any generated
2279 addresses. Control gets here only when full_info is set, which requires f not
2280 to be NULL, and this occurs only when a top-level verify is called with the
2281 debugging switch on.
2283 If there are no local and no remote addresses, and there were no pipes, files,
2284 or autoreplies, and there were no errors or deferments, the message is to be
2285 discarded, usually because of the use of :blackhole: in an alias file. */
2287 if (allok && addr_local == NULL && addr_remote == NULL)
2289 fprintf(f, "mail to %s is discarded\n", address);
2293 for (addr_list = addr_local, i = 0; i < 2; addr_list = addr_remote, i++)
2296 address_item *addr = addr_list;
2297 address_item *p = addr->parent;
2298 transport_instance * tp = addr->transport;
2300 addr_list = addr->next;
2302 fprintf(f, "%s", CS addr->address);
2303 #ifdef EXPERIMENTAL_SRS
2304 if(addr->prop.srs_sender)
2305 fprintf(f, " [srs = %s]", addr->prop.srs_sender);
2308 /* If the address is a duplicate, show something about it. */
2310 if (!testflag(addr, af_pfr))
2313 if ((tnode = tree_search(tree_duplicates, addr->unique)))
2314 fprintf(f, " [duplicate, would not be delivered]");
2315 else tree_add_duplicate(addr->unique, addr);
2318 /* Now show its parents */
2320 for (p = addr->parent; p; p = p->parent)
2321 fprintf(f, "\n <-- %s", p->address);
2324 /* Show router, and transport */
2326 fprintf(f, "router = %s, transport = %s\n",
2327 addr->router->name, tp ? tp->name : US"unset");
2329 /* Show any hosts that are set up by a router unless the transport
2330 is going to override them; fiddle a bit to get a nice format. */
2332 if (addr->host_list && tp && !tp->overrides_hosts)
2337 for (h = addr->host_list; h; h = h->next)
2338 { /* get max lengths of host names, addrs */
2339 int len = Ustrlen(h->name);
2340 if (len > maxlen) maxlen = len;
2341 len = h->address ? Ustrlen(h->address) : 7;
2342 if (len > maxaddlen) maxaddlen = len;
2344 for (h = addr->host_list; h; h = h->next)
2346 fprintf(f, " host %-*s ", maxlen, h->name);
2349 fprintf(f, "[%s%-*c", h->address, maxaddlen+1 - Ustrlen(h->address), ']');
2350 else if (tp->info->local)
2351 fprintf(f, " %-*s ", maxaddlen, ""); /* Omit [unknown] for local */
2353 fprintf(f, "[%s%-*c", "unknown", maxaddlen+1 - 7, ']');
2355 if (h->mx >= 0) fprintf(f, " MX=%d", h->mx);
2356 if (h->port != PORT_NONE) fprintf(f, " port=%d", h->port);
2357 if (running_in_test_harness && h->dnssec == DS_YES) fputs(" AD", f);
2358 if (h->status == hstatus_unusable) fputs(" ** unusable **", f);
2364 /* Yield will be DEFER or FAIL if any one address has, only for full_info (which is
2365 the -bv or -bt case). */
2368 tls_modify_variables(&tls_in);
2376 /*************************************************
2377 * Check headers for syntax errors *
2378 *************************************************/
2380 /* This function checks those header lines that contain addresses, and verifies
2381 that all the addresses therein are syntactially correct.
2384 msgptr where to put an error message
2391 verify_check_headers(uschar **msgptr)
2397 for (h = header_list; h != NULL && yield == OK; h = h->next)
2399 if (h->type != htype_from &&
2400 h->type != htype_reply_to &&
2401 h->type != htype_sender &&
2402 h->type != htype_to &&
2403 h->type != htype_cc &&
2404 h->type != htype_bcc)
2407 colon = Ustrchr(h->text, ':');
2409 while (isspace(*s)) s++;
2411 /* Loop for multiple addresses in the header, enabling group syntax. Note
2412 that we have to reset this after the header has been scanned. */
2414 parse_allow_group = TRUE;
2418 uschar *ss = parse_find_address_end(s, FALSE);
2419 uschar *recipient, *errmess;
2420 int terminator = *ss;
2421 int start, end, domain;
2423 /* Temporarily terminate the string at this point, and extract the
2424 operative address within, allowing group syntax. */
2427 recipient = parse_extract_address(s,&errmess,&start,&end,&domain,FALSE);
2430 /* Permit an unqualified address only if the message is local, or if the
2431 sending host is configured to be permitted to send them. */
2433 if (recipient != NULL && domain == 0)
2435 if (h->type == htype_from || h->type == htype_sender)
2437 if (!allow_unqualified_sender) recipient = NULL;
2441 if (!allow_unqualified_recipient) recipient = NULL;
2443 if (recipient == NULL) errmess = US"unqualified address not permitted";
2446 /* It's an error if no address could be extracted, except for the special
2447 case of an empty address. */
2449 if (recipient == NULL && Ustrcmp(errmess, "empty address") != 0)
2451 uschar *verb = US"is";
2456 /* Arrange not to include any white space at the end in the
2457 error message or the header name. */
2459 while (t > s && isspace(t[-1])) t--;
2460 while (tt > h->text && isspace(tt[-1])) tt--;
2462 /* Add the address that failed to the error message, since in a
2463 header with very many addresses it is sometimes hard to spot
2464 which one is at fault. However, limit the amount of address to
2465 quote - cases have been seen where, for example, a missing double
2466 quote in a humungous To: header creates an "address" that is longer
2467 than string_sprintf can handle. */
2476 /* deconst cast ok as we're passing a non-const to string_printing() */
2477 *msgptr = US string_printing(
2478 string_sprintf("%s: failing address in \"%.*s:\" header %s: %.*s",
2479 errmess, tt - h->text, h->text, verb, len, s));
2482 break; /* Out of address loop */
2485 /* Advance to the next address */
2487 s = ss + (terminator? 1:0);
2488 while (isspace(*s)) s++;
2489 } /* Next address */
2491 parse_allow_group = FALSE;
2492 parse_found_group = FALSE;
2493 } /* Next header unless yield has been set FALSE */
2499 /*************************************************
2500 * Check header names for 8-bit characters *
2501 *************************************************/
2503 /* This function checks for invalid charcters in header names. See
2504 RFC 5322, 2.2. and RFC 6532, 3.
2507 msgptr where to put an error message
2514 verify_check_header_names_ascii(uschar **msgptr)
2519 for (h = header_list; h != NULL; h = h->next)
2521 colon = Ustrchr(h->text, ':');
2522 for(s = h->text; s < colon; s++)
2524 if ((*s < 33) || (*s > 126))
2526 *msgptr = string_sprintf("Invalid character in header \"%.*s\" found",
2527 colon - h->text, h->text);
2535 /*************************************************
2536 * Check for blind recipients *
2537 *************************************************/
2539 /* This function checks that every (envelope) recipient is mentioned in either
2540 the To: or Cc: header lines, thus detecting blind carbon copies.
2542 There are two ways of scanning that could be used: either scan the header lines
2543 and tick off the recipients, or scan the recipients and check the header lines.
2544 The original proposed patch did the former, but I have chosen to do the latter,
2545 because (a) it requires no memory and (b) will use fewer resources when there
2546 are many addresses in To: and/or Cc: and only one or two envelope recipients.
2549 Returns: OK if there are no blind recipients
2550 FAIL if there is at least one blind recipient
2554 verify_check_notblind(void)
2557 for (i = 0; i < recipients_count; i++)
2561 uschar *address = recipients_list[i].address;
2563 for (h = header_list; !found && h != NULL; h = h->next)
2567 if (h->type != htype_to && h->type != htype_cc) continue;
2569 colon = Ustrchr(h->text, ':');
2571 while (isspace(*s)) s++;
2573 /* Loop for multiple addresses in the header, enabling group syntax. Note
2574 that we have to reset this after the header has been scanned. */
2576 parse_allow_group = TRUE;
2580 uschar *ss = parse_find_address_end(s, FALSE);
2581 uschar *recipient,*errmess;
2582 int terminator = *ss;
2583 int start, end, domain;
2585 /* Temporarily terminate the string at this point, and extract the
2586 operative address within, allowing group syntax. */
2589 recipient = parse_extract_address(s,&errmess,&start,&end,&domain,FALSE);
2592 /* If we found a valid recipient that has a domain, compare it with the
2593 envelope recipient. Local parts are compared case-sensitively, domains
2594 case-insensitively. By comparing from the start with length "domain", we
2595 include the "@" at the end, which ensures that we are comparing the whole
2596 local part of each address. */
2598 if (recipient != NULL && domain != 0)
2600 found = Ustrncmp(recipient, address, domain) == 0 &&
2601 strcmpic(recipient + domain, address + domain) == 0;
2605 /* Advance to the next address */
2607 s = ss + (terminator? 1:0);
2608 while (isspace(*s)) s++;
2609 } /* Next address */
2611 parse_allow_group = FALSE;
2612 parse_found_group = FALSE;
2613 } /* Next header (if found is false) */
2615 if (!found) return FAIL;
2616 } /* Next recipient */
2623 /*************************************************
2624 * Find if verified sender *
2625 *************************************************/
2627 /* Usually, just a single address is verified as the sender of the message.
2628 However, Exim can be made to verify other addresses as well (often related in
2629 some way), and this is useful in some environments. There may therefore be a
2630 chain of such addresses that have previously been tested. This function finds
2631 whether a given address is on the chain.
2633 Arguments: the address to be verified
2634 Returns: pointer to an address item, or NULL
2638 verify_checked_sender(uschar *sender)
2641 for (addr = sender_verified_list; addr != NULL; addr = addr->next)
2642 if (Ustrcmp(sender, addr->address) == 0) break;
2650 /*************************************************
2651 * Get valid header address *
2652 *************************************************/
2654 /* Scan the originator headers of the message, looking for an address that
2655 verifies successfully. RFC 822 says:
2657 o The "Sender" field mailbox should be sent notices of
2658 any problems in transport or delivery of the original
2659 messages. If there is no "Sender" field, then the
2660 "From" field mailbox should be used.
2662 o If the "Reply-To" field exists, then the reply should
2663 go to the addresses indicated in that field and not to
2664 the address(es) indicated in the "From" field.
2666 So we check a Sender field if there is one, else a Reply_to field, else a From
2667 field. As some strange messages may have more than one of these fields,
2668 especially if they are resent- fields, check all of them if there is more than
2672 user_msgptr points to where to put a user error message
2673 log_msgptr points to where to put a log error message
2674 callout timeout for callout check (passed to verify_address())
2675 callout_overall overall callout timeout (ditto)
2676 callout_connect connect callout timeout (ditto)
2677 se_mailfrom mailfrom for verify; NULL => ""
2678 pm_mailfrom sender for pm callout check (passed to verify_address())
2679 options callout options (passed to verify_address())
2680 verrno where to put the address basic_errno
2682 If log_msgptr is set to something without setting user_msgptr, the caller
2683 normally uses log_msgptr for both things.
2685 Returns: result of the verification attempt: OK, FAIL, or DEFER;
2686 FAIL is given if no appropriate headers are found
2690 verify_check_header_address(uschar **user_msgptr, uschar **log_msgptr,
2691 int callout, int callout_overall, int callout_connect, uschar *se_mailfrom,
2692 uschar *pm_mailfrom, int options, int *verrno)
2694 static int header_types[] = { htype_sender, htype_reply_to, htype_from };
2699 for (i = 0; i < 3 && !done; i++)
2702 for (h = header_list; h != NULL && !done; h = h->next)
2704 int terminator, new_ok;
2705 uschar *s, *ss, *endname;
2707 if (h->type != header_types[i]) continue;
2708 s = endname = Ustrchr(h->text, ':') + 1;
2710 /* Scan the addresses in the header, enabling group syntax. Note that we
2711 have to reset this after the header has been scanned. */
2713 parse_allow_group = TRUE;
2717 address_item *vaddr;
2719 while (isspace(*s) || *s == ',') s++;
2720 if (*s == 0) break; /* End of header */
2722 ss = parse_find_address_end(s, FALSE);
2724 /* The terminator is a comma or end of header, but there may be white
2725 space preceding it (including newline for the last address). Move back
2726 past any white space so we can check against any cached envelope sender
2727 address verifications. */
2729 while (isspace(ss[-1])) ss--;
2733 HDEBUG(D_verify) debug_printf("verifying %.*s header address %s\n",
2734 (int)(endname - h->text), h->text, s);
2736 /* See if we have already verified this address as an envelope sender,
2737 and if so, use the previous answer. */
2739 vaddr = verify_checked_sender(s);
2741 if (vaddr != NULL && /* Previously checked */
2742 (callout <= 0 || /* No callout needed; OR */
2743 vaddr->special_action > 256)) /* Callout was done */
2745 new_ok = vaddr->special_action & 255;
2746 HDEBUG(D_verify) debug_printf("previously checked as envelope sender\n");
2747 *ss = terminator; /* Restore shortened string */
2750 /* Otherwise we run the verification now. We must restore the shortened
2751 string before running the verification, so the headers are correct, in
2752 case there is any rewriting. */
2756 int start, end, domain;
2757 uschar *address = parse_extract_address(s, log_msgptr, &start, &end,
2762 /* If we found an empty address, just carry on with the next one, but
2763 kill the message. */
2765 if (address == NULL && Ustrcmp(*log_msgptr, "empty address") == 0)
2772 /* If verification failed because of a syntax error, fail this
2773 function, and ensure that the failing address gets added to the error
2776 if (address == NULL)
2779 while (ss > s && isspace(ss[-1])) ss--;
2780 *log_msgptr = string_sprintf("syntax error in '%.*s' header when "
2781 "scanning for sender: %s in \"%.*s\"",
2782 endname - h->text, h->text, *log_msgptr, ss - s, s);
2788 /* Else go ahead with the sender verification. But it isn't *the*
2789 sender of the message, so set vopt_fake_sender to stop sender_address
2790 being replaced after rewriting or qualification. */
2794 vaddr = deliver_make_addr(address, FALSE);
2795 new_ok = verify_address(vaddr, NULL, options | vopt_fake_sender,
2796 callout, callout_overall, callout_connect, se_mailfrom,
2801 /* We now have the result, either newly found, or cached. If we are
2802 giving out error details, set a specific user error. This means that the
2803 last of these will be returned to the user if all three fail. We do not
2804 set a log message - the generic one below will be used. */
2808 *verrno = vaddr->basic_errno;
2809 if (smtp_return_error_details)
2811 *user_msgptr = string_sprintf("Rejected after DATA: "
2812 "could not verify \"%.*s\" header address\n%s: %s",
2813 endname - h->text, h->text, vaddr->address, vaddr->message);
2817 /* Success or defer */
2826 if (new_ok == DEFER) yield = DEFER;
2828 /* Move on to any more addresses in the header */
2831 } /* Next address */
2833 parse_allow_group = FALSE;
2834 parse_found_group = FALSE;
2835 } /* Next header, unless done */
2836 } /* Next header type unless done */
2838 if (yield == FAIL && *log_msgptr == NULL)
2839 *log_msgptr = US"there is no valid sender in any header line";
2841 if (yield == DEFER && *log_msgptr == NULL)
2842 *log_msgptr = US"all attempts to verify a sender in a header line deferred";
2850 /*************************************************
2851 * Get RFC 1413 identification *
2852 *************************************************/
2854 /* Attempt to get an id from the sending machine via the RFC 1413 protocol. If
2855 the timeout is set to zero, then the query is not done. There may also be lists
2856 of hosts and nets which are exempt. To guard against malefactors sending
2857 non-printing characters which could, for example, disrupt a message's headers,
2858 make sure the string consists of printing characters only.
2861 port the port to connect to; usually this is IDENT_PORT (113), but when
2862 running in the test harness with -bh a different value is used.
2866 Side effect: any received ident value is put in sender_ident (NULL otherwise)
2870 verify_get_ident(int port)
2872 int sock, host_af, qlen;
2873 int received_sender_port, received_interface_port, n;
2875 uschar buffer[2048];
2877 /* Default is no ident. Check whether we want to do an ident check for this
2880 sender_ident = NULL;
2881 if (rfc1413_query_timeout <= 0 || verify_check_host(&rfc1413_hosts) != OK)
2884 DEBUG(D_ident) debug_printf("doing ident callback\n");
2886 /* Set up a connection to the ident port of the remote host. Bind the local end
2887 to the incoming interface address. If the sender host address is an IPv6
2888 address, the incoming interface address will also be IPv6. */
2890 host_af = (Ustrchr(sender_host_address, ':') == NULL)? AF_INET : AF_INET6;
2891 sock = ip_socket(SOCK_STREAM, host_af);
2892 if (sock < 0) return;
2894 if (ip_bind(sock, host_af, interface_address, 0) < 0)
2896 DEBUG(D_ident) debug_printf("bind socket for ident failed: %s\n",
2901 if (ip_connect(sock, host_af, sender_host_address, port, rfc1413_query_timeout)
2904 if (errno == ETIMEDOUT && LOGGING(ident_timeout))
2906 log_write(0, LOG_MAIN, "ident connection to %s timed out",
2907 sender_host_address);
2911 DEBUG(D_ident) debug_printf("ident connection to %s failed: %s\n",
2912 sender_host_address, strerror(errno));
2917 /* Construct and send the query. */
2919 sprintf(CS buffer, "%d , %d\r\n", sender_host_port, interface_port);
2920 qlen = Ustrlen(buffer);
2921 if (send(sock, buffer, qlen, 0) < 0)
2923 DEBUG(D_ident) debug_printf("ident send failed: %s\n", strerror(errno));
2927 /* Read a response line. We put it into the rest of the buffer, using several
2928 recv() calls if necessary. */
2936 int size = sizeof(buffer) - (p - buffer);
2938 if (size <= 0) goto END_OFF; /* Buffer filled without seeing \n. */
2939 count = ip_recv(sock, p, size, rfc1413_query_timeout);
2940 if (count <= 0) goto END_OFF; /* Read error or EOF */
2942 /* Scan what we just read, to see if we have reached the terminating \r\n. Be
2943 generous, and accept a plain \n terminator as well. The only illegal
2946 for (pp = p; pp < p + count; pp++)
2948 if (*pp == 0) goto END_OFF; /* Zero octet not allowed */
2951 if (pp[-1] == '\r') pp--;
2953 goto GOT_DATA; /* Break out of both loops */
2957 /* Reached the end of the data without finding \n. Let the loop continue to
2958 read some more, if there is room. */
2965 /* We have received a line of data. Check it carefully. It must start with the
2966 same two port numbers that we sent, followed by data as defined by the RFC. For
2969 12345 , 25 : USERID : UNIX :root
2971 However, the amount of white space may be different to what we sent. In the
2972 "osname" field there may be several sub-fields, comma separated. The data we
2973 actually want to save follows the third colon. Some systems put leading spaces
2974 in it - we discard those. */
2976 if (sscanf(CS buffer + qlen, "%d , %d%n", &received_sender_port,
2977 &received_interface_port, &n) != 2 ||
2978 received_sender_port != sender_host_port ||
2979 received_interface_port != interface_port)
2982 p = buffer + qlen + n;
2983 while(isspace(*p)) p++;
2984 if (*p++ != ':') goto END_OFF;
2985 while(isspace(*p)) p++;
2986 if (Ustrncmp(p, "USERID", 6) != 0) goto END_OFF;
2988 while(isspace(*p)) p++;
2989 if (*p++ != ':') goto END_OFF;
2990 while (*p != 0 && *p != ':') p++;
2991 if (*p++ == 0) goto END_OFF;
2992 while(isspace(*p)) p++;
2993 if (*p == 0) goto END_OFF;
2995 /* The rest of the line is the data we want. We turn it into printing
2996 characters when we save it, so that it cannot mess up the format of any logging
2997 or Received: lines into which it gets inserted. We keep a maximum of 127
2998 characters. The deconst cast is ok as we fed a nonconst to string_printing() */
3000 sender_ident = US string_printing(string_copyn(p, 127));
3001 DEBUG(D_ident) debug_printf("sender_ident = %s\n", sender_ident);
3011 /*************************************************
3012 * Match host to a single host-list item *
3013 *************************************************/
3015 /* This function compares a host (name or address) against a single item
3016 from a host list. The host name gets looked up if it is needed and is not
3017 already known. The function is called from verify_check_this_host() via
3018 match_check_list(), which is why most of its arguments are in a single block.
3021 arg the argument block (see below)
3022 ss the host-list item
3023 valueptr where to pass back looked up data, or NULL
3024 error for error message when returning ERROR
3027 host_name (a) the host name, or
3028 (b) NULL, implying use sender_host_name and
3029 sender_host_aliases, looking them up if required, or
3030 (c) the empty string, meaning that only IP address matches
3032 host_address the host address
3033 host_ipv4 the IPv4 address taken from an IPv6 one
3037 DEFER lookup deferred
3038 ERROR (a) failed to find the host name or IP address, or
3039 (b) unknown lookup type specified, or
3040 (c) host name encountered when only IP addresses are
3045 check_host(void *arg, const uschar *ss, const uschar **valueptr, uschar **error)
3047 check_host_block *cb = (check_host_block *)arg;
3050 BOOL iplookup = FALSE;
3051 BOOL isquery = FALSE;
3052 BOOL isiponly = cb->host_name != NULL && cb->host_name[0] == 0;
3057 /* Optimize for the special case when the pattern is "*". */
3059 if (*ss == '*' && ss[1] == 0) return OK;
3061 /* If the pattern is empty, it matches only in the case when there is no host -
3062 this can occur in ACL checking for SMTP input using the -bs option. In this
3063 situation, the host address is the empty string. */
3065 if (cb->host_address[0] == 0) return (*ss == 0)? OK : FAIL;
3066 if (*ss == 0) return FAIL;
3068 /* If the pattern is precisely "@" then match against the primary host name,
3069 provided that host name matching is permitted; if it's "@[]" match against the
3070 local host's IP addresses. */
3076 if (isiponly) return ERROR;
3077 ss = primary_hostname;
3079 else if (Ustrcmp(ss, "@[]") == 0)
3081 ip_address_item *ip;
3082 for (ip = host_find_interfaces(); ip != NULL; ip = ip->next)
3083 if (Ustrcmp(ip->address, cb->host_address) == 0) return OK;
3088 /* If the pattern is an IP address, optionally followed by a bitmask count, do
3089 a (possibly masked) comparision with the current IP address. */
3091 if (string_is_ip_address(ss, &maskoffset) != 0)
3092 return (host_is_in_net(cb->host_address, ss, maskoffset)? OK : FAIL);
3094 /* The pattern is not an IP address. A common error that people make is to omit
3095 one component of an IPv4 address, either by accident, or believing that, for
3096 example, 1.2.3/24 is the same as 1.2.3.0/24, or 1.2.3 is the same as 1.2.3.0,
3097 which it isn't. (Those applications that do accept 1.2.3 as an IP address
3098 interpret it as 1.2.0.3 because the final component becomes 16-bit - this is an
3099 ancient specification.) To aid in debugging these cases, we give a specific
3100 error if the pattern contains only digits and dots or contains a slash preceded
3101 only by digits and dots (a slash at the start indicates a file name and of
3102 course slashes may be present in lookups, but not preceded only by digits and
3105 for (t = ss; isdigit(*t) || *t == '.'; t++);
3106 if (*t == 0 || (*t == '/' && t != ss))
3108 *error = US"malformed IPv4 address or address mask";
3112 /* See if there is a semicolon in the pattern */
3114 semicolon = Ustrchr(ss, ';');
3116 /* If we are doing an IP address only match, then all lookups must be IP
3117 address lookups, even if there is no "net-". */
3121 iplookup = semicolon != NULL;
3124 /* Otherwise, if the item is of the form net[n]-lookup;<file|query> then it is
3125 a lookup on a masked IP network, in textual form. We obey this code even if we
3126 have already set iplookup, so as to skip over the "net-" prefix and to set the
3127 mask length. The net- stuff really only applies to single-key lookups where the
3128 key is implicit. For query-style lookups the key is specified in the query.
3129 From release 4.30, the use of net- for query style is no longer needed, but we
3130 retain it for backward compatibility. */
3132 if (Ustrncmp(ss, "net", 3) == 0 && semicolon != NULL)
3135 for (t = ss + 3; isdigit(*t); t++) mlen = mlen * 10 + *t - '0';
3136 if (mlen == 0 && t == ss+3) mlen = -1; /* No mask supplied */
3137 iplookup = (*t++ == '-');
3141 /* Do the IP address lookup if that is indeed what we have */
3149 uschar *filename, *key, *result;
3152 /* Find the search type */
3154 search_type = search_findtype(t, semicolon - t);
3156 if (search_type < 0) log_write(0, LOG_MAIN|LOG_PANIC_DIE, "%s",
3157 search_error_message);
3159 /* Adjust parameters for the type of lookup. For a query-style lookup, there
3160 is no file name, and the "key" is just the query. For query-style with a file
3161 name, we have to fish the file off the start of the query. For a single-key
3162 lookup, the key is the current IP address, masked appropriately, and
3163 reconverted to text form, with the mask appended. For IPv6 addresses, specify
3164 dot separators instead of colons, except when the lookup type is "iplsearch".
3167 if (mac_islookup(search_type, lookup_absfilequery))
3169 filename = semicolon + 1;
3171 while (*key != 0 && !isspace(*key)) key++;
3172 filename = string_copyn(filename, key - filename);
3173 while (isspace(*key)) key++;
3175 else if (mac_islookup(search_type, lookup_querystyle))
3178 key = semicolon + 1;
3180 else /* Single-key style */
3182 int sep = (Ustrcmp(lookup_list[search_type]->name, "iplsearch") == 0)?
3184 insize = host_aton(cb->host_address, incoming);
3185 host_mask(insize, incoming, mlen);
3186 (void)host_nmtoa(insize, incoming, mlen, buffer, sep);
3188 filename = semicolon + 1;
3191 /* Now do the actual lookup; note that there is no search_close() because
3192 of the caching arrangements. */
3194 handle = search_open(filename, search_type, 0, NULL, NULL);
3195 if (handle == NULL) log_write(0, LOG_MAIN|LOG_PANIC_DIE, "%s",
3196 search_error_message);
3197 result = search_find(handle, filename, key, -1, NULL, 0, 0, NULL);
3198 if (valueptr != NULL) *valueptr = result;
3199 return (result != NULL)? OK : search_find_defer? DEFER: FAIL;
3202 /* The pattern is not an IP address or network reference of any kind. That is,
3203 it is a host name pattern. If this is an IP only match, there's an error in the
3208 *error = US"cannot match host name in match_ip list";
3212 /* Check the characters of the pattern to see if they comprise only letters,
3213 digits, full stops, and hyphens (the constituents of domain names). Allow
3214 underscores, as they are all too commonly found. Sigh. Also, if
3215 allow_utf8_domains is set, allow top-bit characters. */
3217 for (t = ss; *t != 0; t++)
3218 if (!isalnum(*t) && *t != '.' && *t != '-' && *t != '_' &&
3219 (!allow_utf8_domains || *t < 128)) break;
3221 /* If the pattern is a complete domain name, with no fancy characters, look up
3222 its IP address and match against that. Note that a multi-homed host will add
3223 items to the chain. */
3234 /* Using byname rather than bydns here means we cannot determine dnssec
3235 status. On the other hand it is unclear how that could be either
3236 propagated up or enforced. */
3238 rc = host_find_byname(&h, NULL, HOST_FIND_QUALIFY_SINGLE, NULL, FALSE);
3239 if (rc == HOST_FOUND || rc == HOST_FOUND_LOCAL)
3242 for (hh = &h; hh != NULL; hh = hh->next)
3244 if (host_is_in_net(hh->address, cb->host_address, 0)) return OK;
3248 if (rc == HOST_FIND_AGAIN) return DEFER;
3249 *error = string_sprintf("failed to find IP address for %s", ss);
3253 /* Almost all subsequent comparisons require the host name, and can be done
3254 using the general string matching function. When this function is called for
3255 outgoing hosts, the name is always given explicitly. If it is NULL, it means we
3256 must use sender_host_name and its aliases, looking them up if necessary. */
3258 if (cb->host_name != NULL) /* Explicit host name given */
3259 return match_check_string(cb->host_name, ss, -1, TRUE, TRUE, TRUE,
3262 /* Host name not given; in principle we need the sender host name and its
3263 aliases. However, for query-style lookups, we do not need the name if the
3264 query does not contain $sender_host_name. From release 4.23, a reference to
3265 $sender_host_name causes it to be looked up, so we don't need to do the lookup
3268 if ((semicolon = Ustrchr(ss, ';')) != NULL)
3270 const uschar *affix;
3271 int partial, affixlen, starflags, id;
3274 id = search_findtype_partial(ss, &partial, &affix, &affixlen, &starflags);
3277 if (id < 0) /* Unknown lookup type */
3279 log_write(0, LOG_MAIN|LOG_PANIC, "%s in host list item \"%s\"",
3280 search_error_message, ss);
3283 isquery = mac_islookup(id, lookup_querystyle|lookup_absfilequery);
3288 switch(match_check_string(US"", ss, -1, TRUE, TRUE, TRUE, valueptr))
3291 case DEFER: return DEFER;
3292 default: return FAIL;
3296 /* Not a query-style lookup; must ensure the host name is present, and then we
3297 do a check on the name and all its aliases. */
3299 if (sender_host_name == NULL)
3301 HDEBUG(D_host_lookup)
3302 debug_printf("sender host name required, to match against %s\n", ss);
3303 if (host_lookup_failed || host_name_lookup() != OK)
3305 *error = string_sprintf("failed to find host name for %s",
3306 sender_host_address);;
3309 host_build_sender_fullhost();
3312 /* Match on the sender host name, using the general matching function */
3314 switch(match_check_string(sender_host_name, ss, -1, TRUE, TRUE, TRUE,
3318 case DEFER: return DEFER;
3321 /* If there are aliases, try matching on them. */
3323 aliases = sender_host_aliases;
3324 while (*aliases != NULL)
3326 switch(match_check_string(*aliases++, ss, -1, TRUE, TRUE, TRUE, valueptr))
3329 case DEFER: return DEFER;
3338 /*************************************************
3339 * Check a specific host matches a host list *
3340 *************************************************/
3342 /* This function is passed a host list containing items in a number of
3343 different formats and the identity of a host. Its job is to determine whether
3344 the given host is in the set of hosts defined by the list. The host name is
3345 passed as a pointer so that it can be looked up if needed and not already
3346 known. This is commonly the case when called from verify_check_host() to check
3347 an incoming connection. When called from elsewhere the host name should usually
3350 This function is now just a front end to match_check_list(), which runs common
3351 code for scanning a list. We pass it the check_host() function to perform a
3355 listptr pointer to the host list
3356 cache_bits pointer to cache for named lists, or NULL
3357 host_name the host name or NULL, implying use sender_host_name and
3358 sender_host_aliases, looking them up if required
3359 host_address the IP address
3360 valueptr if not NULL, data from a lookup is passed back here
3362 Returns: OK if the host is in the defined set
3363 FAIL if the host is not in the defined set,
3364 DEFER if a data lookup deferred (not a host lookup)
3366 If the host name was needed in order to make a comparison, and could not be
3367 determined from the IP address, the result is FAIL unless the item
3368 "+allow_unknown" was met earlier in the list, in which case OK is returned. */
3371 verify_check_this_host(const uschar **listptr, unsigned int *cache_bits,
3372 const uschar *host_name, const uschar *host_address, const uschar **valueptr)
3375 unsigned int *local_cache_bits = cache_bits;
3376 const uschar *save_host_address = deliver_host_address;
3377 check_host_block cb;
3378 cb.host_name = host_name;
3379 cb.host_address = host_address;
3381 if (valueptr != NULL) *valueptr = NULL;
3383 /* If the host address starts off ::ffff: it is an IPv6 address in
3384 IPv4-compatible mode. Find the IPv4 part for checking against IPv4
3387 cb.host_ipv4 = (Ustrncmp(host_address, "::ffff:", 7) == 0)?
3388 host_address + 7 : host_address;
3390 /* During the running of the check, put the IP address into $host_address. In
3391 the case of calls from the smtp transport, it will already be there. However,
3392 in other calls (e.g. when testing ignore_target_hosts), it won't. Just to be on
3393 the safe side, any existing setting is preserved, though as I write this
3394 (November 2004) I can't see any cases where it is actually needed. */
3396 deliver_host_address = host_address;
3397 rc = match_check_list(
3398 listptr, /* the list */
3399 0, /* separator character */
3400 &hostlist_anchor, /* anchor pointer */
3401 &local_cache_bits, /* cache pointer */
3402 check_host, /* function for testing */
3403 &cb, /* argument for function */
3404 MCL_HOST, /* type of check */
3405 (host_address == sender_host_address)?
3406 US"host" : host_address, /* text for debugging */
3407 valueptr); /* where to pass back data */
3408 deliver_host_address = save_host_address;
3415 /*************************************************
3416 * Check the given host item matches a list *
3417 *************************************************/
3419 verify_check_given_host(uschar **listptr, host_item *host)
3421 return verify_check_this_host(CUSS listptr, NULL, host->name, host->address, NULL);
3424 /*************************************************
3425 * Check the remote host matches a list *
3426 *************************************************/
3428 /* This is a front end to verify_check_this_host(), created because checking
3429 the remote host is a common occurrence. With luck, a good compiler will spot
3430 the tail recursion and optimize it. If there's no host address, this is
3431 command-line SMTP input - check against an empty string for the address.
3434 listptr pointer to the host list
3436 Returns: the yield of verify_check_this_host(),
3437 i.e. OK, FAIL, or DEFER
3441 verify_check_host(uschar **listptr)
3443 return verify_check_this_host(CUSS listptr, sender_host_cache, NULL,
3444 (sender_host_address == NULL)? US"" : sender_host_address, NULL);
3451 /*************************************************
3452 * Invert an IP address *
3453 *************************************************/
3455 /* Originally just used for DNS xBL lists, now also used for the
3456 reverse_ip expansion operator.
3459 buffer where to put the answer
3460 address the address to invert
3464 invert_address(uschar *buffer, uschar *address)
3467 uschar *bptr = buffer;
3469 /* If this is an IPv4 address mapped into IPv6 format, adjust the pointer
3470 to the IPv4 part only. */
3472 if (Ustrncmp(address, "::ffff:", 7) == 0) address += 7;
3474 /* Handle IPv4 address: when HAVE_IPV6 is false, the result of host_aton() is
3477 if (host_aton(address, bin) == 1)
3481 for (i = 0; i < 4; i++)
3483 sprintf(CS bptr, "%d.", x & 255);
3484 while (*bptr) bptr++;
3489 /* Handle IPv6 address. Actually, as far as I know, there are no IPv6 addresses
3490 in any DNS black lists, and the format in which they will be looked up is
3491 unknown. This is just a guess. */
3497 for (j = 3; j >= 0; j--)
3500 for (i = 0; i < 8; i++)
3502 sprintf(CS bptr, "%x.", x & 15);
3503 while (*bptr) bptr++;
3510 /* Remove trailing period -- this is needed so that both arbitrary
3511 dnsbl keydomains and inverted addresses may be combined with the
3512 same format string, "%s.%s" */
3519 /*************************************************
3520 * Perform a single dnsbl lookup *
3521 *************************************************/
3523 /* This function is called from verify_check_dnsbl() below. It is also called
3524 recursively from within itself when domain and domain_txt are different
3525 pointers, in order to get the TXT record from the alternate domain.
3528 domain the outer dnsbl domain
3529 domain_txt alternate domain to lookup TXT record on success; when the
3530 same domain is to be used, domain_txt == domain (that is,
3531 the pointers must be identical, not just the text)
3532 keydomain the current keydomain (for debug message)
3533 prepend subdomain to lookup (like keydomain, but
3534 reversed if IP address)
3535 iplist the list of matching IP addresses, or NULL for "any"
3536 bitmask true if bitmask matching is wanted
3537 match_type condition for 'succeed' result
3538 0 => Any RR in iplist (=)
3539 1 => No RR in iplist (!=)
3540 2 => All RRs in iplist (==)
3541 3 => Some RRs not in iplist (!==)
3542 the two bits are defined as MT_NOT and MT_ALL
3543 defer_return what to return for a defer
3545 Returns: OK if lookup succeeded
3550 one_check_dnsbl(uschar *domain, uschar *domain_txt, uschar *keydomain,
3551 uschar *prepend, uschar *iplist, BOOL bitmask, int match_type,
3557 dnsbl_cache_block *cb;
3558 int old_pool = store_pool;
3559 uschar query[256]; /* DNS domain max length */
3561 /* Construct the specific query domainname */
3563 if (!string_format(query, sizeof(query), "%s.%s", prepend, domain))
3565 log_write(0, LOG_MAIN|LOG_PANIC, "dnslist query is too long "
3566 "(ignored): %s...", query);
3570 /* Look for this query in the cache. */
3572 if ( (t = tree_search(dnsbl_cache, query))
3573 && (cb = t->data.ptr)->expiry > time(NULL)
3576 /* Previous lookup was cached */
3579 HDEBUG(D_dnsbl) debug_printf("using result of previous DNS lookup\n");
3582 /* If not cached from a previous lookup, we must do a DNS lookup, and
3583 cache the result in permanent memory. */
3589 store_pool = POOL_PERM;
3593 HDEBUG(D_dnsbl) debug_printf("cached data found but past valid time; ");
3597 { /* Set up a tree entry to cache the lookup */
3598 t = store_get(sizeof(tree_node) + Ustrlen(query));
3599 Ustrcpy(t->name, query);
3600 t->data.ptr = cb = store_get(sizeof(dnsbl_cache_block));
3601 (void)tree_insertnode(&dnsbl_cache, t);
3604 /* Do the DNS loopup . */
3606 HDEBUG(D_dnsbl) debug_printf("new DNS lookup for %s\n", query);
3607 cb->rc = dns_basic_lookup(&dnsa, query, T_A);
3608 cb->text_set = FALSE;
3612 /* If the lookup succeeded, cache the RHS address. The code allows for
3613 more than one address - this was for complete generality and the possible
3614 use of A6 records. However, A6 records have been reduced to experimental
3615 status (August 2001) and may die out. So they may never get used at all,
3616 let alone in dnsbl records. However, leave the code here, just in case.
3618 Quite apart from one A6 RR generating multiple addresses, there are DNS
3619 lists that return more than one A record, so we must handle multiple
3620 addresses generated in that way as well.
3622 Mark the cache entry with the "now" plus the minimum of the address TTLs,
3623 or some suitably far-future time if none were found. */
3625 if (cb->rc == DNS_SUCCEED)
3628 dns_address **addrp = &(cb->rhs);
3629 for (rr = dns_next_rr(&dnsa, &dnss, RESET_ANSWERS);
3631 rr = dns_next_rr(&dnsa, &dnss, RESET_NEXT))
3633 if (rr->type == T_A)
3635 dns_address *da = dns_address_from_rr(&dnsa, rr);
3639 while (da->next != NULL) da = da->next;
3640 addrp = &(da->next);
3641 if (ttl > rr->ttl) ttl = rr->ttl;
3646 /* If we didn't find any A records, change the return code. This can
3647 happen when there is a CNAME record but there are no A records for what
3650 if (cb->rhs == NULL) cb->rc = DNS_NODATA;
3653 cb->expiry = time(NULL)+ttl;
3654 store_pool = old_pool;
3657 /* We now have the result of the DNS lookup, either newly done, or cached
3658 from a previous call. If the lookup succeeded, check against the address
3659 list if there is one. This may be a positive equality list (introduced by
3660 "="), a negative equality list (introduced by "!="), a positive bitmask
3661 list (introduced by "&"), or a negative bitmask list (introduced by "!&").*/
3663 if (cb->rc == DNS_SUCCEED)
3665 dns_address *da = NULL;
3666 uschar *addlist = cb->rhs->address;
3668 /* For A and AAAA records, there may be multiple addresses from multiple
3669 records. For A6 records (currently not expected to be used) there may be
3670 multiple addresses from a single record. */
3672 for (da = cb->rhs->next; da != NULL; da = da->next)
3673 addlist = string_sprintf("%s, %s", addlist, da->address);
3675 HDEBUG(D_dnsbl) debug_printf("DNS lookup for %s succeeded (yielding %s)\n",
3678 /* Address list check; this can be either for equality, or via a bitmask.
3679 In the latter case, all the bits must match. */
3683 for (da = cb->rhs; da != NULL; da = da->next)
3687 const uschar *ptr = iplist;
3690 /* Handle exact matching */
3694 while ((res = string_nextinlist(&ptr, &ipsep, ip, sizeof(ip))) != NULL)
3696 if (Ustrcmp(CS da->address, ip) == 0) break;
3700 /* Handle bitmask matching */
3707 /* At present, all known DNS blocking lists use A records, with
3708 IPv4 addresses on the RHS encoding the information they return. I
3709 wonder if this will linger on as the last vestige of IPv4 when IPv6
3710 is ubiquitous? Anyway, for now we use paranoia code to completely
3711 ignore IPv6 addresses. The default mask is 0, which always matches.
3712 We change this only for IPv4 addresses in the list. */
3714 if (host_aton(da->address, address) == 1) mask = address[0];
3716 /* Scan the returned addresses, skipping any that are IPv6 */
3718 while ((res = string_nextinlist(&ptr, &ipsep, ip, sizeof(ip))) != NULL)
3720 if (host_aton(ip, address) != 1) continue;
3721 if ((address[0] & mask) == address[0]) break;
3727 (a) An IP address in an any ('=') list matched, or
3728 (b) No IP address in an all ('==') list matched
3730 then we're done searching. */
3732 if (((match_type & MT_ALL) != 0) == (res == NULL)) break;
3735 /* If da == NULL, either
3737 (a) No IP address in an any ('=') list matched, or
3738 (b) An IP address in an all ('==') list didn't match
3740 so behave as if the DNSBL lookup had not succeeded, i.e. the host is not on
3743 if ((match_type == MT_NOT || match_type == MT_ALL) != (da == NULL))
3751 res = US"was no match";
3754 res = US"was an exclude match";
3757 res = US"was an IP address that did not match";
3760 res = US"were no IP addresses that did not match";
3763 debug_printf("=> but we are not accepting this block class because\n");
3764 debug_printf("=> there %s for %s%c%s\n",
3766 ((match_type & MT_ALL) == 0)? "" : "=",
3767 bitmask? '&' : '=', iplist);
3773 /* Either there was no IP list, or the record matched, implying that the
3774 domain is on the list. We now want to find a corresponding TXT record. If an
3775 alternate domain is specified for the TXT record, call this function
3776 recursively to look that up; this has the side effect of re-checking that
3777 there is indeed an A record at the alternate domain. */
3779 if (domain_txt != domain)
3780 return one_check_dnsbl(domain_txt, domain_txt, keydomain, prepend, NULL,
3781 FALSE, match_type, defer_return);
3783 /* If there is no alternate domain, look up a TXT record in the main domain
3784 if it has not previously been cached. */
3788 cb->text_set = TRUE;
3789 if (dns_basic_lookup(&dnsa, query, T_TXT) == DNS_SUCCEED)
3792 for (rr = dns_next_rr(&dnsa, &dnss, RESET_ANSWERS);
3794 rr = dns_next_rr(&dnsa, &dnss, RESET_NEXT))
3795 if (rr->type == T_TXT) break;
3798 int len = (rr->data)[0];
3799 if (len > 511) len = 127;
3800 store_pool = POOL_PERM;
3801 cb->text = string_sprintf("%.*s", len, (const uschar *)(rr->data+1));
3802 store_pool = old_pool;
3807 dnslist_value = addlist;
3808 dnslist_text = cb->text;
3812 /* There was a problem with the DNS lookup */
3814 if (cb->rc != DNS_NOMATCH && cb->rc != DNS_NODATA)
3816 log_write(L_dnslist_defer, LOG_MAIN,
3817 "DNS list lookup defer (probably timeout) for %s: %s", query,
3818 (defer_return == OK)? US"assumed in list" :
3819 (defer_return == FAIL)? US"assumed not in list" :
3820 US"returned DEFER");
3821 return defer_return;
3824 /* No entry was found in the DNS; continue for next domain */
3828 debug_printf("DNS lookup for %s failed\n", query);
3829 debug_printf("=> that means %s is not listed at %s\n",
3839 /*************************************************
3840 * Check host against DNS black lists *
3841 *************************************************/
3843 /* This function runs checks against a list of DNS black lists, until one
3844 matches. Each item on the list can be of the form
3846 domain=ip-address/key
3848 The domain is the right-most domain that is used for the query, for example,
3849 blackholes.mail-abuse.org. If the IP address is present, there is a match only
3850 if the DNS lookup returns a matching IP address. Several addresses may be
3851 given, comma-separated, for example: x.y.z=127.0.0.1,127.0.0.2.
3853 If no key is given, what is looked up in the domain is the inverted IP address
3854 of the current client host. If a key is given, it is used to construct the
3855 domain for the lookup. For example:
3857 dsn.rfc-ignorant.org/$sender_address_domain
3859 After finding a match in the DNS, the domain is placed in $dnslist_domain, and
3860 then we check for a TXT record for an error message, and if found, save its
3861 value in $dnslist_text. We also cache everything in a tree, to optimize
3864 The TXT record is normally looked up in the same domain as the A record, but
3865 when many lists are combined in a single DNS domain, this will not be a very
3866 specific message. It is possible to specify a different domain for looking up
3867 TXT records; this is given before the main domain, comma-separated. For
3870 dnslists = http.dnsbl.sorbs.net,dnsbl.sorbs.net=127.0.0.2 : \
3871 socks.dnsbl.sorbs.net,dnsbl.sorbs.net=127.0.0.3
3873 The caching ensures that only one lookup in dnsbl.sorbs.net is done.
3875 Note: an address for testing RBL is 192.203.178.39
3876 Note: an address for testing DUL is 192.203.178.4
3877 Note: a domain for testing RFCI is example.tld.dsn.rfc-ignorant.org
3881 listptr the domain/address/data list
3882 log_msgptr log message on error
3884 Returns: OK successful lookup (i.e. the address is on the list), or
3885 lookup deferred after +include_unknown
3886 FAIL name not found, or no data found for the given type, or
3887 lookup deferred after +exclude_unknown (default)
3888 DEFER lookup failure, if +defer_unknown was set
3892 verify_check_dnsbl(int where, const uschar ** listptr, uschar ** log_msgptr)
3895 int defer_return = FAIL;
3896 const uschar *list = *listptr;
3899 uschar buffer[1024];
3900 uschar revadd[128]; /* Long enough for IPv6 address */
3902 /* Indicate that the inverted IP address is not yet set up */
3906 /* In case this is the first time the DNS resolver is being used. */
3908 dns_init(FALSE, FALSE, FALSE); /*XXX dnssec? */
3910 /* Loop through all the domains supplied, until something matches */
3912 while ((domain = string_nextinlist(&list, &sep, buffer, sizeof(buffer))) != NULL)
3915 BOOL bitmask = FALSE;
3922 HDEBUG(D_dnsbl) debug_printf("DNS list check: %s\n", domain);
3924 /* Deal with special values that change the behaviour on defer */
3926 if (domain[0] == '+')
3928 if (strcmpic(domain, US"+include_unknown") == 0) defer_return = OK;
3929 else if (strcmpic(domain, US"+exclude_unknown") == 0) defer_return = FAIL;
3930 else if (strcmpic(domain, US"+defer_unknown") == 0) defer_return = DEFER;
3932 log_write(0, LOG_MAIN|LOG_PANIC, "unknown item in dnslist (ignored): %s",
3937 /* See if there's explicit data to be looked up */
3939 if ((key = Ustrchr(domain, '/'))) *key++ = 0;
3941 /* See if there's a list of addresses supplied after the domain name. This is
3942 introduced by an = or a & character; if preceded by = we require all matches
3943 and if preceded by ! we invert the result. */
3945 if (!(iplist = Ustrchr(domain, '=')))
3948 iplist = Ustrchr(domain, '&');
3951 if (iplist) /* Found either = or & */
3953 if (iplist > domain && iplist[-1] == '!') /* Handle preceding ! */
3955 match_type |= MT_NOT;
3959 *iplist++ = 0; /* Terminate domain, move on */
3961 /* If we found = (bitmask == FALSE), check for == or =& */
3963 if (!bitmask && (*iplist == '=' || *iplist == '&'))
3965 bitmask = *iplist++ == '&';
3966 match_type |= MT_ALL;
3971 /* If there is a comma in the domain, it indicates that a second domain for
3972 looking up TXT records is provided, before the main domain. Otherwise we must
3973 set domain_txt == domain. */
3975 domain_txt = domain;
3976 comma = Ustrchr(domain, ',');
3983 /* Check that what we have left is a sensible domain name. There is no reason
3984 why these domains should in fact use the same syntax as hosts and email
3985 domains, but in practice they seem to. However, there is little point in
3986 actually causing an error here, because that would no doubt hold up incoming
3987 mail. Instead, I'll just log it. */
3989 for (s = domain; *s != 0; s++)
3991 if (!isalnum(*s) && *s != '-' && *s != '.' && *s != '_')
3993 log_write(0, LOG_MAIN, "dnslists domain \"%s\" contains "
3994 "strange characters - is this right?", domain);
3999 /* Check the alternate domain if present */
4001 if (domain_txt != domain) for (s = domain_txt; *s != 0; s++)
4003 if (!isalnum(*s) && *s != '-' && *s != '.' && *s != '_')
4005 log_write(0, LOG_MAIN, "dnslists domain \"%s\" contains "
4006 "strange characters - is this right?", domain_txt);
4011 /* If there is no key string, construct the query by adding the domain name
4012 onto the inverted host address, and perform a single DNS lookup. */
4016 if (where == ACL_WHERE_NOTSMTP_START || where == ACL_WHERE_NOTSMTP)
4018 *log_msgptr = string_sprintf
4019 ("cannot test auto-keyed dnslists condition in %s ACL",
4020 acl_wherenames[where]);
4023 if (sender_host_address == NULL) return FAIL; /* can never match */
4024 if (revadd[0] == 0) invert_address(revadd, sender_host_address);
4025 rc = one_check_dnsbl(domain, domain_txt, sender_host_address, revadd,
4026 iplist, bitmask, match_type, defer_return);
4029 dnslist_domain = string_copy(domain_txt);
4030 dnslist_matched = string_copy(sender_host_address);
4031 HDEBUG(D_dnsbl) debug_printf("=> that means %s is listed at %s\n",
4032 sender_host_address, dnslist_domain);
4034 if (rc != FAIL) return rc; /* OK or DEFER */
4037 /* If there is a key string, it can be a list of domains or IP addresses to
4038 be concatenated with the main domain. */
4045 uschar keybuffer[256];
4046 uschar keyrevadd[128];
4048 while ((keydomain = string_nextinlist(CUSS &key, &keysep, keybuffer,
4049 sizeof(keybuffer))) != NULL)
4051 uschar *prepend = keydomain;
4053 if (string_is_ip_address(keydomain, NULL) != 0)
4055 invert_address(keyrevadd, keydomain);
4056 prepend = keyrevadd;
4059 rc = one_check_dnsbl(domain, domain_txt, keydomain, prepend, iplist,
4060 bitmask, match_type, defer_return);
4064 dnslist_domain = string_copy(domain_txt);
4065 dnslist_matched = string_copy(keydomain);
4066 HDEBUG(D_dnsbl) debug_printf("=> that means %s is listed at %s\n",
4067 keydomain, dnslist_domain);
4071 /* If the lookup deferred, remember this fact. We keep trying the rest
4072 of the list to see if we get a useful result, and if we don't, we return
4073 DEFER at the end. */
4075 if (rc == DEFER) defer = TRUE;
4076 } /* continue with next keystring domain/address */
4078 if (defer) return DEFER;
4080 } /* continue with next dnsdb outer domain */
4087 /* End of verify.c */