5729f8e755986db36943ac893519e5bd2703329e
[exim.git] / src / src / transport.c
1 /*************************************************
2 *     Exim - an Internet mail transport agent    *
3 *************************************************/
4
5 /* Copyright (c) The Exim Maintainers 2020 - 2023 */
6 /* Copyright (c) University of Cambridge 1995 - 2018 */
7 /* See the file NOTICE for conditions of use and distribution. */
8 /* SPDX-License-Identifier: GPL-2.0-or-later */
9
10 /* General functions concerned with transportation, and generic options for all
11 transports. */
12
13
14 #include "exim.h"
15
16 /* Generic options for transports, all of which live inside transport_instance
17 data blocks and which therefore have the opt_public flag set. Note that there
18 are other options living inside this structure which can be set only from
19 certain transports. */
20 #define LOFF(field) OPT_OFF(transport_instance, field)
21
22 optionlist optionlist_transports[] = {
23   /*    name            type                                    value */
24   { "*expand_group",    opt_stringptr|opt_hidden|opt_public,
25                  LOFF(expand_gid) },
26   { "*expand_user",     opt_stringptr|opt_hidden|opt_public,
27                  LOFF(expand_uid) },
28   { "*headers_rewrite_flags", opt_int|opt_public|opt_hidden,
29                  LOFF(rewrite_existflags) },
30   { "*headers_rewrite_rules", opt_void|opt_public|opt_hidden,
31                  LOFF(rewrite_rules) },
32   { "*set_group",       opt_bool|opt_hidden|opt_public,
33                  LOFF(gid_set) },
34   { "*set_user",        opt_bool|opt_hidden|opt_public,
35                  LOFF(uid_set) },
36   { "body_only",        opt_bool|opt_public,
37                  LOFF(body_only) },
38   { "current_directory", opt_stringptr|opt_public,
39                  LOFF(current_dir) },
40   { "debug_print",      opt_stringptr | opt_public,
41                  LOFF(debug_string) },
42   { "delivery_date_add", opt_bool|opt_public,
43                  LOFF(delivery_date_add) },
44   { "disable_logging",  opt_bool|opt_public,
45                  LOFF(disable_logging) },
46   { "driver",           opt_stringptr|opt_public,
47                  LOFF(driver_name) },
48   { "envelope_to_add",   opt_bool|opt_public,
49                  LOFF(envelope_to_add) },
50 #ifndef DISABLE_EVENT
51   { "event_action",     opt_stringptr | opt_public,
52                  LOFF(event_action) },
53 #endif
54   { "group",             opt_expand_gid|opt_public,
55                  LOFF(gid) },
56   { "headers_add",      opt_stringptr|opt_public|opt_rep_str,
57                  LOFF(add_headers) },
58   { "headers_only",     opt_bool|opt_public,
59                  LOFF(headers_only) },
60   { "headers_remove",   opt_stringptr|opt_public|opt_rep_str,
61                  LOFF(remove_headers) },
62   { "headers_rewrite",  opt_rewrite|opt_public,
63                  LOFF(headers_rewrite) },
64   { "home_directory",   opt_stringptr|opt_public,
65                  LOFF(home_dir) },
66   { "initgroups",       opt_bool|opt_public,
67                  LOFF(initgroups) },
68   { "max_parallel",     opt_stringptr|opt_public,
69                  LOFF(max_parallel) },
70   { "message_size_limit", opt_stringptr|opt_public,
71                  LOFF(message_size_limit) },
72   { "rcpt_include_affixes", opt_bool|opt_public,
73                  LOFF(rcpt_include_affixes) },
74   { "retry_use_local_part", opt_bool|opt_public,
75                  LOFF(retry_use_local_part) },
76   { "return_path",      opt_stringptr|opt_public,
77                  LOFF(return_path) },
78   { "return_path_add",   opt_bool|opt_public,
79                  LOFF(return_path_add) },
80   { "shadow_condition", opt_stringptr|opt_public,
81                  LOFF(shadow_condition) },
82   { "shadow_transport", opt_stringptr|opt_public,
83                  LOFF(shadow) },
84   { "transport_filter", opt_stringptr|opt_public,
85                  LOFF(filter_command) },
86   { "transport_filter_timeout", opt_time|opt_public,
87                  LOFF(filter_timeout) },
88   { "user",             opt_expand_uid|opt_public,
89                  LOFF(uid) }
90 };
91
92 int optionlist_transports_size = nelem(optionlist_transports);
93
94 #ifdef MACRO_PREDEF
95
96 # include "macro_predef.h"
97
98 void
99 options_transports(void)
100 {
101 uschar buf[64];
102
103 options_from_list(optionlist_transports, nelem(optionlist_transports), US"TRANSPORTS", NULL);
104
105 for (transport_info * ti = transports_available; ti->driver_name[0]; ti++)
106   {
107   spf(buf, sizeof(buf), US"_DRIVER_TRANSPORT_%T", ti->driver_name);
108   builtin_macro_create(buf);
109   options_from_list(ti->options, (unsigned)*ti->options_count, US"TRANSPORT", ti->driver_name);
110   }
111 }
112
113 #else   /*!MACRO_PREDEF*/
114
115 /* Structure for keeping list of addresses that have been added to
116 Envelope-To:, in order to avoid duplication. */
117
118 struct aci {
119   struct aci *next;
120   address_item *ptr;
121   };
122
123
124 /* Static data for write_chunk() */
125
126 static uschar *chunk_ptr;           /* chunk pointer */
127 static uschar *nl_check;            /* string to look for at line start */
128 static int     nl_check_length;     /* length of same */
129 static uschar *nl_escape;           /* string to insert */
130 static int     nl_escape_length;    /* length of same */
131 static int     nl_partial_match;    /* length matched at chunk end */
132
133
134 /*************************************************
135 *             Initialize transport list           *
136 *************************************************/
137
138 /* Read the transports section of the configuration file, and set up a chain of
139 transport instances according to its contents. Each transport has generic
140 options and may also have its own private options. This function is only ever
141 called when transports == NULL. We use generic code in readconf to do most of
142 the work. */
143
144 void
145 transport_init(void)
146 {
147 readconf_driver_init(US"transport",
148   (driver_instance **)(&transports),     /* chain anchor */
149   (driver_info *)transports_available,   /* available drivers */
150   sizeof(transport_info),                /* size of info block */
151   &transport_defaults,                   /* default values for generic options */
152   sizeof(transport_instance),            /* size of instance block */
153   optionlist_transports,                 /* generic options */
154   optionlist_transports_size);
155
156 /* Now scan the configured transports and check inconsistencies. A shadow
157 transport is permitted only for local transports. */
158
159 for (transport_instance * t = transports; t; t = t->next)
160   {
161   if (!t->info->local && t->shadow)
162     log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
163       "shadow transport not allowed on non-local transport %s", t->name);
164
165   if (t->body_only && t->headers_only)
166     log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
167       "%s transport: body_only and headers_only are mutually exclusive",
168       t->name);
169   }
170 }
171
172
173
174 /*************************************************
175 *             Write block of data                *
176 *************************************************/
177
178 static int
179 tpt_write(int fd, uschar * block, int len, BOOL more, int options)
180 {
181 return
182 #ifndef DISABLE_TLS
183   tls_out.active.sock == fd
184     ? tls_write(tls_out.active.tls_ctx, block, len, more) :
185 #endif
186 #ifdef MSG_MORE
187   more && !(options & topt_not_socket) ? send(fd, block, len, MSG_MORE) :
188 #endif
189   write(fd, block, len);
190 }
191
192 /* Subroutine called by write_chunk() and at the end of the message actually
193 to write a data block. Also called directly by some transports to write
194 additional data to the file descriptor (e.g. prefix, suffix).
195
196 If a transport wants data transfers to be timed, it sets a non-zero value in
197 transport_write_timeout. A non-zero transport_write_timeout causes a timer to
198 be set for each block of data written from here. If time runs out, then write()
199 fails and provokes an error return. The caller can then inspect sigalrm_seen to
200 check for a timeout.
201
202 On some systems, if a quota is exceeded during the write, the yield is the
203 number of bytes written rather than an immediate error code. This also happens
204 on some systems in other cases, for example a pipe that goes away because the
205 other end's process terminates (Linux). On other systems, (e.g. Solaris 2) you
206 get the error codes the first time.
207
208 The write() function is also interruptible; the Solaris 2.6 man page says:
209
210      If write() is interrupted by a signal before it writes any
211      data, it will return -1 with errno set to EINTR.
212
213      If write() is interrupted by a signal after it successfully
214      writes some data, it will return the number of bytes written.
215
216 To handle these cases, we want to restart the write() to output the remainder
217 of the data after a non-negative return from write(), except after a timeout.
218 In the error cases (EDQUOT, EPIPE) no bytes get written the second time, and a
219 proper error then occurs. In principle, after an interruption, the second
220 write() could suffer the same fate, but we do not want to continue for
221 evermore, so stick a maximum repetition count on the loop to act as a
222 longstop.
223
224 Arguments:
225   tctx      transport context: file descriptor or string to write to
226   block     block of bytes to write
227   len       number of bytes to write
228   more      further data expected soon
229
230 Returns:    TRUE on success, FALSE on failure (with errno preserved);
231               transport_count is incremented by the number of bytes written
232 */
233
234 static BOOL
235 transport_write_block_fd(transport_ctx * tctx, uschar * block, int len, BOOL more)
236 {
237 int rc, save_errno;
238 int local_timeout = transport_write_timeout;
239 int connretry = 1;
240 int fd = tctx->u.fd;
241
242 /* This loop is for handling incomplete writes and other retries. In most
243 normal cases, it is only ever executed once. */
244
245 for (int i = 0; i < 100; i++)
246   {
247   DEBUG(D_transport)
248     debug_printf("writing data block fd=%d size=%d timeout=%d%s\n",
249       fd, len, local_timeout, more ? " (more expected)" : "");
250
251   /* When doing TCP Fast Open we may get this far before the 3-way handshake
252   is complete, and write returns ENOTCONN.  Detect that, wait for the socket
253   to become writable, and retry once only. */
254
255   for(;;)
256     {
257     /* This code makes use of alarm() in order to implement the timeout. This
258     isn't a very tidy way of doing things. Using non-blocking I/O with select()
259     provides a neater approach. However, I don't know how to do this when TLS is
260     in use. */
261
262     if (transport_write_timeout <= 0)   /* No timeout wanted */
263       {
264       rc = tpt_write(fd, block, len, more, tctx->options);
265       save_errno = errno;
266       }
267     else                                /* Timeout wanted. */
268       {
269       sigalrm_seen = FALSE;
270       ALARM(local_timeout);
271         rc = tpt_write(fd, block, len, more, tctx->options);
272         save_errno = errno;
273       local_timeout = ALARM_CLR(0);
274       if (sigalrm_seen)
275         {
276         errno = ETIMEDOUT;
277         return FALSE;
278         }
279       }
280
281     if (rc >= 0 || errno != ENOTCONN || connretry <= 0)
282       break;
283
284     poll_one_fd(fd, POLLOUT, -1);               /* could set timeout? retval check? */
285     connretry--;
286     }
287
288   /* Hopefully, the most common case is success, so test that first. */
289
290   if (rc == len) { transport_count += len; return TRUE; }
291
292   /* A non-negative return code is an incomplete write. Try again for the rest
293   of the block. If we have exactly hit the timeout, give up. */
294
295   if (rc >= 0)
296     {
297     len -= rc;
298     block += rc;
299     transport_count += rc;
300     DEBUG(D_transport) debug_printf("write incomplete (%d)\n", rc);
301     goto CHECK_TIMEOUT;   /* A few lines below */
302     }
303
304   /* A negative return code with an EINTR error is another form of
305   incomplete write, zero bytes having been written */
306
307   if (save_errno == EINTR)
308     {
309     DEBUG(D_transport)
310       debug_printf("write interrupted before anything written\n");
311     goto CHECK_TIMEOUT;   /* A few lines below */
312     }
313
314   /* A response of EAGAIN from write() is likely only in the case of writing
315   to a FIFO that is not swallowing the data as fast as Exim is writing it. */
316
317   if (save_errno == EAGAIN)
318     {
319     DEBUG(D_transport)
320       debug_printf("write temporarily locked out, waiting 1 sec\n");
321     sleep(1);
322
323     /* Before continuing to try another write, check that we haven't run out of
324     time. */
325
326     CHECK_TIMEOUT:
327     if (transport_write_timeout > 0 && local_timeout <= 0)
328       {
329       errno = ETIMEDOUT;
330       return FALSE;
331       }
332     continue;
333     }
334
335   /* Otherwise there's been an error */
336
337   DEBUG(D_transport) debug_printf("writing error %d: %s\n", save_errno,
338     strerror(save_errno));
339   errno = save_errno;
340   return FALSE;
341   }
342
343 /* We've tried and tried and tried but still failed */
344
345 errno = ERRNO_WRITEINCOMPLETE;
346 return FALSE;
347 }
348
349
350 BOOL
351 transport_write_block(transport_ctx * tctx, uschar *block, int len, BOOL more)
352 {
353 if (!(tctx->options & topt_output_string))
354   return transport_write_block_fd(tctx, block, len, more);
355
356 /* Write to expanding-string.  NOTE: not NUL-terminated */
357
358 if (!tctx->u.msg)
359   tctx->u.msg = string_get(1024);
360
361 tctx->u.msg = string_catn(tctx->u.msg, block, len);
362 return TRUE;
363 }
364
365
366
367
368 /*************************************************
369 *             Write formatted string             *
370 *************************************************/
371
372 /* This is called by various transports. It is a convenience function.
373
374 Arguments:
375   fd          file descriptor
376   format      string format
377   ...         arguments for format
378
379 Returns:      the yield of transport_write_block()
380 */
381
382 BOOL
383 transport_write_string(int fd, const char *format, ...)
384 {
385 transport_ctx tctx = {{0}};
386 gstring gs = { .size = big_buffer_size, .ptr = 0, .s = big_buffer };
387 va_list ap;
388
389 /* Use taint-unchecked routines for writing into big_buffer, trusting
390 that the result will never be expanded. */
391
392 va_start(ap, format);
393 if (!string_vformat(&gs, SVFMT_TAINT_NOCHK, format, ap))
394   log_write(0, LOG_MAIN|LOG_PANIC_DIE, "overlong formatted string in transport");
395 va_end(ap);
396 tctx.u.fd = fd;
397 return transport_write_block(&tctx, gs.s, gs.ptr, FALSE);
398 }
399
400
401
402
403 void
404 transport_write_reset(int options)
405 {
406 if (!(options & topt_continuation)) chunk_ptr = deliver_out_buffer;
407 nl_partial_match = -1;
408 nl_check_length = nl_escape_length = 0;
409 }
410
411
412
413 /*************************************************
414 *              Write character chunk             *
415 *************************************************/
416
417 /* Subroutine used by transport_write_message() to scan character chunks for
418 newlines and act appropriately. The object is to minimise the number of writes.
419 The output byte stream is buffered up in deliver_out_buffer, which is written
420 only when it gets full, thus minimizing write operations and TCP packets.
421
422 Static data is used to handle the case when the last character of the previous
423 chunk was NL, or matched part of the data that has to be escaped.
424
425 Arguments:
426   tctx       transport context - processing to be done during output,
427                 and file descriptor to write to
428   chunk      pointer to data to write
429   len        length of data to write
430
431 In addition, the static nl_xxx variables must be set as required.
432
433 Returns:     TRUE on success, FALSE on failure (with errno preserved)
434 */
435
436 BOOL
437 write_chunk(transport_ctx * tctx, const uschar * chunk, int len)
438 {
439 const uschar * start = chunk;
440 const uschar * end = chunk + len;
441 int mlen = DELIVER_OUT_BUFFER_SIZE - nl_escape_length - 2;
442
443 /* The assumption is made that the check string will never stretch over move
444 than one chunk since the only time there are partial matches is when copying
445 the body in large buffers. There is always enough room in the buffer for an
446 escape string, since the loop below ensures this for each character it
447 processes, and it won't have stuck in the escape string if it left a partial
448 match. */
449
450 if (nl_partial_match >= 0)
451   {
452   if (nl_check_length > 0 && len >= nl_check_length &&
453       Ustrncmp(start, nl_check + nl_partial_match,
454         nl_check_length - nl_partial_match) == 0)
455     {
456     Ustrncpy(chunk_ptr, nl_escape, nl_escape_length);
457     chunk_ptr += nl_escape_length;
458     start += nl_check_length - nl_partial_match;
459     }
460
461   /* The partial match was a false one. Insert the characters carried over
462   from the previous chunk. */
463
464   else if (nl_partial_match > 0)
465     {
466     Ustrncpy(chunk_ptr, nl_check, nl_partial_match);
467     chunk_ptr += nl_partial_match;
468     }
469
470   nl_partial_match = -1;
471   }
472
473 /* Now process the characters in the chunk. Whenever we hit a newline we check
474 for possible escaping. The code for the non-NL route should be as fast as
475 possible. */
476
477 for (const uschar * ptr = start; ptr < end; ptr++)
478   {
479   int ch, len;
480
481   /* Flush the buffer if it has reached the threshold - we want to leave enough
482   room for the next uschar, plus a possible extra CR for an LF, plus the escape
483   string. */
484
485   if ((len = chunk_ptr - deliver_out_buffer) > mlen)
486     {
487     DEBUG(D_transport) debug_printf("flushing headers buffer\n");
488
489     /* If CHUNKING, prefix with BDAT (size) NON-LAST.  Also, reap responses
490     from previous SMTP commands. */
491
492     if (tctx->options & topt_use_bdat  &&  tctx->chunk_cb)
493       {
494       if (  tctx->chunk_cb(tctx, (unsigned)len, 0) != OK
495          || !transport_write_block(tctx, deliver_out_buffer, len, FALSE)
496          || tctx->chunk_cb(tctx, 0, tc_reap_prev) != OK
497          )
498         return FALSE;
499       }
500     else
501       if (!transport_write_block(tctx, deliver_out_buffer, len, FALSE))
502         return FALSE;
503     chunk_ptr = deliver_out_buffer;
504     }
505
506   /* Remove CR before NL if required */
507
508   if (  *ptr == '\r' && ptr[1] == '\n'
509      && !(tctx->options & topt_use_crlf)
510      && f.spool_file_wireformat
511      )
512     ptr++;
513
514   if ((ch = *ptr) == '\n')
515     {
516     int left = end - ptr - 1;  /* count of chars left after NL */
517
518     /* Insert CR before NL if required */
519
520     if (tctx->options & topt_use_crlf && !f.spool_file_wireformat)
521       *chunk_ptr++ = '\r';
522     *chunk_ptr++ = '\n';
523     transport_newlines++;
524
525     /* The check_string test (formerly "from hack") replaces the specific
526     string at the start of a line with an escape string (e.g. "From " becomes
527     ">From " or "." becomes "..". It is a case-sensitive test. The length
528     check above ensures there is always enough room to insert this string. */
529
530     if (nl_check_length > 0)
531       {
532       if (left >= nl_check_length &&
533           Ustrncmp(ptr+1, nl_check, nl_check_length) == 0)
534         {
535         Ustrncpy(chunk_ptr, nl_escape, nl_escape_length);
536         chunk_ptr += nl_escape_length;
537         ptr += nl_check_length;
538         }
539
540       /* Handle the case when there isn't enough left to match the whole
541       check string, but there may be a partial match. We remember how many
542       characters matched, and finish processing this chunk. */
543
544       else if (left <= 0) nl_partial_match = 0;
545
546       else if (Ustrncmp(ptr+1, nl_check, left) == 0)
547         {
548         nl_partial_match = left;
549         ptr = end;
550         }
551       }
552     }
553
554   /* Not a NL character */
555
556   else *chunk_ptr++ = ch;
557   }
558
559 return TRUE;
560 }
561
562
563
564
565 /*************************************************
566 *        Generate address for RCPT TO            *
567 *************************************************/
568
569 /* This function puts together an address for RCPT to, using the caseful
570 version of the local part and the caseful version of the domain. If there is no
571 prefix or suffix, or if affixes are to be retained, we can just use the
572 original address. Otherwise, if there is a prefix but no suffix we can use a
573 pointer into the original address. If there is a suffix, however, we have to
574 build a new string.
575
576 Arguments:
577   addr              the address item
578   include_affixes   TRUE if affixes are to be included
579
580 Returns:            a string
581 */
582
583 const uschar *
584 transport_rcpt_address(address_item *addr, BOOL include_affixes)
585 {
586 uschar *at;
587 int plen, slen;
588
589 if (include_affixes)
590   {
591   setflag(addr, af_include_affixes);  /* Affects logged => line */
592   return addr->address;
593   }
594
595 if (!addr->suffix)
596   {
597   if (!addr->prefix) return addr->address;
598   return addr->address + Ustrlen(addr->prefix);
599   }
600
601 at = Ustrrchr(addr->address, '@');
602 plen = addr->prefix ? Ustrlen(addr->prefix) : 0;
603 slen = Ustrlen(addr->suffix);
604
605 return string_sprintf("%.*s@%s", (int)(at - addr->address - plen - slen),
606    addr->address + plen, at + 1);
607 }
608
609
610 /*************************************************
611 *  Output Envelope-To: address & scan duplicates *
612 *************************************************/
613
614 /* This function is called from internal_transport_write_message() below, when
615 generating an Envelope-To: header line. It checks for duplicates of the given
616 address and its ancestors. When one is found, this function calls itself
617 recursively, to output the envelope address of the duplicate.
618
619 We want to avoid duplication in the list, which can arise for example when
620 A->B,C and then both B and C alias to D. This can also happen when there are
621 unseen drivers in use. So a list of addresses that have been output is kept in
622 the plist variable.
623
624 It is also possible to have loops in the address ancestry/duplication graph,
625 for example if there are two top level addresses A and B and we have A->B,C and
626 B->A. To break the loop, we use a list of processed addresses in the dlist
627 variable.
628
629 After handling duplication, this function outputs the progenitor of the given
630 address.
631
632 Arguments:
633   p         the address we are interested in
634   pplist    address of anchor of the list of addresses not to output
635   pdlist    address of anchor of the list of processed addresses
636   first     TRUE if this is the first address; set it FALSE afterwards
637   tctx      transport context - processing to be done during output
638               and the file descriptor to write to
639
640 Returns:    FALSE if writing failed
641 */
642
643 static BOOL
644 write_env_to(address_item *p, struct aci **pplist, struct aci **pdlist,
645   BOOL *first, transport_ctx * tctx)
646 {
647 address_item *pp;
648 struct aci *ppp;
649
650 /* Do nothing if we have already handled this address. If not, remember it
651 so that we don't handle it again. */
652
653 for (ppp = *pdlist; ppp; ppp = ppp->next) if (p == ppp->ptr) return TRUE;
654
655 ppp = store_get(sizeof(struct aci), GET_UNTAINTED);
656 ppp->next = *pdlist;
657 *pdlist = ppp;
658 ppp->ptr = p;
659
660 /* Now scan up the ancestry, checking for duplicates at each generation. */
661
662 for (pp = p;; pp = pp->parent)
663   {
664   address_item *dup;
665   for (dup = addr_duplicate; dup; dup = dup->next)
666     if (dup->dupof == pp)   /* a dup of our address */
667       if (!write_env_to(dup, pplist, pdlist, first, tctx))
668         return FALSE;
669   if (!pp->parent) break;
670   }
671
672 /* Check to see if we have already output the progenitor. */
673
674 for (ppp = *pplist; ppp; ppp = ppp->next) if (pp == ppp->ptr) break;
675 if (ppp) return TRUE;
676
677 /* Remember what we have output, and output it. */
678
679 ppp = store_get(sizeof(struct aci), GET_UNTAINTED);
680 ppp->next = *pplist;
681 *pplist = ppp;
682 ppp->ptr = pp;
683
684 if (!*first && !write_chunk(tctx, US",\n ", 3)) return FALSE;
685 *first = FALSE;
686 return write_chunk(tctx, pp->address, Ustrlen(pp->address));
687 }
688
689
690
691
692 /* Add/remove/rewrite headers, and send them plus the empty-line separator.
693
694 Globals:
695   header_list
696
697 Arguments:
698   addr                  (chain of) addresses (for extra headers), or NULL;
699                           only the first address is used
700   tctx                  transport context
701   sendfn                function for output (transport or verify)
702
703 Returns:                TRUE on success; FALSE on failure.
704 */
705 BOOL
706 transport_headers_send(transport_ctx * tctx,
707   BOOL (*sendfn)(transport_ctx * tctx, const uschar * s, int len))
708 {
709 const uschar * list;
710 transport_instance * tblock = tctx ? tctx->tblock : NULL;
711 address_item * addr = tctx ? tctx->addr : NULL;
712
713 /* Then the message's headers. Don't write any that are flagged as "old";
714 that means they were rewritten, or are a record of envelope rewriting, or
715 were removed (e.g. Bcc). If remove_headers is not null, skip any headers that
716 match any entries therein.  It is a colon-sep list; expand the items
717 separately and squash any empty ones.
718 Then check addr->prop.remove_headers too, provided that addr is not NULL. */
719
720 for (header_line * h = header_list; h; h = h->next) if (h->type != htype_old)
721   {
722   BOOL include_header = TRUE;
723
724   list = tblock ? tblock->remove_headers : NULL;
725   for (int i = 0; i < 2; i++)    /* For remove_headers && addr->prop.remove_headers */
726     {
727     if (list)
728       {
729       int sep = ':';         /* This is specified as a colon-separated list */
730       uschar *s, *ss;
731       while ((s = string_nextinlist(&list, &sep, NULL, 0)))
732         {
733         int len;
734
735         if (i == 0)
736           if (!(s = expand_string(s)) && !f.expand_string_forcedfail)
737             {
738             errno = ERRNO_CHHEADER_FAIL;
739             return FALSE;
740             }
741         len = s ? Ustrlen(s) : 0;
742         if (len && s[len-1] == '*')     /* trailing glob */
743           {
744           if (strncmpic(h->text, s, len-1) == 0) break;
745           }
746         else
747           {
748           if (strncmpic(h->text, s, len) != 0) continue;
749           ss = h->text + len;
750           while (*ss == ' ' || *ss == '\t') ss++;
751           if (*ss == ':') break;
752           }
753         }
754       if (s) { include_header = FALSE; break; }
755       }
756     if (addr) list = addr->prop.remove_headers;
757     }
758
759   /* If this header is to be output, try to rewrite it if there are rewriting
760   rules. */
761
762   if (include_header)
763     {
764     int len;
765     if (tblock && tblock->rewrite_rules)
766       {
767       rmark reset_point = store_mark();
768       header_line * hh;
769
770       if ((hh = rewrite_header(h, NULL, NULL, tblock->rewrite_rules,
771                   tblock->rewrite_existflags, FALSE)))
772         {
773         len = hh->slen;
774         if (tctx->options & topt_truncate_headers && len > 998) len = 998;
775         if (!sendfn(tctx, hh->text, len)) return FALSE;
776         store_reset(reset_point);
777         continue;     /* With the next header line */
778         }
779       }
780
781     /* Either no rewriting rules, or it didn't get rewritten */
782
783     len = h->slen;
784     if (tctx->options & topt_truncate_headers && len > 998) len = 998;
785     if (!sendfn(tctx, h->text, len)) return FALSE;
786     }
787
788   /* Header removed */
789
790   else
791     DEBUG(D_transport) debug_printf("removed header line:\n %s---\n", h->text);
792   }
793
794 /* Add on any address-specific headers. If there are multiple addresses,
795 they will all have the same headers in order to be batched. The headers
796 are chained in reverse order of adding (so several addresses from the
797 same alias might share some of them) but we want to output them in the
798 opposite order. This is a bit tedious, but there shouldn't be very many
799 of them. We just walk the list twice, reversing the pointers each time,
800 but on the second time, write out the items.
801
802 Headers added to an address by a router are guaranteed to end with a newline.
803 */
804
805 if (addr)
806   {
807   header_line * hprev = addr->prop.extra_headers, * hnext, * h;
808
809   for (int i = 0; i < 2; i++)
810     for (h = hprev, hprev = NULL; h; h = hnext)
811       {
812       hnext = h->next;
813       h->next = hprev;
814       hprev = h;
815       if (i == 1)
816         {
817         if (!sendfn(tctx, h->text, h->slen)) return FALSE;
818         DEBUG(D_transport)
819           debug_printf("added header line(s):\n %s---\n", h->text);
820         }
821       }
822   }
823
824 /* If a string containing additional headers exists it is a newline-sep
825 list.  Expand each item and write out the result.  This is done last so that
826 if it (deliberately or accidentally) isn't in header format, it won't mess
827 up any other headers. An empty string or a forced expansion failure are
828 noops. An added header string from a transport may not end with a newline;
829 add one if it does not. */
830
831 if (tblock && (list = CUS tblock->add_headers))
832   {
833   int sep = '\n';
834   uschar * s;
835
836   while ((s = string_nextinlist(&list, &sep, NULL, 0)))
837     if ((s = expand_string(s)))
838       {
839       int len = Ustrlen(s);
840       if (len > 0)
841         {
842         if (!sendfn(tctx, s, len)) return FALSE;
843         if (s[len-1] != '\n' && !sendfn(tctx, US"\n", 1))
844           return FALSE;
845         DEBUG(D_transport)
846           {
847           debug_printf("added header line:\n %s", s);
848           if (s[len-1] != '\n') debug_printf("\n");
849           debug_printf("---\n");
850           }
851         }
852       }
853     else if (!f.expand_string_forcedfail)
854       { errno = ERRNO_CHHEADER_FAIL; return FALSE; }
855   }
856
857 /* Separate headers from body with a blank line */
858
859 return sendfn(tctx, US"\n", 1);
860 }
861
862
863 /*************************************************
864 *                Write the message               *
865 *************************************************/
866
867 /* This function writes the message to the given file descriptor. The headers
868 are in the in-store data structure, and the rest of the message is in the open
869 file descriptor deliver_datafile. Make sure we start it at the beginning.
870
871 . If add_return_path is TRUE, a "return-path:" header is added to the message,
872   containing the envelope sender's address.
873
874 . If add_envelope_to is TRUE, a "envelope-to:" header is added to the message,
875   giving the top-level envelope address that caused this delivery to happen.
876
877 . If add_delivery_date is TRUE, a "delivery-date:" header is added to the
878   message. It gives the time and date that delivery took place.
879
880 . If check_string is not null, the start of each line is checked for that
881   string. If it is found, it is replaced by escape_string. This used to be
882   the "from hack" for files, and "smtp_dots" for escaping SMTP dots.
883
884 . If use_crlf is true, newlines are turned into CRLF (SMTP output).
885
886 The yield is TRUE if all went well, and FALSE if not. Exit *immediately* after
887 any writing or reading error, leaving the code in errno intact. Error exits
888 can include timeouts for certain transports, which are requested by setting
889 transport_write_timeout non-zero.
890
891 Arguments:
892   tctx
893     (fd, msg)           Either an fd, to write the message to,
894                         or a string: if null write message to allocated space
895                         otherwire take content as headers.
896     addr                (chain of) addresses (for extra headers), or NULL;
897                           only the first address is used
898     tblock              optional transport instance block (NULL signifies NULL/0):
899       add_headers           a string containing one or more headers to add; it is
900                             expanded, and must be in correct RFC 822 format as
901                             it is transmitted verbatim; NULL => no additions,
902                             and so does empty string or forced expansion fail
903       remove_headers        a colon-separated list of headers to remove, or NULL
904       rewrite_rules         chain of header rewriting rules
905       rewrite_existflags    flags for the rewriting rules
906     options               bit-wise options:
907       add_return_path       if TRUE, add a "return-path" header
908       add_envelope_to       if TRUE, add a "envelope-to" header
909       add_delivery_date     if TRUE, add a "delivery-date" header
910       use_crlf              if TRUE, turn NL into CR LF
911       end_dot               if TRUE, send a terminating "." line at the end
912       no_flush              if TRUE, do not flush at end
913       no_headers            if TRUE, omit the headers
914       no_body               if TRUE, omit the body
915     check_string          a string to check for at the start of lines, or NULL
916     escape_string         a string to insert in front of any check string
917   size_limit              if > 0, this is a limit to the size of message written;
918                             it is used when returning messages to their senders,
919                             and is approximate rather than exact, owing to chunk
920                             buffering
921
922 Returns:                TRUE on success; FALSE (with errno) on failure.
923                         In addition, the global variable transport_count
924                         is incremented by the number of bytes written.
925 */
926
927 static BOOL
928 internal_transport_write_message(transport_ctx * tctx, int size_limit)
929 {
930 int len, size = 0;
931
932 /* Initialize pointer in output buffer. */
933
934 transport_write_reset(tctx->options);
935
936 /* Set up the data for start-of-line data checking and escaping */
937
938 if (tctx->check_string && tctx->escape_string)
939   {
940   nl_check = tctx->check_string;
941   nl_check_length = Ustrlen(nl_check);
942   nl_escape = tctx->escape_string;
943   nl_escape_length = Ustrlen(nl_escape);
944   }
945
946 /* Whether the escaping mechanism is applied to headers or not is controlled by
947 an option (set for SMTP, not otherwise). Negate the length if not wanted till
948 after the headers. */
949
950 if (!(tctx->options & topt_escape_headers))
951   nl_check_length = -nl_check_length;
952
953 /* Write the headers if required, including any that have to be added. If there
954 are header rewriting rules, apply them.  The datasource is not the -D spoolfile
955 so temporarily hide the global that adjusts for its format. */
956
957 if (!(tctx->options & topt_no_headers))
958   {
959   BOOL save_wireformat = f.spool_file_wireformat;
960   f.spool_file_wireformat = FALSE;
961
962   /* Add return-path: if requested. */
963
964   if (tctx->options & topt_add_return_path)
965     {
966     int n;
967     uschar * s = string_sprintf("Return-path: <%.*s>\n%n",
968                           EXIM_EMAILADDR_MAX, return_path, &n);
969     if (!write_chunk(tctx, s, n)) goto bad;
970     }
971
972   /* Add envelope-to: if requested */
973
974   if (tctx->options & topt_add_envelope_to)
975     {
976     BOOL first = TRUE;
977     struct aci *plist = NULL;
978     struct aci *dlist = NULL;
979     rmark reset_point = store_mark();
980
981     if (!write_chunk(tctx, US"Envelope-to: ", 13)) goto bad;
982
983     /* Pick up from all the addresses. The plist and dlist variables are
984     anchors for lists of addresses already handled; they have to be defined at
985     this level because write_env_to() calls itself recursively. */
986
987     for (address_item * p = tctx->addr; p; p = p->next)
988       if (!write_env_to(p, &plist, &dlist, &first, tctx))
989         goto bad;
990
991     /* Add a final newline and reset the store used for tracking duplicates */
992
993     if (!write_chunk(tctx, US"\n", 1)) goto bad;
994     store_reset(reset_point);
995     }
996
997   /* Add delivery-date: if requested. */
998
999   if (tctx->options & topt_add_delivery_date)
1000     {
1001     uschar * s = tod_stamp(tod_full);
1002
1003     if (  !write_chunk(tctx, US"Delivery-date: ", 15)
1004        || !write_chunk(tctx, s, Ustrlen(s))
1005        || !write_chunk(tctx, US"\n", 1)) goto bad;
1006     }
1007
1008   /* Then the message's headers. Don't write any that are flagged as "old";
1009   that means they were rewritten, or are a record of envelope rewriting, or
1010   were removed (e.g. Bcc). If remove_headers is not null, skip any headers that
1011   match any entries therein. Then check addr->prop.remove_headers too, provided that
1012   addr is not NULL. */
1013
1014   if (!transport_headers_send(tctx, &write_chunk))
1015     {
1016 bad:
1017     f.spool_file_wireformat = save_wireformat;
1018     return FALSE;
1019     }
1020
1021   f.spool_file_wireformat = save_wireformat;
1022   }
1023
1024 /* When doing RFC3030 CHUNKING output, work out how much data would be in a
1025 last-BDAT, consisting of the current write_chunk() output buffer fill
1026 (optimally, all of the headers - but it does not matter if we already had to
1027 flush that buffer with non-last BDAT prependix) plus the amount of body data
1028 (as expanded for CRLF lines).  Then create and write BDAT(s), and ensure
1029 that further use of write_chunk() will not prepend BDATs.
1030 The first BDAT written will also first flush any outstanding MAIL and RCPT
1031 commands which were buffered thans to PIPELINING.
1032 Commands go out (using a send()) from a different buffer to data (using a
1033 write()).  They might not end up in the same TCP segment, which is
1034 suboptimal. */
1035
1036 if (tctx->options & topt_use_bdat)
1037   {
1038   off_t fsize;
1039   int hsize;
1040
1041   if ((hsize = chunk_ptr - deliver_out_buffer) < 0)
1042     hsize = 0;
1043   if (!(tctx->options & topt_no_body))
1044     {
1045     if ((fsize = lseek(deliver_datafile, 0, SEEK_END)) < 0) return FALSE;
1046     fsize -= spool_data_start_offset(message_id);
1047     if (size_limit > 0  &&  fsize > size_limit)
1048       fsize = size_limit;
1049     size = hsize + fsize;
1050     if (tctx->options & topt_use_crlf  &&  !f.spool_file_wireformat)
1051       size += body_linecount;   /* account for CRLF-expansion */
1052
1053     /* With topt_use_bdat we never do dot-stuffing; no need to
1054     account for any expansion due to that. */
1055     }
1056
1057   /* If the message is large, emit first a non-LAST chunk with just the
1058   headers, and reap the command responses.  This lets us error out early
1059   on RCPT rejects rather than sending megabytes of data.  Include headers
1060   on the assumption they are cheap enough and some clever implementations
1061   might errorcheck them too, on-the-fly, and reject that chunk. */
1062
1063   if (size > DELIVER_OUT_BUFFER_SIZE && hsize > 0)
1064     {
1065     DEBUG(D_transport)
1066       debug_printf("sending small initial BDAT; hsize=%d\n", hsize);
1067     if (  tctx->chunk_cb(tctx, hsize, 0) != OK
1068        || !transport_write_block(tctx, deliver_out_buffer, hsize, FALSE)
1069        || tctx->chunk_cb(tctx, 0, tc_reap_prev) != OK
1070        )
1071       return FALSE;
1072     chunk_ptr = deliver_out_buffer;
1073     size -= hsize;
1074     }
1075
1076   /* Emit a LAST datachunk command, and unmark the context for further
1077   BDAT commands. */
1078
1079   if (tctx->chunk_cb(tctx, size, tc_chunk_last) != OK)
1080     return FALSE;
1081   tctx->options &= ~topt_use_bdat;
1082   }
1083
1084 /* If the body is required, ensure that the data for check strings (formerly
1085 the "from hack") is enabled by negating the length if necessary. (It will be
1086 negative in cases where it isn't to apply to the headers). Then ensure the body
1087 is positioned at the start of its file (following the message id), then write
1088 it, applying the size limit if required. */
1089
1090 /* If we have a wireformat -D file (CRNL lines, non-dotstuffed, no ending dot)
1091 and we want to send a body without dotstuffing or ending-dot, in-clear,
1092 then we can just dump it using sendfile.
1093 This should get used for CHUNKING output and also for writing the -K file for
1094 dkim signing,  when we had CHUNKING input.  */
1095
1096 #ifdef OS_SENDFILE
1097 if (  f.spool_file_wireformat
1098    && !(tctx->options & (topt_no_body | topt_end_dot))
1099    && !nl_check_length
1100    && tls_out.active.sock != tctx->u.fd
1101    )
1102   {
1103   ssize_t copied = 0;
1104   off_t offset = spool_data_start_offset(message_id);
1105
1106   /* Write out any header data in the buffer */
1107
1108   if ((len = chunk_ptr - deliver_out_buffer) > 0)
1109     {
1110     if (!transport_write_block(tctx, deliver_out_buffer, len, TRUE))
1111       return FALSE;
1112     size -= len;
1113     }
1114
1115   DEBUG(D_transport) debug_printf("using sendfile for body\n");
1116
1117   while(size > 0)
1118     {
1119     if ((copied = os_sendfile(tctx->u.fd, deliver_datafile, &offset, size)) <= 0) break;
1120     size -= copied;
1121     }
1122   return copied >= 0;
1123   }
1124 #else
1125 DEBUG(D_transport) debug_printf("cannot use sendfile for body: no support\n");
1126 #endif
1127
1128 DEBUG(D_transport)
1129   if (!(tctx->options & topt_no_body))
1130     debug_printf("cannot use sendfile for body: %s\n",
1131       !f.spool_file_wireformat ? "spoolfile not wireformat"
1132       : tctx->options & topt_end_dot ? "terminating dot wanted"
1133       : nl_check_length ? "dot- or From-stuffing wanted"
1134       : "TLS output wanted");
1135
1136 if (!(tctx->options & topt_no_body))
1137   {
1138   unsigned long size = size_limit > 0 ? size_limit : ULONG_MAX;
1139
1140   nl_check_length = abs(nl_check_length);
1141   nl_partial_match = 0;
1142   if (lseek(deliver_datafile, spool_data_start_offset(message_id), SEEK_SET) < 0)
1143     return FALSE;
1144   while (  (len = MIN(DELIVER_IN_BUFFER_SIZE, size)) > 0
1145         && (len = read(deliver_datafile, deliver_in_buffer, len)) > 0)
1146     {
1147     if (!write_chunk(tctx, deliver_in_buffer, len))
1148       return FALSE;
1149     size -= len;
1150     }
1151
1152   /* A read error on the body will have left len == -1 and errno set. */
1153
1154   if (len != 0) return FALSE;
1155   }
1156
1157 /* Finished with the check string, and spool-format consideration */
1158
1159 nl_check_length = nl_escape_length = 0;
1160 f.spool_file_wireformat = FALSE;
1161
1162 /* If requested, add a terminating "." line (SMTP output). */
1163
1164 if (tctx->options & topt_end_dot)
1165   {
1166   smtp_debug_cmd(US".", 0);
1167   if (!write_chunk(tctx, US".\n", 2))
1168     return FALSE;
1169   }
1170
1171 /* Write out any remaining data in the buffer before returning. */
1172
1173 return (len = chunk_ptr - deliver_out_buffer) <= 0
1174   || transport_write_block(tctx, deliver_out_buffer, len,
1175                             !!(tctx->options & topt_no_flush));
1176 }
1177
1178
1179
1180
1181 /*************************************************
1182 *    External interface to write the message     *
1183 *************************************************/
1184
1185 /* If there is no filtering required, call the internal function above to do
1186 the real work, passing over all the arguments from this function. Otherwise,
1187 set up a filtering process, fork another process to call the internal function
1188 to write to the filter, and in this process just suck from the filter and write
1189 down the fd in the transport context. At the end, tidy up the pipes and the
1190 processes.
1191
1192 Arguments:     as for internal_transport_write_message() above
1193
1194 Returns:       TRUE on success; FALSE (with errno) for any failure
1195                transport_count is incremented by the number of bytes written
1196 */
1197
1198 BOOL
1199 transport_write_message(transport_ctx * tctx, int size_limit)
1200 {
1201 BOOL last_filter_was_NL = TRUE;
1202 BOOL save_spool_file_wireformat = f.spool_file_wireformat;
1203 BOOL yield;
1204 int rc, len, fd_read, fd_write, save_errno;
1205 int pfd[2] = {-1, -1};
1206 pid_t filter_pid, write_pid;
1207
1208 f.transport_filter_timed_out = FALSE;
1209
1210 /* If there is no filter command set up, call the internal function that does
1211 the actual work, passing it the incoming fd, and return its result. */
1212
1213 if (  !transport_filter_argv
1214    || !*transport_filter_argv
1215    || !**transport_filter_argv
1216    )
1217   return internal_transport_write_message(tctx, size_limit);
1218
1219 /* Otherwise the message must be written to a filter process and read back
1220 before being written to the incoming fd. First set up the special processing to
1221 be done during the copying. */
1222
1223 nl_partial_match = -1;
1224
1225 if (tctx->check_string && tctx->escape_string)
1226   {
1227   nl_check = tctx->check_string;
1228   nl_check_length = Ustrlen(nl_check);
1229   nl_escape = tctx->escape_string;
1230   nl_escape_length = Ustrlen(nl_escape);
1231   }
1232 else nl_check_length = nl_escape_length = 0;
1233
1234 /* Start up a subprocess to run the command. Ensure that our main fd will
1235 be closed when the subprocess execs, but remove the flag afterwards.
1236 (Otherwise, if this is a TCP/IP socket, it can't get passed on to another
1237 process to deliver another message.) We get back stdin/stdout file descriptors.
1238 If the process creation failed, give an error return. */
1239
1240 fd_read = -1;
1241 fd_write = -1;
1242 save_errno = 0;
1243 yield = FALSE;
1244 write_pid = (pid_t)(-1);
1245
1246   {
1247   int bits = fcntl(tctx->u.fd, F_GETFD);
1248   (void) fcntl(tctx->u.fd, F_SETFD, bits | FD_CLOEXEC);
1249   filter_pid = child_open(USS transport_filter_argv, NULL, 077,
1250                           &fd_write, &fd_read, FALSE, US"transport-filter");
1251   (void) fcntl(tctx->u.fd, F_SETFD, bits & ~FD_CLOEXEC);
1252   }
1253 if (filter_pid < 0) goto TIDY_UP;      /* errno set */
1254
1255 DEBUG(D_transport)
1256   debug_printf("process %d running as transport filter: fd_write=%d fd_read=%d\n",
1257     (int)filter_pid, fd_write, fd_read);
1258
1259 /* Fork subprocess to write the message to the filter, and return the result
1260 via a(nother) pipe. While writing to the filter, we do not do the CRLF,
1261 smtp dots, or check string processing. */
1262
1263 if (pipe(pfd) != 0) goto TIDY_UP;      /* errno set */
1264 if ((write_pid = exim_fork(US"tpt-filter-writer")) == 0)
1265   {
1266   BOOL rc;
1267   (void)close(fd_read);
1268   (void)close(pfd[pipe_read]);
1269   nl_check_length = nl_escape_length = 0;
1270
1271   tctx->u.fd = fd_write;
1272   tctx->check_string = tctx->escape_string = NULL;
1273   tctx->options &= ~(topt_use_crlf | topt_end_dot | topt_use_bdat | topt_no_flush);
1274
1275   rc = internal_transport_write_message(tctx, size_limit);
1276
1277   save_errno = errno;
1278   if (  write(pfd[pipe_write], (void *)&rc, sizeof(BOOL))
1279         != sizeof(BOOL)
1280      || write(pfd[pipe_write], (void *)&save_errno, sizeof(int))
1281         != sizeof(int)
1282      || write(pfd[pipe_write], (void *)&tctx->addr->more_errno, sizeof(int))
1283         != sizeof(int)
1284      || write(pfd[pipe_write], (void *)&tctx->addr->delivery_time, sizeof(struct timeval))
1285         != sizeof(struct timeval)
1286      )
1287     rc = FALSE; /* compiler quietening */
1288   exim_underbar_exit(EXIT_SUCCESS);
1289   }
1290 save_errno = errno;
1291
1292 /* Parent process: close our copy of the writing subprocess' pipes. */
1293
1294 (void)close(pfd[pipe_write]);
1295 (void)close(fd_write);
1296 fd_write = -1;
1297
1298 /* Writing process creation failed */
1299
1300 if (write_pid < 0)
1301   {
1302   errno = save_errno;    /* restore */
1303   goto TIDY_UP;
1304   }
1305
1306 /* When testing, let the subprocess get going */
1307
1308 testharness_pause_ms(250);
1309
1310 DEBUG(D_transport)
1311   debug_printf("process %d writing to transport filter\n", (int)write_pid);
1312
1313 /* Copy the message from the filter to the output fd. A read error leaves len
1314 == -1 and errno set. We need to apply a timeout to the read, to cope with
1315 the case when the filter gets stuck, but it can be quite a long one. The
1316 default is 5m, but this is now configurable. */
1317
1318 DEBUG(D_transport) debug_printf("copying from the filter\n");
1319
1320 /* Copy the output of the filter, remembering if the last character was NL. If
1321 no data is returned, that counts as "ended with NL" (default setting of the
1322 variable is TRUE).  The output should always be unix-format as we converted
1323 any wireformat source on writing input to the filter. */
1324
1325 f.spool_file_wireformat = FALSE;
1326 chunk_ptr = deliver_out_buffer;
1327
1328 for (;;)
1329   {
1330   sigalrm_seen = FALSE;
1331   ALARM(transport_filter_timeout);
1332   len = read(fd_read, deliver_in_buffer, DELIVER_IN_BUFFER_SIZE);
1333   ALARM_CLR(0);
1334   if (sigalrm_seen)
1335     {
1336     DEBUG(D_transport) debug_printf("timed out reading from filter\n");
1337     errno = ETIMEDOUT;
1338     f.transport_filter_timed_out = TRUE;
1339     goto TIDY_UP;
1340     }
1341
1342   /* If the read was successful, write the block down the original fd,
1343   remembering whether it ends in \n or not. */
1344
1345   if (len > 0)
1346     {
1347     if (!write_chunk(tctx, deliver_in_buffer, len)) goto TIDY_UP;
1348     last_filter_was_NL = (deliver_in_buffer[len-1] == '\n');
1349     }
1350
1351   /* Otherwise, break the loop. If we have hit EOF, set yield = TRUE. */
1352
1353   else
1354     {
1355     if (len == 0) yield = TRUE;
1356     break;
1357     }
1358   }
1359
1360 /* Tidying up code. If yield = FALSE there has been an error and errno is set
1361 to something. Ensure the pipes are all closed and the processes are removed. If
1362 there has been an error, kill the processes before waiting for them, just to be
1363 sure. Also apply a paranoia timeout. */
1364
1365 TIDY_UP:
1366 f.spool_file_wireformat = save_spool_file_wireformat;
1367 save_errno = errno;
1368
1369 (void)close(fd_read);
1370 if (fd_write > 0) (void)close(fd_write);
1371
1372 if (!yield)
1373   {
1374   if (filter_pid > 0) kill(filter_pid, SIGKILL);
1375   if (write_pid > 0)  kill(write_pid, SIGKILL);
1376   }
1377
1378 /* Wait for the filter process to complete. */
1379
1380 DEBUG(D_transport) debug_printf("waiting for filter process\n");
1381 if (filter_pid > 0 && (rc = child_close(filter_pid, 30)) != 0 && yield)
1382   {
1383   yield = FALSE;
1384   save_errno = ERRNO_FILTER_FAIL;
1385   tctx->addr->more_errno = rc;
1386   DEBUG(D_transport) debug_printf("filter process returned %d\n", rc);
1387   }
1388
1389 /* Wait for the writing process to complete. If it ends successfully,
1390 read the results from its pipe, provided we haven't already had a filter
1391 process failure. */
1392
1393 DEBUG(D_transport) debug_printf("waiting for writing process\n");
1394 if (write_pid > 0)
1395   {
1396   rc = child_close(write_pid, 30);
1397   if (yield)
1398     if (rc == 0)
1399       {
1400       BOOL ok;
1401       if (read(pfd[pipe_read], (void *)&ok, sizeof(BOOL)) != sizeof(BOOL))
1402         {
1403         DEBUG(D_transport)
1404           debug_printf("pipe read from writing process: %s\n", strerror(errno));
1405         save_errno = ERRNO_FILTER_FAIL;
1406         yield = FALSE;
1407         }
1408       else if (!ok)
1409         {               /* Try to drain the pipe; read fails are don't care */
1410         int dummy = read(pfd[pipe_read], (void *)&save_errno, sizeof(int));
1411         dummy = read(pfd[pipe_read], (void *)&tctx->addr->more_errno, sizeof(int));
1412         dummy = read(pfd[pipe_read], (void *)&tctx->addr->delivery_time, sizeof(struct timeval));
1413         yield = FALSE;
1414         }
1415       }
1416     else
1417       {
1418       yield = FALSE;
1419       save_errno = ERRNO_FILTER_FAIL;
1420       tctx->addr->more_errno = rc;
1421       DEBUG(D_transport) debug_printf("writing process returned %d\n", rc);
1422       }
1423   }
1424 (void)close(pfd[pipe_read]);
1425
1426 /* If there have been no problems we can now add the terminating "." if this is
1427 SMTP output, turning off escaping beforehand. If the last character from the
1428 filter was not NL, insert a NL to make the SMTP protocol work. */
1429
1430 if (yield)
1431   {
1432   nl_check_length = nl_escape_length = 0;
1433   f.spool_file_wireformat = FALSE;
1434   if (  tctx->options & topt_end_dot
1435      && ( last_filter_was_NL
1436         ? !write_chunk(tctx, US".\n", 2)
1437         : !write_chunk(tctx, US"\n.\n", 3)
1438      )  )
1439     { smtp_debug_cmd(US".", 0); yield = FALSE; }
1440
1441   /* Write out any remaining data in the buffer. */
1442
1443   else
1444     yield = (len = chunk_ptr - deliver_out_buffer) <= 0
1445           || transport_write_block(tctx, deliver_out_buffer, len, FALSE);
1446   }
1447 else
1448   errno = save_errno;      /* From some earlier error */
1449
1450 DEBUG(D_transport)
1451   {
1452   debug_printf("end of filtering transport writing: yield=%d\n", yield);
1453   if (!yield)
1454     debug_printf(" errno=%d more_errno=%d\n", errno, tctx->addr->more_errno);
1455   }
1456
1457 return yield;
1458 }
1459
1460
1461
1462
1463
1464 /*************************************************
1465 *            Update waiting database             *
1466 *************************************************/
1467
1468 /* This is called when an address is deferred by remote transports that are
1469 capable of sending more than one message over one connection. A database is
1470 maintained for each transport, keeping track of which messages are waiting for
1471 which hosts. The transport can then consult this when eventually a successful
1472 delivery happens, and if it finds that another message is waiting for the same
1473 host, it can fire up a new process to deal with it using the same connection.
1474
1475 The database records are keyed by host name. They can get full if there are
1476 lots of messages waiting, and so there is a continuation mechanism for them.
1477
1478 Each record contains a list of message ids, packed end to end without any
1479 zeros. Each one is MESSAGE_ID_LENGTH bytes long. The count field says how many
1480 in this record, and the sequence field says if there are any other records for
1481 this host. If the sequence field is 0, there are none. If it is 1, then another
1482 record with the name <hostname>:0 exists; if it is 2, then two other records
1483 with sequence numbers 0 and 1 exist, and so on.
1484
1485 Currently, an exhaustive search of all continuation records has to be done to
1486 determine whether to add a message id to a given record. This shouldn't be
1487 too bad except in extreme cases. I can't figure out a *simple* way of doing
1488 better.
1489
1490 Old records should eventually get swept up by the exim_tidydb utility.
1491
1492 Arguments:
1493   hostlist  list of hosts that this message could be sent to
1494   tpname    name of the transport
1495
1496 Returns:    nothing
1497 */
1498
1499 void
1500 transport_update_waiting(host_item * hostlist, uschar * tpname)
1501 {
1502 const uschar *prevname = US"";
1503 open_db dbblock;
1504 open_db *dbm_file;
1505
1506 if (!is_new_message_id(message_id))
1507   {
1508   DEBUG(D_transport) debug_printf("message_id %s is not new format; "
1509     "skipping wait-%s database update\n", tpname);
1510   return;
1511   }
1512
1513 DEBUG(D_transport) debug_printf("updating wait-%s database\n", tpname);
1514
1515 /* Open the database for this transport */
1516
1517 if (!(dbm_file = dbfn_open(string_sprintf("wait-%.200s", tpname),
1518                       O_RDWR, &dbblock, TRUE, TRUE)))
1519   return;
1520
1521 /* Scan the list of hosts for which this message is waiting, and ensure
1522 that the message id is in each host record. */
1523
1524 for (host_item * host = hostlist; host; host = host->next)
1525   {
1526   BOOL already = FALSE;
1527   dbdata_wait * host_record;
1528   int host_length;
1529   uschar buffer[256];
1530
1531   /* Skip if this is the same host as we just processed; otherwise remember
1532   the name for next time. */
1533
1534   if (Ustrcmp(prevname, host->name) == 0) continue;
1535   prevname = host->name;
1536
1537   /* Look up the host record; if there isn't one, make an empty one. */
1538
1539   if (!(host_record = dbfn_read(dbm_file, host->name)))
1540     {
1541     host_record = store_get(sizeof(dbdata_wait) + MESSAGE_ID_LENGTH, GET_UNTAINTED);
1542     host_record->count = host_record->sequence = 0;
1543     }
1544
1545   /* Compute the current length */
1546
1547   host_length = host_record->count * MESSAGE_ID_LENGTH;
1548
1549   /* Search the record to see if the current message is already in it. */
1550
1551   for (uschar * s = host_record->text; s < host_record->text + host_length;
1552        s += MESSAGE_ID_LENGTH)
1553     {
1554     /* If any ID is seen which is not new-format, wipe the record and
1555     any continuations */
1556
1557     if (!is_new_message_id(s))
1558       {
1559       DEBUG(D_hints_lookup)
1560         debug_printf_indent("NOTE: old or corrupt message-id found in wait=%.200s"
1561           " hints DB; deleting records for %s\n", tpname, host->name);
1562
1563       (void) dbfn_delete(dbm_file, host->name);
1564       for (int i = host_record->sequence - 1; i >= 0; i--)
1565         (void) dbfn_delete(dbm_file,
1566                     (sprintf(CS buffer, "%.200s:%d", host->name, i), buffer));
1567
1568       host_record->count = host_record->sequence = 0;
1569       break;
1570       }
1571     if (Ustrncmp(s, message_id, MESSAGE_ID_LENGTH) == 0)
1572       { already = TRUE; break; }
1573     }
1574
1575   /* If we haven't found this message in the main record, search any
1576   continuation records that exist. */
1577
1578   for (int i = host_record->sequence - 1; i >= 0 && !already; i--)
1579     {
1580     dbdata_wait *cont;
1581     sprintf(CS buffer, "%.200s:%d", host->name, i);
1582     if ((cont = dbfn_read(dbm_file, buffer)))
1583       {
1584       int clen = cont->count * MESSAGE_ID_LENGTH;
1585       for (uschar * s = cont->text; s < cont->text + clen; s += MESSAGE_ID_LENGTH)
1586         if (Ustrncmp(s, message_id, MESSAGE_ID_LENGTH) == 0)
1587           { already = TRUE; break; }
1588       }
1589     }
1590
1591   /* If this message is already in a record, no need to update. */
1592
1593   if (already)
1594     {
1595     DEBUG(D_transport) debug_printf("already listed for %s\n", host->name);
1596     continue;
1597     }
1598
1599
1600   /* If this record is full, write it out with a new name constructed
1601   from the sequence number, increase the sequence number, and empty
1602   the record.  If we're doing a two-phase queue run initial phase, ping the
1603   daemon to consider running a delivery on this host. */
1604
1605   if (host_record->count >= WAIT_NAME_MAX)
1606     {
1607     sprintf(CS buffer, "%.200s:%d", host->name, host_record->sequence);
1608     dbfn_write(dbm_file, buffer, host_record, sizeof(dbdata_wait) + host_length);
1609 #ifndef DISABLE_QUEUE_RAMP
1610     if (f.queue_2stage && queue_fast_ramp && !queue_run_in_order)
1611       queue_notify_daemon(message_id);
1612 #endif
1613     host_record->sequence++;
1614     host_record->count = 0;
1615     host_length = 0;
1616     }
1617
1618   /* If this record is not full, increase the size of the record to
1619   allow for one new message id. */
1620
1621   else
1622     {
1623     dbdata_wait *newr =
1624       store_get(sizeof(dbdata_wait) + host_length + MESSAGE_ID_LENGTH, GET_UNTAINTED);
1625     memcpy(newr, host_record, sizeof(dbdata_wait) + host_length);
1626     host_record = newr;
1627     }
1628
1629   /* Now add the new name on the end */
1630
1631   memcpy(host_record->text + host_length, message_id, MESSAGE_ID_LENGTH);
1632   host_record->count++;
1633   host_length += MESSAGE_ID_LENGTH;
1634
1635   /* Update the database */
1636
1637   dbfn_write(dbm_file, host->name, host_record, sizeof(dbdata_wait) + host_length);
1638   DEBUG(D_transport) debug_printf("added %.*s to queue for %s\n",
1639                                   MESSAGE_ID_LENGTH, message_id, host->name);
1640   }
1641
1642 /* All now done */
1643
1644 dbfn_close(dbm_file);
1645 }
1646
1647
1648
1649
1650 /*************************************************
1651 *         Test for waiting messages              *
1652 *************************************************/
1653
1654 /* This function is called by a remote transport which uses the previous
1655 function to remember which messages are waiting for which remote hosts. It's
1656 called after a successful delivery and its job is to check whether there is
1657 another message waiting for the same host. However, it doesn't do this if the
1658 current continue sequence is greater than the maximum supplied as an argument,
1659 or greater than the global connection_max_messages, which, if set, overrides.
1660
1661 It is also called if conditions are otherwise right for pipelining a QUIT after
1662 the message data, since if there is another message waiting we do not want to
1663 send that QUIT.
1664
1665 Arguments:
1666   transport_name     name of the transport
1667   hostname           name of the host
1668   local_message_max  maximum number of messages down one connection
1669                        as set by the caller transport
1670   new_message_id     set to the message id of a waiting message
1671   oicf_func          function to call to validate if it is ok to send
1672                      to this message_id from the current instance.
1673   oicf_data          opaque data for oicf_func
1674
1675 Returns:             TRUE if new_message_id set; FALSE otherwise
1676 */
1677
1678 typedef struct msgq_s
1679 {
1680     uschar  message_id [MESSAGE_ID_LENGTH + 1];
1681     BOOL    bKeep;
1682 } msgq_t;
1683
1684 BOOL
1685 transport_check_waiting(const uschar * transport_name, const uschar * hostname,
1686   int local_message_max, uschar * new_message_id,
1687   oicf oicf_func, void * oicf_data)
1688 {
1689 dbdata_wait * host_record;
1690 int host_length;
1691 open_db dbblock;
1692 open_db * dbm_file;
1693
1694 int         i;
1695 struct stat statbuf;
1696
1697 DEBUG(D_transport)
1698   {
1699   debug_printf("transport_check_waiting entered\n");
1700   debug_printf("  sequence=%d local_max=%d global_max=%d\n",
1701     continue_sequence, local_message_max, connection_max_messages);
1702   acl_level++;
1703   }
1704
1705 /* Do nothing if we have hit the maximum number that can be send down one
1706 connection. */
1707
1708 if (connection_max_messages >= 0) local_message_max = connection_max_messages;
1709 if (local_message_max > 0 && continue_sequence >= local_message_max)
1710   {
1711   DEBUG(D_transport)
1712     debug_printf_indent("max messages for one connection reached: returning\n");
1713   goto retfalse;
1714   }
1715
1716 /* Open the waiting information database. */
1717
1718 if (!(dbm_file = dbfn_open(string_sprintf("wait-%.200s", transport_name),
1719                           O_RDWR, &dbblock, TRUE, TRUE)))
1720   goto retfalse;
1721
1722 /* See if there is a record for this host; if not, there's nothing to do. */
1723
1724 if (!(host_record = dbfn_read(dbm_file, hostname)))
1725   {
1726   dbfn_close(dbm_file);
1727   DEBUG(D_transport) debug_printf_indent("no messages waiting for %s\n", hostname);
1728   goto retfalse;
1729   }
1730
1731 /* If the data in the record looks corrupt, just log something and
1732 don't try to use it. */
1733
1734 if (host_record->count > WAIT_NAME_MAX)
1735   {
1736   dbfn_close(dbm_file);
1737   log_write(0, LOG_MAIN|LOG_PANIC, "smtp-wait database entry for %s has bad "
1738     "count=%d (max=%d)", hostname, host_record->count, WAIT_NAME_MAX);
1739   goto retfalse;
1740   }
1741
1742 /* Scan the message ids in the record from the end towards the beginning,
1743 until one is found for which a spool file actually exists. If the record gets
1744 emptied, delete it and continue with any continuation records that may exist.
1745 */
1746
1747 /* For Bug 1141, I refactored this major portion of the routine, it is risky
1748 but the 1 off will remain without it.  This code now allows me to SKIP over
1749 a message I do not want to send out on this run.  */
1750
1751 host_length = host_record->count * MESSAGE_ID_LENGTH;
1752
1753 while (1)
1754   {
1755   msgq_t      *msgq;
1756   int         msgq_count = 0;
1757   int         msgq_actual = 0;
1758   BOOL        bFound = FALSE;
1759   BOOL        bContinuation = FALSE;
1760
1761   /* create an array to read entire message queue into memory for processing  */
1762
1763   msgq = store_get(sizeof(msgq_t) * host_record->count, GET_UNTAINTED);
1764   msgq_count = host_record->count;
1765   msgq_actual = msgq_count;
1766
1767   for (i = 0; i < host_record->count; ++i)
1768     {
1769     /* If any ID is seen which is not new-format, wipe the record and
1770     any continuations */
1771
1772     if (!is_new_message_id(host_record->text + (i * MESSAGE_ID_LENGTH)))
1773       {
1774       uschar buffer[256];
1775       DEBUG(D_hints_lookup)
1776         debug_printf_indent("NOTE: old or corrupt message-id found in wait=%.200s"
1777           " hints DB; deleting records for %s\n", transport_name, hostname);
1778       (void) dbfn_delete(dbm_file, hostname);
1779       for (int i = host_record->sequence - 1; i >= 0; i--)
1780         (void) dbfn_delete(dbm_file,
1781                     (sprintf(CS buffer, "%.200s:%d", hostname, i), buffer));
1782       dbfn_close(dbm_file);
1783       goto retfalse;
1784       }
1785     msgq[i].bKeep = TRUE;
1786
1787     Ustrncpy_nt(msgq[i].message_id, host_record->text + (i * MESSAGE_ID_LENGTH),
1788       MESSAGE_ID_LENGTH);
1789     msgq[i].message_id[MESSAGE_ID_LENGTH] = 0;
1790     }
1791
1792   /* first thing remove current message id if it exists */
1793   /*XXX but what if it has un-sent addrs? */
1794
1795   for (i = 0; i < msgq_count; ++i)
1796     if (Ustrcmp(msgq[i].message_id, message_id) == 0)
1797       {
1798       msgq[i].bKeep = FALSE;
1799       break;
1800       }
1801
1802   /* now find the next acceptable message_id */
1803
1804   for (i = msgq_count - 1; i >= 0; --i) if (msgq[i].bKeep)
1805     {
1806     uschar subdir[2];
1807     uschar * mid = msgq[i].message_id;
1808
1809     set_subdir_str(subdir, mid, 0);
1810     if (Ustat(spool_fname(US"input", subdir, mid, US"-D"), &statbuf) != 0)
1811       msgq[i].bKeep = FALSE;
1812     else if (!oicf_func || oicf_func(mid, oicf_data))
1813       {
1814       Ustrcpy_nt(new_message_id, mid);
1815       msgq[i].bKeep = FALSE;
1816       bFound = TRUE;
1817       break;
1818       }
1819     }
1820
1821   /* re-count */
1822   for (msgq_actual = 0, i = 0; i < msgq_count; ++i)
1823     if (msgq[i].bKeep)
1824       msgq_actual++;
1825
1826   /* reassemble the host record, based on removed message ids, from in
1827   memory queue  */
1828
1829   if (msgq_actual <= 0)
1830     {
1831     host_length = 0;
1832     host_record->count = 0;
1833     }
1834   else
1835     {
1836     host_length = msgq_actual * MESSAGE_ID_LENGTH;
1837     host_record->count = msgq_actual;
1838
1839     if (msgq_actual < msgq_count)
1840       {
1841       int new_count;
1842       for (new_count = 0, i = 0; i < msgq_count; ++i)
1843         if (msgq[i].bKeep)
1844           Ustrncpy(&host_record->text[new_count++ * MESSAGE_ID_LENGTH],
1845             msgq[i].message_id, MESSAGE_ID_LENGTH);
1846
1847       host_record->text[new_count * MESSAGE_ID_LENGTH] = 0;
1848       }
1849     }
1850
1851   /* Check for a continuation record. */
1852
1853   while (host_length <= 0)
1854     {
1855     dbdata_wait * newr = NULL;
1856     uschar buffer[256];
1857
1858     /* Search for a continuation */
1859
1860     for (int i = host_record->sequence - 1; i >= 0 && !newr; i--)
1861       {
1862       sprintf(CS buffer, "%.200s:%d", hostname, i);
1863       newr = dbfn_read(dbm_file, buffer);
1864       }
1865
1866     /* If no continuation, delete the current and break the loop */
1867
1868     if (!newr)
1869       {
1870       dbfn_delete(dbm_file, hostname);
1871       break;
1872       }
1873
1874     /* Else replace the current with the continuation */
1875
1876     dbfn_delete(dbm_file, buffer);
1877     host_record = newr;
1878     host_length = host_record->count * MESSAGE_ID_LENGTH;
1879
1880     bContinuation = TRUE;
1881     }
1882
1883   if (bFound)           /* Usual exit from main loop */
1884     break;
1885
1886   /* If host_length <= 0 we have emptied a record and not found a good message,
1887   and there are no continuation records. Otherwise there is a continuation
1888   record to process. */
1889
1890   if (host_length <= 0)
1891     {
1892     dbfn_close(dbm_file);
1893     DEBUG(D_transport) debug_printf_indent("waiting messages already delivered\n");
1894     goto retfalse;
1895     }
1896
1897   /* we were not able to find an acceptable message, nor was there a
1898    * continuation record.  So bug out, outer logic will clean this up.
1899    */
1900
1901   if (!bContinuation)
1902     {
1903     Ustrcpy(new_message_id, message_id);
1904     dbfn_close(dbm_file);
1905     goto retfalse;
1906     }
1907   }             /* we need to process a continuation record */
1908
1909 /* Control gets here when an existing message has been encountered; its
1910 id is in new_message_id, and host_length is the revised length of the
1911 host record. If it is zero, the record has been removed. Update the
1912 record if required, close the database, and return TRUE. */
1913
1914 if (host_length > 0)
1915   {
1916   host_record->count = host_length/MESSAGE_ID_LENGTH;
1917   dbfn_write(dbm_file, hostname, host_record, (int)sizeof(dbdata_wait) + host_length);
1918   }
1919
1920 dbfn_close(dbm_file);
1921 DEBUG(D_transport) {acl_level--; debug_printf("transport_check_waiting: TRUE\n"); }
1922 return TRUE;
1923
1924 retfalse:
1925 DEBUG(D_transport) {acl_level--; debug_printf("transport_check_waiting: FALSE\n"); }
1926 return FALSE;
1927 }
1928
1929 /*************************************************
1930 *    Deliver waiting message down same socket    *
1931 *************************************************/
1932
1933 /* Just the regain-root-privilege exec portion */
1934 void
1935 transport_do_pass_socket(const uschar * transport_name, const uschar * hostname,
1936   const uschar * hostaddress, uschar * id, int socket_fd)
1937 {
1938 int i = 13;
1939 const uschar **argv;
1940
1941 #ifndef DISABLE_TLS
1942 if (smtp_peer_options & OPTION_TLS) i += 6;
1943 #endif
1944 #ifndef DISABLE_ESMTP_LIMITS
1945 if (continue_limit_mail || continue_limit_rcpt || continue_limit_rcptdom)
1946                                     i += 4;
1947 #endif
1948 if (queue_run_pid != (pid_t)0)      i += 3;
1949 #ifdef SUPPORT_SOCKS
1950 if (proxy_session)                  i += 5;
1951 #endif
1952
1953 /* Set up the calling arguments; use the standard function for the basics,
1954 but we have a number of extras that may be added. */
1955
1956 argv = CUSS child_exec_exim(CEE_RETURN_ARGV, TRUE, &i, FALSE, 0);
1957
1958 if (f.smtp_authenticated)                       argv[i++] = US"-MCA";
1959 if (smtp_peer_options & OPTION_CHUNKING)        argv[i++] = US"-MCK";
1960 if (smtp_peer_options & OPTION_DSN)             argv[i++] = US"-MCD";
1961 if (smtp_peer_options & OPTION_PIPE)            argv[i++] = US"-MCP";
1962 if (smtp_peer_options & OPTION_SIZE)            argv[i++] = US"-MCS";
1963 #ifndef DISABLE_TLS
1964 if (smtp_peer_options & OPTION_TLS)
1965   if (tls_out.active.sock >= 0 || continue_proxy_cipher)
1966     {
1967     argv[i++] = US"-MCt";
1968     argv[i++] = sending_ip_address;
1969     argv[i++] = string_sprintf("%d", sending_port);
1970     argv[i++] = tls_out.active.sock >= 0 ? tls_out.cipher : continue_proxy_cipher;
1971
1972     if (tls_out.sni)
1973       {
1974       argv[i++] =
1975 #ifdef SUPPORT_DANE
1976         tls_out.dane_verified ? US"-MCr" :
1977 #endif
1978         US"-MCs";
1979       argv[i++] = tls_out.sni;
1980       }
1981     }
1982   else
1983     argv[i++] = US"-MCT";
1984 #endif
1985
1986 #ifndef DISABLE_ESMTP_LIMITS
1987 if (continue_limit_rcpt || continue_limit_rcptdom)
1988   {
1989   argv[i++] = US"-MCL";
1990   argv[i++] = string_sprintf("%u", continue_limit_mail);
1991   argv[i++] = string_sprintf("%u", continue_limit_rcpt);
1992   argv[i++] = string_sprintf("%u", continue_limit_rcptdom);
1993   }
1994 #endif
1995
1996 if (queue_run_pid != (pid_t)0)
1997   {
1998   argv[i++] = US"-MCQ";
1999   argv[i++] = string_sprintf("%d", queue_run_pid);
2000   argv[i++] = string_sprintf("%d", queue_run_pipe);
2001   }
2002
2003 #ifdef SUPPORT_SOCKS
2004 if (proxy_session)
2005   {
2006   argv[i++] = US"-MCp";
2007   argv[i++] = proxy_local_address;
2008   argv[i++] = string_sprintf("%d", proxy_local_port);
2009   argv[i++] = proxy_external_address;
2010   argv[i++] = string_sprintf("%d", proxy_external_port);
2011   }
2012 #endif
2013
2014 argv[i++] = US"-MC";
2015 argv[i++] = US transport_name;
2016 argv[i++] = US hostname;
2017 argv[i++] = US hostaddress;
2018 argv[i++] = string_sprintf("%d", continue_sequence + 1);
2019 argv[i++] = id;
2020 argv[i++] = NULL;
2021
2022 /* Arrange for the channel to be on stdin. */
2023
2024 if (socket_fd != 0)
2025   {
2026   (void)dup2(socket_fd, 0);
2027   (void)close(socket_fd);
2028   }
2029
2030 DEBUG(D_exec) debug_print_argv(argv);
2031 exim_nullstd();                          /* Ensure std{out,err} exist */
2032 /* argv[0] should be untainted, from child_exec_exim() */
2033 execv(CS argv[0], (char *const *)argv);
2034
2035 DEBUG(D_any) debug_printf("execv failed: %s\n", strerror(errno));
2036 _exit(errno);         /* Note: must be _exit(), NOT exit() */
2037 }
2038
2039
2040
2041 /* Fork a new exim process to deliver the message, and do a re-exec, both to
2042 get a clean delivery process, and to regain root privilege in cases where it
2043 has been given away.
2044
2045 Arguments:
2046   transport_name  to pass to the new process
2047   hostname        ditto
2048   hostaddress     ditto
2049   id              the new message to process
2050   socket_fd       the connected socket
2051
2052 Returns:          FALSE if fork fails; TRUE otherwise
2053 */
2054
2055 BOOL
2056 transport_pass_socket(const uschar *transport_name, const uschar *hostname,
2057   const uschar *hostaddress, uschar *id, int socket_fd
2058 #ifndef DISABLE_ESMTP_LIMITS
2059   , unsigned peer_limit_mail, unsigned peer_limit_rcpt, unsigned peer_limit_rcptdom
2060 #endif
2061   )
2062 {
2063 pid_t pid;
2064 int status;
2065
2066 DEBUG(D_transport) debug_printf("transport_pass_socket entered\n");
2067
2068 #ifndef DISABLE_ESMTP_LIMITS
2069 continue_limit_mail = peer_limit_mail;
2070 continue_limit_rcpt = peer_limit_rcpt;
2071 continue_limit_rcptdom = peer_limit_rcptdom;
2072 #endif
2073
2074 if ((pid = exim_fork(US"continued-transport-interproc")) == 0)
2075   {
2076   /* Disconnect entirely from the parent process. If we are running in the
2077   test harness, wait for a bit to allow the previous process time to finish,
2078   write the log, etc., so that the output is always in the same order for
2079   automatic comparison. */
2080
2081   if ((pid = exim_fork(US"continued-transport")) != 0)
2082     _exit(EXIT_SUCCESS);
2083   testharness_pause_ms(1000);
2084
2085   transport_do_pass_socket(transport_name, hostname, hostaddress,
2086     id, socket_fd);
2087   }
2088
2089 /* If the process creation succeeded, wait for the first-level child, which
2090 immediately exits, leaving the second level process entirely disconnected from
2091 this one. */
2092
2093 if (pid > 0)
2094   {
2095   int rc;
2096   while ((rc = wait(&status)) != pid && (rc >= 0 || errno != ECHILD));
2097   return TRUE;
2098   }
2099 else
2100   {
2101   DEBUG(D_transport) debug_printf("transport_pass_socket failed to fork: %s\n",
2102     strerror(errno));
2103   return FALSE;
2104   }
2105 }
2106
2107
2108
2109 /* Enforce all args untainted, for consistency with a router-sourced pipe
2110 command, where (because the whole line is passed as one to the tpt) a
2111 tainted arg taints the executable name.  It's unclear also that letting an
2112 attacker supply command arguments is wise. */
2113
2114 static BOOL
2115 arg_is_tainted(const uschar * s, int argn, address_item * addr,
2116   const uschar * etext, uschar ** errptr)
2117 {
2118 if (is_tainted(s))
2119   {
2120   uschar * msg = string_sprintf("Tainted arg %d for %s command: '%s'",
2121                                 argn, etext, s);
2122   if (addr)
2123     {
2124     addr->transport_return = FAIL;
2125     addr->message = msg;
2126     }
2127   else *errptr = msg;
2128   return TRUE;
2129   }
2130 return FALSE;
2131 }
2132
2133
2134 /*************************************************
2135 *          Set up direct (non-shell) command     *
2136 *************************************************/
2137
2138 /* This function is called when a command line is to be parsed and executed
2139 directly, without the use of /bin/sh. It is called by the pipe transport,
2140 the queryprogram router, for any ${run } expansion,
2141 and also from the main delivery code when setting up a
2142 transport filter process. The code for ETRN also makes use of this; in that
2143 case, no addresses are passed.
2144
2145 Arguments:
2146   argvptr            pointer to anchor for argv vector
2147   cmd                points to the command string (modified IN PLACE)
2148   flags              bits for expand-args, allow taint, allow $recipients
2149   expand_failed      error value to set if expansion fails; not relevant if
2150                      addr == NULL
2151   addr               chain of addresses, or NULL
2152   etext              text for use in error messages
2153   errptr             where to put error message if addr is NULL;
2154                      otherwise it is put in the first address
2155
2156 Returns:             TRUE if all went well; otherwise an error will be
2157                      set in the first address and FALSE returned
2158 */
2159
2160 BOOL
2161 transport_set_up_command(const uschar *** argvptr, const uschar * cmd,
2162   unsigned flags, int expand_failed, address_item * addr,
2163   const uschar * etext, uschar ** errptr)
2164 {
2165 const uschar ** argv, * s;
2166 int address_count = 0, argcount = 0, max_args;
2167
2168 /* Get store in which to build an argument list. Count the number of addresses
2169 supplied, and allow for that many arguments, plus an additional 60, which
2170 should be enough for anybody. Multiple addresses happen only when the local
2171 delivery batch option is set. */
2172
2173 for (address_item * ad = addr; ad; ad = ad->next) address_count++;
2174 max_args = address_count + 60;
2175 *argvptr = argv = store_get((max_args+1)*sizeof(uschar *), GET_UNTAINTED);
2176
2177 /* Split the command up into arguments terminated by white space. Lose
2178 trailing space at the start and end. Double-quoted arguments can contain \\ and
2179 \" escapes and so can be handled by the standard function; single-quoted
2180 arguments are verbatim. Copy each argument into a new string. */
2181
2182 s = cmd;
2183 Uskip_whitespace(&s);
2184
2185 for (; *s && argcount < max_args; argcount++)
2186   {
2187   if (*s == '\'')
2188     {
2189     int n = Ustrcspn(++s, "'");
2190     argv[argcount] = string_copyn(s, n);
2191     if (*(s += n) == '\'') s++;
2192     }
2193   else
2194     argv[argcount] = string_dequote(CUSS &s);
2195   Uskip_whitespace(&s);
2196   }
2197
2198 argv[argcount] = NULL;
2199
2200 /* If *s != 0 we have run out of argument slots. */
2201
2202 if (*s)
2203   {
2204   uschar *msg = string_sprintf("Too many arguments in command \"%s\" in "
2205     "%s", cmd, etext);
2206   if (addr)
2207     {
2208     addr->transport_return = FAIL;
2209     addr->message = msg;
2210     }
2211   else *errptr = msg;
2212   return FALSE;
2213   }
2214
2215 /* Expand each individual argument if required. Expansion happens for pipes set
2216 up in filter files and with directly-supplied commands. It does not happen if
2217 the pipe comes from a traditional .forward file. A failing expansion is a big
2218 disaster if the command came from Exim's configuration; if it came from a user
2219 it is just a normal failure. The expand_failed value is used as the error value
2220 to cater for these two cases.
2221
2222 An argument consisting just of the text "$pipe_addresses" is treated specially.
2223 It is not passed to the general expansion function. Instead, it is replaced by
2224 a number of arguments, one for each address. This avoids problems with shell
2225 metacharacters and spaces in addresses.
2226
2227 If the parent of the top address has an original part of "system-filter", this
2228 pipe was set up by the system filter, and we can permit the expansion of
2229 $recipients. */
2230
2231 DEBUG(D_transport)
2232   {
2233   debug_printf("direct command:\n");
2234   for (int i = 0; argv[i]; i++)
2235     debug_printf("  argv[%d] = '%s'\n", i, string_printing(argv[i]));
2236   }
2237
2238 if (flags & TSUC_EXPAND_ARGS)
2239   {
2240   BOOL allow_dollar_recipients = (flags & TSUC_ALLOW_RECIPIENTS)
2241     || (addr && addr->parent && Ustrcmp(addr->parent->address, "system-filter") == 0);  /*XXX could we check this at caller? */
2242
2243   for (int i = 0; argv[i]; i++)
2244     {
2245     DEBUG(D_expand) debug_printf_indent("arg %d\n", i);
2246
2247     /* Handle special fudge for passing an address list */
2248
2249     if (addr &&
2250         (Ustrcmp(argv[i], "$pipe_addresses") == 0 ||
2251          Ustrcmp(argv[i], "${pipe_addresses}") == 0))
2252       {
2253       int additional;
2254
2255       if (argcount + address_count - 1 > max_args)
2256         {
2257         addr->transport_return = FAIL;
2258         addr->message = string_sprintf("Too many arguments to command \"%s\" "
2259           "in %s", cmd, etext);
2260         return FALSE;
2261         }
2262
2263       additional = address_count - 1;
2264       if (additional > 0)
2265         memmove(argv + i + 1 + additional, argv + i + 1,
2266           (argcount - i)*sizeof(uschar *));
2267
2268       for (address_item * ad = addr; ad; ad = ad->next)
2269         {
2270         /* $pipe_addresses is spefically not checked for taint, because there is
2271         a testcase (321) depending on it.  It's unclear if the exact thing being
2272         done really needs to be legitimate, though I suspect it reflects an
2273         actual use-case that showed up a bug.
2274         This is a hole in the taint-pretection, mitigated only in that
2275         shell-syntax metachars cannot be injected via this route. */
2276
2277         DEBUG(D_transport) if (is_tainted(ad->address))
2278           debug_printf("tainted element '%s' from $pipe_addresses\n", ad->address);
2279
2280         argv[i++] = ad->address;
2281         argcount++;
2282         }
2283
2284       /* Subtract one since we replace $pipe_addresses */
2285       argcount--;
2286       i--;
2287       }
2288
2289       /* Handle special case of $address_pipe when af_force_command is set */
2290
2291     else if (addr && testflag(addr,af_force_command) &&
2292         (Ustrcmp(argv[i], "$address_pipe") == 0 ||
2293          Ustrcmp(argv[i], "${address_pipe}") == 0))
2294       {
2295       int address_pipe_argcount = 0;
2296       int address_pipe_max_args;
2297       uschar **address_pipe_argv;
2298
2299       /* We can never have more then the argv we will be loading into */
2300       address_pipe_max_args = max_args - argcount + 1;
2301
2302       DEBUG(D_transport)
2303         debug_printf("address_pipe_max_args=%d\n", address_pipe_max_args);
2304
2305       /* We allocate an additional for (uschar *)0 */
2306       address_pipe_argv = store_get((address_pipe_max_args+1)*sizeof(uschar *), GET_UNTAINTED);
2307
2308       /* +1 because addr->local_part[0] == '|' since af_force_command is set */
2309       s = expand_cstring(addr->local_part + 1);
2310
2311       if (!s || !*s)
2312         {
2313         addr->transport_return = FAIL;
2314         addr->message = string_sprintf("Expansion of \"%s\" "
2315            "from command \"%s\" in %s failed: %s",
2316            (addr->local_part + 1), cmd, etext, expand_string_message);
2317         return FALSE;
2318         }
2319
2320       Uskip_whitespace(&s);                     /* strip leading space */
2321
2322       while (*s && address_pipe_argcount < address_pipe_max_args)
2323         {
2324         if (*s == '\'')
2325           {
2326           int n = Ustrcspn(++s, "'");
2327           argv[argcount] = string_copyn(s, n);
2328           if (*(s += n) == '\'') s++;
2329           }
2330         else
2331           address_pipe_argv[address_pipe_argcount++] = string_dequote(CUSS &s);
2332         Uskip_whitespace(&s);                   /* strip space after arg */
2333         }
2334
2335       address_pipe_argv[address_pipe_argcount] = NULL;
2336
2337       /* If *s != 0 we have run out of argument slots. */
2338       if (*s)
2339         {
2340         uschar *msg = string_sprintf("Too many arguments in $address_pipe "
2341           "\"%s\" in %s", addr->local_part + 1, etext);
2342         if (addr)
2343           {
2344           addr->transport_return = FAIL;
2345           addr->message = msg;
2346           }
2347         else *errptr = msg;
2348         return FALSE;
2349         }
2350
2351       /* address_pipe_argcount - 1
2352       because we are replacing $address_pipe in the argument list
2353       with the first thing it expands to */
2354
2355       if (argcount + address_pipe_argcount - 1 > max_args)
2356         {
2357         addr->transport_return = FAIL;
2358         addr->message = string_sprintf("Too many arguments to command "
2359           "\"%s\" after expanding $address_pipe in %s", cmd, etext);
2360         return FALSE;
2361         }
2362
2363       /* If we are not just able to replace the slot that contained
2364       $address_pipe (address_pipe_argcount == 1)
2365       We have to move the existing argv by address_pipe_argcount - 1
2366       Visually if address_pipe_argcount == 2:
2367       [argv 0][argv 1][argv 2($address_pipe)][argv 3][0]
2368       [argv 0][argv 1][ap_arg0][ap_arg1][old argv 3][0] */
2369
2370       if (address_pipe_argcount > 1)
2371         memmove(
2372           /* current position + additional args */
2373           argv + i + address_pipe_argcount,
2374           /* current position + 1 (for the (uschar *)0 at the end) */
2375           argv + i + 1,
2376           /* -1 for the (uschar *)0 at the end)*/
2377           (argcount - i)*sizeof(uschar *)
2378         );
2379
2380       /* Now we fill in the slots we just moved argv out of
2381       [argv 0][argv 1][argv 2=pipeargv[0]][argv 3=pipeargv[1]][old argv 3][0] */
2382
2383       for (int address_pipe_i = 0;
2384            address_pipe_argv[address_pipe_i];
2385            address_pipe_i++, argcount++)
2386         {
2387         uschar * s = address_pipe_argv[address_pipe_i];
2388         if (arg_is_tainted(s, i, addr, etext, errptr)) return FALSE;
2389         argv[i++] = s;
2390         }
2391
2392       /* Subtract one since we replace $address_pipe */
2393       argcount--;
2394       i--;
2395       }
2396
2397     /* Handle normal expansion string */
2398
2399     else
2400       {
2401       const uschar *expanded_arg;
2402       BOOL enable_dollar_recipients_g = f.enable_dollar_recipients;
2403       f.enable_dollar_recipients = allow_dollar_recipients;
2404       expanded_arg = expand_cstring(argv[i]);
2405       f.enable_dollar_recipients = enable_dollar_recipients_g;
2406
2407       if (!expanded_arg)
2408         {
2409         uschar *msg = string_sprintf("Expansion of \"%s\" "
2410           "from command \"%s\" in %s failed: %s",
2411           argv[i], cmd, etext, expand_string_message);
2412         if (addr)
2413           {
2414           addr->transport_return = expand_failed;
2415           addr->message = msg;
2416           }
2417         else *errptr = msg;
2418         return FALSE;
2419         }
2420
2421       if (  f.running_in_test_harness && is_tainted(expanded_arg)
2422          && Ustrcmp(etext, "queryprogram router") == 0)
2423         {                       /* hack, would be good to not need it */
2424         DEBUG(D_transport)
2425           debug_printf("SPECIFIC TESTSUITE EXEMPTION: tainted arg '%s'\n",
2426                       expanded_arg);
2427         }
2428       else if (  !(flags & TSUC_ALLOW_TAINTED_ARGS)
2429               && arg_is_tainted(expanded_arg, i, addr, etext, errptr))
2430         return FALSE;
2431       argv[i] = expanded_arg;
2432       }
2433     }
2434
2435   DEBUG(D_transport)
2436     {
2437     debug_printf("direct command after expansion:\n");
2438     for (int i = 0; argv[i]; i++)
2439       {
2440       debug_printf("  argv[%d] = '%s'\n", i, string_printing(argv[i]));
2441       debug_print_taint(argv[i]);
2442       }
2443     }
2444   }
2445
2446 return TRUE;
2447 }
2448
2449
2450
2451 /* For error messages, a string describing the config location associated
2452 with current processing.  NULL if we are not in a transport. */
2453 /* Name only, for now */
2454
2455 uschar *
2456 transport_current_name(void)
2457 {
2458 if (!transport_name) return NULL;
2459 return string_sprintf(" (transport %s, %s %d)", transport_name, driver_srcfile, driver_srcline);
2460 }
2461
2462 #endif  /*!MACRO_PREDEF*/
2463 /* vi: aw ai sw=2
2464 */
2465 /* End of transport.c */