1 /* $Cambridge: exim/src/src/exim.c,v 1.9.2.2 2004/12/02 16:33:30 tom Exp $ */
3 /*************************************************
4 * Exim - an Internet mail transport agent *
5 *************************************************/
7 /* Copyright (c) University of Cambridge 1995 - 2004 */
8 /* See the file NOTICE for conditions of use and distribution. */
11 /* The main function: entry point, initialization, and high-level control.
12 Also a few functions that don't naturally fit elsewhere. */
19 /*************************************************
20 * Function interface to store functions *
21 *************************************************/
23 /* We need some real functions to pass to the PCRE regular expression library
24 for store allocation via Exim's store manager. The normal calls are actually
25 macros that pass over location information to make tracing easier. These
26 functions just interface to the standard macro calls. A good compiler will
27 optimize out the tail recursion and so not make them too expensive. There
28 are two sets of functions; one for use when we want to retain the compiled
29 regular expression for a long time; the other for short-term use. */
32 function_store_get(size_t size)
34 return store_get((int)size);
38 function_dummy_free(void *block) { block = block; }
41 function_store_malloc(size_t size)
43 return store_malloc((int)size);
47 function_store_free(void *block)
55 /*************************************************
56 * Compile regular expression and panic on fail *
57 *************************************************/
59 /* This function is called when failure to compile a regular expression leads
60 to a panic exit. In other cases, pcre_compile() is called directly. In many
61 cases where this function is used, the results of the compilation are to be
62 placed in long-lived store, so we temporarily reset the store management
63 functions that PCRE uses if the use_malloc flag is set.
66 pattern the pattern to compile
67 caseless TRUE if caseless matching is required
68 use_malloc TRUE if compile into malloc store
70 Returns: pointer to the compiled pattern
74 regex_must_compile(uschar *pattern, BOOL caseless, BOOL use_malloc)
77 int options = PCRE_COPT;
82 pcre_malloc = function_store_malloc;
83 pcre_free = function_store_free;
85 if (caseless) options |= PCRE_CASELESS;
86 yield = pcre_compile(CS pattern, options, (const char **)&error, &offset, NULL);
87 pcre_malloc = function_store_get;
88 pcre_free = function_dummy_free;
90 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "regular expression error: "
91 "%s at offset %d while compiling %s", error, offset, pattern);
98 /*************************************************
99 * Execute regular expression and set strings *
100 *************************************************/
102 /* This function runs a regular expression match, and sets up the pointers to
103 the matched substrings.
106 re the compiled expression
107 subject the subject string
108 options additional PCRE options
109 setup if < 0 do full setup
110 if >= 0 setup from setup+1 onwards,
111 excluding the full matched string
113 Returns: TRUE or FALSE
117 regex_match_and_setup(const pcre *re, uschar *subject, int options, int setup)
119 int ovector[3*(EXPAND_MAXN+1)];
120 int n = pcre_exec(re, NULL, CS subject, Ustrlen(subject), 0,
121 PCRE_EOPT | options, ovector, sizeof(ovector)/sizeof(int));
123 if (n == 0) n = EXPAND_MAXN + 1;
127 expand_nmax = (setup < 0)? 0 : setup + 1;
128 for (nn = (setup < 0)? 0 : 2; nn < n*2; nn += 2)
130 expand_nstring[expand_nmax] = subject + ovector[nn];
131 expand_nlength[expand_nmax++] = ovector[nn+1] - ovector[nn];
141 /*************************************************
142 * Handler for SIGUSR1 *
143 *************************************************/
145 /* SIGUSR1 causes any exim process to write to the process log details of
146 what it is currently doing. It will only be used if the OS is capable of
147 setting up a handler that causes automatic restarting of any system call
148 that is in progress at the time.
150 Argument: the signal number (SIGUSR1)
155 usr1_handler(int sig)
157 sig = sig; /* Keep picky compilers happy */
158 log_write(0, LOG_PROCESS, "%s", process_info);
160 os_restarting_signal(SIGUSR1, usr1_handler);
165 /*************************************************
167 *************************************************/
169 /* This handler is enabled most of the time that Exim is running. The handler
170 doesn't actually get used unless alarm() has been called to set a timer, to
171 place a time limit on a system call of some kind. When the handler is run, it
174 There are some other SIGALRM handlers that are used in special cases when more
175 than just a flag setting is required; for example, when reading a message's
176 input. These are normally set up in the code module that uses them, and the
177 SIGALRM handler is reset to this one afterwards.
179 Argument: the signal value (SIGALRM)
184 sigalrm_handler(int sig)
186 sig = sig; /* Keep picky compilers happy */
188 os_non_restarting_signal(SIGALRM, sigalrm_handler);
193 /*************************************************
194 * Sleep for a fractional time interval *
195 *************************************************/
197 /* This function is called by millisleep() and exim_wait_tick() to wait for a
198 period of time that may include a fraction of a second. The coding is somewhat
199 tedious. We do not expect setitimer() ever to fail, but if it does, the process
200 will wait for ever, so we panic in this instance. (There was a case of this
201 when a bug in a function that calls milliwait() caused it to pass invalid data.
202 That's when I added the check. :-)
204 Argument: an itimerval structure containing the interval
209 milliwait(struct itimerval *itval)
212 sigset_t old_sigmask;
213 (void)sigemptyset(&sigmask); /* Empty mask */
214 (void)sigaddset(&sigmask, SIGALRM); /* Add SIGALRM */
215 (void)sigprocmask(SIG_BLOCK, &sigmask, &old_sigmask); /* Block SIGALRM */
216 if (setitimer(ITIMER_REAL, itval, NULL) < 0) /* Start timer */
217 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
218 "setitimer() failed: %s", strerror(errno));
219 (void)sigfillset(&sigmask); /* All signals */
220 (void)sigdelset(&sigmask, SIGALRM); /* Remove SIGALRM */
221 (void)sigsuspend(&sigmask); /* Until SIGALRM */
222 (void)sigprocmask(SIG_SETMASK, &old_sigmask, NULL); /* Restore mask */
228 /*************************************************
229 * Millisecond sleep function *
230 *************************************************/
232 /* The basic sleep() function has a granularity of 1 second, which is too rough
233 in some cases - for example, when using an increasing delay to slow down
236 Argument: number of millseconds
243 struct itimerval itval;
244 itval.it_interval.tv_sec = 0;
245 itval.it_interval.tv_usec = 0;
246 itval.it_value.tv_sec = msec/1000;
247 itval.it_value.tv_usec = (msec % 1000) * 1000;
253 /*************************************************
254 * Compare microsecond times *
255 *************************************************/
262 Returns: -1, 0, or +1
266 exim_tvcmp(struct timeval *t1, struct timeval *t2)
268 if (t1->tv_sec > t2->tv_sec) return +1;
269 if (t1->tv_sec < t2->tv_sec) return -1;
270 if (t1->tv_usec > t2->tv_usec) return +1;
271 if (t1->tv_usec < t2->tv_usec) return -1;
278 /*************************************************
279 * Clock tick wait function *
280 *************************************************/
282 /* Exim uses a time + a pid to generate a unique identifier in two places: its
283 message IDs, and in file names for maildir deliveries. Because some OS now
284 re-use pids within the same second, sub-second times are now being used.
285 However, for absolute certaintly, we must ensure the clock has ticked before
286 allowing the relevant process to complete. At the time of implementation of
287 this code (February 2003), the speed of processors is such that the clock will
288 invariably have ticked already by the time a process has done its job. This
289 function prepares for the time when things are faster - and it also copes with
290 clocks that go backwards.
293 then_tv A timeval which was used to create uniqueness; its usec field
294 has been rounded down to the value of the resolution.
295 We want to be sure the current time is greater than this.
296 resolution The resolution that was used to divide the microseconds
297 (1 for maildir, larger for message ids)
303 exim_wait_tick(struct timeval *then_tv, int resolution)
305 struct timeval now_tv;
306 long int now_true_usec;
308 (void)gettimeofday(&now_tv, NULL);
309 now_true_usec = now_tv.tv_usec;
310 now_tv.tv_usec = (now_true_usec/resolution) * resolution;
312 if (exim_tvcmp(&now_tv, then_tv) <= 0)
314 struct itimerval itval;
315 itval.it_interval.tv_sec = 0;
316 itval.it_interval.tv_usec = 0;
317 itval.it_value.tv_sec = then_tv->tv_sec - now_tv.tv_sec;
318 itval.it_value.tv_usec = then_tv->tv_usec + resolution - now_true_usec;
320 /* We know that, overall, "now" is less than or equal to "then". Therefore, a
321 negative value for the microseconds is possible only in the case when "now"
322 is more than a second less than "then". That means that itval.it_value.tv_sec
323 is greater than zero. The following correction is therefore safe. */
325 if (itval.it_value.tv_usec < 0)
327 itval.it_value.tv_usec += 1000000;
328 itval.it_value.tv_sec -= 1;
331 DEBUG(D_transport|D_receive)
333 if (!running_in_test_harness)
335 debug_printf("tick check: %lu.%06lu %lu.%06lu\n",
336 then_tv->tv_sec, then_tv->tv_usec, now_tv.tv_sec, now_tv.tv_usec);
337 debug_printf("waiting %lu.%06lu\n", itval.it_value.tv_sec,
338 itval.it_value.tv_usec);
349 /*************************************************
350 * Set up processing details *
351 *************************************************/
353 /* Save a text string for dumping when SIGUSR1 is received.
354 Do checks for overruns.
356 Arguments: format and arguments, as for printf()
361 set_process_info(char *format, ...)
365 sprintf(CS process_info, "%5d ", (int)getpid());
366 len = Ustrlen(process_info);
367 va_start(ap, format);
368 if (!string_vformat(process_info + len, PROCESS_INFO_SIZE - len, format, ap))
369 Ustrcpy(process_info + len, "**** string overflowed buffer ****");
370 DEBUG(D_process_info) debug_printf("set_process_info: %s\n", process_info);
378 /*************************************************
379 * Ensure stdin, stdout, and stderr exist *
380 *************************************************/
382 /* Some operating systems grumble if an exec() happens without a standard
383 input, output, and error (fds 0, 1, 2) being defined. The worry is that some
384 file will be opened and will use these fd values, and then some other bit of
385 code will assume, for example, that it can write error messages to stderr.
386 This function ensures that fds 0, 1, and 2 are open if they do not already
387 exist, by connecting them to /dev/null.
389 This function is also used to ensure that std{in,out,err} exist at all times,
390 so that if any library that Exim calls tries to use them, it doesn't crash.
402 for (i = 0; i <= 2; i++)
404 if (fstat(i, &statbuf) < 0 && errno == EBADF)
406 if (devnull < 0) devnull = open("/dev/null", O_RDWR);
407 if (devnull < 0) log_write(0, LOG_MAIN|LOG_PANIC_DIE, "%s",
408 string_open_failed(errno, "/dev/null"));
409 if (devnull != i) dup2(devnull, i);
412 if (devnull > 2) close(devnull);
418 /*************************************************
419 * Close unwanted file descriptors for delivery *
420 *************************************************/
422 /* This function is called from a new process that has been forked to deliver
423 an incoming message, either directly, or using exec.
425 We want any smtp input streams to be closed in this new process. However, it
426 has been observed that using fclose() here causes trouble. When reading in -bS
427 input, duplicate copies of messages have been seen. The files will be sharing a
428 file pointer with the parent process, and it seems that fclose() (at least on
429 some systems - I saw this on Solaris 2.5.1) messes with that file pointer, at
430 least sometimes. Hence we go for closing the underlying file descriptors.
432 If TLS is active, we want to shut down the TLS library, but without molesting
433 the parent's SSL connection.
435 For delivery of a non-SMTP message, we want to close stdin and stdout (and
436 stderr unless debugging) because the calling process might have set them up as
437 pipes and be waiting for them to close before it waits for the submission
438 process to terminate. If they aren't closed, they hold up the calling process
439 until the initial delivery process finishes, which is not what we want.
441 Exception: We do want it for synchronous delivery!
443 And notwithstanding all the above, if D_resolver is set, implying resolver
444 debugging, leave stdout open, because that's where the resolver writes its
447 When we close stderr (which implies we've also closed stdout), we also get rid
448 of any controlling terminal.
460 tls_close(FALSE); /* Shut down the TLS library */
462 close(fileno(smtp_in));
463 close(fileno(smtp_out));
468 close(0); /* stdin */
469 if ((debug_selector & D_resolver) == 0) close(1); /* stdout */
470 if (debug_selector == 0) /* stderr */
472 if (!synchronous_delivery)
485 /*************************************************
487 *************************************************/
489 /* This function sets a new uid and gid permanently, optionally calling
490 initgroups() to set auxiliary groups. There are some special cases when running
491 Exim in unprivileged modes. In these situations the effective uid will not be
492 root; if we already have the right effective uid/gid, and don't need to
493 initialize any groups, leave things as they are.
498 igflag TRUE if initgroups() wanted
499 msg text to use in debugging output and failure log
501 Returns: nothing; bombs out on failure
505 exim_setugid(uid_t uid, gid_t gid, BOOL igflag, uschar *msg)
507 uid_t euid = geteuid();
508 gid_t egid = getegid();
510 if (euid == root_uid || euid != uid || egid != gid || igflag)
512 /* At least one OS returns +1 for initgroups failure, so just check for
517 struct passwd *pw = getpwuid(uid);
520 if (initgroups(pw->pw_name, gid) != 0)
521 log_write(0,LOG_MAIN|LOG_PANIC_DIE,"initgroups failed for uid=%ld: %s",
522 (long int)uid, strerror(errno));
524 else log_write(0, LOG_MAIN|LOG_PANIC_DIE, "cannot run initgroups(): "
525 "no passwd entry for uid=%ld", (long int)uid);
528 if (setgid(gid) < 0 || setuid(uid) < 0)
530 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "unable to set gid=%ld or uid=%ld "
531 "(euid=%ld): %s", (long int)gid, (long int)uid, (long int)euid, msg);
535 /* Debugging output included uid/gid and all groups */
540 gid_t group_list[NGROUPS_MAX];
541 debug_printf("changed uid/gid: %s\n uid=%ld gid=%ld pid=%ld\n", msg,
542 (long int)geteuid(), (long int)getegid(), (long int)getpid());
543 group_count = getgroups(NGROUPS_MAX, group_list);
544 debug_printf(" auxiliary group list:");
548 for (i = 0; i < group_count; i++) debug_printf(" %d", (int)group_list[i]);
550 else debug_printf(" <none>");
558 /*************************************************
560 *************************************************/
562 /* Exim exits via this function so that it always clears up any open
568 Returns: does not return
576 debug_printf(">>>>>>>>>>>>>>>> Exim pid=%d terminating with rc=%d "
577 ">>>>>>>>>>>>>>>>\n", (int)getpid(), rc);
584 /*************************************************
585 * Extract port from host address *
586 *************************************************/
588 /* Called to extract the port from the values given to -oMa and -oMi.
589 It also checks the syntax of the address.
592 address the address, with possible port on the end
594 Returns: the port, or zero if there isn't one
595 bombs out on a syntax error
599 check_port(uschar *address)
601 int port = host_extract_port(address);
602 if (!string_is_ip_address(address, NULL))
604 fprintf(stderr, "exim abandoned: \"%s\" is not an IP address\n", address);
612 /*************************************************
613 * Test/verify an address *
614 *************************************************/
616 /* This function is called by the -bv and -bt code. It extracts a working
617 address from a full RFC 822 address. This isn't really necessary per se, but it
618 has the effect of collapsing source routes.
622 flags flag bits for verify_address()
623 exit_value to be set for failures
629 test_address(uschar *s, int flags, int *exit_value)
631 int start, end, domain;
632 uschar *parse_error = NULL;
633 uschar *address = parse_extract_address(s, &parse_error, &start, &end, &domain,
637 fprintf(stdout, "syntax error: %s\n", parse_error);
642 int rc = verify_address(deliver_make_addr(address,TRUE), stdout, flags, -1,
643 -1, -1, NULL, NULL, NULL);
644 if (rc == FAIL) *exit_value = 2;
645 else if (rc == DEFER && *exit_value == 0) *exit_value = 1;
651 /*************************************************
652 * Decode bit settings for log/debug *
653 *************************************************/
655 /* This function decodes a string containing bit settings in the form of +name
656 and/or -name sequences, and sets/unsets bits in a bit string accordingly. It
657 also recognizes a numeric setting of the form =<number>, but this is not
658 intended for user use. It's an easy way for Exim to pass the debug settings
659 when it is re-exec'ed.
661 The log options are held in two unsigned ints (because there became too many
662 for one). The top bit in the table means "put in 2nd selector". This does not
663 yet apply to debug options, so the "=" facility sets only the first selector.
665 A bad value for a debug setting is treated as an unknown option - error message
666 to stderr and die. For log settings, which come from the configuration file,
667 we write to the log on the way out...
670 selector1 address of the first bit string
671 selector2 address of the second bit string, or NULL
672 string the configured string
673 options the table of option names
675 which "log" or "debug"
677 Returns: nothing on success - bomb out on failure
681 decode_bits(unsigned int *selector1, unsigned int *selector2, uschar *string,
682 bit_table *options, int count, uschar *which)
685 if (string == NULL) return;
689 char *end; /* Not uschar */
690 *selector1 = strtoul(CS string+1, &end, 0);
691 if (*end == 0) return;
692 errmsg = string_sprintf("malformed numeric %s_selector setting: %s", which,
697 /* Handle symbolic setting */
704 bit_table *start, *end;
706 while (isspace(*string)) string++;
707 if (*string == 0) return;
709 if (*string != '+' && *string != '-')
711 errmsg = string_sprintf("malformed %s_selector setting: "
712 "+ or - expected but found \"%s\"", which, string);
716 adding = *string++ == '+';
718 while (isalnum(*string) || *string == '_') string++;
722 end = options + count;
726 bit_table *middle = start + (end - start)/2;
727 int c = Ustrncmp(s, middle->name, len);
730 if (middle->name[len] != 0) c = -1; else
732 unsigned int bit = middle->bit;
733 unsigned int *selector;
735 /* The value with all bits set means "set all bits in both selectors"
736 in the case where two are being handled. However, the top bit in the
737 second selector is never set. */
739 if (bit == 0xffffffff)
741 *selector1 = adding? bit : 0;
742 if (selector2 != NULL) *selector2 = adding? 0x7fffffff : 0;
745 /* Otherwise, the 0x80000000 bit means "this value, without the top
746 bit, belongs in the second selector". */
750 if ((bit & 0x80000000) != 0)
752 selector = selector2;
755 else selector = selector1;
756 if (adding) *selector |= bit; else *selector &= ~bit;
758 break; /* Out of loop to match selector name */
761 if (c < 0) end = middle; else start = middle + 1;
762 } /* Loop to match selector name */
766 errmsg = string_sprintf("unknown %s_selector setting: %c%.*s", which,
767 adding? '+' : '-', len, s);
770 } /* Loop for selector names */
772 /* Handle disasters */
775 if (Ustrcmp(which, "debug") == 0)
777 fprintf(stderr, "exim: %s\n", errmsg);
780 else log_write(0, LOG_CONFIG|LOG_PANIC_DIE, "%s", errmsg);
785 /*************************************************
786 * Show supported features *
787 *************************************************/
789 /* This function is called for -bV and for -d to output the optional features
790 of the current Exim binary.
792 Arguments: a FILE for printing
797 show_whats_supported(FILE *f)
799 #ifdef DB_VERSION_STRING
800 fprintf(f, "Berkeley DB: %s\n", DB_VERSION_STRING);
801 #elif defined(BTREEVERSION) && defined(HASHVERSION)
803 fprintf(f, "Probably Berkeley DB version 1.8x (native mode)\n");
805 fprintf(f, "Probably Berkeley DB version 1.8x (compatibility mode)\n");
807 #elif defined(_DBM_RDONLY) || defined(dbm_dirfno)
808 fprintf(f, "Probably ndbm\n");
809 #elif defined(USE_TDB)
810 fprintf(f, "Using tdb\n");
813 fprintf(f, "Probably GDBM (native mode)\n");
815 fprintf(f, "Probably GDBM (compatibility mode)\n");
819 fprintf(f, "Support for:");
821 fprintf(f, " iconv()");
832 #ifdef USE_TCP_WRAPPERS
833 fprintf(f, " TCPwrappers");
837 fprintf(f, " GnuTLS");
839 fprintf(f, " OpenSSL");
842 #ifdef WITH_CONTENT_SCAN
843 fprintf(f, " Content_Scanning");
845 #ifdef WITH_OLD_DEMIME
846 fprintf(f, " Old_Demime");
850 fprintf(f, "Lookups:");
851 #ifdef LOOKUP_LSEARCH
852 fprintf(f, " lsearch wildlsearch nwildlsearch iplsearch");
858 fprintf(f, " dbm dbmnz");
861 fprintf(f, " dnsdb");
863 #ifdef LOOKUP_DSEARCH
864 fprintf(f, " dsearch");
867 fprintf(f, " ibase");
870 fprintf(f, " ldap ldapdn ldapm");
873 fprintf(f, " mysql");
876 fprintf(f, " nis nis0");
878 #ifdef LOOKUP_NISPLUS
879 fprintf(f, " nisplus");
882 fprintf(f, " oracle");
885 fprintf(f, " passwd");
888 fprintf(f, " pgsql");
891 fprintf(f, " testdb");
894 fprintf(f, " whoson");
898 fprintf(f, "Authenticators:");
900 fprintf(f, " cram_md5");
902 #ifdef AUTH_CYRUS_SASL
903 fprintf(f, " cyrus_sasl");
905 #ifdef AUTH_PLAINTEXT
906 fprintf(f, " plaintext");
913 fprintf(f, "Routers:");
915 fprintf(f, " accept");
917 #ifdef ROUTER_DNSLOOKUP
918 fprintf(f, " dnslookup");
920 #ifdef ROUTER_IPLITERAL
921 fprintf(f, " ipliteral");
923 #ifdef ROUTER_IPLOOKUP
924 fprintf(f, " iplookup");
926 #ifdef ROUTER_MANUALROUTE
927 fprintf(f, " manualroute");
929 #ifdef ROUTER_QUERYPROGRAM
930 fprintf(f, " queryprogram");
932 #ifdef ROUTER_REDIRECT
933 fprintf(f, " redirect");
937 fprintf(f, "Transports:");
938 #ifdef TRANSPORT_APPENDFILE
939 fprintf(f, " appendfile");
940 #ifdef SUPPORT_MAILDIR
941 fprintf(f, "/maildir");
943 #ifdef SUPPORT_MAILSTORE
944 fprintf(f, "/mailstore");
950 #ifdef TRANSPORT_AUTOREPLY
951 fprintf(f, " autoreply");
953 #ifdef TRANSPORT_LMTP
956 #ifdef TRANSPORT_PIPE
959 #ifdef TRANSPORT_SMTP
964 if (fixed_never_users[0] > 0)
967 fprintf(f, "Fixed never_users: ");
968 for (i = 1; i <= (int)fixed_never_users[0] - 1; i++)
969 fprintf(f, "%d:", (unsigned int)fixed_never_users[i]);
970 fprintf(f, "%d\n", (unsigned int)fixed_never_users[i]);
977 /*************************************************
978 * Quote a local part *
979 *************************************************/
981 /* This function is used when a sender address or a From: or Sender: header
982 line is being created from the caller's login, or from an authenticated_id. It
983 applies appropriate quoting rules for a local part.
985 Argument: the local part
986 Returns: the local part, quoted if necessary
990 local_part_quote(uschar *lpart)
992 BOOL needs_quote = FALSE;
997 for (t = lpart; !needs_quote && *t != 0; t++)
999 needs_quote = !isalnum(*t) && strchr("!#$%&'*+-/=?^_`{|}~", *t) == NULL &&
1000 (*t != '.' || t == lpart || t[1] == 0);
1003 if (!needs_quote) return lpart;
1006 yield = string_cat(NULL, &size, &ptr, US"\"", 1);
1010 uschar *nq = US Ustrpbrk(lpart, "\\\"");
1013 yield = string_cat(yield, &size, &ptr, lpart, Ustrlen(lpart));
1016 yield = string_cat(yield, &size, &ptr, lpart, nq - lpart);
1017 yield = string_cat(yield, &size, &ptr, US"\\", 1);
1018 yield = string_cat(yield, &size, &ptr, nq, 1);
1022 yield = string_cat(yield, &size, &ptr, US"\"", 1);
1030 /*************************************************
1031 * Load readline() functions *
1032 *************************************************/
1034 /* This function is called from testing executions that read data from stdin,
1035 but only when running as the calling user. Currently, only -be does this. The
1036 function loads the readline() function library and passes back the functions.
1037 On some systems, it needs the curses library, so load that too, but try without
1038 it if loading fails. All this functionality has to be requested at build time.
1041 fn_readline_ptr pointer to where to put the readline pointer
1042 fn_addhist_ptr pointer to where to put the addhistory function
1044 Returns: the dlopen handle or NULL on failure
1048 set_readline(char * (**fn_readline_ptr)(char *),
1049 char * (**fn_addhist_ptr)(char *))
1052 void *dlhandle_curses = dlopen("libcurses.so", RTLD_GLOBAL|RTLD_LAZY);
1054 dlhandle = dlopen("libreadline.so", RTLD_GLOBAL|RTLD_NOW);
1055 if (dlhandle_curses != NULL) dlclose(dlhandle_curses);
1057 if (dlhandle != NULL)
1059 *fn_readline_ptr = (char *(*)(char*))dlsym(dlhandle, "readline");
1060 *fn_addhist_ptr = (char *(*)(char*))dlsym(dlhandle, "add_history");
1064 DEBUG(D_any) debug_printf("failed to load readline: %s\n", dlerror());
1073 /*************************************************
1074 * Get a line from stdin for testing things *
1075 *************************************************/
1077 /* This function is called when running tests that can take a number of lines
1078 of input (for example, -be and -bt). It handles continuations and trailing
1079 spaces. And prompting and a blank line output on eof. If readline() is in use,
1080 the arguments are non-NULL and provide the relevant functions.
1083 fn_readline readline function or NULL
1084 fn_addhist addhist function or NULL
1086 Returns: pointer to dynamic memory, or NULL at end of file
1090 get_stdinput(char *(*fn_readline)(char *), char *(*fn_addhist)(char *))
1095 uschar *yield = NULL;
1097 if (fn_readline == NULL) printf("> ");
1101 uschar buffer[1024];
1105 char *readline_line = NULL;
1106 if (fn_readline != NULL)
1108 if ((readline_line = fn_readline((i > 0)? "":"> ")) == NULL) break;
1109 if (*readline_line != 0 && fn_addhist != NULL) fn_addhist(readline_line);
1110 p = US readline_line;
1115 /* readline() not in use */
1118 if (Ufgets(buffer, sizeof(buffer), stdin) == NULL) break;
1122 /* Handle the line */
1124 ss = p + (int)Ustrlen(p);
1125 while (ss > p && isspace(ss[-1])) ss--;
1129 while (p < ss && isspace(*p)) p++; /* leading space after cont */
1132 yield = string_cat(yield, &size, &ptr, p, ss - p);
1135 if (fn_readline != NULL) free(readline_line);
1138 if (ss == p || yield[ptr-1] != '\\')
1146 if (yield == NULL) printf("\n");
1152 /*************************************************
1153 * Entry point and high-level code *
1154 *************************************************/
1156 /* Entry point for the Exim mailer. Analyse the arguments and arrange to take
1157 the appropriate action. All the necessary functions are present in the one
1158 binary. I originally thought one should split it up, but it turns out that so
1159 much of the apparatus is needed in each chunk that one might as well just have
1160 it all available all the time, which then makes the coding easier as well.
1163 argc count of entries in argv
1164 argv argument strings, with argv[0] being the program name
1166 Returns: EXIT_SUCCESS if terminated successfully
1167 EXIT_FAILURE otherwise, except when a message has been sent
1168 to the sender, and -oee was given
1172 main(int argc, char **cargv)
1174 uschar **argv = USS cargv;
1175 int arg_receive_timeout = -1;
1176 int arg_smtp_receive_timeout = -1;
1177 int arg_error_handling = error_handling;
1181 int list_queue_option = 0;
1183 int msg_action_arg = -1;
1184 int namelen = (argv[0] == NULL)? 0 : Ustrlen(argv[0]);
1185 int queue_only_reason = 0;
1187 int perl_start_option = 0;
1189 int recipients_arg = argc;
1190 int sender_address_domain = 0;
1191 int test_retry_arg = -1;
1192 int test_rewrite_arg = -1;
1193 BOOL arg_queue_only = FALSE;
1194 BOOL bi_option = FALSE;
1195 BOOL checking = FALSE;
1196 BOOL count_queue = FALSE;
1197 BOOL expansion_test = FALSE;
1198 BOOL extract_recipients = FALSE;
1199 BOOL forced_delivery = FALSE;
1200 BOOL f_end_dot = FALSE;
1201 BOOL deliver_give_up = FALSE;
1202 BOOL list_queue = FALSE;
1203 BOOL list_options = FALSE;
1204 BOOL local_queue_only;
1206 BOOL one_msg_action = FALSE;
1207 BOOL queue_only_set = FALSE;
1208 BOOL receiving_message = TRUE;
1210 BOOL removed_privilege = FALSE;
1211 BOOL verify_address_mode = FALSE;
1212 BOOL verify_as_sender = FALSE;
1213 BOOL version_printed = FALSE;
1214 uschar *alias_arg = NULL;
1215 uschar *called_as = US"";
1216 uschar *start_queue_run_id = NULL;
1217 uschar *stop_queue_run_id = NULL;
1218 uschar *ftest_domain = NULL;
1219 uschar *ftest_localpart = NULL;
1220 uschar *ftest_prefix = NULL;
1221 uschar *ftest_suffix = NULL;
1222 uschar *real_sender_address;
1223 uschar *originator_home = US"/";
1224 BOOL ftest_system = FALSE;
1228 struct stat statbuf;
1229 pid_t passed_qr_pid = (pid_t)0;
1230 int passed_qr_pipe = -1;
1231 gid_t group_list[NGROUPS_MAX];
1233 /* Possible options for -R and -S */
1235 static uschar *rsopts[] = { US"f", US"ff", US"r", US"rf", US"rff" };
1237 /* Need to define this in case we need to change the environment in order
1238 to get rid of a bogus time zone. We have to make it char rather than uschar
1239 because some OS define it in /usr/include/unistd.h. */
1241 extern char **environ;
1243 /* If the Exim user and/or group and/or the configuration file owner/group were
1244 defined by ref:name at build time, we must now find the actual uid/gid values.
1245 This is a feature to make the lives of binary distributors easier. */
1247 #ifdef EXIM_USERNAME
1248 if (route_finduser(US EXIM_USERNAME, &pw, &exim_uid))
1250 exim_gid = pw->pw_gid;
1254 fprintf(stderr, "exim: failed to find uid for user name \"%s\"\n",
1260 #ifdef EXIM_GROUPNAME
1261 if (!route_findgroup(US EXIM_GROUPNAME, &exim_gid))
1263 fprintf(stderr, "exim: failed to find gid for group name \"%s\"\n",
1269 #ifdef CONFIGURE_OWNERNAME
1270 if (!route_finduser(US CONFIGURE_OWNERNAME, NULL, &config_uid))
1272 fprintf(stderr, "exim: failed to find uid for user name \"%s\"\n",
1273 CONFIGURE_OWNERNAME);
1278 #ifdef CONFIGURE_GROUPNAME
1279 if (!route_findgroup(US CONFIGURE_GROUPNAME, &config_gid))
1281 fprintf(stderr, "exim: failed to find gid for group name \"%s\"\n",
1282 CONFIGURE_GROUPNAME);
1287 /* In the Cygwin environment, some initialization needs doing. It is fudged
1288 in by means of this macro. */
1294 /* Check a field which is patched when we are running Exim within its
1295 testing harness; do a fast initial check, and then the whole thing. */
1297 running_in_test_harness =
1298 *running_status == '<' && Ustrcmp(running_status, "<<<testing>>>") == 0;
1300 /* The C standard says that the equivalent of setlocale(LC_ALL, "C") is obeyed
1301 at the start of a program; however, it seems that some environments do not
1302 follow this. A "strange" locale can affect the formatting of timestamps, so we
1305 setlocale(LC_ALL, "C");
1307 /* Set up the default handler for timing using alarm(). */
1309 os_non_restarting_signal(SIGALRM, sigalrm_handler);
1311 /* Ensure we have a buffer for constructing log entries. Use malloc directly,
1312 because store_malloc writes a log entry on failure. */
1314 log_buffer = (uschar *)malloc(LOG_BUFFER_SIZE);
1315 if (log_buffer == NULL)
1317 fprintf(stderr, "exim: failed to get store for log buffer\n");
1321 /* Set log_stderr to stderr, provided that stderr exists. This gets reset to
1322 NULL when the daemon is run and the file is closed. We have to use this
1323 indirection, because some systems don't allow writing to the variable "stderr".
1326 if (fstat(fileno(stderr), &statbuf) >= 0) log_stderr = stderr;
1328 /* Arrange for the PCRE regex library to use our store functions. Note that
1329 the normal calls are actually macros that add additional arguments for
1330 debugging purposes so we have to assign specially constructed functions here.
1331 The default is to use store in the stacking pool, but this is overridden in the
1332 regex_must_compile() function. */
1334 pcre_malloc = function_store_get;
1335 pcre_free = function_dummy_free;
1337 /* Ensure there is a big buffer for temporary use in several places. It is put
1338 in malloc store so that it can be freed for enlargement if necessary. */
1340 big_buffer = store_malloc(big_buffer_size);
1342 /* Set up the handler for the data request signal, and set the initial
1343 descriptive text. */
1345 set_process_info("initializing");
1346 os_restarting_signal(SIGUSR1, usr1_handler);
1348 /* SIGHUP is used to get the daemon to reconfigure. It gets set as appropriate
1349 in the daemon code. For the rest of Exim's uses, we ignore it. */
1351 signal(SIGHUP, SIG_IGN);
1353 /* We don't want to die on pipe errors as the code is written to handle
1354 the write error instead. */
1356 signal(SIGPIPE, SIG_IGN);
1358 /* Under some circumstance on some OS, Exim can get called with SIGCHLD
1359 set to SIG_IGN. This causes subprocesses that complete before the parent
1360 process waits for them not to hang around, so when Exim calls wait(), nothing
1361 is there. The wait() code has been made robust against this, but let's ensure
1362 that SIGCHLD is set to SIG_DFL, because it's tidier to wait and get a process
1363 ending status. We use sigaction rather than plain signal() on those OS where
1364 SA_NOCLDWAIT exists, because we want to be sure it is turned off. (There was a
1365 problem on AIX with this.) */
1369 struct sigaction act;
1370 act.sa_handler = SIG_DFL;
1371 sigemptyset(&(act.sa_mask));
1373 sigaction(SIGCHLD, &act, NULL);
1376 signal(SIGCHLD, SIG_DFL);
1379 /* Save the arguments for use if we re-exec exim as a daemon after receiving
1384 /* Set up the version number. Set up the leading 'E' for the external form of
1385 message ids, set the pointer to the internal form, and initialize it to
1386 indicate no message being processed. */
1389 message_id_option[0] = '-';
1390 message_id_external = message_id_option + 1;
1391 message_id_external[0] = 'E';
1392 message_id = message_id_external + 1;
1395 /* Set the umask to zero so that any files that Exim creates are created
1396 with the modes that it specifies. */
1400 /* Precompile the regular expression for matching a message id. Keep this in
1401 step with the code that generates ids in the accept.c module. We need to do
1402 this here, because the -M options check their arguments for syntactic validity
1403 using mac_ismsgid, which uses this. */
1406 regex_must_compile(US"^(?:[^\\W_]{6}-){2}[^\\W_]{2}$", FALSE, TRUE);
1408 /* If the program is called as "mailq" treat it as equivalent to "exim -bp";
1409 this seems to be a generally accepted convention, since one finds symbolic
1410 links called "mailq" in standard OS configurations. */
1412 if ((namelen == 5 && Ustrcmp(argv[0], "mailq") == 0) ||
1413 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/mailq", 6) == 0))
1416 receiving_message = FALSE;
1417 called_as = US"-mailq";
1420 /* If the program is called as "rmail" treat it as equivalent to
1421 "exim -i -oee", thus allowing UUCP messages to be input using non-SMTP mode,
1422 i.e. preventing a single dot on a line from terminating the message, and
1423 returning with zero return code, even in cases of error (provided an error
1424 message has been sent). */
1426 if ((namelen == 5 && Ustrcmp(argv[0], "rmail") == 0) ||
1427 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/rmail", 6) == 0))
1430 called_as = US"-rmail";
1431 errors_sender_rc = EXIT_SUCCESS;
1434 /* If the program is called as "rsmtp" treat it as equivalent to "exim -bS";
1435 this is a smail convention. */
1437 if ((namelen == 5 && Ustrcmp(argv[0], "rsmtp") == 0) ||
1438 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/rsmtp", 6) == 0))
1440 smtp_input = smtp_batched_input = TRUE;
1441 called_as = US"-rsmtp";
1444 /* If the program is called as "runq" treat it as equivalent to "exim -q";
1445 this is a smail convention. */
1447 if ((namelen == 4 && Ustrcmp(argv[0], "runq") == 0) ||
1448 (namelen > 4 && Ustrncmp(argv[0] + namelen - 5, "/runq", 5) == 0))
1451 receiving_message = FALSE;
1452 called_as = US"-runq";
1455 /* If the program is called as "newaliases" treat it as equivalent to
1456 "exim -bi"; this is a sendmail convention. */
1458 if ((namelen == 10 && Ustrcmp(argv[0], "newaliases") == 0) ||
1459 (namelen > 10 && Ustrncmp(argv[0] + namelen - 11, "/newaliases", 11) == 0))
1462 receiving_message = FALSE;
1463 called_as = US"-newaliases";
1466 /* Save the original effective uid for a couple of uses later. It should
1467 normally be root, but in some esoteric environments it may not be. */
1469 original_euid = geteuid();
1471 /* Get the real uid and gid. If the caller is root, force the effective uid/gid
1472 to be the same as the real ones. This makes a difference only if Exim is setuid
1473 (or setgid) to something other than root, which could be the case in some
1474 special configurations. */
1476 real_uid = getuid();
1477 real_gid = getgid();
1479 if (real_uid == root_uid)
1485 /* If neither the original real uid nor the original euid was root, Exim is
1486 running in an unprivileged state. */
1488 unprivileged = (real_uid != root_uid && original_euid != root_uid);
1490 /* If the first argument is --help, pretend there are no arguments. This will
1491 cause a brief message to be given. */
1493 if (argc > 1 && Ustrcmp(argv[1], "--help") == 0) argc = 1;
1495 /* Scan the program's arguments. Some can be dealt with right away; others are
1496 simply recorded for checking and handling afterwards. Do a high-level switch
1497 on the second character (the one after '-'), to save some effort. */
1499 for (i = 1; i < argc; i++)
1501 BOOL badarg = FALSE;
1502 uschar *arg = argv[i];
1506 /* An argument not starting with '-' is the start of a recipients list;
1507 break out of the options-scanning loop. */
1515 /* An option consistion of -- terminates the options */
1517 if (Ustrcmp(arg, "--") == 0)
1519 recipients_arg = i + 1;
1523 /* Handle flagged options */
1525 switchchar = arg[1];
1528 /* Make all -ex options synonymous with -oex arguments, since that
1529 is assumed by various callers. Also make -qR options synonymous with -R
1530 options, as that seems to be required as well. Allow for -qqR too, and
1531 the same for -S options. */
1533 if (Ustrncmp(arg+1, "oe", 2) == 0 ||
1534 Ustrncmp(arg+1, "qR", 2) == 0 ||
1535 Ustrncmp(arg+1, "qS", 2) == 0)
1537 switchchar = arg[2];
1540 else if (Ustrncmp(arg+1, "qqR", 3) == 0 || Ustrncmp(arg+1, "qqS", 3) == 0)
1542 switchchar = arg[3];
1544 queue_2stage = TRUE;
1547 /* Make -r synonymous with -f, since it is a documented alias */
1549 else if (arg[1] == 'r') switchchar = 'f';
1551 /* Make -ov synonymous with -v */
1553 else if (Ustrcmp(arg, "-ov") == 0)
1559 /* High-level switch on active initial letter */
1563 /* -Btype is a sendmail option for 7bit/8bit setting. Exim is 8-bit clean
1564 so has no need of it. */
1567 if (*argrest == 0) i++; /* Skip over the type */
1572 receiving_message = FALSE; /* Reset TRUE for -bm, -bS, -bs below */
1574 /* -bd: Run in daemon mode, awaiting SMTP connections.
1575 -bdf: Ditto, but in the foreground.
1578 if (*argrest == 'd')
1580 daemon_listen = TRUE;
1581 if (*(++argrest) == 'f') background_daemon = FALSE;
1582 else if (*argrest != 0) { badarg = TRUE; break; }
1585 /* -be: Run in expansion test mode */
1587 else if (*argrest == 'e')
1588 expansion_test = checking = TRUE;
1590 /* -bf: Run in mail filter testing mode
1591 -bF: Ditto, but for system filters
1592 -bfd: Set domain for filter testing
1593 -bfl: Set local part for filter testing
1594 -bfp: Set prefix for filter testing
1595 -bfs: Set suffix for filter testing
1598 else if (*argrest == 'f' || *argrest == 'F')
1600 ftest_system = *argrest++ == 'F';
1603 if(++i < argc) filter_test = argv[i]; else
1605 fprintf(stderr, "exim: file name expected after %s\n", argv[i-1]);
1613 fprintf(stderr, "exim: string expected after %s\n", arg);
1616 if (Ustrcmp(argrest, "d") == 0) ftest_domain = argv[i];
1617 else if (Ustrcmp(argrest, "l") == 0) ftest_localpart = argv[i];
1618 else if (Ustrcmp(argrest, "p") == 0) ftest_prefix = argv[i];
1619 else if (Ustrcmp(argrest, "s") == 0) ftest_suffix = argv[i];
1620 else { badarg = TRUE; break; }
1624 /* -bh: Host checking - an IP address must follow. */
1626 else if (Ustrcmp(argrest, "h") == 0 || Ustrcmp(argrest, "hc") == 0)
1628 if (++i >= argc) { badarg = TRUE; break; }
1629 sender_host_address = argv[i];
1630 host_checking = checking = log_testing_mode = TRUE;
1631 host_checking_callout = argrest[1] == 'c';
1634 /* -bi: This option is used by sendmail to initialize *the* alias file,
1635 though it has the -oA option to specify a different file. Exim has no
1636 concept of *the* alias file, but since Sun's YP make script calls
1637 sendmail this way, some support must be provided. */
1639 else if (Ustrcmp(argrest, "i") == 0) bi_option = TRUE;
1641 /* -bm: Accept and deliver message - the default option. Reinstate
1642 receiving_message, which got turned off for all -b options. */
1644 else if (Ustrcmp(argrest, "m") == 0) receiving_message = TRUE;
1646 /* -bnq: For locally originating messages, do not qualify unqualified
1647 addresses. In the envelope, this causes errors; in header lines they
1650 else if (Ustrcmp(argrest, "nq") == 0)
1652 allow_unqualified_sender = FALSE;
1653 allow_unqualified_recipient = FALSE;
1656 /* -bpxx: List the contents of the mail queue, in various forms. If
1657 the option is -bpc, just a queue count is needed. Otherwise, if the
1658 first letter after p is r, then order is random. */
1660 else if (*argrest == 'p')
1662 if (*(++argrest) == 'c')
1665 if (*(++argrest) != 0) badarg = TRUE;
1669 if (*argrest == 'r')
1671 list_queue_option = 8;
1674 else list_queue_option = 0;
1678 /* -bp: List the contents of the mail queue, top-level only */
1680 if (*argrest == 0) {}
1682 /* -bpu: List the contents of the mail queue, top-level undelivered */
1684 else if (Ustrcmp(argrest, "u") == 0) list_queue_option += 1;
1686 /* -bpa: List the contents of the mail queue, including all delivered */
1688 else if (Ustrcmp(argrest, "a") == 0) list_queue_option += 2;
1690 /* Unknown after -bp[r] */
1700 /* -bP: List the configuration variables given as the address list.
1701 Force -v, so configuration errors get displayed. */
1703 else if (Ustrcmp(argrest, "P") == 0)
1705 list_options = TRUE;
1706 debug_selector |= D_v;
1707 debug_file = stderr;
1710 /* -brt: Test retry configuration lookup */
1712 else if (Ustrcmp(argrest, "rt") == 0)
1714 test_retry_arg = i + 1;
1718 /* -brw: Test rewrite configuration */
1720 else if (Ustrcmp(argrest, "rw") == 0)
1722 test_rewrite_arg = i + 1;
1726 /* -bS: Read SMTP commands on standard input, but produce no replies -
1727 all errors are reported by sending messages. */
1729 else if (Ustrcmp(argrest, "S") == 0)
1730 smtp_input = smtp_batched_input = receiving_message = TRUE;
1732 /* -bs: Read SMTP commands on standard input and produce SMTP replies
1733 on standard output. */
1735 else if (Ustrcmp(argrest, "s") == 0) smtp_input = receiving_message = TRUE;
1737 /* -bt: address testing mode */
1739 else if (Ustrcmp(argrest, "t") == 0)
1740 address_test_mode = checking = log_testing_mode = TRUE;
1742 /* -bv: verify addresses */
1744 else if (Ustrcmp(argrest, "v") == 0)
1745 verify_address_mode = checking = log_testing_mode = TRUE;
1747 /* -bvs: verify sender addresses */
1749 else if (Ustrcmp(argrest, "vs") == 0)
1751 verify_address_mode = checking = log_testing_mode = TRUE;
1752 verify_as_sender = TRUE;
1755 /* -bV: Print version string and support details */
1757 else if (Ustrcmp(argrest, "V") == 0)
1759 printf("Exim version %s #%s built %s\n", version_string,
1760 version_cnumber, version_date);
1761 printf("%s\n", CS version_copyright);
1762 version_printed = TRUE;
1763 show_whats_supported(stdout);
1770 /* -C: change configuration file list; ignore if it isn't really
1771 a change! Enforce a prefix check if required. */
1776 if(++i < argc) argrest = argv[i]; else
1777 { badarg = TRUE; break; }
1779 if (Ustrcmp(config_main_filelist, argrest) != 0)
1781 #ifdef ALT_CONFIG_PREFIX
1783 int len = Ustrlen(ALT_CONFIG_PREFIX);
1784 uschar *list = argrest;
1786 while((filename = string_nextinlist(&list, &sep, big_buffer,
1787 big_buffer_size)) != NULL)
1789 if ((Ustrlen(filename) < len ||
1790 Ustrncmp(filename, ALT_CONFIG_PREFIX, len) != 0 ||
1791 Ustrstr(filename, "/../") != NULL) &&
1792 (Ustrcmp(filename, "/dev/null") != 0 || real_uid != root_uid))
1794 fprintf(stderr, "-C Permission denied\n");
1800 config_main_filelist = argrest;
1801 config_changed = TRUE;
1806 /* -D: set up a macro definition */
1809 #ifdef DISABLE_D_OPTION
1810 fprintf(stderr, "exim: -D is not available in this Exim binary\n");
1815 macro_item *mlast = NULL;
1818 uschar *s = argrest;
1820 while (isspace(*s)) s++;
1822 if (*s < 'A' || *s > 'Z')
1824 fprintf(stderr, "exim: macro name set by -D must start with "
1825 "an upper case letter\n");
1829 while (isalnum(*s) || *s == '_')
1831 if (ptr < sizeof(name)-1) name[ptr++] = *s;
1835 if (ptr == 0) { badarg = TRUE; break; }
1836 while (isspace(*s)) s++;
1839 if (*s++ != '=') { badarg = TRUE; break; }
1840 while (isspace(*s)) s++;
1843 for (m = macros; m != NULL; m = m->next)
1845 if (Ustrcmp(m->name, name) == 0)
1847 fprintf(stderr, "exim: duplicated -D in command line\n");
1853 m = store_get(sizeof(macro_item) + Ustrlen(name));
1855 m->command_line = TRUE;
1856 if (mlast == NULL) macros = m; else mlast->next = m;
1857 Ustrcpy(m->name, name);
1858 m->replacement = string_copy(s);
1860 if (clmacro_count >= MAX_CLMACROS)
1862 fprintf(stderr, "exim: too many -D options on command line\n");
1865 clmacros[clmacro_count++] = string_sprintf("-D%s=%s", m->name,
1871 /* -d: Set debug level (see also -v below) or set the drop_cr option.
1872 The latter is now a no-op, retained for compatibility only. If -dd is used,
1873 debugging subprocesses of the daemon is disabled. */
1876 if (Ustrcmp(argrest, "ropcr") == 0)
1878 /* drop_cr = TRUE; */
1881 /* Use an intermediate variable so that we don't set debugging while
1882 decoding the debugging bits. */
1886 unsigned int selector = D_default;
1889 if (*argrest == 'd')
1891 debug_daemon = TRUE;
1895 decode_bits(&selector, NULL, argrest, debug_options,
1896 debug_options_count, US"debug");
1897 debug_selector = selector;
1902 /* -E: This is a local error message. This option is not intended for
1903 external use at all, but is not restricted to trusted callers because it
1904 does no harm (just suppresses certain error messages) and if Exim is run
1905 not setuid root it won't always be trusted when it generates error
1906 messages using this option. If there is a message id following -E, point
1907 message_reference at it, for logging. */
1910 local_error_message = TRUE;
1911 if (mac_ismsgid(argrest)) message_reference = argrest;
1915 /* -ex: The vacation program calls sendmail with the undocumented "-eq"
1916 option, so it looks as if historically the -oex options are also callable
1917 without the leading -o. So we have to accept them. Before the switch,
1918 anything starting -oe has been converted to -e. Exim does not support all
1919 of the sendmail error options. */
1922 if (Ustrcmp(argrest, "e") == 0)
1924 arg_error_handling = ERRORS_SENDER;
1925 errors_sender_rc = EXIT_SUCCESS;
1927 else if (Ustrcmp(argrest, "m") == 0) arg_error_handling = ERRORS_SENDER;
1928 else if (Ustrcmp(argrest, "p") == 0) arg_error_handling = ERRORS_STDERR;
1929 else if (Ustrcmp(argrest, "q") == 0) arg_error_handling = ERRORS_STDERR;
1930 else if (Ustrcmp(argrest, "w") == 0) arg_error_handling = ERRORS_SENDER;
1935 /* -F: Set sender's full name, used instead of the gecos entry from
1936 the password file. Since users can usually alter their gecos entries,
1937 there's no security involved in using this instead. The data can follow
1938 the -F or be in the next argument. */
1943 if(++i < argc) argrest = argv[i]; else
1944 { badarg = TRUE; break; }
1946 originator_name = argrest;
1950 /* -f: Set sender's address - this value is only actually used if Exim is
1951 run by a trusted user, or if untrusted_set_sender is set and matches the
1952 address, except that the null address can always be set by any user. The
1953 test for this happens later, when the value given here is ignored when not
1954 permitted. For an untrusted user, the actual sender is still put in Sender:
1955 if it doesn't match the From: header (unless no_local_from_check is set).
1956 The data can follow the -f or be in the next argument. The -r switch is an
1957 obsolete form of -f but since there appear to be programs out there that
1958 use anything that sendmail has ever supported, better accept it - the
1959 synonymizing is done before the switch above.
1961 At this stage, we must allow domain literal addresses, because we don't
1962 know what the setting of allow_domain_literals is yet. Ditto for trailing
1963 dots and strip_trailing_dot. */
1971 if (i+1 < argc) argrest = argv[++i]; else
1972 { badarg = TRUE; break; }
1976 sender_address = string_sprintf(""); /* Ensure writeable memory */
1980 uschar *temp = argrest + Ustrlen(argrest) - 1;
1981 while (temp >= argrest && isspace(*temp)) temp--;
1982 if (temp >= argrest && *temp == '.') f_end_dot = TRUE;
1983 allow_domain_literals = TRUE;
1984 strip_trailing_dot = TRUE;
1985 sender_address = parse_extract_address(argrest, &errmess, &start, &end,
1986 &sender_address_domain, TRUE);
1987 allow_domain_literals = FALSE;
1988 strip_trailing_dot = FALSE;
1989 if (sender_address == NULL)
1991 fprintf(stderr, "exim: bad -f address \"%s\": %s\n", argrest, errmess);
1992 return EXIT_FAILURE;
1995 sender_address_forced = TRUE;
1999 /* This is some Sendmail thing which can be ignored */
2004 /* -h: Set the hop count for an incoming message. Exim does not currently
2005 support this; it always computes it by counting the Received: headers.
2006 To put it in will require a change to the spool header file format. */
2011 if(++i < argc) argrest = argv[i]; else
2012 { badarg = TRUE; break; }
2014 if (!isdigit(*argrest)) badarg = TRUE;
2018 /* -i: Set flag so dot doesn't end non-SMTP input (same as -oi, seems
2019 not to be documented for sendmail but mailx (at least) uses it) */
2022 if (*argrest == 0) dot_ends = FALSE; else badarg = TRUE;
2027 receiving_message = FALSE;
2029 /* -MC: continue delivery of another message via an existing open
2030 file descriptor. This option is used for an internal call by the
2031 smtp transport when there is a pending message waiting to go to an
2032 address to which it has got a connection. Five subsequent arguments are
2033 required: transport name, host name, IP address, sequence number, and
2034 message_id. Transports may decline to create new processes if the sequence
2035 number gets too big. The channel is stdin. This (-MC) must be the last
2036 argument. There's a subsequent check that the real-uid is privileged.
2038 If we are running in the test harness. delay for a bit, to let the process
2039 that set this one up complete. This makes for repeatability of the logging,
2042 if (Ustrcmp(argrest, "C") == 0)
2046 fprintf(stderr, "exim: too many or too few arguments after -MC\n");
2047 return EXIT_FAILURE;
2050 if (msg_action_arg >= 0)
2052 fprintf(stderr, "exim: incompatible arguments\n");
2053 return EXIT_FAILURE;
2056 continue_transport = argv[++i];
2057 continue_hostname = argv[++i];
2058 continue_host_address = argv[++i];
2059 continue_sequence = Uatoi(argv[++i]);
2060 msg_action = MSG_DELIVER;
2061 msg_action_arg = ++i;
2062 forced_delivery = TRUE;
2063 queue_run_pid = passed_qr_pid;
2064 queue_run_pipe = passed_qr_pipe;
2066 if (!mac_ismsgid(argv[i]))
2068 fprintf(stderr, "exim: malformed message id %s after -MC option\n",
2070 return EXIT_FAILURE;
2073 if (running_in_test_harness) millisleep(500);
2077 /* -MCA: set the smtp_authenticated flag; this is useful only when it
2078 precedes -MC (see above). The flag indicates that the host to which
2079 Exim is connected has accepted an AUTH sequence. */
2081 else if (Ustrcmp(argrest, "CA") == 0)
2083 smtp_authenticated = TRUE;
2087 /* -MCP: set the smtp_use_pipelining flag; this is useful only when
2088 it preceded -MC (see above) */
2090 else if (Ustrcmp(argrest, "CP") == 0)
2092 smtp_use_pipelining = TRUE;
2096 /* -MCQ: pass on the pid of the queue-running process that started
2097 this chain of deliveries and the fd of its synchronizing pipe; this
2098 is useful only when it precedes -MC (see above) */
2100 else if (Ustrcmp(argrest, "CQ") == 0)
2102 if(++i < argc) passed_qr_pid = (pid_t)(Uatol(argv[i]));
2104 if(++i < argc) passed_qr_pipe = (int)(Uatol(argv[i]));
2109 /* -MCS: set the smtp_use_size flag; this is useful only when it
2110 precedes -MC (see above) */
2112 else if (Ustrcmp(argrest, "CS") == 0)
2114 smtp_use_size = TRUE;
2118 /* -MCT: set the tls_offered flag; this is useful only when it
2119 precedes -MC (see above). The flag indicates that the host to which
2120 Exim is connected has offered TLS support. */
2123 else if (Ustrcmp(argrest, "CT") == 0)
2130 /* -M[x]: various operations on the following list of message ids:
2131 -M deliver the messages, ignoring next retry times and thawing
2132 -Mc deliver the messages, checking next retry times, no thawing
2133 -Mf freeze the messages
2134 -Mg give up on the messages
2135 -Mt thaw the messages
2136 -Mrm remove the messages
2137 In the above cases, this must be the last option. There are also the
2138 following options which are followed by a single message id, and which
2139 act on that message. Some of them use the "recipient" addresses as well.
2140 -Mar add recipient(s)
2141 -Mmad mark all recipients delivered
2142 -Mmd mark recipients(s) delivered
2149 else if (*argrest == 0)
2151 msg_action = MSG_DELIVER;
2152 forced_delivery = deliver_force_thaw = TRUE;
2154 else if (Ustrcmp(argrest, "ar") == 0)
2156 msg_action = MSG_ADD_RECIPIENT;
2157 one_msg_action = TRUE;
2159 else if (Ustrcmp(argrest, "c") == 0) msg_action = MSG_DELIVER;
2160 else if (Ustrcmp(argrest, "es") == 0)
2162 msg_action = MSG_EDIT_SENDER;
2163 one_msg_action = TRUE;
2165 else if (Ustrcmp(argrest, "f") == 0) msg_action = MSG_FREEZE;
2166 else if (Ustrcmp(argrest, "g") == 0)
2168 msg_action = MSG_DELIVER;
2169 deliver_give_up = TRUE;
2171 else if (Ustrcmp(argrest, "mad") == 0)
2173 msg_action = MSG_MARK_ALL_DELIVERED;
2175 else if (Ustrcmp(argrest, "md") == 0)
2177 msg_action = MSG_MARK_DELIVERED;
2178 one_msg_action = TRUE;
2180 else if (Ustrcmp(argrest, "rm") == 0) msg_action = MSG_REMOVE;
2181 else if (Ustrcmp(argrest, "t") == 0) msg_action = MSG_THAW;
2182 else if (Ustrcmp(argrest, "vb") == 0)
2184 msg_action = MSG_SHOW_BODY;
2185 one_msg_action = TRUE;
2187 else if (Ustrcmp(argrest, "vh") == 0)
2189 msg_action = MSG_SHOW_HEADER;
2190 one_msg_action = TRUE;
2192 else if (Ustrcmp(argrest, "vl") == 0)
2194 msg_action = MSG_SHOW_LOG;
2195 one_msg_action = TRUE;
2197 else { badarg = TRUE; break; }
2199 /* All the -Mxx options require at least one message id. */
2201 msg_action_arg = i + 1;
2202 if (msg_action_arg >= argc)
2204 fprintf(stderr, "exim: no message ids given after %s option\n", arg);
2205 return EXIT_FAILURE;
2208 /* Some require only message ids to follow */
2210 if (!one_msg_action)
2213 for (j = msg_action_arg; j < argc; j++) if (!mac_ismsgid(argv[j]))
2215 fprintf(stderr, "exim: malformed message id %s after %s option\n",
2217 return EXIT_FAILURE;
2219 goto END_ARG; /* Remaining args are ids */
2222 /* Others require only one message id, possibly followed by addresses,
2223 which will be handled as normal arguments. */
2227 if (!mac_ismsgid(argv[msg_action_arg]))
2229 fprintf(stderr, "exim: malformed message id %s after %s option\n",
2230 argv[msg_action_arg], arg);
2231 return EXIT_FAILURE;
2238 /* Some programs seem to call the -om option without the leading o;
2239 for sendmail it askes for "me too". Exim always does this. */
2242 if (*argrest != 0) badarg = TRUE;
2246 /* -N: don't do delivery - a debugging option that stops transports doing
2247 their thing. It implies debugging at the D_v level. */
2252 dont_deliver = TRUE;
2253 debug_selector |= D_v;
2254 debug_file = stderr;
2260 /* -n: This means "don't alias" in sendmail, apparently. Just ignore
2266 /* -O: Just ignore it. In sendmail, apparently -O option=value means set
2267 option to the specified value. This form uses long names. We need to handle
2268 -O option=value and -Ooption=value. */
2275 fprintf(stderr, "exim: string expected after -O\n");
2283 /* -oA: Set an argument for the bi command (sendmail's "alternate alias
2286 if (*argrest == 'A')
2288 alias_arg = argrest + 1;
2289 if (alias_arg[0] == 0)
2291 if (i+1 < argc) alias_arg = argv[++i]; else
2293 fprintf(stderr, "exim: string expected after -oA\n");
2299 /* -oB: Set a connection message max value for remote deliveries */
2301 else if (*argrest == 'B')
2303 uschar *p = argrest + 1;
2306 if (i+1 < argc && isdigit((argv[i+1][0]))) p = argv[++i]; else
2308 connection_max_messages = 1;
2317 fprintf(stderr, "exim: number expected after -oB\n");
2320 connection_max_messages = Uatoi(p);
2324 /* -odb: background delivery */
2326 else if (Ustrcmp(argrest, "db") == 0)
2328 synchronous_delivery = FALSE;
2329 arg_queue_only = FALSE;
2330 queue_only_set = TRUE;
2333 /* -odf: foreground delivery (smail-compatible option); same effect as
2334 -odi: interactive (synchronous) delivery (sendmail-compatible option)
2337 else if (Ustrcmp(argrest, "df") == 0 || Ustrcmp(argrest, "di") == 0)
2339 synchronous_delivery = TRUE;
2340 arg_queue_only = FALSE;
2341 queue_only_set = TRUE;
2344 /* -odq: queue only */
2346 else if (Ustrcmp(argrest, "dq") == 0)
2348 synchronous_delivery = FALSE;
2349 arg_queue_only = TRUE;
2350 queue_only_set = TRUE;
2353 /* -odqs: queue SMTP only - do local deliveries and remote routing,
2354 but no remote delivery */
2356 else if (Ustrcmp(argrest, "dqs") == 0)
2359 arg_queue_only = FALSE;
2360 queue_only_set = TRUE;
2363 /* -oex: Sendmail error flags. As these are also accepted without the
2364 leading -o prefix, for compatibility with vacation and other callers,
2365 they are handled with -e above. */
2367 /* -oi: Set flag so dot doesn't end non-SMTP input (same as -i)
2368 -oitrue: Another sendmail syntax for the same */
2370 else if (Ustrcmp(argrest, "i") == 0 ||
2371 Ustrcmp(argrest, "itrue") == 0)
2374 /* -oM*: Set various characteristics for an incoming message; actually
2375 acted on for trusted callers only. */
2377 else if (*argrest == 'M')
2381 fprintf(stderr, "exim: data expected after -o%s\n", argrest);
2385 /* -oMa: Set sender host address */
2387 if (Ustrcmp(argrest, "Ma") == 0) sender_host_address = argv[++i];
2389 /* -oMaa: Set authenticator name */
2391 else if (Ustrcmp(argrest, "Maa") == 0)
2392 sender_host_authenticated = argv[++i];
2394 /* -oMas: setting authenticated sender */
2396 else if (Ustrcmp(argrest, "Mas") == 0) authenticated_sender = argv[++i];
2398 /* -oMai: setting authenticated id */
2400 else if (Ustrcmp(argrest, "Mai") == 0) authenticated_id = argv[++i];
2402 /* -oMi: Set incoming interface address */
2404 else if (Ustrcmp(argrest, "Mi") == 0) interface_address = argv[++i];
2406 /* -oMr: Received protocol */
2408 else if (Ustrcmp(argrest, "Mr") == 0) received_protocol = argv[++i];
2410 /* -oMs: Set sender host name */
2412 else if (Ustrcmp(argrest, "Ms") == 0) sender_host_name = argv[++i];
2414 /* -oMt: Set sender ident */
2416 else if (Ustrcmp(argrest, "Mt") == 0) sender_ident = argv[++i];
2418 /* Else a bad argument */
2427 /* -om: Me-too flag for aliases. Exim always does this. Some programs
2428 seem to call this as -m (undocumented), so that is also accepted (see
2431 else if (Ustrcmp(argrest, "m") == 0) {}
2433 /* -oo: An ancient flag for old-style addresses which still seems to
2434 crop up in some calls (see in SCO). */
2436 else if (Ustrcmp(argrest, "o") == 0) {}
2438 /* -oP <name>: set pid file path for daemon */
2440 else if (Ustrcmp(argrest, "P") == 0)
2441 override_pid_file_path = argv[++i];
2443 /* -or <n>: set timeout for non-SMTP acceptance
2444 -os <n>: set timeout for SMTP acceptance */
2446 else if (*argrest == 'r' || *argrest == 's')
2448 int *tp = (*argrest == 'r')?
2449 &arg_receive_timeout : &arg_smtp_receive_timeout;
2450 if (argrest[1] == 0)
2452 if (i+1 < argc) *tp= readconf_readtime(argv[++i], 0, FALSE);
2454 else *tp = readconf_readtime(argrest + 1, 0, FALSE);
2457 fprintf(stderr, "exim: bad time value %s: abandoned\n", argv[i]);
2462 /* -oX <list>: Override local_interfaces and/or default daemon ports */
2464 else if (Ustrcmp(argrest, "X") == 0)
2465 override_local_interfaces = argv[++i];
2467 /* Unknown -o argument */
2473 /* -ps: force Perl startup; -pd force delayed Perl startup */
2477 if (*argrest == 's' && argrest[1] == 0)
2479 perl_start_option = 1;
2482 if (*argrest == 'd' && argrest[1] == 0)
2484 perl_start_option = -1;
2489 /* -panythingelse is taken as the Sendmail-compatible argument -prval:sval,
2490 which sets the host protocol and host name */
2494 if (i+1 < argc) argrest = argv[++i]; else
2495 { badarg = TRUE; break; }
2500 uschar *hn = Ustrchr(argrest, ':');
2503 received_protocol = argrest;
2507 received_protocol = string_copyn(argrest, hn - argrest);
2508 sender_host_name = hn + 1;
2515 receiving_message = FALSE;
2517 /* -qq...: Do queue runs in a 2-stage manner */
2519 if (*argrest == 'q')
2521 queue_2stage = TRUE;
2525 /* -qi...: Do only first (initial) deliveries */
2527 if (*argrest == 'i')
2529 queue_run_first_delivery = TRUE;
2533 /* -qf...: Run the queue, forcing deliveries
2534 -qff..: Ditto, forcing thawing as well */
2536 if (*argrest == 'f')
2538 queue_run_force = TRUE;
2539 if (*(++argrest) == 'f')
2541 deliver_force_thaw = TRUE;
2546 /* -q[f][f]l...: Run the queue only on local deliveries */
2548 if (*argrest == 'l')
2550 queue_run_local = TRUE;
2554 /* -q[f][f][l]: Run the queue, optionally forced, optionally local only,
2555 optionally starting from a given message id. */
2557 if (*argrest == 0 &&
2558 (i + 1 >= argc || argv[i+1][0] == '-' || mac_ismsgid(argv[i+1])))
2561 if (i+1 < argc && mac_ismsgid(argv[i+1]))
2562 start_queue_run_id = argv[++i];
2563 if (i+1 < argc && mac_ismsgid(argv[i+1]))
2564 stop_queue_run_id = argv[++i];
2567 /* -q[f][f][l]<n>: Run the queue at regular intervals, optionally forced,
2568 optionally local only. */
2573 queue_interval = readconf_readtime(argrest, 0, FALSE);
2575 queue_interval = readconf_readtime(argv[++i], 0, FALSE);
2576 if (queue_interval <= 0)
2578 fprintf(stderr, "exim: bad time value %s: abandoned\n", argv[i]);
2585 case 'R': /* Synonymous with -qR... */
2586 receiving_message = FALSE;
2588 /* -Rf: As -R (below) but force all deliveries,
2589 -Rff: Ditto, but also thaw all frozen messages,
2590 -Rr: String is regex
2591 -Rrf: Regex and force
2592 -Rrff: Regex and force and thaw
2594 in all cases provided there are no further characters in this
2600 for (i = 0; i < sizeof(rsopts)/sizeof(uschar *); i++)
2602 if (Ustrcmp(argrest, rsopts[i]) == 0)
2604 if (i != 2) queue_run_force = TRUE;
2605 if (i >= 2) deliver_selectstring_regex = TRUE;
2606 if (i == 1 || i == 4) deliver_force_thaw = TRUE;
2607 argrest += Ustrlen(rsopts[i]);
2612 /* -R: Set string to match in addresses for forced queue run to
2613 pick out particular messages. */
2617 if (i+1 < argc) deliver_selectstring = argv[++i]; else
2619 fprintf(stderr, "exim: string expected after -R\n");
2623 else deliver_selectstring = argrest;
2624 if (queue_interval < 0) queue_interval = 0;
2628 /* -r: an obsolete synonym for -f (see above) */
2631 /* -S: Like -R but works on sender. */
2633 case 'S': /* Synonymous with -qS... */
2634 receiving_message = FALSE;
2636 /* -Sf: As -S (below) but force all deliveries,
2637 -Sff: Ditto, but also thaw all frozen messages,
2638 -Sr: String is regex
2639 -Srf: Regex and force
2640 -Srff: Regex and force and thaw
2642 in all cases provided there are no further characters in this
2648 for (i = 0; i < sizeof(rsopts)/sizeof(uschar *); i++)
2650 if (Ustrcmp(argrest, rsopts[i]) == 0)
2652 if (i != 2) queue_run_force = TRUE;
2653 if (i >= 2) deliver_selectstring_sender_regex = TRUE;
2654 if (i == 1 || i == 4) deliver_force_thaw = TRUE;
2655 argrest += Ustrlen(rsopts[i]);
2660 /* -S: Set string to match in addresses for forced queue run to
2661 pick out particular messages. */
2665 if (i+1 < argc) deliver_selectstring_sender = argv[++i]; else
2667 fprintf(stderr, "exim: string expected after -S\n");
2671 else deliver_selectstring_sender = argrest;
2672 if (queue_interval < 0) queue_interval = 0;
2675 /* -Tqt is an option that is exclusively for use by the testing suite.
2676 It is not recognized in other circumstances. It allows for the setting up
2677 of explicit "queue times" so that various warning/retry things can be
2678 tested. Otherwise variability of clock ticks etc. cause problems. */
2681 if (running_in_test_harness && Ustrcmp(argrest, "qt") == 0)
2682 fudged_queue_times = argv[++i];
2687 /* -t: Set flag to extract recipients from body of message. */
2690 if (*argrest == 0) extract_recipients = TRUE;
2692 /* -ti: Set flag to extract recipients from body of message, and also
2693 specify that dot does not end the message. */
2695 else if (Ustrcmp(argrest, "i") == 0)
2697 extract_recipients = TRUE;
2701 /* -tls-on-connect: don't wait for STARTTLS (for old clients) */
2704 else if (Ustrcmp(argrest, "ls-on-connect") == 0) tls_on_connect = TRUE;
2711 /* -U: This means "initial user submission" in sendmail, apparently. The
2712 doc claims that in future sendmail may refuse syntactically invalid
2713 messages instead of fixing them. For the moment, we just ignore it. */
2719 /* -v: verify things - this is a very low-level debugging */
2724 debug_selector |= D_v;
2725 debug_file = stderr;
2731 /* -x: AIX uses this to indicate some fancy 8-bit character stuff:
2733 The -x flag tells the sendmail command that mail from a local
2734 mail program has National Language Support (NLS) extended characters
2735 in the body of the mail item. The sendmail command can send mail with
2736 extended NLS characters across networks that normally corrupts these
2739 As Exim is 8-bit clean, it just ignores this flag. */
2742 if (*argrest != 0) badarg = TRUE;
2745 /* All other initial characters are errors */
2750 } /* End of high-level switch statement */
2752 /* Failed to recognize the option, or syntax error */
2756 fprintf(stderr, "exim abandoned: unknown, malformed, or incomplete "
2757 "option %s\n", arg);
2763 /* Arguments have been processed. Check for incompatibilities. */
2767 (smtp_input || extract_recipients || recipients_arg < argc) &&
2768 (daemon_listen || queue_interval >= 0 || bi_option ||
2769 test_retry_arg >= 0 || test_rewrite_arg >= 0 ||
2770 filter_test != NULL || (msg_action_arg > 0 && !one_msg_action))
2773 msg_action_arg > 0 &&
2774 (daemon_listen || queue_interval >= 0 || list_options || checking ||
2775 bi_option || test_retry_arg >= 0 || test_rewrite_arg >= 0)
2778 (daemon_listen || queue_interval >= 0) &&
2779 (sender_address != NULL || list_options || list_queue || checking ||
2783 daemon_listen && queue_interval == 0
2787 (checking || smtp_input || extract_recipients ||
2788 filter_test != NULL || bi_option)
2791 verify_address_mode &&
2792 (address_test_mode || smtp_input || extract_recipients ||
2793 filter_test != NULL || bi_option)
2796 address_test_mode && (smtp_input || extract_recipients ||
2797 filter_test != NULL || bi_option)
2800 smtp_input && (sender_address != NULL || filter_test != NULL ||
2804 deliver_selectstring != NULL && queue_interval < 0
2808 fprintf(stderr, "exim: incompatible command-line options or arguments\n");
2812 /* If debugging is set up, set the file and the file descriptor to pass on to
2813 child processes. It should, of course, be 2 for stderr. Also, force the daemon
2814 to run in the foreground. */
2816 if (debug_selector != 0)
2818 debug_file = stderr;
2819 debug_fd = fileno(debug_file);
2820 background_daemon = FALSE;
2821 if (running_in_test_harness) millisleep(100); /* lets caller finish */
2822 if (debug_selector != D_v) /* -v only doesn't show this */
2824 debug_printf("Exim version %s uid=%ld gid=%ld pid=%d D=%x\n",
2825 version_string, (long int)real_uid, (long int)real_gid, (int)getpid(),
2827 show_whats_supported(stderr);
2831 /* When started with root privilege, ensure that the limits on the number of
2832 open files and the number of processes (where that is accessible) are
2833 sufficiently large, or are unset, in case Exim has been called from an
2834 environment where the limits are screwed down. Not all OS have the ability to
2835 change some of these limits. */
2839 DEBUG(D_any) debug_print_ids(US"Exim has no root privilege:");
2845 #ifdef RLIMIT_NOFILE
2846 if (getrlimit(RLIMIT_NOFILE, &rlp) < 0)
2848 log_write(0, LOG_MAIN|LOG_PANIC, "getrlimit(RLIMIT_NOFILE) failed: %s",
2850 rlp.rlim_cur = rlp.rlim_max = 0;
2853 /* I originally chose 1000 as a nice big number that was unlikely to
2854 be exceeded. It turns out that some older OS have a fixed upper limit of
2857 if (rlp.rlim_cur < 1000)
2859 rlp.rlim_cur = rlp.rlim_max = 1000;
2860 if (setrlimit(RLIMIT_NOFILE, &rlp) < 0)
2862 rlp.rlim_cur = rlp.rlim_max = 256;
2863 if (setrlimit(RLIMIT_NOFILE, &rlp) < 0)
2864 log_write(0, LOG_MAIN|LOG_PANIC, "setrlimit(RLIMIT_NOFILE) failed: %s",
2871 if (getrlimit(RLIMIT_NPROC, &rlp) < 0)
2873 log_write(0, LOG_MAIN|LOG_PANIC, "getrlimit(RLIMIT_NPROC) failed: %s",
2875 rlp.rlim_cur = rlp.rlim_max = 0;
2878 #ifdef RLIM_INFINITY
2879 if (rlp.rlim_cur != RLIM_INFINITY && rlp.rlim_cur < 1000)
2881 rlp.rlim_cur = rlp.rlim_max = RLIM_INFINITY;
2883 if (rlp.rlim_cur < 1000)
2885 rlp.rlim_cur = rlp.rlim_max = 1000;
2887 if (setrlimit(RLIMIT_NPROC, &rlp) < 0)
2888 log_write(0, LOG_MAIN|LOG_PANIC, "setrlimit(RLIMIT_NPROC) failed: %s",
2894 /* Exim is normally entered as root (but some special configurations are
2895 possible that don't do this). However, it always spins off sub-processes that
2896 set their uid and gid as required for local delivery. We don't want to pass on
2897 any extra groups that root may belong to, so we want to get rid of them all at
2900 We need to obey setgroups() at this stage, before possibly giving up root
2901 privilege for a changed configuration file, but later on we might need to
2902 check on the additional groups for the admin user privilege - can't do that
2903 till after reading the config, which might specify the exim gid. Therefore,
2904 save the group list here first. */
2906 group_count = getgroups(NGROUPS_MAX, group_list);
2908 /* There is a fundamental difference in some BSD systems in the matter of
2909 groups. FreeBSD and BSDI are known to be different; NetBSD and OpenBSD are
2910 known not to be different. On the "different" systems there is a single group
2911 list, and the first entry in it is the current group. On all other versions of
2912 Unix there is a supplementary group list, which is in *addition* to the current
2913 group. Consequently, to get rid of all extraneous groups on a "standard" system
2914 you pass over 0 groups to setgroups(), while on a "different" system you pass
2915 over a single group - the current group, which is always the first group in the
2916 list. Calling setgroups() with zero groups on a "different" system results in
2917 an error return. The following code should cope with both types of system.
2919 However, if this process isn't running as root, setgroups() can't be used
2920 since you have to be root to run it, even if throwing away groups. Not being
2921 root here happens only in some unusual configurations. We just ignore the
2924 if (setgroups(0, NULL) != 0)
2926 if (setgroups(1, group_list) != 0 && !unprivileged)
2928 fprintf(stderr, "exim: setgroups() failed: %s\n", strerror(errno));
2933 /* If the configuration file name has been altered by an argument on the
2934 command line (either a new file name or a macro definition) and the caller is
2935 not root or the exim user, or if this is a filter testing run, remove any
2936 setuid privilege the program has, and run as the underlying user.
2938 If ALT_CONFIG_ROOT_ONLY is defined, the exim user is locked out of this, which
2939 severely restricts the use of -C for some purposes.
2941 Otherwise, set the real ids to the effective values (should be root unless run
2942 from inetd, which it can either be root or the exim uid, if one is configured).
2944 There is a private mechanism for bypassing some of this, in order to make it
2945 possible to test lots of configurations automatically, without having either to
2946 recompile each time, or to patch in an actual configuration file name and other
2947 values (such as the path name). If running in the test harness, pretend that
2948 configuration file changes and macro definitions haven't happened. */
2951 (config_changed || macros != NULL) && /* Config changed, and */
2952 real_uid != root_uid && /* Not root, and */
2953 #ifndef ALT_CONFIG_ROOT_ONLY /* (when not locked out) */
2954 real_uid != exim_uid && /* Not exim, and */
2956 !running_in_test_harness /* Not fudged */
2958 expansion_test /* expansion testing */
2960 filter_test != NULL) /* Filter testing */
2962 setgroups(group_count, group_list);
2963 exim_setugid(real_uid, real_gid, FALSE,
2964 US"-C, -D, -be or -bf forces real uid");
2965 removed_privilege = TRUE;
2967 /* In the normal case when Exim is called like this, stderr is available
2968 and should be used for any logging information because attempts to write
2969 to the log will usually fail. To arrange this, we unset really_exim. However,
2970 if no stderr is available there is no point - we might as well have a go
2971 at the log (if it fails, syslog will be written). */
2973 if (log_stderr != NULL) really_exim = FALSE;
2976 /* Privilege is to be retained for the moment. It may be dropped later,
2977 depending on the job that this Exim process has been asked to do. For now, set
2978 the real uid to the effective so that subsequent re-execs of Exim are done by a
2981 else exim_setugid(geteuid(), getegid(), FALSE, US"forcing real = effective");
2983 /* If testing a filter, open the file now, before wasting time doing other
2984 setups and reading the message. */
2986 if (filter_test != NULL)
2988 filter_fd = Uopen(filter_test, O_RDONLY,0);
2991 fprintf(stderr, "exim: failed to open %s: %s\n", filter_test,
2993 return EXIT_FAILURE;
2997 /* Read the main runtime configuration data; this gives up if there
2998 is a failure. It leaves the configuration file open so that the subsequent
2999 configuration data for delivery can be read if needed. */
3003 /* Handle the decoding of logging options. */
3005 decode_bits(&log_write_selector, &log_extra_selector, log_selector_string,
3006 log_options, log_options_count, US"log");
3010 debug_printf("configuration file is %s\n", config_main_filename);
3011 debug_printf("log selectors = %08x %08x\n", log_write_selector,
3012 log_extra_selector);
3015 /* If domain literals are not allowed, check the sender address that was
3016 supplied with -f. Ditto for a stripped trailing dot. */
3018 if (sender_address != NULL)
3020 if (sender_address[sender_address_domain] == '[' && !allow_domain_literals)
3022 fprintf(stderr, "exim: bad -f address \"%s\": domain literals not "
3023 "allowed\n", sender_address);
3024 return EXIT_FAILURE;
3026 if (f_end_dot && !strip_trailing_dot)
3028 fprintf(stderr, "exim: bad -f address \"%s.\": domain is malformed "
3029 "(trailing dot not allowed)\n", sender_address);
3030 return EXIT_FAILURE;
3034 /* Paranoia check of maximum lengths of certain strings. There is a check
3035 on the length of the log file path in log.c, which will come into effect
3036 if there are any calls to write the log earlier than this. However, if we
3037 get this far but the string is very long, it is better to stop now than to
3038 carry on and (e.g.) receive a message and then have to collapse. The call to
3039 log_write() from here will cause the ultimate panic collapse if the complete
3040 file name exceeds the buffer length. */
3042 if (Ustrlen(log_file_path) > 200)
3043 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3044 "log_file_path is longer than 200 chars: aborting");
3046 if (Ustrlen(pid_file_path) > 200)
3047 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3048 "pid_file_path is longer than 200 chars: aborting");
3050 if (Ustrlen(spool_directory) > 200)
3051 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3052 "spool_directory is longer than 200 chars: aborting");
3054 /* Length check on the process name given to syslog for its TAG field,
3055 which is only permitted to be 32 characters or less. See RFC 3164. */
3057 if (Ustrlen(syslog_processname) > 32)
3058 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3059 "syslog_processname is longer than 32 chars: aborting");
3061 /* In some operating systems, the environment variable TMPDIR controls where
3062 temporary files are created; Exim doesn't use these (apart from when delivering
3063 to MBX mailboxes), but called libraries such as DBM libraries may require them.
3064 If TMPDIR is found in the environment, reset it to the value defined in the
3065 TMPDIR macro, if this macro is defined. */
3070 for (p = USS environ; *p != NULL; p++)
3072 if (Ustrncmp(*p, "TMPDIR=", 7) == 0 &&
3073 Ustrcmp(*p+7, TMPDIR) != 0)
3075 uschar *newp = malloc(Ustrlen(TMPDIR) + 8);
3076 sprintf(CS newp, "TMPDIR=%s", TMPDIR);
3078 DEBUG(D_any) debug_printf("reset TMPDIR=%s in environment\n", TMPDIR);
3084 /* Timezone handling. If timezone_string is "utc", set a flag to cause all
3085 timestamps to be in UTC (gmtime() is used instead of localtime()). Otherwise,
3086 we may need to get rid of a bogus timezone setting. This can arise when Exim is
3087 called by a user who has set the TZ variable. This then affects the timestamps
3088 in log files and in Received: headers, and any created Date: header lines. The
3089 required timezone is settable in the configuration file, so nothing can be done
3090 about this earlier - but hopefully nothing will normally be logged earlier than
3091 this. We have to make a new environment if TZ is wrong, but don't bother if
3092 timestamps_utc is set, because then all times are in UTC anyway. */
3094 if (timezone_string != NULL && strcmpic(timezone_string, US"UTC") == 0)
3096 timestamps_utc = TRUE;
3100 uschar *envtz = US getenv("TZ");
3101 if ((envtz == NULL && timezone_string != NULL) ||
3103 (timezone_string == NULL ||
3104 Ustrcmp(timezone_string, envtz) != 0)))
3106 uschar **p = USS environ;
3110 while (*p++ != NULL) count++;
3111 if (envtz == NULL) count++;
3112 newp = new = malloc(sizeof(uschar *) * (count + 1));
3113 for (p = USS environ; *p != NULL; p++)
3115 if (Ustrncmp(*p, "TZ=", 3) == 0) continue;
3118 if (timezone_string != NULL)
3120 *newp = malloc(Ustrlen(timezone_string) + 4);
3121 sprintf(CS *newp++, "TZ=%s", timezone_string);
3126 DEBUG(D_any) debug_printf("Reset TZ to %s: time is %s\n", timezone_string,
3127 tod_stamp(tod_log));
3131 /* Handle the case when we have removed the setuid privilege because of -C or
3132 -D. This means that the caller of Exim was not root, and, provided that
3133 ALT_CONFIG_ROOT_ONLY is not defined, was not the Exim user that is built into
3136 If ALT_CONFIG_ROOT_ONLY is not defined, there is a problem if it turns out we
3137 were running as the exim user defined in the configuration file (different to
3138 the one in the binary). The sysadmin may expect this case to retain privilege
3139 because "the binary was called by the Exim user", but it hasn't, because of the
3140 order in which it handles this stuff. There are two possibilities:
3142 (1) If deliver_drop_privilege is set, Exim is not going to re-exec in order
3143 to do message deliveries. Thus, the fact that it is running as a
3144 non-privileged user is plausible, and might be wanted in some special
3145 configurations. However, really_exim will have been set false when
3146 privilege was dropped, to stop Exim trying to write to its normal log
3147 files. Therefore, re-enable normal log processing, assuming the sysadmin
3148 has set up the log directory correctly.
3150 (2) If deliver_drop_privilege is not set, the configuration won't work as
3151 apparently intended, and so we log a panic message. In order to retain
3152 root for -C or -D, the caller must either be root or the Exim user
3153 defined in the binary (when deliver_drop_ privilege is false).
3155 If ALT_CONFIG_ROOT_ONLY is defined, we don't know whether we were called by the
3156 built-in exim user or one defined in the configuration. In either event,
3157 re-enable log processing, assuming the sysadmin knows what they are doing. */
3159 if (removed_privilege && (config_changed || macros != NULL) &&
3160 real_uid == exim_uid)
3162 #ifdef ALT_CONFIG_ROOT_ONLY
3163 really_exim = TRUE; /* let logging work normally */
3166 if (deliver_drop_privilege)
3167 really_exim = TRUE; /* let logging work normally */
3169 log_write(0, LOG_MAIN|LOG_PANIC,
3170 "exim user (uid=%d) is defined only at runtime; privilege lost for %s",
3171 (int)exim_uid, config_changed? "-C" : "-D");
3175 /* Start up Perl interpreter if Perl support is configured and there is a
3176 perl_startup option, and the configuration or the command line specifies
3177 initializing starting. Note that the global variables are actually called
3178 opt_perl_xxx to avoid clashing with perl's namespace (perl_*). */
3181 if (perl_start_option != 0)
3182 opt_perl_at_start = (perl_start_option > 0);
3183 if (opt_perl_at_start && opt_perl_startup != NULL)
3186 DEBUG(D_any) debug_printf("Starting Perl interpreter\n");
3187 errstr = init_perl(opt_perl_startup);
3190 fprintf(stderr, "exim: error in perl_startup code: %s\n", errstr);
3191 return EXIT_FAILURE;
3193 opt_perl_started = TRUE;
3195 #endif /* EXIM_PERL */
3197 /* Log the arguments of the call if the configuration file said so. This is
3198 a debugging feature for finding out what arguments certain MUAs actually use.
3199 Don't attempt it if logging is disabled, or if listing variables or if
3200 verifying/testing addresses or expansions. */
3202 if ((log_extra_selector & LX_arguments) != 0 && really_exim
3203 && !list_options && !checking)
3206 uschar *p = big_buffer;
3208 (void)getcwd(CS p+4, big_buffer_size - 4);
3210 (void)string_format(p, big_buffer_size - (p - big_buffer), " %d args:", argc);
3212 for (i = 0; i < argc; i++)
3214 int len = Ustrlen(argv[i]);
3217 if (p + len + 8 >= big_buffer + big_buffer_size)
3220 log_write(0, LOG_MAIN, "%s", big_buffer);
3221 Ustrcpy(big_buffer, "...");
3224 printing = string_printing(argv[i]);
3225 if (printing[0] == 0) quote = US"\""; else
3227 uschar *pp = printing;
3229 while (*pp != 0) if (isspace(*pp++)) { quote = US"\""; break; }
3231 sprintf(CS p, " %s%.*s%s", quote, (int)(big_buffer_size -
3232 (p - big_buffer) - 4), printing, quote);
3235 log_write(0, LOG_MAIN, "%s", big_buffer);
3238 /* Set the working directory to be the top-level spool directory. We don't rely
3239 on this in the code, which always uses fully qualified names, but it's useful
3240 for core dumps etc. Don't complain if it fails - the spool directory might not
3241 be generally accessible and calls with the -C option (and others) have lost
3242 privilege by now. */
3244 if (Uchdir(spool_directory) != 0)
3246 (void)directory_make(spool_directory, US"", SPOOL_DIRECTORY_MODE, TRUE);
3247 (void)Uchdir(spool_directory);
3250 /* Handle calls with the -bi option. This is a sendmail option to rebuild *the*
3251 alias file. Exim doesn't have such a concept, but this call is screwed into
3252 Sun's YP makefiles. Handle this by calling a configured script, as the real
3253 user who called Exim. The -oA option can be used to pass an argument to the
3258 fclose(config_file);
3259 if (bi_command != NULL)
3263 argv[i++] = bi_command;
3264 if (alias_arg != NULL) argv[i++] = alias_arg;
3267 setgroups(group_count, group_list);
3268 exim_setugid(real_uid, real_gid, FALSE, US"running bi_command");
3270 DEBUG(D_exec) debug_printf("exec %.256s %.256s\n", argv[0],
3271 (argv[1] == NULL)? US"" : argv[1]);
3273 execv(CS argv[0], (char *const *)argv);
3274 fprintf(stderr, "exim: exec failed: %s\n", strerror(errno));
3279 DEBUG(D_any) debug_printf("-bi used but bi_command not set; exiting\n");
3284 /* If an action on specific messages is requested, or if a daemon or queue
3285 runner is being started, we need to know if Exim was called by an admin user.
3286 This is the case if the real user is root or exim, or if the real group is
3287 exim, or if one of the supplementary groups is exim or a group listed in
3288 admin_groups. We don't fail all message actions immediately if not admin_user,
3289 since some actions can be performed by non-admin users. Instead, set admin_user
3290 for later interrogation. */
3292 if (real_uid == root_uid || real_uid == exim_uid || real_gid == exim_gid)
3298 for (i = 0; i < group_count; i++)
3300 if (group_list[i] == exim_gid) admin_user = TRUE;
3301 else if (admin_groups != NULL)
3303 for (j = 1; j <= (int)(admin_groups[0]); j++)
3304 if (admin_groups[j] == group_list[i])
3305 { admin_user = TRUE; break; }
3307 if (admin_user) break;
3311 /* Another group of privileged users are the trusted users. These are root,
3312 exim, and any caller matching trusted_users or trusted_groups. Trusted callers
3313 are permitted to specify sender_addresses with -f on the command line, and
3314 other message parameters as well. */
3316 if (real_uid == root_uid || real_uid == exim_uid)
3317 trusted_caller = TRUE;
3322 if (trusted_users != NULL)
3324 for (i = 1; i <= (int)(trusted_users[0]); i++)
3325 if (trusted_users[i] == real_uid)
3326 { trusted_caller = TRUE; break; }
3329 if (!trusted_caller && trusted_groups != NULL)
3331 for (i = 1; i <= (int)(trusted_groups[0]); i++)
3333 if (trusted_groups[i] == real_gid)
3334 trusted_caller = TRUE;
3335 else for (j = 0; j < group_count; j++)
3337 if (trusted_groups[i] == group_list[j])
3338 { trusted_caller = TRUE; break; }
3340 if (trusted_caller) break;
3345 if (trusted_caller) DEBUG(D_any) debug_printf("trusted user\n");
3346 if (admin_user) DEBUG(D_any) debug_printf("admin user\n");
3348 /* Only an admin user may start the daemon or force a queue run in the default
3349 configuration, but the queue run restriction can be relaxed. Only an admin
3350 user may request that a message be returned to its sender forthwith. Only an
3351 admin user may specify a debug level greater than D_v (because it might show
3352 passwords, etc. in lookup queries). Only an admin user may request a queue
3357 BOOL debugset = (debug_selector & ~D_v) != 0;
3358 if (deliver_give_up || daemon_listen ||
3359 (count_queue && queue_list_requires_admin) ||
3360 (list_queue && queue_list_requires_admin) ||
3361 (queue_interval >= 0 && prod_requires_admin) ||
3362 (debugset && !running_in_test_harness))
3364 fprintf(stderr, "exim:%s permission denied\n", debugset? " debugging" : "");
3369 /* If the real user is not root or the exim uid, the argument for passing
3370 in an open TCP/IP connection for another message is not permitted, nor is
3371 running with the -N option for any delivery action, unless this call to exim is
3372 one that supplied an input message, or we are using a patched exim for
3373 regression testing. */
3375 if (real_uid != root_uid && real_uid != exim_uid &&
3376 (continue_hostname != NULL ||
3378 (queue_interval >= 0 || daemon_listen || msg_action_arg > 0)
3379 )) && !running_in_test_harness)
3381 fprintf(stderr, "exim: Permission denied\n");
3382 return EXIT_FAILURE;
3385 /* If the caller is not trusted, certain arguments are ignored when running for
3386 real, but are permitted when checking things (-be, -bv, -bt, -bh, -bf). Note
3387 that authority for performing certain actions on messages is tested in the
3388 queue_action() function. */
3390 if (!trusted_caller && !checking && filter_test == NULL)
3392 sender_host_name = sender_host_address = interface_address =
3393 sender_ident = received_protocol = NULL;
3394 sender_host_port = interface_port = 0;
3395 sender_host_authenticated = authenticated_sender = authenticated_id = NULL;
3398 /* If a sender host address is set, extract the optional port number off the
3399 end of it and check its syntax. Do the same thing for the interface address.
3400 Exim exits if the syntax is bad. */
3404 if (sender_host_address != NULL)
3405 sender_host_port = check_port(sender_host_address);
3406 if (interface_address != NULL)
3407 interface_port = check_port(interface_address);
3410 /* If an SMTP message is being received check to see if the standard input is a
3411 TCP/IP socket. If it is, we assume that Exim was called from inetd if the
3412 caller is root or the Exim user, or if the port is a privileged one. Otherwise,
3417 union sockaddr_46 inetd_sock;
3418 SOCKLEN_T size = sizeof(inetd_sock);
3419 if (getpeername(0, (struct sockaddr *)(&inetd_sock), &size) == 0)
3421 int family = ((struct sockaddr *)(&inetd_sock))->sa_family;
3422 if (family == AF_INET || family == AF_INET6)
3424 union sockaddr_46 interface_sock;
3425 size = sizeof(interface_sock);
3427 if (getsockname(0, (struct sockaddr *)(&interface_sock), &size) == 0)
3428 interface_address = host_ntoa(-1, &interface_sock, NULL,
3431 if (host_is_tls_on_connect_port(interface_port)) tls_on_connect = TRUE;
3433 if (real_uid == root_uid || real_uid == exim_uid || interface_port < 1024)
3436 sender_host_address = host_ntoa(-1, (struct sockaddr *)(&inetd_sock),
3437 NULL, &sender_host_port);
3438 if (mua_wrapper) log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Input from "
3439 "inetd is not supported when mua_wrapper is set");
3444 "exim: Permission denied (unprivileged user, unprivileged port)\n");
3445 return EXIT_FAILURE;
3451 /* If the load average is going to be needed while receiving a message, get it
3452 now for those OS that require the first call to os_getloadavg() to be done as
3453 root. There will be further calls later for each message received. */
3455 #ifdef LOAD_AVG_NEEDS_ROOT
3456 if (receiving_message &&
3457 (queue_only_load >= 0 ||
3458 (is_inetd && smtp_load_reserve >= 0)
3461 load_average = os_getloadavg();
3465 /* The queue_only configuration option can be overridden by -odx on the command
3466 line, except that if queue_only_override is false, queue_only cannot be unset
3467 from the command line. */
3469 if (queue_only_set && (queue_only_override || arg_queue_only))
3470 queue_only = arg_queue_only;
3472 /* The receive_timeout and smtp_receive_timeout options can be overridden by
3475 if (arg_receive_timeout >= 0) receive_timeout = arg_receive_timeout;
3476 if (arg_smtp_receive_timeout >= 0)
3477 smtp_receive_timeout = arg_smtp_receive_timeout;
3479 /* If Exim was started with root privilege, unless we have already removed the
3480 root privilege above as a result of -C, -D, -be, -bf or -bF, remove it now
3481 except when starting the daemon or doing some kind of delivery or address
3482 testing (-bt). These are the only cases when root need to be retained. We run
3483 as exim for -bv and -bh. However, if deliver_drop_privilege is set, root is
3484 retained only for starting the daemon. */
3486 if (!unprivileged && /* originally had root AND */
3487 !removed_privilege && /* still got root AND */
3488 !daemon_listen && /* not starting the daemon */
3489 queue_interval <= 0 && /* (either kind of daemon) */
3491 deliver_drop_privilege || /* requested unprivileged */
3493 queue_interval < 0 && /* not running the queue */
3494 (msg_action_arg < 0 || /* and */
3495 msg_action != MSG_DELIVER) && /* not delivering and */
3496 (!checking || !address_test_mode) /* not address checking */
3500 exim_setugid(exim_uid, exim_gid, FALSE, US"privilege not needed");
3503 /* When we are retaining a privileged uid, we still change to the exim gid. */
3505 else setgid(exim_gid);
3507 /* Handle a request to list the delivery queue */
3511 set_process_info("listing the queue");
3512 queue_list(list_queue_option, argv + recipients_arg, argc - recipients_arg);
3516 /* Handle a request to count the delivery queue */
3520 set_process_info("counting the queue");
3525 /* Handle actions on specific messages, except for the force delivery action,
3526 which is done below. Some actions take a whole list of message ids, which
3527 are known to continue up to the end of the arguments. Others take a single
3528 message id and then operate on the recipients list. */
3530 if (msg_action_arg > 0 && msg_action != MSG_DELIVER)
3532 int yield = EXIT_SUCCESS;
3533 set_process_info("acting on specified messages");
3535 if (!one_msg_action)
3537 for (i = msg_action_arg; i < argc; i++)
3538 if (!queue_action(argv[i], msg_action, NULL, 0, 0))
3539 yield = EXIT_FAILURE;
3542 else if (!queue_action(argv[msg_action_arg], msg_action, argv, argc,
3543 recipients_arg)) yield = EXIT_FAILURE;
3547 /* All the modes below here require the remaining configuration sections
3548 to be read, except that we can skip over the ACL setting when delivering
3549 specific messages, or doing a queue run. (For various testing cases we could
3550 skip too, but as they are rare, it doesn't really matter.) The argument is TRUE
3553 readconf_rest(msg_action_arg > 0 || (queue_interval == 0 && !daemon_listen));
3555 /* The configuration data will have been read into POOL_PERM because we won't
3556 ever want to reset back past it. Change the current pool to POOL_MAIN. In fact,
3557 this is just a bit of pedantic tidiness. It wouldn't really matter if the
3558 configuration were read into POOL_MAIN, because we don't do any resets till
3559 later on. However, it seems right, and it does ensure that both pools get used.
3562 store_pool = POOL_MAIN;
3564 /* Handle the -brt option. This is for checking out retry configurations.
3565 The next three arguments are a domain name or a complete address, and
3566 optionally two error numbers. All it does is to call the function that
3567 scans the retry configuration data. */
3569 if (test_retry_arg >= 0)
3571 retry_config *yield;
3572 int basic_errno = 0;
3576 if (test_retry_arg >= argc)
3578 printf("-brt needs a domain or address argument\n");
3579 exim_exit(EXIT_FAILURE);
3581 s1 = argv[test_retry_arg++];
3584 /* If the first argument contains no @ and no . it might be a local user
3585 or it might be a single-component name. Treat as a domain. */
3587 if (Ustrchr(s1, '@') == NULL && Ustrchr(s1, '.') == NULL)
3589 printf("Warning: \"%s\" contains no '@' and no '.' characters. It is "
3590 "being \ntreated as a one-component domain, not as a local part.\n\n",
3594 /* There may be an optional second domain arg. */
3596 if (test_retry_arg < argc && Ustrchr(argv[test_retry_arg], '.') != NULL)
3597 s2 = argv[test_retry_arg++];
3599 /* The final arg is an error name */
3601 if (test_retry_arg < argc)
3603 uschar *ss = argv[test_retry_arg];
3605 readconf_retry_error(ss, ss + Ustrlen(ss), &basic_errno, &more_errno);
3608 printf("%s\n", CS error);
3609 return EXIT_FAILURE;
3612 /* For the rcpt_4xx errors, a value of 255 means "any", and a code > 100 as
3613 an error is for matching codes to the decade. Turn them into a real error
3614 code, off the decade. */
3616 if (basic_errno == ERRNO_RCPT4XX)
3618 int code = (more_errno >> 8) & 255;
3620 more_errno = (more_errno & 0xffff00ff) | (21 << 8);
3621 else if (code > 100)
3622 more_errno = (more_errno & 0xffff00ff) | ((code - 96) << 8);
3626 yield = retry_find_config(s1, s2, basic_errno, more_errno);
3627 if (yield == NULL) printf("No retry information found\n"); else
3630 more_errno = yield->more_errno;
3631 printf("Retry rule: %s ", yield->pattern);
3633 if (yield->basic_errno == ERRNO_EXIMQUOTA)
3635 printf("quota%s%s ",
3636 (more_errno > 0)? "_" : "",
3637 (more_errno > 0)? readconf_printtime(more_errno) : US"");
3639 else if (yield->basic_errno == ECONNREFUSED)
3641 printf("refused%s%s ",
3642 (more_errno > 0)? "_" : "",
3643 (more_errno == 'M')? "MX" :
3644 (more_errno == 'A')? "A" : "");
3646 else if (yield->basic_errno == ETIMEDOUT)
3649 if ((more_errno & RTEF_CTOUT) != 0) printf("_connect");
3651 if (more_errno != 0) printf("_%s",
3652 (more_errno == 'M')? "MX" : "A");
3655 else if (yield->basic_errno == ERRNO_AUTHFAIL)
3656 printf("auth_failed ");
3659 for (r = yield->rules; r != NULL; r = r->next)
3661 printf("%c,%s", r->rule, readconf_printtime(r->timeout)); /* Do not */
3662 printf(",%s", readconf_printtime(r->p1)); /* amalgamate */
3668 printf(",%d.", x/1000);
3682 exim_exit(EXIT_SUCCESS);
3685 /* Handle a request to list one or more configuration options */
3689 set_process_info("listing variables");
3690 if (recipients_arg >= argc) readconf_print(US"all", NULL);
3691 else for (i = recipients_arg; i < argc; i++)
3694 (Ustrcmp(argv[i], "router") == 0 ||
3695 Ustrcmp(argv[i], "transport") == 0 ||
3696 Ustrcmp(argv[i], "authenticator") == 0))
3698 readconf_print(argv[i+1], argv[i]);
3701 else readconf_print(argv[i], NULL);
3703 exim_exit(EXIT_SUCCESS);
3707 /* Handle a request to deliver one or more messages that are already on the
3708 queue. Values of msg_action other than MSG_DELIVER are dealt with above. This
3709 is typically used for a small number when prodding by hand (when the option
3710 forced_delivery will be set) or when re-execing to regain root privilege.
3711 Each message delivery must happen in a separate process, so we fork a process
3712 for each one, and run them sequentially so that debugging output doesn't get
3713 intertwined, and to avoid spawning too many processes if a long list is given.
3714 However, don't fork for the last one; this saves a process in the common case
3715 when Exim is called to deliver just one message. */
3717 if (msg_action_arg > 0)
3719 if (prod_requires_admin && !admin_user)
3721 fprintf(stderr, "exim: Permission denied\n");
3722 exim_exit(EXIT_FAILURE);
3724 set_process_info("delivering specified messages");
3725 if (deliver_give_up) forced_delivery = deliver_force_thaw = TRUE;
3726 for (i = msg_action_arg; i < argc; i++)
3731 (void)deliver_message(argv[i], forced_delivery, deliver_give_up);
3732 else if ((pid = fork()) == 0)
3734 (void)deliver_message(argv[i], forced_delivery, deliver_give_up);
3735 _exit(EXIT_SUCCESS);
3739 fprintf(stderr, "failed to fork delivery process for %s: %s\n", argv[i],
3741 exim_exit(EXIT_FAILURE);
3745 exim_exit(EXIT_SUCCESS);
3749 /* If only a single queue run is requested, without SMTP listening, we can just
3750 turn into a queue runner, with an optional starting message id. */
3752 if (queue_interval == 0 && !daemon_listen)
3754 DEBUG(D_queue_run) debug_printf("Single queue run%s%s%s%s\n",
3755 (start_queue_run_id == NULL)? US"" : US" starting at ",
3756 (start_queue_run_id == NULL)? US"" : start_queue_run_id,
3757 (stop_queue_run_id == NULL)? US"" : US" stopping at ",
3758 (stop_queue_run_id == NULL)? US"" : stop_queue_run_id);
3759 set_process_info("running the queue (single queue run)");
3760 queue_run(start_queue_run_id, stop_queue_run_id, FALSE);
3761 exim_exit(EXIT_SUCCESS);
3765 /* Find the login name of the real user running this process. This is always
3766 needed when receiving a message, because it is written into the spool file. It
3767 may also be used to construct a from: or a sender: header, and in this case we
3768 need the user's full name as well, so save a copy of it, checked for RFC822
3769 syntax and munged if necessary, if it hasn't previously been set by the -F
3770 argument. We may try to get the passwd entry more than once, in case NIS or
3771 other delays are in evidence. Save the home directory for use in filter testing
3776 if ((pw = getpwuid(real_uid)) != NULL)
3778 originator_login = string_copy(US pw->pw_name);
3779 originator_home = string_copy(US pw->pw_dir);
3781 /* If user name has not been set by -F, set it from the passwd entry
3782 unless -f has been used to set the sender address by a trusted user. */
3784 if (originator_name == NULL)
3786 if (sender_address == NULL ||
3787 (!trusted_caller && filter_test == NULL))
3789 uschar *name = US pw->pw_gecos;
3790 uschar *amp = Ustrchr(name, '&');
3793 /* Most Unix specify that a '&' character in the gecos field is
3794 replaced by a copy of the login name, and some even specify that
3795 the first character should be upper cased, so that's what we do. */
3800 string_format(buffer, sizeof(buffer), "%.*s%n%s%s",
3801 amp - name, name, &loffset, originator_login, amp + 1);
3802 buffer[loffset] = toupper(buffer[loffset]);
3806 /* If a pattern for matching the gecos field was supplied, apply
3807 it and then expand the name string. */
3809 if (gecos_pattern != NULL && gecos_name != NULL)
3812 re = regex_must_compile(gecos_pattern, FALSE, TRUE); /* Use malloc */
3814 if (regex_match_and_setup(re, name, 0, -1))
3816 uschar *new_name = expand_string(gecos_name);
3818 if (new_name != NULL)
3820 DEBUG(D_receive) debug_printf("user name \"%s\" extracted from "
3821 "gecos field \"%s\"\n", new_name, name);
3824 else DEBUG(D_receive) debug_printf("failed to expand gecos_name string "
3825 "\"%s\": %s\n", gecos_name, expand_string_message);
3827 else DEBUG(D_receive) debug_printf("gecos_pattern \"%s\" did not match "
3828 "gecos field \"%s\"\n", gecos_pattern, name);
3829 store_free((void *)re);
3831 originator_name = string_copy(name);
3834 /* A trusted caller has used -f but not -F */
3836 else originator_name = US"";
3839 /* Break the retry loop */
3844 if (++i > finduser_retries) break;
3848 /* If we cannot get a user login, log the incident and give up, unless the
3849 configuration specifies something to use. When running in the test harness,
3850 any setting of unknown_login overrides the actual login name. */
3852 if (originator_login == NULL || running_in_test_harness)
3854 if (unknown_login != NULL)
3856 originator_login = expand_string(unknown_login);
3857 if (originator_name == NULL && unknown_username != NULL)
3858 originator_name = expand_string(unknown_username);
3859 if (originator_name == NULL) originator_name = US"";
3861 if (originator_login == NULL)
3862 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Failed to get user name for uid %d",
3866 /* Ensure that the user name is in a suitable form for use as a "phrase" in an
3869 originator_name = string_copy(parse_fix_phrase(originator_name,
3870 Ustrlen(originator_name), big_buffer, big_buffer_size));
3872 /* If a message is created by this call of Exim, the uid/gid of its originator
3873 are those of the caller. These values are overridden if an existing message is
3874 read in from the spool. */
3876 originator_uid = real_uid;
3877 originator_gid = real_gid;
3879 DEBUG(D_receive) debug_printf("originator: uid=%d gid=%d login=%s name=%s\n",
3880 (int)originator_uid, (int)originator_gid, originator_login, originator_name);
3882 /* Run in daemon and/or queue-running mode. The function daemon_go() never
3883 returns. We leave this till here so that the originator_ fields are available
3884 for incoming messages via the daemon. */
3886 if (daemon_listen || queue_interval > 0)
3888 if (mua_wrapper) log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Daemon cannot be "
3889 "run when mua_wrapper is set");
3893 /* If the sender ident has not been set (by a trusted caller) set it to
3894 the caller. This will get overwritten below for an inetd call. If a trusted
3895 caller has set it empty, unset it. */
3897 if (sender_ident == NULL) sender_ident = originator_login;
3898 else if (sender_ident[0] == 0) sender_ident = NULL;
3900 /* Handle the -brw option, which is for checking out rewriting rules. Cause log
3901 writes (on errors) to go to stderr instead. Can't do this earlier, as want the
3902 originator_* variables set. */
3904 if (test_rewrite_arg >= 0)
3906 really_exim = FALSE;
3907 if (test_rewrite_arg >= argc)
3909 printf("-brw needs an address argument\n");
3910 exim_exit(EXIT_FAILURE);
3912 rewrite_test(argv[test_rewrite_arg]);
3913 exim_exit(EXIT_SUCCESS);
3916 /* A locally-supplied message is considered to be coming from a local user
3917 unless a trusted caller supplies a sender address with -f, or is passing in the
3918 message via SMTP (inetd invocation or otherwise). */
3920 if ((sender_address == NULL && !smtp_input) ||
3921 (!trusted_caller && filter_test == NULL))
3923 sender_local = TRUE;
3925 /* A trusted caller can supply authenticated_sender and authenticated_id
3926 via -oMas and -oMai and if so, they will already be set. */
3928 if (authenticated_sender == NULL)
3929 authenticated_sender = string_sprintf("%s@%s", originator_login,
3930 qualify_domain_sender);
3931 if (authenticated_id == NULL) authenticated_id = originator_login;
3934 /* Trusted callers are always permitted to specify the sender address.
3935 Untrusted callers may specify it if it matches untrusted_set_sender, or if what
3936 is specified is the empty address. However, if a trusted caller does not
3937 specify a sender address for SMTP input, we leave sender_address unset. This
3938 causes the MAIL commands to be honoured. */
3940 if ((!smtp_input && sender_address == NULL) ||
3941 !receive_check_set_sender(sender_address))
3943 /* Either the caller is not permitted to set a general sender, or this is
3944 non-SMTP input and the trusted caller has not set a sender. If there is no
3945 sender, or if a sender other than <> is set, override with the originator's
3946 login (which will get qualified below), except when checking things. */
3948 if (sender_address == NULL /* No sender_address set */
3950 (sender_address[0] != 0 && /* Non-empty sender address, AND */
3951 !checking && /* Not running tests, AND */
3952 filter_test == NULL)) /* Not testing a filter */
3954 sender_address = originator_login;
3955 sender_address_forced = FALSE;
3956 sender_address_domain = 0;
3960 /* Remember whether an untrusted caller set the sender address */
3962 sender_set_untrusted = sender_address != originator_login && !trusted_caller;
3964 /* Ensure that the sender address is fully qualified unless it is the empty
3965 address, which indicates an error message, or doesn't exist (root caller, smtp
3966 interface, no -f argument). */
3968 if (sender_address != NULL && sender_address[0] != 0 &&
3969 sender_address_domain == 0)
3970 sender_address = string_sprintf("%s@%s", local_part_quote(sender_address),
3971 qualify_domain_sender);
3973 DEBUG(D_receive) debug_printf("sender address = %s\n", sender_address);
3975 /* Handle a request to verify a list of addresses, or test them for delivery.
3976 This must follow the setting of the sender address, since routers can be
3977 predicated upon the sender. If no arguments are given, read addresses from
3978 stdin. Set debug_level to at least D_v to get full output for address testing.
3981 if (verify_address_mode || address_test_mode)
3984 int flags = vopt_qualify;
3986 if (verify_address_mode)
3988 if (!verify_as_sender) flags |= vopt_is_recipient;
3989 DEBUG(D_verify) debug_print_ids(US"Verifying:");
3994 flags |= vopt_is_recipient;
3995 debug_selector |= D_v;
3996 debug_file = stderr;
3997 debug_fd = fileno(debug_file);
3998 DEBUG(D_verify) debug_print_ids(US"Address testing:");
4001 if (recipients_arg < argc)
4003 while (recipients_arg < argc)
4005 uschar *s = argv[recipients_arg++];
4008 BOOL finished = FALSE;
4009 uschar *ss = parse_find_address_end(s, FALSE);
4010 if (*ss == ',') *ss = 0; else finished = TRUE;
4011 test_address(s, flags, &exit_value);
4014 while (*(++s) != 0 && (*s == ',' || isspace(*s)));
4021 uschar *s = get_stdinput(NULL, NULL);
4022 if (s == NULL) break;
4023 test_address(s, flags, &exit_value);
4027 exim_exit(exit_value);
4030 /* Handle expansion checking */
4034 if (recipients_arg < argc)
4036 while (recipients_arg < argc)
4038 uschar *s = argv[recipients_arg++];
4039 uschar *ss = expand_string(s);
4041 printf ("Failed: %s\n", expand_string_message);
4042 else printf("%s\n", CS ss);
4050 char *(*fn_readline)(char *) = NULL;
4051 char *(*fn_addhist)(char *) = NULL;
4054 void *dlhandle = set_readline(&fn_readline, &fn_addhist);
4060 uschar *source = get_stdinput(fn_readline, fn_addhist);
4061 if (source == NULL) break;
4062 ss = expand_string(source);
4064 printf ("Failed: %s\n", expand_string_message);
4065 else printf("%s\n", CS ss);
4069 if (dlhandle != NULL) dlclose(dlhandle);
4073 exim_exit(EXIT_SUCCESS);
4077 /* The active host name is normally the primary host name, but it can be varied
4078 for hosts that want to play several parts at once. We need to ensure that it is
4079 set for host checking, and for receiving messages. */
4081 smtp_active_hostname = primary_hostname;
4082 if (raw_active_hostname != NULL)
4084 uschar *nah = expand_string(raw_active_hostname);
4087 if (!expand_string_forcedfail)
4088 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to expand \"%s\" "
4089 "(smtp_active_hostname): %s", raw_active_hostname,
4090 expand_string_message);
4092 else if (nah[0] != 0) smtp_active_hostname = nah;
4095 /* Handle host checking: this facility mocks up an incoming SMTP call from a
4096 given IP address so that the blocking and relay configuration can be tested. An
4097 RFC 1413 call is made only if we are running in the test harness and an
4098 incoming interface and both ports are specified, because there is no TCP/IP
4099 call to find the ident for. */
4106 sender_ident = NULL;
4107 if (running_in_test_harness && sender_host_port != 0 &&
4108 interface_address != NULL && interface_port != 0)
4109 verify_get_ident(1413);
4111 /* In case the given address is a non-canonical IPv6 address, canonicize
4112 it. The code works for both IPv4 and IPv6, as it happens. */
4114 size = host_aton(sender_host_address, x);
4115 sender_host_address = store_get(48); /* large enough for full IPv6 */
4116 (void)host_nmtoa(size, x, -1, sender_host_address, ':');
4118 /* Now set up for testing */
4120 host_build_sender_fullhost();
4124 sender_local = FALSE;
4125 sender_host_notsocket = TRUE;
4126 debug_file = stderr;
4127 debug_fd = fileno(debug_file);
4128 fprintf(stdout, "\n**** SMTP testing session as if from host %s\n"
4129 "**** but without any ident (RFC 1413) callback.\n"
4130 "**** This is not for real!\n\n",
4131 sender_host_address);
4133 if (verify_check_host(&hosts_connection_nolog) == OK)
4134 log_write_selector &= ~L_smtp_connection;
4135 log_write(L_smtp_connection, LOG_MAIN, "%s", smtp_get_connection_info());
4137 if (smtp_start_session())
4139 reset_point = store_get(0);
4142 store_reset(reset_point);
4143 if (smtp_setup_msg() <= 0) break;
4144 if (!receive_msg(FALSE)) break;
4147 exim_exit(EXIT_SUCCESS);
4151 /* Arrange for message reception if recipients or SMTP were specified;
4152 otherwise complain unless a version print (-bV) happened or this is a filter
4153 verification test. In the former case, show the configuration file name. */
4155 if (recipients_arg >= argc && !extract_recipients && !smtp_input)
4157 if (version_printed)
4159 printf("Configuration file is %s\n", config_main_filename);
4160 return EXIT_SUCCESS;
4162 if (filter_test == NULL)
4165 "Exim is a Mail Transfer Agent. It is normally called by Mail User Agents,\n"
4166 "not directly from a shell command line. Options and/or arguments control\n"
4167 "what it does when called. For a list of options, see the Exim documentation.\n");
4168 return EXIT_FAILURE;
4173 /* If mua_wrapper is set, Exim is being used to turn an MUA that submits on the
4174 standard input into an MUA that submits to a smarthost over TCP/IP. We know
4175 that we are not called from inetd, because that is rejected above. The
4176 following configuration settings are forced here:
4178 (1) Synchronous delivery (-odi)
4179 (2) Errors to stderr (-oep == -oeq)
4180 (3) No parallel remote delivery
4181 (4) Unprivileged delivery
4183 We don't force overall queueing options because there are several of them;
4184 instead, queueing is avoided below when mua_wrapper is set. However, we do need
4185 to override any SMTP queueing. */
4189 synchronous_delivery = TRUE;
4190 arg_error_handling = ERRORS_STDERR;
4191 remote_max_parallel = 1;
4192 deliver_drop_privilege = TRUE;
4194 queue_smtp_domains = NULL;
4198 /* Prepare to accept one or more new messages on the standard input. When a
4199 message has been read, its id is returned in message_id[]. If doing immediate
4200 delivery, we fork a delivery process for each received message, except for the
4201 last one, where we can save a process switch.
4203 It is only in non-smtp mode that error_handling is allowed to be changed from
4204 its default of ERRORS_SENDER by argument. (Idle thought: are any of the
4205 sendmail error modes other than -oem ever actually used? Later: yes.) */
4207 if (!smtp_input) error_handling = arg_error_handling;
4209 /* If this is an inetd call, ensure that stderr is closed to prevent panic
4210 logging being sent down the socket and make an identd call to get the
4216 exim_nullstd(); /* Re-open to /dev/null */
4217 verify_get_ident(IDENT_PORT);
4218 host_build_sender_fullhost();
4219 set_process_info("handling incoming connection from %s via inetd",
4223 /* If the sender host address has been set, build sender_fullhost if it hasn't
4224 already been done (which it will have been for inetd). This caters for the
4225 case when it is forced by -oMa. However, we must flag that it isn't a socket,
4226 so that the test for IP options is skipped for -bs input. */
4228 if (sender_host_address != NULL && sender_fullhost == NULL)
4230 host_build_sender_fullhost();
4231 set_process_info("handling incoming connection from %s via -oMa",
4233 sender_host_notsocket = TRUE;
4236 /* Otherwise, set the sender host as unknown except for inetd calls. This
4237 prevents host checking in the case of -bs not from inetd and also for -bS. */
4239 else if (!is_inetd) sender_host_unknown = TRUE;
4241 /* If stdout does not exist, then dup stdin to stdout. This can happen
4242 if exim is started from inetd. In this case fd 0 will be set to the socket,
4243 but fd 1 will not be set. This also happens for passed SMTP channels. */
4245 if (fstat(1, &statbuf) < 0) dup2(0, 1);
4247 /* Set up the incoming protocol name and the state of the program. Root
4248 is allowed to force received protocol via the -oMr option above, and if we are
4249 in a non-local SMTP state it means we have come via inetd and the process info
4250 has already been set up. We don't set received_protocol here for smtp input,
4251 as it varies according to batch/HELO/EHLO/AUTH/TLS. */
4255 if (sender_local) set_process_info("accepting a local SMTP message from <%s>",
4260 if (received_protocol == NULL)
4261 received_protocol = string_sprintf("local%s", called_as);
4262 set_process_info("accepting a local non-SMTP message from <%s>",
4266 /* Initialize the local_queue-only flag (this will be ignored if mua_wrapper is
4270 local_queue_only = queue_only;
4272 /* For non-SMTP and for batched SMTP input, check that there is enough space on
4273 the spool if so configured. On failure, we must not attempt to send an error
4274 message! (For interactive SMTP, the check happens at MAIL FROM and an SMTP
4275 error code is given.) */
4277 if ((!smtp_input || smtp_batched_input) && !receive_check_fs(0))
4279 fprintf(stderr, "exim: insufficient disk space\n");
4280 return EXIT_FAILURE;
4283 /* If this is smtp input of any kind, handle the start of the SMTP
4290 if (verify_check_host(&hosts_connection_nolog) == OK)
4291 log_write_selector &= ~L_smtp_connection;
4292 log_write(L_smtp_connection, LOG_MAIN, "%s", smtp_get_connection_info());
4293 if (!smtp_start_session())
4296 exim_exit(EXIT_SUCCESS);
4300 /* Otherwise, set up the input size limit here */
4304 thismessage_size_limit = expand_string_integer(message_size_limit);
4305 if (thismessage_size_limit < 0)
4307 if (thismessage_size_limit == -1)
4308 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to expand "
4309 "message_size_limit: %s", expand_string_message);
4311 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "invalid value for "
4312 "message_size_limit: %s", expand_string_message);
4316 /* Loop for several messages when reading SMTP input. If we fork any child
4317 processes, we don't want to wait for them unless synchronous delivery is
4318 requested, so set SIGCHLD to SIG_IGN in that case. This is not necessarily the
4319 same as SIG_DFL, despite the fact that documentation often lists the default as
4320 "ignore". This is a confusing area. This is what I know:
4322 At least on some systems (e.g. Solaris), just setting SIG_IGN causes child
4323 processes that complete simply to go away without ever becoming defunct. You
4324 can't then wait for them - but we don't want to wait for them in the
4325 non-synchronous delivery case. However, this behaviour of SIG_IGN doesn't
4326 happen for all OS (e.g. *BSD is different).
4328 But that's not the end of the story. Some (many? all?) systems have the
4329 SA_NOCLDWAIT option for sigaction(). This requests the behaviour that Solaris
4330 has by default, so it seems that the difference is merely one of default
4331 (compare restarting vs non-restarting signals).
4333 To cover all cases, Exim sets SIG_IGN with SA_NOCLDWAIT here if it can. If not,
4334 it just sets SIG_IGN. To be on the safe side it also calls waitpid() at the end
4335 of the loop below. Paranoia rules.
4337 February 2003: That's *still* not the end of the story. There are now versions
4338 of Linux (where SIG_IGN does work) that are picky. If, having set SIG_IGN, a
4339 process then calls waitpid(), a grumble is written to the system log, because
4340 this is logically inconsistent. In other words, it doesn't like the paranoia.
4341 As a consequenc of this, the waitpid() below is now excluded if we are sure
4342 that SIG_IGN works. */
4344 if (!synchronous_delivery)
4347 struct sigaction act;
4348 act.sa_handler = SIG_IGN;
4349 sigemptyset(&(act.sa_mask));
4350 act.sa_flags = SA_NOCLDWAIT;
4351 sigaction(SIGCHLD, &act, NULL);
4353 signal(SIGCHLD, SIG_IGN);
4357 /* Save the current store pool point, for resetting at the start of
4358 each message, and save the real sender address, if any. */
4360 reset_point = store_get(0);
4361 real_sender_address = sender_address;
4363 /* Loop to receive messages; receive_msg() returns TRUE if there are more
4364 messages to be read (SMTP input), or FALSE otherwise (not SMTP, or SMTP channel
4369 store_reset(reset_point);
4372 /* In the SMTP case, we have to handle the initial SMTP input and build the
4373 recipients list, before calling receive_msg() to read the message proper.
4374 Whatever sender address is actually given in the SMTP transaction is
4375 actually ignored for local senders - we use the actual sender, which is
4376 normally either the underlying user running this process or a -f argument
4377 provided by a trusted caller. It is saved in real_sender_address.
4379 However, if this value is NULL, we are dealing with a trusted caller when
4380 -f was not used; in this case, the SMTP sender is allowed to stand.
4382 Also, if untrusted_set_sender is set, we permit sender addresses that match
4383 anything in its list.
4385 The variable raw_sender_address holds the sender address before rewriting. */
4390 if ((rc = smtp_setup_msg()) > 0)
4392 if (real_sender_address != NULL &&
4393 !receive_check_set_sender(sender_address))
4395 sender_address = raw_sender = real_sender_address;
4396 sender_address_unrewritten = NULL;
4398 more = receive_msg(extract_recipients);
4399 if (message_id[0] == 0)
4402 exim_exit(EXIT_FAILURE);
4405 else exim_exit((rc == 0)? EXIT_SUCCESS : EXIT_FAILURE);
4408 /* In the non-SMTP case, we have all the information from the command
4409 line, but must process it in case it is in the more general RFC822
4410 format, and in any case, to detect syntax errors. Also, it appears that
4411 the use of comma-separated lists as single arguments is common, so we
4412 had better support them. */
4418 int count = argc - recipients_arg;
4419 uschar **list = argv + recipients_arg;
4421 /* These options cannot be changed dynamically for non-SMTP messages */
4423 active_local_sender_retain = local_sender_retain;
4424 active_local_from_check = local_from_check;
4426 /* Save before any rewriting */
4428 raw_sender = string_copy(sender_address);
4430 /* Loop for each argument */
4432 for (i = 0; i < count; i++)
4434 int start, end, domain;
4436 uschar *s = list[i];
4438 /* Loop for each comma-separated address */
4442 BOOL finished = FALSE;
4444 uschar *ss = parse_find_address_end(s, FALSE);
4446 if (*ss == ',') *ss = 0; else finished = TRUE;
4448 /* Check max recipients - if -t was used, these aren't recipients */
4450 if (recipients_max > 0 && ++rcount > recipients_max &&
4451 !extract_recipients)
4453 if (error_handling == ERRORS_STDERR)
4455 fprintf(stderr, "exim: too many recipients\n");
4456 exim_exit(EXIT_FAILURE);
4461 moan_to_sender(ERRMESS_TOOMANYRECIP, NULL, NULL, stdin, TRUE)?
4462 errors_sender_rc : EXIT_FAILURE;
4467 parse_extract_address(s, &errmess, &start, &end, &domain, FALSE);
4469 if (domain == 0 && !allow_unqualified_recipient)
4472 errmess = US"unqualified recipient address not allowed";
4475 if (recipient == NULL)
4477 if (error_handling == ERRORS_STDERR)
4479 fprintf(stderr, "exim: bad recipient address \"%s\": %s\n",
4480 string_printing(list[i]), errmess);
4481 exim_exit(EXIT_FAILURE);
4487 eblock.text1 = string_printing(list[i]);
4488 eblock.text2 = errmess;
4490 moan_to_sender(ERRMESS_BADARGADDRESS, &eblock, NULL, stdin, TRUE)?
4491 errors_sender_rc : EXIT_FAILURE;
4495 receive_add_recipient(recipient, -1);
4498 while (*(++s) != 0 && (*s == ',' || isspace(*s)));
4502 /* Show the recipients when debugging */
4507 if (sender_address != NULL) debug_printf("Sender: %s\n", sender_address);
4508 if (recipients_list != NULL)
4510 debug_printf("Recipients:\n");
4511 for (i = 0; i < recipients_count; i++)
4512 debug_printf(" %s\n", recipients_list[i].address);
4516 /* Read the data for the message. If filter_test is true, this will
4517 just read the headers for the message, and not write anything onto
4520 message_ended = END_NOTENDED;
4521 more = receive_msg(extract_recipients);
4523 /* more is always FALSE here (not SMTP message) when reading a message
4524 for real; when reading the headers of a message for filter testing,
4525 it is TRUE if the headers were terminated by '.' and FALSE otherwise. */
4527 if (message_id[0] == 0) exim_exit(EXIT_FAILURE);
4528 } /* Non-SMTP message reception */
4530 /* If this is a filter testing run, there are headers in store, but
4531 no message on the spool. Run the filtering code in testing mode, setting
4532 the domain to the qualify domain and the local part to the current user,
4533 unless they have been set by options. The prefix and suffix are left unset
4534 unless specified. The the return path is set to to the sender unless it has
4535 already been set from a return-path header in the message. */
4537 if (filter_test != NULL)
4539 deliver_domain = (ftest_domain != NULL)?
4540 ftest_domain : qualify_domain_recipient;
4541 deliver_domain_orig = deliver_domain;
4542 deliver_localpart = (ftest_localpart != NULL)?
4543 ftest_localpart : originator_login;
4544 deliver_localpart_orig = deliver_localpart;
4545 deliver_localpart_prefix = ftest_prefix;
4546 deliver_localpart_suffix = ftest_suffix;
4547 deliver_home = originator_home;
4549 if (return_path == NULL)
4551 printf("Return-path copied from sender\n");
4552 return_path = string_copy(sender_address);
4556 printf("Return-path = %s\n", (return_path[0] == 0)? US"<>" : return_path);
4558 printf("Sender = %s\n", (sender_address[0] == 0)? US"<>" : sender_address);
4560 receive_add_recipient(
4561 string_sprintf("%s%s%s@%s",
4562 (ftest_prefix == NULL)? US"" : ftest_prefix,
4564 (ftest_suffix == NULL)? US"" : ftest_suffix,
4565 deliver_domain), -1);
4567 printf("Recipient = %s\n", recipients_list[0].address);
4568 if (ftest_prefix != NULL) printf("Prefix = %s\n", ftest_prefix);
4569 if (ftest_suffix != NULL) printf("Suffix = %s\n", ftest_suffix);
4571 chdir("/"); /* Get away from wherever the user is running this from */
4572 exim_exit(filter_runtest(filter_fd, ftest_system, more)?
4573 EXIT_SUCCESS : EXIT_FAILURE);
4576 /* Else act on the result of message reception. We should not get here unless
4577 message_id[0] is non-zero. If queue_only is set, local_queue_only will be
4578 TRUE. If it is not, check on the number of messages received in this
4579 connection. If that's OK and queue_only_load is set, check that the load
4580 average is below it. If it is not, set local_queue_only TRUE. Note that it
4581 then remains this way for any subsequent messages on the same SMTP connection.
4582 This is a deliberate choice; even though the load average may fall, it
4583 doesn't seem right to deliver later messages on the same call when not
4584 delivering earlier ones. */
4586 if (!local_queue_only)
4588 if (smtp_accept_queue_per_connection > 0 &&
4589 receive_messagecount > smtp_accept_queue_per_connection)
4591 local_queue_only = TRUE;
4592 queue_only_reason = 2;
4594 else if (queue_only_load >= 0)
4596 local_queue_only = (load_average = os_getloadavg()) > queue_only_load;
4597 if (local_queue_only) queue_only_reason = 3;
4601 /* If running as an MUA wrapper, all queueing options and freezing options
4605 local_queue_only = queue_only_policy = deliver_freeze = FALSE;
4607 /* Log the queueing here, when it will get a message id attached, but
4608 not if queue_only is set (case 0). Case 1 doesn't happen here (too many
4611 if (local_queue_only) switch(queue_only_reason)
4614 log_write(L_delay_delivery,
4615 LOG_MAIN, "no immediate delivery: more than %d messages "
4616 "received in one connection", smtp_accept_queue_per_connection);
4620 log_write(L_delay_delivery,
4621 LOG_MAIN, "no immediate delivery: load average %.2f",
4622 (double)load_average/1000.0);
4626 /* Else do the delivery unless the ACL or local_scan() called for queue only
4627 or froze the message. Always deliver in a separate process. A fork failure is
4628 not a disaster, as the delivery will eventually happen on a subsequent queue
4629 run. The search cache must be tidied before the fork, as the parent will
4630 do it before exiting. The child will trigger a lookup failure and
4631 thereby defer the delivery if it tries to use (for example) a cached ldap
4632 connection that the parent has called unbind on. */
4634 else if (!queue_only_policy && !deliver_freeze)
4639 if ((pid = fork()) == 0)
4642 close_unwanted(); /* Close unwanted file descriptors and TLS */
4643 exim_nullstd(); /* Ensure std{in,out,err} exist */
4645 /* Re-exec Exim if we need to regain privilege (note: in mua_wrapper
4646 mode, deliver_drop_privilege is forced TRUE). */
4648 if (geteuid() != root_uid && !deliver_drop_privilege && !unprivileged)
4650 (void)child_exec_exim(CEE_EXEC_EXIT, FALSE, NULL, FALSE, 2, US"-Mc",
4652 /* Control does not return here. */
4655 /* No need to re-exec */
4657 rc = deliver_message(message_id, FALSE, FALSE);
4659 _exit((!mua_wrapper || rc == DELIVER_MUA_SUCCEEDED)?
4660 EXIT_SUCCESS : EXIT_FAILURE);
4665 log_write(0, LOG_MAIN|LOG_PANIC, "failed to fork automatic delivery "
4666 "process: %s", strerror(errno));
4669 /* In the parent, wait if synchronous delivery is required. This will
4670 always be the case in MUA wrapper mode. */
4672 else if (synchronous_delivery)
4675 while (wait(&status) != pid);
4676 if ((status & 0x00ff) != 0)
4677 log_write(0, LOG_MAIN|LOG_PANIC,
4678 "process %d crashed with signal %d while delivering %s",
4679 (int)pid, status & 0x00ff, message_id);
4680 if (mua_wrapper && (status & 0xffff) != 0) exim_exit(EXIT_FAILURE);
4684 /* The loop will repeat if more is TRUE. If we do not know know that the OS
4685 automatically reaps children (see comments above the loop), clear away any
4686 finished subprocesses here, in case there are lots of messages coming in
4687 from the same source. */
4689 #ifndef SIG_IGN_WORKS
4690 while (waitpid(-1, NULL, WNOHANG) > 0);
4694 exim_exit(EXIT_SUCCESS); /* Never returns */
4695 return 0; /* To stop compiler warning */