1 /* $Cambridge: exim/src/src/exim.c,v 1.62 2009/06/10 07:34:04 tom Exp $ */
3 /*************************************************
4 * Exim - an Internet mail transport agent *
5 *************************************************/
7 /* Copyright (c) University of Cambridge 1995 - 2007 */
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 * Call fopen() with umask 777 and adjust mode *
380 *************************************************/
382 /* Exim runs with umask(0) so that files created with open() have the mode that
383 is specified in the open() call. However, there are some files, typically in
384 the spool directory, that are created with fopen(). They end up world-writeable
385 if no precautions are taken. Although the spool directory is not accessible to
386 the world, this is an untidiness. So this is a wrapper function for fopen()
387 that sorts out the mode of the created file.
390 filename the file name
391 options the fopen() options
392 mode the required mode
394 Returns: the fopened FILE or NULL
398 modefopen(uschar *filename, char *options, mode_t mode)
400 mode_t saved_umask = umask(0777);
401 FILE *f = Ufopen(filename, options);
402 (void)umask(saved_umask);
403 if (f != NULL) (void)fchmod(fileno(f), mode);
410 /*************************************************
411 * Ensure stdin, stdout, and stderr exist *
412 *************************************************/
414 /* Some operating systems grumble if an exec() happens without a standard
415 input, output, and error (fds 0, 1, 2) being defined. The worry is that some
416 file will be opened and will use these fd values, and then some other bit of
417 code will assume, for example, that it can write error messages to stderr.
418 This function ensures that fds 0, 1, and 2 are open if they do not already
419 exist, by connecting them to /dev/null.
421 This function is also used to ensure that std{in,out,err} exist at all times,
422 so that if any library that Exim calls tries to use them, it doesn't crash.
434 for (i = 0; i <= 2; i++)
436 if (fstat(i, &statbuf) < 0 && errno == EBADF)
438 if (devnull < 0) devnull = open("/dev/null", O_RDWR);
439 if (devnull < 0) log_write(0, LOG_MAIN|LOG_PANIC_DIE, "%s",
440 string_open_failed(errno, "/dev/null"));
441 if (devnull != i) (void)dup2(devnull, i);
444 if (devnull > 2) (void)close(devnull);
450 /*************************************************
451 * Close unwanted file descriptors for delivery *
452 *************************************************/
454 /* This function is called from a new process that has been forked to deliver
455 an incoming message, either directly, or using exec.
457 We want any smtp input streams to be closed in this new process. However, it
458 has been observed that using fclose() here causes trouble. When reading in -bS
459 input, duplicate copies of messages have been seen. The files will be sharing a
460 file pointer with the parent process, and it seems that fclose() (at least on
461 some systems - I saw this on Solaris 2.5.1) messes with that file pointer, at
462 least sometimes. Hence we go for closing the underlying file descriptors.
464 If TLS is active, we want to shut down the TLS library, but without molesting
465 the parent's SSL connection.
467 For delivery of a non-SMTP message, we want to close stdin and stdout (and
468 stderr unless debugging) because the calling process might have set them up as
469 pipes and be waiting for them to close before it waits for the submission
470 process to terminate. If they aren't closed, they hold up the calling process
471 until the initial delivery process finishes, which is not what we want.
473 Exception: We do want it for synchronous delivery!
475 And notwithstanding all the above, if D_resolver is set, implying resolver
476 debugging, leave stdout open, because that's where the resolver writes its
479 When we close stderr (which implies we've also closed stdout), we also get rid
480 of any controlling terminal.
492 tls_close(FALSE); /* Shut down the TLS library */
494 (void)close(fileno(smtp_in));
495 (void)close(fileno(smtp_out));
500 (void)close(0); /* stdin */
501 if ((debug_selector & D_resolver) == 0) (void)close(1); /* stdout */
502 if (debug_selector == 0) /* stderr */
504 if (!synchronous_delivery)
517 /*************************************************
519 *************************************************/
521 /* This function sets a new uid and gid permanently, optionally calling
522 initgroups() to set auxiliary groups. There are some special cases when running
523 Exim in unprivileged modes. In these situations the effective uid will not be
524 root; if we already have the right effective uid/gid, and don't need to
525 initialize any groups, leave things as they are.
530 igflag TRUE if initgroups() wanted
531 msg text to use in debugging output and failure log
533 Returns: nothing; bombs out on failure
537 exim_setugid(uid_t uid, gid_t gid, BOOL igflag, uschar *msg)
539 uid_t euid = geteuid();
540 gid_t egid = getegid();
542 if (euid == root_uid || euid != uid || egid != gid || igflag)
544 /* At least one OS returns +1 for initgroups failure, so just check for
549 struct passwd *pw = getpwuid(uid);
552 if (initgroups(pw->pw_name, gid) != 0)
553 log_write(0,LOG_MAIN|LOG_PANIC_DIE,"initgroups failed for uid=%ld: %s",
554 (long int)uid, strerror(errno));
556 else log_write(0, LOG_MAIN|LOG_PANIC_DIE, "cannot run initgroups(): "
557 "no passwd entry for uid=%ld", (long int)uid);
560 if (setgid(gid) < 0 || setuid(uid) < 0)
562 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "unable to set gid=%ld or uid=%ld "
563 "(euid=%ld): %s", (long int)gid, (long int)uid, (long int)euid, msg);
567 /* Debugging output included uid/gid and all groups */
572 gid_t group_list[NGROUPS_MAX];
573 debug_printf("changed uid/gid: %s\n uid=%ld gid=%ld pid=%ld\n", msg,
574 (long int)geteuid(), (long int)getegid(), (long int)getpid());
575 group_count = getgroups(NGROUPS_MAX, group_list);
576 debug_printf(" auxiliary group list:");
580 for (i = 0; i < group_count; i++) debug_printf(" %d", (int)group_list[i]);
582 else debug_printf(" <none>");
590 /*************************************************
592 *************************************************/
594 /* Exim exits via this function so that it always clears up any open
600 Returns: does not return
608 debug_printf(">>>>>>>>>>>>>>>> Exim pid=%d terminating with rc=%d "
609 ">>>>>>>>>>>>>>>>\n", (int)getpid(), rc);
616 /*************************************************
617 * Extract port from host address *
618 *************************************************/
620 /* Called to extract the port from the values given to -oMa and -oMi.
621 It also checks the syntax of the address, and terminates it before the
622 port data when a port is extracted.
625 address the address, with possible port on the end
627 Returns: the port, or zero if there isn't one
628 bombs out on a syntax error
632 check_port(uschar *address)
634 int port = host_address_extract_port(address);
635 if (string_is_ip_address(address, NULL) == 0)
637 fprintf(stderr, "exim abandoned: \"%s\" is not an IP address\n", address);
645 /*************************************************
646 * Test/verify an address *
647 *************************************************/
649 /* This function is called by the -bv and -bt code. It extracts a working
650 address from a full RFC 822 address. This isn't really necessary per se, but it
651 has the effect of collapsing source routes.
655 flags flag bits for verify_address()
656 exit_value to be set for failures
662 test_address(uschar *s, int flags, int *exit_value)
664 int start, end, domain;
665 uschar *parse_error = NULL;
666 uschar *address = parse_extract_address(s, &parse_error, &start, &end, &domain,
670 fprintf(stdout, "syntax error: %s\n", parse_error);
675 int rc = verify_address(deliver_make_addr(address,TRUE), stdout, flags, -1,
676 -1, -1, NULL, NULL, NULL);
677 if (rc == FAIL) *exit_value = 2;
678 else if (rc == DEFER && *exit_value == 0) *exit_value = 1;
684 /*************************************************
685 * Decode bit settings for log/debug *
686 *************************************************/
688 /* This function decodes a string containing bit settings in the form of +name
689 and/or -name sequences, and sets/unsets bits in a bit string accordingly. It
690 also recognizes a numeric setting of the form =<number>, but this is not
691 intended for user use. It's an easy way for Exim to pass the debug settings
692 when it is re-exec'ed.
694 The log options are held in two unsigned ints (because there became too many
695 for one). The top bit in the table means "put in 2nd selector". This does not
696 yet apply to debug options, so the "=" facility sets only the first selector.
698 The "all" selector, which must be equal to 0xffffffff, is recognized specially.
699 It sets all the bits in both selectors. However, there is a facility for then
700 unsetting certain bits, because we want to turn off "memory" in the debug case.
702 A bad value for a debug setting is treated as an unknown option - error message
703 to stderr and die. For log settings, which come from the configuration file,
704 we write to the log on the way out...
707 selector1 address of the first bit string
708 selector2 address of the second bit string, or NULL
709 notall1 bits to exclude from "all" for selector1
710 notall2 bits to exclude from "all" for selector2
711 string the configured string
712 options the table of option names
714 which "log" or "debug"
716 Returns: nothing on success - bomb out on failure
720 decode_bits(unsigned int *selector1, unsigned int *selector2, int notall1,
721 int notall2, uschar *string, bit_table *options, int count, uschar *which)
724 if (string == NULL) return;
728 char *end; /* Not uschar */
729 *selector1 = strtoul(CS string+1, &end, 0);
730 if (*end == 0) return;
731 errmsg = string_sprintf("malformed numeric %s_selector setting: %s", which,
736 /* Handle symbolic setting */
743 bit_table *start, *end;
745 while (isspace(*string)) string++;
746 if (*string == 0) return;
748 if (*string != '+' && *string != '-')
750 errmsg = string_sprintf("malformed %s_selector setting: "
751 "+ or - expected but found \"%s\"", which, string);
755 adding = *string++ == '+';
757 while (isalnum(*string) || *string == '_') string++;
761 end = options + count;
765 bit_table *middle = start + (end - start)/2;
766 int c = Ustrncmp(s, middle->name, len);
769 if (middle->name[len] != 0) c = -1; else
771 unsigned int bit = middle->bit;
772 unsigned int *selector;
774 /* The value with all bits set means "force all bits in both selectors"
775 in the case where two are being handled. However, the top bit in the
776 second selector is never set. When setting, some bits can be excluded.
779 if (bit == 0xffffffff)
783 *selector1 = 0xffffffff ^ notall1;
784 if (selector2 != NULL) *selector2 = 0x7fffffff ^ notall2;
789 if (selector2 != NULL) *selector2 = 0;
793 /* Otherwise, the 0x80000000 bit means "this value, without the top
794 bit, belongs in the second selector". */
798 if ((bit & 0x80000000) != 0)
800 selector = selector2;
803 else selector = selector1;
804 if (adding) *selector |= bit; else *selector &= ~bit;
806 break; /* Out of loop to match selector name */
809 if (c < 0) end = middle; else start = middle + 1;
810 } /* Loop to match selector name */
814 errmsg = string_sprintf("unknown %s_selector setting: %c%.*s", which,
815 adding? '+' : '-', len, s);
818 } /* Loop for selector names */
820 /* Handle disasters */
823 if (Ustrcmp(which, "debug") == 0)
825 fprintf(stderr, "exim: %s\n", errmsg);
828 else log_write(0, LOG_CONFIG|LOG_PANIC_DIE, "%s", errmsg);
833 /*************************************************
834 * Show supported features *
835 *************************************************/
837 /* This function is called for -bV and for -d to output the optional features
838 of the current Exim binary.
840 Arguments: a FILE for printing
845 show_whats_supported(FILE *f)
847 #ifdef DB_VERSION_STRING
848 fprintf(f, "Berkeley DB: %s\n", DB_VERSION_STRING);
849 #elif defined(BTREEVERSION) && defined(HASHVERSION)
851 fprintf(f, "Probably Berkeley DB version 1.8x (native mode)\n");
853 fprintf(f, "Probably Berkeley DB version 1.8x (compatibility mode)\n");
855 #elif defined(_DBM_RDONLY) || defined(dbm_dirfno)
856 fprintf(f, "Probably ndbm\n");
857 #elif defined(USE_TDB)
858 fprintf(f, "Using tdb\n");
861 fprintf(f, "Probably GDBM (native mode)\n");
863 fprintf(f, "Probably GDBM (compatibility mode)\n");
867 fprintf(f, "Support for:");
868 #ifdef SUPPORT_CRYPTEQ
869 fprintf(f, " crypteq");
872 fprintf(f, " iconv()");
877 #ifdef HAVE_SETCLASSRESOURCES
878 fprintf(f, " use_setclassresources");
887 fprintf(f, " Expand_dlfunc");
889 #ifdef USE_TCP_WRAPPERS
890 fprintf(f, " TCPwrappers");
894 fprintf(f, " GnuTLS");
896 fprintf(f, " OpenSSL");
899 #ifdef SUPPORT_TRANSLATE_IP_ADDRESS
900 fprintf(f, " translate_ip_address");
902 #ifdef SUPPORT_MOVE_FROZEN_MESSAGES
903 fprintf(f, " move_frozen_messages");
905 #ifdef WITH_CONTENT_SCAN
906 fprintf(f, " Content_Scanning");
911 #ifdef WITH_OLD_DEMIME
912 fprintf(f, " Old_Demime");
914 #ifdef EXPERIMENTAL_SPF
915 fprintf(f, " Experimental_SPF");
917 #ifdef EXPERIMENTAL_SRS
918 fprintf(f, " Experimental_SRS");
920 #ifdef EXPERIMENTAL_BRIGHTMAIL
921 fprintf(f, " Experimental_Brightmail");
923 #ifdef EXPERIMENTAL_DCC
924 fprintf(f, " Experimental_DCC");
928 fprintf(f, "Lookups:");
929 #ifdef LOOKUP_LSEARCH
930 fprintf(f, " lsearch wildlsearch nwildlsearch iplsearch");
936 fprintf(f, " dbm dbmnz");
939 fprintf(f, " dnsdb");
941 #ifdef LOOKUP_DSEARCH
942 fprintf(f, " dsearch");
945 fprintf(f, " ibase");
948 fprintf(f, " ldap ldapdn ldapm");
951 fprintf(f, " mysql");
954 fprintf(f, " nis nis0");
956 #ifdef LOOKUP_NISPLUS
957 fprintf(f, " nisplus");
960 fprintf(f, " oracle");
963 fprintf(f, " passwd");
966 fprintf(f, " pgsql");
969 fprintf(f, " sqlite");
972 fprintf(f, " testdb");
975 fprintf(f, " whoson");
979 fprintf(f, "Authenticators:");
981 fprintf(f, " cram_md5");
983 #ifdef AUTH_CYRUS_SASL
984 fprintf(f, " cyrus_sasl");
987 fprintf(f, " dovecot");
989 #ifdef AUTH_PLAINTEXT
990 fprintf(f, " plaintext");
997 fprintf(f, "Routers:");
999 fprintf(f, " accept");
1001 #ifdef ROUTER_DNSLOOKUP
1002 fprintf(f, " dnslookup");
1004 #ifdef ROUTER_IPLITERAL
1005 fprintf(f, " ipliteral");
1007 #ifdef ROUTER_IPLOOKUP
1008 fprintf(f, " iplookup");
1010 #ifdef ROUTER_MANUALROUTE
1011 fprintf(f, " manualroute");
1013 #ifdef ROUTER_QUERYPROGRAM
1014 fprintf(f, " queryprogram");
1016 #ifdef ROUTER_REDIRECT
1017 fprintf(f, " redirect");
1021 fprintf(f, "Transports:");
1022 #ifdef TRANSPORT_APPENDFILE
1023 fprintf(f, " appendfile");
1024 #ifdef SUPPORT_MAILDIR
1025 fprintf(f, "/maildir");
1027 #ifdef SUPPORT_MAILSTORE
1028 fprintf(f, "/mailstore");
1034 #ifdef TRANSPORT_AUTOREPLY
1035 fprintf(f, " autoreply");
1037 #ifdef TRANSPORT_LMTP
1038 fprintf(f, " lmtp");
1040 #ifdef TRANSPORT_PIPE
1041 fprintf(f, " pipe");
1043 #ifdef TRANSPORT_SMTP
1044 fprintf(f, " smtp");
1048 if (fixed_never_users[0] > 0)
1051 fprintf(f, "Fixed never_users: ");
1052 for (i = 1; i <= (int)fixed_never_users[0] - 1; i++)
1053 fprintf(f, "%d:", (unsigned int)fixed_never_users[i]);
1054 fprintf(f, "%d\n", (unsigned int)fixed_never_users[i]);
1057 fprintf(f, "Size of off_t: %d\n", sizeof(off_t));
1063 /*************************************************
1064 * Quote a local part *
1065 *************************************************/
1067 /* This function is used when a sender address or a From: or Sender: header
1068 line is being created from the caller's login, or from an authenticated_id. It
1069 applies appropriate quoting rules for a local part.
1071 Argument: the local part
1072 Returns: the local part, quoted if necessary
1076 local_part_quote(uschar *lpart)
1078 BOOL needs_quote = FALSE;
1083 for (t = lpart; !needs_quote && *t != 0; t++)
1085 needs_quote = !isalnum(*t) && strchr("!#$%&'*+-/=?^_`{|}~", *t) == NULL &&
1086 (*t != '.' || t == lpart || t[1] == 0);
1089 if (!needs_quote) return lpart;
1092 yield = string_cat(NULL, &size, &ptr, US"\"", 1);
1096 uschar *nq = US Ustrpbrk(lpart, "\\\"");
1099 yield = string_cat(yield, &size, &ptr, lpart, Ustrlen(lpart));
1102 yield = string_cat(yield, &size, &ptr, lpart, nq - lpart);
1103 yield = string_cat(yield, &size, &ptr, US"\\", 1);
1104 yield = string_cat(yield, &size, &ptr, nq, 1);
1108 yield = string_cat(yield, &size, &ptr, US"\"", 1);
1116 /*************************************************
1117 * Load readline() functions *
1118 *************************************************/
1120 /* This function is called from testing executions that read data from stdin,
1121 but only when running as the calling user. Currently, only -be does this. The
1122 function loads the readline() function library and passes back the functions.
1123 On some systems, it needs the curses library, so load that too, but try without
1124 it if loading fails. All this functionality has to be requested at build time.
1127 fn_readline_ptr pointer to where to put the readline pointer
1128 fn_addhist_ptr pointer to where to put the addhistory function
1130 Returns: the dlopen handle or NULL on failure
1134 set_readline(char * (**fn_readline_ptr)(char *),
1135 char * (**fn_addhist_ptr)(char *))
1138 void *dlhandle_curses = dlopen("libcurses.so", RTLD_GLOBAL|RTLD_LAZY);
1140 dlhandle = dlopen("libreadline.so", RTLD_GLOBAL|RTLD_NOW);
1141 if (dlhandle_curses != NULL) dlclose(dlhandle_curses);
1143 if (dlhandle != NULL)
1145 *fn_readline_ptr = (char *(*)(char*))dlsym(dlhandle, "readline");
1146 *fn_addhist_ptr = (char *(*)(char*))dlsym(dlhandle, "add_history");
1150 DEBUG(D_any) debug_printf("failed to load readline: %s\n", dlerror());
1159 /*************************************************
1160 * Get a line from stdin for testing things *
1161 *************************************************/
1163 /* This function is called when running tests that can take a number of lines
1164 of input (for example, -be and -bt). It handles continuations and trailing
1165 spaces. And prompting and a blank line output on eof. If readline() is in use,
1166 the arguments are non-NULL and provide the relevant functions.
1169 fn_readline readline function or NULL
1170 fn_addhist addhist function or NULL
1172 Returns: pointer to dynamic memory, or NULL at end of file
1176 get_stdinput(char *(*fn_readline)(char *), char *(*fn_addhist)(char *))
1181 uschar *yield = NULL;
1183 if (fn_readline == NULL) { printf("> "); fflush(stdout); }
1187 uschar buffer[1024];
1191 char *readline_line = NULL;
1192 if (fn_readline != NULL)
1194 if ((readline_line = fn_readline((i > 0)? "":"> ")) == NULL) break;
1195 if (*readline_line != 0 && fn_addhist != NULL) fn_addhist(readline_line);
1196 p = US readline_line;
1201 /* readline() not in use */
1204 if (Ufgets(buffer, sizeof(buffer), stdin) == NULL) break;
1208 /* Handle the line */
1210 ss = p + (int)Ustrlen(p);
1211 while (ss > p && isspace(ss[-1])) ss--;
1215 while (p < ss && isspace(*p)) p++; /* leading space after cont */
1218 yield = string_cat(yield, &size, &ptr, p, ss - p);
1221 if (fn_readline != NULL) free(readline_line);
1224 if (ss == p || yield[ptr-1] != '\\')
1232 if (yield == NULL) printf("\n");
1238 /*************************************************
1239 * Output usage information for the program *
1240 *************************************************/
1242 /* This function is called when there are no recipients
1243 or a specific --help argument was added.
1246 progname information on what name we were called by
1248 Returns: DOES NOT RETURN
1252 exim_usage(uschar *progname)
1255 /* Handle specific program invocation varients */
1256 if (Ustrcmp(progname, US"-mailq") == 0)
1259 "mailq - list the contents of the mail queue\n\n"
1260 "For a list of options, see the Exim documentation.\n");
1264 /* Generic usage - we output this whatever happens */
1266 "Exim is a Mail Transfer Agent. It is normally called by Mail User Agents,\n"
1267 "not directly from a shell command line. Options and/or arguments control\n"
1268 "what it does when called. For a list of options, see the Exim documentation.\n");
1275 /*************************************************
1276 * Entry point and high-level code *
1277 *************************************************/
1279 /* Entry point for the Exim mailer. Analyse the arguments and arrange to take
1280 the appropriate action. All the necessary functions are present in the one
1281 binary. I originally thought one should split it up, but it turns out that so
1282 much of the apparatus is needed in each chunk that one might as well just have
1283 it all available all the time, which then makes the coding easier as well.
1286 argc count of entries in argv
1287 argv argument strings, with argv[0] being the program name
1289 Returns: EXIT_SUCCESS if terminated successfully
1290 EXIT_FAILURE otherwise, except when a message has been sent
1291 to the sender, and -oee was given
1295 main(int argc, char **cargv)
1297 uschar **argv = USS cargv;
1298 int arg_receive_timeout = -1;
1299 int arg_smtp_receive_timeout = -1;
1300 int arg_error_handling = error_handling;
1301 int filter_sfd = -1;
1302 int filter_ufd = -1;
1305 int list_queue_option = 0;
1307 int msg_action_arg = -1;
1308 int namelen = (argv[0] == NULL)? 0 : Ustrlen(argv[0]);
1309 int queue_only_reason = 0;
1311 int perl_start_option = 0;
1313 int recipients_arg = argc;
1314 int sender_address_domain = 0;
1315 int test_retry_arg = -1;
1316 int test_rewrite_arg = -1;
1317 BOOL arg_queue_only = FALSE;
1318 BOOL bi_option = FALSE;
1319 BOOL checking = FALSE;
1320 BOOL count_queue = FALSE;
1321 BOOL expansion_test = FALSE;
1322 BOOL extract_recipients = FALSE;
1323 BOOL forced_delivery = FALSE;
1324 BOOL f_end_dot = FALSE;
1325 BOOL deliver_give_up = FALSE;
1326 BOOL list_queue = FALSE;
1327 BOOL list_options = FALSE;
1328 BOOL local_queue_only;
1330 BOOL one_msg_action = FALSE;
1331 BOOL queue_only_set = FALSE;
1332 BOOL receiving_message = TRUE;
1333 BOOL sender_ident_set = FALSE;
1334 BOOL session_local_queue_only;
1336 BOOL removed_privilege = FALSE;
1337 BOOL usage_wanted = FALSE;
1338 BOOL verify_address_mode = FALSE;
1339 BOOL verify_as_sender = FALSE;
1340 BOOL version_printed = FALSE;
1341 uschar *alias_arg = NULL;
1342 uschar *called_as = US"";
1343 uschar *start_queue_run_id = NULL;
1344 uschar *stop_queue_run_id = NULL;
1345 uschar *expansion_test_message = NULL;
1346 uschar *ftest_domain = NULL;
1347 uschar *ftest_localpart = NULL;
1348 uschar *ftest_prefix = NULL;
1349 uschar *ftest_suffix = NULL;
1350 uschar *real_sender_address;
1351 uschar *originator_home = US"/";
1355 struct stat statbuf;
1356 pid_t passed_qr_pid = (pid_t)0;
1357 int passed_qr_pipe = -1;
1358 gid_t group_list[NGROUPS_MAX];
1360 /* Possible options for -R and -S */
1362 static uschar *rsopts[] = { US"f", US"ff", US"r", US"rf", US"rff" };
1364 /* Need to define this in case we need to change the environment in order
1365 to get rid of a bogus time zone. We have to make it char rather than uschar
1366 because some OS define it in /usr/include/unistd.h. */
1368 extern char **environ;
1370 /* If the Exim user and/or group and/or the configuration file owner/group were
1371 defined by ref:name at build time, we must now find the actual uid/gid values.
1372 This is a feature to make the lives of binary distributors easier. */
1374 #ifdef EXIM_USERNAME
1375 if (route_finduser(US EXIM_USERNAME, &pw, &exim_uid))
1377 exim_gid = pw->pw_gid;
1381 fprintf(stderr, "exim: failed to find uid for user name \"%s\"\n",
1387 #ifdef EXIM_GROUPNAME
1388 if (!route_findgroup(US EXIM_GROUPNAME, &exim_gid))
1390 fprintf(stderr, "exim: failed to find gid for group name \"%s\"\n",
1396 #ifdef CONFIGURE_OWNERNAME
1397 if (!route_finduser(US CONFIGURE_OWNERNAME, NULL, &config_uid))
1399 fprintf(stderr, "exim: failed to find uid for user name \"%s\"\n",
1400 CONFIGURE_OWNERNAME);
1405 #ifdef CONFIGURE_GROUPNAME
1406 if (!route_findgroup(US CONFIGURE_GROUPNAME, &config_gid))
1408 fprintf(stderr, "exim: failed to find gid for group name \"%s\"\n",
1409 CONFIGURE_GROUPNAME);
1414 /* In the Cygwin environment, some initialization needs doing. It is fudged
1415 in by means of this macro. */
1421 /* Check a field which is patched when we are running Exim within its
1422 testing harness; do a fast initial check, and then the whole thing. */
1424 running_in_test_harness =
1425 *running_status == '<' && Ustrcmp(running_status, "<<<testing>>>") == 0;
1427 /* The C standard says that the equivalent of setlocale(LC_ALL, "C") is obeyed
1428 at the start of a program; however, it seems that some environments do not
1429 follow this. A "strange" locale can affect the formatting of timestamps, so we
1432 setlocale(LC_ALL, "C");
1434 /* Set up the default handler for timing using alarm(). */
1436 os_non_restarting_signal(SIGALRM, sigalrm_handler);
1438 /* Ensure we have a buffer for constructing log entries. Use malloc directly,
1439 because store_malloc writes a log entry on failure. */
1441 log_buffer = (uschar *)malloc(LOG_BUFFER_SIZE);
1442 if (log_buffer == NULL)
1444 fprintf(stderr, "exim: failed to get store for log buffer\n");
1448 /* Set log_stderr to stderr, provided that stderr exists. This gets reset to
1449 NULL when the daemon is run and the file is closed. We have to use this
1450 indirection, because some systems don't allow writing to the variable "stderr".
1453 if (fstat(fileno(stderr), &statbuf) >= 0) log_stderr = stderr;
1455 /* Arrange for the PCRE regex library to use our store functions. Note that
1456 the normal calls are actually macros that add additional arguments for
1457 debugging purposes so we have to assign specially constructed functions here.
1458 The default is to use store in the stacking pool, but this is overridden in the
1459 regex_must_compile() function. */
1461 pcre_malloc = function_store_get;
1462 pcre_free = function_dummy_free;
1464 /* Ensure there is a big buffer for temporary use in several places. It is put
1465 in malloc store so that it can be freed for enlargement if necessary. */
1467 big_buffer = store_malloc(big_buffer_size);
1469 /* Set up the handler for the data request signal, and set the initial
1470 descriptive text. */
1472 set_process_info("initializing");
1473 os_restarting_signal(SIGUSR1, usr1_handler);
1475 /* SIGHUP is used to get the daemon to reconfigure. It gets set as appropriate
1476 in the daemon code. For the rest of Exim's uses, we ignore it. */
1478 signal(SIGHUP, SIG_IGN);
1480 /* We don't want to die on pipe errors as the code is written to handle
1481 the write error instead. */
1483 signal(SIGPIPE, SIG_IGN);
1485 /* Under some circumstance on some OS, Exim can get called with SIGCHLD
1486 set to SIG_IGN. This causes subprocesses that complete before the parent
1487 process waits for them not to hang around, so when Exim calls wait(), nothing
1488 is there. The wait() code has been made robust against this, but let's ensure
1489 that SIGCHLD is set to SIG_DFL, because it's tidier to wait and get a process
1490 ending status. We use sigaction rather than plain signal() on those OS where
1491 SA_NOCLDWAIT exists, because we want to be sure it is turned off. (There was a
1492 problem on AIX with this.) */
1496 struct sigaction act;
1497 act.sa_handler = SIG_DFL;
1498 sigemptyset(&(act.sa_mask));
1500 sigaction(SIGCHLD, &act, NULL);
1503 signal(SIGCHLD, SIG_DFL);
1506 /* Save the arguments for use if we re-exec exim as a daemon after receiving
1511 /* Set up the version number. Set up the leading 'E' for the external form of
1512 message ids, set the pointer to the internal form, and initialize it to
1513 indicate no message being processed. */
1516 message_id_option[0] = '-';
1517 message_id_external = message_id_option + 1;
1518 message_id_external[0] = 'E';
1519 message_id = message_id_external + 1;
1522 /* Set the umask to zero so that any files Exim creates using open() are
1523 created with the modes that it specifies. NOTE: Files created with fopen() have
1524 a problem, which was not recognized till rather late (February 2006). With this
1525 umask, such files will be world writeable. (They are all content scanning files
1526 in the spool directory, which isn't world-accessible, so this is not a
1527 disaster, but it's untidy.) I don't want to change this overall setting,
1528 however, because it will interact badly with the open() calls. Instead, there's
1529 now a function called modefopen() that fiddles with the umask while calling
1534 /* Precompile the regular expression for matching a message id. Keep this in
1535 step with the code that generates ids in the accept.c module. We need to do
1536 this here, because the -M options check their arguments for syntactic validity
1537 using mac_ismsgid, which uses this. */
1540 regex_must_compile(US"^(?:[^\\W_]{6}-){2}[^\\W_]{2}$", FALSE, TRUE);
1542 /* Precompile the regular expression that is used for matching an SMTP error
1543 code, possibly extended, at the start of an error message. Note that the
1544 terminating whitespace character is included. */
1547 regex_must_compile(US"^\\d\\d\\d\\s(?:\\d\\.\\d\\d?\\d?\\.\\d\\d?\\d?\\s)?",
1550 /* If the program is called as "mailq" treat it as equivalent to "exim -bp";
1551 this seems to be a generally accepted convention, since one finds symbolic
1552 links called "mailq" in standard OS configurations. */
1554 if ((namelen == 5 && Ustrcmp(argv[0], "mailq") == 0) ||
1555 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/mailq", 6) == 0))
1558 receiving_message = FALSE;
1559 called_as = US"-mailq";
1562 /* If the program is called as "rmail" treat it as equivalent to
1563 "exim -i -oee", thus allowing UUCP messages to be input using non-SMTP mode,
1564 i.e. preventing a single dot on a line from terminating the message, and
1565 returning with zero return code, even in cases of error (provided an error
1566 message has been sent). */
1568 if ((namelen == 5 && Ustrcmp(argv[0], "rmail") == 0) ||
1569 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/rmail", 6) == 0))
1572 called_as = US"-rmail";
1573 errors_sender_rc = EXIT_SUCCESS;
1576 /* If the program is called as "rsmtp" treat it as equivalent to "exim -bS";
1577 this is a smail convention. */
1579 if ((namelen == 5 && Ustrcmp(argv[0], "rsmtp") == 0) ||
1580 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/rsmtp", 6) == 0))
1582 smtp_input = smtp_batched_input = TRUE;
1583 called_as = US"-rsmtp";
1586 /* If the program is called as "runq" treat it as equivalent to "exim -q";
1587 this is a smail convention. */
1589 if ((namelen == 4 && Ustrcmp(argv[0], "runq") == 0) ||
1590 (namelen > 4 && Ustrncmp(argv[0] + namelen - 5, "/runq", 5) == 0))
1593 receiving_message = FALSE;
1594 called_as = US"-runq";
1597 /* If the program is called as "newaliases" treat it as equivalent to
1598 "exim -bi"; this is a sendmail convention. */
1600 if ((namelen == 10 && Ustrcmp(argv[0], "newaliases") == 0) ||
1601 (namelen > 10 && Ustrncmp(argv[0] + namelen - 11, "/newaliases", 11) == 0))
1604 receiving_message = FALSE;
1605 called_as = US"-newaliases";
1608 /* Save the original effective uid for a couple of uses later. It should
1609 normally be root, but in some esoteric environments it may not be. */
1611 original_euid = geteuid();
1613 /* Get the real uid and gid. If the caller is root, force the effective uid/gid
1614 to be the same as the real ones. This makes a difference only if Exim is setuid
1615 (or setgid) to something other than root, which could be the case in some
1616 special configurations. */
1618 real_uid = getuid();
1619 real_gid = getgid();
1621 if (real_uid == root_uid)
1627 /* If neither the original real uid nor the original euid was root, Exim is
1628 running in an unprivileged state. */
1630 unprivileged = (real_uid != root_uid && original_euid != root_uid);
1632 /* If the first argument is --help, set usage_wanted and pretend there
1633 are no arguments. This will cause a brief message to be given. We do
1634 the message generation downstream so we can pick up how we were invoked */
1636 if (argc > 1 && Ustrcmp(argv[1], "--help") == 0)
1639 usage_wanted = TRUE;
1642 /* Scan the program's arguments. Some can be dealt with right away; others are
1643 simply recorded for checking and handling afterwards. Do a high-level switch
1644 on the second character (the one after '-'), to save some effort. */
1646 for (i = 1; i < argc; i++)
1648 BOOL badarg = FALSE;
1649 uschar *arg = argv[i];
1653 /* An argument not starting with '-' is the start of a recipients list;
1654 break out of the options-scanning loop. */
1662 /* An option consistion of -- terminates the options */
1664 if (Ustrcmp(arg, "--") == 0)
1666 recipients_arg = i + 1;
1670 /* Handle flagged options */
1672 switchchar = arg[1];
1675 /* Make all -ex options synonymous with -oex arguments, since that
1676 is assumed by various callers. Also make -qR options synonymous with -R
1677 options, as that seems to be required as well. Allow for -qqR too, and
1678 the same for -S options. */
1680 if (Ustrncmp(arg+1, "oe", 2) == 0 ||
1681 Ustrncmp(arg+1, "qR", 2) == 0 ||
1682 Ustrncmp(arg+1, "qS", 2) == 0)
1684 switchchar = arg[2];
1687 else if (Ustrncmp(arg+1, "qqR", 3) == 0 || Ustrncmp(arg+1, "qqS", 3) == 0)
1689 switchchar = arg[3];
1691 queue_2stage = TRUE;
1694 /* Make -r synonymous with -f, since it is a documented alias */
1696 else if (arg[1] == 'r') switchchar = 'f';
1698 /* Make -ov synonymous with -v */
1700 else if (Ustrcmp(arg, "-ov") == 0)
1706 /* High-level switch on active initial letter */
1710 /* -Btype is a sendmail option for 7bit/8bit setting. Exim is 8-bit clean
1711 so has no need of it. */
1714 if (*argrest == 0) i++; /* Skip over the type */
1719 receiving_message = FALSE; /* Reset TRUE for -bm, -bS, -bs below */
1721 /* -bd: Run in daemon mode, awaiting SMTP connections.
1722 -bdf: Ditto, but in the foreground.
1725 if (*argrest == 'd')
1727 daemon_listen = TRUE;
1728 if (*(++argrest) == 'f') background_daemon = FALSE;
1729 else if (*argrest != 0) { badarg = TRUE; break; }
1732 /* -be: Run in expansion test mode
1733 -bem: Ditto, but read a message from a file first
1736 else if (*argrest == 'e')
1738 expansion_test = checking = TRUE;
1739 if (argrest[1] == 'm')
1741 if (++i >= argc) { badarg = TRUE; break; }
1742 expansion_test_message = argv[i];
1745 if (argrest[1] != 0) { badarg = TRUE; break; }
1748 /* -bF: Run system filter test */
1750 else if (*argrest == 'F')
1752 filter_test |= FTEST_SYSTEM;
1753 if (*(++argrest) != 0) { badarg = TRUE; break; }
1754 if (++i < argc) filter_test_sfile = argv[i]; else
1756 fprintf(stderr, "exim: file name expected after %s\n", argv[i-1]);
1761 /* -bf: Run user filter test
1762 -bfd: Set domain for filter testing
1763 -bfl: Set local part for filter testing
1764 -bfp: Set prefix for filter testing
1765 -bfs: Set suffix for filter testing
1768 else if (*argrest == 'f')
1770 if (*(++argrest) == 0)
1772 filter_test |= FTEST_USER;
1773 if (++i < argc) filter_test_ufile = argv[i]; else
1775 fprintf(stderr, "exim: file name expected after %s\n", argv[i-1]);
1783 fprintf(stderr, "exim: string expected after %s\n", arg);
1786 if (Ustrcmp(argrest, "d") == 0) ftest_domain = argv[i];
1787 else if (Ustrcmp(argrest, "l") == 0) ftest_localpart = argv[i];
1788 else if (Ustrcmp(argrest, "p") == 0) ftest_prefix = argv[i];
1789 else if (Ustrcmp(argrest, "s") == 0) ftest_suffix = argv[i];
1790 else { badarg = TRUE; break; }
1794 /* -bh: Host checking - an IP address must follow. */
1796 else if (Ustrcmp(argrest, "h") == 0 || Ustrcmp(argrest, "hc") == 0)
1798 if (++i >= argc) { badarg = TRUE; break; }
1799 sender_host_address = argv[i];
1800 host_checking = checking = log_testing_mode = TRUE;
1801 host_checking_callout = argrest[1] == 'c';
1804 /* -bi: This option is used by sendmail to initialize *the* alias file,
1805 though it has the -oA option to specify a different file. Exim has no
1806 concept of *the* alias file, but since Sun's YP make script calls
1807 sendmail this way, some support must be provided. */
1809 else if (Ustrcmp(argrest, "i") == 0) bi_option = TRUE;
1811 /* -bm: Accept and deliver message - the default option. Reinstate
1812 receiving_message, which got turned off for all -b options. */
1814 else if (Ustrcmp(argrest, "m") == 0) receiving_message = TRUE;
1816 /* -bnq: For locally originating messages, do not qualify unqualified
1817 addresses. In the envelope, this causes errors; in header lines they
1820 else if (Ustrcmp(argrest, "nq") == 0)
1822 allow_unqualified_sender = FALSE;
1823 allow_unqualified_recipient = FALSE;
1826 /* -bpxx: List the contents of the mail queue, in various forms. If
1827 the option is -bpc, just a queue count is needed. Otherwise, if the
1828 first letter after p is r, then order is random. */
1830 else if (*argrest == 'p')
1832 if (*(++argrest) == 'c')
1835 if (*(++argrest) != 0) badarg = TRUE;
1839 if (*argrest == 'r')
1841 list_queue_option = 8;
1844 else list_queue_option = 0;
1848 /* -bp: List the contents of the mail queue, top-level only */
1850 if (*argrest == 0) {}
1852 /* -bpu: List the contents of the mail queue, top-level undelivered */
1854 else if (Ustrcmp(argrest, "u") == 0) list_queue_option += 1;
1856 /* -bpa: List the contents of the mail queue, including all delivered */
1858 else if (Ustrcmp(argrest, "a") == 0) list_queue_option += 2;
1860 /* Unknown after -bp[r] */
1870 /* -bP: List the configuration variables given as the address list.
1871 Force -v, so configuration errors get displayed. */
1873 else if (Ustrcmp(argrest, "P") == 0)
1875 list_options = TRUE;
1876 debug_selector |= D_v;
1877 debug_file = stderr;
1880 /* -brt: Test retry configuration lookup */
1882 else if (Ustrcmp(argrest, "rt") == 0)
1884 test_retry_arg = i + 1;
1888 /* -brw: Test rewrite configuration */
1890 else if (Ustrcmp(argrest, "rw") == 0)
1892 test_rewrite_arg = i + 1;
1896 /* -bS: Read SMTP commands on standard input, but produce no replies -
1897 all errors are reported by sending messages. */
1899 else if (Ustrcmp(argrest, "S") == 0)
1900 smtp_input = smtp_batched_input = receiving_message = TRUE;
1902 /* -bs: Read SMTP commands on standard input and produce SMTP replies
1903 on standard output. */
1905 else if (Ustrcmp(argrest, "s") == 0) smtp_input = receiving_message = TRUE;
1907 /* -bt: address testing mode */
1909 else if (Ustrcmp(argrest, "t") == 0)
1910 address_test_mode = checking = log_testing_mode = TRUE;
1912 /* -bv: verify addresses */
1914 else if (Ustrcmp(argrest, "v") == 0)
1915 verify_address_mode = checking = log_testing_mode = TRUE;
1917 /* -bvs: verify sender addresses */
1919 else if (Ustrcmp(argrest, "vs") == 0)
1921 verify_address_mode = checking = log_testing_mode = TRUE;
1922 verify_as_sender = TRUE;
1925 /* -bV: Print version string and support details */
1927 else if (Ustrcmp(argrest, "V") == 0)
1929 printf("Exim version %s #%s built %s\n", version_string,
1930 version_cnumber, version_date);
1931 printf("%s\n", CS version_copyright);
1932 version_printed = TRUE;
1933 show_whats_supported(stdout);
1940 /* -C: change configuration file list; ignore if it isn't really
1941 a change! Enforce a prefix check if required. */
1946 if(++i < argc) argrest = argv[i]; else
1947 { badarg = TRUE; break; }
1949 if (Ustrcmp(config_main_filelist, argrest) != 0)
1951 #ifdef ALT_CONFIG_PREFIX
1953 int len = Ustrlen(ALT_CONFIG_PREFIX);
1954 uschar *list = argrest;
1956 while((filename = string_nextinlist(&list, &sep, big_buffer,
1957 big_buffer_size)) != NULL)
1959 if ((Ustrlen(filename) < len ||
1960 Ustrncmp(filename, ALT_CONFIG_PREFIX, len) != 0 ||
1961 Ustrstr(filename, "/../") != NULL) &&
1962 (Ustrcmp(filename, "/dev/null") != 0 || real_uid != root_uid))
1964 fprintf(stderr, "-C Permission denied\n");
1970 config_main_filelist = argrest;
1971 config_changed = TRUE;
1976 /* -D: set up a macro definition */
1979 #ifdef DISABLE_D_OPTION
1980 fprintf(stderr, "exim: -D is not available in this Exim binary\n");
1985 macro_item *mlast = NULL;
1988 uschar *s = argrest;
1990 while (isspace(*s)) s++;
1992 if (*s < 'A' || *s > 'Z')
1994 fprintf(stderr, "exim: macro name set by -D must start with "
1995 "an upper case letter\n");
1999 while (isalnum(*s) || *s == '_')
2001 if (ptr < sizeof(name)-1) name[ptr++] = *s;
2005 if (ptr == 0) { badarg = TRUE; break; }
2006 while (isspace(*s)) s++;
2009 if (*s++ != '=') { badarg = TRUE; break; }
2010 while (isspace(*s)) s++;
2013 for (m = macros; m != NULL; m = m->next)
2015 if (Ustrcmp(m->name, name) == 0)
2017 fprintf(stderr, "exim: duplicated -D in command line\n");
2023 m = store_get(sizeof(macro_item) + Ustrlen(name));
2025 m->command_line = TRUE;
2026 if (mlast == NULL) macros = m; else mlast->next = m;
2027 Ustrcpy(m->name, name);
2028 m->replacement = string_copy(s);
2030 if (clmacro_count >= MAX_CLMACROS)
2032 fprintf(stderr, "exim: too many -D options on command line\n");
2035 clmacros[clmacro_count++] = string_sprintf("-D%s=%s", m->name,
2041 /* -d: Set debug level (see also -v below) or set the drop_cr option.
2042 The latter is now a no-op, retained for compatibility only. If -dd is used,
2043 debugging subprocesses of the daemon is disabled. */
2046 if (Ustrcmp(argrest, "ropcr") == 0)
2048 /* drop_cr = TRUE; */
2051 /* Use an intermediate variable so that we don't set debugging while
2052 decoding the debugging bits. */
2056 unsigned int selector = D_default;
2059 if (*argrest == 'd')
2061 debug_daemon = TRUE;
2065 decode_bits(&selector, NULL, D_memory, 0, argrest, debug_options,
2066 debug_options_count, US"debug");
2067 debug_selector = selector;
2072 /* -E: This is a local error message. This option is not intended for
2073 external use at all, but is not restricted to trusted callers because it
2074 does no harm (just suppresses certain error messages) and if Exim is run
2075 not setuid root it won't always be trusted when it generates error
2076 messages using this option. If there is a message id following -E, point
2077 message_reference at it, for logging. */
2080 local_error_message = TRUE;
2081 if (mac_ismsgid(argrest)) message_reference = argrest;
2085 /* -ex: The vacation program calls sendmail with the undocumented "-eq"
2086 option, so it looks as if historically the -oex options are also callable
2087 without the leading -o. So we have to accept them. Before the switch,
2088 anything starting -oe has been converted to -e. Exim does not support all
2089 of the sendmail error options. */
2092 if (Ustrcmp(argrest, "e") == 0)
2094 arg_error_handling = ERRORS_SENDER;
2095 errors_sender_rc = EXIT_SUCCESS;
2097 else if (Ustrcmp(argrest, "m") == 0) arg_error_handling = ERRORS_SENDER;
2098 else if (Ustrcmp(argrest, "p") == 0) arg_error_handling = ERRORS_STDERR;
2099 else if (Ustrcmp(argrest, "q") == 0) arg_error_handling = ERRORS_STDERR;
2100 else if (Ustrcmp(argrest, "w") == 0) arg_error_handling = ERRORS_SENDER;
2105 /* -F: Set sender's full name, used instead of the gecos entry from
2106 the password file. Since users can usually alter their gecos entries,
2107 there's no security involved in using this instead. The data can follow
2108 the -F or be in the next argument. */
2113 if(++i < argc) argrest = argv[i]; else
2114 { badarg = TRUE; break; }
2116 originator_name = argrest;
2117 sender_name_forced = TRUE;
2121 /* -f: Set sender's address - this value is only actually used if Exim is
2122 run by a trusted user, or if untrusted_set_sender is set and matches the
2123 address, except that the null address can always be set by any user. The
2124 test for this happens later, when the value given here is ignored when not
2125 permitted. For an untrusted user, the actual sender is still put in Sender:
2126 if it doesn't match the From: header (unless no_local_from_check is set).
2127 The data can follow the -f or be in the next argument. The -r switch is an
2128 obsolete form of -f but since there appear to be programs out there that
2129 use anything that sendmail has ever supported, better accept it - the
2130 synonymizing is done before the switch above.
2132 At this stage, we must allow domain literal addresses, because we don't
2133 know what the setting of allow_domain_literals is yet. Ditto for trailing
2134 dots and strip_trailing_dot. */
2142 if (i+1 < argc) argrest = argv[++i]; else
2143 { badarg = TRUE; break; }
2147 sender_address = string_sprintf(""); /* Ensure writeable memory */
2151 uschar *temp = argrest + Ustrlen(argrest) - 1;
2152 while (temp >= argrest && isspace(*temp)) temp--;
2153 if (temp >= argrest && *temp == '.') f_end_dot = TRUE;
2154 allow_domain_literals = TRUE;
2155 strip_trailing_dot = TRUE;
2156 sender_address = parse_extract_address(argrest, &errmess, &start, &end,
2157 &sender_address_domain, TRUE);
2158 allow_domain_literals = FALSE;
2159 strip_trailing_dot = FALSE;
2160 if (sender_address == NULL)
2162 fprintf(stderr, "exim: bad -f address \"%s\": %s\n", argrest, errmess);
2163 return EXIT_FAILURE;
2166 sender_address_forced = TRUE;
2170 /* This is some Sendmail thing which can be ignored */
2175 /* -h: Set the hop count for an incoming message. Exim does not currently
2176 support this; it always computes it by counting the Received: headers.
2177 To put it in will require a change to the spool header file format. */
2182 if(++i < argc) argrest = argv[i]; else
2183 { badarg = TRUE; break; }
2185 if (!isdigit(*argrest)) badarg = TRUE;
2189 /* -i: Set flag so dot doesn't end non-SMTP input (same as -oi, seems
2190 not to be documented for sendmail but mailx (at least) uses it) */
2193 if (*argrest == 0) dot_ends = FALSE; else badarg = TRUE;
2198 receiving_message = FALSE;
2200 /* -MC: continue delivery of another message via an existing open
2201 file descriptor. This option is used for an internal call by the
2202 smtp transport when there is a pending message waiting to go to an
2203 address to which it has got a connection. Five subsequent arguments are
2204 required: transport name, host name, IP address, sequence number, and
2205 message_id. Transports may decline to create new processes if the sequence
2206 number gets too big. The channel is stdin. This (-MC) must be the last
2207 argument. There's a subsequent check that the real-uid is privileged.
2209 If we are running in the test harness. delay for a bit, to let the process
2210 that set this one up complete. This makes for repeatability of the logging,
2213 if (Ustrcmp(argrest, "C") == 0)
2215 union sockaddr_46 interface_sock;
2216 EXIM_SOCKLEN_T size = sizeof(interface_sock);
2220 fprintf(stderr, "exim: too many or too few arguments after -MC\n");
2221 return EXIT_FAILURE;
2224 if (msg_action_arg >= 0)
2226 fprintf(stderr, "exim: incompatible arguments\n");
2227 return EXIT_FAILURE;
2230 continue_transport = argv[++i];
2231 continue_hostname = argv[++i];
2232 continue_host_address = argv[++i];
2233 continue_sequence = Uatoi(argv[++i]);
2234 msg_action = MSG_DELIVER;
2235 msg_action_arg = ++i;
2236 forced_delivery = TRUE;
2237 queue_run_pid = passed_qr_pid;
2238 queue_run_pipe = passed_qr_pipe;
2240 if (!mac_ismsgid(argv[i]))
2242 fprintf(stderr, "exim: malformed message id %s after -MC option\n",
2244 return EXIT_FAILURE;
2247 /* Set up $sending_ip_address and $sending_port */
2249 if (getsockname(fileno(stdin), (struct sockaddr *)(&interface_sock),
2251 sending_ip_address = host_ntoa(-1, &interface_sock, NULL,
2255 fprintf(stderr, "exim: getsockname() failed after -MC option: %s\n",
2257 return EXIT_FAILURE;
2260 if (running_in_test_harness) millisleep(500);
2264 /* -MCA: set the smtp_authenticated flag; this is useful only when it
2265 precedes -MC (see above). The flag indicates that the host to which
2266 Exim is connected has accepted an AUTH sequence. */
2268 else if (Ustrcmp(argrest, "CA") == 0)
2270 smtp_authenticated = TRUE;
2274 /* -MCP: set the smtp_use_pipelining flag; this is useful only when
2275 it preceded -MC (see above) */
2277 else if (Ustrcmp(argrest, "CP") == 0)
2279 smtp_use_pipelining = TRUE;
2283 /* -MCQ: pass on the pid of the queue-running process that started
2284 this chain of deliveries and the fd of its synchronizing pipe; this
2285 is useful only when it precedes -MC (see above) */
2287 else if (Ustrcmp(argrest, "CQ") == 0)
2289 if(++i < argc) passed_qr_pid = (pid_t)(Uatol(argv[i]));
2291 if(++i < argc) passed_qr_pipe = (int)(Uatol(argv[i]));
2296 /* -MCS: set the smtp_use_size flag; this is useful only when it
2297 precedes -MC (see above) */
2299 else if (Ustrcmp(argrest, "CS") == 0)
2301 smtp_use_size = TRUE;
2305 /* -MCT: set the tls_offered flag; this is useful only when it
2306 precedes -MC (see above). The flag indicates that the host to which
2307 Exim is connected has offered TLS support. */
2310 else if (Ustrcmp(argrest, "CT") == 0)
2317 /* -M[x]: various operations on the following list of message ids:
2318 -M deliver the messages, ignoring next retry times and thawing
2319 -Mc deliver the messages, checking next retry times, no thawing
2320 -Mf freeze the messages
2321 -Mg give up on the messages
2322 -Mt thaw the messages
2323 -Mrm remove the messages
2324 In the above cases, this must be the last option. There are also the
2325 following options which are followed by a single message id, and which
2326 act on that message. Some of them use the "recipient" addresses as well.
2327 -Mar add recipient(s)
2328 -Mmad mark all recipients delivered
2329 -Mmd mark recipients(s) delivered
2331 -Mset load a message for use with -be
2333 -Mvc show copy (of whole message, in RFC 2822 format)
2338 else if (*argrest == 0)
2340 msg_action = MSG_DELIVER;
2341 forced_delivery = deliver_force_thaw = TRUE;
2343 else if (Ustrcmp(argrest, "ar") == 0)
2345 msg_action = MSG_ADD_RECIPIENT;
2346 one_msg_action = TRUE;
2348 else if (Ustrcmp(argrest, "c") == 0) msg_action = MSG_DELIVER;
2349 else if (Ustrcmp(argrest, "es") == 0)
2351 msg_action = MSG_EDIT_SENDER;
2352 one_msg_action = TRUE;
2354 else if (Ustrcmp(argrest, "f") == 0) msg_action = MSG_FREEZE;
2355 else if (Ustrcmp(argrest, "g") == 0)
2357 msg_action = MSG_DELIVER;
2358 deliver_give_up = TRUE;
2360 else if (Ustrcmp(argrest, "mad") == 0)
2362 msg_action = MSG_MARK_ALL_DELIVERED;
2364 else if (Ustrcmp(argrest, "md") == 0)
2366 msg_action = MSG_MARK_DELIVERED;
2367 one_msg_action = TRUE;
2369 else if (Ustrcmp(argrest, "rm") == 0) msg_action = MSG_REMOVE;
2370 else if (Ustrcmp(argrest, "set") == 0)
2372 msg_action = MSG_LOAD;
2373 one_msg_action = TRUE;
2375 else if (Ustrcmp(argrest, "t") == 0) msg_action = MSG_THAW;
2376 else if (Ustrcmp(argrest, "vb") == 0)
2378 msg_action = MSG_SHOW_BODY;
2379 one_msg_action = TRUE;
2381 else if (Ustrcmp(argrest, "vc") == 0)
2383 msg_action = MSG_SHOW_COPY;
2384 one_msg_action = TRUE;
2386 else if (Ustrcmp(argrest, "vh") == 0)
2388 msg_action = MSG_SHOW_HEADER;
2389 one_msg_action = TRUE;
2391 else if (Ustrcmp(argrest, "vl") == 0)
2393 msg_action = MSG_SHOW_LOG;
2394 one_msg_action = TRUE;
2396 else { badarg = TRUE; break; }
2398 /* All the -Mxx options require at least one message id. */
2400 msg_action_arg = i + 1;
2401 if (msg_action_arg >= argc)
2403 fprintf(stderr, "exim: no message ids given after %s option\n", arg);
2404 return EXIT_FAILURE;
2407 /* Some require only message ids to follow */
2409 if (!one_msg_action)
2412 for (j = msg_action_arg; j < argc; j++) if (!mac_ismsgid(argv[j]))
2414 fprintf(stderr, "exim: malformed message id %s after %s option\n",
2416 return EXIT_FAILURE;
2418 goto END_ARG; /* Remaining args are ids */
2421 /* Others require only one message id, possibly followed by addresses,
2422 which will be handled as normal arguments. */
2426 if (!mac_ismsgid(argv[msg_action_arg]))
2428 fprintf(stderr, "exim: malformed message id %s after %s option\n",
2429 argv[msg_action_arg], arg);
2430 return EXIT_FAILURE;
2437 /* Some programs seem to call the -om option without the leading o;
2438 for sendmail it askes for "me too". Exim always does this. */
2441 if (*argrest != 0) badarg = TRUE;
2445 /* -N: don't do delivery - a debugging option that stops transports doing
2446 their thing. It implies debugging at the D_v level. */
2451 dont_deliver = TRUE;
2452 debug_selector |= D_v;
2453 debug_file = stderr;
2459 /* -n: This means "don't alias" in sendmail, apparently. Just ignore
2465 /* -O: Just ignore it. In sendmail, apparently -O option=value means set
2466 option to the specified value. This form uses long names. We need to handle
2467 -O option=value and -Ooption=value. */
2474 fprintf(stderr, "exim: string expected after -O\n");
2482 /* -oA: Set an argument for the bi command (sendmail's "alternate alias
2485 if (*argrest == 'A')
2487 alias_arg = argrest + 1;
2488 if (alias_arg[0] == 0)
2490 if (i+1 < argc) alias_arg = argv[++i]; else
2492 fprintf(stderr, "exim: string expected after -oA\n");
2498 /* -oB: Set a connection message max value for remote deliveries */
2500 else if (*argrest == 'B')
2502 uschar *p = argrest + 1;
2505 if (i+1 < argc && isdigit((argv[i+1][0]))) p = argv[++i]; else
2507 connection_max_messages = 1;
2516 fprintf(stderr, "exim: number expected after -oB\n");
2519 connection_max_messages = Uatoi(p);
2523 /* -odb: background delivery */
2525 else if (Ustrcmp(argrest, "db") == 0)
2527 synchronous_delivery = FALSE;
2528 arg_queue_only = FALSE;
2529 queue_only_set = TRUE;
2532 /* -odf: foreground delivery (smail-compatible option); same effect as
2533 -odi: interactive (synchronous) delivery (sendmail-compatible option)
2536 else if (Ustrcmp(argrest, "df") == 0 || Ustrcmp(argrest, "di") == 0)
2538 synchronous_delivery = TRUE;
2539 arg_queue_only = FALSE;
2540 queue_only_set = TRUE;
2543 /* -odq: queue only */
2545 else if (Ustrcmp(argrest, "dq") == 0)
2547 synchronous_delivery = FALSE;
2548 arg_queue_only = TRUE;
2549 queue_only_set = TRUE;
2552 /* -odqs: queue SMTP only - do local deliveries and remote routing,
2553 but no remote delivery */
2555 else if (Ustrcmp(argrest, "dqs") == 0)
2558 arg_queue_only = FALSE;
2559 queue_only_set = TRUE;
2562 /* -oex: Sendmail error flags. As these are also accepted without the
2563 leading -o prefix, for compatibility with vacation and other callers,
2564 they are handled with -e above. */
2566 /* -oi: Set flag so dot doesn't end non-SMTP input (same as -i)
2567 -oitrue: Another sendmail syntax for the same */
2569 else if (Ustrcmp(argrest, "i") == 0 ||
2570 Ustrcmp(argrest, "itrue") == 0)
2573 /* -oM*: Set various characteristics for an incoming message; actually
2574 acted on for trusted callers only. */
2576 else if (*argrest == 'M')
2580 fprintf(stderr, "exim: data expected after -o%s\n", argrest);
2584 /* -oMa: Set sender host address */
2586 if (Ustrcmp(argrest, "Ma") == 0) sender_host_address = argv[++i];
2588 /* -oMaa: Set authenticator name */
2590 else if (Ustrcmp(argrest, "Maa") == 0)
2591 sender_host_authenticated = argv[++i];
2593 /* -oMas: setting authenticated sender */
2595 else if (Ustrcmp(argrest, "Mas") == 0) authenticated_sender = argv[++i];
2597 /* -oMai: setting authenticated id */
2599 else if (Ustrcmp(argrest, "Mai") == 0) authenticated_id = argv[++i];
2601 /* -oMi: Set incoming interface address */
2603 else if (Ustrcmp(argrest, "Mi") == 0) interface_address = argv[++i];
2605 /* -oMr: Received protocol */
2607 else if (Ustrcmp(argrest, "Mr") == 0) received_protocol = argv[++i];
2609 /* -oMs: Set sender host name */
2611 else if (Ustrcmp(argrest, "Ms") == 0) sender_host_name = argv[++i];
2613 /* -oMt: Set sender ident */
2615 else if (Ustrcmp(argrest, "Mt") == 0)
2617 sender_ident_set = TRUE;
2618 sender_ident = argv[++i];
2621 /* Else a bad argument */
2630 /* -om: Me-too flag for aliases. Exim always does this. Some programs
2631 seem to call this as -m (undocumented), so that is also accepted (see
2634 else if (Ustrcmp(argrest, "m") == 0) {}
2636 /* -oo: An ancient flag for old-style addresses which still seems to
2637 crop up in some calls (see in SCO). */
2639 else if (Ustrcmp(argrest, "o") == 0) {}
2641 /* -oP <name>: set pid file path for daemon */
2643 else if (Ustrcmp(argrest, "P") == 0)
2644 override_pid_file_path = argv[++i];
2646 /* -or <n>: set timeout for non-SMTP acceptance
2647 -os <n>: set timeout for SMTP acceptance */
2649 else if (*argrest == 'r' || *argrest == 's')
2651 int *tp = (*argrest == 'r')?
2652 &arg_receive_timeout : &arg_smtp_receive_timeout;
2653 if (argrest[1] == 0)
2655 if (i+1 < argc) *tp= readconf_readtime(argv[++i], 0, FALSE);
2657 else *tp = readconf_readtime(argrest + 1, 0, FALSE);
2660 fprintf(stderr, "exim: bad time value %s: abandoned\n", argv[i]);
2665 /* -oX <list>: Override local_interfaces and/or default daemon ports */
2667 else if (Ustrcmp(argrest, "X") == 0)
2668 override_local_interfaces = argv[++i];
2670 /* Unknown -o argument */
2676 /* -ps: force Perl startup; -pd force delayed Perl startup */
2680 if (*argrest == 's' && argrest[1] == 0)
2682 perl_start_option = 1;
2685 if (*argrest == 'd' && argrest[1] == 0)
2687 perl_start_option = -1;
2692 /* -panythingelse is taken as the Sendmail-compatible argument -prval:sval,
2693 which sets the host protocol and host name */
2697 if (i+1 < argc) argrest = argv[++i]; else
2698 { badarg = TRUE; break; }
2703 uschar *hn = Ustrchr(argrest, ':');
2706 received_protocol = argrest;
2710 received_protocol = string_copyn(argrest, hn - argrest);
2711 sender_host_name = hn + 1;
2718 receiving_message = FALSE;
2719 if (queue_interval >= 0)
2721 fprintf(stderr, "exim: -q specified more than once\n");
2725 /* -qq...: Do queue runs in a 2-stage manner */
2727 if (*argrest == 'q')
2729 queue_2stage = TRUE;
2733 /* -qi...: Do only first (initial) deliveries */
2735 if (*argrest == 'i')
2737 queue_run_first_delivery = TRUE;
2741 /* -qf...: Run the queue, forcing deliveries
2742 -qff..: Ditto, forcing thawing as well */
2744 if (*argrest == 'f')
2746 queue_run_force = TRUE;
2747 if (*(++argrest) == 'f')
2749 deliver_force_thaw = TRUE;
2754 /* -q[f][f]l...: Run the queue only on local deliveries */
2756 if (*argrest == 'l')
2758 queue_run_local = TRUE;
2762 /* -q[f][f][l]: Run the queue, optionally forced, optionally local only,
2763 optionally starting from a given message id. */
2765 if (*argrest == 0 &&
2766 (i + 1 >= argc || argv[i+1][0] == '-' || mac_ismsgid(argv[i+1])))
2769 if (i+1 < argc && mac_ismsgid(argv[i+1]))
2770 start_queue_run_id = argv[++i];
2771 if (i+1 < argc && mac_ismsgid(argv[i+1]))
2772 stop_queue_run_id = argv[++i];
2775 /* -q[f][f][l]<n>: Run the queue at regular intervals, optionally forced,
2776 optionally local only. */
2781 queue_interval = readconf_readtime(argrest, 0, FALSE);
2783 queue_interval = readconf_readtime(argv[++i], 0, FALSE);
2784 if (queue_interval <= 0)
2786 fprintf(stderr, "exim: bad time value %s: abandoned\n", argv[i]);
2793 case 'R': /* Synonymous with -qR... */
2794 receiving_message = FALSE;
2796 /* -Rf: As -R (below) but force all deliveries,
2797 -Rff: Ditto, but also thaw all frozen messages,
2798 -Rr: String is regex
2799 -Rrf: Regex and force
2800 -Rrff: Regex and force and thaw
2802 in all cases provided there are no further characters in this
2808 for (i = 0; i < sizeof(rsopts)/sizeof(uschar *); i++)
2810 if (Ustrcmp(argrest, rsopts[i]) == 0)
2812 if (i != 2) queue_run_force = TRUE;
2813 if (i >= 2) deliver_selectstring_regex = TRUE;
2814 if (i == 1 || i == 4) deliver_force_thaw = TRUE;
2815 argrest += Ustrlen(rsopts[i]);
2820 /* -R: Set string to match in addresses for forced queue run to
2821 pick out particular messages. */
2825 if (i+1 < argc) deliver_selectstring = argv[++i]; else
2827 fprintf(stderr, "exim: string expected after -R\n");
2831 else deliver_selectstring = argrest;
2835 /* -r: an obsolete synonym for -f (see above) */
2838 /* -S: Like -R but works on sender. */
2840 case 'S': /* Synonymous with -qS... */
2841 receiving_message = FALSE;
2843 /* -Sf: As -S (below) but force all deliveries,
2844 -Sff: Ditto, but also thaw all frozen messages,
2845 -Sr: String is regex
2846 -Srf: Regex and force
2847 -Srff: Regex and force and thaw
2849 in all cases provided there are no further characters in this
2855 for (i = 0; i < sizeof(rsopts)/sizeof(uschar *); i++)
2857 if (Ustrcmp(argrest, rsopts[i]) == 0)
2859 if (i != 2) queue_run_force = TRUE;
2860 if (i >= 2) deliver_selectstring_sender_regex = TRUE;
2861 if (i == 1 || i == 4) deliver_force_thaw = TRUE;
2862 argrest += Ustrlen(rsopts[i]);
2867 /* -S: Set string to match in addresses for forced queue run to
2868 pick out particular messages. */
2872 if (i+1 < argc) deliver_selectstring_sender = argv[++i]; else
2874 fprintf(stderr, "exim: string expected after -S\n");
2878 else deliver_selectstring_sender = argrest;
2881 /* -Tqt is an option that is exclusively for use by the testing suite.
2882 It is not recognized in other circumstances. It allows for the setting up
2883 of explicit "queue times" so that various warning/retry things can be
2884 tested. Otherwise variability of clock ticks etc. cause problems. */
2887 if (running_in_test_harness && Ustrcmp(argrest, "qt") == 0)
2888 fudged_queue_times = argv[++i];
2893 /* -t: Set flag to extract recipients from body of message. */
2896 if (*argrest == 0) extract_recipients = TRUE;
2898 /* -ti: Set flag to extract recipients from body of message, and also
2899 specify that dot does not end the message. */
2901 else if (Ustrcmp(argrest, "i") == 0)
2903 extract_recipients = TRUE;
2907 /* -tls-on-connect: don't wait for STARTTLS (for old clients) */
2910 else if (Ustrcmp(argrest, "ls-on-connect") == 0) tls_on_connect = TRUE;
2917 /* -U: This means "initial user submission" in sendmail, apparently. The
2918 doc claims that in future sendmail may refuse syntactically invalid
2919 messages instead of fixing them. For the moment, we just ignore it. */
2925 /* -v: verify things - this is a very low-level debugging */
2930 debug_selector |= D_v;
2931 debug_file = stderr;
2937 /* -x: AIX uses this to indicate some fancy 8-bit character stuff:
2939 The -x flag tells the sendmail command that mail from a local
2940 mail program has National Language Support (NLS) extended characters
2941 in the body of the mail item. The sendmail command can send mail with
2942 extended NLS characters across networks that normally corrupts these
2945 As Exim is 8-bit clean, it just ignores this flag. */
2948 if (*argrest != 0) badarg = TRUE;
2951 /* All other initial characters are errors */
2956 } /* End of high-level switch statement */
2958 /* Failed to recognize the option, or syntax error */
2962 fprintf(stderr, "exim abandoned: unknown, malformed, or incomplete "
2963 "option %s\n", arg);
2969 /* If -R or -S have been specified without -q, assume a single queue run. */
2971 if ((deliver_selectstring != NULL || deliver_selectstring_sender != NULL) &&
2972 queue_interval < 0) queue_interval = 0;
2976 /* If usage_wanted is set we call the usage function - which never returns */
2977 if (usage_wanted) exim_usage(called_as);
2979 /* Arguments have been processed. Check for incompatibilities. */
2981 (smtp_input || extract_recipients || recipients_arg < argc) &&
2982 (daemon_listen || queue_interval >= 0 || bi_option ||
2983 test_retry_arg >= 0 || test_rewrite_arg >= 0 ||
2984 filter_test != FTEST_NONE || (msg_action_arg > 0 && !one_msg_action))
2987 msg_action_arg > 0 &&
2988 (daemon_listen || queue_interval >= 0 || list_options ||
2989 (checking && msg_action != MSG_LOAD) ||
2990 bi_option || test_retry_arg >= 0 || test_rewrite_arg >= 0)
2993 (daemon_listen || queue_interval >= 0) &&
2994 (sender_address != NULL || list_options || list_queue || checking ||
2998 daemon_listen && queue_interval == 0
3002 (checking || smtp_input || extract_recipients ||
3003 filter_test != FTEST_NONE || bi_option)
3006 verify_address_mode &&
3007 (address_test_mode || smtp_input || extract_recipients ||
3008 filter_test != FTEST_NONE || bi_option)
3011 address_test_mode && (smtp_input || extract_recipients ||
3012 filter_test != FTEST_NONE || bi_option)
3015 smtp_input && (sender_address != NULL || filter_test != FTEST_NONE ||
3019 deliver_selectstring != NULL && queue_interval < 0
3022 msg_action == MSG_LOAD &&
3023 (!expansion_test || expansion_test_message != NULL)
3027 fprintf(stderr, "exim: incompatible command-line options or arguments\n");
3031 /* If debugging is set up, set the file and the file descriptor to pass on to
3032 child processes. It should, of course, be 2 for stderr. Also, force the daemon
3033 to run in the foreground. */
3035 if (debug_selector != 0)
3037 debug_file = stderr;
3038 debug_fd = fileno(debug_file);
3039 background_daemon = FALSE;
3040 if (running_in_test_harness) millisleep(100); /* lets caller finish */
3041 if (debug_selector != D_v) /* -v only doesn't show this */
3043 debug_printf("Exim version %s uid=%ld gid=%ld pid=%d D=%x\n",
3044 version_string, (long int)real_uid, (long int)real_gid, (int)getpid(),
3046 show_whats_supported(stderr);
3050 /* When started with root privilege, ensure that the limits on the number of
3051 open files and the number of processes (where that is accessible) are
3052 sufficiently large, or are unset, in case Exim has been called from an
3053 environment where the limits are screwed down. Not all OS have the ability to
3054 change some of these limits. */
3058 DEBUG(D_any) debug_print_ids(US"Exim has no root privilege:");
3064 #ifdef RLIMIT_NOFILE
3065 if (getrlimit(RLIMIT_NOFILE, &rlp) < 0)
3067 log_write(0, LOG_MAIN|LOG_PANIC, "getrlimit(RLIMIT_NOFILE) failed: %s",
3069 rlp.rlim_cur = rlp.rlim_max = 0;
3072 /* I originally chose 1000 as a nice big number that was unlikely to
3073 be exceeded. It turns out that some older OS have a fixed upper limit of
3076 if (rlp.rlim_cur < 1000)
3078 rlp.rlim_cur = rlp.rlim_max = 1000;
3079 if (setrlimit(RLIMIT_NOFILE, &rlp) < 0)
3081 rlp.rlim_cur = rlp.rlim_max = 256;
3082 if (setrlimit(RLIMIT_NOFILE, &rlp) < 0)
3083 log_write(0, LOG_MAIN|LOG_PANIC, "setrlimit(RLIMIT_NOFILE) failed: %s",
3090 if (getrlimit(RLIMIT_NPROC, &rlp) < 0)
3092 log_write(0, LOG_MAIN|LOG_PANIC, "getrlimit(RLIMIT_NPROC) failed: %s",
3094 rlp.rlim_cur = rlp.rlim_max = 0;
3097 #ifdef RLIM_INFINITY
3098 if (rlp.rlim_cur != RLIM_INFINITY && rlp.rlim_cur < 1000)
3100 rlp.rlim_cur = rlp.rlim_max = RLIM_INFINITY;
3102 if (rlp.rlim_cur < 1000)
3104 rlp.rlim_cur = rlp.rlim_max = 1000;
3106 if (setrlimit(RLIMIT_NPROC, &rlp) < 0)
3107 log_write(0, LOG_MAIN|LOG_PANIC, "setrlimit(RLIMIT_NPROC) failed: %s",
3113 /* Exim is normally entered as root (but some special configurations are
3114 possible that don't do this). However, it always spins off sub-processes that
3115 set their uid and gid as required for local delivery. We don't want to pass on
3116 any extra groups that root may belong to, so we want to get rid of them all at
3119 We need to obey setgroups() at this stage, before possibly giving up root
3120 privilege for a changed configuration file, but later on we might need to
3121 check on the additional groups for the admin user privilege - can't do that
3122 till after reading the config, which might specify the exim gid. Therefore,
3123 save the group list here first. */
3125 group_count = getgroups(NGROUPS_MAX, group_list);
3127 /* There is a fundamental difference in some BSD systems in the matter of
3128 groups. FreeBSD and BSDI are known to be different; NetBSD and OpenBSD are
3129 known not to be different. On the "different" systems there is a single group
3130 list, and the first entry in it is the current group. On all other versions of
3131 Unix there is a supplementary group list, which is in *addition* to the current
3132 group. Consequently, to get rid of all extraneous groups on a "standard" system
3133 you pass over 0 groups to setgroups(), while on a "different" system you pass
3134 over a single group - the current group, which is always the first group in the
3135 list. Calling setgroups() with zero groups on a "different" system results in
3136 an error return. The following code should cope with both types of system.
3138 However, if this process isn't running as root, setgroups() can't be used
3139 since you have to be root to run it, even if throwing away groups. Not being
3140 root here happens only in some unusual configurations. We just ignore the
3143 if (setgroups(0, NULL) != 0)
3145 if (setgroups(1, group_list) != 0 && !unprivileged)
3147 fprintf(stderr, "exim: setgroups() failed: %s\n", strerror(errno));
3152 /* If the configuration file name has been altered by an argument on the
3153 command line (either a new file name or a macro definition) and the caller is
3154 not root or the exim user, or if this is a filter testing run, remove any
3155 setuid privilege the program has, and run as the underlying user.
3157 If ALT_CONFIG_ROOT_ONLY is defined, the exim user is locked out of this, which
3158 severely restricts the use of -C for some purposes.
3160 Otherwise, set the real ids to the effective values (should be root unless run
3161 from inetd, which it can either be root or the exim uid, if one is configured).
3163 There is a private mechanism for bypassing some of this, in order to make it
3164 possible to test lots of configurations automatically, without having either to
3165 recompile each time, or to patch in an actual configuration file name and other
3166 values (such as the path name). If running in the test harness, pretend that
3167 configuration file changes and macro definitions haven't happened. */
3170 (config_changed || macros != NULL) && /* Config changed, and */
3171 real_uid != root_uid && /* Not root, and */
3172 #ifndef ALT_CONFIG_ROOT_ONLY /* (when not locked out) */
3173 real_uid != exim_uid && /* Not exim, and */
3175 !running_in_test_harness /* Not fudged */
3177 expansion_test /* expansion testing */
3179 filter_test != FTEST_NONE) /* Filter testing */
3181 setgroups(group_count, group_list);
3182 exim_setugid(real_uid, real_gid, FALSE,
3183 US"-C, -D, -be or -bf forces real uid");
3184 removed_privilege = TRUE;
3186 /* In the normal case when Exim is called like this, stderr is available
3187 and should be used for any logging information because attempts to write
3188 to the log will usually fail. To arrange this, we unset really_exim. However,
3189 if no stderr is available there is no point - we might as well have a go
3190 at the log (if it fails, syslog will be written). */
3192 if (log_stderr != NULL) really_exim = FALSE;
3195 /* Privilege is to be retained for the moment. It may be dropped later,
3196 depending on the job that this Exim process has been asked to do. For now, set
3197 the real uid to the effective so that subsequent re-execs of Exim are done by a
3200 else exim_setugid(geteuid(), getegid(), FALSE, US"forcing real = effective");
3202 /* If testing a filter, open the file(s) now, before wasting time doing other
3203 setups and reading the message. */
3205 if ((filter_test & FTEST_SYSTEM) != 0)
3207 filter_sfd = Uopen(filter_test_sfile, O_RDONLY, 0);
3210 fprintf(stderr, "exim: failed to open %s: %s\n", filter_test_sfile,
3212 return EXIT_FAILURE;
3216 if ((filter_test & FTEST_USER) != 0)
3218 filter_ufd = Uopen(filter_test_ufile, O_RDONLY, 0);
3221 fprintf(stderr, "exim: failed to open %s: %s\n", filter_test_ufile,
3223 return EXIT_FAILURE;
3227 /* Read the main runtime configuration data; this gives up if there
3228 is a failure. It leaves the configuration file open so that the subsequent
3229 configuration data for delivery can be read if needed. */
3233 /* Handle the decoding of logging options. */
3235 decode_bits(&log_write_selector, &log_extra_selector, 0, 0, log_selector_string,
3236 log_options, log_options_count, US"log");
3240 debug_printf("configuration file is %s\n", config_main_filename);
3241 debug_printf("log selectors = %08x %08x\n", log_write_selector,
3242 log_extra_selector);
3245 /* If domain literals are not allowed, check the sender address that was
3246 supplied with -f. Ditto for a stripped trailing dot. */
3248 if (sender_address != NULL)
3250 if (sender_address[sender_address_domain] == '[' && !allow_domain_literals)
3252 fprintf(stderr, "exim: bad -f address \"%s\": domain literals not "
3253 "allowed\n", sender_address);
3254 return EXIT_FAILURE;
3256 if (f_end_dot && !strip_trailing_dot)
3258 fprintf(stderr, "exim: bad -f address \"%s.\": domain is malformed "
3259 "(trailing dot not allowed)\n", sender_address);
3260 return EXIT_FAILURE;
3264 /* Paranoia check of maximum lengths of certain strings. There is a check
3265 on the length of the log file path in log.c, which will come into effect
3266 if there are any calls to write the log earlier than this. However, if we
3267 get this far but the string is very long, it is better to stop now than to
3268 carry on and (e.g.) receive a message and then have to collapse. The call to
3269 log_write() from here will cause the ultimate panic collapse if the complete
3270 file name exceeds the buffer length. */
3272 if (Ustrlen(log_file_path) > 200)
3273 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3274 "log_file_path is longer than 200 chars: aborting");
3276 if (Ustrlen(pid_file_path) > 200)
3277 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3278 "pid_file_path is longer than 200 chars: aborting");
3280 if (Ustrlen(spool_directory) > 200)
3281 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3282 "spool_directory is longer than 200 chars: aborting");
3284 /* Length check on the process name given to syslog for its TAG field,
3285 which is only permitted to be 32 characters or less. See RFC 3164. */
3287 if (Ustrlen(syslog_processname) > 32)
3288 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3289 "syslog_processname is longer than 32 chars: aborting");
3291 /* In some operating systems, the environment variable TMPDIR controls where
3292 temporary files are created; Exim doesn't use these (apart from when delivering
3293 to MBX mailboxes), but called libraries such as DBM libraries may require them.
3294 If TMPDIR is found in the environment, reset it to the value defined in the
3295 TMPDIR macro, if this macro is defined. */
3300 for (p = USS environ; *p != NULL; p++)
3302 if (Ustrncmp(*p, "TMPDIR=", 7) == 0 &&
3303 Ustrcmp(*p+7, TMPDIR) != 0)
3305 uschar *newp = malloc(Ustrlen(TMPDIR) + 8);
3306 sprintf(CS newp, "TMPDIR=%s", TMPDIR);
3308 DEBUG(D_any) debug_printf("reset TMPDIR=%s in environment\n", TMPDIR);
3314 /* Timezone handling. If timezone_string is "utc", set a flag to cause all
3315 timestamps to be in UTC (gmtime() is used instead of localtime()). Otherwise,
3316 we may need to get rid of a bogus timezone setting. This can arise when Exim is
3317 called by a user who has set the TZ variable. This then affects the timestamps
3318 in log files and in Received: headers, and any created Date: header lines. The
3319 required timezone is settable in the configuration file, so nothing can be done
3320 about this earlier - but hopefully nothing will normally be logged earlier than
3321 this. We have to make a new environment if TZ is wrong, but don't bother if
3322 timestamps_utc is set, because then all times are in UTC anyway. */
3324 if (timezone_string != NULL && strcmpic(timezone_string, US"UTC") == 0)
3326 timestamps_utc = TRUE;
3330 uschar *envtz = US getenv("TZ");
3331 if ((envtz == NULL && timezone_string != NULL) ||
3333 (timezone_string == NULL ||
3334 Ustrcmp(timezone_string, envtz) != 0)))
3336 uschar **p = USS environ;
3340 while (*p++ != NULL) count++;
3341 if (envtz == NULL) count++;
3342 newp = new = malloc(sizeof(uschar *) * (count + 1));
3343 for (p = USS environ; *p != NULL; p++)
3345 if (Ustrncmp(*p, "TZ=", 3) == 0) continue;
3348 if (timezone_string != NULL)
3350 *newp = malloc(Ustrlen(timezone_string) + 4);
3351 sprintf(CS *newp++, "TZ=%s", timezone_string);
3356 DEBUG(D_any) debug_printf("Reset TZ to %s: time is %s\n", timezone_string,
3357 tod_stamp(tod_log));
3361 /* Handle the case when we have removed the setuid privilege because of -C or
3362 -D. This means that the caller of Exim was not root, and, provided that
3363 ALT_CONFIG_ROOT_ONLY is not defined, was not the Exim user that is built into
3366 If ALT_CONFIG_ROOT_ONLY is not defined, there is a problem if it turns out we
3367 were running as the exim user defined in the configuration file (different to
3368 the one in the binary). The sysadmin may expect this case to retain privilege
3369 because "the binary was called by the Exim user", but it hasn't, because of the
3370 order in which it handles this stuff. There are two possibilities:
3372 (1) If deliver_drop_privilege is set, Exim is not going to re-exec in order
3373 to do message deliveries. Thus, the fact that it is running as a
3374 non-privileged user is plausible, and might be wanted in some special
3375 configurations. However, really_exim will have been set false when
3376 privilege was dropped, to stop Exim trying to write to its normal log
3377 files. Therefore, re-enable normal log processing, assuming the sysadmin
3378 has set up the log directory correctly.
3380 (2) If deliver_drop_privilege is not set, the configuration won't work as
3381 apparently intended, and so we log a panic message. In order to retain
3382 root for -C or -D, the caller must either be root or the Exim user
3383 defined in the binary (when deliver_drop_ privilege is false).
3385 If ALT_CONFIG_ROOT_ONLY is defined, we don't know whether we were called by the
3386 built-in exim user or one defined in the configuration. In either event,
3387 re-enable log processing, assuming the sysadmin knows what they are doing. */
3389 if (removed_privilege && (config_changed || macros != NULL) &&
3390 real_uid == exim_uid)
3392 #ifdef ALT_CONFIG_ROOT_ONLY
3393 really_exim = TRUE; /* let logging work normally */
3396 if (deliver_drop_privilege)
3397 really_exim = TRUE; /* let logging work normally */
3399 log_write(0, LOG_MAIN|LOG_PANIC,
3400 "exim user (uid=%d) is defined only at runtime; privilege lost for %s",
3401 (int)exim_uid, config_changed? "-C" : "-D");
3405 /* Start up Perl interpreter if Perl support is configured and there is a
3406 perl_startup option, and the configuration or the command line specifies
3407 initializing starting. Note that the global variables are actually called
3408 opt_perl_xxx to avoid clashing with perl's namespace (perl_*). */
3411 if (perl_start_option != 0)
3412 opt_perl_at_start = (perl_start_option > 0);
3413 if (opt_perl_at_start && opt_perl_startup != NULL)
3416 DEBUG(D_any) debug_printf("Starting Perl interpreter\n");
3417 errstr = init_perl(opt_perl_startup);
3420 fprintf(stderr, "exim: error in perl_startup code: %s\n", errstr);
3421 return EXIT_FAILURE;
3423 opt_perl_started = TRUE;
3425 #endif /* EXIM_PERL */
3427 /* Log the arguments of the call if the configuration file said so. This is
3428 a debugging feature for finding out what arguments certain MUAs actually use.
3429 Don't attempt it if logging is disabled, or if listing variables or if
3430 verifying/testing addresses or expansions. */
3432 if (((debug_selector & D_any) != 0 || (log_extra_selector & LX_arguments) != 0)
3433 && really_exim && !list_options && !checking)
3436 uschar *p = big_buffer;
3438 (void)getcwd(CS p+4, big_buffer_size - 4);
3440 (void)string_format(p, big_buffer_size - (p - big_buffer), " %d args:", argc);
3442 for (i = 0; i < argc; i++)
3444 int len = Ustrlen(argv[i]);
3447 if (p + len + 8 >= big_buffer + big_buffer_size)
3450 log_write(0, LOG_MAIN, "%s", big_buffer);
3451 Ustrcpy(big_buffer, "...");
3454 printing = string_printing(argv[i]);
3455 if (printing[0] == 0) quote = US"\""; else
3457 uschar *pp = printing;
3459 while (*pp != 0) if (isspace(*pp++)) { quote = US"\""; break; }
3461 sprintf(CS p, " %s%.*s%s", quote, (int)(big_buffer_size -
3462 (p - big_buffer) - 4), printing, quote);
3466 if ((log_extra_selector & LX_arguments) != 0)
3467 log_write(0, LOG_MAIN, "%s", big_buffer);
3469 debug_printf("%s\n", big_buffer);
3472 /* Set the working directory to be the top-level spool directory. We don't rely
3473 on this in the code, which always uses fully qualified names, but it's useful
3474 for core dumps etc. Don't complain if it fails - the spool directory might not
3475 be generally accessible and calls with the -C option (and others) have lost
3476 privilege by now. Before the chdir, we try to ensure that the directory exists.
3479 if (Uchdir(spool_directory) != 0)
3481 (void)directory_make(spool_directory, US"", SPOOL_DIRECTORY_MODE, FALSE);
3482 (void)Uchdir(spool_directory);
3485 /* Handle calls with the -bi option. This is a sendmail option to rebuild *the*
3486 alias file. Exim doesn't have such a concept, but this call is screwed into
3487 Sun's YP makefiles. Handle this by calling a configured script, as the real
3488 user who called Exim. The -oA option can be used to pass an argument to the
3493 (void)fclose(config_file);
3494 if (bi_command != NULL)
3498 argv[i++] = bi_command;
3499 if (alias_arg != NULL) argv[i++] = alias_arg;
3502 setgroups(group_count, group_list);
3503 exim_setugid(real_uid, real_gid, FALSE, US"running bi_command");
3505 DEBUG(D_exec) debug_printf("exec %.256s %.256s\n", argv[0],
3506 (argv[1] == NULL)? US"" : argv[1]);
3508 execv(CS argv[0], (char *const *)argv);
3509 fprintf(stderr, "exim: exec failed: %s\n", strerror(errno));
3514 DEBUG(D_any) debug_printf("-bi used but bi_command not set; exiting\n");
3519 /* If an action on specific messages is requested, or if a daemon or queue
3520 runner is being started, we need to know if Exim was called by an admin user.
3521 This is the case if the real user is root or exim, or if the real group is
3522 exim, or if one of the supplementary groups is exim or a group listed in
3523 admin_groups. We don't fail all message actions immediately if not admin_user,
3524 since some actions can be performed by non-admin users. Instead, set admin_user
3525 for later interrogation. */
3527 if (real_uid == root_uid || real_uid == exim_uid || real_gid == exim_gid)
3532 for (i = 0; i < group_count; i++)
3534 if (group_list[i] == exim_gid) admin_user = TRUE;
3535 else if (admin_groups != NULL)
3537 for (j = 1; j <= (int)(admin_groups[0]); j++)
3538 if (admin_groups[j] == group_list[i])
3539 { admin_user = TRUE; break; }
3541 if (admin_user) break;
3545 /* Another group of privileged users are the trusted users. These are root,
3546 exim, and any caller matching trusted_users or trusted_groups. Trusted callers
3547 are permitted to specify sender_addresses with -f on the command line, and
3548 other message parameters as well. */
3550 if (real_uid == root_uid || real_uid == exim_uid)
3551 trusted_caller = TRUE;
3556 if (trusted_users != NULL)
3558 for (i = 1; i <= (int)(trusted_users[0]); i++)
3559 if (trusted_users[i] == real_uid)
3560 { trusted_caller = TRUE; break; }
3563 if (!trusted_caller && trusted_groups != NULL)
3565 for (i = 1; i <= (int)(trusted_groups[0]); i++)
3567 if (trusted_groups[i] == real_gid)
3568 trusted_caller = TRUE;
3569 else for (j = 0; j < group_count; j++)
3571 if (trusted_groups[i] == group_list[j])
3572 { trusted_caller = TRUE; break; }
3574 if (trusted_caller) break;
3579 if (trusted_caller) DEBUG(D_any) debug_printf("trusted user\n");
3580 if (admin_user) DEBUG(D_any) debug_printf("admin user\n");
3582 /* Only an admin user may start the daemon or force a queue run in the default
3583 configuration, but the queue run restriction can be relaxed. Only an admin
3584 user may request that a message be returned to its sender forthwith. Only an
3585 admin user may specify a debug level greater than D_v (because it might show
3586 passwords, etc. in lookup queries). Only an admin user may request a queue
3591 BOOL debugset = (debug_selector & ~D_v) != 0;
3592 if (deliver_give_up || daemon_listen ||
3593 (count_queue && queue_list_requires_admin) ||
3594 (list_queue && queue_list_requires_admin) ||
3595 (queue_interval >= 0 && prod_requires_admin) ||
3596 (debugset && !running_in_test_harness))
3598 fprintf(stderr, "exim:%s permission denied\n", debugset? " debugging" : "");
3603 /* If the real user is not root or the exim uid, the argument for passing
3604 in an open TCP/IP connection for another message is not permitted, nor is
3605 running with the -N option for any delivery action, unless this call to exim is
3606 one that supplied an input message, or we are using a patched exim for
3607 regression testing. */
3609 if (real_uid != root_uid && real_uid != exim_uid &&
3610 (continue_hostname != NULL ||
3612 (queue_interval >= 0 || daemon_listen || msg_action_arg > 0)
3613 )) && !running_in_test_harness)
3615 fprintf(stderr, "exim: Permission denied\n");
3616 return EXIT_FAILURE;
3619 /* If the caller is not trusted, certain arguments are ignored when running for
3620 real, but are permitted when checking things (-be, -bv, -bt, -bh, -bf, -bF).
3621 Note that authority for performing certain actions on messages is tested in the
3622 queue_action() function. */
3624 if (!trusted_caller && !checking && filter_test == FTEST_NONE)
3626 sender_host_name = sender_host_address = interface_address =
3627 sender_ident = received_protocol = NULL;
3628 sender_host_port = interface_port = 0;
3629 sender_host_authenticated = authenticated_sender = authenticated_id = NULL;
3632 /* If a sender host address is set, extract the optional port number off the
3633 end of it and check its syntax. Do the same thing for the interface address.
3634 Exim exits if the syntax is bad. */
3638 if (sender_host_address != NULL)
3639 sender_host_port = check_port(sender_host_address);
3640 if (interface_address != NULL)
3641 interface_port = check_port(interface_address);
3644 /* If an SMTP message is being received check to see if the standard input is a
3645 TCP/IP socket. If it is, we assume that Exim was called from inetd if the
3646 caller is root or the Exim user, or if the port is a privileged one. Otherwise,
3651 union sockaddr_46 inetd_sock;
3652 EXIM_SOCKLEN_T size = sizeof(inetd_sock);
3653 if (getpeername(0, (struct sockaddr *)(&inetd_sock), &size) == 0)
3655 int family = ((struct sockaddr *)(&inetd_sock))->sa_family;
3656 if (family == AF_INET || family == AF_INET6)
3658 union sockaddr_46 interface_sock;
3659 size = sizeof(interface_sock);
3661 if (getsockname(0, (struct sockaddr *)(&interface_sock), &size) == 0)
3662 interface_address = host_ntoa(-1, &interface_sock, NULL,
3665 if (host_is_tls_on_connect_port(interface_port)) tls_on_connect = TRUE;
3667 if (real_uid == root_uid || real_uid == exim_uid || interface_port < 1024)
3670 sender_host_address = host_ntoa(-1, (struct sockaddr *)(&inetd_sock),
3671 NULL, &sender_host_port);
3672 if (mua_wrapper) log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Input from "
3673 "inetd is not supported when mua_wrapper is set");
3678 "exim: Permission denied (unprivileged user, unprivileged port)\n");
3679 return EXIT_FAILURE;
3685 /* If the load average is going to be needed while receiving a message, get it
3686 now for those OS that require the first call to os_getloadavg() to be done as
3687 root. There will be further calls later for each message received. */
3689 #ifdef LOAD_AVG_NEEDS_ROOT
3690 if (receiving_message &&
3691 (queue_only_load >= 0 ||
3692 (is_inetd && smtp_load_reserve >= 0)
3695 load_average = OS_GETLOADAVG();
3699 /* The queue_only configuration option can be overridden by -odx on the command
3700 line, except that if queue_only_override is false, queue_only cannot be unset
3701 from the command line. */
3703 if (queue_only_set && (queue_only_override || arg_queue_only))
3704 queue_only = arg_queue_only;
3706 /* The receive_timeout and smtp_receive_timeout options can be overridden by
3709 if (arg_receive_timeout >= 0) receive_timeout = arg_receive_timeout;
3710 if (arg_smtp_receive_timeout >= 0)
3711 smtp_receive_timeout = arg_smtp_receive_timeout;
3713 /* If Exim was started with root privilege, unless we have already removed the
3714 root privilege above as a result of -C, -D, -be, -bf or -bF, remove it now
3715 except when starting the daemon or doing some kind of delivery or address
3716 testing (-bt). These are the only cases when root need to be retained. We run
3717 as exim for -bv and -bh. However, if deliver_drop_privilege is set, root is
3718 retained only for starting the daemon. We always do the initgroups() in this
3719 situation (controlled by the TRUE below), in order to be as close as possible
3720 to the state Exim usually runs in. */
3722 if (!unprivileged && /* originally had root AND */
3723 !removed_privilege && /* still got root AND */
3724 !daemon_listen && /* not starting the daemon */
3725 queue_interval <= 0 && /* (either kind of daemon) */
3727 deliver_drop_privilege || /* requested unprivileged */
3729 queue_interval < 0 && /* not running the queue */
3730 (msg_action_arg < 0 || /* and */
3731 msg_action != MSG_DELIVER) && /* not delivering and */
3732 (!checking || !address_test_mode) /* not address checking */
3736 exim_setugid(exim_uid, exim_gid, TRUE, US"privilege not needed");
3739 /* When we are retaining a privileged uid, we still change to the exim gid. */
3741 else setgid(exim_gid);
3743 /* Handle a request to list the delivery queue */
3747 set_process_info("listing the queue");
3748 queue_list(list_queue_option, argv + recipients_arg, argc - recipients_arg);
3752 /* Handle a request to count the delivery queue */
3756 set_process_info("counting the queue");
3761 /* Handle actions on specific messages, except for the force delivery and
3762 message load actions, which are done below. Some actions take a whole list of
3763 message ids, which are known to continue up to the end of the arguments. Others
3764 take a single message id and then operate on the recipients list. */
3766 if (msg_action_arg > 0 && msg_action != MSG_DELIVER && msg_action != MSG_LOAD)
3768 int yield = EXIT_SUCCESS;
3769 set_process_info("acting on specified messages");
3771 if (!one_msg_action)
3773 for (i = msg_action_arg; i < argc; i++)
3774 if (!queue_action(argv[i], msg_action, NULL, 0, 0))
3775 yield = EXIT_FAILURE;
3778 else if (!queue_action(argv[msg_action_arg], msg_action, argv, argc,
3779 recipients_arg)) yield = EXIT_FAILURE;
3783 /* All the modes below here require the remaining configuration sections
3784 to be read, except that we can skip over the ACL setting when delivering
3785 specific messages, or doing a queue run. (For various testing cases we could
3786 skip too, but as they are rare, it doesn't really matter.) The argument is TRUE
3789 readconf_rest(msg_action_arg > 0 || (queue_interval == 0 && !daemon_listen));
3791 /* The configuration data will have been read into POOL_PERM because we won't
3792 ever want to reset back past it. Change the current pool to POOL_MAIN. In fact,
3793 this is just a bit of pedantic tidiness. It wouldn't really matter if the
3794 configuration were read into POOL_MAIN, because we don't do any resets till
3795 later on. However, it seems right, and it does ensure that both pools get used.
3798 store_pool = POOL_MAIN;
3800 /* Handle the -brt option. This is for checking out retry configurations.
3801 The next three arguments are a domain name or a complete address, and
3802 optionally two error numbers. All it does is to call the function that
3803 scans the retry configuration data. */
3805 if (test_retry_arg >= 0)
3807 retry_config *yield;
3808 int basic_errno = 0;
3812 if (test_retry_arg >= argc)
3814 printf("-brt needs a domain or address argument\n");
3815 exim_exit(EXIT_FAILURE);
3817 s1 = argv[test_retry_arg++];
3820 /* If the first argument contains no @ and no . it might be a local user
3821 or it might be a single-component name. Treat as a domain. */
3823 if (Ustrchr(s1, '@') == NULL && Ustrchr(s1, '.') == NULL)
3825 printf("Warning: \"%s\" contains no '@' and no '.' characters. It is "
3826 "being \ntreated as a one-component domain, not as a local part.\n\n",
3830 /* There may be an optional second domain arg. */
3832 if (test_retry_arg < argc && Ustrchr(argv[test_retry_arg], '.') != NULL)
3833 s2 = argv[test_retry_arg++];
3835 /* The final arg is an error name */
3837 if (test_retry_arg < argc)
3839 uschar *ss = argv[test_retry_arg];
3841 readconf_retry_error(ss, ss + Ustrlen(ss), &basic_errno, &more_errno);
3844 printf("%s\n", CS error);
3845 return EXIT_FAILURE;
3848 /* For the {MAIL,RCPT,DATA}_4xx errors, a value of 255 means "any", and a
3849 code > 100 as an error is for matching codes to the decade. Turn them into
3850 a real error code, off the decade. */
3852 if (basic_errno == ERRNO_MAIL4XX ||
3853 basic_errno == ERRNO_RCPT4XX ||
3854 basic_errno == ERRNO_DATA4XX)
3856 int code = (more_errno >> 8) & 255;
3858 more_errno = (more_errno & 0xffff00ff) | (21 << 8);
3859 else if (code > 100)
3860 more_errno = (more_errno & 0xffff00ff) | ((code - 96) << 8);
3864 yield = retry_find_config(s1, s2, basic_errno, more_errno);
3865 if (yield == NULL) printf("No retry information found\n"); else
3868 more_errno = yield->more_errno;
3869 printf("Retry rule: %s ", yield->pattern);
3871 if (yield->basic_errno == ERRNO_EXIMQUOTA)
3873 printf("quota%s%s ",
3874 (more_errno > 0)? "_" : "",
3875 (more_errno > 0)? readconf_printtime(more_errno) : US"");
3877 else if (yield->basic_errno == ECONNREFUSED)
3879 printf("refused%s%s ",
3880 (more_errno > 0)? "_" : "",
3881 (more_errno == 'M')? "MX" :
3882 (more_errno == 'A')? "A" : "");
3884 else if (yield->basic_errno == ETIMEDOUT)
3887 if ((more_errno & RTEF_CTOUT) != 0) printf("_connect");
3889 if (more_errno != 0) printf("_%s",
3890 (more_errno == 'M')? "MX" : "A");
3893 else if (yield->basic_errno == ERRNO_AUTHFAIL)
3894 printf("auth_failed ");
3897 for (r = yield->rules; r != NULL; r = r->next)
3899 printf("%c,%s", r->rule, readconf_printtime(r->timeout)); /* Do not */
3900 printf(",%s", readconf_printtime(r->p1)); /* amalgamate */
3906 printf(",%d.", x/1000);
3920 exim_exit(EXIT_SUCCESS);
3923 /* Handle a request to list one or more configuration options */
3927 set_process_info("listing variables");
3928 if (recipients_arg >= argc) readconf_print(US"all", NULL);
3929 else for (i = recipients_arg; i < argc; i++)
3932 (Ustrcmp(argv[i], "router") == 0 ||
3933 Ustrcmp(argv[i], "transport") == 0 ||
3934 Ustrcmp(argv[i], "authenticator") == 0))
3936 readconf_print(argv[i+1], argv[i]);
3939 else readconf_print(argv[i], NULL);
3941 exim_exit(EXIT_SUCCESS);
3945 /* Handle a request to deliver one or more messages that are already on the
3946 queue. Values of msg_action other than MSG_DELIVER and MSG_LOAD are dealt with
3947 above. MSG_LOAD is handled with -be (which is the only time it applies) below.
3949 Delivery of specific messages is typically used for a small number when
3950 prodding by hand (when the option forced_delivery will be set) or when
3951 re-execing to regain root privilege. Each message delivery must happen in a
3952 separate process, so we fork a process for each one, and run them sequentially
3953 so that debugging output doesn't get intertwined, and to avoid spawning too
3954 many processes if a long list is given. However, don't fork for the last one;
3955 this saves a process in the common case when Exim is called to deliver just one
3958 if (msg_action_arg > 0 && msg_action != MSG_LOAD)
3960 if (prod_requires_admin && !admin_user)
3962 fprintf(stderr, "exim: Permission denied\n");
3963 exim_exit(EXIT_FAILURE);
3965 set_process_info("delivering specified messages");
3966 if (deliver_give_up) forced_delivery = deliver_force_thaw = TRUE;
3967 for (i = msg_action_arg; i < argc; i++)
3972 (void)deliver_message(argv[i], forced_delivery, deliver_give_up);
3973 else if ((pid = fork()) == 0)
3975 (void)deliver_message(argv[i], forced_delivery, deliver_give_up);
3976 _exit(EXIT_SUCCESS);
3980 fprintf(stderr, "failed to fork delivery process for %s: %s\n", argv[i],
3982 exim_exit(EXIT_FAILURE);
3986 exim_exit(EXIT_SUCCESS);
3990 /* If only a single queue run is requested, without SMTP listening, we can just
3991 turn into a queue runner, with an optional starting message id. */
3993 if (queue_interval == 0 && !daemon_listen)
3995 DEBUG(D_queue_run) debug_printf("Single queue run%s%s%s%s\n",
3996 (start_queue_run_id == NULL)? US"" : US" starting at ",
3997 (start_queue_run_id == NULL)? US"" : start_queue_run_id,
3998 (stop_queue_run_id == NULL)? US"" : US" stopping at ",
3999 (stop_queue_run_id == NULL)? US"" : stop_queue_run_id);
4000 set_process_info("running the queue (single queue run)");
4001 queue_run(start_queue_run_id, stop_queue_run_id, FALSE);
4002 exim_exit(EXIT_SUCCESS);
4006 /* Find the login name of the real user running this process. This is always
4007 needed when receiving a message, because it is written into the spool file. It
4008 may also be used to construct a from: or a sender: header, and in this case we
4009 need the user's full name as well, so save a copy of it, checked for RFC822
4010 syntax and munged if necessary, if it hasn't previously been set by the -F
4011 argument. We may try to get the passwd entry more than once, in case NIS or
4012 other delays are in evidence. Save the home directory for use in filter testing
4017 if ((pw = getpwuid(real_uid)) != NULL)
4019 originator_login = string_copy(US pw->pw_name);
4020 originator_home = string_copy(US pw->pw_dir);
4022 /* If user name has not been set by -F, set it from the passwd entry
4023 unless -f has been used to set the sender address by a trusted user. */
4025 if (originator_name == NULL)
4027 if (sender_address == NULL ||
4028 (!trusted_caller && filter_test == FTEST_NONE))
4030 uschar *name = US pw->pw_gecos;
4031 uschar *amp = Ustrchr(name, '&');
4034 /* Most Unix specify that a '&' character in the gecos field is
4035 replaced by a copy of the login name, and some even specify that
4036 the first character should be upper cased, so that's what we do. */
4041 string_format(buffer, sizeof(buffer), "%.*s%n%s%s",
4042 amp - name, name, &loffset, originator_login, amp + 1);
4043 buffer[loffset] = toupper(buffer[loffset]);
4047 /* If a pattern for matching the gecos field was supplied, apply
4048 it and then expand the name string. */
4050 if (gecos_pattern != NULL && gecos_name != NULL)
4053 re = regex_must_compile(gecos_pattern, FALSE, TRUE); /* Use malloc */
4055 if (regex_match_and_setup(re, name, 0, -1))
4057 uschar *new_name = expand_string(gecos_name);
4059 if (new_name != NULL)
4061 DEBUG(D_receive) debug_printf("user name \"%s\" extracted from "
4062 "gecos field \"%s\"\n", new_name, name);
4065 else DEBUG(D_receive) debug_printf("failed to expand gecos_name string "
4066 "\"%s\": %s\n", gecos_name, expand_string_message);
4068 else DEBUG(D_receive) debug_printf("gecos_pattern \"%s\" did not match "
4069 "gecos field \"%s\"\n", gecos_pattern, name);
4070 store_free((void *)re);
4072 originator_name = string_copy(name);
4075 /* A trusted caller has used -f but not -F */
4077 else originator_name = US"";
4080 /* Break the retry loop */
4085 if (++i > finduser_retries) break;
4089 /* If we cannot get a user login, log the incident and give up, unless the
4090 configuration specifies something to use. When running in the test harness,
4091 any setting of unknown_login overrides the actual name. */
4093 if (originator_login == NULL || running_in_test_harness)
4095 if (unknown_login != NULL)
4097 originator_login = expand_string(unknown_login);
4098 if (originator_name == NULL && unknown_username != NULL)
4099 originator_name = expand_string(unknown_username);
4100 if (originator_name == NULL) originator_name = US"";
4102 if (originator_login == NULL)
4103 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Failed to get user name for uid %d",
4107 /* Ensure that the user name is in a suitable form for use as a "phrase" in an
4110 originator_name = string_copy(parse_fix_phrase(originator_name,
4111 Ustrlen(originator_name), big_buffer, big_buffer_size));
4113 /* If a message is created by this call of Exim, the uid/gid of its originator
4114 are those of the caller. These values are overridden if an existing message is
4115 read in from the spool. */
4117 originator_uid = real_uid;
4118 originator_gid = real_gid;
4120 DEBUG(D_receive) debug_printf("originator: uid=%d gid=%d login=%s name=%s\n",
4121 (int)originator_uid, (int)originator_gid, originator_login, originator_name);
4123 /* Run in daemon and/or queue-running mode. The function daemon_go() never
4124 returns. We leave this till here so that the originator_ fields are available
4125 for incoming messages via the daemon. The daemon cannot be run in mua_wrapper
4128 if (daemon_listen || queue_interval > 0)
4132 fprintf(stderr, "Daemon cannot be run when mua_wrapper is set\n");
4133 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Daemon cannot be run when "
4134 "mua_wrapper is set");
4139 /* If the sender ident has not been set (by a trusted caller) set it to
4140 the caller. This will get overwritten below for an inetd call. If a trusted
4141 caller has set it empty, unset it. */
4143 if (sender_ident == NULL) sender_ident = originator_login;
4144 else if (sender_ident[0] == 0) sender_ident = NULL;
4146 /* Handle the -brw option, which is for checking out rewriting rules. Cause log
4147 writes (on errors) to go to stderr instead. Can't do this earlier, as want the
4148 originator_* variables set. */
4150 if (test_rewrite_arg >= 0)
4152 really_exim = FALSE;
4153 if (test_rewrite_arg >= argc)
4155 printf("-brw needs an address argument\n");
4156 exim_exit(EXIT_FAILURE);
4158 rewrite_test(argv[test_rewrite_arg]);
4159 exim_exit(EXIT_SUCCESS);
4162 /* A locally-supplied message is considered to be coming from a local user
4163 unless a trusted caller supplies a sender address with -f, or is passing in the
4164 message via SMTP (inetd invocation or otherwise). */
4166 if ((sender_address == NULL && !smtp_input) ||
4167 (!trusted_caller && filter_test == FTEST_NONE))
4169 sender_local = TRUE;
4171 /* A trusted caller can supply authenticated_sender and authenticated_id
4172 via -oMas and -oMai and if so, they will already be set. Otherwise, force
4173 defaults except when host checking. */
4175 if (authenticated_sender == NULL && !host_checking)
4176 authenticated_sender = string_sprintf("%s@%s", originator_login,
4177 qualify_domain_sender);
4178 if (authenticated_id == NULL && !host_checking)
4179 authenticated_id = originator_login;
4182 /* Trusted callers are always permitted to specify the sender address.
4183 Untrusted callers may specify it if it matches untrusted_set_sender, or if what
4184 is specified is the empty address. However, if a trusted caller does not
4185 specify a sender address for SMTP input, we leave sender_address unset. This
4186 causes the MAIL commands to be honoured. */
4188 if ((!smtp_input && sender_address == NULL) ||
4189 !receive_check_set_sender(sender_address))
4191 /* Either the caller is not permitted to set a general sender, or this is
4192 non-SMTP input and the trusted caller has not set a sender. If there is no
4193 sender, or if a sender other than <> is set, override with the originator's
4194 login (which will get qualified below), except when checking things. */
4196 if (sender_address == NULL /* No sender_address set */
4198 (sender_address[0] != 0 && /* Non-empty sender address, AND */
4199 !checking && /* Not running tests, AND */
4200 filter_test == FTEST_NONE)) /* Not testing a filter */
4202 sender_address = originator_login;
4203 sender_address_forced = FALSE;
4204 sender_address_domain = 0;
4208 /* Remember whether an untrusted caller set the sender address */
4210 sender_set_untrusted = sender_address != originator_login && !trusted_caller;
4212 /* Ensure that the sender address is fully qualified unless it is the empty
4213 address, which indicates an error message, or doesn't exist (root caller, smtp
4214 interface, no -f argument). */
4216 if (sender_address != NULL && sender_address[0] != 0 &&
4217 sender_address_domain == 0)
4218 sender_address = string_sprintf("%s@%s", local_part_quote(sender_address),
4219 qualify_domain_sender);
4221 DEBUG(D_receive) debug_printf("sender address = %s\n", sender_address);
4223 /* Handle a request to verify a list of addresses, or test them for delivery.
4224 This must follow the setting of the sender address, since routers can be
4225 predicated upon the sender. If no arguments are given, read addresses from
4226 stdin. Set debug_level to at least D_v to get full output for address testing.
4229 if (verify_address_mode || address_test_mode)
4232 int flags = vopt_qualify;
4234 if (verify_address_mode)
4236 if (!verify_as_sender) flags |= vopt_is_recipient;
4237 DEBUG(D_verify) debug_print_ids(US"Verifying:");
4242 flags |= vopt_is_recipient;
4243 debug_selector |= D_v;
4244 debug_file = stderr;
4245 debug_fd = fileno(debug_file);
4246 DEBUG(D_verify) debug_print_ids(US"Address testing:");
4249 if (recipients_arg < argc)
4251 while (recipients_arg < argc)
4253 uschar *s = argv[recipients_arg++];
4256 BOOL finished = FALSE;
4257 uschar *ss = parse_find_address_end(s, FALSE);
4258 if (*ss == ',') *ss = 0; else finished = TRUE;
4259 test_address(s, flags, &exit_value);
4262 while (*(++s) != 0 && (*s == ',' || isspace(*s)));
4269 uschar *s = get_stdinput(NULL, NULL);
4270 if (s == NULL) break;
4271 test_address(s, flags, &exit_value);
4275 exim_exit(exit_value);
4278 /* Handle expansion checking. Either expand items on the command line, or read
4279 from stdin if there aren't any. If -Mset was specified, load the message so
4280 that its variables can be used, but restrict this facility to admin users.
4281 Otherwise, if -bem was used, read a message from stdin. */
4285 if (msg_action_arg > 0 && msg_action == MSG_LOAD)
4287 uschar spoolname[256]; /* Not big_buffer; used in spool_read_header() */
4290 fprintf(stderr, "exim: permission denied\n");
4293 message_id = argv[msg_action_arg];
4294 (void)string_format(spoolname, sizeof(spoolname), "%s-H", message_id);
4295 if (!spool_open_datafile(message_id))
4296 printf ("Failed to load message datafile %s\n", message_id);
4297 if (spool_read_header(spoolname, TRUE, FALSE) != spool_read_OK)
4298 printf ("Failed to load message %s\n", message_id);
4301 /* Read a test message from a file. We fudge it up to be on stdin, saving
4302 stdin itself for later reading of expansion strings. */
4304 else if (expansion_test_message != NULL)
4306 int save_stdin = dup(0);
4307 int fd = Uopen(expansion_test_message, O_RDONLY, 0);
4310 fprintf(stderr, "exim: failed to open %s: %s\n", expansion_test_message,
4312 return EXIT_FAILURE;
4315 filter_test = FTEST_USER; /* Fudge to make it look like filter test */
4316 message_ended = END_NOTENDED;
4317 read_message_body(receive_msg(extract_recipients));
4318 message_linecount += body_linecount;
4319 (void)dup2(save_stdin, 0);
4320 (void)close(save_stdin);
4321 clearerr(stdin); /* Required by Darwin */
4324 /* Allow $recipients for this testing */
4326 enable_dollar_recipients = TRUE;
4328 /* Expand command line items */
4330 if (recipients_arg < argc)
4332 while (recipients_arg < argc)
4334 uschar *s = argv[recipients_arg++];
4335 uschar *ss = expand_string(s);
4336 if (ss == NULL) printf ("Failed: %s\n", expand_string_message);
4337 else printf("%s\n", CS ss);
4345 char *(*fn_readline)(char *) = NULL;
4346 char *(*fn_addhist)(char *) = NULL;
4349 void *dlhandle = set_readline(&fn_readline, &fn_addhist);
4355 uschar *source = get_stdinput(fn_readline, fn_addhist);
4356 if (source == NULL) break;
4357 ss = expand_string(source);
4359 printf ("Failed: %s\n", expand_string_message);
4360 else printf("%s\n", CS ss);
4364 if (dlhandle != NULL) dlclose(dlhandle);
4368 /* The data file will be open after -Mset */
4370 if (deliver_datafile >= 0)
4372 (void)close(deliver_datafile);
4373 deliver_datafile = -1;
4376 exim_exit(EXIT_SUCCESS);
4380 /* The active host name is normally the primary host name, but it can be varied
4381 for hosts that want to play several parts at once. We need to ensure that it is
4382 set for host checking, and for receiving messages. */
4384 smtp_active_hostname = primary_hostname;
4385 if (raw_active_hostname != NULL)
4387 uschar *nah = expand_string(raw_active_hostname);
4390 if (!expand_string_forcedfail)
4391 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to expand \"%s\" "
4392 "(smtp_active_hostname): %s", raw_active_hostname,
4393 expand_string_message);
4395 else if (nah[0] != 0) smtp_active_hostname = nah;
4398 /* Handle host checking: this facility mocks up an incoming SMTP call from a
4399 given IP address so that the blocking and relay configuration can be tested.
4400 Unless a sender_ident was set by -oMt, we discard it (the default is the
4401 caller's login name). An RFC 1413 call is made only if we are running in the
4402 test harness and an incoming interface and both ports are specified, because
4403 there is no TCP/IP call to find the ident for. */
4410 if (!sender_ident_set)
4412 sender_ident = NULL;
4413 if (running_in_test_harness && sender_host_port != 0 &&
4414 interface_address != NULL && interface_port != 0)
4415 verify_get_ident(1413);
4418 /* In case the given address is a non-canonical IPv6 address, canonicize
4419 it. The code works for both IPv4 and IPv6, as it happens. */
4421 size = host_aton(sender_host_address, x);
4422 sender_host_address = store_get(48); /* large enough for full IPv6 */
4423 (void)host_nmtoa(size, x, -1, sender_host_address, ':');
4425 /* Now set up for testing */
4427 host_build_sender_fullhost();
4431 sender_local = FALSE;
4432 sender_host_notsocket = TRUE;
4433 debug_file = stderr;
4434 debug_fd = fileno(debug_file);
4435 fprintf(stdout, "\n**** SMTP testing session as if from host %s\n"
4436 "**** but without any ident (RFC 1413) callback.\n"
4437 "**** This is not for real!\n\n",
4438 sender_host_address);
4440 if (verify_check_host(&hosts_connection_nolog) == OK)
4441 log_write_selector &= ~L_smtp_connection;
4442 log_write(L_smtp_connection, LOG_MAIN, "%s", smtp_get_connection_info());
4444 /* NOTE: We do *not* call smtp_log_no_mail() if smtp_start_session() fails,
4445 because a log line has already been written for all its failure exists
4446 (usually "connection refused: <reason>") and writing another one is
4447 unnecessary clutter. */
4449 if (smtp_start_session())
4451 reset_point = store_get(0);
4454 store_reset(reset_point);
4455 if (smtp_setup_msg() <= 0) break;
4456 if (!receive_msg(FALSE)) break;
4460 exim_exit(EXIT_SUCCESS);
4464 /* Arrange for message reception if recipients or SMTP were specified;
4465 otherwise complain unless a version print (-bV) happened or this is a filter
4466 verification test. In the former case, show the configuration file name. */
4468 if (recipients_arg >= argc && !extract_recipients && !smtp_input)
4470 if (version_printed)
4472 printf("Configuration file is %s\n", config_main_filename);
4473 return EXIT_SUCCESS;
4476 if (filter_test == FTEST_NONE)
4477 exim_usage(called_as);
4481 /* If mua_wrapper is set, Exim is being used to turn an MUA that submits on the
4482 standard input into an MUA that submits to a smarthost over TCP/IP. We know
4483 that we are not called from inetd, because that is rejected above. The
4484 following configuration settings are forced here:
4486 (1) Synchronous delivery (-odi)
4487 (2) Errors to stderr (-oep == -oeq)
4488 (3) No parallel remote delivery
4489 (4) Unprivileged delivery
4491 We don't force overall queueing options because there are several of them;
4492 instead, queueing is avoided below when mua_wrapper is set. However, we do need
4493 to override any SMTP queueing. */
4497 synchronous_delivery = TRUE;
4498 arg_error_handling = ERRORS_STDERR;
4499 remote_max_parallel = 1;
4500 deliver_drop_privilege = TRUE;
4502 queue_smtp_domains = NULL;
4506 /* Prepare to accept one or more new messages on the standard input. When a
4507 message has been read, its id is returned in message_id[]. If doing immediate
4508 delivery, we fork a delivery process for each received message, except for the
4509 last one, where we can save a process switch.
4511 It is only in non-smtp mode that error_handling is allowed to be changed from
4512 its default of ERRORS_SENDER by argument. (Idle thought: are any of the
4513 sendmail error modes other than -oem ever actually used? Later: yes.) */
4515 if (!smtp_input) error_handling = arg_error_handling;
4517 /* If this is an inetd call, ensure that stderr is closed to prevent panic
4518 logging being sent down the socket and make an identd call to get the
4523 (void)fclose(stderr);
4524 exim_nullstd(); /* Re-open to /dev/null */
4525 verify_get_ident(IDENT_PORT);
4526 host_build_sender_fullhost();
4527 set_process_info("handling incoming connection from %s via inetd",
4531 /* If the sender host address has been set, build sender_fullhost if it hasn't
4532 already been done (which it will have been for inetd). This caters for the
4533 case when it is forced by -oMa. However, we must flag that it isn't a socket,
4534 so that the test for IP options is skipped for -bs input. */
4536 if (sender_host_address != NULL && sender_fullhost == NULL)
4538 host_build_sender_fullhost();
4539 set_process_info("handling incoming connection from %s via -oMa",
4541 sender_host_notsocket = TRUE;
4544 /* Otherwise, set the sender host as unknown except for inetd calls. This
4545 prevents host checking in the case of -bs not from inetd and also for -bS. */
4547 else if (!is_inetd) sender_host_unknown = TRUE;
4549 /* If stdout does not exist, then dup stdin to stdout. This can happen
4550 if exim is started from inetd. In this case fd 0 will be set to the socket,
4551 but fd 1 will not be set. This also happens for passed SMTP channels. */
4553 if (fstat(1, &statbuf) < 0) (void)dup2(0, 1);
4555 /* Set up the incoming protocol name and the state of the program. Root is
4556 allowed to force received protocol via the -oMr option above. If we have come
4557 via inetd, the process info has already been set up. We don't set
4558 received_protocol here for smtp input, as it varies according to
4559 batch/HELO/EHLO/AUTH/TLS. */
4563 if (!is_inetd) set_process_info("accepting a local %sSMTP message from <%s>",
4564 smtp_batched_input? "batched " : "",
4565 (sender_address!= NULL)? sender_address : originator_login);
4569 if (received_protocol == NULL)
4570 received_protocol = string_sprintf("local%s", called_as);
4571 set_process_info("accepting a local non-SMTP message from <%s>",
4575 /* Initialize the session_local_queue-only flag (this will be ignored if
4576 mua_wrapper is set) */
4579 session_local_queue_only = queue_only;
4581 /* For non-SMTP and for batched SMTP input, check that there is enough space on
4582 the spool if so configured. On failure, we must not attempt to send an error
4583 message! (For interactive SMTP, the check happens at MAIL FROM and an SMTP
4584 error code is given.) */
4586 if ((!smtp_input || smtp_batched_input) && !receive_check_fs(0))
4588 fprintf(stderr, "exim: insufficient disk space\n");
4589 return EXIT_FAILURE;
4592 /* If this is smtp input of any kind, real or batched, handle the start of the
4595 NOTE: We do *not* call smtp_log_no_mail() if smtp_start_session() fails,
4596 because a log line has already been written for all its failure exists
4597 (usually "connection refused: <reason>") and writing another one is
4598 unnecessary clutter. */
4604 if (verify_check_host(&hosts_connection_nolog) == OK)
4605 log_write_selector &= ~L_smtp_connection;
4606 log_write(L_smtp_connection, LOG_MAIN, "%s", smtp_get_connection_info());
4607 if (!smtp_start_session())
4610 exim_exit(EXIT_SUCCESS);
4614 /* Otherwise, set up the input size limit here. */
4618 thismessage_size_limit = expand_string_integer(message_size_limit, TRUE);
4619 if (expand_string_message != NULL)
4621 if (thismessage_size_limit == -1)
4622 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to expand "
4623 "message_size_limit: %s", expand_string_message);
4625 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "invalid value for "
4626 "message_size_limit: %s", expand_string_message);
4630 /* Loop for several messages when reading SMTP input. If we fork any child
4631 processes, we don't want to wait for them unless synchronous delivery is
4632 requested, so set SIGCHLD to SIG_IGN in that case. This is not necessarily the
4633 same as SIG_DFL, despite the fact that documentation often lists the default as
4634 "ignore". This is a confusing area. This is what I know:
4636 At least on some systems (e.g. Solaris), just setting SIG_IGN causes child
4637 processes that complete simply to go away without ever becoming defunct. You
4638 can't then wait for them - but we don't want to wait for them in the
4639 non-synchronous delivery case. However, this behaviour of SIG_IGN doesn't
4640 happen for all OS (e.g. *BSD is different).
4642 But that's not the end of the story. Some (many? all?) systems have the
4643 SA_NOCLDWAIT option for sigaction(). This requests the behaviour that Solaris
4644 has by default, so it seems that the difference is merely one of default
4645 (compare restarting vs non-restarting signals).
4647 To cover all cases, Exim sets SIG_IGN with SA_NOCLDWAIT here if it can. If not,
4648 it just sets SIG_IGN. To be on the safe side it also calls waitpid() at the end
4649 of the loop below. Paranoia rules.
4651 February 2003: That's *still* not the end of the story. There are now versions
4652 of Linux (where SIG_IGN does work) that are picky. If, having set SIG_IGN, a
4653 process then calls waitpid(), a grumble is written to the system log, because
4654 this is logically inconsistent. In other words, it doesn't like the paranoia.
4655 As a consequenc of this, the waitpid() below is now excluded if we are sure
4656 that SIG_IGN works. */
4658 if (!synchronous_delivery)
4661 struct sigaction act;
4662 act.sa_handler = SIG_IGN;
4663 sigemptyset(&(act.sa_mask));
4664 act.sa_flags = SA_NOCLDWAIT;
4665 sigaction(SIGCHLD, &act, NULL);
4667 signal(SIGCHLD, SIG_IGN);
4671 /* Save the current store pool point, for resetting at the start of
4672 each message, and save the real sender address, if any. */
4674 reset_point = store_get(0);
4675 real_sender_address = sender_address;
4677 /* Loop to receive messages; receive_msg() returns TRUE if there are more
4678 messages to be read (SMTP input), or FALSE otherwise (not SMTP, or SMTP channel
4683 store_reset(reset_point);
4686 /* Handle the SMTP case; call smtp_setup_mst() to deal with the initial SMTP
4687 input and build the recipients list, before calling receive_msg() to read the
4688 message proper. Whatever sender address is given in the SMTP transaction is
4689 often ignored for local senders - we use the actual sender, which is normally
4690 either the underlying user running this process or a -f argument provided by
4691 a trusted caller. It is saved in real_sender_address. The test for whether to
4692 accept the SMTP sender is encapsulated in receive_check_set_sender(). */
4697 if ((rc = smtp_setup_msg()) > 0)
4699 if (real_sender_address != NULL &&
4700 !receive_check_set_sender(sender_address))
4702 sender_address = raw_sender = real_sender_address;
4703 sender_address_unrewritten = NULL;
4706 /* For batched SMTP, we have to run the acl_not_smtp_start ACL, since it
4707 isn't really SMTP, so no other ACL will run until the acl_not_smtp one at
4708 the very end. The result of the ACL is ignored (as for other non-SMTP
4709 messages). It is run for its potential side effects. */
4711 if (smtp_batched_input && acl_not_smtp_start != NULL)
4713 uschar *user_msg, *log_msg;
4714 enable_dollar_recipients = TRUE;
4715 (void)acl_check(ACL_WHERE_NOTSMTP_START, NULL, acl_not_smtp_start,
4716 &user_msg, &log_msg);
4717 enable_dollar_recipients = FALSE;
4720 /* Now get the data for the message */
4722 more = receive_msg(extract_recipients);
4723 if (message_id[0] == 0)
4726 smtp_log_no_mail(); /* Log no mail if configured */
4727 exim_exit(EXIT_FAILURE);
4732 smtp_log_no_mail(); /* Log no mail if configured */
4733 exim_exit((rc == 0)? EXIT_SUCCESS : EXIT_FAILURE);
4737 /* In the non-SMTP case, we have all the information from the command
4738 line, but must process it in case it is in the more general RFC822
4739 format, and in any case, to detect syntax errors. Also, it appears that
4740 the use of comma-separated lists as single arguments is common, so we
4741 had better support them. */
4747 int count = argc - recipients_arg;
4748 uschar **list = argv + recipients_arg;
4750 /* These options cannot be changed dynamically for non-SMTP messages */
4752 active_local_sender_retain = local_sender_retain;
4753 active_local_from_check = local_from_check;
4755 /* Save before any rewriting */
4757 raw_sender = string_copy(sender_address);
4759 /* Loop for each argument */
4761 for (i = 0; i < count; i++)
4763 int start, end, domain;
4765 uschar *s = list[i];
4767 /* Loop for each comma-separated address */
4771 BOOL finished = FALSE;
4773 uschar *ss = parse_find_address_end(s, FALSE);
4775 if (*ss == ',') *ss = 0; else finished = TRUE;
4777 /* Check max recipients - if -t was used, these aren't recipients */
4779 if (recipients_max > 0 && ++rcount > recipients_max &&
4780 !extract_recipients)
4782 if (error_handling == ERRORS_STDERR)
4784 fprintf(stderr, "exim: too many recipients\n");
4785 exim_exit(EXIT_FAILURE);
4790 moan_to_sender(ERRMESS_TOOMANYRECIP, NULL, NULL, stdin, TRUE)?
4791 errors_sender_rc : EXIT_FAILURE;
4796 parse_extract_address(s, &errmess, &start, &end, &domain, FALSE);
4798 if (domain == 0 && !allow_unqualified_recipient)
4801 errmess = US"unqualified recipient address not allowed";
4804 if (recipient == NULL)
4806 if (error_handling == ERRORS_STDERR)
4808 fprintf(stderr, "exim: bad recipient address \"%s\": %s\n",
4809 string_printing(list[i]), errmess);
4810 exim_exit(EXIT_FAILURE);
4816 eblock.text1 = string_printing(list[i]);
4817 eblock.text2 = errmess;
4819 moan_to_sender(ERRMESS_BADARGADDRESS, &eblock, NULL, stdin, TRUE)?
4820 errors_sender_rc : EXIT_FAILURE;
4824 receive_add_recipient(recipient, -1);
4827 while (*(++s) != 0 && (*s == ',' || isspace(*s)));
4831 /* Show the recipients when debugging */
4836 if (sender_address != NULL) debug_printf("Sender: %s\n", sender_address);
4837 if (recipients_list != NULL)
4839 debug_printf("Recipients:\n");
4840 for (i = 0; i < recipients_count; i++)
4841 debug_printf(" %s\n", recipients_list[i].address);
4845 /* Run the acl_not_smtp_start ACL if required. The result of the ACL is
4846 ignored; rejecting here would just add complication, and it can just as
4847 well be done later. Allow $recipients to be visible in the ACL. */
4849 if (acl_not_smtp_start != NULL)
4851 uschar *user_msg, *log_msg;
4852 enable_dollar_recipients = TRUE;
4853 (void)acl_check(ACL_WHERE_NOTSMTP_START, NULL, acl_not_smtp_start,
4854 &user_msg, &log_msg);
4855 enable_dollar_recipients = FALSE;
4858 /* Read the data for the message. If filter_test is not FTEST_NONE, this
4859 will just read the headers for the message, and not write anything onto the
4862 message_ended = END_NOTENDED;
4863 more = receive_msg(extract_recipients);
4865 /* more is always FALSE here (not SMTP message) when reading a message
4866 for real; when reading the headers of a message for filter testing,
4867 it is TRUE if the headers were terminated by '.' and FALSE otherwise. */
4869 if (message_id[0] == 0) exim_exit(EXIT_FAILURE);
4870 } /* Non-SMTP message reception */
4872 /* If this is a filter testing run, there are headers in store, but
4873 no message on the spool. Run the filtering code in testing mode, setting
4874 the domain to the qualify domain and the local part to the current user,
4875 unless they have been set by options. The prefix and suffix are left unset
4876 unless specified. The the return path is set to to the sender unless it has
4877 already been set from a return-path header in the message. */
4879 if (filter_test != FTEST_NONE)
4881 deliver_domain = (ftest_domain != NULL)?
4882 ftest_domain : qualify_domain_recipient;
4883 deliver_domain_orig = deliver_domain;
4884 deliver_localpart = (ftest_localpart != NULL)?
4885 ftest_localpart : originator_login;
4886 deliver_localpart_orig = deliver_localpart;
4887 deliver_localpart_prefix = ftest_prefix;
4888 deliver_localpart_suffix = ftest_suffix;
4889 deliver_home = originator_home;
4891 if (return_path == NULL)
4893 printf("Return-path copied from sender\n");
4894 return_path = string_copy(sender_address);
4898 printf("Return-path = %s\n", (return_path[0] == 0)? US"<>" : return_path);
4900 printf("Sender = %s\n", (sender_address[0] == 0)? US"<>" : sender_address);
4902 receive_add_recipient(
4903 string_sprintf("%s%s%s@%s",
4904 (ftest_prefix == NULL)? US"" : ftest_prefix,
4906 (ftest_suffix == NULL)? US"" : ftest_suffix,
4907 deliver_domain), -1);
4909 printf("Recipient = %s\n", recipients_list[0].address);
4910 if (ftest_prefix != NULL) printf("Prefix = %s\n", ftest_prefix);
4911 if (ftest_suffix != NULL) printf("Suffix = %s\n", ftest_suffix);
4913 (void)chdir("/"); /* Get away from wherever the user is running this from */
4915 /* Now we run either a system filter test, or a user filter test, or both.
4916 In the latter case, headers added by the system filter will persist and be
4917 available to the user filter. We need to copy the filter variables
4920 if ((filter_test & FTEST_SYSTEM) != 0)
4922 if (!filter_runtest(filter_sfd, filter_test_sfile, TRUE, more))
4923 exim_exit(EXIT_FAILURE);
4926 memcpy(filter_sn, filter_n, sizeof(filter_sn));
4928 if ((filter_test & FTEST_USER) != 0)
4930 if (!filter_runtest(filter_ufd, filter_test_ufile, FALSE, more))
4931 exim_exit(EXIT_FAILURE);
4934 exim_exit(EXIT_SUCCESS);
4937 /* Else act on the result of message reception. We should not get here unless
4938 message_id[0] is non-zero. If queue_only is set, session_local_queue_only
4939 will be TRUE. If it is not, check on the number of messages received in this
4942 if (!session_local_queue_only &&
4943 smtp_accept_queue_per_connection > 0 &&
4944 receive_messagecount > smtp_accept_queue_per_connection)
4946 session_local_queue_only = TRUE;
4947 queue_only_reason = 2;
4950 /* Initialize local_queue_only from session_local_queue_only. If it is false,
4951 and queue_only_load is set, check that the load average is below it. If it is
4952 not, set local_queue_only TRUE. If queue_only_load_latch is true (the
4953 default), we put the whole session into queue_only mode. It then remains this
4954 way for any subsequent messages on the same SMTP connection. This is a
4955 deliberate choice; even though the load average may fall, it doesn't seem
4956 right to deliver later messages on the same call when not delivering earlier
4957 ones. However, there are odd cases where this is not wanted, so this can be
4958 changed by setting queue_only_load_latch false. */
4960 local_queue_only = session_local_queue_only;
4961 if (!local_queue_only && queue_only_load >= 0)
4963 local_queue_only = (load_average = OS_GETLOADAVG()) > queue_only_load;
4964 if (local_queue_only)
4966 queue_only_reason = 3;
4967 if (queue_only_load_latch) session_local_queue_only = TRUE;
4971 /* If running as an MUA wrapper, all queueing options and freezing options
4975 local_queue_only = queue_only_policy = deliver_freeze = FALSE;
4977 /* Log the queueing here, when it will get a message id attached, but
4978 not if queue_only is set (case 0). Case 1 doesn't happen here (too many
4981 if (local_queue_only) switch(queue_only_reason)
4984 log_write(L_delay_delivery,
4985 LOG_MAIN, "no immediate delivery: more than %d messages "
4986 "received in one connection", smtp_accept_queue_per_connection);
4990 log_write(L_delay_delivery,
4991 LOG_MAIN, "no immediate delivery: load average %.2f",
4992 (double)load_average/1000.0);
4996 /* Else do the delivery unless the ACL or local_scan() called for queue only
4997 or froze the message. Always deliver in a separate process. A fork failure is
4998 not a disaster, as the delivery will eventually happen on a subsequent queue
4999 run. The search cache must be tidied before the fork, as the parent will
5000 do it before exiting. The child will trigger a lookup failure and
5001 thereby defer the delivery if it tries to use (for example) a cached ldap
5002 connection that the parent has called unbind on. */
5004 else if (!queue_only_policy && !deliver_freeze)
5009 if ((pid = fork()) == 0)
5012 close_unwanted(); /* Close unwanted file descriptors and TLS */
5013 exim_nullstd(); /* Ensure std{in,out,err} exist */
5015 /* Re-exec Exim if we need to regain privilege (note: in mua_wrapper
5016 mode, deliver_drop_privilege is forced TRUE). */
5018 if (geteuid() != root_uid && !deliver_drop_privilege && !unprivileged)
5020 (void)child_exec_exim(CEE_EXEC_EXIT, FALSE, NULL, FALSE, 2, US"-Mc",
5022 /* Control does not return here. */
5025 /* No need to re-exec */
5027 rc = deliver_message(message_id, FALSE, FALSE);
5029 _exit((!mua_wrapper || rc == DELIVER_MUA_SUCCEEDED)?
5030 EXIT_SUCCESS : EXIT_FAILURE);
5035 log_write(0, LOG_MAIN|LOG_PANIC, "failed to fork automatic delivery "
5036 "process: %s", strerror(errno));
5039 /* In the parent, wait if synchronous delivery is required. This will
5040 always be the case in MUA wrapper mode. */
5042 else if (synchronous_delivery)
5045 while (wait(&status) != pid);
5046 if ((status & 0x00ff) != 0)
5047 log_write(0, LOG_MAIN|LOG_PANIC,
5048 "process %d crashed with signal %d while delivering %s",
5049 (int)pid, status & 0x00ff, message_id);
5050 if (mua_wrapper && (status & 0xffff) != 0) exim_exit(EXIT_FAILURE);
5054 /* The loop will repeat if more is TRUE. If we do not know know that the OS
5055 automatically reaps children (see comments above the loop), clear away any
5056 finished subprocesses here, in case there are lots of messages coming in
5057 from the same source. */
5059 #ifndef SIG_IGN_WORKS
5060 while (waitpid(-1, NULL, WNOHANG) > 0);
5064 exim_exit(EXIT_SUCCESS); /* Never returns */
5065 return 0; /* To stop compiler warning */