Tidying: coverity issues
[exim.git] / src / src / transports / pipe.c
1 /*************************************************
2 * Exim - an Internet mail transport agent *
3 *************************************************/
4
5 /* Copyright (c) University of Cambridge 1995 - 2015 */
6 /* See the file NOTICE for conditions of use and distribution. */
7
8
9 #include "../exim.h"
10 #include "pipe.h"
11
12 #ifdef HAVE_SETCLASSRESOURCES
13 #include <login_cap.h>
14 #endif
15
16
17
18 /* Options specific to the pipe transport. They must be in alphabetic
19 order (note that "_" comes before the lower case letters). Those starting
20 with "*" are not settable by the user but are used by the option-reading
21 software for alternative value types. Some options are stored in the transport
22 instance block so as to be publicly visible; these are flagged with opt_public.
23 */
24
25 optionlist pipe_transport_options[] = {
26 { "allow_commands", opt_stringptr,
27 (void *)offsetof(pipe_transport_options_block, allow_commands) },
28 { "batch_id", opt_stringptr | opt_public,
29 (void *)offsetof(transport_instance, batch_id) },
30 { "batch_max", opt_int | opt_public,
31 (void *)offsetof(transport_instance, batch_max) },
32 { "check_string", opt_stringptr,
33 (void *)offsetof(pipe_transport_options_block, check_string) },
34 { "command", opt_stringptr,
35 (void *)offsetof(pipe_transport_options_block, cmd) },
36 { "environment", opt_stringptr,
37 (void *)offsetof(pipe_transport_options_block, environment) },
38 { "escape_string", opt_stringptr,
39 (void *)offsetof(pipe_transport_options_block, escape_string) },
40 { "force_command", opt_bool,
41 (void *)offsetof(pipe_transport_options_block, force_command) },
42 { "freeze_exec_fail", opt_bool,
43 (void *)offsetof(pipe_transport_options_block, freeze_exec_fail) },
44 { "freeze_signal", opt_bool,
45 (void *)offsetof(pipe_transport_options_block, freeze_signal) },
46 { "ignore_status", opt_bool,
47 (void *)offsetof(pipe_transport_options_block, ignore_status) },
48 { "log_defer_output", opt_bool | opt_public,
49 (void *)offsetof(transport_instance, log_defer_output) },
50 { "log_fail_output", opt_bool | opt_public,
51 (void *)offsetof(transport_instance, log_fail_output) },
52 { "log_output", opt_bool | opt_public,
53 (void *)offsetof(transport_instance, log_output) },
54 { "max_output", opt_mkint,
55 (void *)offsetof(pipe_transport_options_block, max_output) },
56 { "message_prefix", opt_stringptr,
57 (void *)offsetof(pipe_transport_options_block, message_prefix) },
58 { "message_suffix", opt_stringptr,
59 (void *)offsetof(pipe_transport_options_block, message_suffix) },
60 { "path", opt_stringptr,
61 (void *)offsetof(pipe_transport_options_block, path) },
62 { "permit_coredump", opt_bool,
63 (void *)offsetof(pipe_transport_options_block, permit_coredump) },
64 { "pipe_as_creator", opt_bool | opt_public,
65 (void *)offsetof(transport_instance, deliver_as_creator) },
66 { "restrict_to_path", opt_bool,
67 (void *)offsetof(pipe_transport_options_block, restrict_to_path) },
68 { "return_fail_output",opt_bool | opt_public,
69 (void *)offsetof(transport_instance, return_fail_output) },
70 { "return_output", opt_bool | opt_public,
71 (void *)offsetof(transport_instance, return_output) },
72 { "temp_errors", opt_stringptr,
73 (void *)offsetof(pipe_transport_options_block, temp_errors) },
74 { "timeout", opt_time,
75 (void *)offsetof(pipe_transport_options_block, timeout) },
76 { "timeout_defer", opt_bool,
77 (void *)offsetof(pipe_transport_options_block, timeout_defer) },
78 { "umask", opt_octint,
79 (void *)offsetof(pipe_transport_options_block, umask) },
80 { "use_bsmtp", opt_bool,
81 (void *)offsetof(pipe_transport_options_block, use_bsmtp) },
82 #ifdef HAVE_SETCLASSRESOURCES
83 { "use_classresources", opt_bool,
84 (void *)offsetof(pipe_transport_options_block, use_classresources) },
85 #endif
86 { "use_crlf", opt_bool,
87 (void *)offsetof(pipe_transport_options_block, use_crlf) },
88 { "use_shell", opt_bool,
89 (void *)offsetof(pipe_transport_options_block, use_shell) },
90 };
91
92 /* Size of the options list. An extern variable has to be used so that its
93 address can appear in the tables drtables.c. */
94
95 int pipe_transport_options_count =
96 sizeof(pipe_transport_options)/sizeof(optionlist);
97
98 /* Default private options block for the pipe transport. */
99
100 pipe_transport_options_block pipe_transport_option_defaults = {
101 NULL, /* cmd */
102 NULL, /* allow_commands */
103 NULL, /* environment */
104 US"/bin:/usr/bin", /* path */
105 NULL, /* message_prefix (reset in init if not bsmtp) */
106 NULL, /* message_suffix (ditto) */
107 US mac_expanded_string(EX_TEMPFAIL) ":" /* temp_errors */
108 mac_expanded_string(EX_CANTCREAT),
109 NULL, /* check_string */
110 NULL, /* escape_string */
111 022, /* umask */
112 20480, /* max_output */
113 60*60, /* timeout */
114 0, /* options */
115 FALSE, /* force_command */
116 FALSE, /* freeze_exec_fail */
117 FALSE, /* freeze_signal */
118 FALSE, /* ignore_status */
119 FALSE, /* permit_coredump */
120 FALSE, /* restrict_to_path */
121 FALSE, /* timeout_defer */
122 FALSE, /* use_shell */
123 FALSE, /* use_bsmtp */
124 FALSE, /* use_classresources */
125 FALSE /* use_crlf */
126 };
127
128
129
130 /*************************************************
131 * Setup entry point *
132 *************************************************/
133
134 /* Called for each delivery in the privileged state, just before the uid/gid
135 are changed and the main entry point is called. In a system that supports the
136 login_cap facilities, this function is used to set the class resource limits
137 for the user. It may also re-enable coredumps.
138
139 Arguments:
140 tblock points to the transport instance
141 addrlist addresses about to be delivered (not used)
142 dummy not used (doesn't pass back data)
143 uid the uid that will be set (not used)
144 gid the gid that will be set (not used)
145 errmsg where to put an error message
146
147 Returns: OK, FAIL, or DEFER
148 */
149
150 static int
151 pipe_transport_setup(transport_instance *tblock, address_item *addrlist,
152 transport_feedback *dummy, uid_t uid, gid_t gid, uschar **errmsg)
153 {
154 pipe_transport_options_block *ob =
155 (pipe_transport_options_block *)(tblock->options_block);
156
157 addrlist = addrlist; /* Keep compiler happy */
158 dummy = dummy;
159 uid = uid;
160 gid = gid;
161 errmsg = errmsg;
162 ob = ob;
163
164 #ifdef HAVE_SETCLASSRESOURCES
165 if (ob->use_classresources)
166 {
167 struct passwd *pw = getpwuid(uid);
168 if (pw != NULL)
169 {
170 login_cap_t *lc = login_getpwclass(pw);
171 if (lc != NULL)
172 {
173 setclassresources(lc);
174 login_close(lc);
175 }
176 }
177 }
178 #endif
179
180 #ifdef RLIMIT_CORE
181 if (ob->permit_coredump)
182 {
183 struct rlimit rl;
184 rl.rlim_cur = RLIM_INFINITY;
185 rl.rlim_max = RLIM_INFINITY;
186 if (setrlimit(RLIMIT_CORE, &rl) < 0)
187 {
188 #ifdef SETRLIMIT_NOT_SUPPORTED
189 if (errno != ENOSYS && errno != ENOTSUP)
190 #endif
191 log_write(0, LOG_MAIN,
192 "delivery setrlimit(RLIMIT_CORE, RLIM_INFINITY) failed: %s",
193 strerror(errno));
194 }
195 }
196 #endif
197
198 return OK;
199 }
200
201
202
203 /*************************************************
204 * Initialization entry point *
205 *************************************************/
206
207 /* Called for each instance, after its options have been read, to
208 enable consistency checks to be done, or anything else that needs
209 to be set up. */
210
211 void
212 pipe_transport_init(transport_instance *tblock)
213 {
214 pipe_transport_options_block *ob =
215 (pipe_transport_options_block *)(tblock->options_block);
216
217 /* Set up the setup entry point, to be called in the privileged state */
218
219 tblock->setup = pipe_transport_setup;
220
221 /* If pipe_as_creator is set, then uid/gid should not be set. */
222
223 if (tblock->deliver_as_creator && (tblock->uid_set || tblock->gid_set ||
224 tblock->expand_uid != NULL || tblock->expand_gid != NULL))
225 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
226 "both pipe_as_creator and an explicit uid/gid are set for the %s "
227 "transport", tblock->name);
228
229 /* If a fixed uid field is set, then a gid field must also be set. */
230
231 if (tblock->uid_set && !tblock->gid_set && tblock->expand_gid == NULL)
232 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
233 "user set without group for the %s transport", tblock->name);
234
235 /* Temp_errors must consist only of digits and colons, but there can be
236 spaces round the colons, so allow them too. */
237
238 if (ob->temp_errors != NULL && Ustrcmp(ob->temp_errors, "*") != 0)
239 {
240 size_t p = Ustrspn(ob->temp_errors, "0123456789: ");
241 if (ob->temp_errors[p] != 0)
242 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
243 "temp_errors must be a list of numbers or an asterisk for the %s "
244 "transport", tblock->name);
245 }
246
247 /* Only one of return_output/return_fail_output or log_output/log_fail_output
248 should be set. */
249
250 if (tblock->return_output && tblock->return_fail_output)
251 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
252 "both return_output and return_fail_output set for %s transport",
253 tblock->name);
254
255 if (tblock->log_output && tblock->log_fail_output)
256 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
257 "both log_output and log_fail_output set for the %s transport",
258 tblock->name);
259
260 /* If batch SMTP is set, force the check and escape strings, and arrange that
261 headers are also escaped. */
262
263 if (ob->use_bsmtp)
264 {
265 ob->check_string = US".";
266 ob->escape_string = US"..";
267 ob->options |= topt_escape_headers;
268 }
269
270 /* If not batch SMTP, and message_prefix or message_suffix are unset, insert
271 default values for them. */
272
273 else
274 {
275 if (ob->message_prefix == NULL) ob->message_prefix =
276 US"From ${if def:return_path{$return_path}{MAILER-DAEMON}} ${tod_bsdinbox}\n";
277 if (ob->message_suffix == NULL) ob->message_suffix = US"\n";
278 }
279
280 /* The restrict_to_path and use_shell options are incompatible */
281
282 if (ob->restrict_to_path && ob->use_shell)
283 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
284 "both restrict_to_path and use_shell set for %s transport",
285 tblock->name);
286
287 /* The allow_commands and use_shell options are incompatible */
288
289 if (ob->allow_commands && ob->use_shell)
290 log_write(0, LOG_PANIC_DIE|LOG_CONFIG,
291 "both allow_commands and use_shell set for %s transport",
292 tblock->name);
293
294 /* Set up the bitwise options for transport_write_message from the various
295 driver options. Only one of body_only and headers_only can be set. */
296
297 ob->options |=
298 (tblock->body_only? topt_no_headers : 0) |
299 (tblock->headers_only? topt_no_body : 0) |
300 (tblock->return_path_add? topt_add_return_path : 0) |
301 (tblock->delivery_date_add? topt_add_delivery_date : 0) |
302 (tblock->envelope_to_add? topt_add_envelope_to : 0) |
303 (ob->use_crlf? topt_use_crlf : 0);
304 }
305
306
307
308 /*************************************************
309 * Set up direct (non-shell) command *
310 *************************************************/
311
312 /* This function is called when a command line is to be parsed by the transport
313 and executed directly, without the use of /bin/sh.
314
315 Arguments:
316 argvptr pointer to anchor for argv vector
317 cmd points to the command string
318 expand_arguments true if expansion is to occur
319 expand_fail error if expansion fails
320 addr chain of addresses
321 tname the transport name
322 ob the transport options block
323
324 Returns: TRUE if all went well; otherwise an error will be
325 set in the first address and FALSE returned
326 */
327
328 static BOOL
329 set_up_direct_command(const uschar ***argvptr, uschar *cmd,
330 BOOL expand_arguments, int expand_fail, address_item *addr, uschar *tname,
331 pipe_transport_options_block *ob)
332 {
333 BOOL permitted = FALSE;
334 const uschar **argv;
335 uschar buffer[64];
336
337 /* Set up "transport <name>" to be put in any error messages, and then
338 call the common function for creating an argument list and expanding
339 the items if necessary. If it fails, this function fails (error information
340 is in the addresses). */
341
342 sprintf(CS buffer, "%.50s transport", tname);
343 if (!transport_set_up_command(argvptr, cmd, expand_arguments, expand_fail,
344 addr, buffer, NULL))
345 return FALSE;
346
347 /* Point to the set-up arguments. */
348
349 argv = *argvptr;
350
351 /* If allow_commands is set, see if the command is in the permitted list. */
352
353 if (ob->allow_commands != NULL)
354 {
355 int sep = 0;
356 const uschar *s;
357 uschar *p;
358 uschar buffer[256];
359
360 if (!(s = expand_string(ob->allow_commands)))
361 {
362 addr->transport_return = DEFER;
363 addr->message = string_sprintf("failed to expand string \"%s\" "
364 "for %s transport: %s", ob->allow_commands, tname, expand_string_message);
365 return FALSE;
366 }
367
368 while ((p = string_nextinlist(&s, &sep, buffer, sizeof(buffer))))
369 if (Ustrcmp(p, argv[0]) == 0) { permitted = TRUE; break; }
370 }
371
372 /* If permitted is TRUE it means the command was found in the allowed list, and
373 no further checks are done. If permitted = FALSE, it either means
374 allow_commands wasn't set, or that the command didn't match anything in the
375 list. In both cases, if restrict_to_path is set, we fail if the command
376 contains any slashes, but if restrict_to_path is not set, we must fail the
377 command only if allow_commands is set. */
378
379 if (!permitted)
380 {
381 if (ob->restrict_to_path)
382 {
383 if (Ustrchr(argv[0], '/') != NULL)
384 {
385 addr->transport_return = FAIL;
386 addr->message = string_sprintf("\"/\" found in \"%s\" (command for %s "
387 "transport) - failed for security reasons", cmd, tname);
388 return FALSE;
389 }
390 }
391
392 else if (ob->allow_commands != NULL)
393 {
394 addr->transport_return = FAIL;
395 addr->message = string_sprintf("\"%s\" command not permitted by %s "
396 "transport", argv[0], tname);
397 return FALSE;
398 }
399 }
400
401 /* If the command is not an absolute path, search the PATH directories
402 for it. */
403
404 if (argv[0][0] != '/')
405 {
406 int sep = 0;
407 uschar *p;
408 const uschar *listptr = ob->path;
409 uschar buffer[1024];
410
411 while ((p = string_nextinlist(&listptr, &sep, buffer, sizeof(buffer))) != NULL)
412 {
413 struct stat statbuf;
414 sprintf(CS big_buffer, "%.256s/%.256s", p, argv[0]);
415 if (Ustat(big_buffer, &statbuf) == 0)
416 {
417 argv[0] = string_copy(big_buffer);
418 break;
419 }
420 }
421 if (p == NULL)
422 {
423 addr->transport_return = FAIL;
424 addr->message = string_sprintf("\"%s\" command not found for %s transport",
425 argv[0], tname);
426 return FALSE;
427 }
428 }
429
430 return TRUE;
431 }
432
433
434 /*************************************************
435 * Set up shell command *
436 *************************************************/
437
438 /* This function is called when a command line is to be passed to /bin/sh
439 without parsing inside the transport.
440
441 Arguments:
442 argvptr pointer to anchor for argv vector
443 cmd points to the command string
444 expand_arguments true if expansion is to occur
445 expand_fail error if expansion fails
446 addr chain of addresses
447 tname the transport name
448
449 Returns: TRUE if all went well; otherwise an error will be
450 set in the first address and FALSE returned
451 */
452
453 static BOOL
454 set_up_shell_command(const uschar ***argvptr, uschar *cmd,
455 BOOL expand_arguments, int expand_fail, address_item *addr, uschar *tname)
456 {
457 const uschar **argv;
458
459 *argvptr = argv = store_get((4)*sizeof(uschar *));
460
461 argv[0] = US"/bin/sh";
462 argv[1] = US"-c";
463
464 /* We have to take special action to handle the special "variable" called
465 $pipe_addresses, which is not recognized by the normal expansion function. */
466
467 DEBUG(D_transport)
468 debug_printf("shell pipe command before expansion:\n %s\n", cmd);
469
470 if (expand_arguments)
471 {
472 uschar *s = cmd;
473 uschar *p = Ustrstr(cmd, "pipe_addresses");
474
475 if (p != NULL && (
476 (p > cmd && p[-1] == '$') ||
477 (p > cmd + 1 && p[-2] == '$' && p[-1] == '{' && p[14] == '}')))
478 {
479 address_item *ad;
480 uschar *q = p + 14;
481 int size = Ustrlen(cmd) + 64;
482 int offset;
483
484 if (p[-1] == '{') { q++; p--; }
485
486 s = store_get(size);
487 offset = p - cmd - 1;
488 Ustrncpy(s, cmd, offset);
489
490 for (ad = addr; ad != NULL; ad = ad->next)
491 {
492 /*XXX string_append_listele() ? */
493 if (ad != addr) s = string_catn(s, &size, &offset, US" ", 1);
494 s = string_cat(s, &size, &offset, ad->address);
495 }
496
497 s = string_cat(s, &size, &offset, q);
498 s[offset] = 0;
499 }
500
501 /* Allow $recipients in the expansion iff it comes from a system filter */
502
503 enable_dollar_recipients = addr != NULL &&
504 addr->parent != NULL &&
505 Ustrcmp(addr->parent->address, "system-filter") == 0;
506 argv[2] = expand_string(s);
507 enable_dollar_recipients = FALSE;
508
509 if (argv[2] == NULL)
510 {
511 addr->transport_return = search_find_defer? DEFER : expand_fail;
512 addr->message = string_sprintf("Expansion of command \"%s\" "
513 "in %s transport failed: %s",
514 cmd, tname, expand_string_message);
515 return FALSE;
516 }
517
518 DEBUG(D_transport)
519 debug_printf("shell pipe command after expansion:\n %s\n", argv[2]);
520 }
521 else argv[2] = cmd;
522
523 argv[3] = (uschar *)0;
524 return TRUE;
525 }
526
527
528
529
530 /*************************************************
531 * Main entry point *
532 *************************************************/
533
534 /* See local README for interface details. This transport always returns FALSE,
535 indicating that the status in the first address is the status for all addresses
536 in a batch. */
537
538 BOOL
539 pipe_transport_entry(
540 transport_instance *tblock, /* data for this instantiation */
541 address_item *addr) /* address(es) we are working on */
542 {
543 pid_t pid, outpid;
544 int fd_in, fd_out, rc;
545 int envcount = 0;
546 int envsep = 0;
547 int expand_fail;
548 pipe_transport_options_block *ob =
549 (pipe_transport_options_block *)(tblock->options_block);
550 int timeout = ob->timeout;
551 BOOL written_ok = FALSE;
552 BOOL expand_arguments;
553 const uschar **argv;
554 uschar *envp[50];
555 const uschar *envlist = ob->environment;
556 uschar *cmd, *ss;
557 uschar *eol = (ob->use_crlf)? US"\r\n" : US"\n";
558
559 DEBUG(D_transport) debug_printf("%s transport entered\n", tblock->name);
560
561 /* Set up for the good case */
562
563 addr->transport_return = OK;
564 addr->basic_errno = 0;
565
566 /* Pipes are not accepted as general addresses, but they can be generated from
567 .forward files or alias files. In those cases, the pfr flag is set, and the
568 command to be obeyed is pointed to by addr->local_part; it starts with the pipe
569 symbol. In other cases, the command is supplied as one of the pipe transport's
570 options. */
571
572 if (testflag(addr, af_pfr) && addr->local_part[0] == '|')
573 {
574 if (ob->force_command)
575 {
576 /* Enables expansion of $address_pipe into seperate arguments */
577 setflag(addr, af_force_command);
578 cmd = ob->cmd;
579 expand_arguments = TRUE;
580 expand_fail = PANIC;
581 }
582 else
583 {
584 cmd = addr->local_part + 1;
585 while (isspace(*cmd)) cmd++;
586 expand_arguments = testflag(addr, af_expand_pipe);
587 expand_fail = FAIL;
588 }
589 }
590 else
591 {
592 cmd = ob->cmd;
593 expand_arguments = TRUE;
594 expand_fail = PANIC;
595 }
596
597 /* If no command has been supplied, we are in trouble.
598 * We also check for an empty string since it may be
599 * coming from addr->local_part[0] == '|'
600 */
601
602 if (cmd == NULL || *cmd == '\0')
603 {
604 addr->transport_return = DEFER;
605 addr->message = string_sprintf("no command specified for %s transport",
606 tblock->name);
607 return FALSE;
608 }
609
610 /* When a pipe is set up by a filter file, there may be values for $thisaddress
611 and numerical the variables in existence. These are passed in
612 addr->pipe_expandn for use here. */
613
614 if (expand_arguments && addr->pipe_expandn != NULL)
615 {
616 uschar **ss = addr->pipe_expandn;
617 expand_nmax = -1;
618 if (*ss != NULL) filter_thisaddress = *ss++;
619 while (*ss != NULL)
620 {
621 expand_nstring[++expand_nmax] = *ss;
622 expand_nlength[expand_nmax] = Ustrlen(*ss++);
623 }
624 }
625
626 /* The default way of processing the command is to split it up into arguments
627 here, and run it directly. This offers some security advantages. However, there
628 are installations that want by default to run commands under /bin/sh always, so
629 there is an option to do that. */
630
631 if (ob->use_shell)
632 {
633 if (!set_up_shell_command(&argv, cmd, expand_arguments, expand_fail, addr,
634 tblock->name)) return FALSE;
635 }
636 else if (!set_up_direct_command(&argv, cmd, expand_arguments, expand_fail, addr,
637 tblock->name, ob)) return FALSE;
638
639 expand_nmax = -1; /* Reset */
640 filter_thisaddress = NULL;
641
642 /* Set up the environment for the command. */
643
644 envp[envcount++] = string_sprintf("LOCAL_PART=%s", deliver_localpart);
645 envp[envcount++] = string_sprintf("LOGNAME=%s", deliver_localpart);
646 envp[envcount++] = string_sprintf("USER=%s", deliver_localpart);
647 envp[envcount++] = string_sprintf("LOCAL_PART_PREFIX=%#s",
648 deliver_localpart_prefix);
649 envp[envcount++] = string_sprintf("LOCAL_PART_SUFFIX=%#s",
650 deliver_localpart_suffix);
651 envp[envcount++] = string_sprintf("DOMAIN=%s", deliver_domain);
652 envp[envcount++] = string_sprintf("HOME=%#s", deliver_home);
653 envp[envcount++] = string_sprintf("MESSAGE_ID=%s", message_id);
654 envp[envcount++] = string_sprintf("PATH=%s", ob->path);
655 envp[envcount++] = string_sprintf("RECIPIENT=%#s%#s%#s@%#s",
656 deliver_localpart_prefix, deliver_localpart, deliver_localpart_suffix,
657 deliver_domain);
658 envp[envcount++] = string_sprintf("QUALIFY_DOMAIN=%s", qualify_domain_sender);
659 envp[envcount++] = string_sprintf("SENDER=%s", sender_address);
660 envp[envcount++] = US"SHELL=/bin/sh";
661
662 if (addr->host_list != NULL)
663 envp[envcount++] = string_sprintf("HOST=%s", addr->host_list->name);
664
665 if (timestamps_utc) envp[envcount++] = US"TZ=UTC";
666 else if (timezone_string != NULL && timezone_string[0] != 0)
667 envp[envcount++] = string_sprintf("TZ=%s", timezone_string);
668
669 /* Add any requested items */
670
671 if (envlist)
672 {
673 envlist = expand_cstring(envlist);
674 if (envlist == NULL)
675 {
676 addr->transport_return = DEFER;
677 addr->message = string_sprintf("failed to expand string \"%s\" "
678 "for %s transport: %s", ob->environment, tblock->name,
679 expand_string_message);
680 return FALSE;
681 }
682 }
683
684 while ((ss = string_nextinlist(&envlist, &envsep, big_buffer, big_buffer_size))
685 != NULL)
686 {
687 if (envcount > sizeof(envp)/sizeof(uschar *) - 2)
688 {
689 addr->transport_return = DEFER;
690 addr->message = string_sprintf("too many environment settings for "
691 "%s transport", tblock->name);
692 return FALSE;
693 }
694 envp[envcount++] = string_copy(ss);
695 }
696
697 envp[envcount] = NULL;
698
699 /* If the -N option is set, can't do any more. */
700
701 if (dont_deliver)
702 {
703 DEBUG(D_transport)
704 debug_printf("*** delivery by %s transport bypassed by -N option",
705 tblock->name);
706 return FALSE;
707 }
708
709
710 /* Handling the output from the pipe is tricky. If a file for catching this
711 output is provided, we could in theory just hand that fd over to the process,
712 but this isn't very safe because it might loop and carry on writing for
713 ever (which is exactly what happened in early versions of Exim). Therefore we
714 use the standard child_open() function, which creates pipes. We can then read
715 our end of the output pipe and count the number of bytes that come through,
716 chopping the sub-process if it exceeds some limit.
717
718 However, this means we want to run a sub-process with both its input and output
719 attached to pipes. We can't handle that easily from a single parent process
720 using straightforward code such as the transport_write_message() function
721 because the subprocess might not be reading its input because it is trying to
722 write to a full output pipe. The complication of redesigning the world to
723 handle this is too great - simpler just to run another process to do the
724 reading of the output pipe. */
725
726
727 /* As this is a local transport, we are already running with the required
728 uid/gid and current directory. Request that the new process be a process group
729 leader, so we can kill it and all its children on a timeout. */
730
731 if ((pid = child_open(USS argv, envp, ob->umask, &fd_in, &fd_out, TRUE)) < 0)
732 {
733 addr->transport_return = DEFER;
734 addr->message = string_sprintf(
735 "Failed to create child process for %s transport: %s", tblock->name,
736 strerror(errno));
737 return FALSE;
738 }
739
740 /* Now fork a process to handle the output that comes down the pipe. */
741
742 if ((outpid = fork()) < 0)
743 {
744 addr->basic_errno = errno;
745 addr->transport_return = DEFER;
746 addr->message = string_sprintf(
747 "Failed to create process for handling output in %s transport",
748 tblock->name);
749 (void)close(fd_in);
750 (void)close(fd_out);
751 return FALSE;
752 }
753
754 /* This is the code for the output-handling subprocess. Read from the pipe
755 in chunks, and write to the return file if one is provided. Keep track of
756 the number of bytes handled. If the limit is exceeded, try to kill the
757 subprocess group, and in any case close the pipe and exit, which should cause
758 the subprocess to fail. */
759
760 if (outpid == 0)
761 {
762 int count = 0;
763 (void)close(fd_in);
764 set_process_info("reading output from |%s", cmd);
765 while ((rc = read(fd_out, big_buffer, big_buffer_size)) > 0)
766 {
767 if (addr->return_file >= 0)
768 if(write(addr->return_file, big_buffer, rc) != rc)
769 DEBUG(D_transport) debug_printf("Problem writing to return_file\n");
770 count += rc;
771 if (count > ob->max_output)
772 {
773 DEBUG(D_transport) debug_printf("Too much output from pipe - killed\n");
774 if (addr->return_file >= 0)
775 {
776 uschar *message = US"\n\n*** Too much output - remainder discarded ***\n";
777 rc = Ustrlen(message);
778 if(write(addr->return_file, message, rc) != rc)
779 DEBUG(D_transport) debug_printf("Problem writing to return_file\n");
780 }
781 killpg(pid, SIGKILL);
782 break;
783 }
784 }
785 (void)close(fd_out);
786 _exit(0);
787 }
788
789 (void)close(fd_out); /* Not used in this process */
790
791
792 /* Carrying on now with the main parent process. Attempt to write the message
793 to it down the pipe. It is a fallacy to think that you can detect write errors
794 when the sub-process fails to read the pipe. The parent process may complete
795 writing and close the pipe before the sub-process completes. We could sleep a
796 bit here to let the sub-process get going, but it may still not complete. So we
797 ignore all writing errors. (When in the test harness, we do do a short sleep so
798 any debugging output is likely to be in the same order.) */
799
800 if (running_in_test_harness) millisleep(500);
801
802 DEBUG(D_transport) debug_printf("Writing message to pipe\n");
803
804 /* Arrange to time out writes if there is a timeout set. */
805
806 if (timeout > 0)
807 {
808 sigalrm_seen = FALSE;
809 transport_write_timeout = timeout;
810 }
811
812 /* Reset the counter of bytes written */
813
814 transport_count = 0;
815
816 /* First write any configured prefix information */
817
818 if (ob->message_prefix != NULL)
819 {
820 uschar *prefix = expand_string(ob->message_prefix);
821 if (prefix == NULL)
822 {
823 addr->transport_return = search_find_defer? DEFER : PANIC;
824 addr->message = string_sprintf("Expansion of \"%s\" (prefix for %s "
825 "transport) failed: %s", ob->message_prefix, tblock->name,
826 expand_string_message);
827 return FALSE;
828 }
829 if (!transport_write_block(fd_in, prefix, Ustrlen(prefix)))
830 goto END_WRITE;
831 }
832
833 /* If the use_bsmtp option is set, we need to write SMTP prefix information.
834 The various different values for batching are handled outside; if there is more
835 than one address available here, all must be included. Force SMTP dot-handling.
836 */
837
838 if (ob->use_bsmtp)
839 {
840 address_item *a;
841
842 if (!transport_write_string(fd_in, "MAIL FROM:<%s>%s", return_path, eol))
843 goto END_WRITE;
844
845 for (a = addr; a != NULL; a = a->next)
846 {
847 if (!transport_write_string(fd_in,
848 "RCPT TO:<%s>%s",
849 transport_rcpt_address(a, tblock->rcpt_include_affixes),
850 eol))
851 goto END_WRITE;
852 }
853
854 if (!transport_write_string(fd_in, "DATA%s", eol)) goto END_WRITE;
855 }
856
857 /* Now the actual message - the options were set at initialization time */
858
859 if (!transport_write_message(addr, fd_in, ob->options, 0, tblock->add_headers,
860 tblock->remove_headers, ob->check_string, ob->escape_string,
861 tblock->rewrite_rules, tblock->rewrite_existflags))
862 goto END_WRITE;
863
864 /* Now any configured suffix */
865
866 if (ob->message_suffix != NULL)
867 {
868 uschar *suffix = expand_string(ob->message_suffix);
869 if (suffix == NULL)
870 {
871 addr->transport_return = search_find_defer? DEFER : PANIC;
872 addr->message = string_sprintf("Expansion of \"%s\" (suffix for %s "
873 "transport) failed: %s", ob->message_suffix, tblock->name,
874 expand_string_message);
875 return FALSE;
876 }
877 if (!transport_write_block(fd_in, suffix, Ustrlen(suffix)))
878 goto END_WRITE;
879 }
880
881 /* If local_smtp, write the terminating dot. */
882
883 if (ob->use_bsmtp && !transport_write_string(fd_in, ".%s", eol))
884 goto END_WRITE;
885
886 /* Flag all writing completed successfully. */
887
888 written_ok = TRUE;
889
890 /* Come here if there are errors during writing. */
891
892 END_WRITE:
893
894 /* OK, the writing is now all done. Close the pipe. */
895
896 (void) close(fd_in);
897
898 /* Handle errors during writing. For timeouts, set the timeout for waiting for
899 the child process to 1 second. If the process at the far end of the pipe died
900 without reading all of it, we expect an EPIPE error, which should be ignored.
901 We used also to ignore WRITEINCOMPLETE but the writing function is now cleverer
902 at handling OS where the death of a pipe doesn't give EPIPE immediately. See
903 comments therein. */
904
905 if (!written_ok)
906 {
907 if (errno == ETIMEDOUT)
908 {
909 addr->message = string_sprintf("%stimeout while writing to pipe",
910 transport_filter_timed_out? "transport filter " : "");
911 addr->transport_return = ob->timeout_defer? DEFER : FAIL;
912 timeout = 1;
913 }
914 else if (errno == EPIPE)
915 {
916 debug_printf("transport error EPIPE ignored\n");
917 }
918 else
919 {
920 addr->transport_return = PANIC;
921 addr->basic_errno = errno;
922 if (errno == ERRNO_CHHEADER_FAIL)
923 addr->message =
924 string_sprintf("Failed to expand headers_add or headers_remove: %s",
925 expand_string_message);
926 else if (errno == ERRNO_FILTER_FAIL)
927 addr->message = string_sprintf("Transport filter process failed (%d)%s",
928 addr->more_errno,
929 (addr->more_errno == EX_EXECFAILED)? ": unable to execute command" : "");
930 else if (errno == ERRNO_WRITEINCOMPLETE)
931 addr->message = string_sprintf("Failed repeatedly to write data");
932 else
933 addr->message = string_sprintf("Error %d", errno);
934 return FALSE;
935 }
936 }
937
938 /* Wait for the child process to complete and take action if the returned
939 status is nonzero. The timeout will be just 1 second if any of the writes
940 above timed out. */
941
942 if ((rc = child_close(pid, timeout)) != 0)
943 {
944 uschar *tmsg = (addr->message == NULL)? US"" :
945 string_sprintf(" (preceded by %s)", addr->message);
946
947 /* The process did not complete in time; kill its process group and fail
948 the delivery. It appears to be necessary to kill the output process too, as
949 otherwise it hangs on for some time if the actual pipe process is sleeping.
950 (At least, that's what I observed on Solaris 2.5.1.) Since we are failing
951 the delivery, that shouldn't cause any problem. */
952
953 if (rc == -256)
954 {
955 killpg(pid, SIGKILL);
956 kill(outpid, SIGKILL);
957 addr->transport_return = ob->timeout_defer? DEFER : FAIL;
958 addr->message = string_sprintf("pipe delivery process timed out%s", tmsg);
959 }
960
961 /* Wait() failed. */
962
963 else if (rc == -257)
964 {
965 addr->transport_return = PANIC;
966 addr->message = string_sprintf("Wait() failed for child process of %s "
967 "transport: %s%s", tblock->name, strerror(errno), tmsg);
968 }
969
970 /* Since the transport_filter timed out we assume it has sent the child process
971 a malformed or incomplete data stream. Kill off the child process
972 and prevent checking its exit status as it will has probably exited in error.
973 This prevents the transport_filter timeout message from getting overwritten
974 by the exit error which is not the cause of the problem. */
975
976 else if (transport_filter_timed_out)
977 {
978 killpg(pid, SIGKILL);
979 kill(outpid, SIGKILL);
980 }
981
982 /* Either the process completed, but yielded a non-zero (necessarily
983 positive) status, or the process was terminated by a signal (rc will contain
984 the negation of the signal number). Treat killing by signal as failure unless
985 status is being ignored. By default, the message is bounced back, unless
986 freeze_signal is set, in which case it is frozen instead. */
987
988 else if (rc < 0)
989 {
990 if (ob->freeze_signal)
991 {
992 addr->transport_return = DEFER;
993 addr->special_action = SPECIAL_FREEZE;
994 addr->message = string_sprintf("Child process of %s transport (running "
995 "command \"%s\") was terminated by signal %d (%s)%s", tblock->name, cmd,
996 -rc, os_strsignal(-rc), tmsg);
997 }
998 else if (!ob->ignore_status)
999 {
1000 addr->transport_return = FAIL;
1001 addr->message = string_sprintf("Child process of %s transport (running "
1002 "command \"%s\") was terminated by signal %d (%s)%s", tblock->name, cmd,
1003 -rc, os_strsignal(-rc), tmsg);
1004 }
1005 }
1006
1007 /* For positive values (process terminated with non-zero status), we need a
1008 status code to request deferral. A number of systems contain the following
1009 line in sysexits.h:
1010
1011 #define EX_TEMPFAIL 75
1012
1013 with the description
1014
1015 EX_TEMPFAIL -- temporary failure, indicating something that
1016 is not really an error. In sendmail, this means
1017 that a mailer (e.g.) could not create a connection,
1018 and the request should be reattempted later.
1019
1020 Based on this, we use exit code EX_TEMPFAIL as a default to mean "defer" when
1021 not ignoring the returned status. However, there is now an option that
1022 contains a list of temporary codes, with TEMPFAIL and CANTCREAT as defaults.
1023
1024 Another case that needs special treatment is if execve() failed (typically
1025 the command that was given is a non-existent path). By default this is
1026 treated as just another failure, but if freeze_exec_fail is set, the reaction
1027 is to freeze the message rather than bounce the address. Exim used to signal
1028 this failure with EX_UNAVAILABLE, which is definined in many systems as
1029
1030 #define EX_UNAVAILABLE 69
1031
1032 with the description
1033
1034 EX_UNAVAILABLE -- A service is unavailable. This can occur
1035 if a support program or file does not exist. This
1036 can also be used as a catchall message when something
1037 you wanted to do doesn't work, but you don't know why.
1038
1039 However, this can be confused with a command that actually returns 69 because
1040 something *it* wanted is unavailable. At release 4.21, Exim was changed to
1041 use return code 127 instead, because this is what the shell returns when it
1042 is unable to exec a command. We define it as EX_EXECFAILED, and use it in
1043 child.c to signal execve() failure and other unexpected failures such as
1044 setuid() not working - though that won't be the case here because we aren't
1045 changing uid. */
1046
1047 else
1048 {
1049 /* Always handle execve() failure specially if requested to */
1050
1051 if (ob->freeze_exec_fail && (rc == EX_EXECFAILED))
1052 {
1053 addr->transport_return = DEFER;
1054 addr->special_action = SPECIAL_FREEZE;
1055 addr->message = string_sprintf("pipe process failed to exec \"%s\"%s",
1056 cmd, tmsg);
1057 }
1058
1059 /* Otherwise take action only if not ignoring status */
1060
1061 else if (!ob->ignore_status)
1062 {
1063 uschar *ss;
1064 int size, ptr, i;
1065
1066 /* If temp_errors is "*" all codes are temporary. Initializion checks
1067 that it's either "*" or a list of numbers. If not "*", scan the list of
1068 temporary failure codes; if any match, the result is DEFER. */
1069
1070 if (ob->temp_errors[0] == '*')
1071 addr->transport_return = DEFER;
1072
1073 else
1074 {
1075 const uschar *s = ob->temp_errors;
1076 uschar *p;
1077 uschar buffer[64];
1078 int sep = 0;
1079
1080 addr->transport_return = FAIL;
1081 while ((p = string_nextinlist(&s,&sep,buffer,sizeof(buffer))))
1082 if (rc == Uatoi(p)) { addr->transport_return = DEFER; break; }
1083 }
1084
1085 /* Ensure the message contains the expanded command and arguments. This
1086 doesn't have to be brilliantly efficient - it is an error situation. */
1087
1088 addr->message = string_sprintf("Child process of %s transport returned "
1089 "%d", tblock->name, rc);
1090
1091 ptr = Ustrlen(addr->message);
1092 size = ptr + 1;
1093
1094 /* If the return code is > 128, it often means that a shell command
1095 was terminated by a signal. */
1096
1097 ss = (rc > 128)?
1098 string_sprintf("(could mean shell command ended by signal %d (%s))",
1099 rc-128, os_strsignal(rc-128)) :
1100 US os_strexit(rc);
1101
1102 if (*ss != 0)
1103 {
1104 addr->message = string_catn(addr->message, &size, &ptr, US" ", 1);
1105 addr->message = string_cat (addr->message, &size, &ptr, ss);
1106 }
1107
1108 /* Now add the command and arguments */
1109
1110 addr->message = string_catn(addr->message, &size, &ptr,
1111 US" from command:", 14);
1112
1113 for (i = 0; i < sizeof(argv)/sizeof(int *) && argv[i] != NULL; i++)
1114 {
1115 BOOL quote = FALSE;
1116 addr->message = string_catn(addr->message, &size, &ptr, US" ", 1);
1117 if (Ustrpbrk(argv[i], " \t") != NULL)
1118 {
1119 quote = TRUE;
1120 addr->message = string_catn(addr->message, &size, &ptr, US"\"", 1);
1121 }
1122 addr->message = string_cat(addr->message, &size, &ptr, argv[i]);
1123 if (quote)
1124 addr->message = string_catn(addr->message, &size, &ptr, US"\"", 1);
1125 }
1126
1127 /* Add previous filter timeout message, if present. */
1128
1129 if (*tmsg)
1130 addr->message = string_cat(addr->message, &size, &ptr, tmsg);
1131
1132 addr->message[ptr] = 0; /* Ensure concatenated string terminated */
1133 }
1134 }
1135 }
1136
1137 /* Ensure all subprocesses (in particular, the output handling process)
1138 are complete before we pass this point. */
1139
1140 while (wait(&rc) >= 0);
1141
1142 DEBUG(D_transport) debug_printf("%s transport yielded %d\n", tblock->name,
1143 addr->transport_return);
1144
1145 /* If there has been a problem, the message in addr->message contains details
1146 of the pipe command. We don't want to expose these to the world, so we set up
1147 something bland to return to the sender. */
1148
1149 if (addr->transport_return != OK)
1150 addr->user_message = US"local delivery failed";
1151
1152 return FALSE;
1153 }
1154
1155 /* End of transport/pipe.c */