1 /*************************************************
2 * Exim - an Internet mail transport agent *
3 *************************************************/
5 /* Copyright (c) University of Cambridge 1995 - 2009 */
6 /* See the file NOTICE for conditions of use and distribution. */
8 /* The main code for delivering a message. */
14 /* Data block for keeping track of subprocesses for parallel remote
17 typedef struct pardata {
18 address_item *addrlist; /* chain of addresses */
19 address_item *addr; /* next address data expected for */
20 pid_t pid; /* subprocess pid */
21 int fd; /* pipe fd for getting result from subprocess */
22 int transport_count; /* returned transport count value */
23 BOOL done; /* no more data needed */
24 uschar *msg; /* error message */
25 uschar *return_path; /* return_path for these addresses */
28 /* Values for the process_recipients variable */
30 enum { RECIP_ACCEPT, RECIP_IGNORE, RECIP_DEFER,
31 RECIP_FAIL, RECIP_FAIL_FILTER, RECIP_FAIL_TIMEOUT,
34 /* Mutually recursive functions for marking addresses done. */
36 static void child_done(address_item *, uschar *);
37 static void address_done(address_item *, uschar *);
39 /* Table for turning base-62 numbers into binary */
41 static uschar tab62[] =
42 {0,1,2,3,4,5,6,7,8,9,0,0,0,0,0,0, /* 0-9 */
43 0,10,11,12,13,14,15,16,17,18,19,20, /* A-K */
44 21,22,23,24,25,26,27,28,29,30,31,32, /* L-W */
45 33,34,35, 0, 0, 0, 0, 0, /* X-Z */
46 0,36,37,38,39,40,41,42,43,44,45,46, /* a-k */
47 47,48,49,50,51,52,53,54,55,56,57,58, /* l-w */
51 /*************************************************
52 * Local static variables *
53 *************************************************/
55 /* addr_duplicate is global because it needs to be seen from the Envelope-To
58 static address_item *addr_defer = NULL;
59 static address_item *addr_failed = NULL;
60 static address_item *addr_fallback = NULL;
61 static address_item *addr_local = NULL;
62 static address_item *addr_new = NULL;
63 static address_item *addr_remote = NULL;
64 static address_item *addr_route = NULL;
65 static address_item *addr_succeed = NULL;
67 static FILE *message_log = NULL;
68 static BOOL update_spool;
69 static BOOL remove_journal;
70 static int parcount = 0;
71 static pardata *parlist = NULL;
72 static int return_count;
73 static uschar *frozen_info = US"";
74 static uschar *used_return_path = NULL;
76 static uschar spoolname[PATH_MAX];
80 /*************************************************
81 * Make a new address item *
82 *************************************************/
84 /* This function gets the store and initializes with default values. The
85 transport_return value defaults to DEFER, so that any unexpected failure to
86 deliver does not wipe out the message. The default unique string is set to a
87 copy of the address, so that its domain can be lowercased.
90 address the RFC822 address string
91 copy force a copy of the address
93 Returns: a pointer to an initialized address_item
97 deliver_make_addr(uschar *address, BOOL copy)
99 address_item *addr = store_get(sizeof(address_item));
100 *addr = address_defaults;
101 if (copy) address = string_copy(address);
102 addr->address = address;
103 addr->unique = string_copy(address);
110 /*************************************************
111 * Set expansion values for an address *
112 *************************************************/
114 /* Certain expansion variables are valid only when handling an address or
115 address list. This function sets them up or clears the values, according to its
119 addr the address in question, or NULL to clear values
124 deliver_set_expansions(address_item *addr)
128 uschar ***p = address_expansions;
129 while (*p != NULL) **p++ = NULL;
133 /* Exactly what gets set depends on whether there is one or more addresses, and
134 what they contain. These first ones are always set, taking their values from
135 the first address. */
137 if (addr->host_list == NULL)
139 deliver_host = deliver_host_address = US"";
143 deliver_host = addr->host_list->name;
144 deliver_host_address = addr->host_list->address;
147 deliver_recipients = addr;
148 deliver_address_data = addr->p.address_data;
149 deliver_domain_data = addr->p.domain_data;
150 deliver_localpart_data = addr->p.localpart_data;
152 /* These may be unset for multiple addresses */
154 deliver_domain = addr->domain;
155 self_hostname = addr->self_hostname;
157 #ifdef EXPERIMENTAL_BRIGHTMAIL
158 bmi_deliver = 1; /* deliver by default */
159 bmi_alt_location = NULL;
160 bmi_base64_verdict = NULL;
161 bmi_base64_tracker_verdict = NULL;
164 /* If there's only one address we can set everything. */
166 if (addr->next == NULL)
168 address_item *addr_orig;
170 deliver_localpart = addr->local_part;
171 deliver_localpart_prefix = addr->prefix;
172 deliver_localpart_suffix = addr->suffix;
174 for (addr_orig = addr; addr_orig->parent != NULL;
175 addr_orig = addr_orig->parent);
176 deliver_domain_orig = addr_orig->domain;
178 /* Re-instate any prefix and suffix in the original local part. In all
179 normal cases, the address will have a router associated with it, and we can
180 choose the caseful or caseless version accordingly. However, when a system
181 filter sets up a pipe, file, or autoreply delivery, no router is involved.
182 In this case, though, there won't be any prefix or suffix to worry about. */
184 deliver_localpart_orig = (addr_orig->router == NULL)? addr_orig->local_part :
185 addr_orig->router->caseful_local_part?
186 addr_orig->cc_local_part : addr_orig->lc_local_part;
188 /* If there's a parent, make its domain and local part available, and if
189 delivering to a pipe or file, or sending an autoreply, get the local
190 part from the parent. For pipes and files, put the pipe or file string
191 into address_pipe and address_file. */
193 if (addr->parent != NULL)
195 deliver_domain_parent = addr->parent->domain;
196 deliver_localpart_parent = (addr->parent->router == NULL)?
197 addr->parent->local_part :
198 addr->parent->router->caseful_local_part?
199 addr->parent->cc_local_part : addr->parent->lc_local_part;
201 /* File deliveries have their own flag because they need to be picked out
202 as special more often. */
204 if (testflag(addr, af_pfr))
206 if (testflag(addr, af_file)) address_file = addr->local_part;
207 else if (deliver_localpart[0] == '|') address_pipe = addr->local_part;
208 deliver_localpart = addr->parent->local_part;
209 deliver_localpart_prefix = addr->parent->prefix;
210 deliver_localpart_suffix = addr->parent->suffix;
214 #ifdef EXPERIMENTAL_BRIGHTMAIL
215 /* Set expansion variables related to Brightmail AntiSpam */
216 bmi_base64_verdict = bmi_get_base64_verdict(deliver_localpart_orig, deliver_domain_orig);
217 bmi_base64_tracker_verdict = bmi_get_base64_tracker_verdict(bmi_base64_verdict);
218 /* get message delivery status (0 - don't deliver | 1 - deliver) */
219 bmi_deliver = bmi_get_delivery_status(bmi_base64_verdict);
220 /* if message is to be delivered, get eventual alternate location */
221 if (bmi_deliver == 1) {
222 bmi_alt_location = bmi_get_alt_location(bmi_base64_verdict);
228 /* For multiple addresses, don't set local part, and leave the domain and
229 self_hostname set only if it is the same for all of them. It is possible to
230 have multiple pipe and file addresses, but only when all addresses have routed
231 to the same pipe or file. */
236 if (testflag(addr, af_pfr))
238 if (testflag(addr, af_file)) address_file = addr->local_part;
239 else if (addr->local_part[0] == '|') address_pipe = addr->local_part;
241 for (addr2 = addr->next; addr2 != NULL; addr2 = addr2->next)
243 if (deliver_domain != NULL &&
244 Ustrcmp(deliver_domain, addr2->domain) != 0)
245 deliver_domain = NULL;
246 if (self_hostname != NULL && (addr2->self_hostname == NULL ||
247 Ustrcmp(self_hostname, addr2->self_hostname) != 0))
248 self_hostname = NULL;
249 if (deliver_domain == NULL && self_hostname == NULL) break;
257 /*************************************************
258 * Open a msglog file *
259 *************************************************/
261 /* This function is used both for normal message logs, and for files in the
262 msglog directory that are used to catch output from pipes. Try to create the
263 directory if it does not exist. From release 4.21, normal message logs should
264 be created when the message is received.
267 filename the file name
268 mode the mode required
269 error used for saying what failed
271 Returns: a file descriptor, or -1 (with errno set)
275 open_msglog_file(uschar *filename, int mode, uschar **error)
277 int fd = Uopen(filename, O_WRONLY|O_APPEND|O_CREAT, mode);
279 if (fd < 0 && errno == ENOENT)
282 sprintf(CS temp, "msglog/%s", message_subdir);
283 if (message_subdir[0] == 0) temp[6] = 0;
284 (void)directory_make(spool_directory, temp, MSGLOG_DIRECTORY_MODE, TRUE);
285 fd = Uopen(filename, O_WRONLY|O_APPEND|O_CREAT, mode);
288 /* Set the close-on-exec flag and change the owner to the exim uid/gid (this
289 function is called as root). Double check the mode, because the group setting
290 doesn't always get set automatically. */
294 (void)fcntl(fd, F_SETFD, fcntl(fd, F_GETFD) | FD_CLOEXEC);
295 if (fchown(fd, exim_uid, exim_gid) < 0)
300 if (fchmod(fd, mode) < 0)
306 else *error = US"create";
314 /*************************************************
315 * Write to msglog if required *
316 *************************************************/
318 /* Write to the message log, if configured. This function may also be called
322 format a string format
328 deliver_msglog(const char *format, ...)
331 if (!message_logs) return;
332 va_start(ap, format);
333 vfprintf(message_log, format, ap);
341 /*************************************************
342 * Replicate status for batch *
343 *************************************************/
345 /* When a transport handles a batch of addresses, it may treat them
346 individually, or it may just put the status in the first one, and return FALSE,
347 requesting that the status be copied to all the others externally. This is the
348 replication function. As well as the status, it copies the transport pointer,
349 which may have changed if appendfile passed the addresses on to a different
352 Argument: pointer to the first address in a chain
357 replicate_status(address_item *addr)
360 for (addr2 = addr->next; addr2 != NULL; addr2 = addr2->next)
362 addr2->transport = addr->transport;
363 addr2->transport_return = addr->transport_return;
364 addr2->basic_errno = addr->basic_errno;
365 addr2->more_errno = addr->more_errno;
366 addr2->special_action = addr->special_action;
367 addr2->message = addr->message;
368 addr2->user_message = addr->user_message;
374 /*************************************************
375 * Compare lists of hosts *
376 *************************************************/
378 /* This function is given two pointers to chains of host items, and it yields
379 TRUE if the lists refer to the same hosts in the same order, except that
381 (1) Multiple hosts with the same non-negative MX values are permitted to appear
382 in different orders. Round-robinning nameservers can cause this to happen.
384 (2) Multiple hosts with the same negative MX values less than MX_NONE are also
385 permitted to appear in different orders. This is caused by randomizing
388 This enables Exim to use a single SMTP transaction for sending to two entirely
389 different domains that happen to end up pointing at the same hosts.
392 one points to the first host list
393 two points to the second host list
395 Returns: TRUE if the lists refer to the same host set
399 same_hosts(host_item *one, host_item *two)
401 while (one != NULL && two != NULL)
403 if (Ustrcmp(one->name, two->name) != 0)
406 host_item *end_one = one;
407 host_item *end_two = two;
409 /* Batch up only if there was no MX and the list was not randomized */
411 if (mx == MX_NONE) return FALSE;
413 /* Find the ends of the shortest sequence of identical MX values */
415 while (end_one->next != NULL && end_one->next->mx == mx &&
416 end_two->next != NULL && end_two->next->mx == mx)
418 end_one = end_one->next;
419 end_two = end_two->next;
422 /* If there aren't any duplicates, there's no match. */
424 if (end_one == one) return FALSE;
426 /* For each host in the 'one' sequence, check that it appears in the 'two'
427 sequence, returning FALSE if not. */
432 for (hi = two; hi != end_two->next; hi = hi->next)
433 if (Ustrcmp(one->name, hi->name) == 0) break;
434 if (hi == end_two->next) return FALSE;
435 if (one == end_one) break;
439 /* All the hosts in the 'one' sequence were found in the 'two' sequence.
440 Ensure both are pointing at the last host, and carry on as for equality. */
451 /* True if both are NULL */
458 /*************************************************
459 * Compare header lines *
460 *************************************************/
462 /* This function is given two pointers to chains of header items, and it yields
463 TRUE if they are the same header texts in the same order.
466 one points to the first header list
467 two points to the second header list
469 Returns: TRUE if the lists refer to the same header set
473 same_headers(header_line *one, header_line *two)
477 if (one == two) return TRUE; /* Includes the case where both NULL */
478 if (one == NULL || two == NULL) return FALSE;
479 if (Ustrcmp(one->text, two->text) != 0) return FALSE;
487 /*************************************************
488 * Compare string settings *
489 *************************************************/
491 /* This function is given two pointers to strings, and it returns
492 TRUE if they are the same pointer, or if the two strings are the same.
495 one points to the first string
496 two points to the second string
498 Returns: TRUE or FALSE
502 same_strings(uschar *one, uschar *two)
504 if (one == two) return TRUE; /* Includes the case where both NULL */
505 if (one == NULL || two == NULL) return FALSE;
506 return (Ustrcmp(one, two) == 0);
511 /*************************************************
512 * Compare uid/gid for addresses *
513 *************************************************/
515 /* This function is given a transport and two addresses. It yields TRUE if the
516 uid/gid/initgroups settings for the two addresses are going to be the same when
521 addr1 the first address
522 addr2 the second address
524 Returns: TRUE or FALSE
528 same_ugid(transport_instance *tp, address_item *addr1, address_item *addr2)
530 if (!tp->uid_set && tp->expand_uid == NULL && !tp->deliver_as_creator)
532 if (testflag(addr1, af_uid_set) != testflag(addr2, af_gid_set) ||
533 (testflag(addr1, af_uid_set) &&
534 (addr1->uid != addr2->uid ||
535 testflag(addr1, af_initgroups) != testflag(addr2, af_initgroups))))
539 if (!tp->gid_set && tp->expand_gid == NULL)
541 if (testflag(addr1, af_gid_set) != testflag(addr2, af_gid_set) ||
542 (testflag(addr1, af_gid_set) && addr1->gid != addr2->gid))
552 /*************************************************
553 * Record that an address is complete *
554 *************************************************/
556 /* This function records that an address is complete. This is straightforward
557 for most addresses, where the unique address is just the full address with the
558 domain lower cased. For homonyms (addresses that are the same as one of their
559 ancestors) their are complications. Their unique addresses have \x\ prepended
560 (where x = 0, 1, 2...), so that de-duplication works correctly for siblings and
563 Exim used to record the unique addresses of homonyms as "complete". This,
564 however, fails when the pattern of redirection varies over time (e.g. if taking
565 unseen copies at only some times of day) because the prepended numbers may vary
566 from one delivery run to the next. This problem is solved by never recording
567 prepended unique addresses as complete. Instead, when a homonymic address has
568 actually been delivered via a transport, we record its basic unique address
569 followed by the name of the transport. This is checked in subsequent delivery
570 runs whenever an address is routed to a transport.
572 If the completed address is a top-level one (has no parent, which means it
573 cannot be homonymic) we also add the original address to the non-recipients
574 tree, so that it gets recorded in the spool file and therefore appears as
575 "done" in any spool listings. The original address may differ from the unique
576 address in the case of the domain.
578 Finally, this function scans the list of duplicates, marks as done any that
579 match this address, and calls child_done() for their ancestors.
582 addr address item that has been completed
583 now current time as a string
589 address_done(address_item *addr, uschar *now)
593 update_spool = TRUE; /* Ensure spool gets updated */
595 /* Top-level address */
597 if (addr->parent == NULL)
599 tree_add_nonrecipient(addr->unique);
600 tree_add_nonrecipient(addr->address);
603 /* Homonymous child address */
605 else if (testflag(addr, af_homonym))
607 if (addr->transport != NULL)
609 tree_add_nonrecipient(
610 string_sprintf("%s/%s", addr->unique + 3, addr->transport->name));
614 /* Non-homonymous child address */
616 else tree_add_nonrecipient(addr->unique);
618 /* Check the list of duplicate addresses and ensure they are now marked
621 for (dup = addr_duplicate; dup != NULL; dup = dup->next)
623 if (Ustrcmp(addr->unique, dup->unique) == 0)
625 tree_add_nonrecipient(dup->unique);
626 child_done(dup, now);
634 /*************************************************
635 * Decrease counts in parents and mark done *
636 *************************************************/
638 /* This function is called when an address is complete. If there is a parent
639 address, its count of children is decremented. If there are still other
640 children outstanding, the function exits. Otherwise, if the count has become
641 zero, address_done() is called to mark the parent and its duplicates complete.
642 Then loop for any earlier ancestors.
645 addr points to the completed address item
646 now the current time as a string, for writing to the message log
652 child_done(address_item *addr, uschar *now)
655 while (addr->parent != NULL)
658 if ((addr->child_count -= 1) > 0) return; /* Incomplete parent */
659 address_done(addr, now);
661 /* Log the completion of all descendents only when there is no ancestor with
662 the same original address. */
664 for (aa = addr->parent; aa != NULL; aa = aa->parent)
665 if (Ustrcmp(aa->address, addr->address) == 0) break;
666 if (aa != NULL) continue;
668 deliver_msglog("%s %s: children all complete\n", now, addr->address);
669 DEBUG(D_deliver) debug_printf("%s: children all complete\n", addr->address);
676 /* If msg is NULL this is a delivery log and logchar is used. Otherwise
677 this is a nonstandard call; no two-characher delivery flag is written
678 but sender-host and sender are prefixed and "msg" is inserted in the log line.
681 flags passed to log_write()
684 delivery_log(int flags, address_item * addr, int logchar, uschar * msg)
687 int size = 256; /* Used for a temporary, */
688 int ptr = 0; /* expanding buffer, for */
689 uschar *s; /* building log lines; */
690 void *reset_point; /* released afterwards. */
693 /* Log the delivery on the main log. We use an extensible string to build up
694 the log line, and reset the store afterwards. Remote deliveries should always
695 have a pointer to the host item that succeeded; local deliveries can have a
696 pointer to a single host item in their host list, for use by the transport. */
698 s = reset_point = store_get(size);
700 log_address = string_log_address(addr, (log_write_selector & L_all_parents) != 0, TRUE);
702 s = string_append(s, &size, &ptr, 3, host_and_ident(TRUE), US" ", log_address);
706 s = string_append(s, &size, &ptr, 2, US"> ", log_address);
709 if ((log_extra_selector & LX_sender_on_delivery) != 0 || msg)
710 s = string_append(s, &size, &ptr, 3, US" F=<", sender_address, US">");
712 #ifdef EXPERIMENTAL_SRS
713 if(addr->p.srs_sender)
714 s = string_append(s, &size, &ptr, 3, US" SRS=<", addr->p.srs_sender, US">");
717 /* You might think that the return path must always be set for a successful
718 delivery; indeed, I did for some time, until this statement crashed. The case
719 when it is not set is for a delivery to /dev/null which is optimised by not
722 if (used_return_path != NULL &&
723 (log_extra_selector & LX_return_path_on_delivery) != 0)
724 s = string_append(s, &size, &ptr, 3, US" P=<", used_return_path, US">");
727 s = string_append(s, &size, &ptr, 2, US" ", msg);
729 /* For a delivery from a system filter, there may not be a router */
730 if (addr->router != NULL)
731 s = string_append(s, &size, &ptr, 2, US" R=", addr->router->name);
733 s = string_append(s, &size, &ptr, 2, US" T=", addr->transport->name);
735 if ((log_extra_selector & LX_delivery_size) != 0)
736 s = string_append(s, &size, &ptr, 2, US" S=",
737 string_sprintf("%d", transport_count));
741 if (addr->transport->info->local)
743 if (addr->host_list != NULL)
744 s = string_append(s, &size, &ptr, 2, US" H=", addr->host_list->name);
745 if (addr->shadow_message != NULL)
746 s = string_cat(s, &size, &ptr, addr->shadow_message,
747 Ustrlen(addr->shadow_message));
750 /* Remote delivery */
754 if (addr->host_used != NULL)
756 s = string_append(s, &size, &ptr, 5, US" H=", addr->host_used->name,
757 US" [", addr->host_used->address, US"]");
758 if ((log_extra_selector & LX_outgoing_port) != 0)
759 s = string_append(s, &size, &ptr, 2, US":", string_sprintf("%d",
760 addr->host_used->port));
761 if (continue_sequence > 1)
762 s = string_cat(s, &size, &ptr, US"*", 1);
766 if ((log_extra_selector & LX_tls_cipher) != 0 && addr->cipher != NULL)
767 s = string_append(s, &size, &ptr, 2, US" X=", addr->cipher);
768 if ((log_extra_selector & LX_tls_certificate_verified) != 0 &&
769 addr->cipher != NULL)
770 s = string_append(s, &size, &ptr, 2, US" CV=",
771 testflag(addr, af_cert_verified)? "yes":"no");
772 if ((log_extra_selector & LX_tls_peerdn) != 0 && addr->peerdn != NULL)
773 s = string_append(s, &size, &ptr, 3, US" DN=\"",
774 string_printing(addr->peerdn), US"\"");
777 if (addr->authenticator)
779 s = string_append(s, &size, &ptr, 2, US" A=", addr->authenticator);
782 s = string_append(s, &size, &ptr, 2, US":", addr->auth_id);
783 if (log_extra_selector & LX_smtp_mailauth && addr->auth_sndr)
784 s = string_append(s, &size, &ptr, 2, US":", addr->auth_sndr);
788 if ((log_extra_selector & LX_smtp_confirmation) != 0 &&
789 addr->message != NULL)
792 uschar *p = big_buffer;
793 uschar *ss = addr->message;
795 for (i = 0; i < 100 && ss[i] != 0; i++)
797 if (ss[i] == '\"' || ss[i] == '\\') *p++ = '\\';
802 s = string_append(s, &size, &ptr, 2, US" C=", big_buffer);
806 /* Time on queue and actual time taken to deliver */
808 if ((log_extra_selector & LX_queue_time) != 0)
810 s = string_append(s, &size, &ptr, 2, US" QT=",
811 readconf_printtime(time(NULL) - received_time));
814 if ((log_extra_selector & LX_deliver_time) != 0)
816 s = string_append(s, &size, &ptr, 2, US" DT=",
817 readconf_printtime(addr->more_errno));
820 /* string_cat() always leaves room for the terminator. Release the
821 store we used to build the line after writing it. */
824 log_write(0, flags, "%s", s);
825 store_reset(reset_point);
831 /*************************************************
832 * Actions at the end of handling an address *
833 *************************************************/
835 /* This is a function for processing a single address when all that can be done
836 with it has been done.
839 addr points to the address block
840 result the result of the delivery attempt
841 logflags flags for log_write() (LOG_MAIN and/or LOG_PANIC)
842 driver_type indicates which type of driver (transport, or router) was last
843 to process the address
844 logchar '=' or '-' for use when logging deliveries with => or ->
850 post_process_one(address_item *addr, int result, int logflags, int driver_type,
853 uschar *now = tod_stamp(tod_log);
854 uschar *driver_kind = NULL;
855 uschar *driver_name = NULL;
858 int size = 256; /* Used for a temporary, */
859 int ptr = 0; /* expanding buffer, for */
860 uschar *s; /* building log lines; */
861 void *reset_point; /* released afterwards. */
864 DEBUG(D_deliver) debug_printf("post-process %s (%d)\n", addr->address, result);
866 /* Set up driver kind and name for logging. Disable logging if the router or
867 transport has disabled it. */
869 if (driver_type == DTYPE_TRANSPORT)
871 if (addr->transport != NULL)
873 driver_name = addr->transport->name;
874 driver_kind = US" transport";
875 disable_logging = addr->transport->disable_logging;
877 else driver_kind = US"transporting";
879 else if (driver_type == DTYPE_ROUTER)
881 if (addr->router != NULL)
883 driver_name = addr->router->name;
884 driver_kind = US" router";
885 disable_logging = addr->router->disable_logging;
887 else driver_kind = US"routing";
890 /* If there's an error message set, ensure that it contains only printing
891 characters - it should, but occasionally things slip in and this at least
892 stops the log format from getting wrecked. We also scan the message for an LDAP
893 expansion item that has a password setting, and flatten the password. This is a
894 fudge, but I don't know a cleaner way of doing this. (If the item is badly
895 malformed, it won't ever have gone near LDAP.) */
897 if (addr->message != NULL)
899 addr->message = string_printing(addr->message);
900 if (((Ustrstr(addr->message, "failed to expand") != NULL) || (Ustrstr(addr->message, "expansion of ") != NULL)) &&
901 (Ustrstr(addr->message, "mysql") != NULL ||
902 Ustrstr(addr->message, "pgsql") != NULL ||
903 Ustrstr(addr->message, "sqlite") != NULL ||
904 Ustrstr(addr->message, "ldap:") != NULL ||
905 Ustrstr(addr->message, "ldapdn:") != NULL ||
906 Ustrstr(addr->message, "ldapm:") != NULL))
908 addr->message = string_sprintf("Temporary internal error");
912 /* If we used a transport that has one of the "return_output" options set, and
913 if it did in fact generate some output, then for return_output we treat the
914 message as failed if it was not already set that way, so that the output gets
915 returned to the sender, provided there is a sender to send it to. For
916 return_fail_output, do this only if the delivery failed. Otherwise we just
917 unlink the file, and remove the name so that if the delivery failed, we don't
918 try to send back an empty or unwanted file. The log_output options operate only
921 In any case, we close the message file, because we cannot afford to leave a
922 file-descriptor for one address while processing (maybe very many) others. */
924 if (addr->return_file >= 0 && addr->return_filename != NULL)
926 BOOL return_output = FALSE;
928 (void)EXIMfsync(addr->return_file);
930 /* If there is no output, do nothing. */
932 if (fstat(addr->return_file, &statbuf) == 0 && statbuf.st_size > 0)
934 transport_instance *tb = addr->transport;
936 /* Handle logging options */
938 if (tb->log_output || (result == FAIL && tb->log_fail_output) ||
939 (result == DEFER && tb->log_defer_output))
942 FILE *f = Ufopen(addr->return_filename, "rb");
944 log_write(0, LOG_MAIN|LOG_PANIC, "failed to open %s to log output "
945 "from %s transport: %s", addr->return_filename, tb->name,
949 s = US Ufgets(big_buffer, big_buffer_size, f);
952 uschar *p = big_buffer + Ustrlen(big_buffer);
953 while (p > big_buffer && isspace(p[-1])) p--;
955 s = string_printing(big_buffer);
956 log_write(0, LOG_MAIN, "<%s>: %s transport output: %s",
957 addr->address, tb->name, s);
963 /* Handle returning options, but only if there is an address to return
966 if (sender_address[0] != 0 || addr->p.errors_address != NULL)
968 if (tb->return_output)
970 addr->transport_return = result = FAIL;
971 if (addr->basic_errno == 0 && addr->message == NULL)
972 addr->message = US"return message generated";
973 return_output = TRUE;
976 if (tb->return_fail_output && result == FAIL) return_output = TRUE;
980 /* Get rid of the file unless it might be returned, but close it in
985 Uunlink(addr->return_filename);
986 addr->return_filename = NULL;
987 addr->return_file = -1;
990 (void)close(addr->return_file);
993 /* The sucess case happens only after delivery by a transport. */
997 addr->next = addr_succeed;
1000 /* Call address_done() to ensure that we don't deliver to this address again,
1001 and write appropriate things to the message log. If it is a child address, we
1002 call child_done() to scan the ancestors and mark them complete if this is the
1003 last child to complete. */
1005 address_done(addr, now);
1006 DEBUG(D_deliver) debug_printf("%s delivered\n", addr->address);
1008 if (addr->parent == NULL)
1010 deliver_msglog("%s %s: %s%s succeeded\n", now, addr->address,
1011 driver_name, driver_kind);
1015 deliver_msglog("%s %s <%s>: %s%s succeeded\n", now, addr->address,
1016 addr->parent->address, driver_name, driver_kind);
1017 child_done(addr, now);
1020 delivery_log(LOG_MAIN, addr, logchar, NULL);
1024 /* Soft failure, or local delivery process failed; freezing may be
1027 else if (result == DEFER || result == PANIC)
1029 if (result == PANIC) logflags |= LOG_PANIC;
1031 /* This puts them on the chain in reverse order. Do not change this, because
1032 the code for handling retries assumes that the one with the retry
1033 information is last. */
1035 addr->next = addr_defer;
1038 /* The only currently implemented special action is to freeze the
1039 message. Logging of this is done later, just before the -H file is
1042 if (addr->special_action == SPECIAL_FREEZE)
1044 deliver_freeze = TRUE;
1045 deliver_frozen_at = time(NULL);
1046 update_spool = TRUE;
1049 /* If doing a 2-stage queue run, we skip writing to either the message
1050 log or the main log for SMTP defers. */
1052 if (!queue_2stage || addr->basic_errno != 0)
1056 /* For errors of the type "retry time not reached" (also remotes skipped
1057 on queue run), logging is controlled by L_retry_defer. Note that this kind
1058 of error number is negative, and all the retry ones are less than any
1061 unsigned int use_log_selector = (addr->basic_errno <= ERRNO_RETRY_BASE)?
1064 /* Build up the line that is used for both the message log and the main
1067 s = reset_point = store_get(size);
1069 /* Create the address string for logging. Must not do this earlier, because
1070 an OK result may be changed to FAIL when a pipe returns text. */
1072 log_address = string_log_address(addr,
1073 (log_write_selector & L_all_parents) != 0, result == OK);
1075 s = string_cat(s, &size, &ptr, log_address, Ustrlen(log_address));
1077 /* Either driver_name contains something and driver_kind contains
1078 " router" or " transport" (note the leading space), or driver_name is
1079 a null string and driver_kind contains "routing" without the leading
1080 space, if all routing has been deferred. When a domain has been held,
1081 so nothing has been done at all, both variables contain null strings. */
1083 if (driver_name == NULL)
1085 if (driver_kind != NULL)
1086 s = string_append(s, &size, &ptr, 2, US" ", driver_kind);
1090 if (driver_kind[1] == 't' && addr->router != NULL)
1091 s = string_append(s, &size, &ptr, 2, US" R=", addr->router->name);
1093 ss[1] = toupper(driver_kind[1]);
1094 s = string_append(s, &size, &ptr, 2, ss, driver_name);
1097 sprintf(CS ss, " defer (%d)", addr->basic_errno);
1098 s = string_cat(s, &size, &ptr, ss, Ustrlen(ss));
1100 if (addr->basic_errno > 0)
1101 s = string_append(s, &size, &ptr, 2, US": ",
1102 US strerror(addr->basic_errno));
1104 if (addr->message != NULL)
1105 s = string_append(s, &size, &ptr, 2, US": ", addr->message);
1109 /* Log the deferment in the message log, but don't clutter it
1110 up with retry-time defers after the first delivery attempt. */
1112 if (deliver_firsttime || addr->basic_errno > ERRNO_RETRY_BASE)
1113 deliver_msglog("%s %s\n", now, s);
1115 /* Write the main log and reset the store */
1117 log_write(use_log_selector, logflags, "== %s", s);
1118 store_reset(reset_point);
1123 /* Hard failure. If there is an address to which an error message can be sent,
1124 put this address on the failed list. If not, put it on the deferred list and
1125 freeze the mail message for human attention. The latter action can also be
1126 explicitly requested by a router or transport. */
1130 /* If this is a delivery error, or a message for which no replies are
1131 wanted, and the message's age is greater than ignore_bounce_errors_after,
1132 force the af_ignore_error flag. This will cause the address to be discarded
1133 later (with a log entry). */
1135 if (sender_address[0] == 0 && message_age >= ignore_bounce_errors_after)
1136 setflag(addr, af_ignore_error);
1138 /* Freeze the message if requested, or if this is a bounce message (or other
1139 message with null sender) and this address does not have its own errors
1140 address. However, don't freeze if errors are being ignored. The actual code
1141 to ignore occurs later, instead of sending a message. Logging of freezing
1142 occurs later, just before writing the -H file. */
1144 if (!testflag(addr, af_ignore_error) &&
1145 (addr->special_action == SPECIAL_FREEZE ||
1146 (sender_address[0] == 0 && addr->p.errors_address == NULL)
1149 frozen_info = (addr->special_action == SPECIAL_FREEZE)? US"" :
1150 (sender_local && !local_error_message)?
1151 US" (message created with -f <>)" : US" (delivery error message)";
1152 deliver_freeze = TRUE;
1153 deliver_frozen_at = time(NULL);
1154 update_spool = TRUE;
1156 /* The address is put on the defer rather than the failed queue, because
1157 the message is being retained. */
1159 addr->next = addr_defer;
1163 /* Don't put the address on the nonrecipients tree yet; wait until an
1164 error message has been successfully sent. */
1168 addr->next = addr_failed;
1172 /* Build up the log line for the message and main logs */
1174 s = reset_point = store_get(size);
1176 /* Create the address string for logging. Must not do this earlier, because
1177 an OK result may be changed to FAIL when a pipe returns text. */
1179 log_address = string_log_address(addr,
1180 (log_write_selector & L_all_parents) != 0, result == OK);
1182 s = string_cat(s, &size, &ptr, log_address, Ustrlen(log_address));
1184 if ((log_extra_selector & LX_sender_on_delivery) != 0)
1185 s = string_append(s, &size, &ptr, 3, US" F=<", sender_address, US">");
1187 /* Return path may not be set if no delivery actually happened */
1189 if (used_return_path != NULL &&
1190 (log_extra_selector & LX_return_path_on_delivery) != 0)
1192 s = string_append(s, &size, &ptr, 3, US" P=<", used_return_path, US">");
1195 if (addr->router != NULL)
1196 s = string_append(s, &size, &ptr, 2, US" R=", addr->router->name);
1197 if (addr->transport != NULL)
1198 s = string_append(s, &size, &ptr, 2, US" T=", addr->transport->name);
1200 if (addr->host_used != NULL)
1201 s = string_append(s, &size, &ptr, 5, US" H=", addr->host_used->name,
1202 US" [", addr->host_used->address, US"]");
1204 if (addr->basic_errno > 0)
1205 s = string_append(s, &size, &ptr, 2, US": ",
1206 US strerror(addr->basic_errno));
1208 if (addr->message != NULL)
1209 s = string_append(s, &size, &ptr, 2, US": ", addr->message);
1213 /* Do the logging. For the message log, "routing failed" for those cases,
1214 just to make it clearer. */
1216 if (driver_name == NULL)
1217 deliver_msglog("%s %s failed for %s\n", now, driver_kind, s);
1219 deliver_msglog("%s %s\n", now, s);
1221 log_write(0, LOG_MAIN, "** %s", s);
1222 store_reset(reset_point);
1225 /* Ensure logging is turned on again in all cases */
1227 disable_logging = FALSE;
1233 /*************************************************
1234 * Address-independent error *
1235 *************************************************/
1237 /* This function is called when there's an error that is not dependent on a
1238 particular address, such as an expansion string failure. It puts the error into
1239 all the addresses in a batch, logs the incident on the main and panic logs, and
1240 clears the expansions. It is mostly called from local_deliver(), but can be
1241 called for a remote delivery via findugid().
1244 logit TRUE if (MAIN+PANIC) logging required
1245 addr the first of the chain of addresses
1247 format format string for error message, or NULL if already set in addr
1248 ... arguments for the format
1254 common_error(BOOL logit, address_item *addr, int code, uschar *format, ...)
1256 address_item *addr2;
1257 addr->basic_errno = code;
1263 va_start(ap, format);
1264 if (!string_vformat(buffer, sizeof(buffer), CS format, ap))
1265 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
1266 "common_error expansion was longer than " SIZE_T_FMT, sizeof(buffer));
1268 addr->message = string_copy(buffer);
1271 for (addr2 = addr->next; addr2 != NULL; addr2 = addr2->next)
1273 addr2->basic_errno = code;
1274 addr2->message = addr->message;
1277 if (logit) log_write(0, LOG_MAIN|LOG_PANIC, "%s", addr->message);
1278 deliver_set_expansions(NULL);
1284 /*************************************************
1285 * Check a "never users" list *
1286 *************************************************/
1288 /* This function is called to check whether a uid is on one of the two "never
1292 uid the uid to be checked
1293 nusers the list to be scanned; the first item in the list is the count
1295 Returns: TRUE if the uid is on the list
1299 check_never_users(uid_t uid, uid_t *nusers)
1302 if (nusers == NULL) return FALSE;
1303 for (i = 1; i <= (int)(nusers[0]); i++) if (nusers[i] == uid) return TRUE;
1309 /*************************************************
1310 * Find uid and gid for a transport *
1311 *************************************************/
1313 /* This function is called for both local and remote deliveries, to find the
1314 uid/gid under which to run the delivery. The values are taken preferentially
1315 from the transport (either explicit or deliver_as_creator), then from the
1316 address (i.e. the router), and if nothing is set, the exim uid/gid are used. If
1317 the resulting uid is on the "never_users" or the "fixed_never_users" list, a
1318 panic error is logged, and the function fails (which normally leads to delivery
1322 addr the address (possibly a chain)
1324 uidp pointer to uid field
1325 gidp pointer to gid field
1326 igfp pointer to the use_initgroups field
1328 Returns: FALSE if failed - error has been set in address(es)
1332 findugid(address_item *addr, transport_instance *tp, uid_t *uidp, gid_t *gidp,
1335 uschar *nuname = NULL;
1336 BOOL gid_set = FALSE;
1338 /* Default initgroups flag comes from the transport */
1340 *igfp = tp->initgroups;
1342 /* First see if there's a gid on the transport, either fixed or expandable.
1343 The expanding function always logs failure itself. */
1350 else if (tp->expand_gid != NULL)
1352 if (route_find_expanded_group(tp->expand_gid, tp->name, US"transport", gidp,
1353 &(addr->message))) gid_set = TRUE;
1356 common_error(FALSE, addr, ERRNO_GIDFAIL, NULL);
1361 /* If the transport did not set a group, see if the router did. */
1363 if (!gid_set && testflag(addr, af_gid_set))
1369 /* Pick up a uid from the transport if one is set. */
1371 if (tp->uid_set) *uidp = tp->uid;
1373 /* Otherwise, try for an expandable uid field. If it ends up as a numeric id,
1374 it does not provide a passwd value from which a gid can be taken. */
1376 else if (tp->expand_uid != NULL)
1379 if (!route_find_expanded_user(tp->expand_uid, tp->name, US"transport", &pw,
1380 uidp, &(addr->message)))
1382 common_error(FALSE, addr, ERRNO_UIDFAIL, NULL);
1385 if (!gid_set && pw != NULL)
1392 /* If the transport doesn't set the uid, test the deliver_as_creator flag. */
1394 else if (tp->deliver_as_creator)
1396 *uidp = originator_uid;
1399 *gidp = originator_gid;
1404 /* Otherwise see if the address specifies the uid and if so, take it and its
1407 else if (testflag(addr, af_uid_set))
1410 *igfp = testflag(addr, af_initgroups);
1413 /* Nothing has specified the uid - default to the Exim user, and group if the
1426 /* If no gid is set, it is a disaster. We default to the Exim gid only if
1427 defaulting to the Exim uid. In other words, if the configuration has specified
1428 a uid, it must also provide a gid. */
1432 common_error(TRUE, addr, ERRNO_GIDFAIL, US"User set without group for "
1433 "%s transport", tp->name);
1437 /* Check that the uid is not on the lists of banned uids that may not be used
1438 for delivery processes. */
1440 if (check_never_users(*uidp, never_users))
1441 nuname = US"never_users";
1442 else if (check_never_users(*uidp, fixed_never_users))
1443 nuname = US"fixed_never_users";
1447 common_error(TRUE, addr, ERRNO_UIDFAIL, US"User %ld set for %s transport "
1448 "is on the %s list", (long int)(*uidp), tp->name, nuname);
1460 /*************************************************
1461 * Check the size of a message for a transport *
1462 *************************************************/
1464 /* Checks that the message isn't too big for the selected transport.
1465 This is called only when it is known that the limit is set.
1469 addr the (first) address being delivered
1472 DEFER expansion failed or did not yield an integer
1473 FAIL message too big
1477 check_message_size(transport_instance *tp, address_item *addr)
1482 deliver_set_expansions(addr);
1483 size_limit = expand_string_integer(tp->message_size_limit, TRUE);
1484 deliver_set_expansions(NULL);
1486 if (expand_string_message != NULL)
1489 if (size_limit == -1)
1490 addr->message = string_sprintf("failed to expand message_size_limit "
1491 "in %s transport: %s", tp->name, expand_string_message);
1493 addr->message = string_sprintf("invalid message_size_limit "
1494 "in %s transport: %s", tp->name, expand_string_message);
1496 else if (size_limit > 0 && message_size > size_limit)
1500 string_sprintf("message is too big (transport limit = %d)",
1509 /*************************************************
1510 * Transport-time check for a previous delivery *
1511 *************************************************/
1513 /* Check that this base address hasn't previously been delivered to its routed
1514 transport. If it has been delivered, mark it done. The check is necessary at
1515 delivery time in order to handle homonymic addresses correctly in cases where
1516 the pattern of redirection changes between delivery attempts (so the unique
1517 fields change). Non-homonymic previous delivery is detected earlier, at routing
1518 time (which saves unnecessary routing).
1521 addr the address item
1522 testing TRUE if testing wanted only, without side effects
1524 Returns: TRUE if previously delivered by the transport
1528 previously_transported(address_item *addr, BOOL testing)
1530 (void)string_format(big_buffer, big_buffer_size, "%s/%s",
1531 addr->unique + (testflag(addr, af_homonym)? 3:0), addr->transport->name);
1533 if (tree_search(tree_nonrecipients, big_buffer) != 0)
1535 DEBUG(D_deliver|D_route|D_transport)
1536 debug_printf("%s was previously delivered (%s transport): discarded\n",
1537 addr->address, addr->transport->name);
1538 if (!testing) child_done(addr, tod_stamp(tod_log));
1547 /******************************************************
1548 * Check for a given header in a header string *
1549 ******************************************************/
1551 /* This function is used when generating quota warnings. The configuration may
1552 specify any header lines it likes in quota_warn_message. If certain of them are
1553 missing, defaults are inserted, so we need to be able to test for the presence
1557 hdr the required header name
1558 hstring the header string
1560 Returns: TRUE the header is in the string
1561 FALSE the header is not in the string
1565 contains_header(uschar *hdr, uschar *hstring)
1567 int len = Ustrlen(hdr);
1568 uschar *p = hstring;
1571 if (strncmpic(p, hdr, len) == 0)
1574 while (*p == ' ' || *p == '\t') p++;
1575 if (*p == ':') return TRUE;
1577 while (*p != 0 && *p != '\n') p++;
1578 if (*p == '\n') p++;
1586 /*************************************************
1587 * Perform a local delivery *
1588 *************************************************/
1590 /* Each local delivery is performed in a separate process which sets its
1591 uid and gid as specified. This is a safer way than simply changing and
1592 restoring using seteuid(); there is a body of opinion that seteuid() cannot be
1593 used safely. From release 4, Exim no longer makes any use of it. Besides, not
1594 all systems have seteuid().
1596 If the uid/gid are specified in the transport_instance, they are used; the
1597 transport initialization must ensure that either both or neither are set.
1598 Otherwise, the values associated with the address are used. If neither are set,
1599 it is a configuration error.
1601 The transport or the address may specify a home directory (transport over-
1602 rides), and if they do, this is set as $home. If neither have set a working
1603 directory, this value is used for that as well. Otherwise $home is left unset
1604 and the cwd is set to "/" - a directory that should be accessible to all users.
1606 Using a separate process makes it more complicated to get error information
1607 back. We use a pipe to pass the return code and also an error code and error
1608 text string back to the parent process.
1611 addr points to an address block for this delivery; for "normal" local
1612 deliveries this is the only address to be delivered, but for
1613 pseudo-remote deliveries (e.g. by batch SMTP to a file or pipe)
1614 a number of addresses can be handled simultaneously, and in this
1615 case addr will point to a chain of addresses with the same
1618 shadowing TRUE if running a shadow transport; this causes output from pipes
1625 deliver_local(address_item *addr, BOOL shadowing)
1627 BOOL use_initgroups;
1630 int status, len, rc;
1633 uschar *working_directory;
1634 address_item *addr2;
1635 transport_instance *tp = addr->transport;
1637 /* Set up the return path from the errors or sender address. If the transport
1638 has its own return path setting, expand it and replace the existing value. */
1640 if(addr->p.errors_address != NULL)
1641 return_path = addr->p.errors_address;
1642 #ifdef EXPERIMENTAL_SRS
1643 else if(addr->p.srs_sender != NULL)
1644 return_path = addr->p.srs_sender;
1647 return_path = sender_address;
1649 if (tp->return_path != NULL)
1651 uschar *new_return_path = expand_string(tp->return_path);
1652 if (new_return_path == NULL)
1654 if (!expand_string_forcedfail)
1656 common_error(TRUE, addr, ERRNO_EXPANDFAIL,
1657 US"Failed to expand return path \"%s\" in %s transport: %s",
1658 tp->return_path, tp->name, expand_string_message);
1662 else return_path = new_return_path;
1665 /* For local deliveries, one at a time, the value used for logging can just be
1666 set directly, once and for all. */
1668 used_return_path = return_path;
1670 /* Sort out the uid, gid, and initgroups flag. If an error occurs, the message
1671 gets put into the address(es), and the expansions are unset, so we can just
1674 if (!findugid(addr, tp, &uid, &gid, &use_initgroups)) return;
1676 /* See if either the transport or the address specifies a home directory. A
1677 home directory set in the address may already be expanded; a flag is set to
1678 indicate that. In other cases we must expand it. */
1680 if ((deliver_home = tp->home_dir) != NULL || /* Set in transport, or */
1681 ((deliver_home = addr->home_dir) != NULL && /* Set in address and */
1682 !testflag(addr, af_home_expanded))) /* not expanded */
1684 uschar *rawhome = deliver_home;
1685 deliver_home = NULL; /* in case it contains $home */
1686 deliver_home = expand_string(rawhome);
1687 if (deliver_home == NULL)
1689 common_error(TRUE, addr, ERRNO_EXPANDFAIL, US"home directory \"%s\" failed "
1690 "to expand for %s transport: %s", rawhome, tp->name,
1691 expand_string_message);
1694 if (*deliver_home != '/')
1696 common_error(TRUE, addr, ERRNO_NOTABSOLUTE, US"home directory path \"%s\" "
1697 "is not absolute for %s transport", deliver_home, tp->name);
1702 /* See if either the transport or the address specifies a current directory,
1703 and if so, expand it. If nothing is set, use the home directory, unless it is
1704 also unset in which case use "/", which is assumed to be a directory to which
1705 all users have access. It is necessary to be in a visible directory for some
1706 operating systems when running pipes, as some commands (e.g. "rm" under Solaris
1707 2.5) require this. */
1709 working_directory = (tp->current_dir != NULL)?
1710 tp->current_dir : addr->current_dir;
1712 if (working_directory != NULL)
1714 uschar *raw = working_directory;
1715 working_directory = expand_string(raw);
1716 if (working_directory == NULL)
1718 common_error(TRUE, addr, ERRNO_EXPANDFAIL, US"current directory \"%s\" "
1719 "failed to expand for %s transport: %s", raw, tp->name,
1720 expand_string_message);
1723 if (*working_directory != '/')
1725 common_error(TRUE, addr, ERRNO_NOTABSOLUTE, US"current directory path "
1726 "\"%s\" is not absolute for %s transport", working_directory, tp->name);
1730 else working_directory = (deliver_home == NULL)? US"/" : deliver_home;
1732 /* If one of the return_output flags is set on the transport, create and open a
1733 file in the message log directory for the transport to write its output onto.
1734 This is mainly used by pipe transports. The file needs to be unique to the
1735 address. This feature is not available for shadow transports. */
1737 if (!shadowing && (tp->return_output || tp->return_fail_output ||
1738 tp->log_output || tp->log_fail_output))
1741 addr->return_filename =
1742 string_sprintf("%s/msglog/%s/%s-%d-%d", spool_directory, message_subdir,
1743 message_id, getpid(), return_count++);
1744 addr->return_file = open_msglog_file(addr->return_filename, 0400, &error);
1745 if (addr->return_file < 0)
1747 common_error(TRUE, addr, errno, US"Unable to %s file for %s transport "
1748 "to return message: %s", error, tp->name, strerror(errno));
1753 /* Create the pipe for inter-process communication. */
1757 common_error(TRUE, addr, ERRNO_PIPEFAIL, US"Creation of pipe failed: %s",
1762 /* Now fork the process to do the real work in the subprocess, but first
1763 ensure that all cached resources are freed so that the subprocess starts with
1764 a clean slate and doesn't interfere with the parent process. */
1768 if ((pid = fork()) == 0)
1770 BOOL replicate = TRUE;
1772 /* Prevent core dumps, as we don't want them in users' home directories.
1773 HP-UX doesn't have RLIMIT_CORE; I don't know how to do this in that
1774 system. Some experimental/developing systems (e.g. GNU/Hurd) may define
1775 RLIMIT_CORE but not support it in setrlimit(). For such systems, do not
1776 complain if the error is "not supported".
1778 There are two scenarios where changing the max limit has an effect. In one,
1779 the user is using a .forward and invoking a command of their choice via pipe;
1780 for these, we do need the max limit to be 0 unless the admin chooses to
1781 permit an increased limit. In the other, the command is invoked directly by
1782 the transport and is under administrator control, thus being able to raise
1783 the limit aids in debugging. So there's no general always-right answer.
1785 Thus we inhibit core-dumps completely but let individual transports, while
1786 still root, re-raise the limits back up to aid debugging. We make the
1787 default be no core-dumps -- few enough people can use core dumps in
1788 diagnosis that it's reasonable to make them something that has to be explicitly requested.
1795 if (setrlimit(RLIMIT_CORE, &rl) < 0)
1797 #ifdef SETRLIMIT_NOT_SUPPORTED
1798 if (errno != ENOSYS && errno != ENOTSUP)
1800 log_write(0, LOG_MAIN|LOG_PANIC, "setrlimit(RLIMIT_CORE) failed: %s",
1805 /* Reset the random number generator, so different processes don't all
1806 have the same sequence. */
1810 /* If the transport has a setup entry, call this first, while still
1811 privileged. (Appendfile uses this to expand quota, for example, while
1812 able to read private files.) */
1814 if (addr->transport->setup != NULL)
1816 switch((addr->transport->setup)(addr->transport, addr, NULL, uid, gid,
1820 addr->transport_return = DEFER;
1824 addr->transport_return = PANIC;
1829 /* Ignore SIGINT and SIGTERM during delivery. Also ignore SIGUSR1, as
1830 when the process becomes unprivileged, it won't be able to write to the
1831 process log. SIGHUP is ignored throughout exim, except when it is being
1834 signal(SIGINT, SIG_IGN);
1835 signal(SIGTERM, SIG_IGN);
1836 signal(SIGUSR1, SIG_IGN);
1838 /* Close the unwanted half of the pipe, and set close-on-exec for the other
1839 half - for transports that exec things (e.g. pipe). Then set the required
1842 (void)close(pfd[pipe_read]);
1843 (void)fcntl(pfd[pipe_write], F_SETFD, fcntl(pfd[pipe_write], F_GETFD) |
1845 exim_setugid(uid, gid, use_initgroups,
1846 string_sprintf("local delivery to %s <%s> transport=%s", addr->local_part,
1847 addr->address, addr->transport->name));
1851 address_item *batched;
1852 debug_printf(" home=%s current=%s\n", deliver_home, working_directory);
1853 for (batched = addr->next; batched != NULL; batched = batched->next)
1854 debug_printf("additional batched address: %s\n", batched->address);
1857 /* Set an appropriate working directory. */
1859 if (Uchdir(working_directory) < 0)
1861 addr->transport_return = DEFER;
1862 addr->basic_errno = errno;
1863 addr->message = string_sprintf("failed to chdir to %s", working_directory);
1866 /* If successful, call the transport */
1871 set_process_info("delivering %s to %s using %s", message_id,
1872 addr->local_part, addr->transport->name);
1874 /* If a transport filter has been specified, set up its argument list.
1875 Any errors will get put into the address, and FALSE yielded. */
1877 if (addr->transport->filter_command != NULL)
1879 ok = transport_set_up_command(&transport_filter_argv,
1880 addr->transport->filter_command,
1881 TRUE, PANIC, addr, US"transport filter", NULL);
1882 transport_filter_timeout = addr->transport->filter_timeout;
1884 else transport_filter_argv = NULL;
1888 debug_print_string(addr->transport->debug_string);
1889 replicate = !(addr->transport->info->code)(addr->transport, addr);
1893 /* Pass the results back down the pipe. If necessary, first replicate the
1894 status in the top address to the others in the batch. The label is the
1895 subject of a goto when a call to the transport's setup function fails. We
1896 pass the pointer to the transport back in case it got changed as a result of
1897 file_format in appendfile. */
1901 if (replicate) replicate_status(addr);
1902 for (addr2 = addr; addr2 != NULL; addr2 = addr2->next)
1905 int local_part_length = Ustrlen(addr2->local_part);
1909 if( (ret = write(pfd[pipe_write], (void *)&(addr2->transport_return), sizeof(int))) != sizeof(int)
1910 || (ret = write(pfd[pipe_write], (void *)&transport_count, sizeof(transport_count))) != sizeof(transport_count)
1911 || (ret = write(pfd[pipe_write], (void *)&(addr2->flags), sizeof(addr2->flags))) != sizeof(addr2->flags)
1912 || (ret = write(pfd[pipe_write], (void *)&(addr2->basic_errno), sizeof(int))) != sizeof(int)
1913 || (ret = write(pfd[pipe_write], (void *)&(addr2->more_errno), sizeof(int))) != sizeof(int)
1914 || (ret = write(pfd[pipe_write], (void *)&(addr2->special_action), sizeof(int))) != sizeof(int)
1915 || (ret = write(pfd[pipe_write], (void *)&(addr2->transport),
1916 sizeof(transport_instance *))) != sizeof(transport_instance *)
1918 /* For a file delivery, pass back the local part, in case the original
1919 was only part of the final delivery path. This gives more complete
1922 || (testflag(addr2, af_file)
1923 && ( (ret = write(pfd[pipe_write], (void *)&local_part_length, sizeof(int))) != sizeof(int)
1924 || (ret = write(pfd[pipe_write], addr2->local_part, local_part_length)) != local_part_length
1928 log_write(0, LOG_MAIN|LOG_PANIC, "Failed writing transport results to pipe: %s\n",
1929 ret == -1 ? strerror(errno) : "short write");
1931 /* Now any messages */
1933 for (i = 0, s = addr2->message; i < 2; i++, s = addr2->user_message)
1935 int message_length = (s == NULL)? 0 : Ustrlen(s) + 1;
1936 if( (ret = write(pfd[pipe_write], (void *)&message_length, sizeof(int))) != sizeof(int)
1937 || (message_length > 0 && (ret = write(pfd[pipe_write], s, message_length)) != message_length)
1939 log_write(0, LOG_MAIN|LOG_PANIC, "Failed writing transport results to pipe: %s\n",
1940 ret == -1 ? strerror(errno) : "short write");
1944 /* OK, this process is now done. Free any cached resources that it opened,
1945 and close the pipe we were writing down before exiting. */
1947 (void)close(pfd[pipe_write]);
1952 /* Back in the main process: panic if the fork did not succeed. This seems
1953 better than returning an error - if forking is failing it is probably best
1954 not to try other deliveries for this message. */
1957 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Fork failed for local delivery to %s",
1960 /* Read the pipe to get the delivery status codes and error messages. Our copy
1961 of the writing end must be closed first, as otherwise read() won't return zero
1962 on an empty pipe. We check that a status exists for each address before
1963 overwriting the address structure. If data is missing, the default DEFER status
1964 will remain. Afterwards, close the reading end. */
1966 (void)close(pfd[pipe_write]);
1968 for (addr2 = addr; addr2 != NULL; addr2 = addr2->next)
1970 len = read(pfd[pipe_read], (void *)&status, sizeof(int));
1976 addr2->transport_return = status;
1977 len = read(pfd[pipe_read], (void *)&transport_count,
1978 sizeof(transport_count));
1979 len = read(pfd[pipe_read], (void *)&(addr2->flags), sizeof(addr2->flags));
1980 len = read(pfd[pipe_read], (void *)&(addr2->basic_errno), sizeof(int));
1981 len = read(pfd[pipe_read], (void *)&(addr2->more_errno), sizeof(int));
1982 len = read(pfd[pipe_read], (void *)&(addr2->special_action), sizeof(int));
1983 len = read(pfd[pipe_read], (void *)&(addr2->transport),
1984 sizeof(transport_instance *));
1986 if (testflag(addr2, af_file))
1988 int local_part_length;
1989 len = read(pfd[pipe_read], (void *)&local_part_length, sizeof(int));
1990 len = read(pfd[pipe_read], (void *)big_buffer, local_part_length);
1991 big_buffer[local_part_length] = 0;
1992 addr2->local_part = string_copy(big_buffer);
1995 for (i = 0, sptr = &(addr2->message); i < 2;
1996 i++, sptr = &(addr2->user_message))
1999 len = read(pfd[pipe_read], (void *)&message_length, sizeof(int));
2000 if (message_length > 0)
2002 len = read(pfd[pipe_read], (void *)big_buffer, message_length);
2003 if (len > 0) *sptr = string_copy(big_buffer);
2010 log_write(0, LOG_MAIN|LOG_PANIC, "failed to read delivery status for %s "
2011 "from delivery subprocess", addr2->unique);
2016 (void)close(pfd[pipe_read]);
2018 /* Unless shadowing, write all successful addresses immediately to the journal
2019 file, to ensure they are recorded asap. For homonymic addresses, use the base
2020 address plus the transport name. Failure to write the journal is panic-worthy,
2021 but don't stop, as it may prove possible subsequently to update the spool file
2022 in order to record the delivery. */
2026 for (addr2 = addr; addr2 != NULL; addr2 = addr2->next)
2028 if (addr2->transport_return != OK) continue;
2030 if (testflag(addr2, af_homonym))
2031 sprintf(CS big_buffer, "%.500s/%s\n", addr2->unique + 3, tp->name);
2033 sprintf(CS big_buffer, "%.500s\n", addr2->unique);
2035 /* In the test harness, wait just a bit to let the subprocess finish off
2036 any debug output etc first. */
2038 if (running_in_test_harness) millisleep(300);
2040 DEBUG(D_deliver) debug_printf("journalling %s", big_buffer);
2041 len = Ustrlen(big_buffer);
2042 if (write(journal_fd, big_buffer, len) != len)
2043 log_write(0, LOG_MAIN|LOG_PANIC, "failed to update journal for %s: %s",
2044 big_buffer, strerror(errno));
2047 /* Ensure the journal file is pushed out to disk. */
2049 if (EXIMfsync(journal_fd) < 0)
2050 log_write(0, LOG_MAIN|LOG_PANIC, "failed to fsync journal: %s",
2054 /* Wait for the process to finish. If it terminates with a non-zero code,
2055 freeze the message (except for SIGTERM, SIGKILL and SIGQUIT), but leave the
2056 status values of all the addresses as they are. Take care to handle the case
2057 when the subprocess doesn't seem to exist. This has been seen on one system
2058 when Exim was called from an MUA that set SIGCHLD to SIG_IGN. When that
2059 happens, wait() doesn't recognize the termination of child processes. Exim now
2060 resets SIGCHLD to SIG_DFL, but this code should still be robust. */
2062 while ((rc = wait(&status)) != pid)
2064 if (rc < 0 && errno == ECHILD) /* Process has vanished */
2066 log_write(0, LOG_MAIN, "%s transport process vanished unexpectedly",
2067 addr->transport->driver_name);
2073 if ((status & 0xffff) != 0)
2075 int msb = (status >> 8) & 255;
2076 int lsb = status & 255;
2077 int code = (msb == 0)? (lsb & 0x7f) : msb;
2078 if (msb != 0 || (code != SIGTERM && code != SIGKILL && code != SIGQUIT))
2079 addr->special_action = SPECIAL_FREEZE;
2080 log_write(0, LOG_MAIN|LOG_PANIC, "%s transport process returned non-zero "
2081 "status 0x%04x: %s %d",
2082 addr->transport->driver_name,
2084 (msb == 0)? "terminated by signal" : "exit code",
2088 /* If SPECIAL_WARN is set in the top address, send a warning message. */
2090 if (addr->special_action == SPECIAL_WARN &&
2091 addr->transport->warn_message != NULL)
2094 uschar *warn_message;
2096 DEBUG(D_deliver) debug_printf("Warning message requested by transport\n");
2098 warn_message = expand_string(addr->transport->warn_message);
2099 if (warn_message == NULL)
2100 log_write(0, LOG_MAIN|LOG_PANIC, "Failed to expand \"%s\" (warning "
2101 "message for %s transport): %s", addr->transport->warn_message,
2102 addr->transport->name, expand_string_message);
2105 pid_t pid = child_open_exim(&fd);
2108 FILE *f = fdopen(fd, "wb");
2109 if (errors_reply_to != NULL &&
2110 !contains_header(US"Reply-To", warn_message))
2111 fprintf(f, "Reply-To: %s\n", errors_reply_to);
2112 fprintf(f, "Auto-Submitted: auto-replied\n");
2113 if (!contains_header(US"From", warn_message)) moan_write_from(f);
2114 fprintf(f, "%s", CS warn_message);
2116 /* Close and wait for child process to complete, without a timeout. */
2119 (void)child_close(pid, 0);
2123 addr->special_action = SPECIAL_NONE;
2129 /*************************************************
2130 * Do local deliveries *
2131 *************************************************/
2133 /* This function processes the list of addresses in addr_local. True local
2134 deliveries are always done one address at a time. However, local deliveries can
2135 be batched up in some cases. Typically this is when writing batched SMTP output
2136 files for use by some external transport mechanism, or when running local
2137 deliveries over LMTP.
2144 do_local_deliveries(void)
2147 open_db *dbm_file = NULL;
2148 time_t now = time(NULL);
2150 /* Loop until we have exhausted the supply of local deliveries */
2152 while (addr_local != NULL)
2154 time_t delivery_start;
2156 address_item *addr2, *addr3, *nextaddr;
2157 int logflags = LOG_MAIN;
2158 int logchar = dont_deliver? '*' : '=';
2159 transport_instance *tp;
2161 /* Pick the first undelivered address off the chain */
2163 address_item *addr = addr_local;
2164 addr_local = addr->next;
2167 DEBUG(D_deliver|D_transport)
2168 debug_printf("--------> %s <--------\n", addr->address);
2170 /* An internal disaster if there is no transport. Should not occur! */
2172 if ((tp = addr->transport) == NULL)
2174 logflags |= LOG_PANIC;
2175 disable_logging = FALSE; /* Jic */
2177 (addr->router != NULL)?
2178 string_sprintf("No transport set by %s router", addr->router->name)
2180 string_sprintf("No transport set by system filter");
2181 post_process_one(addr, DEFER, logflags, DTYPE_TRANSPORT, 0);
2185 /* Check that this base address hasn't previously been delivered to this
2186 transport. The check is necessary at this point to handle homonymic addresses
2187 correctly in cases where the pattern of redirection changes between delivery
2188 attempts. Non-homonymic previous delivery is detected earlier, at routing
2191 if (previously_transported(addr, FALSE)) continue;
2193 /* There are weird cases where logging is disabled */
2195 disable_logging = tp->disable_logging;
2197 /* Check for batched addresses and possible amalgamation. Skip all the work
2198 if either batch_max <= 1 or there aren't any other addresses for local
2201 if (tp->batch_max > 1 && addr_local != NULL)
2203 int batch_count = 1;
2204 BOOL uses_dom = readconf_depends((driver_instance *)tp, US"domain");
2205 BOOL uses_lp = (testflag(addr, af_pfr) &&
2206 (testflag(addr, af_file) || addr->local_part[0] == '|')) ||
2207 readconf_depends((driver_instance *)tp, US"local_part");
2208 uschar *batch_id = NULL;
2209 address_item **anchor = &addr_local;
2210 address_item *last = addr;
2213 /* Expand the batch_id string for comparison with other addresses.
2214 Expansion failure suppresses batching. */
2216 if (tp->batch_id != NULL)
2218 deliver_set_expansions(addr);
2219 batch_id = expand_string(tp->batch_id);
2220 deliver_set_expansions(NULL);
2221 if (batch_id == NULL)
2223 log_write(0, LOG_MAIN|LOG_PANIC, "Failed to expand batch_id option "
2224 "in %s transport (%s): %s", tp->name, addr->address,
2225 expand_string_message);
2226 batch_count = tp->batch_max;
2230 /* Until we reach the batch_max limit, pick off addresses which have the
2231 same characteristics. These are:
2234 not previously delivered (see comment about 50 lines above)
2235 same local part if the transport's configuration contains $local_part
2236 or if this is a file or pipe delivery from a redirection
2237 same domain if the transport's configuration contains $domain
2239 same additional headers
2240 same headers to be removed
2241 same uid/gid for running the transport
2242 same first host if a host list is set
2245 while ((next = *anchor) != NULL && batch_count < tp->batch_max)
2248 tp == next->transport &&
2249 !previously_transported(next, TRUE) &&
2250 (addr->flags & (af_pfr|af_file)) == (next->flags & (af_pfr|af_file)) &&
2251 (!uses_lp || Ustrcmp(next->local_part, addr->local_part) == 0) &&
2252 (!uses_dom || Ustrcmp(next->domain, addr->domain) == 0) &&
2253 same_strings(next->p.errors_address, addr->p.errors_address) &&
2254 same_headers(next->p.extra_headers, addr->p.extra_headers) &&
2255 same_strings(next->p.remove_headers, addr->p.remove_headers) &&
2256 same_ugid(tp, addr, next) &&
2257 ((addr->host_list == NULL && next->host_list == NULL) ||
2258 (addr->host_list != NULL && next->host_list != NULL &&
2259 Ustrcmp(addr->host_list->name, next->host_list->name) == 0));
2261 /* If the transport has a batch_id setting, batch_id will be non-NULL
2262 from the expansion outside the loop. Expand for this address and compare.
2263 Expansion failure makes this address ineligible for batching. */
2265 if (ok && batch_id != NULL)
2268 address_item *save_nextnext = next->next;
2269 next->next = NULL; /* Expansion for a single address */
2270 deliver_set_expansions(next);
2271 next->next = save_nextnext;
2272 bid = expand_string(tp->batch_id);
2273 deliver_set_expansions(NULL);
2276 log_write(0, LOG_MAIN|LOG_PANIC, "Failed to expand batch_id option "
2277 "in %s transport (%s): %s", tp->name, next->address,
2278 expand_string_message);
2281 else ok = (Ustrcmp(batch_id, bid) == 0);
2284 /* Take address into batch if OK. */
2288 *anchor = next->next; /* Include the address */
2294 else anchor = &(next->next); /* Skip the address */
2298 /* We now have one or more addresses that can be delivered in a batch. Check
2299 whether the transport is prepared to accept a message of this size. If not,
2300 fail them all forthwith. If the expansion fails, or does not yield an
2301 integer, defer delivery. */
2303 if (tp->message_size_limit != NULL)
2305 int rc = check_message_size(tp, addr);
2308 replicate_status(addr);
2309 while (addr != NULL)
2312 post_process_one(addr, rc, logflags, DTYPE_TRANSPORT, 0);
2315 continue; /* With next batch of addresses */
2319 /* If we are not running the queue, or if forcing, all deliveries will be
2320 attempted. Otherwise, we must respect the retry times for each address. Even
2321 when not doing this, we need to set up the retry key string, and determine
2322 whether a retry record exists, because after a successful delivery, a delete
2323 retry item must be set up. Keep the retry database open only for the duration
2324 of these checks, rather than for all local deliveries, because some local
2325 deliveries (e.g. to pipes) can take a substantial time. */
2327 dbm_file = dbfn_open(US"retry", O_RDONLY, &dbblock, FALSE);
2328 if (dbm_file == NULL)
2330 DEBUG(D_deliver|D_retry|D_hints_lookup)
2331 debug_printf("no retry data available\n");
2336 while (addr2 != NULL)
2338 BOOL ok = TRUE; /* to deliver this address */
2341 /* Set up the retry key to include the domain or not, and change its
2342 leading character from "R" to "T". Must make a copy before doing this,
2343 because the old key may be pointed to from a "delete" retry item after
2346 retry_key = string_copy(
2347 (tp->retry_use_local_part)? addr2->address_retry_key :
2348 addr2->domain_retry_key);
2351 /* Inspect the retry data. If there is no hints file, delivery happens. */
2353 if (dbm_file != NULL)
2355 dbdata_retry *retry_record = dbfn_read(dbm_file, retry_key);
2357 /* If there is no retry record, delivery happens. If there is,
2358 remember it exists so it can be deleted after a successful delivery. */
2360 if (retry_record != NULL)
2362 setflag(addr2, af_lt_retry_exists);
2364 /* A retry record exists for this address. If queue running and not
2365 forcing, inspect its contents. If the record is too old, or if its
2366 retry time has come, or if it has passed its cutoff time, delivery
2371 debug_printf("retry record exists: age=%s ",
2372 readconf_printtime(now - retry_record->time_stamp));
2373 debug_printf("(max %s)\n", readconf_printtime(retry_data_expire));
2374 debug_printf(" time to retry = %s expired = %d\n",
2375 readconf_printtime(retry_record->next_try - now),
2376 retry_record->expired);
2379 if (queue_running && !deliver_force)
2381 ok = (now - retry_record->time_stamp > retry_data_expire) ||
2382 (now >= retry_record->next_try) ||
2383 retry_record->expired;
2385 /* If we haven't reached the retry time, there is one more check
2386 to do, which is for the ultimate address timeout. We also do this
2387 check during routing so this one might be redundant... */
2390 ok = retry_ultimate_address_timeout(retry_key, addr2->domain,
2394 else DEBUG(D_retry) debug_printf("no retry record exists\n");
2397 /* This address is to be delivered. Leave it on the chain. */
2402 addr2 = addr2->next;
2405 /* This address is to be deferred. Take it out of the chain, and
2406 post-process it as complete. Must take it out of the chain first,
2407 because post processing puts it on another chain. */
2411 address_item *this = addr2;
2412 this->message = US"Retry time not yet reached";
2413 this->basic_errno = ERRNO_LRETRY;
2414 if (addr3 == NULL) addr2 = addr = addr2->next;
2415 else addr2 = addr3->next = addr2->next;
2416 post_process_one(this, DEFER, logflags, DTYPE_TRANSPORT, 0);
2420 if (dbm_file != NULL) dbfn_close(dbm_file);
2422 /* If there are no addresses left on the chain, they all deferred. Loop
2423 for the next set of addresses. */
2425 if (addr == NULL) continue;
2427 /* So, finally, we do have some addresses that can be passed to the
2428 transport. Before doing so, set up variables that are relevant to a
2431 deliver_set_expansions(addr);
2432 delivery_start = time(NULL);
2433 deliver_local(addr, FALSE);
2434 deliver_time = (int)(time(NULL) - delivery_start);
2436 /* If a shadow transport (which must perforce be another local transport), is
2437 defined, and its condition is met, we must pass the message to the shadow
2438 too, but only those addresses that succeeded. We do this by making a new
2439 chain of addresses - also to keep the original chain uncontaminated. We must
2440 use a chain rather than doing it one by one, because the shadow transport may
2443 NOTE: if the condition fails because of a lookup defer, there is nothing we
2446 if (tp->shadow != NULL &&
2447 (tp->shadow_condition == NULL ||
2448 expand_check_condition(tp->shadow_condition, tp->name, US"transport")))
2450 transport_instance *stp;
2451 address_item *shadow_addr = NULL;
2452 address_item **last = &shadow_addr;
2454 for (stp = transports; stp != NULL; stp = stp->next)
2455 if (Ustrcmp(stp->name, tp->shadow) == 0) break;
2458 log_write(0, LOG_MAIN|LOG_PANIC, "shadow transport \"%s\" not found ",
2461 /* Pick off the addresses that have succeeded, and make clones. Put into
2462 the shadow_message field a pointer to the shadow_message field of the real
2465 else for (addr2 = addr; addr2 != NULL; addr2 = addr2->next)
2467 if (addr2->transport_return != OK) continue;
2468 addr3 = store_get(sizeof(address_item));
2471 addr3->shadow_message = (uschar *)(&(addr2->shadow_message));
2472 addr3->transport = stp;
2473 addr3->transport_return = DEFER;
2474 addr3->return_filename = NULL;
2475 addr3->return_file = -1;
2477 last = &(addr3->next);
2480 /* If we found any addresses to shadow, run the delivery, and stick any
2481 message back into the shadow_message field in the original. */
2483 if (shadow_addr != NULL)
2485 int save_count = transport_count;
2487 DEBUG(D_deliver|D_transport)
2488 debug_printf(">>>>>>>>>>>>>>>> Shadow delivery >>>>>>>>>>>>>>>>\n");
2489 deliver_local(shadow_addr, TRUE);
2491 for(; shadow_addr != NULL; shadow_addr = shadow_addr->next)
2493 int sresult = shadow_addr->transport_return;
2494 *((uschar **)(shadow_addr->shadow_message)) = (sresult == OK)?
2495 string_sprintf(" ST=%s", stp->name) :
2496 string_sprintf(" ST=%s (%s%s%s)", stp->name,
2497 (shadow_addr->basic_errno <= 0)?
2498 US"" : US strerror(shadow_addr->basic_errno),
2499 (shadow_addr->basic_errno <= 0 || shadow_addr->message == NULL)?
2501 (shadow_addr->message != NULL)? shadow_addr->message :
2502 (shadow_addr->basic_errno <= 0)? US"unknown error" : US"");
2504 DEBUG(D_deliver|D_transport)
2505 debug_printf("%s shadow transport returned %s for %s\n",
2507 (sresult == OK)? "OK" :
2508 (sresult == DEFER)? "DEFER" :
2509 (sresult == FAIL)? "FAIL" :
2510 (sresult == PANIC)? "PANIC" : "?",
2511 shadow_addr->address);
2514 DEBUG(D_deliver|D_transport)
2515 debug_printf(">>>>>>>>>>>>>>>> End shadow delivery >>>>>>>>>>>>>>>>\n");
2517 transport_count = save_count; /* Restore original transport count */
2521 /* Cancel the expansions that were set up for the delivery. */
2523 deliver_set_expansions(NULL);
2525 /* Now we can process the results of the real transport. We must take each
2526 address off the chain first, because post_process_one() puts it on another
2529 for (addr2 = addr; addr2 != NULL; addr2 = nextaddr)
2531 int result = addr2->transport_return;
2532 nextaddr = addr2->next;
2534 DEBUG(D_deliver|D_transport)
2535 debug_printf("%s transport returned %s for %s\n",
2537 (result == OK)? "OK" :
2538 (result == DEFER)? "DEFER" :
2539 (result == FAIL)? "FAIL" :
2540 (result == PANIC)? "PANIC" : "?",
2543 /* If there is a retry_record, or if delivery is deferred, build a retry
2544 item for setting a new retry time or deleting the old retry record from
2545 the database. These items are handled all together after all addresses
2546 have been handled (so the database is open just for a short time for
2549 if (result == DEFER || testflag(addr2, af_lt_retry_exists))
2551 int flags = (result == DEFER)? 0 : rf_delete;
2552 uschar *retry_key = string_copy((tp->retry_use_local_part)?
2553 addr2->address_retry_key : addr2->domain_retry_key);
2555 retry_add_item(addr2, retry_key, flags);
2558 /* Done with this address */
2560 if (result == OK) addr2->more_errno = deliver_time;
2561 post_process_one(addr2, result, logflags, DTYPE_TRANSPORT, logchar);
2563 /* If a pipe delivery generated text to be sent back, the result may be
2564 changed to FAIL, and we must copy this for subsequent addresses in the
2567 if (addr2->transport_return != result)
2569 for (addr3 = nextaddr; addr3 != NULL; addr3 = addr3->next)
2571 addr3->transport_return = addr2->transport_return;
2572 addr3->basic_errno = addr2->basic_errno;
2573 addr3->message = addr2->message;
2575 result = addr2->transport_return;
2578 /* Whether or not the result was changed to FAIL, we need to copy the
2579 return_file value from the first address into all the addresses of the
2580 batch, so they are all listed in the error message. */
2582 addr2->return_file = addr->return_file;
2584 /* Change log character for recording successful deliveries. */
2586 if (result == OK) logchar = '-';
2588 } /* Loop back for next batch of addresses */
2594 /*************************************************
2595 * Sort remote deliveries *
2596 *************************************************/
2598 /* This function is called if remote_sort_domains is set. It arranges that the
2599 chain of addresses for remote deliveries is ordered according to the strings
2600 specified. Try to make this shuffling reasonably efficient by handling
2601 sequences of addresses rather than just single ones.
2608 sort_remote_deliveries(void)
2611 address_item **aptr = &addr_remote;
2612 uschar *listptr = remote_sort_domains;
2616 while (*aptr != NULL &&
2617 (pattern = string_nextinlist(&listptr, &sep, patbuf, sizeof(patbuf)))
2620 address_item *moved = NULL;
2621 address_item **bptr = &moved;
2623 while (*aptr != NULL)
2625 address_item **next;
2626 deliver_domain = (*aptr)->domain; /* set $domain */
2627 if (match_isinlist(deliver_domain, &pattern, UCHAR_MAX+1,
2628 &domainlist_anchor, NULL, MCL_DOMAIN, TRUE, NULL) == OK)
2630 aptr = &((*aptr)->next);
2634 next = &((*aptr)->next);
2635 while (*next != NULL &&
2636 (deliver_domain = (*next)->domain, /* Set $domain */
2637 match_isinlist(deliver_domain, &pattern, UCHAR_MAX+1,
2638 &domainlist_anchor, NULL, MCL_DOMAIN, TRUE, NULL)) != OK)
2639 next = &((*next)->next);
2641 /* If the batch of non-matchers is at the end, add on any that were
2642 extracted further up the chain, and end this iteration. Otherwise,
2643 extract them from the chain and hang on the moved chain. */
2655 aptr = &((*aptr)->next);
2658 /* If the loop ended because the final address matched, *aptr will
2659 be NULL. Add on to the end any extracted non-matching addresses. If
2660 *aptr is not NULL, the loop ended via "break" when *next is null, that
2661 is, there was a string of non-matching addresses at the end. In this
2662 case the extracted addresses have already been added on the end. */
2664 if (*aptr == NULL) *aptr = moved;
2670 debug_printf("remote addresses after sorting:\n");
2671 for (addr = addr_remote; addr != NULL; addr = addr->next)
2672 debug_printf(" %s\n", addr->address);
2678 /*************************************************
2679 * Read from pipe for remote delivery subprocess *
2680 *************************************************/
2682 /* This function is called when the subprocess is complete, but can also be
2683 called before it is complete, in order to empty a pipe that is full (to prevent
2684 deadlock). It must therefore keep track of its progress in the parlist data
2687 We read the pipe to get the delivery status codes and a possible error message
2688 for each address, optionally preceded by unusability data for the hosts and
2689 also by optional retry data.
2691 Read in large chunks into the big buffer and then scan through, interpreting
2692 the data therein. In most cases, only a single read will be necessary. No
2693 individual item will ever be anywhere near 2500 bytes in length, so by ensuring
2694 that we read the next chunk when there is less than 2500 bytes left in the
2695 non-final chunk, we can assume each item is complete in the buffer before
2696 handling it. Each item is written using a single write(), which is atomic for
2697 small items (less than PIPE_BUF, which seems to be at least 512 in any Unix and
2698 often bigger) so even if we are reading while the subprocess is still going, we
2699 should never have only a partial item in the buffer.
2702 poffset the offset of the parlist item
2703 eop TRUE if the process has completed
2705 Returns: TRUE if the terminating 'Z' item has been read,
2706 or there has been a disaster (i.e. no more data needed);
2711 par_read_pipe(int poffset, BOOL eop)
2714 pardata *p = parlist + poffset;
2715 address_item *addrlist = p->addrlist;
2716 address_item *addr = p->addr;
2719 uschar *endptr = big_buffer;
2720 uschar *ptr = endptr;
2721 uschar *msg = p->msg;
2722 BOOL done = p->done;
2723 BOOL unfinished = TRUE;
2725 /* Loop through all items, reading from the pipe when necessary. The pipe
2726 is set up to be non-blocking, but there are two different Unix mechanisms in
2727 use. Exim uses O_NONBLOCK if it is defined. This returns 0 for end of file,
2728 and EAGAIN for no more data. If O_NONBLOCK is not defined, Exim uses O_NDELAY,
2729 which returns 0 for both end of file and no more data. We distinguish the
2730 two cases by taking 0 as end of file only when we know the process has
2733 Each separate item is written to the pipe in a single write(), and as they are
2734 all short items, the writes will all be atomic and we should never find
2735 ourselves in the position of having read an incomplete item. "Short" in this
2736 case can mean up to about 1K in the case when there is a long error message
2737 associated with an address. */
2739 DEBUG(D_deliver) debug_printf("reading pipe for subprocess %d (%s)\n",
2740 (int)p->pid, eop? "ended" : "not ended");
2744 retry_item *r, **rp;
2745 int remaining = endptr - ptr;
2747 /* Read (first time) or top up the chars in the buffer if necessary.
2748 There will be only one read if we get all the available data (i.e. don't
2749 fill the buffer completely). */
2751 if (remaining < 2500 && unfinished)
2754 int available = big_buffer_size - remaining;
2756 if (remaining > 0) memmove(big_buffer, ptr, remaining);
2759 endptr = big_buffer + remaining;
2760 len = read(fd, endptr, available);
2762 DEBUG(D_deliver) debug_printf("read() yielded %d\n", len);
2764 /* If the result is EAGAIN and the process is not complete, just
2765 stop reading any more and process what we have already. */
2769 if (!eop && errno == EAGAIN) len = 0; else
2771 msg = string_sprintf("failed to read pipe from transport process "
2772 "%d for transport %s: %s", pid, addr->transport->driver_name,
2778 /* If the length is zero (eof or no-more-data), just process what we
2779 already have. Note that if the process is still running and we have
2780 read all the data in the pipe (but less that "available") then we
2781 won't read any more, as "unfinished" will get set FALSE. */
2784 unfinished = len == available;
2787 /* If we are at the end of the available data, exit the loop. */
2789 if (ptr >= endptr) break;
2791 /* Handle each possible type of item, assuming the complete item is
2792 available in store. */
2796 /* Host items exist only if any hosts were marked unusable. Match
2797 up by checking the IP address. */
2800 for (h = addrlist->host_list; h != NULL; h = h->next)
2802 if (h->address == NULL || Ustrcmp(h->address, ptr+2) != 0) continue;
2810 /* Retry items are sent in a preceding R item for each address. This is
2811 kept separate to keep each message short enough to guarantee it won't
2812 be split in the pipe. Hopefully, in the majority of cases, there won't in
2813 fact be any retry items at all.
2815 The complete set of retry items might include an item to delete a
2816 routing retry if there was a previous routing delay. However, routing
2817 retries are also used when a remote transport identifies an address error.
2818 In that case, there may also be an "add" item for the same key. Arrange
2819 that a "delete" item is dropped in favour of an "add" item. */
2822 if (addr == NULL) goto ADDR_MISMATCH;
2824 DEBUG(D_deliver|D_retry)
2825 debug_printf("reading retry information for %s from subprocess\n",
2828 /* Cut out any "delete" items on the list. */
2830 for (rp = &(addr->retries); (r = *rp) != NULL; rp = &(r->next))
2832 if (Ustrcmp(r->key, ptr+1) == 0) /* Found item with same key */
2834 if ((r->flags & rf_delete) == 0) break; /* It was not "delete" */
2835 *rp = r->next; /* Excise a delete item */
2836 DEBUG(D_deliver|D_retry)
2837 debug_printf(" existing delete item dropped\n");
2841 /* We want to add a delete item only if there is no non-delete item;
2842 however we still have to step ptr through the data. */
2844 if (r == NULL || (*ptr & rf_delete) == 0)
2846 r = store_get(sizeof(retry_item));
2847 r->next = addr->retries;
2850 r->key = string_copy(ptr);
2852 memcpy(&(r->basic_errno), ptr, sizeof(r->basic_errno));
2853 ptr += sizeof(r->basic_errno);
2854 memcpy(&(r->more_errno), ptr, sizeof(r->more_errno));
2855 ptr += sizeof(r->more_errno);
2856 r->message = (*ptr)? string_copy(ptr) : NULL;
2857 DEBUG(D_deliver|D_retry)
2858 debug_printf(" added %s item\n",
2859 ((r->flags & rf_delete) == 0)? "retry" : "delete");
2864 DEBUG(D_deliver|D_retry)
2865 debug_printf(" delete item not added: non-delete item exists\n");
2868 ptr += sizeof(r->basic_errno) + sizeof(r->more_errno);
2874 /* Put the amount of data written into the parlist block */
2877 memcpy(&(p->transport_count), ptr, sizeof(transport_count));
2878 ptr += sizeof(transport_count);
2881 /* Address items are in the order of items on the address chain. We
2882 remember the current address value in case this function is called
2883 several times to empty the pipe in stages. Information about delivery
2884 over TLS is sent in a preceding X item for each address. We don't put
2885 it in with the other info, in order to keep each message short enough to
2886 guarantee it won't be split in the pipe. */
2890 if (addr == NULL) goto ADDR_MISMATCH; /* Below, in 'A' handler */
2891 addr->cipher = (*ptr)? string_copy(ptr) : NULL;
2893 addr->peerdn = (*ptr)? string_copy(ptr) : NULL;
2898 case 'C': /* client authenticator information */
2902 addr->authenticator = (*ptr)? string_copy(ptr) : NULL;
2905 addr->auth_id = (*ptr)? string_copy(ptr) : NULL;
2908 addr->auth_sndr = (*ptr)? string_copy(ptr) : NULL;
2918 msg = string_sprintf("address count mismatch for data read from pipe "
2919 "for transport process %d for transport %s", pid,
2920 addrlist->transport->driver_name);
2925 addr->transport_return = *ptr++;
2926 addr->special_action = *ptr++;
2927 memcpy(&(addr->basic_errno), ptr, sizeof(addr->basic_errno));
2928 ptr += sizeof(addr->basic_errno);
2929 memcpy(&(addr->more_errno), ptr, sizeof(addr->more_errno));
2930 ptr += sizeof(addr->more_errno);
2931 memcpy(&(addr->flags), ptr, sizeof(addr->flags));
2932 ptr += sizeof(addr->flags);
2933 addr->message = (*ptr)? string_copy(ptr) : NULL;
2935 addr->user_message = (*ptr)? string_copy(ptr) : NULL;
2938 /* Always two strings for host information, followed by the port number */
2942 h = store_get(sizeof(host_item));
2943 h->name = string_copy(ptr);
2945 h->address = string_copy(ptr);
2947 memcpy(&(h->port), ptr, sizeof(h->port));
2948 ptr += sizeof(h->port);
2949 addr->host_used = h;
2953 /* Finished with this address */
2958 /* Z marks the logical end of the data. It is followed by '0' if
2959 continue_transport was NULL at the end of transporting, otherwise '1'.
2960 We need to know when it becomes NULL during a delivery down a passed SMTP
2961 channel so that we don't try to pass anything more down it. Of course, for
2962 most normal messages it will remain NULL all the time. */
2967 continue_transport = NULL;
2968 continue_hostname = NULL;
2971 DEBUG(D_deliver) debug_printf("Z%c item read\n", *ptr);
2974 /* Anything else is a disaster. */
2977 msg = string_sprintf("malformed data (%d) read from pipe for transport "
2978 "process %d for transport %s", ptr[-1], pid,
2979 addr->transport->driver_name);
2985 /* The done flag is inspected externally, to determine whether or not to
2986 call the function again when the process finishes. */
2990 /* If the process hadn't finished, and we haven't seen the end of the data
2991 or suffered a disaster, update the rest of the state, and return FALSE to
2992 indicate "not finished". */
3001 /* Close our end of the pipe, to prevent deadlock if the far end is still
3002 pushing stuff into it. */
3007 /* If we have finished without error, but haven't had data for every address,
3008 something is wrong. */
3010 if (msg == NULL && addr != NULL)
3011 msg = string_sprintf("insufficient address data read from pipe "
3012 "for transport process %d for transport %s", pid,
3013 addr->transport->driver_name);
3015 /* If an error message is set, something has gone wrong in getting back
3016 the delivery data. Put the message into each address and freeze it. */
3020 for (addr = addrlist; addr != NULL; addr = addr->next)
3022 addr->transport_return = DEFER;
3023 addr->special_action = SPECIAL_FREEZE;
3024 addr->message = msg;
3028 /* Return TRUE to indicate we have got all we need from this process, even
3029 if it hasn't actually finished yet. */
3036 /*************************************************
3037 * Post-process a set of remote addresses *
3038 *************************************************/
3040 /* Do what has to be done immediately after a remote delivery for each set of
3041 addresses, then re-write the spool if necessary. Note that post_process_one
3042 puts the address on an appropriate queue; hence we must fish off the next
3043 one first. This function is also called if there is a problem with setting
3044 up a subprocess to do a remote delivery in parallel. In this case, the final
3045 argument contains a message, and the action must be forced to DEFER.
3048 addr pointer to chain of address items
3049 logflags flags for logging
3050 msg NULL for normal cases; -> error message for unexpected problems
3051 fallback TRUE if processing fallback hosts
3057 remote_post_process(address_item *addr, int logflags, uschar *msg,
3062 /* If any host addresses were found to be unusable, add them to the unusable
3063 tree so that subsequent deliveries don't try them. */
3065 for (h = addr->host_list; h != NULL; h = h->next)
3067 if (h->address == NULL) continue;
3068 if (h->status >= hstatus_unusable) tree_add_unusable(h);
3071 /* Now handle each address on the chain. The transport has placed '=' or '-'
3072 into the special_action field for each successful delivery. */
3074 while (addr != NULL)
3076 address_item *next = addr->next;
3078 /* If msg == NULL (normal processing) and the result is DEFER and we are
3079 processing the main hosts and there are fallback hosts available, put the
3080 address on the list for fallback delivery. */
3082 if (addr->transport_return == DEFER &&
3083 addr->fallback_hosts != NULL &&
3087 addr->host_list = addr->fallback_hosts;
3088 addr->next = addr_fallback;
3089 addr_fallback = addr;
3090 DEBUG(D_deliver) debug_printf("%s queued for fallback host(s)\n", addr->address);
3093 /* If msg is set (=> unexpected problem), set it in the address before
3094 doing the ordinary post processing. */
3100 addr->message = msg;
3101 addr->transport_return = DEFER;
3103 (void)post_process_one(addr, addr->transport_return, logflags,
3104 DTYPE_TRANSPORT, addr->special_action);
3112 /* If we have just delivered down a passed SMTP channel, and that was
3113 the last address, the channel will have been closed down. Now that
3114 we have logged that delivery, set continue_sequence to 1 so that
3115 any subsequent deliveries don't get "*" incorrectly logged. */
3117 if (continue_transport == NULL) continue_sequence = 1;
3122 /*************************************************
3123 * Wait for one remote delivery subprocess *
3124 *************************************************/
3126 /* This function is called while doing remote deliveries when either the
3127 maximum number of processes exist and we need one to complete so that another
3128 can be created, or when waiting for the last ones to complete. It must wait for
3129 the completion of one subprocess, empty the control block slot, and return a
3130 pointer to the address chain.
3133 Returns: pointer to the chain of addresses handled by the process;
3134 NULL if no subprocess found - this is an unexpected error
3137 static address_item *
3140 int poffset, status;
3141 address_item *addr, *addrlist;
3144 set_process_info("delivering %s: waiting for a remote delivery subprocess "
3145 "to finish", message_id);
3147 /* Loop until either a subprocess completes, or there are no subprocesses in
3148 existence - in which case give an error return. We cannot proceed just by
3149 waiting for a completion, because a subprocess may have filled up its pipe, and
3150 be waiting for it to be emptied. Therefore, if no processes have finished, we
3151 wait for one of the pipes to acquire some data by calling select(), with a
3152 timeout just in case.
3154 The simple approach is just to iterate after reading data from a ready pipe.
3155 This leads to non-ideal behaviour when the subprocess has written its final Z
3156 item, closed the pipe, and is in the process of exiting (the common case). A
3157 call to waitpid() yields nothing completed, but select() shows the pipe ready -
3158 reading it yields EOF, so you end up with busy-waiting until the subprocess has
3161 To avoid this, if all the data that is needed has been read from a subprocess
3162 after select(), an explicit wait() for it is done. We know that all it is doing
3163 is writing to the pipe and then exiting, so the wait should not be long.
3165 The non-blocking waitpid() is to some extent just insurance; if we could
3166 reliably detect end-of-file on the pipe, we could always know when to do a
3167 blocking wait() for a completed process. However, because some systems use
3168 NDELAY, which doesn't distinguish between EOF and pipe empty, it is easier to
3169 use code that functions without the need to recognize EOF.
3171 There's a double loop here just in case we end up with a process that is not in
3172 the list of remote delivery processes. Something has obviously gone wrong if
3173 this is the case. (For example, a process that is incorrectly left over from
3174 routing or local deliveries might be found.) The damage can be minimized by
3175 looping back and looking for another process. If there aren't any, the error
3176 return will happen. */
3178 for (;;) /* Normally we do not repeat this loop */
3180 while ((pid = waitpid(-1, &status, WNOHANG)) <= 0)
3183 fd_set select_pipes;
3184 int maxpipe, readycount;
3186 /* A return value of -1 can mean several things. If errno != ECHILD, it
3187 either means invalid options (which we discount), or that this process was
3188 interrupted by a signal. Just loop to try the waitpid() again.
3190 If errno == ECHILD, waitpid() is telling us that there are no subprocesses
3191 in existence. This should never happen, and is an unexpected error.
3192 However, there is a nasty complication when running under Linux. If "strace
3193 -f" is being used under Linux to trace this process and its children,
3194 subprocesses are "stolen" from their parents and become the children of the
3195 tracing process. A general wait such as the one we've just obeyed returns
3196 as if there are no children while subprocesses are running. Once a
3197 subprocess completes, it is restored to the parent, and waitpid(-1) finds
3198 it. Thanks to Joachim Wieland for finding all this out and suggesting a
3201 This does not happen using "truss" on Solaris, nor (I think) with other
3202 tracing facilities on other OS. It seems to be specific to Linux.
3204 What we do to get round this is to use kill() to see if any of our
3205 subprocesses are still in existence. If kill() gives an OK return, we know
3206 it must be for one of our processes - it can't be for a re-use of the pid,
3207 because if our process had finished, waitpid() would have found it. If any
3208 of our subprocesses are in existence, we proceed to use select() as if
3209 waitpid() had returned zero. I think this is safe. */
3213 if (errno != ECHILD) continue; /* Repeats the waitpid() */
3216 debug_printf("waitpid() returned -1/ECHILD: checking explicitly "
3217 "for process existence\n");
3219 for (poffset = 0; poffset < remote_max_parallel; poffset++)
3221 if ((pid = parlist[poffset].pid) != 0 && kill(pid, 0) == 0)
3223 DEBUG(D_deliver) debug_printf("process %d still exists: assume "
3224 "stolen by strace\n", (int)pid);
3225 break; /* With poffset set */
3229 if (poffset >= remote_max_parallel)
3231 DEBUG(D_deliver) debug_printf("*** no delivery children found\n");
3232 return NULL; /* This is the error return */
3236 /* A pid value greater than 0 breaks the "while" loop. A negative value has
3237 been handled above. A return value of zero means that there is at least one
3238 subprocess, but there are no completed subprocesses. See if any pipes are
3239 ready with any data for reading. */
3241 DEBUG(D_deliver) debug_printf("selecting on subprocess pipes\n");
3244 FD_ZERO(&select_pipes);
3245 for (poffset = 0; poffset < remote_max_parallel; poffset++)
3247 if (parlist[poffset].pid != 0)
3249 int fd = parlist[poffset].fd;
3250 FD_SET(fd, &select_pipes);
3251 if (fd > maxpipe) maxpipe = fd;
3255 /* Stick in a 60-second timeout, just in case. */
3260 readycount = select(maxpipe + 1, (SELECT_ARG2_TYPE *)&select_pipes,
3263 /* Scan through the pipes and read any that are ready; use the count
3264 returned by select() to stop when there are no more. Select() can return
3265 with no processes (e.g. if interrupted). This shouldn't matter.
3267 If par_read_pipe() returns TRUE, it means that either the terminating Z was
3268 read, or there was a disaster. In either case, we are finished with this
3269 process. Do an explicit wait() for the process and break the main loop if
3272 It turns out that we have to deal with the case of an interrupted system
3273 call, which can happen on some operating systems if the signal handling is
3274 set up to do that by default. */
3277 readycount > 0 && poffset < remote_max_parallel;
3280 if ((pid = parlist[poffset].pid) != 0 &&
3281 FD_ISSET(parlist[poffset].fd, &select_pipes))
3284 if (par_read_pipe(poffset, FALSE)) /* Finished with this pipe */
3286 for (;;) /* Loop for signals */
3288 pid_t endedpid = waitpid(pid, &status, 0);
3289 if (endedpid == pid) goto PROCESS_DONE;
3290 if (endedpid != (pid_t)(-1) || errno != EINTR)
3291 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Unexpected error return "
3292 "%d (errno = %d) from waitpid() for process %d",
3293 (int)endedpid, errno, (int)pid);
3299 /* Now go back and look for a completed subprocess again. */
3302 /* A completed process was detected by the non-blocking waitpid(). Find the
3303 data block that corresponds to this subprocess. */
3305 for (poffset = 0; poffset < remote_max_parallel; poffset++)
3306 if (pid == parlist[poffset].pid) break;
3308 /* Found the data block; this is a known remote delivery process. We don't
3309 need to repeat the outer loop. This should be what normally happens. */
3311 if (poffset < remote_max_parallel) break;
3313 /* This situation is an error, but it's probably better to carry on looking
3314 for another process than to give up (as we used to do). */
3316 log_write(0, LOG_MAIN|LOG_PANIC, "Process %d finished: not found in remote "
3317 "transport process list", pid);
3318 } /* End of the "for" loop */
3320 /* Come here when all the data was completely read after a select(), and
3321 the process in pid has been wait()ed for. */
3328 debug_printf("remote delivery process %d ended\n", (int)pid);
3330 debug_printf("remote delivery process %d ended: status=%04x\n", (int)pid,
3334 set_process_info("delivering %s", message_id);
3336 /* Get the chain of processed addresses */
3338 addrlist = parlist[poffset].addrlist;
3340 /* If the process did not finish cleanly, record an error and freeze (except
3341 for SIGTERM, SIGKILL and SIGQUIT), and also ensure the journal is not removed,
3342 in case the delivery did actually happen. */
3344 if ((status & 0xffff) != 0)
3347 int msb = (status >> 8) & 255;
3348 int lsb = status & 255;
3349 int code = (msb == 0)? (lsb & 0x7f) : msb;
3351 msg = string_sprintf("%s transport process returned non-zero status 0x%04x: "
3353 addrlist->transport->driver_name,
3355 (msb == 0)? "terminated by signal" : "exit code",
3358 if (msb != 0 || (code != SIGTERM && code != SIGKILL && code != SIGQUIT))
3359 addrlist->special_action = SPECIAL_FREEZE;
3361 for (addr = addrlist; addr != NULL; addr = addr->next)
3363 addr->transport_return = DEFER;
3364 addr->message = msg;
3367 remove_journal = FALSE;
3370 /* Else complete reading the pipe to get the result of the delivery, if all
3371 the data has not yet been obtained. */
3373 else if (!parlist[poffset].done) (void)par_read_pipe(poffset, TRUE);
3375 /* Put the data count and return path into globals, mark the data slot unused,
3376 decrement the count of subprocesses, and return the address chain. */
3378 transport_count = parlist[poffset].transport_count;
3379 used_return_path = parlist[poffset].return_path;
3380 parlist[poffset].pid = 0;
3387 /*************************************************
3388 * Wait for subprocesses and post-process *
3389 *************************************************/
3391 /* This function waits for subprocesses until the number that are still running
3392 is below a given threshold. For each complete subprocess, the addresses are
3393 post-processed. If we can't find a running process, there is some shambles.
3394 Better not bomb out, as that might lead to multiple copies of the message. Just
3395 log and proceed as if all done.
3398 max maximum number of subprocesses to leave running
3399 fallback TRUE if processing fallback hosts
3405 par_reduce(int max, BOOL fallback)
3407 while (parcount > max)
3409 address_item *doneaddr = par_wait();
3410 if (doneaddr == NULL)
3412 log_write(0, LOG_MAIN|LOG_PANIC,
3413 "remote delivery process count got out of step");
3416 else remote_post_process(doneaddr, LOG_MAIN, NULL, fallback);
3424 rmt_dlv_checked_write(int fd, void * buf, int size)
3426 int ret = write(fd, buf, size);
3428 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Failed writing transport result to pipe: %s\n",
3429 ret == -1 ? strerror(errno) : "short write");
3432 /*************************************************
3433 * Do remote deliveries *
3434 *************************************************/
3436 /* This function is called to process the addresses in addr_remote. We must
3437 pick off the queue all addresses that have the same transport, remote
3438 destination, and errors address, and hand them to the transport in one go,
3439 subject to some configured limitations. If this is a run to continue delivering
3440 to an existing delivery channel, skip all but those addresses that can go to
3441 that channel. The skipped addresses just get deferred.
3443 If mua_wrapper is set, all addresses must be able to be sent in a single
3444 transaction. If not, this function yields FALSE.
3446 In Exim 4, remote deliveries are always done in separate processes, even
3447 if remote_max_parallel = 1 or if there's only one delivery to do. The reason
3448 is so that the base process can retain privilege. This makes the
3449 implementation of fallback transports feasible (though not initially done.)
3451 We create up to the configured number of subprocesses, each of which passes
3452 back the delivery state via a pipe. (However, when sending down an existing
3453 connection, remote_max_parallel is forced to 1.)
3456 fallback TRUE if processing fallback hosts
3458 Returns: TRUE normally
3459 FALSE if mua_wrapper is set and the addresses cannot all be sent
3464 do_remote_deliveries(BOOL fallback)
3470 parcount = 0; /* Number of executing subprocesses */
3472 /* When sending down an existing channel, only do one delivery at a time.
3473 We use a local variable (parmax) to hold the maximum number of processes;
3474 this gets reduced from remote_max_parallel if we can't create enough pipes. */
3476 if (continue_transport != NULL) remote_max_parallel = 1;
3477 parmax = remote_max_parallel;
3479 /* If the data for keeping a list of processes hasn't yet been
3482 if (parlist == NULL)
3484 parlist = store_get(remote_max_parallel * sizeof(pardata));
3485 for (poffset = 0; poffset < remote_max_parallel; poffset++)
3486 parlist[poffset].pid = 0;
3489 /* Now loop for each remote delivery */
3491 for (delivery_count = 0; addr_remote != NULL; delivery_count++)
3497 int address_count = 1;
3498 int address_count_max;
3500 BOOL use_initgroups;
3501 BOOL pipe_done = FALSE;
3502 transport_instance *tp;
3503 address_item **anchor = &addr_remote;
3504 address_item *addr = addr_remote;
3505 address_item *last = addr;
3508 /* Pull the first address right off the list. */
3510 addr_remote = addr->next;
3513 DEBUG(D_deliver|D_transport)
3514 debug_printf("--------> %s <--------\n", addr->address);
3516 /* If no transport has been set, there has been a big screw-up somewhere. */
3518 if ((tp = addr->transport) == NULL)
3520 disable_logging = FALSE; /* Jic */
3521 remote_post_process(addr, LOG_MAIN|LOG_PANIC,
3522 US"No transport set by router", fallback);
3526 /* Check that this base address hasn't previously been delivered to this
3527 transport. The check is necessary at this point to handle homonymic addresses
3528 correctly in cases where the pattern of redirection changes between delivery
3529 attempts. Non-homonymic previous delivery is detected earlier, at routing
3532 if (previously_transported(addr, FALSE)) continue;
3534 /* Force failure if the message is too big. */
3536 if (tp->message_size_limit != NULL)
3538 int rc = check_message_size(tp, addr);
3541 addr->transport_return = rc;
3542 remote_post_process(addr, LOG_MAIN, NULL, fallback);
3547 /* Get the flag which specifies whether the transport can handle different
3548 domains that nevertheless resolve to the same set of hosts. */
3550 multi_domain = tp->multi_domain;
3552 /* Get the maximum it can handle in one envelope, with zero meaning
3553 unlimited, which is forced for the MUA wrapper case. */
3555 address_count_max = tp->max_addresses;
3556 if (address_count_max == 0 || mua_wrapper) address_count_max = 999999;
3559 /************************************************************************/
3560 /***** This is slightly experimental code, but should be safe. *****/
3562 /* The address_count_max value is the maximum number of addresses that the
3563 transport can send in one envelope. However, the transport must be capable of
3564 dealing with any number of addresses. If the number it gets exceeds its
3565 envelope limitation, it must send multiple copies of the message. This can be
3566 done over a single connection for SMTP, so uses less resources than making
3567 multiple connections. On the other hand, if remote_max_parallel is greater
3568 than one, it is perhaps a good idea to use parallel processing to move the
3569 message faster, even if that results in multiple simultaneous connections to
3572 How can we come to some compromise between these two ideals? What we do is to
3573 limit the number of addresses passed to a single instance of a transport to
3574 the greater of (a) its address limit (rcpt_max for SMTP) and (b) the total
3575 number of addresses routed to remote transports divided by
3576 remote_max_parallel. For example, if the message has 100 remote recipients,
3577 remote max parallel is 2, and rcpt_max is 10, we'd never send more than 50 at
3578 once. But if rcpt_max is 100, we could send up to 100.
3580 Of course, not all the remotely addresses in a message are going to go to the
3581 same set of hosts (except in smarthost configurations), so this is just a
3582 heuristic way of dividing up the work.
3584 Furthermore (1), because this may not be wanted in some cases, and also to
3585 cope with really pathological cases, there is also a limit to the number of
3586 messages that are sent over one connection. This is the same limit that is
3587 used when sending several different messages over the same connection.
3588 Continue_sequence is set when in this situation, to the number sent so
3589 far, including this message.
3591 Furthermore (2), when somebody explicitly sets the maximum value to 1, it
3592 is probably because they are using VERP, in which case they want to pass only
3593 one address at a time to the transport, in order to be able to use
3594 $local_part and $domain in constructing a new return path. We could test for
3595 the use of these variables, but as it is so likely they will be used when the
3596 maximum is 1, we don't bother. Just leave the value alone. */
3598 if (address_count_max != 1 &&
3599 address_count_max < remote_delivery_count/remote_max_parallel)
3601 int new_max = remote_delivery_count/remote_max_parallel;
3602 int message_max = tp->connection_max_messages;
3603 if (connection_max_messages >= 0) message_max = connection_max_messages;
3604 message_max -= continue_sequence - 1;
3605 if (message_max > 0 && new_max > address_count_max * message_max)
3606 new_max = address_count_max * message_max;
3607 address_count_max = new_max;
3610 /************************************************************************/
3613 /* Pick off all addresses which have the same transport, errors address,
3614 destination, and extra headers. In some cases they point to the same host
3615 list, but we also need to check for identical host lists generated from
3616 entirely different domains. The host list pointers can be NULL in the case
3617 where the hosts are defined in the transport. There is also a configured
3618 maximum limit of addresses that can be handled at once (see comments above
3619 for how it is computed). */
3621 while ((next = *anchor) != NULL && address_count < address_count_max)
3623 if ((multi_domain || Ustrcmp(next->domain, addr->domain) == 0)
3625 tp == next->transport
3627 same_hosts(next->host_list, addr->host_list)
3629 same_strings(next->p.errors_address, addr->p.errors_address)
3631 same_headers(next->p.extra_headers, addr->p.extra_headers)
3633 same_ugid(tp, next, addr)
3635 (next->p.remove_headers == addr->p.remove_headers ||
3636 (next->p.remove_headers != NULL &&
3637 addr->p.remove_headers != NULL &&
3638 Ustrcmp(next->p.remove_headers, addr->p.remove_headers) == 0)))
3640 *anchor = next->next;
3642 next->first = addr; /* remember top one (for retry processing) */
3647 else anchor = &(next->next);
3650 /* If we are acting as an MUA wrapper, all addresses must go in a single
3651 transaction. If not, put them back on the chain and yield FALSE. */
3653 if (mua_wrapper && addr_remote != NULL)
3655 last->next = addr_remote;
3660 /* Set up the expansion variables for this set of addresses */
3662 deliver_set_expansions(addr);
3664 /* Ensure any transport-set auth info is fresh */
3665 addr->authenticator = addr->auth_id = addr->auth_sndr = NULL;
3667 /* Compute the return path, expanding a new one if required. The old one
3668 must be set first, as it might be referred to in the expansion. */
3670 if(addr->p.errors_address != NULL)
3671 return_path = addr->p.errors_address;
3672 #ifdef EXPERIMENTAL_SRS
3673 else if(addr->p.srs_sender != NULL)
3674 return_path = addr->p.srs_sender;
3677 return_path = sender_address;
3679 if (tp->return_path != NULL)
3681 uschar *new_return_path = expand_string(tp->return_path);
3682 if (new_return_path == NULL)
3684 if (!expand_string_forcedfail)
3686 remote_post_process(addr, LOG_MAIN|LOG_PANIC,
3687 string_sprintf("Failed to expand return path \"%s\": %s",
3688 tp->return_path, expand_string_message), fallback);
3692 else return_path = new_return_path;
3695 /* Find the uid, gid, and use_initgroups setting for this transport. Failure
3696 logs and sets up error messages, so we just post-process and continue with
3697 the next address. */
3699 if (!findugid(addr, tp, &uid, &gid, &use_initgroups))
3701 remote_post_process(addr, LOG_MAIN|LOG_PANIC, NULL, fallback);
3705 /* If this transport has a setup function, call it now so that it gets
3706 run in this process and not in any subprocess. That way, the results of
3707 any setup that are retained by the transport can be reusable. One of the
3708 things the setup does is to set the fallback host lists in the addresses.
3709 That is why it is called at this point, before the continue delivery
3710 processing, because that might use the fallback hosts. */
3712 if (tp->setup != NULL)
3713 (void)((tp->setup)(addr->transport, addr, NULL, uid, gid, NULL));
3715 /* If this is a run to continue delivery down an already-established
3716 channel, check that this set of addresses matches the transport and
3717 the channel. If it does not, defer the addresses. If a host list exists,
3718 we must check that the continue host is on the list. Otherwise, the
3719 host is set in the transport. */
3721 continue_more = FALSE; /* In case got set for the last lot */
3722 if (continue_transport != NULL)
3724 BOOL ok = Ustrcmp(continue_transport, tp->name) == 0;
3725 if (ok && addr->host_list != NULL)
3729 for (h = addr->host_list; h != NULL; h = h->next)
3731 if (Ustrcmp(h->name, continue_hostname) == 0)
3732 { ok = TRUE; break; }
3736 /* Addresses not suitable; defer or queue for fallback hosts (which
3737 might be the continue host) and skip to next address. */
3741 DEBUG(D_deliver) debug_printf("not suitable for continue_transport\n");
3744 if (addr->fallback_hosts != NULL && !fallback)
3748 next->host_list = next->fallback_hosts;
3749 DEBUG(D_deliver) debug_printf("%s queued for fallback host(s)\n", next->address);
3750 if (next->next == NULL) break;
3753 next->next = addr_fallback;
3754 addr_fallback = addr;
3759 while (next->next != NULL) next = next->next;
3760 next->next = addr_defer;
3767 /* Set a flag indicating whether there are further addresses that list
3768 the continued host. This tells the transport to leave the channel open,
3769 but not to pass it to another delivery process. */
3771 for (next = addr_remote; next != NULL; next = next->next)
3774 for (h = next->host_list; h != NULL; h = h->next)
3776 if (Ustrcmp(h->name, continue_hostname) == 0)
3777 { continue_more = TRUE; break; }
3782 /* The transports set up the process info themselves as they may connect
3783 to more than one remote machine. They also have to set up the filter
3784 arguments, if required, so that the host name and address are available
3787 transport_filter_argv = NULL;
3789 /* Create the pipe for inter-process communication. If pipe creation
3790 fails, it is probably because the value of remote_max_parallel is so
3791 large that too many file descriptors for pipes have been created. Arrange
3792 to wait for a process to finish, and then try again. If we still can't
3793 create a pipe when all processes have finished, break the retry loop. */
3797 if (pipe(pfd) == 0) pipe_done = TRUE;
3798 else if (parcount > 0) parmax = parcount;
3801 /* We need to make the reading end of the pipe non-blocking. There are
3802 two different options for this. Exim is cunningly (I hope!) coded so
3803 that it can use either of them, though it prefers O_NONBLOCK, which
3804 distinguishes between EOF and no-more-data. */
3807 (void)fcntl(pfd[pipe_read], F_SETFL, O_NONBLOCK);
3809 (void)fcntl(pfd[pipe_read], F_SETFL, O_NDELAY);
3812 /* If the maximum number of subprocesses already exist, wait for a process
3813 to finish. If we ran out of file descriptors, parmax will have been reduced
3814 from its initial value of remote_max_parallel. */
3816 par_reduce(parmax - 1, fallback);
3819 /* If we failed to create a pipe and there were no processes to wait
3820 for, we have to give up on this one. Do this outside the above loop
3821 so that we can continue the main loop. */
3825 remote_post_process(addr, LOG_MAIN|LOG_PANIC,
3826 string_sprintf("unable to create pipe: %s", strerror(errno)), fallback);
3830 /* Find a free slot in the pardata list. Must do this after the possible
3831 waiting for processes to finish, because a terminating process will free
3834 for (poffset = 0; poffset < remote_max_parallel; poffset++)
3835 if (parlist[poffset].pid == 0) break;
3837 /* If there isn't one, there has been a horrible disaster. */
3839 if (poffset >= remote_max_parallel)
3841 (void)close(pfd[pipe_write]);
3842 (void)close(pfd[pipe_read]);
3843 remote_post_process(addr, LOG_MAIN|LOG_PANIC,
3844 US"Unexpectedly no free subprocess slot", fallback);
3848 /* Now fork a subprocess to do the remote delivery, but before doing so,
3849 ensure that any cached resourses are released so as not to interfere with
3850 what happens in the subprocess. */
3854 if ((pid = fork()) == 0)
3856 int fd = pfd[pipe_write];
3859 /* There are weird circumstances in which logging is disabled */
3861 disable_logging = tp->disable_logging;
3863 /* Show pids on debug output if parallelism possible */
3865 if (parmax > 1 && (parcount > 0 || addr_remote != NULL))
3867 DEBUG(D_any|D_v) debug_selector |= D_pid;
3868 DEBUG(D_deliver) debug_printf("Remote delivery process started\n");
3871 /* Reset the random number generator, so different processes don't all
3872 have the same sequence. In the test harness we want different, but
3873 predictable settings for each delivery process, so do something explicit
3874 here rather they rely on the fixed reset in the random number function. */
3876 random_seed = running_in_test_harness? 42 + 2*delivery_count : 0;
3878 /* Set close-on-exec on the pipe so that it doesn't get passed on to
3879 a new process that may be forked to do another delivery down the same
3882 (void)fcntl(fd, F_SETFD, fcntl(fd, F_GETFD) | FD_CLOEXEC);
3884 /* Close open file descriptors for the pipes of other processes
3885 that are running in parallel. */
3887 for (poffset = 0; poffset < remote_max_parallel; poffset++)
3888 if (parlist[poffset].pid != 0) (void)close(parlist[poffset].fd);
3890 /* This process has inherited a copy of the file descriptor
3891 for the data file, but its file pointer is shared with all the
3892 other processes running in parallel. Therefore, we have to re-open
3893 the file in order to get a new file descriptor with its own
3894 file pointer. We don't need to lock it, as the lock is held by
3895 the parent process. There doesn't seem to be any way of doing
3896 a dup-with-new-file-pointer. */
3898 (void)close(deliver_datafile);
3899 sprintf(CS spoolname, "%s/input/%s/%s-D", spool_directory, message_subdir,
3901 deliver_datafile = Uopen(spoolname, O_RDWR | O_APPEND, 0);
3903 if (deliver_datafile < 0)
3904 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Failed to reopen %s for remote "
3905 "parallel delivery: %s", spoolname, strerror(errno));
3907 /* Set the close-on-exec flag */
3909 (void)fcntl(deliver_datafile, F_SETFD, fcntl(deliver_datafile, F_GETFD) |
3912 /* Set the uid/gid of this process; bombs out on failure. */
3914 exim_setugid(uid, gid, use_initgroups,
3915 string_sprintf("remote delivery to %s with transport=%s",
3916 addr->address, tp->name));
3918 /* Close the unwanted half of this process' pipe, set the process state,
3919 and run the transport. Afterwards, transport_count will contain the number
3920 of bytes written. */
3922 (void)close(pfd[pipe_read]);
3923 set_process_info("delivering %s using %s", message_id, tp->name);
3924 debug_print_string(tp->debug_string);
3925 if (!(tp->info->code)(addr->transport, addr)) replicate_status(addr);
3927 set_process_info("delivering %s (just run %s for %s%s in subprocess)",
3928 message_id, tp->name, addr->address, (addr->next == NULL)? "" : ", ...");
3930 /* Ensure any cached resources that we used are now released */
3934 /* Pass the result back down the pipe. This is a lot more information
3935 than is needed for a local delivery. We have to send back the error
3936 status for each address, the usability status for each host that is
3937 flagged as unusable, and all the retry items. When TLS is in use, we
3938 send also the cipher and peerdn information. Each type of information
3939 is flagged by an identifying byte, and is then in a fixed format (with
3940 strings terminated by zeros), and there is a final terminator at the
3941 end. The host information and retry information is all attached to
3942 the first address, so that gets sent at the start. */
3944 /* Host unusability information: for most success cases this will
3947 for (h = addr->host_list; h != NULL; h = h->next)
3949 if (h->address == NULL || h->status < hstatus_unusable) continue;
3950 sprintf(CS big_buffer, "H%c%c%s", h->status, h->why, h->address);
3951 rmt_dlv_checked_write(fd, big_buffer, Ustrlen(big_buffer+3) + 4);
3954 /* The number of bytes written. This is the same for each address. Even
3955 if we sent several copies of the message down the same connection, the
3956 size of each one is the same, and it's that value we have got because
3957 transport_count gets reset before calling transport_write_message(). */
3959 big_buffer[0] = 'S';
3960 memcpy(big_buffer+1, &transport_count, sizeof(transport_count));
3961 rmt_dlv_checked_write(fd, big_buffer, sizeof(transport_count) + 1);
3963 /* Information about what happened to each address. Four item types are
3964 used: an optional 'X' item first, for TLS information, then an optional "C"
3965 item for any client-auth info followed by 'R' items for any retry settings,
3966 and finally an 'A' item for the remaining data. */
3968 for(; addr != NULL; addr = addr->next)
3973 /* The certificate verification status goes into the flags */
3975 if (tls_out.certificate_verified) setflag(addr, af_cert_verified);
3977 /* Use an X item only if there's something to send */
3980 if (addr->cipher != NULL)
3983 sprintf(CS ptr, "X%.128s", addr->cipher);
3985 if (addr->peerdn == NULL) *ptr++ = 0; else
3987 sprintf(CS ptr, "%.512s", addr->peerdn);
3990 rmt_dlv_checked_write(fd, big_buffer, ptr - big_buffer);
3994 if (client_authenticator)
3997 sprintf(CS big_buffer, "C1%.64s", client_authenticator);
3999 rmt_dlv_checked_write(fd, big_buffer, ptr - big_buffer);
4001 if (client_authenticated_id)
4004 sprintf(CS big_buffer, "C2%.64s", client_authenticated_id);
4006 rmt_dlv_checked_write(fd, big_buffer, ptr - big_buffer);
4008 if (client_authenticated_sender)
4011 sprintf(CS big_buffer, "C3%.64s", client_authenticated_sender);
4013 rmt_dlv_checked_write(fd, big_buffer, ptr - big_buffer);
4016 /* Retry information: for most success cases this will be null. */
4018 for (r = addr->retries; r != NULL; r = r->next)
4021 sprintf(CS big_buffer, "R%c%.500s", r->flags, r->key);
4022 ptr = big_buffer + Ustrlen(big_buffer+2) + 3;
4023 memcpy(ptr, &(r->basic_errno), sizeof(r->basic_errno));
4024 ptr += sizeof(r->basic_errno);
4025 memcpy(ptr, &(r->more_errno), sizeof(r->more_errno));
4026 ptr += sizeof(r->more_errno);
4027 if (r->message == NULL) *ptr++ = 0; else
4029 sprintf(CS ptr, "%.512s", r->message);
4032 rmt_dlv_checked_write(fd, big_buffer, ptr - big_buffer);
4035 /* The rest of the information goes in an 'A' item. */
4037 ptr = big_buffer + 3;
4038 sprintf(CS big_buffer, "A%c%c", addr->transport_return,
4039 addr->special_action);
4040 memcpy(ptr, &(addr->basic_errno), sizeof(addr->basic_errno));
4041 ptr += sizeof(addr->basic_errno);
4042 memcpy(ptr, &(addr->more_errno), sizeof(addr->more_errno));
4043 ptr += sizeof(addr->more_errno);
4044 memcpy(ptr, &(addr->flags), sizeof(addr->flags));
4045 ptr += sizeof(addr->flags);
4047 if (addr->message == NULL) *ptr++ = 0; else
4049 sprintf(CS ptr, "%.1024s", addr->message);
4053 if (addr->user_message == NULL) *ptr++ = 0; else
4055 sprintf(CS ptr, "%.1024s", addr->user_message);
4059 if (addr->host_used == NULL) *ptr++ = 0; else
4061 sprintf(CS ptr, "%.256s", addr->host_used->name);
4063 sprintf(CS ptr, "%.64s", addr->host_used->address);
4065 memcpy(ptr, &(addr->host_used->port), sizeof(addr->host_used->port));
4066 ptr += sizeof(addr->host_used->port);
4068 rmt_dlv_checked_write(fd, big_buffer, ptr - big_buffer);
4071 /* Add termination flag, close the pipe, and that's it. The character
4072 after 'Z' indicates whether continue_transport is now NULL or not.
4073 A change from non-NULL to NULL indicates a problem with a continuing
4076 big_buffer[0] = 'Z';
4077 big_buffer[1] = (continue_transport == NULL)? '0' : '1';
4078 rmt_dlv_checked_write(fd, big_buffer, 2);
4083 /* Back in the mainline: close the unwanted half of the pipe. */
4085 (void)close(pfd[pipe_write]);
4087 /* Fork failed; defer with error message */
4091 (void)close(pfd[pipe_read]);
4092 remote_post_process(addr, LOG_MAIN|LOG_PANIC,
4093 string_sprintf("fork failed for remote delivery to %s: %s",
4094 addr->domain, strerror(errno)), fallback);
4098 /* Fork succeeded; increment the count, and remember relevant data for
4099 when the process finishes. */
4102 parlist[poffset].addrlist = parlist[poffset].addr = addr;
4103 parlist[poffset].pid = pid;
4104 parlist[poffset].fd = pfd[pipe_read];
4105 parlist[poffset].done = FALSE;
4106 parlist[poffset].msg = NULL;
4107 parlist[poffset].return_path = return_path;
4109 /* If the process we've just started is sending a message down an existing
4110 channel, wait for it now. This ensures that only one such process runs at
4111 once, whatever the value of remote_max parallel. Otherwise, we might try to
4112 send two or more messages simultaneously down the same channel. This could
4113 happen if there are different domains that include the same host in otherwise
4114 different host lists.
4116 Also, if the transport closes down the channel, this information gets back
4117 (continue_transport gets set to NULL) before we consider any other addresses
4120 if (continue_transport != NULL) par_reduce(0, fallback);
4122 /* Otherwise, if we are running in the test harness, wait a bit, to let the
4123 newly created process get going before we create another process. This should
4124 ensure repeatability in the tests. We only need to wait a tad. */
4126 else if (running_in_test_harness) millisleep(500);
4129 /* Reached the end of the list of addresses. Wait for all the subprocesses that
4130 are still running and post-process their addresses. */
4132 par_reduce(0, fallback);
4139 /*************************************************
4140 * Split an address into local part and domain *
4141 *************************************************/
4143 /* This function initializes an address for routing by splitting it up into a
4144 local part and a domain. The local part is set up twice - once in its original
4145 casing, and once in lower case, and it is dequoted. We also do the "percent
4146 hack" for configured domains. This may lead to a DEFER result if a lookup
4147 defers. When a percent-hacking takes place, we insert a copy of the original
4148 address as a new parent of this address, as if we have had a redirection.
4151 addr points to an addr_item block containing the address
4154 DEFER - could not determine if domain is %-hackable
4158 deliver_split_address(address_item *addr)
4160 uschar *address = addr->address;
4161 uschar *domain = Ustrrchr(address, '@');
4163 int len = domain - address;
4165 addr->domain = string_copylc(domain+1); /* Domains are always caseless */
4167 /* The implication in the RFCs (though I can't say I've seen it spelled out
4168 explicitly) is that quoting should be removed from local parts at the point
4169 where they are locally interpreted. [The new draft "821" is more explicit on
4170 this, Jan 1999.] We know the syntax is valid, so this can be done by simply
4171 removing quoting backslashes and any unquoted doublequotes. */
4173 t = addr->cc_local_part = store_get(len+1);
4176 register int c = *address++;
4177 if (c == '\"') continue;
4187 /* We do the percent hack only for those domains that are listed in
4188 percent_hack_domains. A loop is required, to copy with multiple %-hacks. */
4190 if (percent_hack_domains != NULL)
4193 uschar *new_address = NULL;
4194 uschar *local_part = addr->cc_local_part;
4196 deliver_domain = addr->domain; /* set $domain */
4198 while ((rc = match_isinlist(deliver_domain, &percent_hack_domains, 0,
4199 &domainlist_anchor, addr->domain_cache, MCL_DOMAIN, TRUE, NULL))
4201 (t = Ustrrchr(local_part, '%')) != NULL)
4203 new_address = string_copy(local_part);
4204 new_address[t - local_part] = '@';
4205 deliver_domain = string_copylc(t+1);
4206 local_part = string_copyn(local_part, t - local_part);
4209 if (rc == DEFER) return DEFER; /* lookup deferred */
4211 /* If hackery happened, set up new parent and alter the current address. */
4213 if (new_address != NULL)
4215 address_item *new_parent = store_get(sizeof(address_item));
4216 *new_parent = *addr;
4217 addr->parent = new_parent;
4218 addr->address = new_address;
4219 addr->unique = string_copy(new_address);
4220 addr->domain = deliver_domain;
4221 addr->cc_local_part = local_part;
4222 DEBUG(D_deliver) debug_printf("%%-hack changed address to: %s\n",
4227 /* Create the lowercased version of the final local part, and make that the
4228 default one to be used. */
4230 addr->local_part = addr->lc_local_part = string_copylc(addr->cc_local_part);
4237 /*************************************************
4238 * Get next error message text *
4239 *************************************************/
4241 /* If f is not NULL, read the next "paragraph", from a customized error message
4242 text file, terminated by a line containing ****, and expand it.
4245 f NULL or a file to read from
4246 which string indicating which string (for errors)
4248 Returns: NULL or an expanded string
4252 next_emf(FILE *f, uschar *which)
4256 uschar *para, *yield;
4259 if (f == NULL) return NULL;
4261 if (Ufgets(buffer, sizeof(buffer), f) == NULL ||
4262 Ustrcmp(buffer, "****\n") == 0) return NULL;
4264 para = store_get(size);
4267 para = string_cat(para, &size, &ptr, buffer, Ustrlen(buffer));
4268 if (Ufgets(buffer, sizeof(buffer), f) == NULL ||
4269 Ustrcmp(buffer, "****\n") == 0) break;
4273 yield = expand_string(para);
4274 if (yield != NULL) return yield;
4276 log_write(0, LOG_MAIN|LOG_PANIC, "Failed to expand string from "
4277 "bounce_message_file or warn_message_file (%s): %s", which,
4278 expand_string_message);
4285 /*************************************************
4286 * Close down a passed transport channel *
4287 *************************************************/
4289 /* This function is called when a passed transport channel cannot be used.
4290 It attempts to close it down tidily. The yield is always DELIVER_NOT_ATTEMPTED
4291 so that the function call can be the argument of a "return" statement.
4294 Returns: DELIVER_NOT_ATTEMPTED
4298 continue_closedown(void)
4300 if (continue_transport != NULL)
4302 transport_instance *t;
4303 for (t = transports; t != NULL; t = t->next)
4305 if (Ustrcmp(t->name, continue_transport) == 0)
4307 if (t->info->closedown != NULL) (t->info->closedown)(t);
4312 return DELIVER_NOT_ATTEMPTED;
4318 /*************************************************
4319 * Print address information *
4320 *************************************************/
4322 /* This function is called to output an address, or information about an
4323 address, for bounce or defer messages. If the hide_child flag is set, all we
4324 output is the original ancestor address.
4327 addr points to the address
4328 f the FILE to print to
4329 si an initial string
4330 sc a continuation string for before "generated"
4333 Returns: TRUE if the address is not hidden
4337 print_address_information(address_item *addr, FILE *f, uschar *si, uschar *sc,
4341 uschar *printed = US"";
4342 address_item *ancestor = addr;
4343 while (ancestor->parent != NULL) ancestor = ancestor->parent;
4345 fprintf(f, "%s", CS si);
4347 if (addr->parent != NULL && testflag(addr, af_hide_child))
4349 printed = US"an undisclosed address";
4352 else if (!testflag(addr, af_pfr) || addr->parent == NULL)
4353 printed = addr->address;
4357 uschar *s = addr->address;
4360 if (addr->address[0] == '>') { ss = US"mail"; s++; }
4361 else if (addr->address[0] == '|') ss = US"pipe";
4364 fprintf(f, "%s to %s%sgenerated by ", ss, s, sc);
4365 printed = addr->parent->address;
4368 fprintf(f, "%s", CS string_printing(printed));
4370 if (ancestor != addr)
4372 uschar *original = (ancestor->onetime_parent == NULL)?
4373 ancestor->address : ancestor->onetime_parent;
4374 if (strcmpic(original, printed) != 0)
4375 fprintf(f, "%s(%sgenerated from %s)", sc,
4376 (ancestor != addr->parent)? "ultimately " : "",
4377 string_printing(original));
4380 fprintf(f, "%s", CS se);
4388 /*************************************************
4389 * Print error for an address *
4390 *************************************************/
4392 /* This function is called to print the error information out of an address for
4393 a bounce or a warning message. It tries to format the message reasonably by
4394 introducing newlines. All lines are indented by 4; the initial printing
4395 position must be set before calling.
4397 This function used always to print the error. Nowadays we want to restrict it
4398 to cases such as LMTP/SMTP errors from a remote host, and errors from :fail:
4399 and filter "fail". We no longer pass other information willy-nilly in bounce
4400 and warning messages. Text in user_message is always output; text in message
4401 only if the af_pass_message flag is set.
4405 f the FILE to print on
4412 print_address_error(address_item *addr, FILE *f, uschar *t)
4414 int count = Ustrlen(t);
4415 uschar *s = testflag(addr, af_pass_message)? addr->message : NULL;
4419 if (addr->user_message != NULL) s = addr->user_message; else return;
4422 fprintf(f, "\n %s", t);
4426 if (*s == '\\' && s[1] == 'n')
4436 if (*s++ == ':' && isspace(*s) && count > 45)
4438 fprintf(f, "\n "); /* sic (because space follows) */
4450 /*************************************************
4451 * Check list of addresses for duplication *
4452 *************************************************/
4454 /* This function was introduced when the test for duplicate addresses that are
4455 not pipes, files, or autoreplies was moved from the middle of routing to when
4456 routing was complete. That was to fix obscure cases when the routing history
4457 affects the subsequent routing of identical addresses. This function is called
4458 after routing, to check that the final routed addresses are not duplicates.
4460 If we detect a duplicate, we remember what it is a duplicate of. Note that
4461 pipe, file, and autoreply de-duplication is handled during routing, so we must
4462 leave such "addresses" alone here, as otherwise they will incorrectly be
4465 Argument: address of list anchor
4470 do_duplicate_check(address_item **anchor)
4473 while ((addr = *anchor) != NULL)
4476 if (testflag(addr, af_pfr))
4478 anchor = &(addr->next);
4480 else if ((tnode = tree_search(tree_duplicates, addr->unique)) != NULL)
4482 DEBUG(D_deliver|D_route)
4483 debug_printf("%s is a duplicate address: discarded\n", addr->unique);
4484 *anchor = addr->next;
4485 addr->dupof = tnode->data.ptr;
4486 addr->next = addr_duplicate;
4487 addr_duplicate = addr;
4491 tree_add_duplicate(addr->unique, addr);
4492 anchor = &(addr->next);
4500 /*************************************************
4501 * Deliver one message *
4502 *************************************************/
4504 /* This is the function which is called when a message is to be delivered. It
4505 is passed the id of the message. It is possible that the message no longer
4506 exists, if some other process has delivered it, and it is also possible that
4507 the message is being worked on by another process, in which case the data file
4510 If no delivery is attempted for any of the above reasons, the function returns
4511 DELIVER_NOT_ATTEMPTED.
4513 If the give_up flag is set true, do not attempt any deliveries, but instead
4514 fail all outstanding addresses and return the message to the sender (or
4517 A delivery operation has a process all to itself; we never deliver more than
4518 one message in the same process. Therefore we needn't worry too much about
4522 id the id of the message to be delivered
4523 forced TRUE if delivery was forced by an administrator; this overrides
4524 retry delays and causes a delivery to be tried regardless
4525 give_up TRUE if an administrator has requested that delivery attempts
4528 Returns: When the global variable mua_wrapper is FALSE:
4529 DELIVER_ATTEMPTED_NORMAL if a delivery attempt was made
4530 DELIVER_NOT_ATTEMPTED otherwise (see comment above)
4531 When the global variable mua_wrapper is TRUE:
4532 DELIVER_MUA_SUCCEEDED if delivery succeeded
4533 DELIVER_MUA_FAILED if delivery failed
4534 DELIVER_NOT_ATTEMPTED if not attempted (should not occur)
4538 deliver_message(uschar *id, BOOL forced, BOOL give_up)
4541 int final_yield = DELIVER_ATTEMPTED_NORMAL;
4542 time_t now = time(NULL);
4543 address_item *addr_last = NULL;
4544 uschar *filter_message = NULL;
4546 int process_recipients = RECIP_ACCEPT;
4549 extern int acl_where;
4551 uschar *info = (queue_run_pid == (pid_t)0)?
4552 string_sprintf("delivering %s", id) :
4553 string_sprintf("delivering %s (queue run pid %d)", id, queue_run_pid);
4555 /* If the D_process_info bit is on, set_process_info() will output debugging
4556 information. If not, we want to show this initial information if D_deliver or
4557 D_queue_run is set or in verbose mode. */
4559 set_process_info("%s", info);
4561 if ((debug_selector & D_process_info) == 0 &&
4562 (debug_selector & (D_deliver|D_queue_run|D_v)) != 0)
4563 debug_printf("%s\n", info);
4565 /* Ensure that we catch any subprocesses that are created. Although Exim
4566 sets SIG_DFL as its initial default, some routes through the code end up
4567 here with it set to SIG_IGN - cases where a non-synchronous delivery process
4568 has been forked, but no re-exec has been done. We use sigaction rather than
4569 plain signal() on those OS where SA_NOCLDWAIT exists, because we want to be
4570 sure it is turned off. (There was a problem on AIX with this.) */
4574 struct sigaction act;
4575 act.sa_handler = SIG_DFL;
4576 sigemptyset(&(act.sa_mask));
4578 sigaction(SIGCHLD, &act, NULL);
4581 signal(SIGCHLD, SIG_DFL);
4584 /* Make the forcing flag available for routers and transports, set up the
4585 global message id field, and initialize the count for returned files and the
4586 message size. This use of strcpy() is OK because the length id is checked when
4587 it is obtained from a command line (the -M or -q options), and otherwise it is
4588 known to be a valid message id. */
4590 Ustrcpy(message_id, id);
4591 deliver_force = forced;
4595 /* Initialize some flags */
4597 update_spool = FALSE;
4598 remove_journal = TRUE;
4600 /* Set a known context for any ACLs we call via expansions */
4601 acl_where = ACL_WHERE_DELIVERY;
4603 /* Reset the random number generator, so that if several delivery processes are
4604 started from a queue runner that has already used random numbers (for sorting),
4605 they don't all get the same sequence. */
4609 /* Open and lock the message's data file. Exim locks on this one because the
4610 header file may get replaced as it is re-written during the delivery process.
4611 Any failures cause messages to be written to the log, except for missing files
4612 while queue running - another process probably completed delivery. As part of
4613 opening the data file, message_subdir gets set. */
4615 if (!spool_open_datafile(id))
4616 return continue_closedown(); /* yields DELIVER_NOT_ATTEMPTED */
4618 /* The value of message_size at this point has been set to the data length,
4619 plus one for the blank line that notionally precedes the data. */
4621 /* Now read the contents of the header file, which will set up the headers in
4622 store, and also the list of recipients and the tree of non-recipients and
4623 assorted flags. It updates message_size. If there is a reading or format error,
4624 give up; if the message has been around for sufficiently long, remove it. */
4626 sprintf(CS spoolname, "%s-H", id);
4627 if ((rc = spool_read_header(spoolname, TRUE, TRUE)) != spool_read_OK)
4629 if (errno == ERRNO_SPOOLFORMAT)
4631 struct stat statbuf;
4632 sprintf(CS big_buffer, "%s/input/%s/%s", spool_directory, message_subdir,
4634 if (Ustat(big_buffer, &statbuf) == 0)
4635 log_write(0, LOG_MAIN, "Format error in spool file %s: "
4636 "size=" OFF_T_FMT, spoolname, statbuf.st_size);
4637 else log_write(0, LOG_MAIN, "Format error in spool file %s", spoolname);
4640 log_write(0, LOG_MAIN, "Error reading spool file %s: %s", spoolname,
4643 /* If we managed to read the envelope data, received_time contains the
4644 time the message was received. Otherwise, we can calculate it from the
4647 if (rc != spool_read_hdrerror)
4650 for (i = 0; i < 6; i++)
4651 received_time = received_time * BASE_62 + tab62[id[i] - '0'];
4654 /* If we've had this malformed message too long, sling it. */
4656 if (now - received_time > keep_malformed)
4658 sprintf(CS spoolname, "%s/msglog/%s/%s", spool_directory, message_subdir, id);
4660 sprintf(CS spoolname, "%s/input/%s/%s-D", spool_directory, message_subdir, id);
4662 sprintf(CS spoolname, "%s/input/%s/%s-H", spool_directory, message_subdir, id);
4664 sprintf(CS spoolname, "%s/input/%s/%s-J", spool_directory, message_subdir, id);
4666 log_write(0, LOG_MAIN, "Message removed because older than %s",
4667 readconf_printtime(keep_malformed));
4670 (void)close(deliver_datafile);
4671 deliver_datafile = -1;
4672 return continue_closedown(); /* yields DELIVER_NOT_ATTEMPTED */
4675 /* The spool header file has been read. Look to see if there is an existing
4676 journal file for this message. If there is, it means that a previous delivery
4677 attempt crashed (program or host) before it could update the spool header file.
4678 Read the list of delivered addresses from the journal and add them to the
4679 nonrecipients tree. Then update the spool file. We can leave the journal in
4680 existence, as it will get further successful deliveries added to it in this
4681 run, and it will be deleted if this function gets to its end successfully.
4682 Otherwise it might be needed again. */
4684 sprintf(CS spoolname, "%s/input/%s/%s-J", spool_directory, message_subdir, id);
4685 jread = Ufopen(spoolname, "rb");
4688 while (Ufgets(big_buffer, big_buffer_size, jread) != NULL)
4690 int n = Ustrlen(big_buffer);
4691 big_buffer[n-1] = 0;
4692 tree_add_nonrecipient(big_buffer);
4693 DEBUG(D_deliver) debug_printf("Previously delivered address %s taken from "
4694 "journal file\n", big_buffer);
4696 (void)fclose(jread);
4697 /* Panic-dies on error */
4698 (void)spool_write_header(message_id, SW_DELIVERING, NULL);
4700 else if (errno != ENOENT)
4702 log_write(0, LOG_MAIN|LOG_PANIC, "attempt to open journal for reading gave: "
4703 "%s", strerror(errno));
4704 return continue_closedown(); /* yields DELIVER_NOT_ATTEMPTED */
4707 /* A null recipients list indicates some kind of disaster. */
4709 if (recipients_list == NULL)
4711 (void)close(deliver_datafile);
4712 deliver_datafile = -1;
4713 log_write(0, LOG_MAIN, "Spool error: no recipients for %s", spoolname);
4714 return continue_closedown(); /* yields DELIVER_NOT_ATTEMPTED */
4718 /* Handle a message that is frozen. There are a number of different things that
4719 can happen, but in the default situation, unless forced, no delivery is
4724 #ifdef SUPPORT_MOVE_FROZEN_MESSAGES
4725 /* Moving to another directory removes the message from Exim's view. Other
4726 tools must be used to deal with it. Logging of this action happens in
4727 spool_move_message() and its subfunctions. */
4729 if (move_frozen_messages &&
4730 spool_move_message(id, message_subdir, US"", US"F"))
4731 return continue_closedown(); /* yields DELIVER_NOT_ATTEMPTED */
4734 /* For all frozen messages (bounces or not), timeout_frozen_after sets the
4735 maximum time to keep messages that are frozen. Thaw if we reach it, with a
4736 flag causing all recipients to be failed. The time is the age of the
4737 message, not the time since freezing. */
4739 if (timeout_frozen_after > 0 && message_age >= timeout_frozen_after)
4741 log_write(0, LOG_MAIN, "cancelled by timeout_frozen_after");
4742 process_recipients = RECIP_FAIL_TIMEOUT;
4745 /* For bounce messages (and others with no sender), thaw if the error message
4746 ignore timer is exceeded. The message will be discarded if this delivery
4749 else if (sender_address[0] == 0 && message_age >= ignore_bounce_errors_after)
4751 log_write(0, LOG_MAIN, "Unfrozen by errmsg timer");
4754 /* If this is a bounce message, or there's no auto thaw, or we haven't
4755 reached the auto thaw time yet, and this delivery is not forced by an admin
4756 user, do not attempt delivery of this message. Note that forced is set for
4757 continuing messages down the same channel, in order to skip load checking and
4758 ignore hold domains, but we don't want unfreezing in that case. */
4762 if ((sender_address[0] == 0 ||
4764 now <= deliver_frozen_at + auto_thaw
4767 (!forced || !deliver_force_thaw || !admin_user ||
4768 continue_hostname != NULL
4771 (void)close(deliver_datafile);
4772 deliver_datafile = -1;
4773 log_write(L_skip_delivery, LOG_MAIN, "Message is frozen");
4774 return continue_closedown(); /* yields DELIVER_NOT_ATTEMPTED */
4777 /* If delivery was forced (by an admin user), assume a manual thaw.
4778 Otherwise it's an auto thaw. */
4782 deliver_manual_thaw = TRUE;
4783 log_write(0, LOG_MAIN, "Unfrozen by forced delivery");
4785 else log_write(0, LOG_MAIN, "Unfrozen by auto-thaw");
4788 /* We get here if any of the rules for unfreezing have triggered. */
4790 deliver_freeze = FALSE;
4791 update_spool = TRUE;
4795 /* Open the message log file if we are using them. This records details of
4796 deliveries, deferments, and failures for the benefit of the mail administrator.
4797 The log is not used by exim itself to track the progress of a message; that is
4798 done by rewriting the header spool file. */
4805 sprintf(CS spoolname, "%s/msglog/%s/%s", spool_directory, message_subdir, id);
4806 fd = open_msglog_file(spoolname, SPOOL_MODE, &error);
4810 log_write(0, LOG_MAIN|LOG_PANIC, "Couldn't %s message log %s: %s", error,
4811 spoolname, strerror(errno));
4812 return continue_closedown(); /* yields DELIVER_NOT_ATTEMPTED */
4815 /* Make a C stream out of it. */
4817 message_log = fdopen(fd, "a");
4818 if (message_log == NULL)
4820 log_write(0, LOG_MAIN|LOG_PANIC, "Couldn't fdopen message log %s: %s",
4821 spoolname, strerror(errno));
4822 return continue_closedown(); /* yields DELIVER_NOT_ATTEMPTED */
4827 /* If asked to give up on a message, log who did it, and set the action for all
4832 struct passwd *pw = getpwuid(real_uid);
4833 log_write(0, LOG_MAIN, "cancelled by %s", (pw != NULL)?
4834 US pw->pw_name : string_sprintf("uid %ld", (long int)real_uid));
4835 process_recipients = RECIP_FAIL;
4838 /* Otherwise, if there are too many Received: headers, fail all recipients. */
4840 else if (received_count > received_headers_max)
4841 process_recipients = RECIP_FAIL_LOOP;
4843 /* Otherwise, if a system-wide, address-independent message filter is
4844 specified, run it now, except in the case when we are failing all recipients as
4845 a result of timeout_frozen_after. If the system filter yields "delivered", then
4846 ignore the true recipients of the message. Failure of the filter file is
4847 logged, and the delivery attempt fails. */
4849 else if (system_filter != NULL && process_recipients != RECIP_FAIL_TIMEOUT)
4854 redirect_block redirect;
4856 if (system_filter_uid_set)
4858 ugid.uid = system_filter_uid;
4859 ugid.gid = system_filter_gid;
4860 ugid.uid_set = ugid.gid_set = TRUE;
4864 ugid.uid_set = ugid.gid_set = FALSE;
4867 return_path = sender_address;
4868 enable_dollar_recipients = TRUE; /* Permit $recipients in system filter */
4869 system_filtering = TRUE;
4871 /* Any error in the filter file causes a delivery to be abandoned. */
4873 redirect.string = system_filter;
4874 redirect.isfile = TRUE;
4875 redirect.check_owner = redirect.check_group = FALSE;
4876 redirect.owners = NULL;
4877 redirect.owngroups = NULL;
4879 redirect.modemask = 0;
4881 DEBUG(D_deliver|D_filter) debug_printf("running system filter\n");
4884 &redirect, /* Where the data is */
4885 RDO_DEFER | /* Turn on all the enabling options */
4886 RDO_FAIL | /* Leave off all the disabling options */
4891 NULL, /* No :include: restriction (not used in filter) */
4892 NULL, /* No sieve vacation directory (not sieve!) */
4893 NULL, /* No sieve enotify mailto owner (not sieve!) */
4894 NULL, /* No sieve user address (not sieve!) */
4895 NULL, /* No sieve subaddress (not sieve!) */
4896 &ugid, /* uid/gid data */
4897 &addr_new, /* Where to hang generated addresses */
4898 &filter_message, /* Where to put error message */
4899 NULL, /* Don't skip syntax errors */
4900 &filtertype, /* Will always be set to FILTER_EXIM for this call */
4901 US"system filter"); /* For error messages */
4903 DEBUG(D_deliver|D_filter) debug_printf("system filter returned %d\n", rc);
4905 if (rc == FF_ERROR || rc == FF_NONEXIST)
4907 (void)close(deliver_datafile);
4908 deliver_datafile = -1;
4909 log_write(0, LOG_MAIN|LOG_PANIC, "Error in system filter: %s",
4910 string_printing(filter_message));
4911 return continue_closedown(); /* yields DELIVER_NOT_ATTEMPTED */
4914 /* Reset things. If the filter message is an empty string, which can happen
4915 for a filter "fail" or "freeze" command with no text, reset it to NULL. */
4917 system_filtering = FALSE;
4918 enable_dollar_recipients = FALSE;
4919 if (filter_message != NULL && filter_message[0] == 0) filter_message = NULL;
4921 /* Save the values of the system filter variables so that user filters
4924 memcpy(filter_sn, filter_n, sizeof(filter_sn));
4926 /* The filter can request that delivery of the original addresses be
4931 process_recipients = RECIP_DEFER;
4932 deliver_msglog("Delivery deferred by system filter\n");
4933 log_write(0, LOG_MAIN, "Delivery deferred by system filter");
4936 /* The filter can request that a message be frozen, but this does not
4937 take place if the message has been manually thawed. In that case, we must
4938 unset "delivered", which is forced by the "freeze" command to make -bF
4941 else if (rc == FF_FREEZE && !deliver_manual_thaw)
4943 deliver_freeze = TRUE;
4944 deliver_frozen_at = time(NULL);
4945 process_recipients = RECIP_DEFER;
4946 frozen_info = string_sprintf(" by the system filter%s%s",
4947 (filter_message == NULL)? US"" : US": ",
4948 (filter_message == NULL)? US"" : filter_message);
4951 /* The filter can request that a message be failed. The error message may be
4952 quite long - it is sent back to the sender in the bounce - but we don't want
4953 to fill up the log with repetitions of it. If it starts with << then the text
4954 between << and >> is written to the log, with the rest left for the bounce
4957 else if (rc == FF_FAIL)
4959 uschar *colon = US"";
4960 uschar *logmsg = US"";
4963 process_recipients = RECIP_FAIL_FILTER;
4965 if (filter_message != NULL)
4969 if (filter_message[0] == '<' && filter_message[1] == '<' &&
4970 (logend = Ustrstr(filter_message, ">>")) != NULL)
4972 logmsg = filter_message + 2;
4973 loglen = logend - logmsg;
4974 filter_message = logend + 2;
4975 if (filter_message[0] == 0) filter_message = NULL;
4979 logmsg = filter_message;
4980 loglen = Ustrlen(filter_message);
4984 log_write(0, LOG_MAIN, "cancelled by system filter%s%.*s", colon, loglen,
4988 /* Delivery can be restricted only to those recipients (if any) that the
4989 filter specified. */
4991 else if (rc == FF_DELIVERED)
4993 process_recipients = RECIP_IGNORE;
4994 if (addr_new == NULL)
4995 log_write(0, LOG_MAIN, "=> discarded (system filter)");
4997 log_write(0, LOG_MAIN, "original recipients ignored (system filter)");
5000 /* If any new addresses were created by the filter, fake up a "parent"
5001 for them. This is necessary for pipes, etc., which are expected to have
5002 parents, and it also gives some sensible logging for others. Allow
5003 pipes, files, and autoreplies, and run them as the filter uid if set,
5004 otherwise as the current uid. */
5006 if (addr_new != NULL)
5008 int uid = (system_filter_uid_set)? system_filter_uid : geteuid();
5009 int gid = (system_filter_gid_set)? system_filter_gid : getegid();
5011 /* The text "system-filter" is tested in transport_set_up_command() and in
5012 set_up_shell_command() in the pipe transport, to enable them to permit
5013 $recipients, so don't change it here without also changing it there. */
5015 address_item *p = addr_new;
5016 address_item *parent = deliver_make_addr(US"system-filter", FALSE);
5018 parent->domain = string_copylc(qualify_domain_recipient);
5019 parent->local_part = US"system-filter";
5021 /* As part of this loop, we arrange for addr_last to end up pointing
5022 at the final address. This is used if we go on to add addresses for the
5023 original recipients. */
5027 if (parent->child_count == SHRT_MAX)
5028 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "system filter generated more "
5029 "than %d delivery addresses", SHRT_MAX);
5030 parent->child_count++;
5033 if (testflag(p, af_pfr))
5039 setflag(p, af_uid_set |
5045 /* Find the name of the system filter's appropriate pfr transport */
5047 if (p->address[0] == '|')
5050 tpname = system_filter_pipe_transport;
5051 address_pipe = p->address;
5053 else if (p->address[0] == '>')
5056 tpname = system_filter_reply_transport;
5060 if (p->address[Ustrlen(p->address)-1] == '/')
5062 type = US"directory";
5063 tpname = system_filter_directory_transport;
5068 tpname = system_filter_file_transport;
5070 address_file = p->address;
5073 /* Now find the actual transport, first expanding the name. We have
5074 set address_file or address_pipe above. */
5078 uschar *tmp = expand_string(tpname);
5079 address_file = address_pipe = NULL;
5081 p->message = string_sprintf("failed to expand \"%s\" as a "
5082 "system filter transport name", tpname);
5087 p->message = string_sprintf("system_filter_%s_transport is unset",
5093 transport_instance *tp;
5094 for (tp = transports; tp != NULL; tp = tp->next)
5096 if (Ustrcmp(tp->name, tpname) == 0)
5103 p->message = string_sprintf("failed to find \"%s\" transport "
5104 "for system filter delivery", tpname);
5107 /* If we couldn't set up a transport, defer the delivery, putting the
5108 error on the panic log as well as the main log. */
5110 if (p->transport == NULL)
5112 address_item *badp = p;
5114 if (addr_last == NULL) addr_new = p; else addr_last->next = p;
5115 badp->local_part = badp->address; /* Needed for log line */
5116 post_process_one(badp, DEFER, LOG_MAIN|LOG_PANIC, DTYPE_ROUTER, 0);
5119 } /* End of pfr handling */
5121 /* Either a non-pfr delivery, or we found a transport */
5123 DEBUG(D_deliver|D_filter)
5124 debug_printf("system filter added %s\n", p->address);
5128 } /* Loop through all addr_new addresses */
5133 /* Scan the recipients list, and for every one that is not in the non-
5134 recipients tree, add an addr item to the chain of new addresses. If the pno
5135 value is non-negative, we must set the onetime parent from it. This which
5136 points to the relevant entry in the recipients list.
5138 This processing can be altered by the setting of the process_recipients
5139 variable, which is changed if recipients are to be ignored, failed, or
5140 deferred. This can happen as a result of system filter activity, or if the -Mg
5141 option is used to fail all of them.
5143 Duplicate addresses are handled later by a different tree structure; we can't
5144 just extend the non-recipients tree, because that will be re-written to the
5145 spool if the message is deferred, and in any case there are casing
5146 complications for local addresses. */
5148 if (process_recipients != RECIP_IGNORE)
5150 for (i = 0; i < recipients_count; i++)
5152 if (tree_search(tree_nonrecipients, recipients_list[i].address) == NULL)
5154 recipient_item *r = recipients_list + i;
5155 address_item *new = deliver_make_addr(r->address, FALSE);
5156 new->p.errors_address = r->errors_to;
5159 new->onetime_parent = recipients_list[r->pno].address;
5161 switch (process_recipients)
5163 /* RECIP_DEFER is set when a system filter freezes a message. */
5166 new->next = addr_defer;
5171 /* RECIP_FAIL_FILTER is set when a system filter has obeyed a "fail"
5174 case RECIP_FAIL_FILTER:
5176 (filter_message == NULL)? US"delivery cancelled" : filter_message;
5177 setflag(new, af_pass_message);
5178 goto RECIP_QUEUE_FAILED; /* below */
5181 /* RECIP_FAIL_TIMEOUT is set when a message is frozen, but is older
5182 than the value in timeout_frozen_after. Treat non-bounce messages
5183 similarly to -Mg; for bounce messages we just want to discard, so
5184 don't put the address on the failed list. The timeout has already
5187 case RECIP_FAIL_TIMEOUT:
5188 new->message = US"delivery cancelled; message timed out";
5189 goto RECIP_QUEUE_FAILED; /* below */
5192 /* RECIP_FAIL is set when -Mg has been used. */
5195 new->message = US"delivery cancelled by administrator";
5198 /* Common code for the failure cases above. If this is not a bounce
5199 message, put the address on the failed list so that it is used to
5200 create a bounce. Otherwise do nothing - this just discards the address.
5201 The incident has already been logged. */
5204 if (sender_address[0] != 0)
5206 new->next = addr_failed;
5212 /* RECIP_FAIL_LOOP is set when there are too many Received: headers
5213 in the message. Process each address as a routing failure; if this
5214 is a bounce message, it will get frozen. */
5216 case RECIP_FAIL_LOOP:
5217 new->message = US"Too many \"Received\" headers - suspected mail loop";
5218 post_process_one(new, FAIL, LOG_MAIN, DTYPE_ROUTER, 0);
5222 /* Value should be RECIP_ACCEPT; take this as the safe default. */
5225 if (addr_new == NULL) addr_new = new; else addr_last->next = new;
5235 address_item *p = addr_new;
5236 debug_printf("Delivery address list:\n");
5239 debug_printf(" %s %s\n", p->address, (p->onetime_parent == NULL)? US"" :
5245 /* Set up the buffers used for copying over the file when delivering. */
5247 deliver_in_buffer = store_malloc(DELIVER_IN_BUFFER_SIZE);
5248 deliver_out_buffer = store_malloc(DELIVER_OUT_BUFFER_SIZE);
5252 /* Until there are no more new addresses, handle each one as follows:
5254 . If this is a generated address (indicated by the presence of a parent
5255 pointer) then check to see whether it is a pipe, file, or autoreply, and
5256 if so, handle it directly here. The router that produced the address will
5257 have set the allow flags into the address, and also set the uid/gid required.
5258 Having the routers generate new addresses and then checking them here at
5259 the outer level is tidier than making each router do the checking, and
5260 means that routers don't need access to the failed address queue.
5262 . Break up the address into local part and domain, and make lowercased
5263 versions of these strings. We also make unquoted versions of the local part.
5265 . Handle the percent hack for those domains for which it is valid.
5267 . For child addresses, determine if any of the parents have the same address.
5268 If so, generate a different string for previous delivery checking. Without
5269 this code, if the address spqr generates spqr via a forward or alias file,
5270 delivery of the generated spqr stops further attempts at the top level spqr,
5271 which is not what is wanted - it may have generated other addresses.
5273 . Check on the retry database to see if routing was previously deferred, but
5274 only if in a queue run. Addresses that are to be routed are put on the
5275 addr_route chain. Addresses that are to be deferred are put on the
5276 addr_defer chain. We do all the checking first, so as not to keep the
5277 retry database open any longer than necessary.
5279 . Now we run the addresses through the routers. A router may put the address
5280 on either the addr_local or the addr_remote chain for local or remote
5281 delivery, respectively, or put it on the addr_failed chain if it is
5282 undeliveable, or it may generate child addresses and put them on the
5283 addr_new chain, or it may defer an address. All the chain anchors are
5284 passed as arguments so that the routers can be called for verification
5287 . If new addresses have been generated by the routers, da capo.
5290 header_rewritten = FALSE; /* No headers rewritten yet */
5291 while (addr_new != NULL) /* Loop until all addresses dealt with */
5293 address_item *addr, *parent;
5294 dbm_file = dbfn_open(US"retry", O_RDONLY, &dbblock, FALSE);
5296 /* Failure to open the retry database is treated the same as if it does
5297 not exist. In both cases, dbm_file is NULL. */
5299 if (dbm_file == NULL)
5301 DEBUG(D_deliver|D_retry|D_route|D_hints_lookup)
5302 debug_printf("no retry data available\n");
5305 /* Scan the current batch of new addresses, to handle pipes, files and
5306 autoreplies, and determine which others are ready for routing. */
5308 while (addr_new != NULL)
5313 dbdata_retry *domain_retry_record;
5314 dbdata_retry *address_retry_record;
5317 addr_new = addr->next;
5319 DEBUG(D_deliver|D_retry|D_route)
5321 debug_printf(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n");
5322 debug_printf("Considering: %s\n", addr->address);
5325 /* Handle generated address that is a pipe or a file or an autoreply. */
5327 if (testflag(addr, af_pfr))
5329 /* If an autoreply in a filter could not generate a syntactically valid
5330 address, give up forthwith. Set af_ignore_error so that we don't try to
5331 generate a bounce. */
5333 if (testflag(addr, af_bad_reply))
5335 addr->basic_errno = ERRNO_BADADDRESS2;
5336 addr->local_part = addr->address;
5338 US"filter autoreply generated syntactically invalid recipient";
5339 setflag(addr, af_ignore_error);
5340 (void)post_process_one(addr, FAIL, LOG_MAIN, DTYPE_ROUTER, 0);
5341 continue; /* with the next new address */
5344 /* If two different users specify delivery to the same pipe or file or
5345 autoreply, there should be two different deliveries, so build a unique
5346 string that incorporates the original address, and use this for
5347 duplicate testing and recording delivery, and also for retrying. */
5350 string_sprintf("%s:%s", addr->address, addr->parent->unique +
5351 (testflag(addr->parent, af_homonym)? 3:0));
5353 addr->address_retry_key = addr->domain_retry_key =
5354 string_sprintf("T:%s", addr->unique);
5356 /* If a filter file specifies two deliveries to the same pipe or file,
5357 we want to de-duplicate, but this is probably not wanted for two mail
5358 commands to the same address, where probably both should be delivered.
5359 So, we have to invent a different unique string in that case. Just
5360 keep piling '>' characters on the front. */
5362 if (addr->address[0] == '>')
5364 while (tree_search(tree_duplicates, addr->unique) != NULL)
5365 addr->unique = string_sprintf(">%s", addr->unique);
5368 else if ((tnode = tree_search(tree_duplicates, addr->unique)) != NULL)
5370 DEBUG(D_deliver|D_route)
5371 debug_printf("%s is a duplicate address: discarded\n", addr->address);
5372 addr->dupof = tnode->data.ptr;
5373 addr->next = addr_duplicate;
5374 addr_duplicate = addr;
5378 DEBUG(D_deliver|D_route) debug_printf("unique = %s\n", addr->unique);
5380 /* Check for previous delivery */
5382 if (tree_search(tree_nonrecipients, addr->unique) != NULL)
5384 DEBUG(D_deliver|D_route)
5385 debug_printf("%s was previously delivered: discarded\n", addr->address);
5386 child_done(addr, tod_stamp(tod_log));
5390 /* Save for checking future duplicates */
5392 tree_add_duplicate(addr->unique, addr);
5394 /* Set local part and domain */
5396 addr->local_part = addr->address;
5397 addr->domain = addr->parent->domain;
5399 /* Ensure that the delivery is permitted. */
5401 if (testflag(addr, af_file))
5403 if (!testflag(addr, af_allow_file))
5405 addr->basic_errno = ERRNO_FORBIDFILE;
5406 addr->message = US"delivery to file forbidden";
5407 (void)post_process_one(addr, FAIL, LOG_MAIN, DTYPE_ROUTER, 0);
5408 continue; /* with the next new address */
5411 else if (addr->address[0] == '|')
5413 if (!testflag(addr, af_allow_pipe))
5415 addr->basic_errno = ERRNO_FORBIDPIPE;
5416 addr->message = US"delivery to pipe forbidden";
5417 (void)post_process_one(addr, FAIL, LOG_MAIN, DTYPE_ROUTER, 0);
5418 continue; /* with the next new address */
5421 else if (!testflag(addr, af_allow_reply))
5423 addr->basic_errno = ERRNO_FORBIDREPLY;
5424 addr->message = US"autoreply forbidden";
5425 (void)post_process_one(addr, FAIL, LOG_MAIN, DTYPE_ROUTER, 0);
5426 continue; /* with the next new address */
5429 /* If the errno field is already set to BADTRANSPORT, it indicates
5430 failure to expand a transport string, or find the associated transport,
5431 or an unset transport when one is required. Leave this test till now so
5432 that the forbid errors are given in preference. */
5434 if (addr->basic_errno == ERRNO_BADTRANSPORT)
5436 (void)post_process_one(addr, DEFER, LOG_MAIN, DTYPE_ROUTER, 0);
5440 /* Treat /dev/null as a special case and abandon the delivery. This
5441 avoids having to specify a uid on the transport just for this case.
5442 Arrange for the transport name to be logged as "**bypassed**". */
5444 if (Ustrcmp(addr->address, "/dev/null") == 0)
5446 uschar *save = addr->transport->name;
5447 addr->transport->name = US"**bypassed**";
5448 (void)post_process_one(addr, OK, LOG_MAIN, DTYPE_TRANSPORT, '=');
5449 addr->transport->name = save;
5450 continue; /* with the next new address */
5453 /* Pipe, file, or autoreply delivery is to go ahead as a normal local
5456 DEBUG(D_deliver|D_route)
5457 debug_printf("queued for %s transport\n", addr->transport->name);
5458 addr->next = addr_local;
5460 continue; /* with the next new address */
5463 /* Handle normal addresses. First, split up into local part and domain,
5464 handling the %-hack if necessary. There is the possibility of a defer from
5465 a lookup in percent_hack_domains. */
5467 if ((rc = deliver_split_address(addr)) == DEFER)
5469 addr->message = US"cannot check percent_hack_domains";
5470 addr->basic_errno = ERRNO_LISTDEFER;
5471 (void)post_process_one(addr, DEFER, LOG_MAIN, DTYPE_NONE, 0);
5475 /* Check to see if the domain is held. If so, proceed only if the
5476 delivery was forced by hand. */
5478 deliver_domain = addr->domain; /* set $domain */
5479 if (!forced && hold_domains != NULL &&
5480 (rc = match_isinlist(addr->domain, &hold_domains, 0,
5481 &domainlist_anchor, addr->domain_cache, MCL_DOMAIN, TRUE,
5486 addr->message = US"hold_domains lookup deferred";
5487 addr->basic_errno = ERRNO_LISTDEFER;
5491 addr->message = US"domain is held";
5492 addr->basic_errno = ERRNO_HELD;
5494 (void)post_process_one(addr, DEFER, LOG_MAIN, DTYPE_NONE, 0);
5498 /* Now we can check for duplicates and previously delivered addresses. In
5499 order to do this, we have to generate a "unique" value for each address,
5500 because there may be identical actual addresses in a line of descendents.
5501 The "unique" field is initialized to the same value as the "address" field,
5502 but gets changed here to cope with identically-named descendents. */
5504 for (parent = addr->parent; parent != NULL; parent = parent->parent)
5505 if (strcmpic(addr->address, parent->address) == 0) break;
5507 /* If there's an ancestor with the same name, set the homonym flag. This
5508 influences how deliveries are recorded. Then add a prefix on the front of
5509 the unique address. We use \n\ where n starts at 0 and increases each time.
5510 It is unlikely to pass 9, but if it does, it may look odd but will still
5511 work. This means that siblings or cousins with the same names are treated
5512 as duplicates, which is what we want. */
5516 setflag(addr, af_homonym);
5517 if (parent->unique[0] != '\\')
5518 addr->unique = string_sprintf("\\0\\%s", addr->address);
5520 addr->unique = string_sprintf("\\%c\\%s", parent->unique[1] + 1,
5524 /* Ensure that the domain in the unique field is lower cased, because
5525 domains are always handled caselessly. */
5527 p = Ustrrchr(addr->unique, '@');
5528 while (*p != 0) { *p = tolower(*p); p++; }
5530 DEBUG(D_deliver|D_route) debug_printf("unique = %s\n", addr->unique);
5532 if (tree_search(tree_nonrecipients, addr->unique) != NULL)
5534 DEBUG(D_deliver|D_route)
5535 debug_printf("%s was previously delivered: discarded\n", addr->unique);
5536 child_done(addr, tod_stamp(tod_log));
5540 /* Get the routing retry status, saving the two retry keys (with and
5541 without the local part) for subsequent use. If there is no retry record for
5542 the standard address routing retry key, we look for the same key with the
5543 sender attached, because this form is used by the smtp transport after a
5544 4xx response to RCPT when address_retry_include_sender is true. */
5546 addr->domain_retry_key = string_sprintf("R:%s", addr->domain);
5547 addr->address_retry_key = string_sprintf("R:%s@%s", addr->local_part,
5550 if (dbm_file == NULL)
5551 domain_retry_record = address_retry_record = NULL;
5554 domain_retry_record = dbfn_read(dbm_file, addr->domain_retry_key);
5555 if (domain_retry_record != NULL &&
5556 now - domain_retry_record->time_stamp > retry_data_expire)
5557 domain_retry_record = NULL; /* Ignore if too old */
5559 address_retry_record = dbfn_read(dbm_file, addr->address_retry_key);
5560 if (address_retry_record != NULL &&
5561 now - address_retry_record->time_stamp > retry_data_expire)
5562 address_retry_record = NULL; /* Ignore if too old */
5564 if (address_retry_record == NULL)
5566 uschar *altkey = string_sprintf("%s:<%s>", addr->address_retry_key,
5568 address_retry_record = dbfn_read(dbm_file, altkey);
5569 if (address_retry_record != NULL &&
5570 now - address_retry_record->time_stamp > retry_data_expire)
5571 address_retry_record = NULL; /* Ignore if too old */
5575 DEBUG(D_deliver|D_retry)
5577 if (domain_retry_record == NULL)
5578 debug_printf("no domain retry record\n");
5579 if (address_retry_record == NULL)
5580 debug_printf("no address retry record\n");
5583 /* If we are sending a message down an existing SMTP connection, we must
5584 assume that the message which created the connection managed to route
5585 an address to that connection. We do not want to run the risk of taking
5586 a long time over routing here, because if we do, the server at the other
5587 end of the connection may time it out. This is especially true for messages
5588 with lots of addresses. For this kind of delivery, queue_running is not
5589 set, so we would normally route all addresses. We take a pragmatic approach
5590 and defer routing any addresses that have any kind of domain retry record.
5591 That is, we don't even look at their retry times. It doesn't matter if this
5592 doesn't work occasionally. This is all just an optimization, after all.
5594 The reason for not doing the same for address retries is that they normally
5595 arise from 4xx responses, not DNS timeouts. */
5597 if (continue_hostname != NULL && domain_retry_record != NULL)
5599 addr->message = US"reusing SMTP connection skips previous routing defer";
5600 addr->basic_errno = ERRNO_RRETRY;
5601 (void)post_process_one(addr, DEFER, LOG_MAIN, DTYPE_ROUTER, 0);
5604 /* If we are in a queue run, defer routing unless there is no retry data or
5605 we've passed the next retry time, or this message is forced. In other
5606 words, ignore retry data when not in a queue run.
5608 However, if the domain retry time has expired, always allow the routing
5609 attempt. If it fails again, the address will be failed. This ensures that
5610 each address is routed at least once, even after long-term routing
5613 If there is an address retry, check that too; just wait for the next
5614 retry time. This helps with the case when the temporary error on the
5615 address was really message-specific rather than address specific, since
5616 it allows other messages through.
5618 We also wait for the next retry time if this is a message sent down an
5619 existing SMTP connection (even though that will be forced). Otherwise there
5620 will be far too many attempts for an address that gets a 4xx error. In
5621 fact, after such an error, we should not get here because, the host should
5622 not be remembered as one this message needs. However, there was a bug that
5623 used to cause this to happen, so it is best to be on the safe side.
5625 Even if we haven't reached the retry time in the hints, there is one
5626 more check to do, which is for the ultimate address timeout. */
5628 else if (((queue_running && !deliver_force) || continue_hostname != NULL)
5630 ((domain_retry_record != NULL &&
5631 now < domain_retry_record->next_try &&
5632 !domain_retry_record->expired)
5634 (address_retry_record != NULL &&
5635 now < address_retry_record->next_try))
5637 !retry_ultimate_address_timeout(addr->address_retry_key,
5638 addr->domain, address_retry_record, now)
5641 addr->message = US"retry time not reached";
5642 addr->basic_errno = ERRNO_RRETRY;
5643 (void)post_process_one(addr, DEFER, LOG_MAIN, DTYPE_ROUTER, 0);
5646 /* The domain is OK for routing. Remember if retry data exists so it
5647 can be cleaned up after a successful delivery. */
5651 if (domain_retry_record != NULL || address_retry_record != NULL)
5652 setflag(addr, af_dr_retry_exists);
5653 addr->next = addr_route;
5655 DEBUG(D_deliver|D_route)
5656 debug_printf("%s: queued for routing\n", addr->address);
5660 /* The database is closed while routing is actually happening. Requests to
5661 update it are put on a chain and all processed together at the end. */
5663 if (dbm_file != NULL) dbfn_close(dbm_file);
5665 /* If queue_domains is set, we don't even want to try routing addresses in
5666 those domains. During queue runs, queue_domains is forced to be unset.
5667 Optimize by skipping this pass through the addresses if nothing is set. */
5669 if (!deliver_force && queue_domains != NULL)
5671 address_item *okaddr = NULL;
5672 while (addr_route != NULL)
5674 address_item *addr = addr_route;
5675 addr_route = addr->next;
5677 deliver_domain = addr->domain; /* set $domain */
5678 if ((rc = match_isinlist(addr->domain, &queue_domains, 0,
5679 &domainlist_anchor, addr->domain_cache, MCL_DOMAIN, TRUE, NULL))
5684 addr->basic_errno = ERRNO_LISTDEFER;
5685 addr->message = US"queue_domains lookup deferred";
5686 (void)post_process_one(addr, DEFER, LOG_MAIN, DTYPE_ROUTER, 0);
5690 addr->next = okaddr;
5696 addr->basic_errno = ERRNO_QUEUE_DOMAIN;
5697 addr->message = US"domain is in queue_domains";
5698 (void)post_process_one(addr, DEFER, LOG_MAIN, DTYPE_ROUTER, 0);
5702 addr_route = okaddr;
5705 /* Now route those addresses that are not deferred. */
5707 while (addr_route != NULL)
5710 address_item *addr = addr_route;
5711 uschar *old_domain = addr->domain;
5712 uschar *old_unique = addr->unique;
5713 addr_route = addr->next;
5716 /* Just in case some router parameter refers to it. */
5718 return_path = (addr->p.errors_address != NULL)?
5719 addr->p.errors_address : sender_address;
5721 /* If a router defers an address, add a retry item. Whether or not to
5722 use the local part in the key is a property of the router. */
5724 if ((rc = route_address(addr, &addr_local, &addr_remote, &addr_new,
5725 &addr_succeed, v_none)) == DEFER)
5726 retry_add_item(addr, (addr->router->retry_use_local_part)?
5727 string_sprintf("R:%s@%s", addr->local_part, addr->domain) :
5728 string_sprintf("R:%s", addr->domain), 0);
5730 /* Otherwise, if there is an existing retry record in the database, add
5731 retry items to delete both forms. We must also allow for the possibility
5732 of a routing retry that includes the sender address. Since the domain might
5733 have been rewritten (expanded to fully qualified) as a result of routing,
5734 ensure that the rewritten form is also deleted. */
5736 else if (testflag(addr, af_dr_retry_exists))
5738 uschar *altkey = string_sprintf("%s:<%s>", addr->address_retry_key,
5740 retry_add_item(addr, altkey, rf_delete);
5741 retry_add_item(addr, addr->address_retry_key, rf_delete);
5742 retry_add_item(addr, addr->domain_retry_key, rf_delete);
5743 if (Ustrcmp(addr->domain, old_domain) != 0)
5744 retry_add_item(addr, string_sprintf("R:%s", old_domain), rf_delete);
5747 /* DISCARD is given for :blackhole: and "seen finish". The event has been
5748 logged, but we need to ensure the address (and maybe parents) is marked
5753 address_done(addr, tod_stamp(tod_log));
5754 continue; /* route next address */
5757 /* The address is finished with (failed or deferred). */
5761 (void)post_process_one(addr, rc, LOG_MAIN, DTYPE_ROUTER, 0);
5762 continue; /* route next address */
5765 /* The address has been routed. If the router changed the domain, it will
5766 also have changed the unique address. We have to test whether this address
5767 has already been delivered, because it's the unique address that finally
5770 if (addr->unique != old_unique &&
5771 tree_search(tree_nonrecipients, addr->unique) != 0)
5773 DEBUG(D_deliver|D_route) debug_printf("%s was previously delivered: "
5774 "discarded\n", addr->address);
5775 if (addr_remote == addr) addr_remote = addr->next;
5776 else if (addr_local == addr) addr_local = addr->next;
5779 /* If the router has same_domain_copy_routing set, we are permitted to copy
5780 the routing for any other addresses with the same domain. This is an
5781 optimisation to save repeated DNS lookups for "standard" remote domain
5782 routing. The option is settable only on routers that generate host lists.
5783 We play it very safe, and do the optimization only if the address is routed
5784 to a remote transport, there are no header changes, and the domain was not
5785 modified by the router. */
5787 if (addr_remote == addr &&
5788 addr->router->same_domain_copy_routing &&
5789 addr->p.extra_headers == NULL &&
5790 addr->p.remove_headers == NULL &&
5791 old_domain == addr->domain)
5793 address_item **chain = &addr_route;
5794 while (*chain != NULL)
5796 address_item *addr2 = *chain;
5797 if (Ustrcmp(addr2->domain, addr->domain) != 0)
5799 chain = &(addr2->next);
5803 /* Found a suitable address; take it off the routing list and add it to
5804 the remote delivery list. */
5806 *chain = addr2->next;
5807 addr2->next = addr_remote;
5808 addr_remote = addr2;
5810 /* Copy the routing data */
5812 addr2->domain = addr->domain;
5813 addr2->router = addr->router;
5814 addr2->transport = addr->transport;
5815 addr2->host_list = addr->host_list;
5816 addr2->fallback_hosts = addr->fallback_hosts;
5817 addr2->p.errors_address = addr->p.errors_address;
5818 copyflag(addr2, addr, af_hide_child | af_local_host_removed);
5820 DEBUG(D_deliver|D_route)
5822 debug_printf(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n"
5824 "Routing for %s copied from %s\n",
5825 addr2->address, addr2->address, addr->address);
5829 } /* Continue with routing the next address. */
5830 } /* Loop to process any child addresses that the routers created, and
5831 any rerouted addresses that got put back on the new chain. */
5834 /* Debugging: show the results of the routing */
5836 DEBUG(D_deliver|D_retry|D_route)
5838 address_item *p = addr_local;
5839 debug_printf(">>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>>\n");
5840 debug_printf("After routing:\n Local deliveries:\n");
5843 debug_printf(" %s\n", p->address);
5848 debug_printf(" Remote deliveries:\n");
5851 debug_printf(" %s\n", p->address);
5856 debug_printf(" Failed addresses:\n");
5859 debug_printf(" %s\n", p->address);
5864 debug_printf(" Deferred addresses:\n");
5867 debug_printf(" %s\n", p->address);
5872 /* Free any resources that were cached during routing. */
5877 /* These two variables are set only during routing, after check_local_user.
5878 Ensure they are not set in transports. */
5880 local_user_gid = (gid_t)(-1);
5881 local_user_uid = (uid_t)(-1);
5883 /* Check for any duplicate addresses. This check is delayed until after
5884 routing, because the flexibility of the routing configuration means that
5885 identical addresses with different parentage may end up being redirected to
5886 different addresses. Checking for duplicates too early (as we previously used
5887 to) makes this kind of thing not work. */
5889 do_duplicate_check(&addr_local);
5890 do_duplicate_check(&addr_remote);
5892 /* When acting as an MUA wrapper, we proceed only if all addresses route to a
5893 remote transport. The check that they all end up in one transaction happens in
5894 the do_remote_deliveries() function. */
5896 if (mua_wrapper && (addr_local != NULL || addr_failed != NULL ||
5897 addr_defer != NULL))
5900 uschar *which, *colon, *msg;
5902 if (addr_local != NULL)
5907 else if (addr_defer != NULL)
5910 which = US"deferred";
5918 while (addr->parent != NULL) addr = addr->parent;
5920 if (addr->message != NULL)
5923 msg = addr->message;
5925 else colon = msg = US"";
5927 /* We don't need to log here for a forced failure as it will already
5928 have been logged. Defer will also have been logged, but as a defer, so we do
5929 need to do the failure logging. */
5931 if (addr != addr_failed)
5932 log_write(0, LOG_MAIN, "** %s routing yielded a %s delivery",
5933 addr->address, which);
5935 /* Always write an error to the caller */
5937 fprintf(stderr, "routing %s yielded a %s delivery%s%s\n", addr->address,
5940 final_yield = DELIVER_MUA_FAILED;
5941 addr_failed = addr_defer = NULL; /* So that we remove the message */
5942 goto DELIVERY_TIDYUP;
5946 /* If this is a run to continue deliveries to an external channel that is
5947 already set up, defer any local deliveries. */
5949 if (continue_transport != NULL)
5951 if (addr_defer == NULL) addr_defer = addr_local; else
5953 address_item *addr = addr_defer;
5954 while (addr->next != NULL) addr = addr->next;
5955 addr->next = addr_local;
5961 /* Because address rewriting can happen in the routers, we should not really do
5962 ANY deliveries until all addresses have been routed, so that all recipients of
5963 the message get the same headers. However, this is in practice not always
5964 possible, since sometimes remote addresses give DNS timeouts for days on end.
5965 The pragmatic approach is to deliver what we can now, saving any rewritten
5966 headers so that at least the next lot of recipients benefit from the rewriting
5967 that has already been done.
5969 If any headers have been rewritten during routing, update the spool file to
5970 remember them for all subsequent deliveries. This can be delayed till later if
5971 there is only address to be delivered - if it succeeds the spool write need not
5974 if (header_rewritten &&
5975 ((addr_local != NULL &&
5976 (addr_local->next != NULL || addr_remote != NULL)) ||
5977 (addr_remote != NULL && addr_remote->next != NULL)))
5979 /* Panic-dies on error */
5980 (void)spool_write_header(message_id, SW_DELIVERING, NULL);
5981 header_rewritten = FALSE;
5985 /* If there are any deliveries to be done, open the journal file. This is used
5986 to record successful deliveries as soon as possible after each delivery is
5987 known to be complete. A file opened with O_APPEND is used so that several
5988 processes can run simultaneously.
5990 The journal is just insurance against crashes. When the spool file is
5991 ultimately updated at the end of processing, the journal is deleted. If a
5992 journal is found to exist at the start of delivery, the addresses listed
5993 therein are added to the non-recipients. */
5995 if (addr_local != NULL || addr_remote != NULL)
5997 sprintf(CS spoolname, "%s/input/%s/%s-J", spool_directory, message_subdir, id);
5998 journal_fd = Uopen(spoolname, O_WRONLY|O_APPEND|O_CREAT, SPOOL_MODE);
6002 log_write(0, LOG_MAIN|LOG_PANIC, "Couldn't open journal file %s: %s",
6003 spoolname, strerror(errno));
6004 return DELIVER_NOT_ATTEMPTED;
6007 /* Set the close-on-exec flag, make the file owned by Exim, and ensure
6008 that the mode is correct - the group setting doesn't always seem to get
6009 set automatically. */
6011 if( fcntl(journal_fd, F_SETFD, fcntl(journal_fd, F_GETFD) | FD_CLOEXEC)
6012 || fchown(journal_fd, exim_uid, exim_gid)
6013 || fchmod(journal_fd, SPOOL_MODE)
6016 int ret = Uunlink(spoolname);
6017 log_write(0, LOG_MAIN|LOG_PANIC, "Couldn't set perms on journal file %s: %s",
6018 spoolname, strerror(errno));
6019 if(ret && errno != ENOENT)
6020 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to unlink %s: %s",
6021 spoolname, strerror(errno));
6022 return DELIVER_NOT_ATTEMPTED;
6028 /* Now we can get down to the business of actually doing deliveries. Local
6029 deliveries are done first, then remote ones. If ever the problems of how to
6030 handle fallback transports are figured out, this section can be put into a loop
6031 for handling fallbacks, though the uid switching will have to be revised. */
6033 /* Precompile a regex that is used to recognize a parameter in response
6034 to an LHLO command, if is isn't already compiled. This may be used on both
6035 local and remote LMTP deliveries. */
6037 if (regex_IGNOREQUOTA == NULL) regex_IGNOREQUOTA =
6038 regex_must_compile(US"\\n250[\\s\\-]IGNOREQUOTA(\\s|\\n|$)", FALSE, TRUE);
6040 /* Handle local deliveries */
6042 if (addr_local != NULL)
6044 DEBUG(D_deliver|D_transport)
6045 debug_printf(">>>>>>>>>>>>>>>> Local deliveries >>>>>>>>>>>>>>>>\n");
6046 do_local_deliveries();
6047 disable_logging = FALSE;
6050 /* If queue_run_local is set, we do not want to attempt any remote deliveries,
6051 so just queue them all. */
6053 if (queue_run_local)
6055 while (addr_remote != NULL)
6057 address_item *addr = addr_remote;
6058 addr_remote = addr->next;
6060 addr->basic_errno = ERRNO_LOCAL_ONLY;
6061 addr->message = US"remote deliveries suppressed";
6062 (void)post_process_one(addr, DEFER, LOG_MAIN, DTYPE_TRANSPORT, 0);
6066 /* Handle remote deliveries */
6068 if (addr_remote != NULL)
6070 DEBUG(D_deliver|D_transport)
6071 debug_printf(">>>>>>>>>>>>>>>> Remote deliveries >>>>>>>>>>>>>>>>\n");
6073 /* Precompile some regex that are used to recognize parameters in response
6074 to an EHLO command, if they aren't already compiled. */
6076 if (regex_PIPELINING == NULL) regex_PIPELINING =
6077 regex_must_compile(US"\\n250[\\s\\-]PIPELINING(\\s|\\n|$)", FALSE, TRUE);
6079 if (regex_SIZE == NULL) regex_SIZE =
6080 regex_must_compile(US"\\n250[\\s\\-]SIZE(\\s|\\n|$)", FALSE, TRUE);
6082 if (regex_AUTH == NULL) regex_AUTH =
6083 regex_must_compile(US"\\n250[\\s\\-]AUTH\\s+([\\-\\w\\s]+)(?:\\n|$)",
6087 if (regex_STARTTLS == NULL) regex_STARTTLS =
6088 regex_must_compile(US"\\n250[\\s\\-]STARTTLS(\\s|\\n|$)", FALSE, TRUE);
6091 /* Now sort the addresses if required, and do the deliveries. The yield of
6092 do_remote_deliveries is FALSE when mua_wrapper is set and all addresses
6093 cannot be delivered in one transaction. */
6095 if (remote_sort_domains != NULL) sort_remote_deliveries();
6096 if (!do_remote_deliveries(FALSE))
6098 log_write(0, LOG_MAIN, "** mua_wrapper is set but recipients cannot all "
6099 "be delivered in one transaction");
6100 fprintf(stderr, "delivery to smarthost failed (configuration problem)\n");
6102 final_yield = DELIVER_MUA_FAILED;
6103 addr_failed = addr_defer = NULL; /* So that we remove the message */
6104 goto DELIVERY_TIDYUP;
6107 /* See if any of the addresses that failed got put on the queue for delivery
6108 to their fallback hosts. We do it this way because often the same fallback
6109 host is used for many domains, so all can be sent in a single transaction
6110 (if appropriately configured). */
6112 if (addr_fallback != NULL && !mua_wrapper)
6114 DEBUG(D_deliver) debug_printf("Delivering to fallback hosts\n");
6115 addr_remote = addr_fallback;
6116 addr_fallback = NULL;
6117 if (remote_sort_domains != NULL) sort_remote_deliveries();
6118 do_remote_deliveries(TRUE);
6120 disable_logging = FALSE;
6124 /* All deliveries are now complete. Ignore SIGTERM during this tidying up
6125 phase, to minimize cases of half-done things. */
6128 debug_printf(">>>>>>>>>>>>>>>> deliveries are done >>>>>>>>>>>>>>>>\n");
6130 /* Root privilege is no longer needed */
6132 exim_setugid(exim_uid, exim_gid, FALSE, US"post-delivery tidying");
6134 set_process_info("tidying up after delivering %s", message_id);
6135 signal(SIGTERM, SIG_IGN);
6137 /* When we are acting as an MUA wrapper, the smtp transport will either have
6138 succeeded for all addresses, or failed them all in normal cases. However, there
6139 are some setup situations (e.g. when a named port does not exist) that cause an
6140 immediate exit with deferral of all addresses. Convert those into failures. We
6141 do not ever want to retry, nor do we want to send a bounce message. */
6145 if (addr_defer != NULL)
6147 address_item *addr, *nextaddr;
6148 for (addr = addr_defer; addr != NULL; addr = nextaddr)
6150 log_write(0, LOG_MAIN, "** %s mua_wrapper forced failure for deferred "
6151 "delivery", addr->address);
6152 nextaddr = addr->next;
6153 addr->next = addr_failed;
6159 /* Now all should either have succeeded or failed. */
6161 if (addr_failed == NULL) final_yield = DELIVER_MUA_SUCCEEDED; else
6163 uschar *s = (addr_failed->user_message != NULL)?
6164 addr_failed->user_message : addr_failed->message;
6166 fprintf(stderr, "Delivery failed: ");
6167 if (addr_failed->basic_errno > 0)
6169 fprintf(stderr, "%s", strerror(addr_failed->basic_errno));
6170 if (s != NULL) fprintf(stderr, ": ");
6174 if (addr_failed->basic_errno <= 0) fprintf(stderr, "unknown error");
6176 else fprintf(stderr, "%s", CS s);
6177 fprintf(stderr, "\n");
6179 final_yield = DELIVER_MUA_FAILED;
6184 /* In a normal configuration, we now update the retry database. This is done in
6185 one fell swoop at the end in order not to keep opening and closing (and
6186 locking) the database. The code for handling retries is hived off into a
6187 separate module for convenience. We pass it the addresses of the various
6188 chains, because deferred addresses can get moved onto the failed chain if the
6189 retry cutoff time has expired for all alternative destinations. Bypass the
6190 updating of the database if the -N flag is set, which is a debugging thing that
6191 prevents actual delivery. */
6193 else if (!dont_deliver) retry_update(&addr_defer, &addr_failed, &addr_succeed);
6195 /* If any addresses failed, we must send a message to somebody, unless
6196 af_ignore_error is set, in which case no action is taken. It is possible for
6197 several messages to get sent if there are addresses with different
6200 while (addr_failed != NULL)
6204 uschar *logtod = tod_stamp(tod_log);
6206 address_item *handled_addr = NULL;
6207 address_item **paddr;
6208 address_item *msgchain = NULL;
6209 address_item **pmsgchain = &msgchain;
6211 /* There are weird cases when logging is disabled in the transport. However,
6212 there may not be a transport (address failed by a router). */
6214 disable_logging = FALSE;
6215 if (addr_failed->transport != NULL)
6216 disable_logging = addr_failed->transport->disable_logging;
6219 debug_printf("processing failed address %s\n", addr_failed->address);
6221 /* There are only two ways an address in a bounce message can get here:
6223 (1) When delivery was initially deferred, but has now timed out (in the call
6224 to retry_update() above). We can detect this by testing for
6225 af_retry_timedout. If the address does not have its own errors address,
6226 we arrange to ignore the error.
6228 (2) If delivery failures for bounce messages are being ignored. We can detect
6229 this by testing for af_ignore_error. This will also be set if a bounce
6230 message has been autothawed and the ignore_bounce_errors_after time has
6231 passed. It might also be set if a router was explicitly configured to
6232 ignore errors (errors_to = "").
6234 If neither of these cases obtains, something has gone wrong. Log the
6235 incident, but then ignore the error. */
6237 if (sender_address[0] == 0 && addr_failed->p.errors_address == NULL)
6239 if (!testflag(addr_failed, af_retry_timedout) &&
6240 !testflag(addr_failed, af_ignore_error))
6242 log_write(0, LOG_MAIN|LOG_PANIC, "internal error: bounce message "
6243 "failure is neither frozen nor ignored (it's been ignored)");
6245 setflag(addr_failed, af_ignore_error);
6248 /* If the first address on the list has af_ignore_error set, just remove
6249 it from the list, throw away any saved message file, log it, and
6250 mark the recipient done. */
6252 if (testflag(addr_failed, af_ignore_error))
6255 addr_failed = addr->next;
6256 if (addr->return_filename != NULL) Uunlink(addr->return_filename);
6258 log_write(0, LOG_MAIN, "%s%s%s%s: error ignored",
6260 (addr->parent == NULL)? US"" : US" <",
6261 (addr->parent == NULL)? US"" : addr->parent->address,
6262 (addr->parent == NULL)? US"" : US">");
6264 address_done(addr, logtod);
6265 child_done(addr, logtod);
6266 /* Panic-dies on error */
6267 (void)spool_write_header(message_id, SW_DELIVERING, NULL);
6270 /* Otherwise, handle the sending of a message. Find the error address for
6271 the first address, then send a message that includes all failed addresses
6272 that have the same error address. Note the bounce_recipient is a global so
6273 that it can be accesssed by $bounce_recipient while creating a customized
6278 bounce_recipient = (addr_failed->p.errors_address == NULL)?
6279 sender_address : addr_failed->p.errors_address;
6281 /* Make a subprocess to send a message */
6283 pid = child_open_exim(&fd);
6285 /* Creation of child failed */
6288 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Process %d (parent %d) failed to "
6289 "create child process to send failure message: %s", getpid(),
6290 getppid(), strerror(errno));
6292 /* Creation of child succeeded */
6299 uschar *bcc, *emf_text;
6300 FILE *f = fdopen(fd, "wb");
6302 BOOL to_sender = strcmpic(sender_address, bounce_recipient) == 0;
6303 int max = (bounce_return_size_limit/DELIVER_IN_BUFFER_SIZE + 1) *
6304 DELIVER_IN_BUFFER_SIZE;
6307 debug_printf("sending error message to: %s\n", bounce_recipient);
6309 /* Scan the addresses for all that have the same errors address, removing
6310 them from the addr_failed chain, and putting them on msgchain. */
6312 paddr = &addr_failed;
6313 for (addr = addr_failed; addr != NULL; addr = *paddr)
6315 if (Ustrcmp(bounce_recipient, (addr->p.errors_address == NULL)?
6316 sender_address : addr->p.errors_address) != 0)
6318 paddr = &(addr->next); /* Not the same; skip */
6320 else /* The same - dechain */
6322 *paddr = addr->next;
6325 pmsgchain = &(addr->next);
6329 /* Include X-Failed-Recipients: for automatic interpretation, but do
6330 not let any one header line get too long. We do this by starting a
6331 new header every 50 recipients. Omit any addresses for which the
6332 "hide_child" flag is set. */
6334 for (addr = msgchain; addr != NULL; addr = addr->next)
6336 if (testflag(addr, af_hide_child)) continue;
6343 (rcount++ == 0)? "X-Failed-Recipients: " : ",\n ",
6344 (testflag(addr, af_pfr) && addr->parent != NULL)?
6345 string_printing(addr->parent->address) :
6346 string_printing(addr->address));
6348 if (rcount > 0) fprintf(f, "\n");
6350 /* Output the standard headers */
6352 if (errors_reply_to != NULL)
6353 fprintf(f, "Reply-To: %s\n", errors_reply_to);
6354 fprintf(f, "Auto-Submitted: auto-replied\n");
6356 fprintf(f, "To: %s\n", bounce_recipient);
6358 /* Open a template file if one is provided. Log failure to open, but
6359 carry on - default texts will be used. */
6361 if (bounce_message_file != NULL)
6363 emf = Ufopen(bounce_message_file, "rb");
6365 log_write(0, LOG_MAIN|LOG_PANIC, "Failed to open %s for error "
6366 "message texts: %s", bounce_message_file, strerror(errno));
6369 /* Quietly copy to configured additional addresses if required. */
6371 bcc = moan_check_errorcopy(bounce_recipient);
6372 if (bcc != NULL) fprintf(f, "Bcc: %s\n", bcc);
6374 /* The texts for the message can be read from a template file; if there
6375 isn't one, or if it is too short, built-in texts are used. The first
6376 emf text is a Subject: and any other headers. */
6378 emf_text = next_emf(emf, US"header");
6379 if (emf_text != NULL) fprintf(f, "%s\n", emf_text); else
6381 fprintf(f, "Subject: Mail delivery failed%s\n\n",
6382 to_sender? ": returning message to sender" : "");
6385 emf_text = next_emf(emf, US"intro");
6386 if (emf_text != NULL) fprintf(f, "%s", CS emf_text); else
6389 /* This message has been reworded several times. It seems to be confusing to
6390 somebody, however it is worded. I have retreated to the original, simple
6392 "This message was created automatically by mail delivery software.\n");
6393 if (bounce_message_text != NULL) fprintf(f, "%s", CS bounce_message_text);
6397 "\nA message that you sent could not be delivered to one or more of its\n"
6398 "recipients. This is a permanent error. The following address(es) failed:\n");
6403 "\nA message sent by\n\n <%s>\n\n"
6404 "could not be delivered to one or more of its recipients. The following\n"
6405 "address(es) failed:\n", sender_address);
6410 /* Process the addresses, leaving them on the msgchain if they have a
6411 file name for a return message. (There has already been a check in
6412 post_process_one() for the existence of data in the message file.) A TRUE
6413 return from print_address_information() means that the address is not
6417 for (addr = msgchain; addr != NULL; addr = *paddr)
6419 if (print_address_information(addr, f, US" ", US"\n ", US""))
6420 print_address_error(addr, f, US"");
6422 /* End the final line for the address */
6426 /* Leave on msgchain if there's a return file. */
6428 if (addr->return_file >= 0)
6430 paddr = &(addr->next);
6434 /* Else save so that we can tick off the recipient when the
6439 *paddr = addr->next;
6440 addr->next = handled_addr;
6441 handled_addr = addr;
6447 /* Get the next text, whether we need it or not, so as to be
6448 positioned for the one after. */
6450 emf_text = next_emf(emf, US"generated text");
6452 /* If there were any file messages passed by the local transports,
6453 include them in the message. Then put the address on the handled chain.
6454 In the case of a batch of addresses that were all sent to the same
6455 transport, the return_file field in all of them will contain the same
6456 fd, and the return_filename field in the *last* one will be set (to the
6457 name of the file). */
6459 if (msgchain != NULL)
6461 address_item *nextaddr;
6463 if (emf_text != NULL) fprintf(f, "%s", CS emf_text); else
6465 "The following text was generated during the delivery "
6466 "attempt%s:\n", (filecount > 1)? "s" : "");
6468 for (addr = msgchain; addr != NULL; addr = nextaddr)
6471 address_item *topaddr = addr;
6473 /* List all the addresses that relate to this file */
6476 while(addr != NULL) /* Insurance */
6478 print_address_information(addr, f, US"------ ", US"\n ",
6480 if (addr->return_filename != NULL) break;
6485 /* Now copy the file */
6487 fm = Ufopen(addr->return_filename, "rb");
6490 fprintf(f, " +++ Exim error... failed to open text file: %s\n",
6494 while ((ch = fgetc(fm)) != EOF) fputc(ch, f);
6497 Uunlink(addr->return_filename);
6499 /* Can now add to handled chain, first fishing off the next
6500 address on the msgchain. */
6502 nextaddr = addr->next;
6503 addr->next = handled_addr;
6504 handled_addr = topaddr;
6509 /* Now copy the message, trying to give an intelligible comment if
6510 it is too long for it all to be copied. The limit isn't strictly
6511 applied because of the buffering. There is, however, an option
6512 to suppress copying altogether. */
6514 emf_text = next_emf(emf, US"copy");
6516 if (bounce_return_message)
6518 int topt = topt_add_return_path;
6519 if (!bounce_return_body) topt |= topt_no_body;
6521 if (emf_text != NULL) fprintf(f, "%s", CS emf_text); else
6523 if (bounce_return_body) fprintf(f,
6524 "------ This is a copy of the message, including all the headers. ------\n");
6526 "------ This is a copy of the message's headers. ------\n");
6529 /* While reading the "truncated" message, set return_size_limit to
6530 the actual max testing value, rounded. We need to read the message
6531 whether we are going to use it or not. */
6534 int temp = bounce_return_size_limit;
6535 bounce_return_size_limit = (max/1000)*1000;
6536 emf_text = next_emf(emf, US"truncated");
6537 bounce_return_size_limit = temp;
6540 if (bounce_return_body && bounce_return_size_limit > 0)
6542 struct stat statbuf;
6543 if (fstat(deliver_datafile, &statbuf) == 0 && statbuf.st_size > max)
6545 if (emf_text != NULL) fprintf(f, "%s", CS emf_text); else
6548 "------ The body of the message is " OFF_T_FMT " characters long; only the first\n"
6549 "------ %d or so are included here.\n", statbuf.st_size, max);
6556 transport_filter_argv = NULL; /* Just in case */
6557 return_path = sender_address; /* In case not previously set */
6558 transport_write_message(NULL, fileno(f), topt,
6559 bounce_return_size_limit, NULL, NULL, NULL, NULL, NULL, 0);
6562 /* Write final text and close the template file if one is open */
6566 emf_text = next_emf(emf, US"final");
6567 if (emf_text != NULL) fprintf(f, "%s", CS emf_text);
6571 /* Close the file, which should send an EOF to the child process
6572 that is receiving the message. Wait for it to finish. */
6575 rc = child_close(pid, 0); /* Waits for child to close, no timeout */
6577 /* In the test harness, let the child do it's thing first. */
6579 if (running_in_test_harness) millisleep(500);
6581 /* If the process failed, there was some disaster in setting up the
6582 error message. Unless the message is very old, ensure that addr_defer
6583 is non-null, which will have the effect of leaving the message on the
6584 spool. The failed addresses will get tried again next time. However, we
6585 don't really want this to happen too often, so freeze the message unless
6586 there are some genuine deferred addresses to try. To do this we have
6587 to call spool_write_header() here, because with no genuine deferred
6588 addresses the normal code below doesn't get run. */
6593 if (now - received_time < retry_maximum_timeout && addr_defer == NULL)
6595 addr_defer = (address_item *)(+1);
6596 deliver_freeze = TRUE;
6597 deliver_frozen_at = time(NULL);
6598 /* Panic-dies on error */
6599 (void)spool_write_header(message_id, SW_DELIVERING, NULL);
6602 deliver_msglog("Process failed (%d) when writing error message "
6603 "to %s%s", rc, bounce_recipient, s);
6604 log_write(0, LOG_MAIN, "Process failed (%d) when writing error message "
6605 "to %s%s", rc, bounce_recipient, s);
6608 /* The message succeeded. Ensure that the recipients that failed are
6609 now marked finished with on the spool and their parents updated. */
6613 for (addr = handled_addr; addr != NULL; addr = addr->next)
6615 address_done(addr, logtod);
6616 child_done(addr, logtod);
6618 /* Panic-dies on error */
6619 (void)spool_write_header(message_id, SW_DELIVERING, NULL);
6625 disable_logging = FALSE; /* In case left set */
6627 /* Come here from the mua_wrapper case if routing goes wrong */
6631 /* If there are now no deferred addresses, we are done. Preserve the
6632 message log if so configured, and we are using them. Otherwise, sling it.
6633 Then delete the message itself. */
6635 if (addr_defer == NULL)
6639 sprintf(CS spoolname, "%s/msglog/%s/%s", spool_directory, message_subdir,
6641 if (preserve_message_logs)
6644 sprintf(CS big_buffer, "%s/msglog.OLD/%s", spool_directory, id);
6645 if ((rc = Urename(spoolname, big_buffer)) < 0)
6647 (void)directory_make(spool_directory, US"msglog.OLD",
6648 MSGLOG_DIRECTORY_MODE, TRUE);
6649 rc = Urename(spoolname, big_buffer);
6652 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to move %s to the "
6653 "msglog.OLD directory", spoolname);
6657 if (Uunlink(spoolname) < 0)
6658 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to unlink %s: %s",
6659 spoolname, strerror(errno));
6663 /* Remove the two message files. */
6665 sprintf(CS spoolname, "%s/input/%s/%s-D", spool_directory, message_subdir, id);
6666 if (Uunlink(spoolname) < 0)
6667 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to unlink %s: %s",
6668 spoolname, strerror(errno));
6669 sprintf(CS spoolname, "%s/input/%s/%s-H", spool_directory, message_subdir, id);
6670 if (Uunlink(spoolname) < 0)
6671 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to unlink %s: %s",
6672 spoolname, strerror(errno));
6674 /* Log the end of this message, with queue time if requested. */
6676 if ((log_extra_selector & LX_queue_time_overall) != 0)
6677 log_write(0, LOG_MAIN, "Completed QT=%s",
6678 readconf_printtime(time(NULL) - received_time));
6680 log_write(0, LOG_MAIN, "Completed");
6682 /* Unset deliver_freeze so that we won't try to move the spool files further down */
6683 deliver_freeze = FALSE;
6686 /* If there are deferred addresses, we are keeping this message because it is
6687 not yet completed. Lose any temporary files that were catching output from
6688 pipes for any of the deferred addresses, handle one-time aliases, and see if
6689 the message has been on the queue for so long that it is time to send a warning
6690 message to the sender, unless it is a mailer-daemon. If all deferred addresses
6691 have the same domain, we can set deliver_domain for the expansion of
6692 delay_warning_ condition - if any of them are pipes, files, or autoreplies, use
6693 the parent's domain.
6695 If all the deferred addresses have an error number that indicates "retry time
6696 not reached", skip sending the warning message, because it won't contain the
6697 reason for the delay. It will get sent at the next real delivery attempt.
6698 However, if at least one address has tried, we'd better include all of them in
6701 If we can't make a process to send the message, don't worry.
6703 For mailing list expansions we want to send the warning message to the
6704 mailing list manager. We can't do a perfect job here, as some addresses may
6705 have different errors addresses, but if we take the errors address from
6706 each deferred address it will probably be right in most cases.
6708 If addr_defer == +1, it means there was a problem sending an error message
6709 for failed addresses, and there were no "real" deferred addresses. The value
6710 was set just to keep the message on the spool, so there is nothing to do here.
6713 else if (addr_defer != (address_item *)(+1))
6716 uschar *recipients = US"";
6717 BOOL delivery_attempted = FALSE;
6719 deliver_domain = testflag(addr_defer, af_pfr)?
6720 addr_defer->parent->domain : addr_defer->domain;
6722 for (addr = addr_defer; addr != NULL; addr = addr->next)
6724 address_item *otaddr;
6726 if (addr->basic_errno > ERRNO_RETRY_BASE) delivery_attempted = TRUE;
6728 if (deliver_domain != NULL)
6730 uschar *d = (testflag(addr, af_pfr))? addr->parent->domain : addr->domain;
6732 /* The domain may be unset for an address that has never been routed
6733 because the system filter froze the message. */
6735 if (d == NULL || Ustrcmp(d, deliver_domain) != 0) deliver_domain = NULL;
6738 if (addr->return_filename != NULL) Uunlink(addr->return_filename);
6740 /* Handle the case of one-time aliases. If any address in the ancestry
6741 of this one is flagged, ensure it is in the recipients list, suitably
6742 flagged, and that its parent is marked delivered. */
6744 for (otaddr = addr; otaddr != NULL; otaddr = otaddr->parent)
6745 if (otaddr->onetime_parent != NULL) break;
6750 int t = recipients_count;
6752 for (i = 0; i < recipients_count; i++)
6754 uschar *r = recipients_list[i].address;
6755 if (Ustrcmp(otaddr->onetime_parent, r) == 0) t = i;
6756 if (Ustrcmp(otaddr->address, r) == 0) break;
6759 /* Didn't find the address already in the list, and did find the
6760 ultimate parent's address in the list. After adding the recipient,
6761 update the errors address in the recipients list. */
6763 if (i >= recipients_count && t < recipients_count)
6765 DEBUG(D_deliver) debug_printf("one_time: adding %s in place of %s\n",
6766 otaddr->address, otaddr->parent->address);
6767 receive_add_recipient(otaddr->address, t);
6768 recipients_list[recipients_count-1].errors_to = otaddr->p.errors_address;
6769 tree_add_nonrecipient(otaddr->parent->address);
6770 update_spool = TRUE;
6774 /* Except for error messages, ensure that either the errors address for
6775 this deferred address or, if there is none, the sender address, is on the
6776 list of recipients for a warning message. */
6778 if (sender_address[0] != 0)
6780 if (addr->p.errors_address == NULL)
6782 if (Ustrstr(recipients, sender_address) == NULL)
6783 recipients = string_sprintf("%s%s%s", recipients,
6784 (recipients[0] == 0)? "" : ",", sender_address);
6788 if (Ustrstr(recipients, addr->p.errors_address) == NULL)
6789 recipients = string_sprintf("%s%s%s", recipients,
6790 (recipients[0] == 0)? "" : ",", addr->p.errors_address);
6795 /* Send a warning message if the conditions are right. If the condition check
6796 fails because of a lookup defer, there is nothing we can do. The warning
6797 is not sent. Another attempt will be made at the next delivery attempt (if
6800 if (!queue_2stage && delivery_attempted &&
6801 delay_warning[1] > 0 && sender_address[0] != 0 &&
6802 (delay_warning_condition == NULL ||
6803 expand_check_condition(delay_warning_condition,
6804 US"delay_warning", US"option")))
6808 int queue_time = time(NULL) - received_time;
6810 /* When running in the test harness, there's an option that allows us to
6811 fudge this time so as to get repeatability of the tests. Take the first
6812 time off the list. In queue runs, the list pointer gets updated in the
6815 if (running_in_test_harness && fudged_queue_times[0] != 0)
6817 int qt = readconf_readtime(fudged_queue_times, '/', FALSE);
6820 DEBUG(D_deliver) debug_printf("fudged queue_times = %s\n",
6821 fudged_queue_times);
6826 /* See how many warnings we should have sent by now */
6828 for (count = 0; count < delay_warning[1]; count++)
6829 if (queue_time < delay_warning[count+2]) break;
6831 show_time = delay_warning[count+1];
6833 if (count >= delay_warning[1])
6836 int last_gap = show_time;
6837 if (count > 1) last_gap -= delay_warning[count];
6838 extra = (queue_time - delay_warning[count+1])/last_gap;
6839 show_time += last_gap * extra;
6845 debug_printf("time on queue = %s\n", readconf_printtime(queue_time));
6846 debug_printf("warning counts: required %d done %d\n", count,
6850 /* We have computed the number of warnings there should have been by now.
6851 If there haven't been enough, send one, and up the count to what it should
6854 if (warning_count < count)
6858 pid_t pid = child_open_exim(&fd);
6864 FILE *f = fdopen(fd, "wb");
6866 if (warn_message_file != NULL)
6868 wmf = Ufopen(warn_message_file, "rb");
6870 log_write(0, LOG_MAIN|LOG_PANIC, "Failed to open %s for warning "
6871 "message texts: %s", warn_message_file, strerror(errno));
6874 warnmsg_recipients = recipients;
6875 warnmsg_delay = (queue_time < 120*60)?
6876 string_sprintf("%d minutes", show_time/60):
6877 string_sprintf("%d hours", show_time/3600);
6879 if (errors_reply_to != NULL)
6880 fprintf(f, "Reply-To: %s\n", errors_reply_to);
6881 fprintf(f, "Auto-Submitted: auto-replied\n");
6883 fprintf(f, "To: %s\n", recipients);
6885 wmf_text = next_emf(wmf, US"header");
6886 if (wmf_text != NULL)
6887 fprintf(f, "%s\n", wmf_text);
6889 fprintf(f, "Subject: Warning: message %s delayed %s\n\n",
6890 message_id, warnmsg_delay);
6892 wmf_text = next_emf(wmf, US"intro");
6893 if (wmf_text != NULL) fprintf(f, "%s", CS wmf_text); else
6896 "This message was created automatically by mail delivery software.\n");
6898 if (Ustrcmp(recipients, sender_address) == 0)
6900 "A message that you sent has not yet been delivered to one or more of its\n"
6901 "recipients after more than ");
6904 "A message sent by\n\n <%s>\n\n"
6905 "has not yet been delivered to one or more of its recipients after more than \n",
6908 fprintf(f, "%s on the queue on %s.\n\n", warnmsg_delay,
6910 fprintf(f, "The message identifier is: %s\n", message_id);
6912 for (h = header_list; h != NULL; h = h->next)
6914 if (strncmpic(h->text, US"Subject:", 8) == 0)
6915 fprintf(f, "The subject of the message is: %s", h->text + 9);
6916 else if (strncmpic(h->text, US"Date:", 5) == 0)
6917 fprintf(f, "The date of the message is: %s", h->text + 6);
6921 fprintf(f, "The address%s to which the message has not yet been "
6923 (addr_defer->next == NULL)? "" : "es",
6924 (addr_defer->next == NULL)? "is": "are");
6927 /* List the addresses, with error information if allowed */
6930 while (addr_defer != NULL)
6932 address_item *addr = addr_defer;
6933 addr_defer = addr->next;
6934 if (print_address_information(addr, f, US" ", US"\n ", US""))
6935 print_address_error(addr, f, US"Delay reason: ");
6944 wmf_text = next_emf(wmf, US"final");
6945 if (wmf_text != NULL) fprintf(f, "%s", CS wmf_text);
6951 "No action is required on your part. Delivery attempts will continue for\n"
6952 "some time, and this warning may be repeated at intervals if the message\n"
6953 "remains undelivered. Eventually the mail delivery software will give up,\n"
6954 "and when that happens, the message will be returned to you.\n");
6957 /* Close and wait for child process to complete, without a timeout.
6958 If there's an error, don't update the count. */
6961 if (child_close(pid, 0) == 0)
6963 warning_count = count;
6964 update_spool = TRUE; /* Ensure spool rewritten */
6970 /* Clear deliver_domain */
6972 deliver_domain = NULL;
6974 /* If this was a first delivery attempt, unset the first time flag, and
6975 ensure that the spool gets updated. */
6977 if (deliver_firsttime)
6979 deliver_firsttime = FALSE;
6980 update_spool = TRUE;
6983 /* If delivery was frozen and freeze_tell is set, generate an appropriate
6984 message, unless the message is a local error message (to avoid loops). Then
6985 log the freezing. If the text in "frozen_info" came from a system filter,
6986 it has been escaped into printing characters so as not to mess up log lines.
6987 For the "tell" message, we turn \n back into newline. Also, insert a newline
6988 near the start instead of the ": " string. */
6992 if (freeze_tell != NULL && freeze_tell[0] != 0 && !local_error_message)
6994 uschar *s = string_copy(frozen_info);
6995 uschar *ss = Ustrstr(s, " by the system filter: ");
7006 if (*ss == '\\' && ss[1] == 'n')
7013 moan_tell_someone(freeze_tell, addr_defer, US"Message frozen",
7014 "Message %s has been frozen%s.\nThe sender is <%s>.\n", message_id,
7018 /* Log freezing just before we update the -H file, to minimize the chance
7019 of a race problem. */
7021 deliver_msglog("*** Frozen%s\n", frozen_info);
7022 log_write(0, LOG_MAIN, "Frozen%s", frozen_info);
7025 /* If there have been any updates to the non-recipients list, or other things
7026 that get written to the spool, we must now update the spool header file so
7027 that it has the right information for the next delivery attempt. If there
7028 was more than one address being delivered, the header_change update is done
7029 earlier, in case one succeeds and then something crashes. */
7032 debug_printf("delivery deferred: update_spool=%d header_rewritten=%d\n",
7033 update_spool, header_rewritten);
7035 if (update_spool || header_rewritten)
7036 /* Panic-dies on error */
7037 (void)spool_write_header(message_id, SW_DELIVERING, NULL);
7040 /* Finished with the message log. If the message is complete, it will have
7041 been unlinked or renamed above. */
7043 if (message_logs) (void)fclose(message_log);
7045 /* Now we can close and remove the journal file. Its only purpose is to record
7046 successfully completed deliveries asap so that this information doesn't get
7047 lost if Exim (or the machine) crashes. Forgetting about a failed delivery is
7048 not serious, as trying it again is not harmful. The journal might not be open
7049 if all addresses were deferred at routing or directing. Nevertheless, we must
7050 remove it if it exists (may have been lying around from a crash during the
7051 previous delivery attempt). We don't remove the journal if a delivery
7052 subprocess failed to pass back delivery information; this is controlled by
7053 the remove_journal flag. When the journal is left, we also don't move the
7054 message off the main spool if frozen and the option is set. It should get moved
7055 at the next attempt, after the journal has been inspected. */
7057 if (journal_fd >= 0) (void)close(journal_fd);
7061 sprintf(CS spoolname, "%s/input/%s/%s-J", spool_directory, message_subdir, id);
7062 if (Uunlink(spoolname) < 0 && errno != ENOENT)
7063 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to unlink %s: %s", spoolname,
7066 /* Move the message off the spool if reqested */
7068 #ifdef SUPPORT_MOVE_FROZEN_MESSAGES
7069 if (deliver_freeze && move_frozen_messages)
7070 (void)spool_move_message(id, message_subdir, US"", US"F");
7074 /* Closing the data file frees the lock; if the file has been unlinked it
7075 will go away. Otherwise the message becomes available for another process
7078 (void)close(deliver_datafile);
7079 deliver_datafile = -1;
7080 DEBUG(D_deliver) debug_printf("end delivery of %s\n", id);
7082 /* It is unlikely that there will be any cached resources, since they are
7083 released after routing, and in the delivery subprocesses. However, it's
7084 possible for an expansion for something afterwards (for example,
7085 expand_check_condition) to do a lookup. We must therefore be sure everything is
7089 acl_where = ACL_WHERE_UNKNOWN;
7093 /* End of deliver.c */