1 /*************************************************
2 * Exim - an Internet mail transport agent *
3 *************************************************/
5 /* Copyright (c) University of Cambridge 1995 - 2014 */
6 /* See the file NOTICE for conditions of use and distribution. */
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 address_item cutthrough_addr
;
18 static smtp_outblock ctblock
;
19 uschar ctbuffer
[8192];
22 /* Structure for caching DNSBL lookups */
24 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() */
44 /*************************************************
45 * Retrieve a callout cache record *
46 *************************************************/
48 /* If a record exists, check whether it has expired.
51 dbm_file an open hints file
53 type "address" or "domain"
54 positive_expire expire time for positive records
55 negative_expire expire time for negative records
57 Returns: the cache record if a non-expired one exists, else NULL
60 static dbdata_callout_cache
*
61 get_callout_cache_record(open_db
*dbm_file
, uschar
*key
, uschar
*type
,
62 int positive_expire
, int negative_expire
)
67 dbdata_callout_cache
*cache_record
;
69 cache_record
= dbfn_read_with_length(dbm_file
, key
, &length
);
71 if (cache_record
== NULL
)
73 HDEBUG(D_verify
) debug_printf("callout cache: no %s record found\n", type
);
77 /* We treat a record as "negative" if its result field is not positive, or if
78 it is a domain record and the postmaster field is negative. */
80 negative
= cache_record
->result
!= ccache_accept
||
81 (type
[0] == 'd' && cache_record
->postmaster_result
== ccache_reject
);
82 expire
= negative
? negative_expire
: positive_expire
;
85 if (now
- cache_record
->time_stamp
> expire
)
87 HDEBUG(D_verify
) debug_printf("callout cache: %s record expired\n", type
);
91 /* If this is a non-reject domain record, check for the obsolete format version
92 that doesn't have the postmaster and random timestamps, by looking at the
93 length. If so, copy it to a new-style block, replicating the record's
94 timestamp. Then check the additional timestamps. (There's no point wasting
95 effort if connections are rejected.) */
97 if (type
[0] == 'd' && cache_record
->result
!= ccache_reject
)
99 if (length
== sizeof(dbdata_callout_cache_obs
))
101 dbdata_callout_cache
*new = store_get(sizeof(dbdata_callout_cache
));
102 memcpy(new, cache_record
, length
);
103 new->postmaster_stamp
= new->random_stamp
= new->time_stamp
;
107 if (now
- cache_record
->postmaster_stamp
> expire
)
108 cache_record
->postmaster_result
= ccache_unknown
;
110 if (now
- cache_record
->random_stamp
> expire
)
111 cache_record
->random_result
= ccache_unknown
;
114 HDEBUG(D_verify
) debug_printf("callout cache: found %s record\n", type
);
120 /*************************************************
121 * Do callout verification for an address *
122 *************************************************/
124 /* This function is called from verify_address() when the address has routed to
125 a host list, and a callout has been requested. Callouts are expensive; that is
126 why a cache is used to improve the efficiency.
129 addr the address that's been routed
130 host_list the list of hosts to try
131 tf the transport feedback block
133 ifstring "interface" option from transport, or NULL
134 portstring "port" option from transport, or NULL
135 protocolstring "protocol" option from transport, or NULL
136 callout the per-command callout timeout
137 callout_overall the overall callout timeout (if < 0 use 4*callout)
138 callout_connect the callout connection timeout (if < 0 use callout)
139 options the verification options - these bits are used:
140 vopt_is_recipient => this is a recipient address
141 vopt_callout_no_cache => don't use callout cache
142 vopt_callout_fullpm => if postmaster check, do full one
143 vopt_callout_random => do the "random" thing
144 vopt_callout_recipsender => use real sender for recipient
145 vopt_callout_recippmaster => use postmaster for recipient
146 se_mailfrom MAIL FROM address for sender verify; NULL => ""
147 pm_mailfrom if non-NULL, do the postmaster check with this sender
149 Returns: OK/FAIL/DEFER
153 do_callout(address_item
*addr
, host_item
*host_list
, transport_feedback
*tf
,
154 int callout
, int callout_overall
, int callout_connect
, int options
,
155 uschar
*se_mailfrom
, uschar
*pm_mailfrom
)
157 BOOL is_recipient
= (options
& vopt_is_recipient
) != 0;
158 BOOL callout_no_cache
= (options
& vopt_callout_no_cache
) != 0;
159 BOOL callout_random
= (options
& vopt_callout_random
) != 0;
162 int old_domain_cache_result
= ccache_accept
;
165 uschar
*from_address
;
166 uschar
*random_local_part
= NULL
;
167 uschar
*save_deliver_domain
= deliver_domain
;
168 uschar
**failure_ptr
= is_recipient
?
169 &recipient_verify_failure
: &sender_verify_failure
;
171 open_db
*dbm_file
= NULL
;
172 dbdata_callout_cache new_domain_record
;
173 dbdata_callout_cache_address new_address_record
;
175 time_t callout_start_time
;
177 new_domain_record
.result
= ccache_unknown
;
178 new_domain_record
.postmaster_result
= ccache_unknown
;
179 new_domain_record
.random_result
= ccache_unknown
;
181 memset(&new_address_record
, 0, sizeof(new_address_record
));
183 /* For a recipient callout, the key used for the address cache record must
184 include the sender address if we are using the real sender in the callout,
185 because that may influence the result of the callout. */
187 address_key
= addr
->address
;
192 if ((options
& vopt_callout_recipsender
) != 0)
194 address_key
= string_sprintf("%s/<%s>", addr
->address
, sender_address
);
195 from_address
= sender_address
;
197 else if ((options
& vopt_callout_recippmaster
) != 0)
199 address_key
= string_sprintf("%s/<postmaster@%s>", addr
->address
,
200 qualify_domain_sender
);
201 from_address
= string_sprintf("postmaster@%s", qualify_domain_sender
);
205 /* For a sender callout, we must adjust the key if the mailfrom address is not
210 from_address
= (se_mailfrom
== NULL
)? US
"" : se_mailfrom
;
211 if (from_address
[0] != 0)
212 address_key
= string_sprintf("%s/<%s>", addr
->address
, from_address
);
215 /* Open the callout cache database, it it exists, for reading only at this
216 stage, unless caching has been disabled. */
218 if (callout_no_cache
)
220 HDEBUG(D_verify
) debug_printf("callout cache: disabled by no_cache\n");
222 else if ((dbm_file
= dbfn_open(US
"callout", O_RDWR
, &dbblock
, FALSE
)) == NULL
)
224 HDEBUG(D_verify
) debug_printf("callout cache: not available\n");
227 /* If a cache database is available see if we can avoid the need to do an
228 actual callout by making use of previously-obtained data. */
230 if (dbm_file
!= NULL
)
232 dbdata_callout_cache_address
*cache_address_record
;
233 dbdata_callout_cache
*cache_record
= get_callout_cache_record(dbm_file
,
234 addr
->domain
, US
"domain",
235 callout_cache_domain_positive_expire
,
236 callout_cache_domain_negative_expire
);
238 /* If an unexpired cache record was found for this domain, see if the callout
239 process can be short-circuited. */
241 if (cache_record
!= NULL
)
243 /* In most cases, if an early command (up to and including MAIL FROM:<>)
244 was rejected, there is no point carrying on. The callout fails. However, if
245 we are doing a recipient verification with use_sender or use_postmaster
246 set, a previous failure of MAIL FROM:<> doesn't count, because this time we
247 will be using a non-empty sender. We have to remember this situation so as
248 not to disturb the cached domain value if this whole verification succeeds
249 (we don't want it turning into "accept"). */
251 old_domain_cache_result
= cache_record
->result
;
253 if (cache_record
->result
== ccache_reject
||
254 (*from_address
== 0 && cache_record
->result
== ccache_reject_mfnull
))
256 setflag(addr
, af_verify_nsfail
);
258 debug_printf("callout cache: domain gave initial rejection, or "
259 "does not accept HELO or MAIL FROM:<>\n");
260 setflag(addr
, af_verify_nsfail
);
261 addr
->user_message
= US
"(result of an earlier callout reused).";
263 *failure_ptr
= US
"mail";
267 /* If a previous check on a "random" local part was accepted, we assume
268 that the server does not do any checking on local parts. There is therefore
269 no point in doing the callout, because it will always be successful. If a
270 random check previously failed, arrange not to do it again, but preserve
271 the data in the new record. If a random check is required but hasn't been
272 done, skip the remaining cache processing. */
274 if (callout_random
) switch(cache_record
->random_result
)
278 debug_printf("callout cache: domain accepts random addresses\n");
279 goto END_CALLOUT
; /* Default yield is OK */
283 debug_printf("callout cache: domain rejects random addresses\n");
284 callout_random
= FALSE
;
285 new_domain_record
.random_result
= ccache_reject
;
286 new_domain_record
.random_stamp
= cache_record
->random_stamp
;
291 debug_printf("callout cache: need to check random address handling "
292 "(not cached or cache expired)\n");
296 /* If a postmaster check is requested, but there was a previous failure,
297 there is again no point in carrying on. If a postmaster check is required,
298 but has not been done before, we are going to have to do a callout, so skip
299 remaining cache processing. */
301 if (pm_mailfrom
!= NULL
)
303 if (cache_record
->postmaster_result
== ccache_reject
)
305 setflag(addr
, af_verify_pmfail
);
307 debug_printf("callout cache: domain does not accept "
308 "RCPT TO:<postmaster@domain>\n");
310 *failure_ptr
= US
"postmaster";
311 setflag(addr
, af_verify_pmfail
);
312 addr
->user_message
= US
"(result of earlier verification reused).";
315 if (cache_record
->postmaster_result
== ccache_unknown
)
318 debug_printf("callout cache: need to check RCPT "
319 "TO:<postmaster@domain> (not cached or cache expired)\n");
323 /* If cache says OK, set pm_mailfrom NULL to prevent a redundant
324 postmaster check if the address itself has to be checked. Also ensure
325 that the value in the cache record is preserved (with its old timestamp).
328 HDEBUG(D_verify
) debug_printf("callout cache: domain accepts RCPT "
329 "TO:<postmaster@domain>\n");
331 new_domain_record
.postmaster_result
= ccache_accept
;
332 new_domain_record
.postmaster_stamp
= cache_record
->postmaster_stamp
;
336 /* We can't give a result based on information about the domain. See if there
337 is an unexpired cache record for this specific address (combined with the
338 sender address if we are doing a recipient callout with a non-empty sender).
341 cache_address_record
= (dbdata_callout_cache_address
*)
342 get_callout_cache_record(dbm_file
,
343 address_key
, US
"address",
344 callout_cache_positive_expire
,
345 callout_cache_negative_expire
);
347 if (cache_address_record
!= NULL
)
349 if (cache_address_record
->result
== ccache_accept
)
352 debug_printf("callout cache: address record is positive\n");
357 debug_printf("callout cache: address record is negative\n");
358 addr
->user_message
= US
"Previous (cached) callout verification failure";
359 *failure_ptr
= US
"recipient";
365 /* Close the cache database while we actually do the callout for real. */
368 dbfn_close(dbm_file
);
372 if (!addr
->transport
)
374 HDEBUG(D_verify
) debug_printf("cannot callout via null transport\n");
376 else if (Ustrcmp(addr
->transport
->driver_name
, "smtp") != 0)
377 log_write(0, LOG_MAIN
|LOG_PANIC
|LOG_CONFIG_FOR
, "callout transport '%s': %s is non-smtp",
378 addr
->transport
->name
, addr
->transport
->driver_name
);
381 smtp_transport_options_block
*ob
=
382 (smtp_transport_options_block
*)addr
->transport
->options_block
;
384 /* The information wasn't available in the cache, so we have to do a real
385 callout and save the result in the cache for next time, unless no_cache is set,
386 or unless we have a previously cached negative random result. If we are to test
387 with a random local part, ensure that such a local part is available. If not,
388 log the fact, but carry on without randomming. */
390 if (callout_random
&& callout_random_local_part
!= NULL
)
392 random_local_part
= expand_string(callout_random_local_part
);
393 if (random_local_part
== NULL
)
394 log_write(0, LOG_MAIN
|LOG_PANIC
, "failed to expand "
395 "callout_random_local_part: %s", expand_string_message
);
398 /* Default the connect and overall callout timeouts if not set, and record the
399 time we are starting so that we can enforce it. */
401 if (callout_overall
< 0) callout_overall
= 4 * callout
;
402 if (callout_connect
< 0) callout_connect
= callout
;
403 callout_start_time
= time(NULL
);
405 /* Before doing a real callout, if this is an SMTP connection, flush the SMTP
406 output because a callout might take some time. When PIPELINING is active and
407 there are many recipients, the total time for doing lots of callouts can add up
408 and cause the client to time out. So in this case we forgo the PIPELINING
411 if (smtp_out
!= NULL
&& !disable_callout_flush
) mac_smtp_fflush();
413 /* Now make connections to the hosts and do real callouts. The list of hosts
414 is passed in as an argument. */
416 for (host
= host_list
; host
!= NULL
&& !done
; host
= host
->next
)
418 smtp_inblock inblock
;
419 smtp_outblock outblock
;
422 BOOL send_quit
= TRUE
;
423 uschar
*active_hostname
= smtp_active_hostname
;
427 BOOL suppress_tls
= FALSE
;
428 uschar
*interface
= NULL
; /* Outgoing interface to use; NULL => any */
429 uschar inbuffer
[4096];
430 uschar outbuffer
[1024];
431 uschar responsebuffer
[4096];
433 clearflag(addr
, af_verify_pmfail
); /* postmaster callout flag */
434 clearflag(addr
, af_verify_nsfail
); /* null sender callout flag */
436 /* Skip this host if we don't have an IP address for it. */
438 if (host
->address
== NULL
)
440 DEBUG(D_verify
) debug_printf("no IP address for host name %s: skipping\n",
445 /* Check the overall callout timeout */
447 if (time(NULL
) - callout_start_time
>= callout_overall
)
449 HDEBUG(D_verify
) debug_printf("overall timeout for callout exceeded\n");
453 /* Set IPv4 or IPv6 */
455 host_af
= (Ustrchr(host
->address
, ':') == NULL
)? AF_INET
:AF_INET6
;
457 /* Expand and interpret the interface and port strings. The latter will not
458 be used if there is a host-specific port (e.g. from a manualroute router).
459 This has to be delayed till now, because they may expand differently for
460 different hosts. If there's a failure, log it, but carry on with the
463 deliver_host
= host
->name
;
464 deliver_host_address
= host
->address
;
465 deliver_host_port
= host
->port
;
466 deliver_domain
= addr
->domain
;
468 if (!smtp_get_interface(tf
->interface
, host_af
, addr
, NULL
, &interface
,
470 !smtp_get_port(tf
->port
, addr
, &port
, US
"callout"))
471 log_write(0, LOG_MAIN
|LOG_PANIC
, "<%s>: %s", addr
->address
,
474 /* Set HELO string according to the protocol */
475 lmtp
= Ustrcmp(tf
->protocol
, "lmtp") == 0;
476 smtps
= Ustrcmp(tf
->protocol
, "smtps") == 0;
479 HDEBUG(D_verify
) debug_printf("interface=%s port=%d\n", interface
, port
);
481 /* Set up the buffer for reading SMTP response packets. */
483 inblock
.buffer
= inbuffer
;
484 inblock
.buffersize
= sizeof(inbuffer
);
485 inblock
.ptr
= inbuffer
;
486 inblock
.ptrend
= inbuffer
;
488 /* Set up the buffer for holding SMTP commands while pipelining */
490 outblock
.buffer
= outbuffer
;
491 outblock
.buffersize
= sizeof(outbuffer
);
492 outblock
.ptr
= outbuffer
;
493 outblock
.cmd_count
= 0;
494 outblock
.authenticating
= FALSE
;
496 /* Reset the parameters of a TLS session */
497 tls_out
.cipher
= tls_out
.peerdn
= NULL
;
499 /* Connect to the host; on failure, just loop for the next one, but we
500 set the error for the last one. Use the callout_connect timeout. */
502 tls_retry_connection
:
504 inblock
.sock
= outblock
.sock
=
505 smtp_connect(host
, host_af
, port
, interface
, callout_connect
, TRUE
, NULL
506 #ifdef EXPERIMENTAL_TPDA
507 /*XXX tpda action? NULL for now. */
511 /* reconsider DSCP here */
512 if (inblock
.sock
< 0)
514 addr
->message
= string_sprintf("could not connect to %s [%s]: %s",
515 host
->name
, host
->address
, strerror(errno
));
516 deliver_host
= deliver_host_address
= NULL
;
517 deliver_domain
= save_deliver_domain
;
521 /* Expand the helo_data string to find the host name to use. */
523 if (tf
->helo_data
!= NULL
)
525 uschar
*s
= expand_string(tf
->helo_data
);
527 log_write(0, LOG_MAIN
|LOG_PANIC
, "<%s>: failed to expand transport's "
528 "helo_data value for callout: %s", addr
->address
,
529 expand_string_message
);
530 else active_hostname
= s
;
533 /* Wait for initial response, and send HELO. The smtp_write_command()
534 function leaves its command in big_buffer. This is used in error responses.
535 Initialize it in case the connection is rejected. */
537 Ustrcpy(big_buffer
, "initial connection");
539 /* Unless ssl-on-connect, wait for the initial greeting */
543 if (!smtps
|| (smtps
&& tls_out
.active
>= 0))
546 if (!(done
= smtp_read_response(&inblock
, responsebuffer
, sizeof(responsebuffer
), '2', callout
)))
547 goto RESPONSE_FAILED
;
549 #ifdef EXPERIMENTAL_TPDA
550 if (tpda_raise_event(addr
->transport
->tpda_event_action
,
551 US
"smtp:connect", responsebuffer
) == DEFER
)
553 /* Logging? Debug? */
554 goto RESPONSE_FAILED
;
559 /* Not worth checking greeting line for ESMTP support */
560 if (!(esmtp
= verify_check_this_host(&(ob
->hosts_avoid_esmtp
), NULL
,
561 host
->name
, host
->address
, NULL
) != OK
))
563 debug_printf("not sending EHLO (host matches hosts_avoid_esmtp)\n");
568 if (smtps
&& tls_out
.active
< 0) /* ssl-on-connect, first pass */
571 ob
->tls_tempfail_tryclear
= FALSE
;
573 else /* all other cases */
578 if (!(done
= smtp_write_command(&outblock
, FALSE
, "%s %s\r\n",
579 !esmtp
? "HELO" : lmtp
? "LHLO" : "EHLO", active_hostname
) >= 0))
581 if (!smtp_read_response(&inblock
, responsebuffer
, sizeof(responsebuffer
), '2', callout
))
583 if (errno
!= 0 || responsebuffer
[0] == 0 || lmtp
|| !esmtp
|| tls_out
.active
>= 0)
586 goto RESPONSE_FAILED
;
592 goto esmtp_retry
; /* fallback to HELO */
595 /* Set tls_offered if the response to EHLO specifies support for STARTTLS. */
597 if (esmtp
&& !suppress_tls
&& tls_out
.active
< 0)
599 if (regex_STARTTLS
== NULL
) regex_STARTTLS
=
600 regex_must_compile(US
"\\n250[\\s\\-]STARTTLS(\\s|\\n|$)", FALSE
, TRUE
);
602 tls_offered
= pcre_exec(regex_STARTTLS
, NULL
, CS responsebuffer
,
603 Ustrlen(responsebuffer
), 0, PCRE_EOPT
, NULL
, 0) >= 0;
610 /* If TLS is available on this connection attempt to
611 start up a TLS session, unless the host is in hosts_avoid_tls. If successful,
612 send another EHLO - the server may give a different answer in secure mode. We
613 use a separate buffer for reading the response to STARTTLS so that if it is
614 negative, the original EHLO data is available for subsequent analysis, should
615 the client not be required to use TLS. If the response is bad, copy the buffer
616 for error analysis. */
620 verify_check_this_host(&(ob
->hosts_avoid_tls
), NULL
, host
->name
,
621 host
->address
, NULL
) != OK
&&
622 verify_check_this_host(&(ob
->hosts_verify_avoid_tls
), NULL
, host
->name
,
623 host
->address
, NULL
) != OK
626 uschar buffer2
[4096];
628 && !(done
= smtp_write_command(&outblock
, FALSE
, "STARTTLS\r\n") >= 0))
631 /* If there is an I/O error, transmission of this message is deferred. If
632 there is a temporary rejection of STARRTLS and tls_tempfail_tryclear is
633 false, we also defer. However, if there is a temporary rejection of STARTTLS
634 and tls_tempfail_tryclear is true, or if there is an outright rejection of
635 STARTTLS, we carry on. This means we will try to send the message in clear,
636 unless the host is in hosts_require_tls (tested below). */
638 if (!smtps
&& !smtp_read_response(&inblock
, buffer2
, sizeof(buffer2
), '2',
639 ob
->command_timeout
))
641 if (errno
!= 0 || buffer2
[0] == 0 ||
642 (buffer2
[0] == '4' && !ob
->tls_tempfail_tryclear
))
644 Ustrncpy(responsebuffer
, buffer2
, sizeof(responsebuffer
));
646 goto RESPONSE_FAILED
;
650 /* STARTTLS accepted or ssl-on-connect: try to negotiate a TLS session. */
653 int oldtimeout
= ob
->command_timeout
;
656 ob
->command_timeout
= callout
;
657 rc
= tls_client_start(inblock
.sock
, host
, addr
, addr
->transport
);
658 ob
->command_timeout
= oldtimeout
;
660 /* TLS negotiation failed; give an error. Try in clear on a new connection,
661 if the options permit it for this host. */
665 && ob
->tls_tempfail_tryclear
667 && verify_check_this_host(&(ob
->hosts_require_tls
), NULL
,
668 host
->name
, host
->address
, NULL
) != OK
669 #ifdef EXPERIMENTAL_DANE
670 && verify_check_this_host(&(ob
->hosts_require_dane
), NULL
,
671 host
->name
, host
->address
, NULL
) != OK
675 (void)close(inblock
.sock
);
676 #ifdef EXPERIMENTAL_TPDA
677 (void) tpda_raise_event(addr
->transport
->tpda_event_action
,
678 US
"tcp:close", NULL
);
680 log_write(0, LOG_MAIN
, "TLS session failure: delivering unencrypted "
681 "to %s [%s] (not in hosts_require_tls)", host
->name
, host
->address
);
683 goto tls_retry_connection
;
685 /*save_errno = ERRNO_TLSFAILURE;*/
686 /*message = US"failure while setting up TLS session";*/
692 /* TLS session is set up. Copy info for logging. */
693 addr
->cipher
= tls_out
.cipher
;
694 addr
->peerdn
= tls_out
.peerdn
;
696 /* For SMTPS we need to wait for the initial OK response, then do HELO. */
698 goto smtps_redo_greeting
;
700 /* For STARTTLS we need to redo EHLO */
705 /* If the host is required to use a secure channel, ensure that we have one. */
706 if (tls_out
.active
< 0)
707 if ( verify_check_this_host(&(ob
->hosts_require_tls
), NULL
, host
->name
,
708 host
->address
, NULL
) == OK
709 #ifdef EXPERIMENTAL_DANE
710 || verify_check_this_host(&(ob
->hosts_require_dane
), NULL
, host
->name
,
711 host
->address
, NULL
) == OK
715 /*save_errno = ERRNO_TLSREQUIRED;*/
716 log_write(0, LOG_MAIN
, "a TLS session is required for %s [%s], but %s",
717 host
->name
, host
->address
,
718 tls_offered
? "an attempt to start TLS failed" : "the server did not offer TLS support");
723 #endif /*SUPPORT_TLS*/
725 done
= TRUE
; /* so far so good; have response to HELO */
727 /*XXX the EHLO response would be analyzed here for IGNOREQUOTA, SIZE, PIPELINING */
729 /* For now, transport_filter by cutthrough-delivery is not supported */
730 /* Need proper integration with the proper transport mechanism. */
731 if (cutthrough_delivery
)
733 if (addr
->transport
->filter_command
)
735 cutthrough_delivery
= FALSE
;
736 HDEBUG(D_acl
|D_v
) debug_printf("Cutthrough cancelled by presence of transport filter\n");
741 cutthrough_delivery
= FALSE
;
742 HDEBUG(D_acl
|D_v
) debug_printf("Cutthrough cancelled by presence of DKIM signing\n");
751 /* Clear down of the TLS, SMTP and TCP layers on error is handled below. */
753 /* Failure to accept HELO is cached; this blocks the whole domain for all
754 senders. I/O errors and defer responses are not cached. */
758 *failure_ptr
= US
"mail"; /* At or before MAIL */
759 if (errno
== 0 && responsebuffer
[0] == '5')
761 setflag(addr
, af_verify_nsfail
);
762 new_domain_record
.result
= ccache_reject
;
766 /* If we haven't authenticated, but are required to, give up. */
769 else done
= smtp_auth(responsebuffer
, sizeof(responsebuffer
),
770 addr
, host
, ob
, esmtp
, &inblock
, &outblock
) == OK
&&
772 /* Copy AUTH info for logging */
773 ( (addr
->authenticator
= client_authenticator
),
774 (addr
->auth_id
= client_authenticated_id
),
776 /* Build a mail-AUTH string (re-using responsebuffer for convenience */
777 !smtp_mail_auth_str(responsebuffer
, sizeof(responsebuffer
), addr
, ob
)
780 ( (addr
->auth_sndr
= client_authenticated_sender
),
782 /* Send the MAIL command */
783 (smtp_write_command(&outblock
, FALSE
, "MAIL FROM:<%s>%s\r\n",
784 from_address
, responsebuffer
) >= 0)
787 smtp_read_response(&inblock
, responsebuffer
, sizeof(responsebuffer
),
790 deliver_host
= deliver_host_address
= NULL
;
791 deliver_domain
= save_deliver_domain
;
793 /* If the host does not accept MAIL FROM:<>, arrange to cache this
794 information, but again, don't record anything for an I/O error or a defer. Do
795 not cache rejections of MAIL when a non-empty sender has been used, because
796 that blocks the whole domain for all senders. */
800 *failure_ptr
= US
"mail"; /* At or before MAIL */
801 if (errno
== 0 && responsebuffer
[0] == '5')
803 setflag(addr
, af_verify_nsfail
);
804 if (from_address
[0] == 0)
805 new_domain_record
.result
= ccache_reject_mfnull
;
809 /* Otherwise, proceed to check a "random" address (if required), then the
810 given address, and the postmaster address (if required). Between each check,
811 issue RSET, because some servers accept only one recipient after MAIL
814 Before doing this, set the result in the domain cache record to "accept",
815 unless its previous value was ccache_reject_mfnull. In that case, the domain
816 rejects MAIL FROM:<> and we want to continue to remember that. When that is
817 the case, we have got here only in the case of a recipient verification with
818 a non-null sender. */
822 new_domain_record
.result
=
823 (old_domain_cache_result
== ccache_reject_mfnull
)?
824 ccache_reject_mfnull
: ccache_accept
;
826 /* Do the random local part check first */
828 if (random_local_part
!= NULL
)
830 uschar randombuffer
[1024];
832 smtp_write_command(&outblock
, FALSE
,
833 "RCPT TO:<%.1000s@%.1000s>\r\n", random_local_part
,
834 addr
->domain
) >= 0 &&
835 smtp_read_response(&inblock
, randombuffer
,
836 sizeof(randombuffer
), '2', callout
);
838 /* Remember when we last did a random test */
840 new_domain_record
.random_stamp
= time(NULL
);
842 /* If accepted, we aren't going to do any further tests below. */
846 new_domain_record
.random_result
= ccache_accept
;
849 /* Otherwise, cache a real negative response, and get back to the right
850 state to send RCPT. Unless there's some problem such as a dropped
851 connection, we expect to succeed, because the commands succeeded above. */
855 if (randombuffer
[0] == '5')
856 new_domain_record
.random_result
= ccache_reject
;
859 smtp_write_command(&outblock
, FALSE
, "RSET\r\n") >= 0 &&
860 smtp_read_response(&inblock
, responsebuffer
, sizeof(responsebuffer
),
863 smtp_write_command(&outblock
, FALSE
, "MAIL FROM:<%s>\r\n",
864 from_address
) >= 0 &&
865 smtp_read_response(&inblock
, responsebuffer
, sizeof(responsebuffer
),
868 else done
= FALSE
; /* Some timeout/connection problem */
871 /* If the host is accepting all local parts, as determined by the "random"
872 check, we don't need to waste time doing any further checking. */
874 if (new_domain_record
.random_result
!= ccache_accept
&& done
)
876 /* Get the rcpt_include_affixes flag from the transport if there is one,
877 but assume FALSE if there is not. */
880 smtp_write_command(&outblock
, FALSE
, "RCPT TO:<%.1000s>\r\n",
881 transport_rcpt_address(addr
,
882 (addr
->transport
== NULL
)? FALSE
:
883 addr
->transport
->rcpt_include_affixes
)) >= 0 &&
884 smtp_read_response(&inblock
, responsebuffer
, sizeof(responsebuffer
),
888 new_address_record
.result
= ccache_accept
;
889 else if (errno
== 0 && responsebuffer
[0] == '5')
891 *failure_ptr
= US
"recipient";
892 new_address_record
.result
= ccache_reject
;
895 /* Do postmaster check if requested; if a full check is required, we
896 check for RCPT TO:<postmaster> (no domain) in accordance with RFC 821. */
898 if (done
&& pm_mailfrom
!= NULL
)
900 /*XXX not suitable for cutthrough - sequencing problems */
901 cutthrough_delivery
= FALSE
;
902 HDEBUG(D_acl
|D_v
) debug_printf("Cutthrough cancelled by presence of postmaster verify\n");
905 smtp_write_command(&outblock
, FALSE
, "RSET\r\n") >= 0 &&
906 smtp_read_response(&inblock
, responsebuffer
,
907 sizeof(responsebuffer
), '2', callout
) &&
909 smtp_write_command(&outblock
, FALSE
,
910 "MAIL FROM:<%s>\r\n", pm_mailfrom
) >= 0 &&
911 smtp_read_response(&inblock
, responsebuffer
,
912 sizeof(responsebuffer
), '2', callout
) &&
914 /* First try using the current domain */
917 smtp_write_command(&outblock
, FALSE
,
918 "RCPT TO:<postmaster@%.1000s>\r\n", addr
->domain
) >= 0 &&
919 smtp_read_response(&inblock
, responsebuffer
,
920 sizeof(responsebuffer
), '2', callout
)
925 /* If that doesn't work, and a full check is requested,
926 try without the domain. */
929 (options
& vopt_callout_fullpm
) != 0 &&
930 smtp_write_command(&outblock
, FALSE
,
931 "RCPT TO:<postmaster>\r\n") >= 0 &&
932 smtp_read_response(&inblock
, responsebuffer
,
933 sizeof(responsebuffer
), '2', callout
)
936 /* Sort out the cache record */
938 new_domain_record
.postmaster_stamp
= time(NULL
);
941 new_domain_record
.postmaster_result
= ccache_accept
;
942 else if (errno
== 0 && responsebuffer
[0] == '5')
944 *failure_ptr
= US
"postmaster";
945 setflag(addr
, af_verify_pmfail
);
946 new_domain_record
.postmaster_result
= ccache_reject
;
949 } /* Random not accepted */
950 } /* MAIL FROM: accepted */
952 /* For any failure of the main check, other than a negative response, we just
953 close the connection and carry on. We can identify a negative response by the
954 fact that errno is zero. For I/O errors it will be non-zero
956 Set up different error texts for logging and for sending back to the caller
957 as an SMTP response. Log in all cases, using a one-line format. For sender
958 callouts, give a full response to the caller, but for recipient callouts,
959 don't give the IP address because this may be an internal host whose identity
960 is not to be widely broadcast. */
964 if (errno
== ETIMEDOUT
)
966 HDEBUG(D_verify
) debug_printf("SMTP timeout\n");
971 if (*responsebuffer
== 0) Ustrcpy(responsebuffer
, US
"connection dropped");
974 string_sprintf("response to \"%s\" from %s [%s] was: %s",
975 big_buffer
, host
->name
, host
->address
,
976 string_printing(responsebuffer
));
978 addr
->user_message
= is_recipient
?
979 string_sprintf("Callout verification failed:\n%s", responsebuffer
)
981 string_sprintf("Called: %s\nSent: %s\nResponse: %s",
982 host
->address
, big_buffer
, responsebuffer
);
984 /* Hard rejection ends the process */
986 if (responsebuffer
[0] == '5') /* Address rejected */
994 /* End the SMTP conversation and close the connection. */
996 /* Cutthrough - on a successfull connect and recipient-verify with use-sender
997 and we have no cutthrough conn so far
998 here is where we want to leave the conn open */
999 if ( cutthrough_delivery
1002 && (options
& (vopt_callout_recipsender
|vopt_callout_recippmaster
)) == vopt_callout_recipsender
1003 && !random_local_part
1005 && cutthrough_fd
< 0
1008 cutthrough_fd
= outblock
.sock
; /* We assume no buffer in use in the outblock */
1009 cutthrough_addr
= *addr
; /* Save the address_item for later logging */
1010 cutthrough_addr
.next
= NULL
;
1011 cutthrough_addr
.host_used
= store_get(sizeof(host_item
));
1012 cutthrough_addr
.host_used
->name
= host
->name
;
1013 cutthrough_addr
.host_used
->address
= host
->address
;
1014 cutthrough_addr
.host_used
->port
= port
;
1016 *(cutthrough_addr
.parent
= store_get(sizeof(address_item
)))= *addr
->parent
;
1017 ctblock
.buffer
= ctbuffer
;
1018 ctblock
.buffersize
= sizeof(ctbuffer
);
1019 ctblock
.ptr
= ctbuffer
;
1020 /* ctblock.cmd_count = 0; ctblock.authenticating = FALSE; */
1021 ctblock
.sock
= cutthrough_fd
;
1025 /* Ensure no cutthrough on multiple address verifies */
1026 if (options
& vopt_callout_recipsender
)
1027 cancel_cutthrough_connection("multiple verify calls");
1028 if (send_quit
) (void)smtp_write_command(&outblock
, FALSE
, "QUIT\r\n");
1031 tls_close(FALSE
, TRUE
);
1033 (void)close(inblock
.sock
);
1034 #ifdef EXPERIMENTAL_TPDA
1035 (void) tpda_raise_event(addr
->transport
->tpda_event_action
,
1036 US
"tcp:close", NULL
);
1040 } /* Loop through all hosts, while !done */
1043 /* If we get here with done == TRUE, a successful callout happened, and yield
1044 will be set OK or FAIL according to the response to the RCPT command.
1045 Otherwise, we looped through the hosts but couldn't complete the business.
1046 However, there may be domain-specific information to cache in both cases.
1048 The value of the result field in the new_domain record is ccache_unknown if
1049 there was an error before or with MAIL FROM:, and errno was not zero,
1050 implying some kind of I/O error. We don't want to write the cache in that case.
1051 Otherwise the value is ccache_accept, ccache_reject, or ccache_reject_mfnull. */
1053 if (!callout_no_cache
&& new_domain_record
.result
!= ccache_unknown
)
1055 if ((dbm_file
= dbfn_open(US
"callout", O_RDWR
|O_CREAT
, &dbblock
, FALSE
))
1058 HDEBUG(D_verify
) debug_printf("callout cache: not available\n");
1062 (void)dbfn_write(dbm_file
, addr
->domain
, &new_domain_record
,
1063 (int)sizeof(dbdata_callout_cache
));
1064 HDEBUG(D_verify
) debug_printf("wrote callout cache domain record:\n"
1065 " result=%d postmaster=%d random=%d\n",
1066 new_domain_record
.result
,
1067 new_domain_record
.postmaster_result
,
1068 new_domain_record
.random_result
);
1072 /* If a definite result was obtained for the callout, cache it unless caching
1077 if (!callout_no_cache
&& new_address_record
.result
!= ccache_unknown
)
1079 if (dbm_file
== NULL
)
1080 dbm_file
= dbfn_open(US
"callout", O_RDWR
|O_CREAT
, &dbblock
, FALSE
);
1081 if (dbm_file
== NULL
)
1083 HDEBUG(D_verify
) debug_printf("no callout cache available\n");
1087 (void)dbfn_write(dbm_file
, address_key
, &new_address_record
,
1088 (int)sizeof(dbdata_callout_cache_address
));
1089 HDEBUG(D_verify
) debug_printf("wrote %s callout cache address record\n",
1090 (new_address_record
.result
== ccache_accept
)? "positive" : "negative");
1095 /* Failure to connect to any host, or any response other than 2xx or 5xx is a
1096 temporary error. If there was only one host, and a response was received, leave
1097 it alone if supplying details. Otherwise, give a generic response. */
1101 uschar
*dullmsg
= string_sprintf("Could not complete %s verify callout",
1102 is_recipient
? "recipient" : "sender");
1105 if (host_list
->next
!= NULL
|| addr
->message
== NULL
) addr
->message
= dullmsg
;
1107 addr
->user_message
= (!smtp_return_error_details
)? dullmsg
:
1108 string_sprintf("%s for <%s>.\n"
1109 "The mail server(s) for the domain may be temporarily unreachable, or\n"
1110 "they may be permanently unreachable from this server. In the latter case,\n%s",
1111 dullmsg
, addr
->address
,
1113 "the address will never be accepted."
1115 "you need to change the address or create an MX record for its domain\n"
1116 "if it is supposed to be generally accessible from the Internet.\n"
1117 "Talk to your mail administrator for details.");
1119 /* Force a specific error code */
1121 addr
->basic_errno
= ERRNO_CALLOUTDEFER
;
1124 /* Come here from within the cache-reading code on fast-track exit. */
1127 if (dbm_file
!= NULL
) dbfn_close(dbm_file
);
1133 /* Called after recipient-acl to get a cutthrough connection open when
1134 one was requested and a recipient-verify wasn't subsequently done.
1137 open_cutthrough_connection( address_item
* addr
)
1141 /* Use a recipient-verify-callout to set up the cutthrough connection. */
1142 /* We must use a copy of the address for verification, because it might
1146 HDEBUG(D_acl
) debug_printf("----------- start cutthrough setup ------------\n");
1147 (void) verify_address(&addr2
, NULL
,
1148 vopt_is_recipient
| vopt_callout_recipsender
| vopt_callout_no_cache
,
1149 CUTTHROUGH_CMD_TIMEOUT
, -1, -1,
1151 HDEBUG(D_acl
) debug_printf("----------- end cutthrough setup ------------\n");
1157 /* Send given number of bytes from the buffer */
1159 cutthrough_send(int n
)
1161 if(cutthrough_fd
< 0)
1166 (tls_out
.active
== cutthrough_fd
) ? tls_write(FALSE
, ctblock
.buffer
, n
) :
1168 send(cutthrough_fd
, ctblock
.buffer
, n
, 0) > 0
1171 transport_count
+= n
;
1172 ctblock
.ptr
= ctblock
.buffer
;
1176 HDEBUG(D_transport
|D_acl
) debug_printf("cutthrough_send failed: %s\n", strerror(errno
));
1183 _cutthrough_puts(uschar
* cp
, int n
)
1187 if(ctblock
.ptr
>= ctblock
.buffer
+ctblock
.buffersize
)
1188 if(!cutthrough_send(ctblock
.buffersize
))
1191 *ctblock
.ptr
++ = *cp
++;
1196 /* Buffered output of counted data block. Return boolean success */
1198 cutthrough_puts(uschar
* cp
, int n
)
1200 if (cutthrough_fd
< 0) return TRUE
;
1201 if (_cutthrough_puts(cp
, n
)) return TRUE
;
1202 cancel_cutthrough_connection("transmit failed");
1208 _cutthrough_flush_send( void )
1210 int n
= ctblock
.ptr
-ctblock
.buffer
;
1213 if(!cutthrough_send(n
))
1219 /* Send out any bufferred output. Return boolean success. */
1221 cutthrough_flush_send( void )
1223 if (_cutthrough_flush_send()) return TRUE
;
1224 cancel_cutthrough_connection("transmit failed");
1230 cutthrough_put_nl( void )
1232 return cutthrough_puts(US
"\r\n", 2);
1236 /* Get and check response from cutthrough target */
1238 cutthrough_response(char expect
, uschar
** copy
)
1240 smtp_inblock inblock
;
1241 uschar inbuffer
[4096];
1242 uschar responsebuffer
[4096];
1244 inblock
.buffer
= inbuffer
;
1245 inblock
.buffersize
= sizeof(inbuffer
);
1246 inblock
.ptr
= inbuffer
;
1247 inblock
.ptrend
= inbuffer
;
1248 inblock
.sock
= cutthrough_fd
;
1249 /* this relies on (inblock.sock == tls_out.active) */
1250 if(!smtp_read_response(&inblock
, responsebuffer
, sizeof(responsebuffer
), expect
, CUTTHROUGH_DATA_TIMEOUT
))
1251 cancel_cutthrough_connection("target timeout on read");
1256 *copy
= cp
= string_copy(responsebuffer
);
1257 /* Trim the trailing end of line */
1258 cp
+= Ustrlen(responsebuffer
);
1259 if(cp
> *copy
&& cp
[-1] == '\n') *--cp
= '\0';
1260 if(cp
> *copy
&& cp
[-1] == '\r') *--cp
= '\0';
1263 return responsebuffer
[0];
1267 /* Negotiate dataphase with the cutthrough target, returning success boolean */
1269 cutthrough_predata( void )
1271 if(cutthrough_fd
< 0)
1274 HDEBUG(D_transport
|D_acl
|D_v
) debug_printf(" SMTP>> DATA\n");
1275 cutthrough_puts(US
"DATA\r\n", 6);
1276 cutthrough_flush_send();
1278 /* Assume nothing buffered. If it was it gets ignored. */
1279 return cutthrough_response('3', NULL
) == '3';
1283 /* fd and use_crlf args only to match write_chunk() */
1285 cutthrough_write_chunk(int fd
, uschar
* s
, int len
, BOOL use_crlf
)
1288 while(s
&& (s2
= Ustrchr(s
, '\n')))
1290 if(!cutthrough_puts(s
, s2
-s
) || !cutthrough_put_nl())
1298 /* Buffered send of headers. Return success boolean. */
1299 /* Expands newlines to wire format (CR,NL). */
1300 /* Also sends header-terminating blank line. */
1302 cutthrough_headers_send( void )
1304 if(cutthrough_fd
< 0)
1307 /* We share a routine with the mainline transport to handle header add/remove/rewrites,
1308 but having a separate buffered-output function (for now)
1310 HDEBUG(D_acl
) debug_printf("----------- start cutthrough headers send -----------\n");
1312 if (!transport_headers_send(&cutthrough_addr
, cutthrough_fd
,
1313 cutthrough_addr
.transport
->add_headers
, cutthrough_addr
.transport
->remove_headers
,
1314 &cutthrough_write_chunk
, TRUE
,
1315 cutthrough_addr
.transport
->rewrite_rules
, cutthrough_addr
.transport
->rewrite_existflags
))
1318 HDEBUG(D_acl
) debug_printf("----------- done cutthrough headers send ------------\n");
1324 close_cutthrough_connection( const char * why
)
1326 if(cutthrough_fd
>= 0)
1328 /* We could be sending this after a bunch of data, but that is ok as
1329 the only way to cancel the transfer in dataphase is to drop the tcp
1330 conn before the final dot.
1332 ctblock
.ptr
= ctbuffer
;
1333 HDEBUG(D_transport
|D_acl
|D_v
) debug_printf(" SMTP>> QUIT\n");
1334 _cutthrough_puts(US
"QUIT\r\n", 6); /* avoid recursion */
1335 _cutthrough_flush_send();
1336 /* No wait for response */
1339 tls_close(FALSE
, TRUE
);
1341 (void)close(cutthrough_fd
);
1343 HDEBUG(D_acl
) debug_printf("----------- cutthrough shutdown (%s) ------------\n", why
);
1345 ctblock
.ptr
= ctbuffer
;
1349 cancel_cutthrough_connection( const char * why
)
1351 close_cutthrough_connection(why
);
1352 cutthrough_delivery
= FALSE
;
1358 /* Have senders final-dot. Send one to cutthrough target, and grab the response.
1359 Log an OK response as a transmission.
1360 Close the connection.
1361 Return smtp response-class digit.
1364 cutthrough_finaldot( void )
1366 HDEBUG(D_transport
|D_acl
|D_v
) debug_printf(" SMTP>> .\n");
1368 /* Assume data finshed with new-line */
1369 if(!cutthrough_puts(US
".", 1) || !cutthrough_put_nl() || !cutthrough_flush_send())
1370 return cutthrough_addr
.message
;
1372 switch(cutthrough_response('2', &cutthrough_addr
.message
))
1375 delivery_log(LOG_MAIN
, &cutthrough_addr
, (int)'>', NULL
);
1376 close_cutthrough_connection("delivered");
1380 delivery_log(LOG_MAIN
, &cutthrough_addr
, 0, US
"tmp-reject from cutthrough after DATA:");
1384 delivery_log(LOG_MAIN
|LOG_REJECT
, &cutthrough_addr
, 0, US
"rejected after DATA:");
1390 return cutthrough_addr
.message
;
1395 /*************************************************
1396 * Copy error to toplevel address *
1397 *************************************************/
1399 /* This function is used when a verify fails or defers, to ensure that the
1400 failure or defer information is in the original toplevel address. This applies
1401 when an address is redirected to a single new address, and the failure or
1402 deferral happens to the child address.
1405 vaddr the verify address item
1406 addr the final address item
1409 Returns: the value of YIELD
1413 copy_error(address_item
*vaddr
, address_item
*addr
, int yield
)
1417 vaddr
->message
= addr
->message
;
1418 vaddr
->user_message
= addr
->user_message
;
1419 vaddr
->basic_errno
= addr
->basic_errno
;
1420 vaddr
->more_errno
= addr
->more_errno
;
1421 vaddr
->p
.address_data
= addr
->p
.address_data
;
1422 copyflag(vaddr
, addr
, af_pass_message
);
1430 /**************************************************
1431 * printf that automatically handles TLS if needed *
1432 ***************************************************/
1434 /* This function is used by verify_address() as a substitute for all fprintf()
1435 calls; a direct fprintf() will not produce output in a TLS SMTP session, such
1436 as a response to an EXPN command. smtp_in.c makes smtp_printf available but
1437 that assumes that we always use the smtp_out FILE* when not using TLS or the
1438 ssl buffer when we are. Instead we take a FILE* parameter and check to see if
1439 that is smtp_out; if so, smtp_printf() with TLS support, otherwise regular
1443 f the candidate FILE* to write to
1444 format format string
1445 ... optional arguments
1451 static void PRINTF_FUNCTION(2,3)
1452 respond_printf(FILE *f
, const char *format
, ...)
1456 va_start(ap
, format
);
1457 if (smtp_out
&& (f
== smtp_out
))
1458 smtp_vprintf(format
, ap
);
1460 vfprintf(f
, format
, ap
);
1466 /*************************************************
1467 * Verify an email address *
1468 *************************************************/
1470 /* This function is used both for verification (-bv and at other times) and
1471 address testing (-bt), which is indicated by address_test_mode being set.
1474 vaddr contains the address to verify; the next field in this block
1476 f if not NULL, write the result to this file
1477 options various option bits:
1478 vopt_fake_sender => this sender verify is not for the real
1479 sender (it was verify=sender=xxxx or an address from a
1480 header line) - rewriting must not change sender_address
1481 vopt_is_recipient => this is a recipient address, otherwise
1482 it's a sender address - this affects qualification and
1483 rewriting and messages from callouts
1484 vopt_qualify => qualify an unqualified address; else error
1485 vopt_expn => called from SMTP EXPN command
1486 vopt_success_on_redirect => when a new address is generated
1487 the verification instantly succeeds
1489 These ones are used by do_callout() -- the options variable
1492 vopt_callout_fullpm => if postmaster check, do full one
1493 vopt_callout_no_cache => don't use callout cache
1494 vopt_callout_random => do the "random" thing
1495 vopt_callout_recipsender => use real sender for recipient
1496 vopt_callout_recippmaster => use postmaster for recipient
1498 callout if > 0, specifies that callout is required, and gives timeout
1499 for individual commands
1500 callout_overall if > 0, gives overall timeout for the callout function;
1501 if < 0, a default is used (see do_callout())
1502 callout_connect the connection timeout for callouts
1503 se_mailfrom when callout is requested to verify a sender, use this
1504 in MAIL FROM; NULL => ""
1505 pm_mailfrom when callout is requested, if non-NULL, do the postmaster
1506 thing and use this as the sender address (may be "")
1508 routed if not NULL, set TRUE if routing succeeded, so we can
1509 distinguish between routing failed and callout failed
1511 Returns: OK address verified
1512 FAIL address failed to verify
1513 DEFER can't tell at present
1517 verify_address(address_item
*vaddr
, FILE *f
, int options
, int callout
,
1518 int callout_overall
, int callout_connect
, uschar
*se_mailfrom
,
1519 uschar
*pm_mailfrom
, BOOL
*routed
)
1522 BOOL full_info
= (f
== NULL
)? FALSE
: (debug_selector
!= 0);
1523 BOOL is_recipient
= (options
& vopt_is_recipient
) != 0;
1524 BOOL expn
= (options
& vopt_expn
) != 0;
1525 BOOL success_on_redirect
= (options
& vopt_success_on_redirect
) != 0;
1528 int verify_type
= expn
? v_expn
:
1529 address_test_mode
? v_none
:
1530 is_recipient
? v_recipient
: v_sender
;
1531 address_item
*addr_list
;
1532 address_item
*addr_new
= NULL
;
1533 address_item
*addr_remote
= NULL
;
1534 address_item
*addr_local
= NULL
;
1535 address_item
*addr_succeed
= NULL
;
1536 uschar
**failure_ptr
= is_recipient
?
1537 &recipient_verify_failure
: &sender_verify_failure
;
1538 uschar
*ko_prefix
, *cr
;
1539 uschar
*address
= vaddr
->address
;
1540 uschar
*save_sender
;
1541 uschar null_sender
[] = { 0 }; /* Ensure writeable memory */
1543 /* Clear, just in case */
1545 *failure_ptr
= NULL
;
1547 /* Set up a prefix and suffix for error message which allow us to use the same
1548 output statements both in EXPN mode (where an SMTP response is needed) and when
1549 debugging with an output file. */
1553 ko_prefix
= US
"553 ";
1556 else ko_prefix
= cr
= US
"";
1558 /* Add qualify domain if permitted; otherwise an unqualified address fails. */
1560 if (parse_find_at(address
) == NULL
)
1562 if ((options
& vopt_qualify
) == 0)
1565 respond_printf(f
, "%sA domain is required for \"%s\"%s\n",
1566 ko_prefix
, address
, cr
);
1567 *failure_ptr
= US
"qualify";
1570 address
= rewrite_address_qualify(address
, is_recipient
);
1575 debug_printf(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n");
1576 debug_printf("%s %s\n", address_test_mode
? "Testing" : "Verifying", address
);
1579 /* Rewrite and report on it. Clear the domain and local part caches - these
1580 may have been set by domains and local part tests during an ACL. */
1582 if (global_rewrite_rules
!= NULL
)
1584 uschar
*old
= address
;
1585 address
= rewrite_address(address
, is_recipient
, FALSE
,
1586 global_rewrite_rules
, rewrite_existflags
);
1589 for (i
= 0; i
< (MAX_NAMED_LIST
* 2)/32; i
++) vaddr
->localpart_cache
[i
] = 0;
1590 for (i
= 0; i
< (MAX_NAMED_LIST
* 2)/32; i
++) vaddr
->domain_cache
[i
] = 0;
1591 if (f
!= NULL
&& !expn
) fprintf(f
, "Address rewritten as: %s\n", address
);
1595 /* If this is the real sender address, we must update sender_address at
1596 this point, because it may be referred to in the routers. */
1598 if ((options
& (vopt_fake_sender
|vopt_is_recipient
)) == 0)
1599 sender_address
= address
;
1601 /* If the address was rewritten to <> no verification can be done, and we have
1602 to return OK. This rewriting is permitted only for sender addresses; for other
1603 addresses, such rewriting fails. */
1605 if (address
[0] == 0) return OK
;
1607 /* Flip the legacy TLS-related variables over to the outbound set in case
1608 they're used in the context of a transport used by verification. Reset them
1609 at exit from this routine. */
1611 tls_modify_variables(&tls_out
);
1613 /* Save a copy of the sender address for re-instating if we change it to <>
1614 while verifying a sender address (a nice bit of self-reference there). */
1616 save_sender
= sender_address
;
1618 /* Update the address structure with the possibly qualified and rewritten
1619 address. Set it up as the starting address on the chain of new addresses. */
1621 vaddr
->address
= address
;
1624 /* We need a loop, because an address can generate new addresses. We must also
1625 cope with generated pipes and files at the top level. (See also the code and
1626 comment in deliver.c.) However, it is usually the case that the router for
1627 user's .forward files has its verify flag turned off.
1629 If an address generates more than one child, the loop is used only when
1630 full_info is set, and this can only be set locally. Remote enquiries just get
1631 information about the top level address, not anything that it generated. */
1633 while (addr_new
!= NULL
)
1636 address_item
*addr
= addr_new
;
1638 addr_new
= addr
->next
;
1643 debug_printf(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n");
1644 debug_printf("Considering %s\n", addr
->address
);
1647 /* Handle generated pipe, file or reply addresses. We don't get these
1648 when handling EXPN, as it does only one level of expansion. */
1650 if (testflag(addr
, af_pfr
))
1657 if (addr
->address
[0] == '>')
1659 allow
= testflag(addr
, af_allow_reply
);
1660 fprintf(f
, "%s -> mail %s", addr
->parent
->address
, addr
->address
+ 1);
1664 allow
= (addr
->address
[0] == '|')?
1665 testflag(addr
, af_allow_pipe
) : testflag(addr
, af_allow_file
);
1666 fprintf(f
, "%s -> %s", addr
->parent
->address
, addr
->address
);
1669 if (addr
->basic_errno
== ERRNO_BADTRANSPORT
)
1670 fprintf(f
, "\n*** Error in setting up pipe, file, or autoreply:\n"
1671 "%s\n", addr
->message
);
1673 fprintf(f
, "\n transport = %s\n", addr
->transport
->name
);
1675 fprintf(f
, " *** forbidden ***\n");
1680 /* Just in case some router parameter refers to it. */
1682 return_path
= (addr
->p
.errors_address
!= NULL
)?
1683 addr
->p
.errors_address
: sender_address
;
1685 /* Split the address into domain and local part, handling the %-hack if
1686 necessary, and then route it. While routing a sender address, set
1687 $sender_address to <> because that is what it will be if we were trying to
1688 send a bounce to the sender. */
1690 if (routed
!= NULL
) *routed
= FALSE
;
1691 if ((rc
= deliver_split_address(addr
)) == OK
)
1693 if (!is_recipient
) sender_address
= null_sender
;
1694 rc
= route_address(addr
, &addr_local
, &addr_remote
, &addr_new
,
1695 &addr_succeed
, verify_type
);
1696 sender_address
= save_sender
; /* Put back the real sender */
1699 /* If routing an address succeeded, set the flag that remembers, for use when
1700 an ACL cached a sender verify (in case a callout fails). Then if routing set
1701 up a list of hosts or the transport has a host list, and the callout option
1702 is set, and we aren't in a host checking run, do the callout verification,
1703 and set another flag that notes that a callout happened. */
1707 if (routed
!= NULL
) *routed
= TRUE
;
1710 host_item
*host_list
= addr
->host_list
;
1712 /* Make up some data for use in the case where there is no remote
1715 transport_feedback tf
= {
1716 NULL
, /* interface (=> any) */
1717 US
"smtp", /* port */
1718 US
"smtp", /* protocol */
1720 US
"$smtp_active_hostname", /* helo_data */
1721 FALSE
, /* hosts_override */
1722 FALSE
, /* hosts_randomize */
1723 FALSE
, /* gethostbyname */
1724 TRUE
, /* qualify_single */
1725 FALSE
/* search_parents */
1728 /* If verification yielded a remote transport, we want to use that
1729 transport's options, so as to mimic what would happen if we were really
1730 sending a message to this address. */
1732 if (addr
->transport
!= NULL
&& !addr
->transport
->info
->local
)
1734 (void)(addr
->transport
->setup
)(addr
->transport
, addr
, &tf
, 0, 0, NULL
);
1736 /* If the transport has hosts and the router does not, or if the
1737 transport is configured to override the router's hosts, we must build a
1738 host list of the transport's hosts, and find the IP addresses */
1740 if (tf
.hosts
!= NULL
&& (host_list
== NULL
|| tf
.hosts_override
))
1743 uschar
*save_deliver_domain
= deliver_domain
;
1744 uschar
*save_deliver_localpart
= deliver_localpart
;
1746 host_list
= NULL
; /* Ignore the router's hosts */
1748 deliver_domain
= addr
->domain
;
1749 deliver_localpart
= addr
->local_part
;
1750 s
= expand_string(tf
.hosts
);
1751 deliver_domain
= save_deliver_domain
;
1752 deliver_localpart
= save_deliver_localpart
;
1756 log_write(0, LOG_MAIN
|LOG_PANIC
, "failed to expand list of hosts "
1757 "\"%s\" in %s transport for callout: %s", tf
.hosts
,
1758 addr
->transport
->name
, expand_string_message
);
1763 uschar
*canonical_name
;
1764 host_item
*host
, *nexthost
;
1765 host_build_hostlist(&host_list
, s
, tf
.hosts_randomize
);
1767 /* Just ignore failures to find a host address. If we don't manage
1768 to find any addresses, the callout will defer. Note that more than
1769 one address may be found for a single host, which will result in
1770 additional host items being inserted into the chain. Hence we must
1771 save the next host first. */
1773 flags
= HOST_FIND_BY_A
;
1774 if (tf
.qualify_single
) flags
|= HOST_FIND_QUALIFY_SINGLE
;
1775 if (tf
.search_parents
) flags
|= HOST_FIND_SEARCH_PARENTS
;
1777 for (host
= host_list
; host
!= NULL
; host
= nexthost
)
1779 nexthost
= host
->next
;
1780 if (tf
.gethostbyname
||
1781 string_is_ip_address(host
->name
, NULL
) != 0)
1782 (void)host_find_byname(host
, NULL
, flags
, &canonical_name
, TRUE
);
1785 uschar
* d_request
= NULL
, * d_require
= NULL
;
1786 if (Ustrcmp(addr
->transport
->driver_name
, "smtp") == 0)
1788 smtp_transport_options_block
* ob
=
1789 (smtp_transport_options_block
*)
1790 addr
->transport
->options_block
;
1791 d_request
= ob
->dnssec_request_domains
;
1792 d_require
= ob
->dnssec_require_domains
;
1795 (void)host_find_bydns(host
, NULL
, flags
, NULL
, NULL
, NULL
,
1796 d_request
, d_require
, &canonical_name
, NULL
);
1803 /* Can only do a callout if we have at least one host! If the callout
1804 fails, it will have set ${sender,recipient}_verify_failure. */
1806 if (host_list
!= NULL
)
1808 HDEBUG(D_verify
) debug_printf("Attempting full verification using callout\n");
1809 if (host_checking
&& !host_checking_callout
)
1812 debug_printf("... callout omitted by default when host testing\n"
1813 "(Use -bhc if you want the callouts to happen.)\n");
1818 deliver_set_expansions(addr
);
1820 rc
= do_callout(addr
, host_list
, &tf
, callout
, callout_overall
,
1821 callout_connect
, options
, se_mailfrom
, pm_mailfrom
);
1826 HDEBUG(D_verify
) debug_printf("Cannot do callout: neither router nor "
1827 "transport provided a host list\n");
1832 /* Otherwise, any failure is a routing failure */
1834 else *failure_ptr
= US
"route";
1836 /* A router may return REROUTED if it has set up a child address as a result
1837 of a change of domain name (typically from widening). In this case we always
1838 want to continue to verify the new child. */
1840 if (rc
== REROUTED
) continue;
1842 /* Handle hard failures */
1849 address_item
*p
= addr
->parent
;
1851 respond_printf(f
, "%s%s %s", ko_prefix
,
1852 full_info
? addr
->address
: address
,
1853 address_test_mode
? "is undeliverable" : "failed to verify");
1854 if (!expn
&& admin_user
)
1856 if (addr
->basic_errno
> 0)
1857 respond_printf(f
, ": %s", strerror(addr
->basic_errno
));
1858 if (addr
->message
!= NULL
)
1859 respond_printf(f
, ": %s", addr
->message
);
1862 /* Show parents iff doing full info */
1864 if (full_info
) while (p
!= NULL
)
1866 respond_printf(f
, "%s\n <-- %s", cr
, p
->address
);
1869 respond_printf(f
, "%s\n", cr
);
1871 cancel_cutthrough_connection("routing hard fail");
1875 yield
= copy_error(vaddr
, addr
, FAIL
);
1883 else if (rc
== DEFER
)
1888 address_item
*p
= addr
->parent
;
1889 respond_printf(f
, "%s%s cannot be resolved at this time", ko_prefix
,
1890 full_info
? addr
->address
: address
);
1891 if (!expn
&& admin_user
)
1893 if (addr
->basic_errno
> 0)
1894 respond_printf(f
, ": %s", strerror(addr
->basic_errno
));
1895 if (addr
->message
!= NULL
)
1896 respond_printf(f
, ": %s", addr
->message
);
1897 else if (addr
->basic_errno
<= 0)
1898 respond_printf(f
, ": unknown error");
1901 /* Show parents iff doing full info */
1903 if (full_info
) while (p
!= NULL
)
1905 respond_printf(f
, "%s\n <-- %s", cr
, p
->address
);
1908 respond_printf(f
, "%s\n", cr
);
1910 cancel_cutthrough_connection("routing soft fail");
1914 yield
= copy_error(vaddr
, addr
, DEFER
);
1917 else if (yield
== OK
) yield
= DEFER
;
1920 /* If we are handling EXPN, we do not want to continue to route beyond
1921 the top level (whose address is in "address"). */
1925 uschar
*ok_prefix
= US
"250-";
1926 if (addr_new
== NULL
)
1928 if (addr_local
== NULL
&& addr_remote
== NULL
)
1929 respond_printf(f
, "250 mail to <%s> is discarded\r\n", address
);
1931 respond_printf(f
, "250 <%s>\r\n", address
);
1933 else while (addr_new
!= NULL
)
1935 address_item
*addr2
= addr_new
;
1936 addr_new
= addr2
->next
;
1937 if (addr_new
== NULL
) ok_prefix
= US
"250 ";
1938 respond_printf(f
, "%s<%s>\r\n", ok_prefix
, addr2
->address
);
1944 /* Successful routing other than EXPN. */
1948 /* Handle successful routing when short info wanted. Otherwise continue for
1949 other (generated) addresses. Short info is the operational case. Full info
1950 can be requested only when debug_selector != 0 and a file is supplied.
1952 There is a conflict between the use of aliasing as an alternate email
1953 address, and as a sort of mailing list. If an alias turns the incoming
1954 address into just one address (e.g. J.Caesar->jc44) you may well want to
1955 carry on verifying the generated address to ensure it is valid when
1956 checking incoming mail. If aliasing generates multiple addresses, you
1957 probably don't want to do this. Exim therefore treats the generation of
1958 just a single new address as a special case, and continues on to verify the
1959 generated address. */
1961 if (!full_info
&& /* Stop if short info wanted AND */
1962 (((addr_new
== NULL
|| /* No new address OR */
1963 addr_new
->next
!= NULL
|| /* More than one new address OR */
1964 testflag(addr_new
, af_pfr
))) /* New address is pfr */
1966 (addr_new
!= NULL
&& /* At least one new address AND */
1967 success_on_redirect
))) /* success_on_redirect is set */
1969 if (f
!= NULL
) fprintf(f
, "%s %s\n", address
,
1970 address_test_mode
? "is deliverable" : "verified");
1972 /* If we have carried on to verify a child address, we want the value
1973 of $address_data to be that of the child */
1975 vaddr
->p
.address_data
= addr
->p
.address_data
;
1980 } /* Loop for generated addresses */
1982 /* Display the full results of the successful routing, including any generated
1983 addresses. Control gets here only when full_info is set, which requires f not
1984 to be NULL, and this occurs only when a top-level verify is called with the
1985 debugging switch on.
1987 If there are no local and no remote addresses, and there were no pipes, files,
1988 or autoreplies, and there were no errors or deferments, the message is to be
1989 discarded, usually because of the use of :blackhole: in an alias file. */
1991 if (allok
&& addr_local
== NULL
&& addr_remote
== NULL
)
1993 fprintf(f
, "mail to %s is discarded\n", address
);
1997 for (addr_list
= addr_local
, i
= 0; i
< 2; addr_list
= addr_remote
, i
++)
1999 while (addr_list
!= NULL
)
2001 address_item
*addr
= addr_list
;
2002 address_item
*p
= addr
->parent
;
2003 addr_list
= addr
->next
;
2005 fprintf(f
, "%s", CS addr
->address
);
2006 #ifdef EXPERIMENTAL_SRS
2007 if(addr
->p
.srs_sender
)
2008 fprintf(f
, " [srs = %s]", addr
->p
.srs_sender
);
2011 /* If the address is a duplicate, show something about it. */
2013 if (!testflag(addr
, af_pfr
))
2016 if ((tnode
= tree_search(tree_duplicates
, addr
->unique
)) != NULL
)
2017 fprintf(f
, " [duplicate, would not be delivered]");
2018 else tree_add_duplicate(addr
->unique
, addr
);
2021 /* Now show its parents */
2025 fprintf(f
, "\n <-- %s", p
->address
);
2030 /* Show router, and transport */
2032 fprintf(f
, "router = %s, ", addr
->router
->name
);
2033 fprintf(f
, "transport = %s\n", (addr
->transport
== NULL
)? US
"unset" :
2034 addr
->transport
->name
);
2036 /* Show any hosts that are set up by a router unless the transport
2037 is going to override them; fiddle a bit to get a nice format. */
2039 if (addr
->host_list
!= NULL
&& addr
->transport
!= NULL
&&
2040 !addr
->transport
->overrides_hosts
)
2045 for (h
= addr
->host_list
; h
!= NULL
; h
= h
->next
)
2047 int len
= Ustrlen(h
->name
);
2048 if (len
> maxlen
) maxlen
= len
;
2049 len
= (h
->address
!= NULL
)? Ustrlen(h
->address
) : 7;
2050 if (len
> maxaddlen
) maxaddlen
= len
;
2052 for (h
= addr
->host_list
; h
!= NULL
; h
= h
->next
)
2054 int len
= Ustrlen(h
->name
);
2055 fprintf(f
, " host %s ", h
->name
);
2056 while (len
++ < maxlen
) fprintf(f
, " ");
2057 if (h
->address
!= NULL
)
2059 fprintf(f
, "[%s] ", h
->address
);
2060 len
= Ustrlen(h
->address
);
2062 else if (!addr
->transport
->info
->local
) /* Omit [unknown] for local */
2064 fprintf(f
, "[unknown] ");
2068 while (len
++ < maxaddlen
) fprintf(f
," ");
2069 if (h
->mx
>= 0) fprintf(f
, "MX=%d", h
->mx
);
2070 if (h
->port
!= PORT_NONE
) fprintf(f
, " port=%d", h
->port
);
2071 if (h
->status
== hstatus_unusable
) fprintf(f
, " ** unusable **");
2078 /* Yield will be DEFER or FAIL if any one address has, only for full_info (which is
2079 the -bv or -bt case). */
2082 tls_modify_variables(&tls_in
);
2090 /*************************************************
2091 * Check headers for syntax errors *
2092 *************************************************/
2094 /* This function checks those header lines that contain addresses, and verifies
2095 that all the addresses therein are syntactially correct.
2098 msgptr where to put an error message
2105 verify_check_headers(uschar
**msgptr
)
2111 for (h
= header_list
; h
!= NULL
&& yield
== OK
; h
= h
->next
)
2113 if (h
->type
!= htype_from
&&
2114 h
->type
!= htype_reply_to
&&
2115 h
->type
!= htype_sender
&&
2116 h
->type
!= htype_to
&&
2117 h
->type
!= htype_cc
&&
2118 h
->type
!= htype_bcc
)
2121 colon
= Ustrchr(h
->text
, ':');
2123 while (isspace(*s
)) s
++;
2125 /* Loop for multiple addresses in the header, enabling group syntax. Note
2126 that we have to reset this after the header has been scanned. */
2128 parse_allow_group
= TRUE
;
2132 uschar
*ss
= parse_find_address_end(s
, FALSE
);
2133 uschar
*recipient
, *errmess
;
2134 int terminator
= *ss
;
2135 int start
, end
, domain
;
2137 /* Temporarily terminate the string at this point, and extract the
2138 operative address within, allowing group syntax. */
2141 recipient
= parse_extract_address(s
,&errmess
,&start
,&end
,&domain
,FALSE
);
2144 /* Permit an unqualified address only if the message is local, or if the
2145 sending host is configured to be permitted to send them. */
2147 if (recipient
!= NULL
&& domain
== 0)
2149 if (h
->type
== htype_from
|| h
->type
== htype_sender
)
2151 if (!allow_unqualified_sender
) recipient
= NULL
;
2155 if (!allow_unqualified_recipient
) recipient
= NULL
;
2157 if (recipient
== NULL
) errmess
= US
"unqualified address not permitted";
2160 /* It's an error if no address could be extracted, except for the special
2161 case of an empty address. */
2163 if (recipient
== NULL
&& Ustrcmp(errmess
, "empty address") != 0)
2165 uschar
*verb
= US
"is";
2170 /* Arrange not to include any white space at the end in the
2171 error message or the header name. */
2173 while (t
> s
&& isspace(t
[-1])) t
--;
2174 while (tt
> h
->text
&& isspace(tt
[-1])) tt
--;
2176 /* Add the address that failed to the error message, since in a
2177 header with very many addresses it is sometimes hard to spot
2178 which one is at fault. However, limit the amount of address to
2179 quote - cases have been seen where, for example, a missing double
2180 quote in a humungous To: header creates an "address" that is longer
2181 than string_sprintf can handle. */
2190 *msgptr
= string_printing(
2191 string_sprintf("%s: failing address in \"%.*s:\" header %s: %.*s",
2192 errmess
, tt
- h
->text
, h
->text
, verb
, len
, s
));
2195 break; /* Out of address loop */
2198 /* Advance to the next address */
2200 s
= ss
+ (terminator
? 1:0);
2201 while (isspace(*s
)) s
++;
2202 } /* Next address */
2204 parse_allow_group
= FALSE
;
2205 parse_found_group
= FALSE
;
2206 } /* Next header unless yield has been set FALSE */
2212 /*************************************************
2213 * Check header names for 8-bit characters *
2214 *************************************************/
2216 /* This function checks for invalid charcters in header names. See
2217 RFC 5322, 2.2. and RFC 6532, 3.
2220 msgptr where to put an error message
2227 verify_check_header_names_ascii(uschar
**msgptr
)
2232 for (h
= header_list
; h
!= NULL
; h
= h
->next
)
2234 colon
= Ustrchr(h
->text
, ':');
2235 for(s
= h
->text
; s
< colon
; s
++)
2237 if ((*s
< 33) || (*s
> 126))
2239 *msgptr
= string_sprintf("Invalid character in header \"%.*s\" found",
2240 colon
- h
->text
, h
->text
);
2248 /*************************************************
2249 * Check for blind recipients *
2250 *************************************************/
2252 /* This function checks that every (envelope) recipient is mentioned in either
2253 the To: or Cc: header lines, thus detecting blind carbon copies.
2255 There are two ways of scanning that could be used: either scan the header lines
2256 and tick off the recipients, or scan the recipients and check the header lines.
2257 The original proposed patch did the former, but I have chosen to do the latter,
2258 because (a) it requires no memory and (b) will use fewer resources when there
2259 are many addresses in To: and/or Cc: and only one or two envelope recipients.
2262 Returns: OK if there are no blind recipients
2263 FAIL if there is at least one blind recipient
2267 verify_check_notblind(void)
2270 for (i
= 0; i
< recipients_count
; i
++)
2274 uschar
*address
= recipients_list
[i
].address
;
2276 for (h
= header_list
; !found
&& h
!= NULL
; h
= h
->next
)
2280 if (h
->type
!= htype_to
&& h
->type
!= htype_cc
) continue;
2282 colon
= Ustrchr(h
->text
, ':');
2284 while (isspace(*s
)) s
++;
2286 /* Loop for multiple addresses in the header, enabling group syntax. Note
2287 that we have to reset this after the header has been scanned. */
2289 parse_allow_group
= TRUE
;
2293 uschar
*ss
= parse_find_address_end(s
, FALSE
);
2294 uschar
*recipient
,*errmess
;
2295 int terminator
= *ss
;
2296 int start
, end
, domain
;
2298 /* Temporarily terminate the string at this point, and extract the
2299 operative address within, allowing group syntax. */
2302 recipient
= parse_extract_address(s
,&errmess
,&start
,&end
,&domain
,FALSE
);
2305 /* If we found a valid recipient that has a domain, compare it with the
2306 envelope recipient. Local parts are compared case-sensitively, domains
2307 case-insensitively. By comparing from the start with length "domain", we
2308 include the "@" at the end, which ensures that we are comparing the whole
2309 local part of each address. */
2311 if (recipient
!= NULL
&& domain
!= 0)
2313 found
= Ustrncmp(recipient
, address
, domain
) == 0 &&
2314 strcmpic(recipient
+ domain
, address
+ domain
) == 0;
2318 /* Advance to the next address */
2320 s
= ss
+ (terminator
? 1:0);
2321 while (isspace(*s
)) s
++;
2322 } /* Next address */
2324 parse_allow_group
= FALSE
;
2325 parse_found_group
= FALSE
;
2326 } /* Next header (if found is false) */
2328 if (!found
) return FAIL
;
2329 } /* Next recipient */
2336 /*************************************************
2337 * Find if verified sender *
2338 *************************************************/
2340 /* Usually, just a single address is verified as the sender of the message.
2341 However, Exim can be made to verify other addresses as well (often related in
2342 some way), and this is useful in some environments. There may therefore be a
2343 chain of such addresses that have previously been tested. This function finds
2344 whether a given address is on the chain.
2346 Arguments: the address to be verified
2347 Returns: pointer to an address item, or NULL
2351 verify_checked_sender(uschar
*sender
)
2354 for (addr
= sender_verified_list
; addr
!= NULL
; addr
= addr
->next
)
2355 if (Ustrcmp(sender
, addr
->address
) == 0) break;
2363 /*************************************************
2364 * Get valid header address *
2365 *************************************************/
2367 /* Scan the originator headers of the message, looking for an address that
2368 verifies successfully. RFC 822 says:
2370 o The "Sender" field mailbox should be sent notices of
2371 any problems in transport or delivery of the original
2372 messages. If there is no "Sender" field, then the
2373 "From" field mailbox should be used.
2375 o If the "Reply-To" field exists, then the reply should
2376 go to the addresses indicated in that field and not to
2377 the address(es) indicated in the "From" field.
2379 So we check a Sender field if there is one, else a Reply_to field, else a From
2380 field. As some strange messages may have more than one of these fields,
2381 especially if they are resent- fields, check all of them if there is more than
2385 user_msgptr points to where to put a user error message
2386 log_msgptr points to where to put a log error message
2387 callout timeout for callout check (passed to verify_address())
2388 callout_overall overall callout timeout (ditto)
2389 callout_connect connect callout timeout (ditto)
2390 se_mailfrom mailfrom for verify; NULL => ""
2391 pm_mailfrom sender for pm callout check (passed to verify_address())
2392 options callout options (passed to verify_address())
2393 verrno where to put the address basic_errno
2395 If log_msgptr is set to something without setting user_msgptr, the caller
2396 normally uses log_msgptr for both things.
2398 Returns: result of the verification attempt: OK, FAIL, or DEFER;
2399 FAIL is given if no appropriate headers are found
2403 verify_check_header_address(uschar
**user_msgptr
, uschar
**log_msgptr
,
2404 int callout
, int callout_overall
, int callout_connect
, uschar
*se_mailfrom
,
2405 uschar
*pm_mailfrom
, int options
, int *verrno
)
2407 static int header_types
[] = { htype_sender
, htype_reply_to
, htype_from
};
2412 for (i
= 0; i
< 3 && !done
; i
++)
2415 for (h
= header_list
; h
!= NULL
&& !done
; h
= h
->next
)
2417 int terminator
, new_ok
;
2418 uschar
*s
, *ss
, *endname
;
2420 if (h
->type
!= header_types
[i
]) continue;
2421 s
= endname
= Ustrchr(h
->text
, ':') + 1;
2423 /* Scan the addresses in the header, enabling group syntax. Note that we
2424 have to reset this after the header has been scanned. */
2426 parse_allow_group
= TRUE
;
2430 address_item
*vaddr
;
2432 while (isspace(*s
) || *s
== ',') s
++;
2433 if (*s
== 0) break; /* End of header */
2435 ss
= parse_find_address_end(s
, FALSE
);
2437 /* The terminator is a comma or end of header, but there may be white
2438 space preceding it (including newline for the last address). Move back
2439 past any white space so we can check against any cached envelope sender
2440 address verifications. */
2442 while (isspace(ss
[-1])) ss
--;
2446 HDEBUG(D_verify
) debug_printf("verifying %.*s header address %s\n",
2447 (int)(endname
- h
->text
), h
->text
, s
);
2449 /* See if we have already verified this address as an envelope sender,
2450 and if so, use the previous answer. */
2452 vaddr
= verify_checked_sender(s
);
2454 if (vaddr
!= NULL
&& /* Previously checked */
2455 (callout
<= 0 || /* No callout needed; OR */
2456 vaddr
->special_action
> 256)) /* Callout was done */
2458 new_ok
= vaddr
->special_action
& 255;
2459 HDEBUG(D_verify
) debug_printf("previously checked as envelope sender\n");
2460 *ss
= terminator
; /* Restore shortened string */
2463 /* Otherwise we run the verification now. We must restore the shortened
2464 string before running the verification, so the headers are correct, in
2465 case there is any rewriting. */
2469 int start
, end
, domain
;
2470 uschar
*address
= parse_extract_address(s
, log_msgptr
, &start
, &end
,
2475 /* If we found an empty address, just carry on with the next one, but
2476 kill the message. */
2478 if (address
== NULL
&& Ustrcmp(*log_msgptr
, "empty address") == 0)
2485 /* If verification failed because of a syntax error, fail this
2486 function, and ensure that the failing address gets added to the error
2489 if (address
== NULL
)
2492 while (ss
> s
&& isspace(ss
[-1])) ss
--;
2493 *log_msgptr
= string_sprintf("syntax error in '%.*s' header when "
2494 "scanning for sender: %s in \"%.*s\"",
2495 endname
- h
->text
, h
->text
, *log_msgptr
, ss
- s
, s
);
2501 /* Else go ahead with the sender verification. But it isn't *the*
2502 sender of the message, so set vopt_fake_sender to stop sender_address
2503 being replaced after rewriting or qualification. */
2507 vaddr
= deliver_make_addr(address
, FALSE
);
2508 new_ok
= verify_address(vaddr
, NULL
, options
| vopt_fake_sender
,
2509 callout
, callout_overall
, callout_connect
, se_mailfrom
,
2514 /* We now have the result, either newly found, or cached. If we are
2515 giving out error details, set a specific user error. This means that the
2516 last of these will be returned to the user if all three fail. We do not
2517 set a log message - the generic one below will be used. */
2521 *verrno
= vaddr
->basic_errno
;
2522 if (smtp_return_error_details
)
2524 *user_msgptr
= string_sprintf("Rejected after DATA: "
2525 "could not verify \"%.*s\" header address\n%s: %s",
2526 endname
- h
->text
, h
->text
, vaddr
->address
, vaddr
->message
);
2530 /* Success or defer */
2539 if (new_ok
== DEFER
) yield
= DEFER
;
2541 /* Move on to any more addresses in the header */
2544 } /* Next address */
2546 parse_allow_group
= FALSE
;
2547 parse_found_group
= FALSE
;
2548 } /* Next header, unless done */
2549 } /* Next header type unless done */
2551 if (yield
== FAIL
&& *log_msgptr
== NULL
)
2552 *log_msgptr
= US
"there is no valid sender in any header line";
2554 if (yield
== DEFER
&& *log_msgptr
== NULL
)
2555 *log_msgptr
= US
"all attempts to verify a sender in a header line deferred";
2563 /*************************************************
2564 * Get RFC 1413 identification *
2565 *************************************************/
2567 /* Attempt to get an id from the sending machine via the RFC 1413 protocol. If
2568 the timeout is set to zero, then the query is not done. There may also be lists
2569 of hosts and nets which are exempt. To guard against malefactors sending
2570 non-printing characters which could, for example, disrupt a message's headers,
2571 make sure the string consists of printing characters only.
2574 port the port to connect to; usually this is IDENT_PORT (113), but when
2575 running in the test harness with -bh a different value is used.
2579 Side effect: any received ident value is put in sender_ident (NULL otherwise)
2583 verify_get_ident(int port
)
2585 int sock
, host_af
, qlen
;
2586 int received_sender_port
, received_interface_port
, n
;
2588 uschar buffer
[2048];
2590 /* Default is no ident. Check whether we want to do an ident check for this
2593 sender_ident
= NULL
;
2594 if (rfc1413_query_timeout
<= 0 || verify_check_host(&rfc1413_hosts
) != OK
)
2597 DEBUG(D_ident
) debug_printf("doing ident callback\n");
2599 /* Set up a connection to the ident port of the remote host. Bind the local end
2600 to the incoming interface address. If the sender host address is an IPv6
2601 address, the incoming interface address will also be IPv6. */
2603 host_af
= (Ustrchr(sender_host_address
, ':') == NULL
)? AF_INET
: AF_INET6
;
2604 sock
= ip_socket(SOCK_STREAM
, host_af
);
2605 if (sock
< 0) return;
2607 if (ip_bind(sock
, host_af
, interface_address
, 0) < 0)
2609 DEBUG(D_ident
) debug_printf("bind socket for ident failed: %s\n",
2614 if (ip_connect(sock
, host_af
, sender_host_address
, port
, rfc1413_query_timeout
)
2617 if (errno
== ETIMEDOUT
&& (log_extra_selector
& LX_ident_timeout
) != 0)
2619 log_write(0, LOG_MAIN
, "ident connection to %s timed out",
2620 sender_host_address
);
2624 DEBUG(D_ident
) debug_printf("ident connection to %s failed: %s\n",
2625 sender_host_address
, strerror(errno
));
2630 /* Construct and send the query. */
2632 sprintf(CS buffer
, "%d , %d\r\n", sender_host_port
, interface_port
);
2633 qlen
= Ustrlen(buffer
);
2634 if (send(sock
, buffer
, qlen
, 0) < 0)
2636 DEBUG(D_ident
) debug_printf("ident send failed: %s\n", strerror(errno
));
2640 /* Read a response line. We put it into the rest of the buffer, using several
2641 recv() calls if necessary. */
2649 int size
= sizeof(buffer
) - (p
- buffer
);
2651 if (size
<= 0) goto END_OFF
; /* Buffer filled without seeing \n. */
2652 count
= ip_recv(sock
, p
, size
, rfc1413_query_timeout
);
2653 if (count
<= 0) goto END_OFF
; /* Read error or EOF */
2655 /* Scan what we just read, to see if we have reached the terminating \r\n. Be
2656 generous, and accept a plain \n terminator as well. The only illegal
2659 for (pp
= p
; pp
< p
+ count
; pp
++)
2661 if (*pp
== 0) goto END_OFF
; /* Zero octet not allowed */
2664 if (pp
[-1] == '\r') pp
--;
2666 goto GOT_DATA
; /* Break out of both loops */
2670 /* Reached the end of the data without finding \n. Let the loop continue to
2671 read some more, if there is room. */
2678 /* We have received a line of data. Check it carefully. It must start with the
2679 same two port numbers that we sent, followed by data as defined by the RFC. For
2682 12345 , 25 : USERID : UNIX :root
2684 However, the amount of white space may be different to what we sent. In the
2685 "osname" field there may be several sub-fields, comma separated. The data we
2686 actually want to save follows the third colon. Some systems put leading spaces
2687 in it - we discard those. */
2689 if (sscanf(CS buffer
+ qlen
, "%d , %d%n", &received_sender_port
,
2690 &received_interface_port
, &n
) != 2 ||
2691 received_sender_port
!= sender_host_port
||
2692 received_interface_port
!= interface_port
)
2695 p
= buffer
+ qlen
+ n
;
2696 while(isspace(*p
)) p
++;
2697 if (*p
++ != ':') goto END_OFF
;
2698 while(isspace(*p
)) p
++;
2699 if (Ustrncmp(p
, "USERID", 6) != 0) goto END_OFF
;
2701 while(isspace(*p
)) p
++;
2702 if (*p
++ != ':') goto END_OFF
;
2703 while (*p
!= 0 && *p
!= ':') p
++;
2704 if (*p
++ == 0) goto END_OFF
;
2705 while(isspace(*p
)) p
++;
2706 if (*p
== 0) goto END_OFF
;
2708 /* The rest of the line is the data we want. We turn it into printing
2709 characters when we save it, so that it cannot mess up the format of any logging
2710 or Received: lines into which it gets inserted. We keep a maximum of 127
2713 sender_ident
= string_printing(string_copyn(p
, 127));
2714 DEBUG(D_ident
) debug_printf("sender_ident = %s\n", sender_ident
);
2724 /*************************************************
2725 * Match host to a single host-list item *
2726 *************************************************/
2728 /* This function compares a host (name or address) against a single item
2729 from a host list. The host name gets looked up if it is needed and is not
2730 already known. The function is called from verify_check_this_host() via
2731 match_check_list(), which is why most of its arguments are in a single block.
2734 arg the argument block (see below)
2735 ss the host-list item
2736 valueptr where to pass back looked up data, or NULL
2737 error for error message when returning ERROR
2740 host_name (a) the host name, or
2741 (b) NULL, implying use sender_host_name and
2742 sender_host_aliases, looking them up if required, or
2743 (c) the empty string, meaning that only IP address matches
2745 host_address the host address
2746 host_ipv4 the IPv4 address taken from an IPv6 one
2750 DEFER lookup deferred
2751 ERROR (a) failed to find the host name or IP address, or
2752 (b) unknown lookup type specified, or
2753 (c) host name encountered when only IP addresses are
2758 check_host(void *arg
, uschar
*ss
, uschar
**valueptr
, uschar
**error
)
2760 check_host_block
*cb
= (check_host_block
*)arg
;
2763 BOOL iplookup
= FALSE
;
2764 BOOL isquery
= FALSE
;
2765 BOOL isiponly
= cb
->host_name
!= NULL
&& cb
->host_name
[0] == 0;
2770 /* Optimize for the special case when the pattern is "*". */
2772 if (*ss
== '*' && ss
[1] == 0) return OK
;
2774 /* If the pattern is empty, it matches only in the case when there is no host -
2775 this can occur in ACL checking for SMTP input using the -bs option. In this
2776 situation, the host address is the empty string. */
2778 if (cb
->host_address
[0] == 0) return (*ss
== 0)? OK
: FAIL
;
2779 if (*ss
== 0) return FAIL
;
2781 /* If the pattern is precisely "@" then match against the primary host name,
2782 provided that host name matching is permitted; if it's "@[]" match against the
2783 local host's IP addresses. */
2789 if (isiponly
) return ERROR
;
2790 ss
= primary_hostname
;
2792 else if (Ustrcmp(ss
, "@[]") == 0)
2794 ip_address_item
*ip
;
2795 for (ip
= host_find_interfaces(); ip
!= NULL
; ip
= ip
->next
)
2796 if (Ustrcmp(ip
->address
, cb
->host_address
) == 0) return OK
;
2801 /* If the pattern is an IP address, optionally followed by a bitmask count, do
2802 a (possibly masked) comparision with the current IP address. */
2804 if (string_is_ip_address(ss
, &maskoffset
) != 0)
2805 return (host_is_in_net(cb
->host_address
, ss
, maskoffset
)? OK
: FAIL
);
2807 /* The pattern is not an IP address. A common error that people make is to omit
2808 one component of an IPv4 address, either by accident, or believing that, for
2809 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,
2810 which it isn't. (Those applications that do accept 1.2.3 as an IP address
2811 interpret it as 1.2.0.3 because the final component becomes 16-bit - this is an
2812 ancient specification.) To aid in debugging these cases, we give a specific
2813 error if the pattern contains only digits and dots or contains a slash preceded
2814 only by digits and dots (a slash at the start indicates a file name and of
2815 course slashes may be present in lookups, but not preceded only by digits and
2818 for (t
= ss
; isdigit(*t
) || *t
== '.'; t
++);
2819 if (*t
== 0 || (*t
== '/' && t
!= ss
))
2821 *error
= US
"malformed IPv4 address or address mask";
2825 /* See if there is a semicolon in the pattern */
2827 semicolon
= Ustrchr(ss
, ';');
2829 /* If we are doing an IP address only match, then all lookups must be IP
2830 address lookups, even if there is no "net-". */
2834 iplookup
= semicolon
!= NULL
;
2837 /* Otherwise, if the item is of the form net[n]-lookup;<file|query> then it is
2838 a lookup on a masked IP network, in textual form. We obey this code even if we
2839 have already set iplookup, so as to skip over the "net-" prefix and to set the
2840 mask length. The net- stuff really only applies to single-key lookups where the
2841 key is implicit. For query-style lookups the key is specified in the query.
2842 From release 4.30, the use of net- for query style is no longer needed, but we
2843 retain it for backward compatibility. */
2845 if (Ustrncmp(ss
, "net", 3) == 0 && semicolon
!= NULL
)
2848 for (t
= ss
+ 3; isdigit(*t
); t
++) mlen
= mlen
* 10 + *t
- '0';
2849 if (mlen
== 0 && t
== ss
+3) mlen
= -1; /* No mask supplied */
2850 iplookup
= (*t
++ == '-');
2854 /* Do the IP address lookup if that is indeed what we have */
2862 uschar
*filename
, *key
, *result
;
2865 /* Find the search type */
2867 search_type
= search_findtype(t
, semicolon
- t
);
2869 if (search_type
< 0) log_write(0, LOG_MAIN
|LOG_PANIC_DIE
, "%s",
2870 search_error_message
);
2872 /* Adjust parameters for the type of lookup. For a query-style lookup, there
2873 is no file name, and the "key" is just the query. For query-style with a file
2874 name, we have to fish the file off the start of the query. For a single-key
2875 lookup, the key is the current IP address, masked appropriately, and
2876 reconverted to text form, with the mask appended. For IPv6 addresses, specify
2877 dot separators instead of colons, except when the lookup type is "iplsearch".
2880 if (mac_islookup(search_type
, lookup_absfilequery
))
2882 filename
= semicolon
+ 1;
2884 while (*key
!= 0 && !isspace(*key
)) key
++;
2885 filename
= string_copyn(filename
, key
- filename
);
2886 while (isspace(*key
)) key
++;
2888 else if (mac_islookup(search_type
, lookup_querystyle
))
2891 key
= semicolon
+ 1;
2893 else /* Single-key style */
2895 int sep
= (Ustrcmp(lookup_list
[search_type
]->name
, "iplsearch") == 0)?
2897 insize
= host_aton(cb
->host_address
, incoming
);
2898 host_mask(insize
, incoming
, mlen
);
2899 (void)host_nmtoa(insize
, incoming
, mlen
, buffer
, sep
);
2901 filename
= semicolon
+ 1;
2904 /* Now do the actual lookup; note that there is no search_close() because
2905 of the caching arrangements. */
2907 handle
= search_open(filename
, search_type
, 0, NULL
, NULL
);
2908 if (handle
== NULL
) log_write(0, LOG_MAIN
|LOG_PANIC_DIE
, "%s",
2909 search_error_message
);
2910 result
= search_find(handle
, filename
, key
, -1, NULL
, 0, 0, NULL
);
2911 if (valueptr
!= NULL
) *valueptr
= result
;
2912 return (result
!= NULL
)? OK
: search_find_defer
? DEFER
: FAIL
;
2915 /* The pattern is not an IP address or network reference of any kind. That is,
2916 it is a host name pattern. If this is an IP only match, there's an error in the
2921 *error
= US
"cannot match host name in match_ip list";
2925 /* Check the characters of the pattern to see if they comprise only letters,
2926 digits, full stops, and hyphens (the constituents of domain names). Allow
2927 underscores, as they are all too commonly found. Sigh. Also, if
2928 allow_utf8_domains is set, allow top-bit characters. */
2930 for (t
= ss
; *t
!= 0; t
++)
2931 if (!isalnum(*t
) && *t
!= '.' && *t
!= '-' && *t
!= '_' &&
2932 (!allow_utf8_domains
|| *t
< 128)) break;
2934 /* If the pattern is a complete domain name, with no fancy characters, look up
2935 its IP address and match against that. Note that a multi-homed host will add
2936 items to the chain. */
2947 rc
= host_find_byname(&h
, NULL
, HOST_FIND_QUALIFY_SINGLE
, NULL
, FALSE
);
2948 if (rc
== HOST_FOUND
|| rc
== HOST_FOUND_LOCAL
)
2951 for (hh
= &h
; hh
!= NULL
; hh
= hh
->next
)
2953 if (host_is_in_net(hh
->address
, cb
->host_address
, 0)) return OK
;
2957 if (rc
== HOST_FIND_AGAIN
) return DEFER
;
2958 *error
= string_sprintf("failed to find IP address for %s", ss
);
2962 /* Almost all subsequent comparisons require the host name, and can be done
2963 using the general string matching function. When this function is called for
2964 outgoing hosts, the name is always given explicitly. If it is NULL, it means we
2965 must use sender_host_name and its aliases, looking them up if necessary. */
2967 if (cb
->host_name
!= NULL
) /* Explicit host name given */
2968 return match_check_string(cb
->host_name
, ss
, -1, TRUE
, TRUE
, TRUE
,
2971 /* Host name not given; in principle we need the sender host name and its
2972 aliases. However, for query-style lookups, we do not need the name if the
2973 query does not contain $sender_host_name. From release 4.23, a reference to
2974 $sender_host_name causes it to be looked up, so we don't need to do the lookup
2977 if ((semicolon
= Ustrchr(ss
, ';')) != NULL
)
2980 int partial
, affixlen
, starflags
, id
;
2983 id
= search_findtype_partial(ss
, &partial
, &affix
, &affixlen
, &starflags
);
2986 if (id
< 0) /* Unknown lookup type */
2988 log_write(0, LOG_MAIN
|LOG_PANIC
, "%s in host list item \"%s\"",
2989 search_error_message
, ss
);
2992 isquery
= mac_islookup(id
, lookup_querystyle
|lookup_absfilequery
);
2997 switch(match_check_string(US
"", ss
, -1, TRUE
, TRUE
, TRUE
, valueptr
))
3000 case DEFER
: return DEFER
;
3001 default: return FAIL
;
3005 /* Not a query-style lookup; must ensure the host name is present, and then we
3006 do a check on the name and all its aliases. */
3008 if (sender_host_name
== NULL
)
3010 HDEBUG(D_host_lookup
)
3011 debug_printf("sender host name required, to match against %s\n", ss
);
3012 if (host_lookup_failed
|| host_name_lookup() != OK
)
3014 *error
= string_sprintf("failed to find host name for %s",
3015 sender_host_address
);;
3018 host_build_sender_fullhost();
3021 /* Match on the sender host name, using the general matching function */
3023 switch(match_check_string(sender_host_name
, ss
, -1, TRUE
, TRUE
, TRUE
,
3027 case DEFER
: return DEFER
;
3030 /* If there are aliases, try matching on them. */
3032 aliases
= sender_host_aliases
;
3033 while (*aliases
!= NULL
)
3035 switch(match_check_string(*aliases
++, ss
, -1, TRUE
, TRUE
, TRUE
, valueptr
))
3038 case DEFER
: return DEFER
;
3047 /*************************************************
3048 * Check a specific host matches a host list *
3049 *************************************************/
3051 /* This function is passed a host list containing items in a number of
3052 different formats and the identity of a host. Its job is to determine whether
3053 the given host is in the set of hosts defined by the list. The host name is
3054 passed as a pointer so that it can be looked up if needed and not already
3055 known. This is commonly the case when called from verify_check_host() to check
3056 an incoming connection. When called from elsewhere the host name should usually
3059 This function is now just a front end to match_check_list(), which runs common
3060 code for scanning a list. We pass it the check_host() function to perform a
3064 listptr pointer to the host list
3065 cache_bits pointer to cache for named lists, or NULL
3066 host_name the host name or NULL, implying use sender_host_name and
3067 sender_host_aliases, looking them up if required
3068 host_address the IP address
3069 valueptr if not NULL, data from a lookup is passed back here
3071 Returns: OK if the host is in the defined set
3072 FAIL if the host is not in the defined set,
3073 DEFER if a data lookup deferred (not a host lookup)
3075 If the host name was needed in order to make a comparison, and could not be
3076 determined from the IP address, the result is FAIL unless the item
3077 "+allow_unknown" was met earlier in the list, in which case OK is returned. */
3080 verify_check_this_host(uschar
**listptr
, unsigned int *cache_bits
,
3081 uschar
*host_name
, uschar
*host_address
, uschar
**valueptr
)
3084 unsigned int *local_cache_bits
= cache_bits
;
3085 uschar
*save_host_address
= deliver_host_address
;
3086 check_host_block cb
;
3087 cb
.host_name
= host_name
;
3088 cb
.host_address
= host_address
;
3090 if (valueptr
!= NULL
) *valueptr
= NULL
;
3092 /* If the host address starts off ::ffff: it is an IPv6 address in
3093 IPv4-compatible mode. Find the IPv4 part for checking against IPv4
3096 cb
.host_ipv4
= (Ustrncmp(host_address
, "::ffff:", 7) == 0)?
3097 host_address
+ 7 : host_address
;
3099 /* During the running of the check, put the IP address into $host_address. In
3100 the case of calls from the smtp transport, it will already be there. However,
3101 in other calls (e.g. when testing ignore_target_hosts), it won't. Just to be on
3102 the safe side, any existing setting is preserved, though as I write this
3103 (November 2004) I can't see any cases where it is actually needed. */
3105 deliver_host_address
= host_address
;
3106 rc
= match_check_list(
3107 listptr
, /* the list */
3108 0, /* separator character */
3109 &hostlist_anchor
, /* anchor pointer */
3110 &local_cache_bits
, /* cache pointer */
3111 check_host
, /* function for testing */
3112 &cb
, /* argument for function */
3113 MCL_HOST
, /* type of check */
3114 (host_address
== sender_host_address
)?
3115 US
"host" : host_address
, /* text for debugging */
3116 valueptr
); /* where to pass back data */
3117 deliver_host_address
= save_host_address
;
3124 /*************************************************
3125 * Check the remote host matches a list *
3126 *************************************************/
3128 /* This is a front end to verify_check_this_host(), created because checking
3129 the remote host is a common occurrence. With luck, a good compiler will spot
3130 the tail recursion and optimize it. If there's no host address, this is
3131 command-line SMTP input - check against an empty string for the address.
3134 listptr pointer to the host list
3136 Returns: the yield of verify_check_this_host(),
3137 i.e. OK, FAIL, or DEFER
3141 verify_check_host(uschar
**listptr
)
3143 return verify_check_this_host(listptr
, sender_host_cache
, NULL
,
3144 (sender_host_address
== NULL
)? US
"" : sender_host_address
, NULL
);
3151 /*************************************************
3152 * Invert an IP address *
3153 *************************************************/
3155 /* Originally just used for DNS xBL lists, now also used for the
3156 reverse_ip expansion operator.
3159 buffer where to put the answer
3160 address the address to invert
3164 invert_address(uschar
*buffer
, uschar
*address
)
3167 uschar
*bptr
= buffer
;
3169 /* If this is an IPv4 address mapped into IPv6 format, adjust the pointer
3170 to the IPv4 part only. */
3172 if (Ustrncmp(address
, "::ffff:", 7) == 0) address
+= 7;
3174 /* Handle IPv4 address: when HAVE_IPV6 is false, the result of host_aton() is
3177 if (host_aton(address
, bin
) == 1)
3181 for (i
= 0; i
< 4; i
++)
3183 sprintf(CS bptr
, "%d.", x
& 255);
3184 while (*bptr
) bptr
++;
3189 /* Handle IPv6 address. Actually, as far as I know, there are no IPv6 addresses
3190 in any DNS black lists, and the format in which they will be looked up is
3191 unknown. This is just a guess. */
3197 for (j
= 3; j
>= 0; j
--)
3200 for (i
= 0; i
< 8; i
++)
3202 sprintf(CS bptr
, "%x.", x
& 15);
3203 while (*bptr
) bptr
++;
3210 /* Remove trailing period -- this is needed so that both arbitrary
3211 dnsbl keydomains and inverted addresses may be combined with the
3212 same format string, "%s.%s" */
3219 /*************************************************
3220 * Perform a single dnsbl lookup *
3221 *************************************************/
3223 /* This function is called from verify_check_dnsbl() below. It is also called
3224 recursively from within itself when domain and domain_txt are different
3225 pointers, in order to get the TXT record from the alternate domain.
3228 domain the outer dnsbl domain
3229 domain_txt alternate domain to lookup TXT record on success; when the
3230 same domain is to be used, domain_txt == domain (that is,
3231 the pointers must be identical, not just the text)
3232 keydomain the current keydomain (for debug message)
3233 prepend subdomain to lookup (like keydomain, but
3234 reversed if IP address)
3235 iplist the list of matching IP addresses, or NULL for "any"
3236 bitmask true if bitmask matching is wanted
3237 match_type condition for 'succeed' result
3238 0 => Any RR in iplist (=)
3239 1 => No RR in iplist (!=)
3240 2 => All RRs in iplist (==)
3241 3 => Some RRs not in iplist (!==)
3242 the two bits are defined as MT_NOT and MT_ALL
3243 defer_return what to return for a defer
3245 Returns: OK if lookup succeeded
3250 one_check_dnsbl(uschar
*domain
, uschar
*domain_txt
, uschar
*keydomain
,
3251 uschar
*prepend
, uschar
*iplist
, BOOL bitmask
, int match_type
,
3257 dnsbl_cache_block
*cb
;
3258 int old_pool
= store_pool
;
3259 uschar query
[256]; /* DNS domain max length */
3261 /* Construct the specific query domainname */
3263 if (!string_format(query
, sizeof(query
), "%s.%s", prepend
, domain
))
3265 log_write(0, LOG_MAIN
|LOG_PANIC
, "dnslist query is too long "
3266 "(ignored): %s...", query
);
3270 /* Look for this query in the cache. */
3272 t
= tree_search(dnsbl_cache
, query
);
3274 /* If not cached from a previous lookup, we must do a DNS lookup, and
3275 cache the result in permanent memory. */
3279 store_pool
= POOL_PERM
;
3281 /* Set up a tree entry to cache the lookup */
3283 t
= store_get(sizeof(tree_node
) + Ustrlen(query
));
3284 Ustrcpy(t
->name
, query
);
3285 t
->data
.ptr
= cb
= store_get(sizeof(dnsbl_cache_block
));
3286 (void)tree_insertnode(&dnsbl_cache
, t
);
3288 /* Do the DNS loopup . */
3290 HDEBUG(D_dnsbl
) debug_printf("new DNS lookup for %s\n", query
);
3291 cb
->rc
= dns_basic_lookup(&dnsa
, query
, T_A
);
3292 cb
->text_set
= FALSE
;
3296 /* If the lookup succeeded, cache the RHS address. The code allows for
3297 more than one address - this was for complete generality and the possible
3298 use of A6 records. However, A6 records have been reduced to experimental
3299 status (August 2001) and may die out. So they may never get used at all,
3300 let alone in dnsbl records. However, leave the code here, just in case.
3302 Quite apart from one A6 RR generating multiple addresses, there are DNS
3303 lists that return more than one A record, so we must handle multiple
3304 addresses generated in that way as well. */
3306 if (cb
->rc
== DNS_SUCCEED
)
3309 dns_address
**addrp
= &(cb
->rhs
);
3310 for (rr
= dns_next_rr(&dnsa
, &dnss
, RESET_ANSWERS
);
3312 rr
= dns_next_rr(&dnsa
, &dnss
, RESET_NEXT
))
3314 if (rr
->type
== T_A
)
3316 dns_address
*da
= dns_address_from_rr(&dnsa
, rr
);
3320 while (da
->next
!= NULL
) da
= da
->next
;
3321 addrp
= &(da
->next
);
3326 /* If we didn't find any A records, change the return code. This can
3327 happen when there is a CNAME record but there are no A records for what
3330 if (cb
->rhs
== NULL
) cb
->rc
= DNS_NODATA
;
3333 store_pool
= old_pool
;
3336 /* Previous lookup was cached */
3340 HDEBUG(D_dnsbl
) debug_printf("using result of previous DNS lookup\n");
3344 /* We now have the result of the DNS lookup, either newly done, or cached
3345 from a previous call. If the lookup succeeded, check against the address
3346 list if there is one. This may be a positive equality list (introduced by
3347 "="), a negative equality list (introduced by "!="), a positive bitmask
3348 list (introduced by "&"), or a negative bitmask list (introduced by "!&").*/
3350 if (cb
->rc
== DNS_SUCCEED
)
3352 dns_address
*da
= NULL
;
3353 uschar
*addlist
= cb
->rhs
->address
;
3355 /* For A and AAAA records, there may be multiple addresses from multiple
3356 records. For A6 records (currently not expected to be used) there may be
3357 multiple addresses from a single record. */
3359 for (da
= cb
->rhs
->next
; da
!= NULL
; da
= da
->next
)
3360 addlist
= string_sprintf("%s, %s", addlist
, da
->address
);
3362 HDEBUG(D_dnsbl
) debug_printf("DNS lookup for %s succeeded (yielding %s)\n",
3365 /* Address list check; this can be either for equality, or via a bitmask.
3366 In the latter case, all the bits must match. */
3370 for (da
= cb
->rhs
; da
!= NULL
; da
= da
->next
)
3374 uschar
*ptr
= iplist
;
3377 /* Handle exact matching */
3381 while ((res
= string_nextinlist(&ptr
, &ipsep
, ip
, sizeof(ip
))) != NULL
)
3383 if (Ustrcmp(CS da
->address
, ip
) == 0) break;
3387 /* Handle bitmask matching */
3394 /* At present, all known DNS blocking lists use A records, with
3395 IPv4 addresses on the RHS encoding the information they return. I
3396 wonder if this will linger on as the last vestige of IPv4 when IPv6
3397 is ubiquitous? Anyway, for now we use paranoia code to completely
3398 ignore IPv6 addresses. The default mask is 0, which always matches.
3399 We change this only for IPv4 addresses in the list. */
3401 if (host_aton(da
->address
, address
) == 1) mask
= address
[0];
3403 /* Scan the returned addresses, skipping any that are IPv6 */
3405 while ((res
= string_nextinlist(&ptr
, &ipsep
, ip
, sizeof(ip
))) != NULL
)
3407 if (host_aton(ip
, address
) != 1) continue;
3408 if ((address
[0] & mask
) == address
[0]) break;
3414 (a) An IP address in an any ('=') list matched, or
3415 (b) No IP address in an all ('==') list matched
3417 then we're done searching. */
3419 if (((match_type
& MT_ALL
) != 0) == (res
== NULL
)) break;
3422 /* If da == NULL, either
3424 (a) No IP address in an any ('=') list matched, or
3425 (b) An IP address in an all ('==') list didn't match
3427 so behave as if the DNSBL lookup had not succeeded, i.e. the host is not on
3430 if ((match_type
== MT_NOT
|| match_type
== MT_ALL
) != (da
== NULL
))
3438 res
= US
"was no match";
3441 res
= US
"was an exclude match";
3444 res
= US
"was an IP address that did not match";
3447 res
= US
"were no IP addresses that did not match";
3450 debug_printf("=> but we are not accepting this block class because\n");
3451 debug_printf("=> there %s for %s%c%s\n",
3453 ((match_type
& MT_ALL
) == 0)? "" : "=",
3454 bitmask
? '&' : '=', iplist
);
3460 /* Either there was no IP list, or the record matched, implying that the
3461 domain is on the list. We now want to find a corresponding TXT record. If an
3462 alternate domain is specified for the TXT record, call this function
3463 recursively to look that up; this has the side effect of re-checking that
3464 there is indeed an A record at the alternate domain. */
3466 if (domain_txt
!= domain
)
3467 return one_check_dnsbl(domain_txt
, domain_txt
, keydomain
, prepend
, NULL
,
3468 FALSE
, match_type
, defer_return
);
3470 /* If there is no alternate domain, look up a TXT record in the main domain
3471 if it has not previously been cached. */
3475 cb
->text_set
= TRUE
;
3476 if (dns_basic_lookup(&dnsa
, query
, T_TXT
) == DNS_SUCCEED
)
3479 for (rr
= dns_next_rr(&dnsa
, &dnss
, RESET_ANSWERS
);
3481 rr
= dns_next_rr(&dnsa
, &dnss
, RESET_NEXT
))
3482 if (rr
->type
== T_TXT
) break;
3485 int len
= (rr
->data
)[0];
3486 if (len
> 511) len
= 127;
3487 store_pool
= POOL_PERM
;
3488 cb
->text
= string_sprintf("%.*s", len
, (const uschar
*)(rr
->data
+1));
3489 store_pool
= old_pool
;
3494 dnslist_value
= addlist
;
3495 dnslist_text
= cb
->text
;
3499 /* There was a problem with the DNS lookup */
3501 if (cb
->rc
!= DNS_NOMATCH
&& cb
->rc
!= DNS_NODATA
)
3503 log_write(L_dnslist_defer
, LOG_MAIN
,
3504 "DNS list lookup defer (probably timeout) for %s: %s", query
,
3505 (defer_return
== OK
)? US
"assumed in list" :
3506 (defer_return
== FAIL
)? US
"assumed not in list" :
3507 US
"returned DEFER");
3508 return defer_return
;
3511 /* No entry was found in the DNS; continue for next domain */
3515 debug_printf("DNS lookup for %s failed\n", query
);
3516 debug_printf("=> that means %s is not listed at %s\n",
3526 /*************************************************
3527 * Check host against DNS black lists *
3528 *************************************************/
3530 /* This function runs checks against a list of DNS black lists, until one
3531 matches. Each item on the list can be of the form
3533 domain=ip-address/key
3535 The domain is the right-most domain that is used for the query, for example,
3536 blackholes.mail-abuse.org. If the IP address is present, there is a match only
3537 if the DNS lookup returns a matching IP address. Several addresses may be
3538 given, comma-separated, for example: x.y.z=127.0.0.1,127.0.0.2.
3540 If no key is given, what is looked up in the domain is the inverted IP address
3541 of the current client host. If a key is given, it is used to construct the
3542 domain for the lookup. For example:
3544 dsn.rfc-ignorant.org/$sender_address_domain
3546 After finding a match in the DNS, the domain is placed in $dnslist_domain, and
3547 then we check for a TXT record for an error message, and if found, save its
3548 value in $dnslist_text. We also cache everything in a tree, to optimize
3551 The TXT record is normally looked up in the same domain as the A record, but
3552 when many lists are combined in a single DNS domain, this will not be a very
3553 specific message. It is possible to specify a different domain for looking up
3554 TXT records; this is given before the main domain, comma-separated. For
3557 dnslists = http.dnsbl.sorbs.net,dnsbl.sorbs.net=127.0.0.2 : \
3558 socks.dnsbl.sorbs.net,dnsbl.sorbs.net=127.0.0.3
3560 The caching ensures that only one lookup in dnsbl.sorbs.net is done.
3562 Note: an address for testing RBL is 192.203.178.39
3563 Note: an address for testing DUL is 192.203.178.4
3564 Note: a domain for testing RFCI is example.tld.dsn.rfc-ignorant.org
3567 listptr the domain/address/data list
3569 Returns: OK successful lookup (i.e. the address is on the list), or
3570 lookup deferred after +include_unknown
3571 FAIL name not found, or no data found for the given type, or
3572 lookup deferred after +exclude_unknown (default)
3573 DEFER lookup failure, if +defer_unknown was set
3577 verify_check_dnsbl(uschar
**listptr
)
3580 int defer_return
= FAIL
;
3581 uschar
*list
= *listptr
;
3584 uschar buffer
[1024];
3585 uschar revadd
[128]; /* Long enough for IPv6 address */
3587 /* Indicate that the inverted IP address is not yet set up */
3591 /* In case this is the first time the DNS resolver is being used. */
3593 dns_init(FALSE
, FALSE
, FALSE
); /*XXX dnssec? */
3595 /* Loop through all the domains supplied, until something matches */
3597 while ((domain
= string_nextinlist(&list
, &sep
, buffer
, sizeof(buffer
))) != NULL
)
3600 BOOL bitmask
= FALSE
;
3607 HDEBUG(D_dnsbl
) debug_printf("DNS list check: %s\n", domain
);
3609 /* Deal with special values that change the behaviour on defer */
3611 if (domain
[0] == '+')
3613 if (strcmpic(domain
, US
"+include_unknown") == 0) defer_return
= OK
;
3614 else if (strcmpic(domain
, US
"+exclude_unknown") == 0) defer_return
= FAIL
;
3615 else if (strcmpic(domain
, US
"+defer_unknown") == 0) defer_return
= DEFER
;
3617 log_write(0, LOG_MAIN
|LOG_PANIC
, "unknown item in dnslist (ignored): %s",
3622 /* See if there's explicit data to be looked up */
3624 key
= Ustrchr(domain
, '/');
3625 if (key
!= NULL
) *key
++ = 0;
3627 /* See if there's a list of addresses supplied after the domain name. This is
3628 introduced by an = or a & character; if preceded by = we require all matches
3629 and if preceded by ! we invert the result. */
3631 iplist
= Ustrchr(domain
, '=');
3635 iplist
= Ustrchr(domain
, '&');
3638 if (iplist
!= NULL
) /* Found either = or & */
3640 if (iplist
> domain
&& iplist
[-1] == '!') /* Handle preceding ! */
3642 match_type
|= MT_NOT
;
3646 *iplist
++ = 0; /* Terminate domain, move on */
3648 /* If we found = (bitmask == FALSE), check for == or =& */
3650 if (!bitmask
&& (*iplist
== '=' || *iplist
== '&'))
3652 bitmask
= *iplist
++ == '&';
3653 match_type
|= MT_ALL
;
3657 /* If there is a comma in the domain, it indicates that a second domain for
3658 looking up TXT records is provided, before the main domain. Otherwise we must
3659 set domain_txt == domain. */
3661 domain_txt
= domain
;
3662 comma
= Ustrchr(domain
, ',');
3669 /* Check that what we have left is a sensible domain name. There is no reason
3670 why these domains should in fact use the same syntax as hosts and email
3671 domains, but in practice they seem to. However, there is little point in
3672 actually causing an error here, because that would no doubt hold up incoming
3673 mail. Instead, I'll just log it. */
3675 for (s
= domain
; *s
!= 0; s
++)
3677 if (!isalnum(*s
) && *s
!= '-' && *s
!= '.' && *s
!= '_')
3679 log_write(0, LOG_MAIN
, "dnslists domain \"%s\" contains "
3680 "strange characters - is this right?", domain
);
3685 /* Check the alternate domain if present */
3687 if (domain_txt
!= domain
) for (s
= domain_txt
; *s
!= 0; s
++)
3689 if (!isalnum(*s
) && *s
!= '-' && *s
!= '.' && *s
!= '_')
3691 log_write(0, LOG_MAIN
, "dnslists domain \"%s\" contains "
3692 "strange characters - is this right?", domain_txt
);
3697 /* If there is no key string, construct the query by adding the domain name
3698 onto the inverted host address, and perform a single DNS lookup. */
3702 if (sender_host_address
== NULL
) return FAIL
; /* can never match */
3703 if (revadd
[0] == 0) invert_address(revadd
, sender_host_address
);
3704 rc
= one_check_dnsbl(domain
, domain_txt
, sender_host_address
, revadd
,
3705 iplist
, bitmask
, match_type
, defer_return
);
3708 dnslist_domain
= string_copy(domain_txt
);
3709 dnslist_matched
= string_copy(sender_host_address
);
3710 HDEBUG(D_dnsbl
) debug_printf("=> that means %s is listed at %s\n",
3711 sender_host_address
, dnslist_domain
);
3713 if (rc
!= FAIL
) return rc
; /* OK or DEFER */
3716 /* If there is a key string, it can be a list of domains or IP addresses to
3717 be concatenated with the main domain. */
3724 uschar keybuffer
[256];
3725 uschar keyrevadd
[128];
3727 while ((keydomain
= string_nextinlist(&key
, &keysep
, keybuffer
,
3728 sizeof(keybuffer
))) != NULL
)
3730 uschar
*prepend
= keydomain
;
3732 if (string_is_ip_address(keydomain
, NULL
) != 0)
3734 invert_address(keyrevadd
, keydomain
);
3735 prepend
= keyrevadd
;
3738 rc
= one_check_dnsbl(domain
, domain_txt
, keydomain
, prepend
, iplist
,
3739 bitmask
, match_type
, defer_return
);
3743 dnslist_domain
= string_copy(domain_txt
);
3744 dnslist_matched
= string_copy(keydomain
);
3745 HDEBUG(D_dnsbl
) debug_printf("=> that means %s is listed at %s\n",
3746 keydomain
, dnslist_domain
);
3750 /* If the lookup deferred, remember this fact. We keep trying the rest
3751 of the list to see if we get a useful result, and if we don't, we return
3752 DEFER at the end. */
3754 if (rc
== DEFER
) defer
= TRUE
;
3755 } /* continue with next keystring domain/address */
3757 if (defer
) return DEFER
;
3759 } /* continue with next dnsdb outer domain */
3766 /* End of verify.c */