1 /*************************************************
2 * Exim - an Internet mail transport agent *
3 *************************************************/
5 /* Copyright (c) University of Cambridge 1995 - 2018 */
6 /* See the file NOTICE for conditions of use and distribution. */
9 /* The main function: entry point, initialization, and high-level control.
10 Also a few functions that don't naturally fit elsewhere. */
15 #if defined(__GLIBC__) && !defined(__UCLIBC__)
16 # include <gnu/libc-version.h>
20 # include <gnutls/gnutls.h>
21 # if GNUTLS_VERSION_NUMBER < 0x030103 && !defined(DISABLE_OCSP)
26 extern void init_lookup_list(void);
30 /*************************************************
31 * Function interface to store functions *
32 *************************************************/
34 /* We need some real functions to pass to the PCRE regular expression library
35 for store allocation via Exim's store manager. The normal calls are actually
36 macros that pass over location information to make tracing easier. These
37 functions just interface to the standard macro calls. A good compiler will
38 optimize out the tail recursion and so not make them too expensive. There
39 are two sets of functions; one for use when we want to retain the compiled
40 regular expression for a long time; the other for short-term use. */
43 function_store_get(size_t size)
45 return store_get((int)size);
49 function_dummy_free(void *block) { block = block; }
52 function_store_malloc(size_t size)
54 return store_malloc((int)size);
58 function_store_free(void *block)
66 /*************************************************
67 * Enums for cmdline interface *
68 *************************************************/
70 enum commandline_info { CMDINFO_NONE=0,
71 CMDINFO_HELP, CMDINFO_SIEVE, CMDINFO_DSCP };
76 /*************************************************
77 * Compile regular expression and panic on fail *
78 *************************************************/
80 /* This function is called when failure to compile a regular expression leads
81 to a panic exit. In other cases, pcre_compile() is called directly. In many
82 cases where this function is used, the results of the compilation are to be
83 placed in long-lived store, so we temporarily reset the store management
84 functions that PCRE uses if the use_malloc flag is set.
87 pattern the pattern to compile
88 caseless TRUE if caseless matching is required
89 use_malloc TRUE if compile into malloc store
91 Returns: pointer to the compiled pattern
95 regex_must_compile(const uschar *pattern, BOOL caseless, BOOL use_malloc)
98 int options = PCRE_COPT;
103 pcre_malloc = function_store_malloc;
104 pcre_free = function_store_free;
106 if (caseless) options |= PCRE_CASELESS;
107 yield = pcre_compile(CCS pattern, options, (const char **)&error, &offset, NULL);
108 pcre_malloc = function_store_get;
109 pcre_free = function_dummy_free;
111 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "regular expression error: "
112 "%s at offset %d while compiling %s", error, offset, pattern);
119 /*************************************************
120 * Execute regular expression and set strings *
121 *************************************************/
123 /* This function runs a regular expression match, and sets up the pointers to
124 the matched substrings.
127 re the compiled expression
128 subject the subject string
129 options additional PCRE options
130 setup if < 0 do full setup
131 if >= 0 setup from setup+1 onwards,
132 excluding the full matched string
134 Returns: TRUE or FALSE
138 regex_match_and_setup(const pcre *re, const uschar *subject, int options, int setup)
140 int ovector[3*(EXPAND_MAXN+1)];
141 uschar * s = string_copy(subject); /* de-constifying */
142 int n = pcre_exec(re, NULL, CS s, Ustrlen(s), 0,
143 PCRE_EOPT | options, ovector, sizeof(ovector)/sizeof(int));
145 if (n == 0) n = EXPAND_MAXN + 1;
149 expand_nmax = (setup < 0)? 0 : setup + 1;
150 for (nn = (setup < 0)? 0 : 2; nn < n*2; nn += 2)
152 expand_nstring[expand_nmax] = s + ovector[nn];
153 expand_nlength[expand_nmax++] = ovector[nn+1] - ovector[nn];
163 /*************************************************
164 * Set up processing details *
165 *************************************************/
167 /* Save a text string for dumping when SIGUSR1 is received.
168 Do checks for overruns.
170 Arguments: format and arguments, as for printf()
175 set_process_info(const char *format, ...)
177 int len = sprintf(CS process_info, "%5d ", (int)getpid());
179 va_start(ap, format);
180 if (!string_vformat(process_info + len, PROCESS_INFO_SIZE - len - 2, format, ap))
181 Ustrcpy(process_info + len, "**** string overflowed buffer ****");
182 len = Ustrlen(process_info);
183 process_info[len+0] = '\n';
184 process_info[len+1] = '\0';
185 process_info_len = len + 1;
186 DEBUG(D_process_info) debug_printf("set_process_info: %s", process_info);
190 /***********************************************
191 * Handler for SIGTERM *
192 ***********************************************/
195 term_handler(int sig)
201 /*************************************************
202 * Handler for SIGUSR1 *
203 *************************************************/
205 /* SIGUSR1 causes any exim process to write to the process log details of
206 what it is currently doing. It will only be used if the OS is capable of
207 setting up a handler that causes automatic restarting of any system call
208 that is in progress at the time.
210 This function takes care to be signal-safe.
212 Argument: the signal number (SIGUSR1)
217 usr1_handler(int sig)
221 os_restarting_signal(sig, usr1_handler);
223 if ((fd = Uopen(process_log_path, O_APPEND|O_WRONLY, LOG_MODE)) < 0)
225 /* If we are already running as the Exim user, try to create it in the
226 current process (assuming spool_directory exists). Otherwise, if we are
227 root, do the creation in an exim:exim subprocess. */
229 int euid = geteuid();
230 if (euid == exim_uid)
231 fd = Uopen(process_log_path, O_CREAT|O_APPEND|O_WRONLY, LOG_MODE);
232 else if (euid == root_uid)
233 fd = log_create_as_exim(process_log_path);
236 /* If we are neither exim nor root, or if we failed to create the log file,
237 give up. There is not much useful we can do with errors, since we don't want
238 to disrupt whatever is going on outside the signal handler. */
242 (void)write(fd, process_info, process_info_len);
248 /*************************************************
250 *************************************************/
252 /* This handler is enabled most of the time that Exim is running. The handler
253 doesn't actually get used unless alarm() has been called to set a timer, to
254 place a time limit on a system call of some kind. When the handler is run, it
257 There are some other SIGALRM handlers that are used in special cases when more
258 than just a flag setting is required; for example, when reading a message's
259 input. These are normally set up in the code module that uses them, and the
260 SIGALRM handler is reset to this one afterwards.
262 Argument: the signal value (SIGALRM)
267 sigalrm_handler(int sig)
269 sig = sig; /* Keep picky compilers happy */
271 os_non_restarting_signal(SIGALRM, sigalrm_handler);
276 /*************************************************
277 * Sleep for a fractional time interval *
278 *************************************************/
280 /* This function is called by millisleep() and exim_wait_tick() to wait for a
281 period of time that may include a fraction of a second. The coding is somewhat
282 tedious. We do not expect setitimer() ever to fail, but if it does, the process
283 will wait for ever, so we panic in this instance. (There was a case of this
284 when a bug in a function that calls milliwait() caused it to pass invalid data.
285 That's when I added the check. :-)
287 We assume it to be not worth sleeping for under 100us; this value will
288 require revisiting as hardware advances. This avoids the issue of
289 a zero-valued timer setting meaning "never fire".
291 Argument: an itimerval structure containing the interval
296 milliwait(struct itimerval *itval)
299 sigset_t old_sigmask;
301 if (itval->it_value.tv_usec < 100 && itval->it_value.tv_sec == 0)
303 (void)sigemptyset(&sigmask); /* Empty mask */
304 (void)sigaddset(&sigmask, SIGALRM); /* Add SIGALRM */
305 (void)sigprocmask(SIG_BLOCK, &sigmask, &old_sigmask); /* Block SIGALRM */
306 if (setitimer(ITIMER_REAL, itval, NULL) < 0) /* Start timer */
307 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
308 "setitimer() failed: %s", strerror(errno));
309 (void)sigfillset(&sigmask); /* All signals */
310 (void)sigdelset(&sigmask, SIGALRM); /* Remove SIGALRM */
311 (void)sigsuspend(&sigmask); /* Until SIGALRM */
312 (void)sigprocmask(SIG_SETMASK, &old_sigmask, NULL); /* Restore mask */
318 /*************************************************
319 * Millisecond sleep function *
320 *************************************************/
322 /* The basic sleep() function has a granularity of 1 second, which is too rough
323 in some cases - for example, when using an increasing delay to slow down
326 Argument: number of millseconds
333 struct itimerval itval;
334 itval.it_interval.tv_sec = 0;
335 itval.it_interval.tv_usec = 0;
336 itval.it_value.tv_sec = msec/1000;
337 itval.it_value.tv_usec = (msec % 1000) * 1000;
343 /*************************************************
344 * Compare microsecond times *
345 *************************************************/
352 Returns: -1, 0, or +1
356 exim_tvcmp(struct timeval *t1, struct timeval *t2)
358 if (t1->tv_sec > t2->tv_sec) return +1;
359 if (t1->tv_sec < t2->tv_sec) return -1;
360 if (t1->tv_usec > t2->tv_usec) return +1;
361 if (t1->tv_usec < t2->tv_usec) return -1;
368 /*************************************************
369 * Clock tick wait function *
370 *************************************************/
372 /* Exim uses a time + a pid to generate a unique identifier in two places: its
373 message IDs, and in file names for maildir deliveries. Because some OS now
374 re-use pids within the same second, sub-second times are now being used.
375 However, for absolute certainty, we must ensure the clock has ticked before
376 allowing the relevant process to complete. At the time of implementation of
377 this code (February 2003), the speed of processors is such that the clock will
378 invariably have ticked already by the time a process has done its job. This
379 function prepares for the time when things are faster - and it also copes with
380 clocks that go backwards.
383 then_tv A timeval which was used to create uniqueness; its usec field
384 has been rounded down to the value of the resolution.
385 We want to be sure the current time is greater than this.
386 resolution The resolution that was used to divide the microseconds
387 (1 for maildir, larger for message ids)
393 exim_wait_tick(struct timeval *then_tv, int resolution)
395 struct timeval now_tv;
396 long int now_true_usec;
398 (void)gettimeofday(&now_tv, NULL);
399 now_true_usec = now_tv.tv_usec;
400 now_tv.tv_usec = (now_true_usec/resolution) * resolution;
402 if (exim_tvcmp(&now_tv, then_tv) <= 0)
404 struct itimerval itval;
405 itval.it_interval.tv_sec = 0;
406 itval.it_interval.tv_usec = 0;
407 itval.it_value.tv_sec = then_tv->tv_sec - now_tv.tv_sec;
408 itval.it_value.tv_usec = then_tv->tv_usec + resolution - now_true_usec;
410 /* We know that, overall, "now" is less than or equal to "then". Therefore, a
411 negative value for the microseconds is possible only in the case when "now"
412 is more than a second less than "then". That means that itval.it_value.tv_sec
413 is greater than zero. The following correction is therefore safe. */
415 if (itval.it_value.tv_usec < 0)
417 itval.it_value.tv_usec += 1000000;
418 itval.it_value.tv_sec -= 1;
421 DEBUG(D_transport|D_receive)
423 if (!running_in_test_harness)
425 debug_printf("tick check: " TIME_T_FMT ".%06lu " TIME_T_FMT ".%06lu\n",
426 then_tv->tv_sec, (long) then_tv->tv_usec,
427 now_tv.tv_sec, (long) now_tv.tv_usec);
428 debug_printf("waiting " TIME_T_FMT ".%06lu\n",
429 itval.it_value.tv_sec, (long) itval.it_value.tv_usec);
440 /*************************************************
441 * Call fopen() with umask 777 and adjust mode *
442 *************************************************/
444 /* Exim runs with umask(0) so that files created with open() have the mode that
445 is specified in the open() call. However, there are some files, typically in
446 the spool directory, that are created with fopen(). They end up world-writeable
447 if no precautions are taken. Although the spool directory is not accessible to
448 the world, this is an untidiness. So this is a wrapper function for fopen()
449 that sorts out the mode of the created file.
452 filename the file name
453 options the fopen() options
454 mode the required mode
456 Returns: the fopened FILE or NULL
460 modefopen(const uschar *filename, const char *options, mode_t mode)
462 mode_t saved_umask = umask(0777);
463 FILE *f = Ufopen(filename, options);
464 (void)umask(saved_umask);
465 if (f != NULL) (void)fchmod(fileno(f), mode);
472 /*************************************************
473 * Ensure stdin, stdout, and stderr exist *
474 *************************************************/
476 /* Some operating systems grumble if an exec() happens without a standard
477 input, output, and error (fds 0, 1, 2) being defined. The worry is that some
478 file will be opened and will use these fd values, and then some other bit of
479 code will assume, for example, that it can write error messages to stderr.
480 This function ensures that fds 0, 1, and 2 are open if they do not already
481 exist, by connecting them to /dev/null.
483 This function is also used to ensure that std{in,out,err} exist at all times,
484 so that if any library that Exim calls tries to use them, it doesn't crash.
496 for (i = 0; i <= 2; i++)
498 if (fstat(i, &statbuf) < 0 && errno == EBADF)
500 if (devnull < 0) devnull = open("/dev/null", O_RDWR);
501 if (devnull < 0) log_write(0, LOG_MAIN|LOG_PANIC_DIE, "%s",
502 string_open_failed(errno, "/dev/null"));
503 if (devnull != i) (void)dup2(devnull, i);
506 if (devnull > 2) (void)close(devnull);
512 /*************************************************
513 * Close unwanted file descriptors for delivery *
514 *************************************************/
516 /* This function is called from a new process that has been forked to deliver
517 an incoming message, either directly, or using exec.
519 We want any smtp input streams to be closed in this new process. However, it
520 has been observed that using fclose() here causes trouble. When reading in -bS
521 input, duplicate copies of messages have been seen. The files will be sharing a
522 file pointer with the parent process, and it seems that fclose() (at least on
523 some systems - I saw this on Solaris 2.5.1) messes with that file pointer, at
524 least sometimes. Hence we go for closing the underlying file descriptors.
526 If TLS is active, we want to shut down the TLS library, but without molesting
527 the parent's SSL connection.
529 For delivery of a non-SMTP message, we want to close stdin and stdout (and
530 stderr unless debugging) because the calling process might have set them up as
531 pipes and be waiting for them to close before it waits for the submission
532 process to terminate. If they aren't closed, they hold up the calling process
533 until the initial delivery process finishes, which is not what we want.
535 Exception: We do want it for synchronous delivery!
537 And notwithstanding all the above, if D_resolver is set, implying resolver
538 debugging, leave stdout open, because that's where the resolver writes its
541 When we close stderr (which implies we've also closed stdout), we also get rid
542 of any controlling terminal.
554 tls_close(TRUE, TLS_NO_SHUTDOWN); /* Shut down the TLS library */
556 (void)close(fileno(smtp_in));
557 (void)close(fileno(smtp_out));
562 (void)close(0); /* stdin */
563 if ((debug_selector & D_resolver) == 0) (void)close(1); /* stdout */
564 if (debug_selector == 0) /* stderr */
566 if (!synchronous_delivery)
579 /*************************************************
581 *************************************************/
583 /* This function sets a new uid and gid permanently, optionally calling
584 initgroups() to set auxiliary groups. There are some special cases when running
585 Exim in unprivileged modes. In these situations the effective uid will not be
586 root; if we already have the right effective uid/gid, and don't need to
587 initialize any groups, leave things as they are.
592 igflag TRUE if initgroups() wanted
593 msg text to use in debugging output and failure log
595 Returns: nothing; bombs out on failure
599 exim_setugid(uid_t uid, gid_t gid, BOOL igflag, uschar *msg)
601 uid_t euid = geteuid();
602 gid_t egid = getegid();
604 if (euid == root_uid || euid != uid || egid != gid || igflag)
606 /* At least one OS returns +1 for initgroups failure, so just check for
611 struct passwd *pw = getpwuid(uid);
614 if (initgroups(pw->pw_name, gid) != 0)
615 log_write(0,LOG_MAIN|LOG_PANIC_DIE,"initgroups failed for uid=%ld: %s",
616 (long int)uid, strerror(errno));
618 else log_write(0, LOG_MAIN|LOG_PANIC_DIE, "cannot run initgroups(): "
619 "no passwd entry for uid=%ld", (long int)uid);
622 if (setgid(gid) < 0 || setuid(uid) < 0)
624 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "unable to set gid=%ld or uid=%ld "
625 "(euid=%ld): %s", (long int)gid, (long int)uid, (long int)euid, msg);
629 /* Debugging output included uid/gid and all groups */
633 int group_count, save_errno;
634 gid_t group_list[NGROUPS_MAX];
635 debug_printf("changed uid/gid: %s\n uid=%ld gid=%ld pid=%ld\n", msg,
636 (long int)geteuid(), (long int)getegid(), (long int)getpid());
637 group_count = getgroups(NGROUPS_MAX, group_list);
639 debug_printf(" auxiliary group list:");
643 for (i = 0; i < group_count; i++) debug_printf(" %d", (int)group_list[i]);
645 else if (group_count < 0)
646 debug_printf(" <error: %s>", strerror(save_errno));
647 else debug_printf(" <none>");
655 /*************************************************
657 *************************************************/
659 /* Exim exits via this function so that it always clears up any open
665 Returns: does not return
669 exim_exit(int rc, const uschar * process)
673 debug_printf(">>>>>>>>>>>>>>>> Exim pid=%d %s%s%sterminating with rc=%d "
674 ">>>>>>>>>>>>>>>>\n", (int)getpid(),
675 process ? "(" : "", process, process ? ") " : "", rc);
682 /*************************************************
683 * Extract port from host address *
684 *************************************************/
686 /* Called to extract the port from the values given to -oMa and -oMi.
687 It also checks the syntax of the address, and terminates it before the
688 port data when a port is extracted.
691 address the address, with possible port on the end
693 Returns: the port, or zero if there isn't one
694 bombs out on a syntax error
698 check_port(uschar *address)
700 int port = host_address_extract_port(address);
701 if (string_is_ip_address(address, NULL) == 0)
703 fprintf(stderr, "exim abandoned: \"%s\" is not an IP address\n", address);
711 /*************************************************
712 * Test/verify an address *
713 *************************************************/
715 /* This function is called by the -bv and -bt code. It extracts a working
716 address from a full RFC 822 address. This isn't really necessary per se, but it
717 has the effect of collapsing source routes.
721 flags flag bits for verify_address()
722 exit_value to be set for failures
728 test_address(uschar *s, int flags, int *exit_value)
730 int start, end, domain;
731 uschar *parse_error = NULL;
732 uschar *address = parse_extract_address(s, &parse_error, &start, &end, &domain,
736 fprintf(stdout, "syntax error: %s\n", parse_error);
741 int rc = verify_address(deliver_make_addr(address,TRUE), stdout, flags, -1,
742 -1, -1, NULL, NULL, NULL);
743 if (rc == FAIL) *exit_value = 2;
744 else if (rc == DEFER && *exit_value == 0) *exit_value = 1;
750 /*************************************************
751 * Show supported features *
752 *************************************************/
755 show_db_version(FILE * f)
757 #ifdef DB_VERSION_STRING
760 fprintf(f, "Library version: BDB: Compile: %s\n", DB_VERSION_STRING);
761 fprintf(f, " Runtime: %s\n",
762 db_version(NULL, NULL, NULL));
765 fprintf(f, "Berkeley DB: %s\n", DB_VERSION_STRING);
767 #elif defined(BTREEVERSION) && defined(HASHVERSION)
769 fprintf(f, "Probably Berkeley DB version 1.8x (native mode)\n");
771 fprintf(f, "Probably Berkeley DB version 1.8x (compatibility mode)\n");
774 #elif defined(_DBM_RDONLY) || defined(dbm_dirfno)
775 fprintf(f, "Probably ndbm\n");
776 #elif defined(USE_TDB)
777 fprintf(f, "Using tdb\n");
780 fprintf(f, "Probably GDBM (native mode)\n");
782 fprintf(f, "Probably GDBM (compatibility mode)\n");
788 /* This function is called for -bV/--version and for -d to output the optional
789 features of the current Exim binary.
791 Arguments: a FILE for printing
796 show_whats_supported(FILE * f)
800 DEBUG(D_any) {} else show_db_version(f);
802 fprintf(f, "Support for:");
803 #ifdef SUPPORT_CRYPTEQ
804 fprintf(f, " crypteq");
807 fprintf(f, " iconv()");
812 #ifdef HAVE_SETCLASSRESOURCES
813 fprintf(f, " use_setclassresources");
822 fprintf(f, " Expand_dlfunc");
824 #ifdef USE_TCP_WRAPPERS
825 fprintf(f, " TCPwrappers");
829 fprintf(f, " GnuTLS");
831 fprintf(f, " OpenSSL");
834 #ifdef SUPPORT_TRANSLATE_IP_ADDRESS
835 fprintf(f, " translate_ip_address");
837 #ifdef SUPPORT_MOVE_FROZEN_MESSAGES
838 fprintf(f, " move_frozen_messages");
840 #ifdef WITH_CONTENT_SCAN
841 fprintf(f, " Content_Scanning");
849 #ifndef DISABLE_DNSSEC
850 fprintf(f, " DNSSEC");
852 #ifndef DISABLE_EVENT
853 fprintf(f, " Event");
865 fprintf(f, " PROXY");
868 fprintf(f, " SOCKS");
875 if (tcp_fastopen_ok) fprintf(f, " TCP_Fast_Open");
877 #ifdef EXPERIMENTAL_LMDB
878 fprintf(f, " Experimental_LMDB");
880 #ifdef EXPERIMENTAL_QUEUEFILE
881 fprintf(f, " Experimental_QUEUEFILE");
883 #ifdef EXPERIMENTAL_SRS
884 fprintf(f, " Experimental_SRS");
886 #ifdef EXPERIMENTAL_ARC
887 fprintf(f, " Experimental_ARC");
889 #ifdef EXPERIMENTAL_BRIGHTMAIL
890 fprintf(f, " Experimental_Brightmail");
892 #ifdef EXPERIMENTAL_DCC
893 fprintf(f, " Experimental_DCC");
895 #ifdef EXPERIMENTAL_DMARC
896 fprintf(f, " Experimental_DMARC");
898 #ifdef EXPERIMENTAL_DSN_INFO
899 fprintf(f, " Experimental_DSN_info");
903 fprintf(f, "Lookups (built-in):");
904 #if defined(LOOKUP_LSEARCH) && LOOKUP_LSEARCH!=2
905 fprintf(f, " lsearch wildlsearch nwildlsearch iplsearch");
907 #if defined(LOOKUP_CDB) && LOOKUP_CDB!=2
910 #if defined(LOOKUP_DBM) && LOOKUP_DBM!=2
911 fprintf(f, " dbm dbmjz dbmnz");
913 #if defined(LOOKUP_DNSDB) && LOOKUP_DNSDB!=2
914 fprintf(f, " dnsdb");
916 #if defined(LOOKUP_DSEARCH) && LOOKUP_DSEARCH!=2
917 fprintf(f, " dsearch");
919 #if defined(LOOKUP_IBASE) && LOOKUP_IBASE!=2
920 fprintf(f, " ibase");
922 #if defined(LOOKUP_LDAP) && LOOKUP_LDAP!=2
923 fprintf(f, " ldap ldapdn ldapm");
925 #ifdef EXPERIMENTAL_LMDB
928 #if defined(LOOKUP_MYSQL) && LOOKUP_MYSQL!=2
929 fprintf(f, " mysql");
931 #if defined(LOOKUP_NIS) && LOOKUP_NIS!=2
932 fprintf(f, " nis nis0");
934 #if defined(LOOKUP_NISPLUS) && LOOKUP_NISPLUS!=2
935 fprintf(f, " nisplus");
937 #if defined(LOOKUP_ORACLE) && LOOKUP_ORACLE!=2
938 fprintf(f, " oracle");
940 #if defined(LOOKUP_PASSWD) && LOOKUP_PASSWD!=2
941 fprintf(f, " passwd");
943 #if defined(LOOKUP_PGSQL) && LOOKUP_PGSQL!=2
944 fprintf(f, " pgsql");
946 #if defined(LOOKUP_REDIS) && LOOKUP_REDIS!=2
947 fprintf(f, " redis");
949 #if defined(LOOKUP_SQLITE) && LOOKUP_SQLITE!=2
950 fprintf(f, " sqlite");
952 #if defined(LOOKUP_TESTDB) && LOOKUP_TESTDB!=2
953 fprintf(f, " testdb");
955 #if defined(LOOKUP_WHOSON) && LOOKUP_WHOSON!=2
956 fprintf(f, " whoson");
960 auth_show_supported(f);
961 route_show_supported(f);
962 transport_show_supported(f);
964 #ifdef WITH_CONTENT_SCAN
965 malware_show_supported(f);
968 if (fixed_never_users[0] > 0)
971 fprintf(f, "Fixed never_users: ");
972 for (i = 1; i <= (int)fixed_never_users[0] - 1; i++)
973 fprintf(f, "%d:", (unsigned int)fixed_never_users[i]);
974 fprintf(f, "%d\n", (unsigned int)fixed_never_users[i]);
977 fprintf(f, "Configure owner: %d:%d\n", config_uid, config_gid);
979 fprintf(f, "Size of off_t: " SIZE_T_FMT "\n", sizeof(off_t));
981 /* Everything else is details which are only worth reporting when debugging.
982 Perhaps the tls_version_report should move into this too. */
987 /* clang defines __GNUC__ (at least, for me) so test for it first */
988 #if defined(__clang__)
989 fprintf(f, "Compiler: CLang [%s]\n", __clang_version__);
990 #elif defined(__GNUC__)
991 fprintf(f, "Compiler: GCC [%s]\n",
995 "? unknown version ?"
999 fprintf(f, "Compiler: <unknown>\n");
1002 #if defined(__GLIBC__) && !defined(__UCLIBC__)
1003 fprintf(f, "Library version: Glibc: Compile: %d.%d\n",
1004 __GLIBC__, __GLIBC_MINOR__);
1005 if (__GLIBC_PREREQ(2, 1))
1006 fprintf(f, " Runtime: %s\n",
1007 gnu_get_libc_version());
1013 tls_version_report(f);
1016 utf8_version_report(f);
1019 for (authi = auths_available; *authi->driver_name != '\0'; ++authi)
1020 if (authi->version_report)
1021 (*authi->version_report)(f);
1023 /* PCRE_PRERELEASE is either defined and empty or a bare sequence of
1024 characters; unless it's an ancient version of PCRE in which case it
1026 #ifndef PCRE_PRERELEASE
1027 # define PCRE_PRERELEASE
1030 #define EXPAND_AND_QUOTE(X) QUOTE(X)
1031 fprintf(f, "Library version: PCRE: Compile: %d.%d%s\n"
1033 PCRE_MAJOR, PCRE_MINOR,
1034 EXPAND_AND_QUOTE(PCRE_PRERELEASE) "",
1037 #undef EXPAND_AND_QUOTE
1040 for (i = 0; i < lookup_list_count; i++)
1041 if (lookup_list[i]->version_report)
1042 lookup_list[i]->version_report(f);
1044 #ifdef WHITELIST_D_MACROS
1045 fprintf(f, "WHITELIST_D_MACROS: \"%s\"\n", WHITELIST_D_MACROS);
1047 fprintf(f, "WHITELIST_D_MACROS unset\n");
1049 #ifdef TRUSTED_CONFIG_LIST
1050 fprintf(f, "TRUSTED_CONFIG_LIST: \"%s\"\n", TRUSTED_CONFIG_LIST);
1052 fprintf(f, "TRUSTED_CONFIG_LIST unset\n");
1059 /*************************************************
1060 * Show auxiliary information about Exim *
1061 *************************************************/
1064 show_exim_information(enum commandline_info request, FILE *stream)
1071 fprintf(stream, "Oops, something went wrong.\n");
1075 "The -bI: flag takes a string indicating which information to provide.\n"
1076 "If the string is not recognised, you'll get this help (on stderr).\n"
1078 " exim -bI:help this information\n"
1079 " exim -bI:dscp list of known dscp value keywords\n"
1080 " exim -bI:sieve list of supported sieve extensions\n"
1084 for (pp = exim_sieve_extension_list; *pp; ++pp)
1085 fprintf(stream, "%s\n", *pp);
1088 dscp_list_to_stream(stream);
1094 /*************************************************
1095 * Quote a local part *
1096 *************************************************/
1098 /* This function is used when a sender address or a From: or Sender: header
1099 line is being created from the caller's login, or from an authenticated_id. It
1100 applies appropriate quoting rules for a local part.
1102 Argument: the local part
1103 Returns: the local part, quoted if necessary
1107 local_part_quote(uschar *lpart)
1109 BOOL needs_quote = FALSE;
1113 for (t = lpart; !needs_quote && *t != 0; t++)
1115 needs_quote = !isalnum(*t) && strchr("!#$%&'*+-/=?^_`{|}~", *t) == NULL &&
1116 (*t != '.' || t == lpart || t[1] == 0);
1119 if (!needs_quote) return lpart;
1121 g = string_catn(NULL, US"\"", 1);
1125 uschar *nq = US Ustrpbrk(lpart, "\\\"");
1128 g = string_cat(g, lpart);
1131 g = string_catn(g, lpart, nq - lpart);
1132 g = string_catn(g, US"\\", 1);
1133 g = string_catn(g, nq, 1);
1137 g = string_catn(g, US"\"", 1);
1138 return string_from_gstring(g);
1144 /*************************************************
1145 * Load readline() functions *
1146 *************************************************/
1148 /* This function is called from testing executions that read data from stdin,
1149 but only when running as the calling user. Currently, only -be does this. The
1150 function loads the readline() function library and passes back the functions.
1151 On some systems, it needs the curses library, so load that too, but try without
1152 it if loading fails. All this functionality has to be requested at build time.
1155 fn_readline_ptr pointer to where to put the readline pointer
1156 fn_addhist_ptr pointer to where to put the addhistory function
1158 Returns: the dlopen handle or NULL on failure
1162 set_readline(char * (**fn_readline_ptr)(const char *),
1163 void (**fn_addhist_ptr)(const char *))
1166 void *dlhandle_curses = dlopen("libcurses." DYNLIB_FN_EXT, RTLD_GLOBAL|RTLD_LAZY);
1168 dlhandle = dlopen("libreadline." DYNLIB_FN_EXT, RTLD_GLOBAL|RTLD_NOW);
1169 if (dlhandle_curses != NULL) dlclose(dlhandle_curses);
1171 if (dlhandle != NULL)
1173 /* Checked manual pages; at least in GNU Readline 6.1, the prototypes are:
1174 * char * readline (const char *prompt);
1175 * void add_history (const char *string);
1177 *fn_readline_ptr = (char *(*)(const char*))dlsym(dlhandle, "readline");
1178 *fn_addhist_ptr = (void(*)(const char*))dlsym(dlhandle, "add_history");
1182 DEBUG(D_any) debug_printf("failed to load readline: %s\n", dlerror());
1191 /*************************************************
1192 * Get a line from stdin for testing things *
1193 *************************************************/
1195 /* This function is called when running tests that can take a number of lines
1196 of input (for example, -be and -bt). It handles continuations and trailing
1197 spaces. And prompting and a blank line output on eof. If readline() is in use,
1198 the arguments are non-NULL and provide the relevant functions.
1201 fn_readline readline function or NULL
1202 fn_addhist addhist function or NULL
1204 Returns: pointer to dynamic memory, or NULL at end of file
1208 get_stdinput(char *(*fn_readline)(const char *), void(*fn_addhist)(const char *))
1213 if (!fn_readline) { printf("> "); fflush(stdout); }
1217 uschar buffer[1024];
1221 char *readline_line = NULL;
1222 if (fn_readline != NULL)
1224 if ((readline_line = fn_readline((i > 0)? "":"> ")) == NULL) break;
1225 if (*readline_line != 0 && fn_addhist != NULL) fn_addhist(readline_line);
1226 p = US readline_line;
1231 /* readline() not in use */
1234 if (Ufgets(buffer, sizeof(buffer), stdin) == NULL) break;
1238 /* Handle the line */
1240 ss = p + (int)Ustrlen(p);
1241 while (ss > p && isspace(ss[-1])) ss--;
1245 while (p < ss && isspace(*p)) p++; /* leading space after cont */
1248 g = string_catn(g, p, ss - p);
1251 if (fn_readline) free(readline_line);
1254 /* g can only be NULL if ss==p */
1255 if (ss == p || g->s[g->ptr-1] != '\\')
1259 (void) string_from_gstring(g);
1262 if (!g) printf("\n");
1263 return string_from_gstring(g);
1268 /*************************************************
1269 * Output usage information for the program *
1270 *************************************************/
1272 /* This function is called when there are no recipients
1273 or a specific --help argument was added.
1276 progname information on what name we were called by
1278 Returns: DOES NOT RETURN
1282 exim_usage(uschar *progname)
1285 /* Handle specific program invocation variants */
1286 if (Ustrcmp(progname, US"-mailq") == 0)
1289 "mailq - list the contents of the mail queue\n\n"
1290 "For a list of options, see the Exim documentation.\n");
1294 /* Generic usage - we output this whatever happens */
1296 "Exim is a Mail Transfer Agent. It is normally called by Mail User Agents,\n"
1297 "not directly from a shell command line. Options and/or arguments control\n"
1298 "what it does when called. For a list of options, see the Exim documentation.\n");
1305 /*************************************************
1306 * Validate that the macros given are okay *
1307 *************************************************/
1309 /* Typically, Exim will drop privileges if macros are supplied. In some
1310 cases, we want to not do so.
1312 Arguments: opt_D_used - true if the commandline had a "-D" option
1313 Returns: true if trusted, false otherwise
1317 macros_trusted(BOOL opt_D_used)
1319 #ifdef WHITELIST_D_MACROS
1321 uschar *whitelisted, *end, *p, **whites, **w;
1322 int white_count, i, n;
1324 BOOL prev_char_item, found;
1329 #ifndef WHITELIST_D_MACROS
1333 /* We only trust -D overrides for some invoking users:
1334 root, the exim run-time user, the optional config owner user.
1335 I don't know why config-owner would be needed, but since they can own the
1336 config files anyway, there's no security risk to letting them override -D. */
1337 if ( ! ((real_uid == root_uid)
1338 || (real_uid == exim_uid)
1339 #ifdef CONFIGURE_OWNER
1340 || (real_uid == config_uid)
1344 debug_printf("macros_trusted rejecting macros for uid %d\n", (int) real_uid);
1348 /* Get a list of macros which are whitelisted */
1349 whitelisted = string_copy_malloc(US WHITELIST_D_MACROS);
1350 prev_char_item = FALSE;
1352 for (p = whitelisted; *p != '\0'; ++p)
1354 if (*p == ':' || isspace(*p))
1359 prev_char_item = FALSE;
1362 if (!prev_char_item)
1363 prev_char_item = TRUE;
1370 whites = store_malloc(sizeof(uschar *) * (white_count+1));
1371 for (p = whitelisted, i = 0; (p != end) && (i < white_count); ++p)
1376 if (i == white_count)
1378 while (*p != '\0' && p < end)
1384 /* The list of commandline macros should be very short.
1385 Accept the N*M complexity. */
1386 for (m = macros_user; m; m = m->next) if (m->command_line)
1389 for (w = whites; *w; ++w)
1390 if (Ustrcmp(*w, m->name) == 0)
1397 if (!m->replacement)
1399 if ((len = m->replen) == 0)
1401 n = pcre_exec(regex_whitelisted_macro, NULL, CS m->replacement, len,
1402 0, PCRE_EOPT, NULL, 0);
1405 if (n != PCRE_ERROR_NOMATCH)
1406 debug_printf("macros_trusted checking %s returned %d\n", m->name, n);
1410 DEBUG(D_any) debug_printf("macros_trusted overridden to true by whitelisting\n");
1416 /*************************************************
1417 * Expansion testing *
1418 *************************************************/
1420 /* Expand and print one item, doing macro-processing.
1423 item line for expansion
1427 expansion_test_line(uschar * line)
1432 Ustrncpy(big_buffer, line, big_buffer_size);
1433 big_buffer[big_buffer_size-1] = '\0';
1434 len = Ustrlen(big_buffer);
1436 (void) macros_expand(0, &len, &dummy_macexp);
1438 if (isupper(big_buffer[0]))
1440 if (macro_read_assignment(big_buffer))
1441 printf("Defined macro '%s'\n", mlast->name);
1444 if ((line = expand_string(big_buffer))) printf("%s\n", CS line);
1445 else printf("Failed: %s\n", expand_string_message);
1449 /*************************************************
1450 * Entry point and high-level code *
1451 *************************************************/
1453 /* Entry point for the Exim mailer. Analyse the arguments and arrange to take
1454 the appropriate action. All the necessary functions are present in the one
1455 binary. I originally thought one should split it up, but it turns out that so
1456 much of the apparatus is needed in each chunk that one might as well just have
1457 it all available all the time, which then makes the coding easier as well.
1460 argc count of entries in argv
1461 argv argument strings, with argv[0] being the program name
1463 Returns: EXIT_SUCCESS if terminated successfully
1464 EXIT_FAILURE otherwise, except when a message has been sent
1465 to the sender, and -oee was given
1469 main(int argc, char **cargv)
1471 uschar **argv = USS cargv;
1472 int arg_receive_timeout = -1;
1473 int arg_smtp_receive_timeout = -1;
1474 int arg_error_handling = error_handling;
1475 int filter_sfd = -1;
1476 int filter_ufd = -1;
1479 int list_queue_option = 0;
1481 int msg_action_arg = -1;
1482 int namelen = (argv[0] == NULL)? 0 : Ustrlen(argv[0]);
1483 int queue_only_reason = 0;
1485 int perl_start_option = 0;
1487 int recipients_arg = argc;
1488 int sender_address_domain = 0;
1489 int test_retry_arg = -1;
1490 int test_rewrite_arg = -1;
1491 BOOL arg_queue_only = FALSE;
1492 BOOL bi_option = FALSE;
1493 BOOL checking = FALSE;
1494 BOOL count_queue = FALSE;
1495 BOOL expansion_test = FALSE;
1496 BOOL extract_recipients = FALSE;
1497 BOOL flag_G = FALSE;
1498 BOOL flag_n = FALSE;
1499 BOOL forced_delivery = FALSE;
1500 BOOL f_end_dot = FALSE;
1501 BOOL deliver_give_up = FALSE;
1502 BOOL list_queue = FALSE;
1503 BOOL list_options = FALSE;
1504 BOOL list_config = FALSE;
1505 BOOL local_queue_only;
1507 BOOL one_msg_action = FALSE;
1508 BOOL opt_D_used = FALSE;
1509 BOOL queue_only_set = FALSE;
1510 BOOL receiving_message = TRUE;
1511 BOOL sender_ident_set = FALSE;
1512 BOOL session_local_queue_only;
1514 BOOL removed_privilege = FALSE;
1515 BOOL usage_wanted = FALSE;
1516 BOOL verify_address_mode = FALSE;
1517 BOOL verify_as_sender = FALSE;
1518 BOOL version_printed = FALSE;
1519 uschar *alias_arg = NULL;
1520 uschar *called_as = US"";
1521 uschar *cmdline_syslog_name = NULL;
1522 uschar *start_queue_run_id = NULL;
1523 uschar *stop_queue_run_id = NULL;
1524 uschar *expansion_test_message = NULL;
1525 uschar *ftest_domain = NULL;
1526 uschar *ftest_localpart = NULL;
1527 uschar *ftest_prefix = NULL;
1528 uschar *ftest_suffix = NULL;
1529 uschar *log_oneline = NULL;
1530 uschar *malware_test_file = NULL;
1531 uschar *real_sender_address;
1532 uschar *originator_home = US"/";
1537 struct stat statbuf;
1538 pid_t passed_qr_pid = (pid_t)0;
1539 int passed_qr_pipe = -1;
1540 gid_t group_list[NGROUPS_MAX];
1542 /* For the -bI: flag */
1543 enum commandline_info info_flag = CMDINFO_NONE;
1544 BOOL info_stdout = FALSE;
1546 /* Possible options for -R and -S */
1548 static uschar *rsopts[] = { US"f", US"ff", US"r", US"rf", US"rff" };
1550 /* Need to define this in case we need to change the environment in order
1551 to get rid of a bogus time zone. We have to make it char rather than uschar
1552 because some OS define it in /usr/include/unistd.h. */
1554 extern char **environ;
1556 /* If the Exim user and/or group and/or the configuration file owner/group were
1557 defined by ref:name at build time, we must now find the actual uid/gid values.
1558 This is a feature to make the lives of binary distributors easier. */
1560 #ifdef EXIM_USERNAME
1561 if (route_finduser(US EXIM_USERNAME, &pw, &exim_uid))
1565 fprintf(stderr, "exim: refusing to run with uid 0 for \"%s\"\n",
1569 /* If ref:name uses a number as the name, route_finduser() returns
1570 TRUE with exim_uid set and pw coerced to NULL. */
1572 exim_gid = pw->pw_gid;
1573 #ifndef EXIM_GROUPNAME
1577 "exim: ref:name should specify a usercode, not a group.\n"
1578 "exim: can't let you get away with it unless you also specify a group.\n");
1585 fprintf(stderr, "exim: failed to find uid for user name \"%s\"\n",
1591 #ifdef EXIM_GROUPNAME
1592 if (!route_findgroup(US EXIM_GROUPNAME, &exim_gid))
1594 fprintf(stderr, "exim: failed to find gid for group name \"%s\"\n",
1600 #ifdef CONFIGURE_OWNERNAME
1601 if (!route_finduser(US CONFIGURE_OWNERNAME, NULL, &config_uid))
1603 fprintf(stderr, "exim: failed to find uid for user name \"%s\"\n",
1604 CONFIGURE_OWNERNAME);
1609 /* We default the system_filter_user to be the Exim run-time user, as a
1610 sane non-root value. */
1611 system_filter_uid = exim_uid;
1613 #ifdef CONFIGURE_GROUPNAME
1614 if (!route_findgroup(US CONFIGURE_GROUPNAME, &config_gid))
1616 fprintf(stderr, "exim: failed to find gid for group name \"%s\"\n",
1617 CONFIGURE_GROUPNAME);
1622 /* In the Cygwin environment, some initialization used to need doing.
1623 It was fudged in by means of this macro; now no longer but we'll leave
1624 it in case of others. */
1630 /* Check a field which is patched when we are running Exim within its
1631 testing harness; do a fast initial check, and then the whole thing. */
1633 running_in_test_harness =
1634 *running_status == '<' && Ustrcmp(running_status, "<<<testing>>>") == 0;
1635 if (running_in_test_harness)
1638 /* The C standard says that the equivalent of setlocale(LC_ALL, "C") is obeyed
1639 at the start of a program; however, it seems that some environments do not
1640 follow this. A "strange" locale can affect the formatting of timestamps, so we
1643 setlocale(LC_ALL, "C");
1645 /* Set up the default handler for timing using alarm(). */
1647 os_non_restarting_signal(SIGALRM, sigalrm_handler);
1649 /* Ensure we have a buffer for constructing log entries. Use malloc directly,
1650 because store_malloc writes a log entry on failure. */
1652 if (!(log_buffer = US malloc(LOG_BUFFER_SIZE)))
1654 fprintf(stderr, "exim: failed to get store for log buffer\n");
1658 /* Initialize the default log options. */
1660 bits_set(log_selector, log_selector_size, log_default);
1662 /* Set log_stderr to stderr, provided that stderr exists. This gets reset to
1663 NULL when the daemon is run and the file is closed. We have to use this
1664 indirection, because some systems don't allow writing to the variable "stderr".
1667 if (fstat(fileno(stderr), &statbuf) >= 0) log_stderr = stderr;
1669 /* Arrange for the PCRE regex library to use our store functions. Note that
1670 the normal calls are actually macros that add additional arguments for
1671 debugging purposes so we have to assign specially constructed functions here.
1672 The default is to use store in the stacking pool, but this is overridden in the
1673 regex_must_compile() function. */
1675 pcre_malloc = function_store_get;
1676 pcre_free = function_dummy_free;
1678 /* Ensure there is a big buffer for temporary use in several places. It is put
1679 in malloc store so that it can be freed for enlargement if necessary. */
1681 big_buffer = store_malloc(big_buffer_size);
1683 /* Set up the handler for the data request signal, and set the initial
1684 descriptive text. */
1686 set_process_info("initializing");
1687 os_restarting_signal(SIGUSR1, usr1_handler);
1689 /* If running in a dockerized environment, the TERM signal is only
1690 delegated to the PID 1 if we request it by setting an signal handler */
1691 if (getpid() == 1) signal(SIGTERM, term_handler);
1693 /* SIGHUP is used to get the daemon to reconfigure. It gets set as appropriate
1694 in the daemon code. For the rest of Exim's uses, we ignore it. */
1696 signal(SIGHUP, SIG_IGN);
1698 /* We don't want to die on pipe errors as the code is written to handle
1699 the write error instead. */
1701 signal(SIGPIPE, SIG_IGN);
1703 /* Under some circumstance on some OS, Exim can get called with SIGCHLD
1704 set to SIG_IGN. This causes subprocesses that complete before the parent
1705 process waits for them not to hang around, so when Exim calls wait(), nothing
1706 is there. The wait() code has been made robust against this, but let's ensure
1707 that SIGCHLD is set to SIG_DFL, because it's tidier to wait and get a process
1708 ending status. We use sigaction rather than plain signal() on those OS where
1709 SA_NOCLDWAIT exists, because we want to be sure it is turned off. (There was a
1710 problem on AIX with this.) */
1714 struct sigaction act;
1715 act.sa_handler = SIG_DFL;
1716 sigemptyset(&(act.sa_mask));
1718 sigaction(SIGCHLD, &act, NULL);
1721 signal(SIGCHLD, SIG_DFL);
1724 /* Save the arguments for use if we re-exec exim as a daemon after receiving
1729 /* Set up the version number. Set up the leading 'E' for the external form of
1730 message ids, set the pointer to the internal form, and initialize it to
1731 indicate no message being processed. */
1734 message_id_option[0] = '-';
1735 message_id_external = message_id_option + 1;
1736 message_id_external[0] = 'E';
1737 message_id = message_id_external + 1;
1740 /* Set the umask to zero so that any files Exim creates using open() are
1741 created with the modes that it specifies. NOTE: Files created with fopen() have
1742 a problem, which was not recognized till rather late (February 2006). With this
1743 umask, such files will be world writeable. (They are all content scanning files
1744 in the spool directory, which isn't world-accessible, so this is not a
1745 disaster, but it's untidy.) I don't want to change this overall setting,
1746 however, because it will interact badly with the open() calls. Instead, there's
1747 now a function called modefopen() that fiddles with the umask while calling
1752 /* Precompile the regular expression for matching a message id. Keep this in
1753 step with the code that generates ids in the accept.c module. We need to do
1754 this here, because the -M options check their arguments for syntactic validity
1755 using mac_ismsgid, which uses this. */
1758 regex_must_compile(US"^(?:[^\\W_]{6}-){2}[^\\W_]{2}$", FALSE, TRUE);
1760 /* Precompile the regular expression that is used for matching an SMTP error
1761 code, possibly extended, at the start of an error message. Note that the
1762 terminating whitespace character is included. */
1765 regex_must_compile(US"^\\d\\d\\d\\s(?:\\d\\.\\d\\d?\\d?\\.\\d\\d?\\d?\\s)?",
1768 #ifdef WHITELIST_D_MACROS
1769 /* Precompile the regular expression used to filter the content of macros
1770 given to -D for permissibility. */
1772 regex_whitelisted_macro =
1773 regex_must_compile(US"^[A-Za-z0-9_/.-]*$", FALSE, TRUE);
1776 for (i = 0; i < REGEX_VARS; i++) regex_vars[i] = NULL;
1778 /* If the program is called as "mailq" treat it as equivalent to "exim -bp";
1779 this seems to be a generally accepted convention, since one finds symbolic
1780 links called "mailq" in standard OS configurations. */
1782 if ((namelen == 5 && Ustrcmp(argv[0], "mailq") == 0) ||
1783 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/mailq", 6) == 0))
1786 receiving_message = FALSE;
1787 called_as = US"-mailq";
1790 /* If the program is called as "rmail" treat it as equivalent to
1791 "exim -i -oee", thus allowing UUCP messages to be input using non-SMTP mode,
1792 i.e. preventing a single dot on a line from terminating the message, and
1793 returning with zero return code, even in cases of error (provided an error
1794 message has been sent). */
1796 if ((namelen == 5 && Ustrcmp(argv[0], "rmail") == 0) ||
1797 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/rmail", 6) == 0))
1800 called_as = US"-rmail";
1801 errors_sender_rc = EXIT_SUCCESS;
1804 /* If the program is called as "rsmtp" treat it as equivalent to "exim -bS";
1805 this is a smail convention. */
1807 if ((namelen == 5 && Ustrcmp(argv[0], "rsmtp") == 0) ||
1808 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/rsmtp", 6) == 0))
1810 smtp_input = smtp_batched_input = TRUE;
1811 called_as = US"-rsmtp";
1814 /* If the program is called as "runq" treat it as equivalent to "exim -q";
1815 this is a smail convention. */
1817 if ((namelen == 4 && Ustrcmp(argv[0], "runq") == 0) ||
1818 (namelen > 4 && Ustrncmp(argv[0] + namelen - 5, "/runq", 5) == 0))
1821 receiving_message = FALSE;
1822 called_as = US"-runq";
1825 /* If the program is called as "newaliases" treat it as equivalent to
1826 "exim -bi"; this is a sendmail convention. */
1828 if ((namelen == 10 && Ustrcmp(argv[0], "newaliases") == 0) ||
1829 (namelen > 10 && Ustrncmp(argv[0] + namelen - 11, "/newaliases", 11) == 0))
1832 receiving_message = FALSE;
1833 called_as = US"-newaliases";
1836 /* Save the original effective uid for a couple of uses later. It should
1837 normally be root, but in some esoteric environments it may not be. */
1839 original_euid = geteuid();
1841 /* Get the real uid and gid. If the caller is root, force the effective uid/gid
1842 to be the same as the real ones. This makes a difference only if Exim is setuid
1843 (or setgid) to something other than root, which could be the case in some
1844 special configurations. */
1846 real_uid = getuid();
1847 real_gid = getgid();
1849 if (real_uid == root_uid)
1851 rv = setgid(real_gid);
1854 fprintf(stderr, "exim: setgid(%ld) failed: %s\n",
1855 (long int)real_gid, strerror(errno));
1858 rv = setuid(real_uid);
1861 fprintf(stderr, "exim: setuid(%ld) failed: %s\n",
1862 (long int)real_uid, strerror(errno));
1867 /* If neither the original real uid nor the original euid was root, Exim is
1868 running in an unprivileged state. */
1870 unprivileged = (real_uid != root_uid && original_euid != root_uid);
1872 /* Scan the program's arguments. Some can be dealt with right away; others are
1873 simply recorded for checking and handling afterwards. Do a high-level switch
1874 on the second character (the one after '-'), to save some effort. */
1876 for (i = 1; i < argc; i++)
1878 BOOL badarg = FALSE;
1879 uschar *arg = argv[i];
1883 /* An argument not starting with '-' is the start of a recipients list;
1884 break out of the options-scanning loop. */
1892 /* An option consisting of -- terminates the options */
1894 if (Ustrcmp(arg, "--") == 0)
1896 recipients_arg = i + 1;
1900 /* Handle flagged options */
1902 switchchar = arg[1];
1905 /* Make all -ex options synonymous with -oex arguments, since that
1906 is assumed by various callers. Also make -qR options synonymous with -R
1907 options, as that seems to be required as well. Allow for -qqR too, and
1908 the same for -S options. */
1910 if (Ustrncmp(arg+1, "oe", 2) == 0 ||
1911 Ustrncmp(arg+1, "qR", 2) == 0 ||
1912 Ustrncmp(arg+1, "qS", 2) == 0)
1914 switchchar = arg[2];
1917 else if (Ustrncmp(arg+1, "qqR", 3) == 0 || Ustrncmp(arg+1, "qqS", 3) == 0)
1919 switchchar = arg[3];
1921 queue_2stage = TRUE;
1924 /* Make -r synonymous with -f, since it is a documented alias */
1926 else if (arg[1] == 'r') switchchar = 'f';
1928 /* Make -ov synonymous with -v */
1930 else if (Ustrcmp(arg, "-ov") == 0)
1936 /* deal with --option_aliases */
1937 else if (switchchar == '-')
1939 if (Ustrcmp(argrest, "help") == 0)
1941 usage_wanted = TRUE;
1944 else if (Ustrcmp(argrest, "version") == 0)
1951 /* High-level switch on active initial letter */
1956 /* sendmail uses -Ac and -Am to control which .cf file is used;
1959 if (*argrest == '\0') { badarg = TRUE; break; }
1962 BOOL ignore = FALSE;
1967 if (*(argrest + 1) == '\0')
1971 if (!ignore) { badarg = TRUE; break; }
1975 /* -Btype is a sendmail option for 7bit/8bit setting. Exim is 8-bit clean
1976 so has no need of it. */
1979 if (*argrest == 0) i++; /* Skip over the type */
1984 receiving_message = FALSE; /* Reset TRUE for -bm, -bS, -bs below */
1986 /* -bd: Run in daemon mode, awaiting SMTP connections.
1987 -bdf: Ditto, but in the foreground.
1990 if (*argrest == 'd')
1992 daemon_listen = TRUE;
1993 if (*(++argrest) == 'f') background_daemon = FALSE;
1994 else if (*argrest != 0) { badarg = TRUE; break; }
1997 /* -be: Run in expansion test mode
1998 -bem: Ditto, but read a message from a file first
2001 else if (*argrest == 'e')
2003 expansion_test = checking = TRUE;
2004 if (argrest[1] == 'm')
2006 if (++i >= argc) { badarg = TRUE; break; }
2007 expansion_test_message = argv[i];
2010 if (argrest[1] != 0) { badarg = TRUE; break; }
2013 /* -bF: Run system filter test */
2015 else if (*argrest == 'F')
2017 filter_test |= checking = FTEST_SYSTEM;
2018 if (*(++argrest) != 0) { badarg = TRUE; break; }
2019 if (++i < argc) filter_test_sfile = argv[i]; else
2021 fprintf(stderr, "exim: file name expected after %s\n", argv[i-1]);
2026 /* -bf: Run user filter test
2027 -bfd: Set domain for filter testing
2028 -bfl: Set local part for filter testing
2029 -bfp: Set prefix for filter testing
2030 -bfs: Set suffix for filter testing
2033 else if (*argrest == 'f')
2035 if (*(++argrest) == 0)
2037 filter_test |= checking = FTEST_USER;
2038 if (++i < argc) filter_test_ufile = argv[i]; else
2040 fprintf(stderr, "exim: file name expected after %s\n", argv[i-1]);
2048 fprintf(stderr, "exim: string expected after %s\n", arg);
2051 if (Ustrcmp(argrest, "d") == 0) ftest_domain = argv[i];
2052 else if (Ustrcmp(argrest, "l") == 0) ftest_localpart = argv[i];
2053 else if (Ustrcmp(argrest, "p") == 0) ftest_prefix = argv[i];
2054 else if (Ustrcmp(argrest, "s") == 0) ftest_suffix = argv[i];
2055 else { badarg = TRUE; break; }
2059 /* -bh: Host checking - an IP address must follow. */
2061 else if (Ustrcmp(argrest, "h") == 0 || Ustrcmp(argrest, "hc") == 0)
2063 if (++i >= argc) { badarg = TRUE; break; }
2064 sender_host_address = argv[i];
2065 host_checking = checking = log_testing_mode = TRUE;
2066 host_checking_callout = argrest[1] == 'c';
2067 message_logs = FALSE;
2070 /* -bi: This option is used by sendmail to initialize *the* alias file,
2071 though it has the -oA option to specify a different file. Exim has no
2072 concept of *the* alias file, but since Sun's YP make script calls
2073 sendmail this way, some support must be provided. */
2075 else if (Ustrcmp(argrest, "i") == 0) bi_option = TRUE;
2077 /* -bI: provide information, of the type to follow after a colon.
2078 This is an Exim flag. */
2080 else if (argrest[0] == 'I' && Ustrlen(argrest) >= 2 && argrest[1] == ':')
2082 uschar *p = &argrest[2];
2083 info_flag = CMDINFO_HELP;
2086 if (strcmpic(p, CUS"sieve") == 0)
2088 info_flag = CMDINFO_SIEVE;
2091 else if (strcmpic(p, CUS"dscp") == 0)
2093 info_flag = CMDINFO_DSCP;
2096 else if (strcmpic(p, CUS"help") == 0)
2103 /* -bm: Accept and deliver message - the default option. Reinstate
2104 receiving_message, which got turned off for all -b options. */
2106 else if (Ustrcmp(argrest, "m") == 0) receiving_message = TRUE;
2108 /* -bmalware: test the filename given for malware */
2110 else if (Ustrcmp(argrest, "malware") == 0)
2112 if (++i >= argc) { badarg = TRUE; break; }
2114 malware_test_file = argv[i];
2117 /* -bnq: For locally originating messages, do not qualify unqualified
2118 addresses. In the envelope, this causes errors; in header lines they
2121 else if (Ustrcmp(argrest, "nq") == 0)
2123 allow_unqualified_sender = FALSE;
2124 allow_unqualified_recipient = FALSE;
2127 /* -bpxx: List the contents of the mail queue, in various forms. If
2128 the option is -bpc, just a queue count is needed. Otherwise, if the
2129 first letter after p is r, then order is random. */
2131 else if (*argrest == 'p')
2133 if (*(++argrest) == 'c')
2136 if (*(++argrest) != 0) badarg = TRUE;
2140 if (*argrest == 'r')
2142 list_queue_option = 8;
2145 else list_queue_option = 0;
2149 /* -bp: List the contents of the mail queue, top-level only */
2151 if (*argrest == 0) {}
2153 /* -bpu: List the contents of the mail queue, top-level undelivered */
2155 else if (Ustrcmp(argrest, "u") == 0) list_queue_option += 1;
2157 /* -bpa: List the contents of the mail queue, including all delivered */
2159 else if (Ustrcmp(argrest, "a") == 0) list_queue_option += 2;
2161 /* Unknown after -bp[r] */
2171 /* -bP: List the configuration variables given as the address list.
2172 Force -v, so configuration errors get displayed. */
2174 else if (Ustrcmp(argrest, "P") == 0)
2176 /* -bP config: we need to setup here, because later,
2177 * when list_options is checked, the config is read already */
2178 if (argv[i+1] && Ustrcmp(argv[i+1], "config") == 0)
2181 readconf_save_config(version_string);
2185 list_options = TRUE;
2186 debug_selector |= D_v;
2187 debug_file = stderr;
2191 /* -brt: Test retry configuration lookup */
2193 else if (Ustrcmp(argrest, "rt") == 0)
2196 test_retry_arg = i + 1;
2200 /* -brw: Test rewrite configuration */
2202 else if (Ustrcmp(argrest, "rw") == 0)
2205 test_rewrite_arg = i + 1;
2209 /* -bS: Read SMTP commands on standard input, but produce no replies -
2210 all errors are reported by sending messages. */
2212 else if (Ustrcmp(argrest, "S") == 0)
2213 smtp_input = smtp_batched_input = receiving_message = TRUE;
2215 /* -bs: Read SMTP commands on standard input and produce SMTP replies
2216 on standard output. */
2218 else if (Ustrcmp(argrest, "s") == 0) smtp_input = receiving_message = TRUE;
2220 /* -bt: address testing mode */
2222 else if (Ustrcmp(argrest, "t") == 0)
2223 address_test_mode = checking = log_testing_mode = TRUE;
2225 /* -bv: verify addresses */
2227 else if (Ustrcmp(argrest, "v") == 0)
2228 verify_address_mode = checking = log_testing_mode = TRUE;
2230 /* -bvs: verify sender addresses */
2232 else if (Ustrcmp(argrest, "vs") == 0)
2234 verify_address_mode = checking = log_testing_mode = TRUE;
2235 verify_as_sender = TRUE;
2238 /* -bV: Print version string and support details */
2240 else if (Ustrcmp(argrest, "V") == 0)
2242 printf("Exim version %s #%s built %s\n", version_string,
2243 version_cnumber, version_date);
2244 printf("%s\n", CS version_copyright);
2245 version_printed = TRUE;
2246 show_whats_supported(stdout);
2247 log_testing_mode = TRUE;
2250 /* -bw: inetd wait mode, accept a listening socket as stdin */
2252 else if (*argrest == 'w')
2254 inetd_wait_mode = TRUE;
2255 background_daemon = FALSE;
2256 daemon_listen = TRUE;
2257 if (*(++argrest) != '\0')
2259 inetd_wait_timeout = readconf_readtime(argrest, 0, FALSE);
2260 if (inetd_wait_timeout <= 0)
2262 fprintf(stderr, "exim: bad time value %s: abandoned\n", argv[i]);
2272 /* -C: change configuration file list; ignore if it isn't really
2273 a change! Enforce a prefix check if required. */
2278 if(++i < argc) argrest = argv[i]; else
2279 { badarg = TRUE; break; }
2281 if (Ustrcmp(config_main_filelist, argrest) != 0)
2283 #ifdef ALT_CONFIG_PREFIX
2285 int len = Ustrlen(ALT_CONFIG_PREFIX);
2286 const uschar *list = argrest;
2288 while((filename = string_nextinlist(&list, &sep, big_buffer,
2289 big_buffer_size)) != NULL)
2291 if ((Ustrlen(filename) < len ||
2292 Ustrncmp(filename, ALT_CONFIG_PREFIX, len) != 0 ||
2293 Ustrstr(filename, "/../") != NULL) &&
2294 (Ustrcmp(filename, "/dev/null") != 0 || real_uid != root_uid))
2296 fprintf(stderr, "-C Permission denied\n");
2301 if (real_uid != root_uid)
2303 #ifdef TRUSTED_CONFIG_LIST
2305 if (real_uid != exim_uid
2306 #ifdef CONFIGURE_OWNER
2307 && real_uid != config_uid
2310 trusted_config = FALSE;
2313 FILE *trust_list = Ufopen(TRUSTED_CONFIG_LIST, "rb");
2316 struct stat statbuf;
2318 if (fstat(fileno(trust_list), &statbuf) != 0 ||
2319 (statbuf.st_uid != root_uid /* owner not root */
2320 #ifdef CONFIGURE_OWNER
2321 && statbuf.st_uid != config_uid /* owner not the special one */
2324 (statbuf.st_gid != root_gid /* group not root */
2325 #ifdef CONFIGURE_GROUP
2326 && statbuf.st_gid != config_gid /* group not the special one */
2328 && (statbuf.st_mode & 020) != 0 /* group writeable */
2330 (statbuf.st_mode & 2) != 0) /* world writeable */
2332 trusted_config = FALSE;
2337 /* Well, the trust list at least is up to scratch... */
2338 void *reset_point = store_get(0);
2339 uschar *trusted_configs[32];
2343 while (Ufgets(big_buffer, big_buffer_size, trust_list))
2345 uschar *start = big_buffer, *nl;
2346 while (*start && isspace(*start))
2350 nl = Ustrchr(start, '\n');
2353 trusted_configs[nr_configs++] = string_copy(start);
2354 if (nr_configs == 32)
2362 const uschar *list = argrest;
2364 while (trusted_config && (filename = string_nextinlist(&list,
2365 &sep, big_buffer, big_buffer_size)) != NULL)
2367 for (i=0; i < nr_configs; i++)
2369 if (Ustrcmp(filename, trusted_configs[i]) == 0)
2372 if (i == nr_configs)
2374 trusted_config = FALSE;
2378 store_reset(reset_point);
2382 /* No valid prefixes found in trust_list file. */
2383 trusted_config = FALSE;
2389 /* Could not open trust_list file. */
2390 trusted_config = FALSE;
2394 /* Not root; don't trust config */
2395 trusted_config = FALSE;
2399 config_main_filelist = argrest;
2400 config_changed = TRUE;
2405 /* -D: set up a macro definition */
2408 #ifdef DISABLE_D_OPTION
2409 fprintf(stderr, "exim: -D is not available in this Exim binary\n");
2416 uschar *s = argrest;
2419 while (isspace(*s)) s++;
2421 if (*s < 'A' || *s > 'Z')
2423 fprintf(stderr, "exim: macro name set by -D must start with "
2424 "an upper case letter\n");
2428 while (isalnum(*s) || *s == '_')
2430 if (ptr < sizeof(name)-1) name[ptr++] = *s;
2434 if (ptr == 0) { badarg = TRUE; break; }
2435 while (isspace(*s)) s++;
2438 if (*s++ != '=') { badarg = TRUE; break; }
2439 while (isspace(*s)) s++;
2442 for (m = macros_user; m; m = m->next)
2443 if (Ustrcmp(m->name, name) == 0)
2445 fprintf(stderr, "exim: duplicated -D in command line\n");
2449 m = macro_create(name, s, TRUE);
2451 if (clmacro_count >= MAX_CLMACROS)
2453 fprintf(stderr, "exim: too many -D options on command line\n");
2456 clmacros[clmacro_count++] = string_sprintf("-D%s=%s", m->name,
2462 /* -d: Set debug level (see also -v below) or set the drop_cr option.
2463 The latter is now a no-op, retained for compatibility only. If -dd is used,
2464 debugging subprocesses of the daemon is disabled. */
2467 if (Ustrcmp(argrest, "ropcr") == 0)
2469 /* drop_cr = TRUE; */
2472 /* Use an intermediate variable so that we don't set debugging while
2473 decoding the debugging bits. */
2477 unsigned int selector = D_default;
2480 if (*argrest == 'd')
2482 debug_daemon = TRUE;
2486 decode_bits(&selector, 1, debug_notall, argrest,
2487 debug_options, debug_options_count, US"debug", 0);
2488 debug_selector = selector;
2493 /* -E: This is a local error message. This option is not intended for
2494 external use at all, but is not restricted to trusted callers because it
2495 does no harm (just suppresses certain error messages) and if Exim is run
2496 not setuid root it won't always be trusted when it generates error
2497 messages using this option. If there is a message id following -E, point
2498 message_reference at it, for logging. */
2501 local_error_message = TRUE;
2502 if (mac_ismsgid(argrest)) message_reference = argrest;
2506 /* -ex: The vacation program calls sendmail with the undocumented "-eq"
2507 option, so it looks as if historically the -oex options are also callable
2508 without the leading -o. So we have to accept them. Before the switch,
2509 anything starting -oe has been converted to -e. Exim does not support all
2510 of the sendmail error options. */
2513 if (Ustrcmp(argrest, "e") == 0)
2515 arg_error_handling = ERRORS_SENDER;
2516 errors_sender_rc = EXIT_SUCCESS;
2518 else if (Ustrcmp(argrest, "m") == 0) arg_error_handling = ERRORS_SENDER;
2519 else if (Ustrcmp(argrest, "p") == 0) arg_error_handling = ERRORS_STDERR;
2520 else if (Ustrcmp(argrest, "q") == 0) arg_error_handling = ERRORS_STDERR;
2521 else if (Ustrcmp(argrest, "w") == 0) arg_error_handling = ERRORS_SENDER;
2526 /* -F: Set sender's full name, used instead of the gecos entry from
2527 the password file. Since users can usually alter their gecos entries,
2528 there's no security involved in using this instead. The data can follow
2529 the -F or be in the next argument. */
2534 if(++i < argc) argrest = argv[i]; else
2535 { badarg = TRUE; break; }
2537 originator_name = argrest;
2538 sender_name_forced = TRUE;
2542 /* -f: Set sender's address - this value is only actually used if Exim is
2543 run by a trusted user, or if untrusted_set_sender is set and matches the
2544 address, except that the null address can always be set by any user. The
2545 test for this happens later, when the value given here is ignored when not
2546 permitted. For an untrusted user, the actual sender is still put in Sender:
2547 if it doesn't match the From: header (unless no_local_from_check is set).
2548 The data can follow the -f or be in the next argument. The -r switch is an
2549 obsolete form of -f but since there appear to be programs out there that
2550 use anything that sendmail has ever supported, better accept it - the
2551 synonymizing is done before the switch above.
2553 At this stage, we must allow domain literal addresses, because we don't
2554 know what the setting of allow_domain_literals is yet. Ditto for trailing
2555 dots and strip_trailing_dot. */
2559 int dummy_start, dummy_end;
2563 if (i+1 < argc) argrest = argv[++i]; else
2564 { badarg = TRUE; break; }
2567 sender_address = string_sprintf(""); /* Ensure writeable memory */
2570 uschar *temp = argrest + Ustrlen(argrest) - 1;
2571 while (temp >= argrest && isspace(*temp)) temp--;
2572 if (temp >= argrest && *temp == '.') f_end_dot = TRUE;
2573 allow_domain_literals = TRUE;
2574 strip_trailing_dot = TRUE;
2576 allow_utf8_domains = TRUE;
2578 sender_address = parse_extract_address(argrest, &errmess,
2579 &dummy_start, &dummy_end, &sender_address_domain, TRUE);
2581 message_smtputf8 = string_is_utf8(sender_address);
2582 allow_utf8_domains = FALSE;
2584 allow_domain_literals = FALSE;
2585 strip_trailing_dot = FALSE;
2586 if (sender_address == NULL)
2588 fprintf(stderr, "exim: bad -f address \"%s\": %s\n", argrest, errmess);
2589 return EXIT_FAILURE;
2592 sender_address_forced = TRUE;
2596 /* -G: sendmail invocation to specify that it's a gateway submission and
2597 sendmail may complain about problems instead of fixing them.
2598 We make it equivalent to an ACL "control = suppress_local_fixups" and do
2599 not at this time complain about problems. */
2605 /* -h: Set the hop count for an incoming message. Exim does not currently
2606 support this; it always computes it by counting the Received: headers.
2607 To put it in will require a change to the spool header file format. */
2612 if(++i < argc) argrest = argv[i]; else
2613 { badarg = TRUE; break; }
2615 if (!isdigit(*argrest)) badarg = TRUE;
2619 /* -i: Set flag so dot doesn't end non-SMTP input (same as -oi, seems
2620 not to be documented for sendmail but mailx (at least) uses it) */
2623 if (*argrest == 0) dot_ends = FALSE; else badarg = TRUE;
2627 /* -L: set the identifier used for syslog; equivalent to setting
2628 syslog_processname in the config file, but needs to be an admin option. */
2631 if (*argrest == '\0')
2633 if(++i < argc) argrest = argv[i]; else
2634 { badarg = TRUE; break; }
2636 sz = Ustrlen(argrest);
2639 fprintf(stderr, "exim: the -L syslog name is too long: \"%s\"\n", argrest);
2640 return EXIT_FAILURE;
2644 fprintf(stderr, "exim: the -L syslog name is too short\n");
2645 return EXIT_FAILURE;
2647 cmdline_syslog_name = argrest;
2651 receiving_message = FALSE;
2653 /* -MC: continue delivery of another message via an existing open
2654 file descriptor. This option is used for an internal call by the
2655 smtp transport when there is a pending message waiting to go to an
2656 address to which it has got a connection. Five subsequent arguments are
2657 required: transport name, host name, IP address, sequence number, and
2658 message_id. Transports may decline to create new processes if the sequence
2659 number gets too big. The channel is stdin. This (-MC) must be the last
2660 argument. There's a subsequent check that the real-uid is privileged.
2662 If we are running in the test harness. delay for a bit, to let the process
2663 that set this one up complete. This makes for repeatability of the logging,
2666 if (Ustrcmp(argrest, "C") == 0)
2668 union sockaddr_46 interface_sock;
2669 EXIM_SOCKLEN_T size = sizeof(interface_sock);
2673 fprintf(stderr, "exim: too many or too few arguments after -MC\n");
2674 return EXIT_FAILURE;
2677 if (msg_action_arg >= 0)
2679 fprintf(stderr, "exim: incompatible arguments\n");
2680 return EXIT_FAILURE;
2683 continue_transport = argv[++i];
2684 continue_hostname = argv[++i];
2685 continue_host_address = argv[++i];
2686 continue_sequence = Uatoi(argv[++i]);
2687 msg_action = MSG_DELIVER;
2688 msg_action_arg = ++i;
2689 forced_delivery = TRUE;
2690 queue_run_pid = passed_qr_pid;
2691 queue_run_pipe = passed_qr_pipe;
2693 if (!mac_ismsgid(argv[i]))
2695 fprintf(stderr, "exim: malformed message id %s after -MC option\n",
2697 return EXIT_FAILURE;
2700 /* Set up $sending_ip_address and $sending_port, unless proxied */
2702 if (!continue_proxy_cipher)
2703 if (getsockname(fileno(stdin), (struct sockaddr *)(&interface_sock),
2705 sending_ip_address = host_ntoa(-1, &interface_sock, NULL,
2709 fprintf(stderr, "exim: getsockname() failed after -MC option: %s\n",
2711 return EXIT_FAILURE;
2714 if (running_in_test_harness) millisleep(500);
2718 else if (*argrest == 'C' && argrest[1] && !argrest[2])
2722 /* -MCA: set the smtp_authenticated flag; this is useful only when it
2723 precedes -MC (see above). The flag indicates that the host to which
2724 Exim is connected has accepted an AUTH sequence. */
2726 case 'A': smtp_authenticated = TRUE; break;
2728 /* -MCD: set the smtp_use_dsn flag; this indicates that the host
2729 that exim is connected to supports the esmtp extension DSN */
2731 case 'D': smtp_peer_options |= OPTION_DSN; break;
2733 /* -MCG: set the queue name, to a non-default value */
2735 case 'G': if (++i < argc) queue_name = string_copy(argv[i]);
2739 /* -MCK: the peer offered CHUNKING. Must precede -MC */
2741 case 'K': smtp_peer_options |= OPTION_CHUNKING; break;
2743 /* -MCP: set the smtp_use_pipelining flag; this is useful only when
2744 it preceded -MC (see above) */
2746 case 'P': smtp_peer_options |= OPTION_PIPE; break;
2748 /* -MCQ: pass on the pid of the queue-running process that started
2749 this chain of deliveries and the fd of its synchronizing pipe; this
2750 is useful only when it precedes -MC (see above) */
2752 case 'Q': if (++i < argc) passed_qr_pid = (pid_t)(Uatol(argv[i]));
2754 if (++i < argc) passed_qr_pipe = (int)(Uatol(argv[i]));
2758 /* -MCS: set the smtp_use_size flag; this is useful only when it
2759 precedes -MC (see above) */
2761 case 'S': smtp_peer_options |= OPTION_SIZE; break;
2764 /* -MCt: similar to -MCT below but the connection is still open
2765 via a proxy proces which handles the TLS context and coding.
2766 Require three arguments for the proxied local address and port,
2767 and the TLS cipher. */
2769 case 't': if (++i < argc) sending_ip_address = argv[i];
2771 if (++i < argc) sending_port = (int)(Uatol(argv[i]));
2773 if (++i < argc) continue_proxy_cipher = argv[i];
2777 /* -MCT: set the tls_offered flag; this is useful only when it
2778 precedes -MC (see above). The flag indicates that the host to which
2779 Exim is connected has offered TLS support. */
2781 case 'T': smtp_peer_options |= OPTION_TLS; break;
2784 default: badarg = TRUE; break;
2789 /* -M[x]: various operations on the following list of message ids:
2790 -M deliver the messages, ignoring next retry times and thawing
2791 -Mc deliver the messages, checking next retry times, no thawing
2792 -Mf freeze the messages
2793 -Mg give up on the messages
2794 -Mt thaw the messages
2795 -Mrm remove the messages
2796 In the above cases, this must be the last option. There are also the
2797 following options which are followed by a single message id, and which
2798 act on that message. Some of them use the "recipient" addresses as well.
2799 -Mar add recipient(s)
2800 -Mmad mark all recipients delivered
2801 -Mmd mark recipients(s) delivered
2803 -Mset load a message for use with -be
2805 -Mvc show copy (of whole message, in RFC 2822 format)
2810 else if (*argrest == 0)
2812 msg_action = MSG_DELIVER;
2813 forced_delivery = deliver_force_thaw = TRUE;
2815 else if (Ustrcmp(argrest, "ar") == 0)
2817 msg_action = MSG_ADD_RECIPIENT;
2818 one_msg_action = TRUE;
2820 else if (Ustrcmp(argrest, "c") == 0) msg_action = MSG_DELIVER;
2821 else if (Ustrcmp(argrest, "es") == 0)
2823 msg_action = MSG_EDIT_SENDER;
2824 one_msg_action = TRUE;
2826 else if (Ustrcmp(argrest, "f") == 0) msg_action = MSG_FREEZE;
2827 else if (Ustrcmp(argrest, "g") == 0)
2829 msg_action = MSG_DELIVER;
2830 deliver_give_up = TRUE;
2832 else if (Ustrcmp(argrest, "mad") == 0)
2834 msg_action = MSG_MARK_ALL_DELIVERED;
2836 else if (Ustrcmp(argrest, "md") == 0)
2838 msg_action = MSG_MARK_DELIVERED;
2839 one_msg_action = TRUE;
2841 else if (Ustrcmp(argrest, "rm") == 0) msg_action = MSG_REMOVE;
2842 else if (Ustrcmp(argrest, "set") == 0)
2844 msg_action = MSG_LOAD;
2845 one_msg_action = TRUE;
2847 else if (Ustrcmp(argrest, "t") == 0) msg_action = MSG_THAW;
2848 else if (Ustrcmp(argrest, "vb") == 0)
2850 msg_action = MSG_SHOW_BODY;
2851 one_msg_action = TRUE;
2853 else if (Ustrcmp(argrest, "vc") == 0)
2855 msg_action = MSG_SHOW_COPY;
2856 one_msg_action = TRUE;
2858 else if (Ustrcmp(argrest, "vh") == 0)
2860 msg_action = MSG_SHOW_HEADER;
2861 one_msg_action = TRUE;
2863 else if (Ustrcmp(argrest, "vl") == 0)
2865 msg_action = MSG_SHOW_LOG;
2866 one_msg_action = TRUE;
2868 else { badarg = TRUE; break; }
2870 /* All the -Mxx options require at least one message id. */
2872 msg_action_arg = i + 1;
2873 if (msg_action_arg >= argc)
2875 fprintf(stderr, "exim: no message ids given after %s option\n", arg);
2876 return EXIT_FAILURE;
2879 /* Some require only message ids to follow */
2881 if (!one_msg_action)
2884 for (j = msg_action_arg; j < argc; j++) if (!mac_ismsgid(argv[j]))
2886 fprintf(stderr, "exim: malformed message id %s after %s option\n",
2888 return EXIT_FAILURE;
2890 goto END_ARG; /* Remaining args are ids */
2893 /* Others require only one message id, possibly followed by addresses,
2894 which will be handled as normal arguments. */
2898 if (!mac_ismsgid(argv[msg_action_arg]))
2900 fprintf(stderr, "exim: malformed message id %s after %s option\n",
2901 argv[msg_action_arg], arg);
2902 return EXIT_FAILURE;
2909 /* Some programs seem to call the -om option without the leading o;
2910 for sendmail it askes for "me too". Exim always does this. */
2913 if (*argrest != 0) badarg = TRUE;
2917 /* -N: don't do delivery - a debugging option that stops transports doing
2918 their thing. It implies debugging at the D_v level. */
2923 dont_deliver = TRUE;
2924 debug_selector |= D_v;
2925 debug_file = stderr;
2931 /* -n: This means "don't alias" in sendmail, apparently.
2932 For normal invocations, it has no effect.
2933 It may affect some other options. */
2939 /* -O: Just ignore it. In sendmail, apparently -O option=value means set
2940 option to the specified value. This form uses long names. We need to handle
2941 -O option=value and -Ooption=value. */
2948 fprintf(stderr, "exim: string expected after -O\n");
2956 /* -oA: Set an argument for the bi command (sendmail's "alternate alias
2959 if (*argrest == 'A')
2961 alias_arg = argrest + 1;
2962 if (alias_arg[0] == 0)
2964 if (i+1 < argc) alias_arg = argv[++i]; else
2966 fprintf(stderr, "exim: string expected after -oA\n");
2972 /* -oB: Set a connection message max value for remote deliveries */
2974 else if (*argrest == 'B')
2976 uschar *p = argrest + 1;
2979 if (i+1 < argc && isdigit((argv[i+1][0]))) p = argv[++i]; else
2981 connection_max_messages = 1;
2990 fprintf(stderr, "exim: number expected after -oB\n");
2993 connection_max_messages = Uatoi(p);
2997 /* -odb: background delivery */
2999 else if (Ustrcmp(argrest, "db") == 0)
3001 synchronous_delivery = FALSE;
3002 arg_queue_only = FALSE;
3003 queue_only_set = TRUE;
3006 /* -odf: foreground delivery (smail-compatible option); same effect as
3007 -odi: interactive (synchronous) delivery (sendmail-compatible option)
3010 else if (Ustrcmp(argrest, "df") == 0 || Ustrcmp(argrest, "di") == 0)
3012 synchronous_delivery = TRUE;
3013 arg_queue_only = FALSE;
3014 queue_only_set = TRUE;
3017 /* -odq: queue only */
3019 else if (Ustrcmp(argrest, "dq") == 0)
3021 synchronous_delivery = FALSE;
3022 arg_queue_only = TRUE;
3023 queue_only_set = TRUE;
3026 /* -odqs: queue SMTP only - do local deliveries and remote routing,
3027 but no remote delivery */
3029 else if (Ustrcmp(argrest, "dqs") == 0)
3032 arg_queue_only = FALSE;
3033 queue_only_set = TRUE;
3036 /* -oex: Sendmail error flags. As these are also accepted without the
3037 leading -o prefix, for compatibility with vacation and other callers,
3038 they are handled with -e above. */
3040 /* -oi: Set flag so dot doesn't end non-SMTP input (same as -i)
3041 -oitrue: Another sendmail syntax for the same */
3043 else if (Ustrcmp(argrest, "i") == 0 ||
3044 Ustrcmp(argrest, "itrue") == 0)
3047 /* -oM*: Set various characteristics for an incoming message; actually
3048 acted on for trusted callers only. */
3050 else if (*argrest == 'M')
3054 fprintf(stderr, "exim: data expected after -o%s\n", argrest);
3058 /* -oMa: Set sender host address */
3060 if (Ustrcmp(argrest, "Ma") == 0) sender_host_address = argv[++i];
3062 /* -oMaa: Set authenticator name */
3064 else if (Ustrcmp(argrest, "Maa") == 0)
3065 sender_host_authenticated = argv[++i];
3067 /* -oMas: setting authenticated sender */
3069 else if (Ustrcmp(argrest, "Mas") == 0) authenticated_sender = argv[++i];
3071 /* -oMai: setting authenticated id */
3073 else if (Ustrcmp(argrest, "Mai") == 0) authenticated_id = argv[++i];
3075 /* -oMi: Set incoming interface address */
3077 else if (Ustrcmp(argrest, "Mi") == 0) interface_address = argv[++i];
3079 /* -oMm: Message reference */
3081 else if (Ustrcmp(argrest, "Mm") == 0)
3083 if (!mac_ismsgid(argv[i+1]))
3085 fprintf(stderr,"-oMm must be a valid message ID\n");
3088 if (!trusted_config)
3090 fprintf(stderr,"-oMm must be called by a trusted user/config\n");
3093 message_reference = argv[++i];
3096 /* -oMr: Received protocol */
3098 else if (Ustrcmp(argrest, "Mr") == 0)
3100 if (received_protocol)
3102 fprintf(stderr, "received_protocol is set already\n");
3105 else received_protocol = argv[++i];
3107 /* -oMs: Set sender host name */
3109 else if (Ustrcmp(argrest, "Ms") == 0) sender_host_name = argv[++i];
3111 /* -oMt: Set sender ident */
3113 else if (Ustrcmp(argrest, "Mt") == 0)
3115 sender_ident_set = TRUE;
3116 sender_ident = argv[++i];
3119 /* Else a bad argument */
3128 /* -om: Me-too flag for aliases. Exim always does this. Some programs
3129 seem to call this as -m (undocumented), so that is also accepted (see
3132 else if (Ustrcmp(argrest, "m") == 0) {}
3134 /* -oo: An ancient flag for old-style addresses which still seems to
3135 crop up in some calls (see in SCO). */
3137 else if (Ustrcmp(argrest, "o") == 0) {}
3139 /* -oP <name>: set pid file path for daemon */
3141 else if (Ustrcmp(argrest, "P") == 0)
3142 override_pid_file_path = argv[++i];
3144 /* -or <n>: set timeout for non-SMTP acceptance
3145 -os <n>: set timeout for SMTP acceptance */
3147 else if (*argrest == 'r' || *argrest == 's')
3149 int *tp = (*argrest == 'r')?
3150 &arg_receive_timeout : &arg_smtp_receive_timeout;
3151 if (argrest[1] == 0)
3153 if (i+1 < argc) *tp= readconf_readtime(argv[++i], 0, FALSE);
3155 else *tp = readconf_readtime(argrest + 1, 0, FALSE);
3158 fprintf(stderr, "exim: bad time value %s: abandoned\n", argv[i]);
3163 /* -oX <list>: Override local_interfaces and/or default daemon ports */
3165 else if (Ustrcmp(argrest, "X") == 0)
3166 override_local_interfaces = argv[++i];
3168 /* Unknown -o argument */
3174 /* -ps: force Perl startup; -pd force delayed Perl startup */
3178 if (*argrest == 's' && argrest[1] == 0)
3180 perl_start_option = 1;
3183 if (*argrest == 'd' && argrest[1] == 0)
3185 perl_start_option = -1;
3190 /* -panythingelse is taken as the Sendmail-compatible argument -prval:sval,
3191 which sets the host protocol and host name */
3195 argrest = argv[++i];
3197 { badarg = TRUE; break; }
3203 if (received_protocol)
3205 fprintf(stderr, "received_protocol is set already\n");
3209 hn = Ustrchr(argrest, ':');
3211 received_protocol = argrest;
3214 int old_pool = store_pool;
3215 store_pool = POOL_PERM;
3216 received_protocol = string_copyn(argrest, hn - argrest);
3217 store_pool = old_pool;
3218 sender_host_name = hn + 1;
3225 receiving_message = FALSE;
3226 if (queue_interval >= 0)
3228 fprintf(stderr, "exim: -q specified more than once\n");
3232 /* -qq...: Do queue runs in a 2-stage manner */
3234 if (*argrest == 'q')
3236 queue_2stage = TRUE;
3240 /* -qi...: Do only first (initial) deliveries */
3242 if (*argrest == 'i')
3244 queue_run_first_delivery = TRUE;
3248 /* -qf...: Run the queue, forcing deliveries
3249 -qff..: Ditto, forcing thawing as well */
3251 if (*argrest == 'f')
3253 queue_run_force = TRUE;
3254 if (*++argrest == 'f')
3256 deliver_force_thaw = TRUE;
3261 /* -q[f][f]l...: Run the queue only on local deliveries */
3263 if (*argrest == 'l')
3265 queue_run_local = TRUE;
3269 /* -q[f][f][l][G<name>]... Work on the named queue */
3271 if (*argrest == 'G')
3274 for (argrest++, i = 0; argrest[i] && argrest[i] != '/'; ) i++;
3275 queue_name = string_copyn(argrest, i);
3277 if (*argrest == '/') argrest++;
3280 /* -q[f][f][l][G<name>]: Run the queue, optionally forced, optionally local
3281 only, optionally named, optionally starting from a given message id. */
3283 if (*argrest == 0 &&
3284 (i + 1 >= argc || argv[i+1][0] == '-' || mac_ismsgid(argv[i+1])))
3287 if (i+1 < argc && mac_ismsgid(argv[i+1]))
3288 start_queue_run_id = argv[++i];
3289 if (i+1 < argc && mac_ismsgid(argv[i+1]))
3290 stop_queue_run_id = argv[++i];
3293 /* -q[f][f][l][G<name>/]<n>: Run the queue at regular intervals, optionally
3294 forced, optionally local only, optionally named. */
3296 else if ((queue_interval = readconf_readtime(*argrest ? argrest : argv[++i],
3299 fprintf(stderr, "exim: bad time value %s: abandoned\n", argv[i]);
3305 case 'R': /* Synonymous with -qR... */
3306 receiving_message = FALSE;
3308 /* -Rf: As -R (below) but force all deliveries,
3309 -Rff: Ditto, but also thaw all frozen messages,
3310 -Rr: String is regex
3311 -Rrf: Regex and force
3312 -Rrff: Regex and force and thaw
3314 in all cases provided there are no further characters in this
3320 for (i = 0; i < nelem(rsopts); i++)
3321 if (Ustrcmp(argrest, rsopts[i]) == 0)
3323 if (i != 2) queue_run_force = TRUE;
3324 if (i >= 2) deliver_selectstring_regex = TRUE;
3325 if (i == 1 || i == 4) deliver_force_thaw = TRUE;
3326 argrest += Ustrlen(rsopts[i]);
3330 /* -R: Set string to match in addresses for forced queue run to
3331 pick out particular messages. */
3334 deliver_selectstring = argrest;
3335 else if (i+1 < argc)
3336 deliver_selectstring = argv[++i];
3339 fprintf(stderr, "exim: string expected after -R\n");
3345 /* -r: an obsolete synonym for -f (see above) */
3348 /* -S: Like -R but works on sender. */
3350 case 'S': /* Synonymous with -qS... */
3351 receiving_message = FALSE;
3353 /* -Sf: As -S (below) but force all deliveries,
3354 -Sff: Ditto, but also thaw all frozen messages,
3355 -Sr: String is regex
3356 -Srf: Regex and force
3357 -Srff: Regex and force and thaw
3359 in all cases provided there are no further characters in this
3365 for (i = 0; i < nelem(rsopts); i++)
3366 if (Ustrcmp(argrest, rsopts[i]) == 0)
3368 if (i != 2) queue_run_force = TRUE;
3369 if (i >= 2) deliver_selectstring_sender_regex = TRUE;
3370 if (i == 1 || i == 4) deliver_force_thaw = TRUE;
3371 argrest += Ustrlen(rsopts[i]);
3375 /* -S: Set string to match in addresses for forced queue run to
3376 pick out particular messages. */
3379 deliver_selectstring_sender = argrest;
3380 else if (i+1 < argc)
3381 deliver_selectstring_sender = argv[++i];
3384 fprintf(stderr, "exim: string expected after -S\n");
3389 /* -Tqt is an option that is exclusively for use by the testing suite.
3390 It is not recognized in other circumstances. It allows for the setting up
3391 of explicit "queue times" so that various warning/retry things can be
3392 tested. Otherwise variability of clock ticks etc. cause problems. */
3395 if (running_in_test_harness && Ustrcmp(argrest, "qt") == 0)
3396 fudged_queue_times = argv[++i];
3401 /* -t: Set flag to extract recipients from body of message. */
3404 if (*argrest == 0) extract_recipients = TRUE;
3406 /* -ti: Set flag to extract recipients from body of message, and also
3407 specify that dot does not end the message. */
3409 else if (Ustrcmp(argrest, "i") == 0)
3411 extract_recipients = TRUE;
3415 /* -tls-on-connect: don't wait for STARTTLS (for old clients) */
3418 else if (Ustrcmp(argrest, "ls-on-connect") == 0) tls_in.on_connect = TRUE;
3425 /* -U: This means "initial user submission" in sendmail, apparently. The
3426 doc claims that in future sendmail may refuse syntactically invalid
3427 messages instead of fixing them. For the moment, we just ignore it. */
3433 /* -v: verify things - this is a very low-level debugging */
3438 debug_selector |= D_v;
3439 debug_file = stderr;
3445 /* -x: AIX uses this to indicate some fancy 8-bit character stuff:
3447 The -x flag tells the sendmail command that mail from a local
3448 mail program has National Language Support (NLS) extended characters
3449 in the body of the mail item. The sendmail command can send mail with
3450 extended NLS characters across networks that normally corrupts these
3453 As Exim is 8-bit clean, it just ignores this flag. */
3456 if (*argrest != 0) badarg = TRUE;
3459 /* -X: in sendmail: takes one parameter, logfile, and sends debugging
3460 logs to that file. We swallow the parameter and otherwise ignore it. */
3463 if (*argrest == '\0')
3466 fprintf(stderr, "exim: string expected after -X\n");
3472 if (*argrest == '\0')
3473 if (++i < argc) log_oneline = argv[i]; else
3475 fprintf(stderr, "exim: file name expected after %s\n", argv[i-1]);
3480 /* All other initial characters are errors */
3485 } /* End of high-level switch statement */
3487 /* Failed to recognize the option, or syntax error */
3491 fprintf(stderr, "exim abandoned: unknown, malformed, or incomplete "
3492 "option %s\n", arg);
3498 /* If -R or -S have been specified without -q, assume a single queue run. */
3500 if ( (deliver_selectstring || deliver_selectstring_sender)
3501 && queue_interval < 0)
3506 /* If usage_wanted is set we call the usage function - which never returns */
3507 if (usage_wanted) exim_usage(called_as);
3509 /* Arguments have been processed. Check for incompatibilities. */
3511 (smtp_input || extract_recipients || recipients_arg < argc) &&
3512 (daemon_listen || queue_interval >= 0 || bi_option ||
3513 test_retry_arg >= 0 || test_rewrite_arg >= 0 ||
3514 filter_test != FTEST_NONE || (msg_action_arg > 0 && !one_msg_action))
3517 msg_action_arg > 0 &&
3518 (daemon_listen || queue_interval > 0 || list_options ||
3519 (checking && msg_action != MSG_LOAD) ||
3520 bi_option || test_retry_arg >= 0 || test_rewrite_arg >= 0)
3523 (daemon_listen || queue_interval > 0) &&
3524 (sender_address != NULL || list_options || list_queue || checking ||
3528 daemon_listen && queue_interval == 0
3531 inetd_wait_mode && queue_interval >= 0
3535 (checking || smtp_input || extract_recipients ||
3536 filter_test != FTEST_NONE || bi_option)
3539 verify_address_mode &&
3540 (address_test_mode || smtp_input || extract_recipients ||
3541 filter_test != FTEST_NONE || bi_option)
3544 address_test_mode && (smtp_input || extract_recipients ||
3545 filter_test != FTEST_NONE || bi_option)
3548 smtp_input && (sender_address != NULL || filter_test != FTEST_NONE ||
3552 deliver_selectstring != NULL && queue_interval < 0
3555 msg_action == MSG_LOAD &&
3556 (!expansion_test || expansion_test_message != NULL)
3560 fprintf(stderr, "exim: incompatible command-line options or arguments\n");
3564 /* If debugging is set up, set the file and the file descriptor to pass on to
3565 child processes. It should, of course, be 2 for stderr. Also, force the daemon
3566 to run in the foreground. */
3568 if (debug_selector != 0)
3570 debug_file = stderr;
3571 debug_fd = fileno(debug_file);
3572 background_daemon = FALSE;
3573 if (running_in_test_harness) millisleep(100); /* lets caller finish */
3574 if (debug_selector != D_v) /* -v only doesn't show this */
3576 debug_printf("Exim version %s uid=%ld gid=%ld pid=%d D=%x\n",
3577 version_string, (long int)real_uid, (long int)real_gid, (int)getpid(),
3579 if (!version_printed)
3580 show_whats_supported(stderr);
3584 /* When started with root privilege, ensure that the limits on the number of
3585 open files and the number of processes (where that is accessible) are
3586 sufficiently large, or are unset, in case Exim has been called from an
3587 environment where the limits are screwed down. Not all OS have the ability to
3588 change some of these limits. */
3592 DEBUG(D_any) debug_print_ids(US"Exim has no root privilege:");
3598 #ifdef RLIMIT_NOFILE
3599 if (getrlimit(RLIMIT_NOFILE, &rlp) < 0)
3601 log_write(0, LOG_MAIN|LOG_PANIC, "getrlimit(RLIMIT_NOFILE) failed: %s",
3603 rlp.rlim_cur = rlp.rlim_max = 0;
3606 /* I originally chose 1000 as a nice big number that was unlikely to
3607 be exceeded. It turns out that some older OS have a fixed upper limit of
3610 if (rlp.rlim_cur < 1000)
3612 rlp.rlim_cur = rlp.rlim_max = 1000;
3613 if (setrlimit(RLIMIT_NOFILE, &rlp) < 0)
3615 rlp.rlim_cur = rlp.rlim_max = 256;
3616 if (setrlimit(RLIMIT_NOFILE, &rlp) < 0)
3617 log_write(0, LOG_MAIN|LOG_PANIC, "setrlimit(RLIMIT_NOFILE) failed: %s",
3624 if (getrlimit(RLIMIT_NPROC, &rlp) < 0)
3626 log_write(0, LOG_MAIN|LOG_PANIC, "getrlimit(RLIMIT_NPROC) failed: %s",
3628 rlp.rlim_cur = rlp.rlim_max = 0;
3631 #ifdef RLIM_INFINITY
3632 if (rlp.rlim_cur != RLIM_INFINITY && rlp.rlim_cur < 1000)
3634 rlp.rlim_cur = rlp.rlim_max = RLIM_INFINITY;
3636 if (rlp.rlim_cur < 1000)
3638 rlp.rlim_cur = rlp.rlim_max = 1000;
3640 if (setrlimit(RLIMIT_NPROC, &rlp) < 0)
3641 log_write(0, LOG_MAIN|LOG_PANIC, "setrlimit(RLIMIT_NPROC) failed: %s",
3647 /* Exim is normally entered as root (but some special configurations are
3648 possible that don't do this). However, it always spins off sub-processes that
3649 set their uid and gid as required for local delivery. We don't want to pass on
3650 any extra groups that root may belong to, so we want to get rid of them all at
3653 We need to obey setgroups() at this stage, before possibly giving up root
3654 privilege for a changed configuration file, but later on we might need to
3655 check on the additional groups for the admin user privilege - can't do that
3656 till after reading the config, which might specify the exim gid. Therefore,
3657 save the group list here first. */
3659 group_count = getgroups(NGROUPS_MAX, group_list);
3660 if (group_count < 0)
3662 fprintf(stderr, "exim: getgroups() failed: %s\n", strerror(errno));
3666 /* There is a fundamental difference in some BSD systems in the matter of
3667 groups. FreeBSD and BSDI are known to be different; NetBSD and OpenBSD are
3668 known not to be different. On the "different" systems there is a single group
3669 list, and the first entry in it is the current group. On all other versions of
3670 Unix there is a supplementary group list, which is in *addition* to the current
3671 group. Consequently, to get rid of all extraneous groups on a "standard" system
3672 you pass over 0 groups to setgroups(), while on a "different" system you pass
3673 over a single group - the current group, which is always the first group in the
3674 list. Calling setgroups() with zero groups on a "different" system results in
3675 an error return. The following code should cope with both types of system.
3677 However, if this process isn't running as root, setgroups() can't be used
3678 since you have to be root to run it, even if throwing away groups. Not being
3679 root here happens only in some unusual configurations. We just ignore the
3682 if (setgroups(0, NULL) != 0)
3684 if (setgroups(1, group_list) != 0 && !unprivileged)
3686 fprintf(stderr, "exim: setgroups() failed: %s\n", strerror(errno));
3691 /* If the configuration file name has been altered by an argument on the
3692 command line (either a new file name or a macro definition) and the caller is
3693 not root, or if this is a filter testing run, remove any setuid privilege the
3694 program has and run as the underlying user.
3696 The exim user is locked out of this, which severely restricts the use of -C
3699 Otherwise, set the real ids to the effective values (should be root unless run
3700 from inetd, which it can either be root or the exim uid, if one is configured).
3702 There is a private mechanism for bypassing some of this, in order to make it
3703 possible to test lots of configurations automatically, without having either to
3704 recompile each time, or to patch in an actual configuration file name and other
3705 values (such as the path name). If running in the test harness, pretend that
3706 configuration file changes and macro definitions haven't happened. */
3709 (!trusted_config || /* Config changed, or */
3710 !macros_trusted(opt_D_used)) && /* impermissible macros and */
3711 real_uid != root_uid && /* Not root, and */
3712 !running_in_test_harness /* Not fudged */
3714 expansion_test /* expansion testing */
3716 filter_test != FTEST_NONE) /* Filter testing */
3718 setgroups(group_count, group_list);
3719 exim_setugid(real_uid, real_gid, FALSE,
3720 US"-C, -D, -be or -bf forces real uid");
3721 removed_privilege = TRUE;
3723 /* In the normal case when Exim is called like this, stderr is available
3724 and should be used for any logging information because attempts to write
3725 to the log will usually fail. To arrange this, we unset really_exim. However,
3726 if no stderr is available there is no point - we might as well have a go
3727 at the log (if it fails, syslog will be written).
3729 Note that if the invoker is Exim, the logs remain available. Messing with
3730 this causes unlogged successful deliveries. */
3732 if ((log_stderr != NULL) && (real_uid != exim_uid))
3733 really_exim = FALSE;
3736 /* Privilege is to be retained for the moment. It may be dropped later,
3737 depending on the job that this Exim process has been asked to do. For now, set
3738 the real uid to the effective so that subsequent re-execs of Exim are done by a
3741 else exim_setugid(geteuid(), getegid(), FALSE, US"forcing real = effective");
3743 /* If testing a filter, open the file(s) now, before wasting time doing other
3744 setups and reading the message. */
3746 if ((filter_test & FTEST_SYSTEM) != 0)
3748 filter_sfd = Uopen(filter_test_sfile, O_RDONLY, 0);
3751 fprintf(stderr, "exim: failed to open %s: %s\n", filter_test_sfile,
3753 return EXIT_FAILURE;
3757 if ((filter_test & FTEST_USER) != 0)
3759 filter_ufd = Uopen(filter_test_ufile, O_RDONLY, 0);
3762 fprintf(stderr, "exim: failed to open %s: %s\n", filter_test_ufile,
3764 return EXIT_FAILURE;
3768 /* Initialise lookup_list
3769 If debugging, already called above via version reporting.
3770 In either case, we initialise the list of available lookups while running
3771 as root. All dynamically modules are loaded from a directory which is
3772 hard-coded into the binary and is code which, if not a module, would be
3773 part of Exim already. Ability to modify the content of the directory
3774 is equivalent to the ability to modify a setuid binary!
3776 This needs to happen before we read the main configuration. */
3780 if (running_in_test_harness) smtputf8_advertise_hosts = NULL;
3783 /* Read the main runtime configuration data; this gives up if there
3784 is a failure. It leaves the configuration file open so that the subsequent
3785 configuration data for delivery can be read if needed.
3787 NOTE: immediatly after opening the configuration file we change the working
3788 directory to "/"! Later we change to $spool_directory. We do it there, because
3789 during readconf_main() some expansion takes place already. */
3791 /* Store the initial cwd before we change directories. Can be NULL if the
3792 dir has already been unlinked. */
3793 initial_cwd = os_getcwd(NULL, 0);
3796 -be[m] expansion test -
3797 -b[fF] filter test new
3799 -bmalware malware_test_file new
3801 -brw rewrite test new
3803 -bv[s] address verify -
3805 -bP <option> (except -bP config, which sets list_config)
3807 If any of these options is set, we suppress warnings about configuration
3808 issues (currently about tls_advertise_hosts and keep_environment not being
3811 readconf_main(checking || list_options);
3814 /* Now in directory "/" */
3816 if (cleanup_environment() == FALSE)
3817 log_write(0, LOG_PANIC_DIE, "Can't cleanup environment");
3820 /* If an action on specific messages is requested, or if a daemon or queue
3821 runner is being started, we need to know if Exim was called by an admin user.
3822 This is the case if the real user is root or exim, or if the real group is
3823 exim, or if one of the supplementary groups is exim or a group listed in
3824 admin_groups. We don't fail all message actions immediately if not admin_user,
3825 since some actions can be performed by non-admin users. Instead, set admin_user
3826 for later interrogation. */
3828 if (real_uid == root_uid || real_uid == exim_uid || real_gid == exim_gid)
3833 for (i = 0; i < group_count && !admin_user; i++)
3834 if (group_list[i] == exim_gid)
3836 else if (admin_groups)
3837 for (j = 1; j <= (int)admin_groups[0] && !admin_user; j++)
3838 if (admin_groups[j] == group_list[i])
3842 /* Another group of privileged users are the trusted users. These are root,
3843 exim, and any caller matching trusted_users or trusted_groups. Trusted callers
3844 are permitted to specify sender_addresses with -f on the command line, and
3845 other message parameters as well. */
3847 if (real_uid == root_uid || real_uid == exim_uid)
3848 trusted_caller = TRUE;
3854 for (i = 1; i <= (int)trusted_users[0] && !trusted_caller; i++)
3855 if (trusted_users[i] == real_uid)
3856 trusted_caller = TRUE;
3859 for (i = 1; i <= (int)trusted_groups[0] && !trusted_caller; i++)
3860 if (trusted_groups[i] == real_gid)
3861 trusted_caller = TRUE;
3862 else for (j = 0; j < group_count && !trusted_caller; j++)
3863 if (trusted_groups[i] == group_list[j])
3864 trusted_caller = TRUE;
3867 /* At this point, we know if the user is privileged and some command-line
3868 options become possibly impermissible, depending upon the configuration file. */
3870 if (checking && commandline_checks_require_admin && !admin_user) {
3871 fprintf(stderr, "exim: those command-line flags are set to require admin\n");
3875 /* Handle the decoding of logging options. */
3877 decode_bits(log_selector, log_selector_size, log_notall,
3878 log_selector_string, log_options, log_options_count, US"log", 0);
3883 debug_printf("configuration file is %s\n", config_main_filename);
3884 debug_printf("log selectors =");
3885 for (i = 0; i < log_selector_size; i++)
3886 debug_printf(" %08x", log_selector[i]);
3890 /* If domain literals are not allowed, check the sender address that was
3891 supplied with -f. Ditto for a stripped trailing dot. */
3893 if (sender_address != NULL)
3895 if (sender_address[sender_address_domain] == '[' && !allow_domain_literals)
3897 fprintf(stderr, "exim: bad -f address \"%s\": domain literals not "
3898 "allowed\n", sender_address);
3899 return EXIT_FAILURE;
3901 if (f_end_dot && !strip_trailing_dot)
3903 fprintf(stderr, "exim: bad -f address \"%s.\": domain is malformed "
3904 "(trailing dot not allowed)\n", sender_address);
3905 return EXIT_FAILURE;
3909 /* See if an admin user overrode our logging. */
3911 if (cmdline_syslog_name != NULL)
3915 syslog_processname = cmdline_syslog_name;
3916 log_file_path = string_copy(CUS"syslog");
3920 /* not a panic, non-privileged users should not be able to spam paniclog */
3922 "exim: you lack sufficient privilege to specify syslog process name\n");
3923 return EXIT_FAILURE;
3927 /* Paranoia check of maximum lengths of certain strings. There is a check
3928 on the length of the log file path in log.c, which will come into effect
3929 if there are any calls to write the log earlier than this. However, if we
3930 get this far but the string is very long, it is better to stop now than to
3931 carry on and (e.g.) receive a message and then have to collapse. The call to
3932 log_write() from here will cause the ultimate panic collapse if the complete
3933 file name exceeds the buffer length. */
3935 if (Ustrlen(log_file_path) > 200)
3936 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3937 "log_file_path is longer than 200 chars: aborting");
3939 if (Ustrlen(pid_file_path) > 200)
3940 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3941 "pid_file_path is longer than 200 chars: aborting");
3943 if (Ustrlen(spool_directory) > 200)
3944 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3945 "spool_directory is longer than 200 chars: aborting");
3947 /* Length check on the process name given to syslog for its TAG field,
3948 which is only permitted to be 32 characters or less. See RFC 3164. */
3950 if (Ustrlen(syslog_processname) > 32)
3951 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3952 "syslog_processname is longer than 32 chars: aborting");
3957 log_write(0, LOG_MAIN, "%s", log_oneline);
3958 return EXIT_SUCCESS;
3961 return EXIT_FAILURE;
3963 /* In some operating systems, the environment variable TMPDIR controls where
3964 temporary files are created; Exim doesn't use these (apart from when delivering
3965 to MBX mailboxes), but called libraries such as DBM libraries may require them.
3966 If TMPDIR is found in the environment, reset it to the value defined in the
3967 EXIM_TMPDIR macro, if this macro is defined. For backward compatibility this
3968 macro may be called TMPDIR in old "Local/Makefile"s. It's converted to
3969 EXIM_TMPDIR by the build scripts.
3975 if (environ) for (p = USS environ; *p; p++)
3976 if (Ustrncmp(*p, "TMPDIR=", 7) == 0 && Ustrcmp(*p+7, EXIM_TMPDIR) != 0)
3978 uschar * newp = store_malloc(Ustrlen(EXIM_TMPDIR) + 8);
3979 sprintf(CS newp, "TMPDIR=%s", EXIM_TMPDIR);
3981 DEBUG(D_any) debug_printf("reset TMPDIR=%s in environment\n", EXIM_TMPDIR);
3986 /* Timezone handling. If timezone_string is "utc", set a flag to cause all
3987 timestamps to be in UTC (gmtime() is used instead of localtime()). Otherwise,
3988 we may need to get rid of a bogus timezone setting. This can arise when Exim is
3989 called by a user who has set the TZ variable. This then affects the timestamps
3990 in log files and in Received: headers, and any created Date: header lines. The
3991 required timezone is settable in the configuration file, so nothing can be done
3992 about this earlier - but hopefully nothing will normally be logged earlier than
3993 this. We have to make a new environment if TZ is wrong, but don't bother if
3994 timestamps_utc is set, because then all times are in UTC anyway. */
3996 if (timezone_string && strcmpic(timezone_string, US"UTC") == 0)
3997 timestamps_utc = TRUE;
4000 uschar *envtz = US getenv("TZ");
4002 ? !timezone_string || Ustrcmp(timezone_string, envtz) != 0
4003 : timezone_string != NULL
4006 uschar **p = USS environ;
4010 if (environ) while (*p++) count++;
4011 if (!envtz) count++;
4012 newp = new = store_malloc(sizeof(uschar *) * (count + 1));
4013 if (environ) for (p = USS environ; *p; p++)
4014 if (Ustrncmp(*p, "TZ=", 3) != 0) *newp++ = *p;
4015 if (timezone_string)
4017 *newp = store_malloc(Ustrlen(timezone_string) + 4);
4018 sprintf(CS *newp++, "TZ=%s", timezone_string);
4023 DEBUG(D_any) debug_printf("Reset TZ to %s: time is %s\n", timezone_string,
4024 tod_stamp(tod_log));
4028 /* Handle the case when we have removed the setuid privilege because of -C or
4029 -D. This means that the caller of Exim was not root.
4031 There is a problem if we were running as the Exim user. The sysadmin may
4032 expect this case to retain privilege because "the binary was called by the
4033 Exim user", but it hasn't, because either the -D option set macros, or the
4034 -C option set a non-trusted configuration file. There are two possibilities:
4036 (1) If deliver_drop_privilege is set, Exim is not going to re-exec in order
4037 to do message deliveries. Thus, the fact that it is running as a
4038 non-privileged user is plausible, and might be wanted in some special
4039 configurations. However, really_exim will have been set false when
4040 privilege was dropped, to stop Exim trying to write to its normal log
4041 files. Therefore, re-enable normal log processing, assuming the sysadmin
4042 has set up the log directory correctly.
4044 (2) If deliver_drop_privilege is not set, the configuration won't work as
4045 apparently intended, and so we log a panic message. In order to retain
4046 root for -C or -D, the caller must either be root or be invoking a
4047 trusted configuration file (when deliver_drop_privilege is false). */
4049 if ( removed_privilege
4050 && (!trusted_config || opt_D_used)
4051 && real_uid == exim_uid)
4052 if (deliver_drop_privilege)
4053 really_exim = TRUE; /* let logging work normally */
4055 log_write(0, LOG_MAIN|LOG_PANIC,
4056 "exim user lost privilege for using %s option",
4057 trusted_config? "-D" : "-C");
4059 /* Start up Perl interpreter if Perl support is configured and there is a
4060 perl_startup option, and the configuration or the command line specifies
4061 initializing starting. Note that the global variables are actually called
4062 opt_perl_xxx to avoid clashing with perl's namespace (perl_*). */
4065 if (perl_start_option != 0)
4066 opt_perl_at_start = (perl_start_option > 0);
4067 if (opt_perl_at_start && opt_perl_startup != NULL)
4070 DEBUG(D_any) debug_printf("Starting Perl interpreter\n");
4071 errstr = init_perl(opt_perl_startup);
4074 fprintf(stderr, "exim: error in perl_startup code: %s\n", errstr);
4075 return EXIT_FAILURE;
4077 opt_perl_started = TRUE;
4079 #endif /* EXIM_PERL */
4081 /* Log the arguments of the call if the configuration file said so. This is
4082 a debugging feature for finding out what arguments certain MUAs actually use.
4083 Don't attempt it if logging is disabled, or if listing variables or if
4084 verifying/testing addresses or expansions. */
4086 if (((debug_selector & D_any) != 0 || LOGGING(arguments))
4087 && really_exim && !list_options && !checking)
4090 uschar *p = big_buffer;
4091 Ustrcpy(p, "cwd= (failed)");
4093 Ustrncpy(p + 4, initial_cwd, big_buffer_size-5);
4096 (void)string_format(p, big_buffer_size - (p - big_buffer), " %d args:", argc);
4098 for (i = 0; i < argc; i++)
4100 int len = Ustrlen(argv[i]);
4101 const uschar *printing;
4103 if (p + len + 8 >= big_buffer + big_buffer_size)
4106 log_write(0, LOG_MAIN, "%s", big_buffer);
4107 Ustrcpy(big_buffer, "...");
4110 printing = string_printing(argv[i]);
4111 if (printing[0] == 0) quote = US"\""; else
4113 const uschar *pp = printing;
4115 while (*pp != 0) if (isspace(*pp++)) { quote = US"\""; break; }
4117 p += sprintf(CS p, " %s%.*s%s", quote, (int)(big_buffer_size -
4118 (p - big_buffer) - 4), printing, quote);
4121 if (LOGGING(arguments))
4122 log_write(0, LOG_MAIN, "%s", big_buffer);
4124 debug_printf("%s\n", big_buffer);
4127 /* Set the working directory to be the top-level spool directory. We don't rely
4128 on this in the code, which always uses fully qualified names, but it's useful
4129 for core dumps etc. Don't complain if it fails - the spool directory might not
4130 be generally accessible and calls with the -C option (and others) have lost
4131 privilege by now. Before the chdir, we try to ensure that the directory exists.
4134 if (Uchdir(spool_directory) != 0)
4137 (void)directory_make(spool_directory, US"", SPOOL_DIRECTORY_MODE, FALSE);
4138 dummy = /* quieten compiler */ Uchdir(spool_directory);
4139 dummy = dummy; /* yet more compiler quietening, sigh */
4142 /* Handle calls with the -bi option. This is a sendmail option to rebuild *the*
4143 alias file. Exim doesn't have such a concept, but this call is screwed into
4144 Sun's YP makefiles. Handle this by calling a configured script, as the real
4145 user who called Exim. The -oA option can be used to pass an argument to the
4150 (void)fclose(config_file);
4151 if (bi_command != NULL)
4155 argv[i++] = bi_command;
4156 if (alias_arg != NULL) argv[i++] = alias_arg;
4159 setgroups(group_count, group_list);
4160 exim_setugid(real_uid, real_gid, FALSE, US"running bi_command");
4162 DEBUG(D_exec) debug_printf("exec %.256s %.256s\n", argv[0],
4163 (argv[1] == NULL)? US"" : argv[1]);
4165 execv(CS argv[0], (char *const *)argv);
4166 fprintf(stderr, "exim: exec failed: %s\n", strerror(errno));
4171 DEBUG(D_any) debug_printf("-bi used but bi_command not set; exiting\n");
4176 /* We moved the admin/trusted check to be immediately after reading the
4177 configuration file. We leave these prints here to ensure that syslog setup,
4178 logfile setup, and so on has already happened. */
4180 if (trusted_caller) DEBUG(D_any) debug_printf("trusted user\n");
4181 if (admin_user) DEBUG(D_any) debug_printf("admin user\n");
4183 /* Only an admin user may start the daemon or force a queue run in the default
4184 configuration, but the queue run restriction can be relaxed. Only an admin
4185 user may request that a message be returned to its sender forthwith. Only an
4186 admin user may specify a debug level greater than D_v (because it might show
4187 passwords, etc. in lookup queries). Only an admin user may request a queue
4188 count. Only an admin user can use the test interface to scan for email
4189 (because Exim will be in the spool dir and able to look at mails). */
4193 BOOL debugset = (debug_selector & ~D_v) != 0;
4194 if (deliver_give_up || daemon_listen || malware_test_file ||
4195 (count_queue && queue_list_requires_admin) ||
4196 (list_queue && queue_list_requires_admin) ||
4197 (queue_interval >= 0 && prod_requires_admin) ||
4198 (debugset && !running_in_test_harness))
4200 fprintf(stderr, "exim:%s permission denied\n", debugset? " debugging" : "");
4205 /* If the real user is not root or the exim uid, the argument for passing
4206 in an open TCP/IP connection for another message is not permitted, nor is
4207 running with the -N option for any delivery action, unless this call to exim is
4208 one that supplied an input message, or we are using a patched exim for
4209 regression testing. */
4211 if (real_uid != root_uid && real_uid != exim_uid &&
4212 (continue_hostname != NULL ||
4214 (queue_interval >= 0 || daemon_listen || msg_action_arg > 0)
4215 )) && !running_in_test_harness)
4217 fprintf(stderr, "exim: Permission denied\n");
4218 return EXIT_FAILURE;
4221 /* If the caller is not trusted, certain arguments are ignored when running for
4222 real, but are permitted when checking things (-be, -bv, -bt, -bh, -bf, -bF).
4223 Note that authority for performing certain actions on messages is tested in the
4224 queue_action() function. */
4226 if (!trusted_caller && !checking)
4228 sender_host_name = sender_host_address = interface_address =
4229 sender_ident = received_protocol = NULL;
4230 sender_host_port = interface_port = 0;
4231 sender_host_authenticated = authenticated_sender = authenticated_id = NULL;
4234 /* If a sender host address is set, extract the optional port number off the
4235 end of it and check its syntax. Do the same thing for the interface address.
4236 Exim exits if the syntax is bad. */
4240 if (sender_host_address != NULL)
4241 sender_host_port = check_port(sender_host_address);
4242 if (interface_address != NULL)
4243 interface_port = check_port(interface_address);
4246 /* If the caller is trusted, then they can use -G to suppress_local_fixups. */
4251 suppress_local_fixups = suppress_local_fixups_default = TRUE;
4252 DEBUG(D_acl) debug_printf("suppress_local_fixups forced on by -G\n");
4256 fprintf(stderr, "exim: permission denied (-G requires a trusted user)\n");
4257 return EXIT_FAILURE;
4261 /* If an SMTP message is being received check to see if the standard input is a
4262 TCP/IP socket. If it is, we assume that Exim was called from inetd if the
4263 caller is root or the Exim user, or if the port is a privileged one. Otherwise,
4268 union sockaddr_46 inetd_sock;
4269 EXIM_SOCKLEN_T size = sizeof(inetd_sock);
4270 if (getpeername(0, (struct sockaddr *)(&inetd_sock), &size) == 0)
4272 int family = ((struct sockaddr *)(&inetd_sock))->sa_family;
4273 if (family == AF_INET || family == AF_INET6)
4275 union sockaddr_46 interface_sock;
4276 size = sizeof(interface_sock);
4278 if (getsockname(0, (struct sockaddr *)(&interface_sock), &size) == 0)
4279 interface_address = host_ntoa(-1, &interface_sock, NULL,
4282 if (host_is_tls_on_connect_port(interface_port)) tls_in.on_connect = TRUE;
4284 if (real_uid == root_uid || real_uid == exim_uid || interface_port < 1024)
4287 sender_host_address = host_ntoa(-1, (struct sockaddr *)(&inetd_sock),
4288 NULL, &sender_host_port);
4289 if (mua_wrapper) log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Input from "
4290 "inetd is not supported when mua_wrapper is set");
4295 "exim: Permission denied (unprivileged user, unprivileged port)\n");
4296 return EXIT_FAILURE;
4302 /* If the load average is going to be needed while receiving a message, get it
4303 now for those OS that require the first call to os_getloadavg() to be done as
4304 root. There will be further calls later for each message received. */
4306 #ifdef LOAD_AVG_NEEDS_ROOT
4307 if (receiving_message &&
4308 (queue_only_load >= 0 ||
4309 (is_inetd && smtp_load_reserve >= 0)
4312 load_average = OS_GETLOADAVG();
4316 /* The queue_only configuration option can be overridden by -odx on the command
4317 line, except that if queue_only_override is false, queue_only cannot be unset
4318 from the command line. */
4320 if (queue_only_set && (queue_only_override || arg_queue_only))
4321 queue_only = arg_queue_only;
4323 /* The receive_timeout and smtp_receive_timeout options can be overridden by
4326 if (arg_receive_timeout >= 0) receive_timeout = arg_receive_timeout;
4327 if (arg_smtp_receive_timeout >= 0)
4328 smtp_receive_timeout = arg_smtp_receive_timeout;
4330 /* If Exim was started with root privilege, unless we have already removed the
4331 root privilege above as a result of -C, -D, -be, -bf or -bF, remove it now
4332 except when starting the daemon or doing some kind of delivery or address
4333 testing (-bt). These are the only cases when root need to be retained. We run
4334 as exim for -bv and -bh. However, if deliver_drop_privilege is set, root is
4335 retained only for starting the daemon. We always do the initgroups() in this
4336 situation (controlled by the TRUE below), in order to be as close as possible
4337 to the state Exim usually runs in. */
4339 if (!unprivileged && /* originally had root AND */
4340 !removed_privilege && /* still got root AND */
4341 !daemon_listen && /* not starting the daemon */
4342 queue_interval <= 0 && /* (either kind of daemon) */
4344 deliver_drop_privilege || /* requested unprivileged */
4346 queue_interval < 0 && /* not running the queue */
4347 (msg_action_arg < 0 || /* and */
4348 msg_action != MSG_DELIVER) && /* not delivering and */
4349 (!checking || !address_test_mode) /* not address checking */
4351 exim_setugid(exim_uid, exim_gid, TRUE, US"privilege not needed");
4353 /* When we are retaining a privileged uid, we still change to the exim gid. */
4358 rv = setgid(exim_gid);
4359 /* Impact of failure is that some stuff might end up with an incorrect group.
4360 We track this for failures from root, since any attempt to change privilege
4361 by root should succeed and failures should be examined. For non-root,
4362 there's no security risk. For me, it's { exim -bV } on a just-built binary,
4363 no need to complain then. */
4365 if (!(unprivileged || removed_privilege))
4368 "exim: changing group failed: %s\n", strerror(errno));
4372 DEBUG(D_any) debug_printf("changing group to %ld failed: %s\n",
4373 (long int)exim_gid, strerror(errno));
4376 /* Handle a request to scan a file for malware */
4377 if (malware_test_file)
4379 #ifdef WITH_CONTENT_SCAN
4381 set_process_info("scanning file for malware");
4382 result = malware_in_file(malware_test_file);
4385 printf("No malware found.\n");
4390 printf("Malware lookup returned non-okay/fail: %d\n", result);
4394 printf("Malware found: %s\n", malware_name);
4396 printf("Malware scan detected malware of unknown name.\n");
4398 printf("Malware scanning not enabled at compile time.\n");
4403 /* Handle a request to list the delivery queue */
4407 set_process_info("listing the queue");
4408 queue_list(list_queue_option, argv + recipients_arg, argc - recipients_arg);
4412 /* Handle a request to count the delivery queue */
4416 set_process_info("counting the queue");
4421 /* Handle actions on specific messages, except for the force delivery and
4422 message load actions, which are done below. Some actions take a whole list of
4423 message ids, which are known to continue up to the end of the arguments. Others
4424 take a single message id and then operate on the recipients list. */
4426 if (msg_action_arg > 0 && msg_action != MSG_DELIVER && msg_action != MSG_LOAD)
4428 int yield = EXIT_SUCCESS;
4429 set_process_info("acting on specified messages");
4431 if (!one_msg_action)
4433 for (i = msg_action_arg; i < argc; i++)
4434 if (!queue_action(argv[i], msg_action, NULL, 0, 0))
4435 yield = EXIT_FAILURE;
4438 else if (!queue_action(argv[msg_action_arg], msg_action, argv, argc,
4439 recipients_arg)) yield = EXIT_FAILURE;
4443 /* We used to set up here to skip reading the ACL section, on
4444 (msg_action_arg > 0 || (queue_interval == 0 && !daemon_listen)
4445 Now, since the intro of the ${acl } expansion, ACL definitions may be
4446 needed in transports so we lost the optimisation. */
4450 /* The configuration data will have been read into POOL_PERM because we won't
4451 ever want to reset back past it. Change the current pool to POOL_MAIN. In fact,
4452 this is just a bit of pedantic tidiness. It wouldn't really matter if the
4453 configuration were read into POOL_MAIN, because we don't do any resets till
4454 later on. However, it seems right, and it does ensure that both pools get used.
4457 store_pool = POOL_MAIN;
4459 /* Handle the -brt option. This is for checking out retry configurations.
4460 The next three arguments are a domain name or a complete address, and
4461 optionally two error numbers. All it does is to call the function that
4462 scans the retry configuration data. */
4464 if (test_retry_arg >= 0)
4466 retry_config *yield;
4467 int basic_errno = 0;
4471 if (test_retry_arg >= argc)
4473 printf("-brt needs a domain or address argument\n");
4474 exim_exit(EXIT_FAILURE, US"main");
4476 s1 = argv[test_retry_arg++];
4479 /* If the first argument contains no @ and no . it might be a local user
4480 or it might be a single-component name. Treat as a domain. */
4482 if (Ustrchr(s1, '@') == NULL && Ustrchr(s1, '.') == NULL)
4484 printf("Warning: \"%s\" contains no '@' and no '.' characters. It is "
4485 "being \ntreated as a one-component domain, not as a local part.\n\n",
4489 /* There may be an optional second domain arg. */
4491 if (test_retry_arg < argc && Ustrchr(argv[test_retry_arg], '.') != NULL)
4492 s2 = argv[test_retry_arg++];
4494 /* The final arg is an error name */
4496 if (test_retry_arg < argc)
4498 uschar *ss = argv[test_retry_arg];
4500 readconf_retry_error(ss, ss + Ustrlen(ss), &basic_errno, &more_errno);
4503 printf("%s\n", CS error);
4504 return EXIT_FAILURE;
4507 /* For the {MAIL,RCPT,DATA}_4xx errors, a value of 255 means "any", and a
4508 code > 100 as an error is for matching codes to the decade. Turn them into
4509 a real error code, off the decade. */
4511 if (basic_errno == ERRNO_MAIL4XX ||
4512 basic_errno == ERRNO_RCPT4XX ||
4513 basic_errno == ERRNO_DATA4XX)
4515 int code = (more_errno >> 8) & 255;
4517 more_errno = (more_errno & 0xffff00ff) | (21 << 8);
4518 else if (code > 100)
4519 more_errno = (more_errno & 0xffff00ff) | ((code - 96) << 8);
4523 if (!(yield = retry_find_config(s1, s2, basic_errno, more_errno)))
4524 printf("No retry information found\n");
4528 more_errno = yield->more_errno;
4529 printf("Retry rule: %s ", yield->pattern);
4531 if (yield->basic_errno == ERRNO_EXIMQUOTA)
4533 printf("quota%s%s ",
4534 (more_errno > 0)? "_" : "",
4535 (more_errno > 0)? readconf_printtime(more_errno) : US"");
4537 else if (yield->basic_errno == ECONNREFUSED)
4539 printf("refused%s%s ",
4540 (more_errno > 0)? "_" : "",
4541 (more_errno == 'M')? "MX" :
4542 (more_errno == 'A')? "A" : "");
4544 else if (yield->basic_errno == ETIMEDOUT)
4547 if ((more_errno & RTEF_CTOUT) != 0) printf("_connect");
4549 if (more_errno != 0) printf("_%s",
4550 (more_errno == 'M')? "MX" : "A");
4553 else if (yield->basic_errno == ERRNO_AUTHFAIL)
4554 printf("auth_failed ");
4557 for (r = yield->rules; r; r = r->next)
4559 printf("%c,%s", r->rule, readconf_printtime(r->timeout)); /* Do not */
4560 printf(",%s", readconf_printtime(r->p1)); /* amalgamate */
4566 printf(",%d.", x/1000);
4580 exim_exit(EXIT_SUCCESS, US"main");
4583 /* Handle a request to list one or more configuration options */
4584 /* If -n was set, we suppress some information */
4589 set_process_info("listing variables");
4590 if (recipients_arg >= argc)
4591 fail = !readconf_print(US"all", NULL, flag_n);
4592 else for (i = recipients_arg; i < argc; i++)
4595 (Ustrcmp(argv[i], "router") == 0 ||
4596 Ustrcmp(argv[i], "transport") == 0 ||
4597 Ustrcmp(argv[i], "authenticator") == 0 ||
4598 Ustrcmp(argv[i], "macro") == 0 ||
4599 Ustrcmp(argv[i], "environment") == 0))
4601 fail |= !readconf_print(argv[i+1], argv[i], flag_n);
4605 fail = !readconf_print(argv[i], NULL, flag_n);
4607 exim_exit(fail ? EXIT_FAILURE : EXIT_SUCCESS, US"main");
4612 set_process_info("listing config");
4613 exim_exit(readconf_print(US"config", NULL, flag_n)
4614 ? EXIT_SUCCESS : EXIT_FAILURE, US"main");
4618 /* Initialise subsystems as required */
4619 #ifndef DISABLE_DKIM
4625 /* Handle a request to deliver one or more messages that are already on the
4626 queue. Values of msg_action other than MSG_DELIVER and MSG_LOAD are dealt with
4627 above. MSG_LOAD is handled with -be (which is the only time it applies) below.
4629 Delivery of specific messages is typically used for a small number when
4630 prodding by hand (when the option forced_delivery will be set) or when
4631 re-execing to regain root privilege. Each message delivery must happen in a
4632 separate process, so we fork a process for each one, and run them sequentially
4633 so that debugging output doesn't get intertwined, and to avoid spawning too
4634 many processes if a long list is given. However, don't fork for the last one;
4635 this saves a process in the common case when Exim is called to deliver just one
4638 if (msg_action_arg > 0 && msg_action != MSG_LOAD)
4640 if (prod_requires_admin && !admin_user)
4642 fprintf(stderr, "exim: Permission denied\n");
4643 exim_exit(EXIT_FAILURE, US"main");
4645 set_process_info("delivering specified messages");
4646 if (deliver_give_up) forced_delivery = deliver_force_thaw = TRUE;
4647 for (i = msg_action_arg; i < argc; i++)
4652 (void)deliver_message(argv[i], forced_delivery, deliver_give_up);
4653 else if ((pid = fork()) == 0)
4655 (void)deliver_message(argv[i], forced_delivery, deliver_give_up);
4656 _exit(EXIT_SUCCESS);
4660 fprintf(stderr, "failed to fork delivery process for %s: %s\n", argv[i],
4662 exim_exit(EXIT_FAILURE, US"main");
4666 exim_exit(EXIT_SUCCESS, US"main");
4670 /* If only a single queue run is requested, without SMTP listening, we can just
4671 turn into a queue runner, with an optional starting message id. */
4673 if (queue_interval == 0 && !daemon_listen)
4675 DEBUG(D_queue_run) debug_printf("Single queue run%s%s%s%s\n",
4676 (start_queue_run_id == NULL)? US"" : US" starting at ",
4677 (start_queue_run_id == NULL)? US"" : start_queue_run_id,
4678 (stop_queue_run_id == NULL)? US"" : US" stopping at ",
4679 (stop_queue_run_id == NULL)? US"" : stop_queue_run_id);
4681 set_process_info("running the '%s' queue (single queue run)", queue_name);
4683 set_process_info("running the queue (single queue run)");
4684 queue_run(start_queue_run_id, stop_queue_run_id, FALSE);
4685 exim_exit(EXIT_SUCCESS, US"main");
4689 /* Find the login name of the real user running this process. This is always
4690 needed when receiving a message, because it is written into the spool file. It
4691 may also be used to construct a from: or a sender: header, and in this case we
4692 need the user's full name as well, so save a copy of it, checked for RFC822
4693 syntax and munged if necessary, if it hasn't previously been set by the -F
4694 argument. We may try to get the passwd entry more than once, in case NIS or
4695 other delays are in evidence. Save the home directory for use in filter testing
4700 if ((pw = getpwuid(real_uid)) != NULL)
4702 originator_login = string_copy(US pw->pw_name);
4703 originator_home = string_copy(US pw->pw_dir);
4705 /* If user name has not been set by -F, set it from the passwd entry
4706 unless -f has been used to set the sender address by a trusted user. */
4708 if (!originator_name)
4710 if (!sender_address || (!trusted_caller && filter_test == FTEST_NONE))
4712 uschar *name = US pw->pw_gecos;
4713 uschar *amp = Ustrchr(name, '&');
4716 /* Most Unix specify that a '&' character in the gecos field is
4717 replaced by a copy of the login name, and some even specify that
4718 the first character should be upper cased, so that's what we do. */
4723 string_format(buffer, sizeof(buffer), "%.*s%n%s%s",
4724 (int)(amp - name), name, &loffset, originator_login, amp + 1);
4725 buffer[loffset] = toupper(buffer[loffset]);
4729 /* If a pattern for matching the gecos field was supplied, apply
4730 it and then expand the name string. */
4732 if (gecos_pattern && gecos_name)
4735 re = regex_must_compile(gecos_pattern, FALSE, TRUE); /* Use malloc */
4737 if (regex_match_and_setup(re, name, 0, -1))
4739 uschar *new_name = expand_string(gecos_name);
4743 DEBUG(D_receive) debug_printf("user name \"%s\" extracted from "
4744 "gecos field \"%s\"\n", new_name, name);
4747 else DEBUG(D_receive) debug_printf("failed to expand gecos_name string "
4748 "\"%s\": %s\n", gecos_name, expand_string_message);
4750 else DEBUG(D_receive) debug_printf("gecos_pattern \"%s\" did not match "
4751 "gecos field \"%s\"\n", gecos_pattern, name);
4752 store_free((void *)re);
4754 originator_name = string_copy(name);
4757 /* A trusted caller has used -f but not -F */
4759 else originator_name = US"";
4762 /* Break the retry loop */
4767 if (++i > finduser_retries) break;
4771 /* If we cannot get a user login, log the incident and give up, unless the
4772 configuration specifies something to use. When running in the test harness,
4773 any setting of unknown_login overrides the actual name. */
4775 if (originator_login == NULL || running_in_test_harness)
4777 if (unknown_login != NULL)
4779 originator_login = expand_string(unknown_login);
4780 if (originator_name == NULL && unknown_username != NULL)
4781 originator_name = expand_string(unknown_username);
4782 if (originator_name == NULL) originator_name = US"";
4784 if (originator_login == NULL)
4785 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Failed to get user name for uid %d",
4789 /* Ensure that the user name is in a suitable form for use as a "phrase" in an
4792 originator_name = string_copy(parse_fix_phrase(originator_name,
4793 Ustrlen(originator_name), big_buffer, big_buffer_size));
4795 /* If a message is created by this call of Exim, the uid/gid of its originator
4796 are those of the caller. These values are overridden if an existing message is
4797 read in from the spool. */
4799 originator_uid = real_uid;
4800 originator_gid = real_gid;
4802 DEBUG(D_receive) debug_printf("originator: uid=%d gid=%d login=%s name=%s\n",
4803 (int)originator_uid, (int)originator_gid, originator_login, originator_name);
4805 /* Run in daemon and/or queue-running mode. The function daemon_go() never
4806 returns. We leave this till here so that the originator_ fields are available
4807 for incoming messages via the daemon. The daemon cannot be run in mua_wrapper
4810 if (daemon_listen || inetd_wait_mode || queue_interval > 0)
4814 fprintf(stderr, "Daemon cannot be run when mua_wrapper is set\n");
4815 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Daemon cannot be run when "
4816 "mua_wrapper is set");
4821 /* If the sender ident has not been set (by a trusted caller) set it to
4822 the caller. This will get overwritten below for an inetd call. If a trusted
4823 caller has set it empty, unset it. */
4825 if (sender_ident == NULL) sender_ident = originator_login;
4826 else if (sender_ident[0] == 0) sender_ident = NULL;
4828 /* Handle the -brw option, which is for checking out rewriting rules. Cause log
4829 writes (on errors) to go to stderr instead. Can't do this earlier, as want the
4830 originator_* variables set. */
4832 if (test_rewrite_arg >= 0)
4834 really_exim = FALSE;
4835 if (test_rewrite_arg >= argc)
4837 printf("-brw needs an address argument\n");
4838 exim_exit(EXIT_FAILURE, US"main");
4840 rewrite_test(argv[test_rewrite_arg]);
4841 exim_exit(EXIT_SUCCESS, US"main");
4844 /* A locally-supplied message is considered to be coming from a local user
4845 unless a trusted caller supplies a sender address with -f, or is passing in the
4846 message via SMTP (inetd invocation or otherwise). */
4848 if ((sender_address == NULL && !smtp_input) ||
4849 (!trusted_caller && filter_test == FTEST_NONE))
4851 sender_local = TRUE;
4853 /* A trusted caller can supply authenticated_sender and authenticated_id
4854 via -oMas and -oMai and if so, they will already be set. Otherwise, force
4855 defaults except when host checking. */
4857 if (authenticated_sender == NULL && !host_checking)
4858 authenticated_sender = string_sprintf("%s@%s", originator_login,
4859 qualify_domain_sender);
4860 if (authenticated_id == NULL && !host_checking)
4861 authenticated_id = originator_login;
4864 /* Trusted callers are always permitted to specify the sender address.
4865 Untrusted callers may specify it if it matches untrusted_set_sender, or if what
4866 is specified is the empty address. However, if a trusted caller does not
4867 specify a sender address for SMTP input, we leave sender_address unset. This
4868 causes the MAIL commands to be honoured. */
4870 if ((!smtp_input && sender_address == NULL) ||
4871 !receive_check_set_sender(sender_address))
4873 /* Either the caller is not permitted to set a general sender, or this is
4874 non-SMTP input and the trusted caller has not set a sender. If there is no
4875 sender, or if a sender other than <> is set, override with the originator's
4876 login (which will get qualified below), except when checking things. */
4878 if (sender_address == NULL /* No sender_address set */
4880 (sender_address[0] != 0 && /* Non-empty sender address, AND */
4881 !checking)) /* Not running tests, including filter tests */
4883 sender_address = originator_login;
4884 sender_address_forced = FALSE;
4885 sender_address_domain = 0;
4889 /* Remember whether an untrusted caller set the sender address */
4891 sender_set_untrusted = sender_address != originator_login && !trusted_caller;
4893 /* Ensure that the sender address is fully qualified unless it is the empty
4894 address, which indicates an error message, or doesn't exist (root caller, smtp
4895 interface, no -f argument). */
4897 if (sender_address != NULL && sender_address[0] != 0 &&
4898 sender_address_domain == 0)
4899 sender_address = string_sprintf("%s@%s", local_part_quote(sender_address),
4900 qualify_domain_sender);
4902 DEBUG(D_receive) debug_printf("sender address = %s\n", sender_address);
4904 /* Handle a request to verify a list of addresses, or test them for delivery.
4905 This must follow the setting of the sender address, since routers can be
4906 predicated upon the sender. If no arguments are given, read addresses from
4907 stdin. Set debug_level to at least D_v to get full output for address testing.
4910 if (verify_address_mode || address_test_mode)
4913 int flags = vopt_qualify;
4915 if (verify_address_mode)
4917 if (!verify_as_sender) flags |= vopt_is_recipient;
4918 DEBUG(D_verify) debug_print_ids(US"Verifying:");
4923 flags |= vopt_is_recipient;
4924 debug_selector |= D_v;
4925 debug_file = stderr;
4926 debug_fd = fileno(debug_file);
4927 DEBUG(D_verify) debug_print_ids(US"Address testing:");
4930 if (recipients_arg < argc)
4932 while (recipients_arg < argc)
4934 uschar *s = argv[recipients_arg++];
4937 BOOL finished = FALSE;
4938 uschar *ss = parse_find_address_end(s, FALSE);
4939 if (*ss == ',') *ss = 0; else finished = TRUE;
4940 test_address(s, flags, &exit_value);
4943 while (*(++s) != 0 && (*s == ',' || isspace(*s)));
4950 uschar *s = get_stdinput(NULL, NULL);
4951 if (s == NULL) break;
4952 test_address(s, flags, &exit_value);
4956 exim_exit(exit_value, US"main");
4959 /* Handle expansion checking. Either expand items on the command line, or read
4960 from stdin if there aren't any. If -Mset was specified, load the message so
4961 that its variables can be used, but restrict this facility to admin users.
4962 Otherwise, if -bem was used, read a message from stdin. */
4966 dns_init(FALSE, FALSE, FALSE);
4967 if (msg_action_arg > 0 && msg_action == MSG_LOAD)
4969 uschar spoolname[256]; /* Not big_buffer; used in spool_read_header() */
4972 fprintf(stderr, "exim: permission denied\n");
4975 message_id = argv[msg_action_arg];
4976 (void)string_format(spoolname, sizeof(spoolname), "%s-H", message_id);
4977 if ((deliver_datafile = spool_open_datafile(message_id)) < 0)
4978 printf ("Failed to load message datafile %s\n", message_id);
4979 if (spool_read_header(spoolname, TRUE, FALSE) != spool_read_OK)
4980 printf ("Failed to load message %s\n", message_id);
4983 /* Read a test message from a file. We fudge it up to be on stdin, saving
4984 stdin itself for later reading of expansion strings. */
4986 else if (expansion_test_message)
4988 int save_stdin = dup(0);
4989 int fd = Uopen(expansion_test_message, O_RDONLY, 0);
4992 fprintf(stderr, "exim: failed to open %s: %s\n", expansion_test_message,
4994 return EXIT_FAILURE;
4997 filter_test = FTEST_USER; /* Fudge to make it look like filter test */
4998 message_ended = END_NOTENDED;
4999 read_message_body(receive_msg(extract_recipients));
5000 message_linecount += body_linecount;
5001 (void)dup2(save_stdin, 0);
5002 (void)close(save_stdin);
5003 clearerr(stdin); /* Required by Darwin */
5006 /* Only admin users may see config-file macros this way */
5008 if (!admin_user) macros_user = macros = mlast = NULL;
5010 /* Allow $recipients for this testing */
5012 enable_dollar_recipients = TRUE;
5014 /* Expand command line items */
5016 if (recipients_arg < argc)
5017 while (recipients_arg < argc)
5018 expansion_test_line(argv[recipients_arg++]);
5024 char *(*fn_readline)(const char *) = NULL;
5025 void (*fn_addhist)(const char *) = NULL;
5029 void *dlhandle = set_readline(&fn_readline, &fn_addhist);
5032 while (s = get_stdinput(fn_readline, fn_addhist))
5033 expansion_test_line(s);
5036 if (dlhandle) dlclose(dlhandle);
5040 /* The data file will be open after -Mset */
5042 if (deliver_datafile >= 0)
5044 (void)close(deliver_datafile);
5045 deliver_datafile = -1;
5048 exim_exit(EXIT_SUCCESS, US"main: expansion test");
5052 /* The active host name is normally the primary host name, but it can be varied
5053 for hosts that want to play several parts at once. We need to ensure that it is
5054 set for host checking, and for receiving messages. */
5056 smtp_active_hostname = primary_hostname;
5057 if (raw_active_hostname != NULL)
5059 uschar *nah = expand_string(raw_active_hostname);
5062 if (!expand_string_forcedfail)
5063 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to expand \"%s\" "
5064 "(smtp_active_hostname): %s", raw_active_hostname,
5065 expand_string_message);
5067 else if (nah[0] != 0) smtp_active_hostname = nah;
5070 /* Handle host checking: this facility mocks up an incoming SMTP call from a
5071 given IP address so that the blocking and relay configuration can be tested.
5072 Unless a sender_ident was set by -oMt, we discard it (the default is the
5073 caller's login name). An RFC 1413 call is made only if we are running in the
5074 test harness and an incoming interface and both ports are specified, because
5075 there is no TCP/IP call to find the ident for. */
5082 if (!sender_ident_set)
5084 sender_ident = NULL;
5085 if (running_in_test_harness && sender_host_port != 0 &&
5086 interface_address != NULL && interface_port != 0)
5087 verify_get_ident(1413);
5090 /* In case the given address is a non-canonical IPv6 address, canonicalize
5091 it. The code works for both IPv4 and IPv6, as it happens. */
5093 size = host_aton(sender_host_address, x);
5094 sender_host_address = store_get(48); /* large enough for full IPv6 */
5095 (void)host_nmtoa(size, x, -1, sender_host_address, ':');
5097 /* Now set up for testing */
5099 host_build_sender_fullhost();
5103 sender_local = FALSE;
5104 sender_host_notsocket = TRUE;
5105 debug_file = stderr;
5106 debug_fd = fileno(debug_file);
5107 fprintf(stdout, "\n**** SMTP testing session as if from host %s\n"
5108 "**** but without any ident (RFC 1413) callback.\n"
5109 "**** This is not for real!\n\n",
5110 sender_host_address);
5112 memset(sender_host_cache, 0, sizeof(sender_host_cache));
5113 if (verify_check_host(&hosts_connection_nolog) == OK)
5114 BIT_CLEAR(log_selector, log_selector_size, Li_smtp_connection);
5115 log_write(L_smtp_connection, LOG_MAIN, "%s", smtp_get_connection_info());
5117 /* NOTE: We do *not* call smtp_log_no_mail() if smtp_start_session() fails,
5118 because a log line has already been written for all its failure exists
5119 (usually "connection refused: <reason>") and writing another one is
5120 unnecessary clutter. */
5122 if (smtp_start_session())
5124 for (reset_point = store_get(0); ; store_reset(reset_point))
5126 if (smtp_setup_msg() <= 0) break;
5127 if (!receive_msg(FALSE)) break;
5129 return_path = sender_address = NULL;
5130 dnslist_domain = dnslist_matched = NULL;
5131 #ifndef DISABLE_DKIM
5132 dkim_cur_signer = NULL;
5135 deliver_localpart_orig = NULL;
5136 deliver_domain_orig = NULL;
5137 callout_address = sending_ip_address = NULL;
5138 sender_rate = sender_rate_limit = sender_rate_period = NULL;
5142 exim_exit(EXIT_SUCCESS, US"main");
5146 /* Arrange for message reception if recipients or SMTP were specified;
5147 otherwise complain unless a version print (-bV) happened or this is a filter
5148 verification test or info dump.
5149 In the former case, show the configuration file name. */
5151 if (recipients_arg >= argc && !extract_recipients && !smtp_input)
5153 if (version_printed)
5155 if (Ustrchr(config_main_filelist, ':'))
5156 printf("Configuration file search path is %s\n", config_main_filelist);
5157 printf("Configuration file is %s\n", config_main_filename);
5158 return EXIT_SUCCESS;
5161 if (info_flag != CMDINFO_NONE)
5163 show_exim_information(info_flag, info_stdout ? stdout : stderr);
5164 return info_stdout ? EXIT_SUCCESS : EXIT_FAILURE;
5167 if (filter_test == FTEST_NONE)
5168 exim_usage(called_as);
5172 /* If mua_wrapper is set, Exim is being used to turn an MUA that submits on the
5173 standard input into an MUA that submits to a smarthost over TCP/IP. We know
5174 that we are not called from inetd, because that is rejected above. The
5175 following configuration settings are forced here:
5177 (1) Synchronous delivery (-odi)
5178 (2) Errors to stderr (-oep == -oeq)
5179 (3) No parallel remote delivery
5180 (4) Unprivileged delivery
5182 We don't force overall queueing options because there are several of them;
5183 instead, queueing is avoided below when mua_wrapper is set. However, we do need
5184 to override any SMTP queueing. */
5188 synchronous_delivery = TRUE;
5189 arg_error_handling = ERRORS_STDERR;
5190 remote_max_parallel = 1;
5191 deliver_drop_privilege = TRUE;
5193 queue_smtp_domains = NULL;
5195 message_utf8_downconvert = -1; /* convert-if-needed */
5200 /* Prepare to accept one or more new messages on the standard input. When a
5201 message has been read, its id is returned in message_id[]. If doing immediate
5202 delivery, we fork a delivery process for each received message, except for the
5203 last one, where we can save a process switch.
5205 It is only in non-smtp mode that error_handling is allowed to be changed from
5206 its default of ERRORS_SENDER by argument. (Idle thought: are any of the
5207 sendmail error modes other than -oem ever actually used? Later: yes.) */
5209 if (!smtp_input) error_handling = arg_error_handling;
5211 /* If this is an inetd call, ensure that stderr is closed to prevent panic
5212 logging being sent down the socket and make an identd call to get the
5217 (void)fclose(stderr);
5218 exim_nullstd(); /* Re-open to /dev/null */
5219 verify_get_ident(IDENT_PORT);
5220 host_build_sender_fullhost();
5221 set_process_info("handling incoming connection from %s via inetd",
5225 /* If the sender host address has been set, build sender_fullhost if it hasn't
5226 already been done (which it will have been for inetd). This caters for the
5227 case when it is forced by -oMa. However, we must flag that it isn't a socket,
5228 so that the test for IP options is skipped for -bs input. */
5230 if (sender_host_address && !sender_fullhost)
5232 host_build_sender_fullhost();
5233 set_process_info("handling incoming connection from %s via -oMa",
5235 sender_host_notsocket = TRUE;
5238 /* Otherwise, set the sender host as unknown except for inetd calls. This
5239 prevents host checking in the case of -bs not from inetd and also for -bS. */
5241 else if (!is_inetd) sender_host_unknown = TRUE;
5243 /* If stdout does not exist, then dup stdin to stdout. This can happen
5244 if exim is started from inetd. In this case fd 0 will be set to the socket,
5245 but fd 1 will not be set. This also happens for passed SMTP channels. */
5247 if (fstat(1, &statbuf) < 0) (void)dup2(0, 1);
5249 /* Set up the incoming protocol name and the state of the program. Root is
5250 allowed to force received protocol via the -oMr option above. If we have come
5251 via inetd, the process info has already been set up. We don't set
5252 received_protocol here for smtp input, as it varies according to
5253 batch/HELO/EHLO/AUTH/TLS. */
5257 if (!is_inetd) set_process_info("accepting a local %sSMTP message from <%s>",
5258 smtp_batched_input? "batched " : "",
5259 (sender_address!= NULL)? sender_address : originator_login);
5263 int old_pool = store_pool;
5264 store_pool = POOL_PERM;
5265 if (!received_protocol)
5266 received_protocol = string_sprintf("local%s", called_as);
5267 store_pool = old_pool;
5268 set_process_info("accepting a local non-SMTP message from <%s>",
5272 /* Initialize the session_local_queue-only flag (this will be ignored if
5273 mua_wrapper is set) */
5276 session_local_queue_only = queue_only;
5278 /* For non-SMTP and for batched SMTP input, check that there is enough space on
5279 the spool if so configured. On failure, we must not attempt to send an error
5280 message! (For interactive SMTP, the check happens at MAIL FROM and an SMTP
5281 error code is given.) */
5283 if ((!smtp_input || smtp_batched_input) && !receive_check_fs(0))
5285 fprintf(stderr, "exim: insufficient disk space\n");
5286 return EXIT_FAILURE;
5289 /* If this is smtp input of any kind, real or batched, handle the start of the
5292 NOTE: We do *not* call smtp_log_no_mail() if smtp_start_session() fails,
5293 because a log line has already been written for all its failure exists
5294 (usually "connection refused: <reason>") and writing another one is
5295 unnecessary clutter. */
5301 memset(sender_host_cache, 0, sizeof(sender_host_cache));
5302 if (verify_check_host(&hosts_connection_nolog) == OK)
5303 BIT_CLEAR(log_selector, log_selector_size, Li_smtp_connection);
5304 log_write(L_smtp_connection, LOG_MAIN, "%s", smtp_get_connection_info());
5305 if (!smtp_start_session())
5308 exim_exit(EXIT_SUCCESS, US"smtp_start toplevel");
5312 /* Otherwise, set up the input size limit here. */
5316 thismessage_size_limit = expand_string_integer(message_size_limit, TRUE);
5317 if (expand_string_message)
5318 if (thismessage_size_limit == -1)
5319 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to expand "
5320 "message_size_limit: %s", expand_string_message);
5322 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "invalid value for "
5323 "message_size_limit: %s", expand_string_message);
5326 /* Loop for several messages when reading SMTP input. If we fork any child
5327 processes, we don't want to wait for them unless synchronous delivery is
5328 requested, so set SIGCHLD to SIG_IGN in that case. This is not necessarily the
5329 same as SIG_DFL, despite the fact that documentation often lists the default as
5330 "ignore". This is a confusing area. This is what I know:
5332 At least on some systems (e.g. Solaris), just setting SIG_IGN causes child
5333 processes that complete simply to go away without ever becoming defunct. You
5334 can't then wait for them - but we don't want to wait for them in the
5335 non-synchronous delivery case. However, this behaviour of SIG_IGN doesn't
5336 happen for all OS (e.g. *BSD is different).
5338 But that's not the end of the story. Some (many? all?) systems have the
5339 SA_NOCLDWAIT option for sigaction(). This requests the behaviour that Solaris
5340 has by default, so it seems that the difference is merely one of default
5341 (compare restarting vs non-restarting signals).
5343 To cover all cases, Exim sets SIG_IGN with SA_NOCLDWAIT here if it can. If not,
5344 it just sets SIG_IGN. To be on the safe side it also calls waitpid() at the end
5345 of the loop below. Paranoia rules.
5347 February 2003: That's *still* not the end of the story. There are now versions
5348 of Linux (where SIG_IGN does work) that are picky. If, having set SIG_IGN, a
5349 process then calls waitpid(), a grumble is written to the system log, because
5350 this is logically inconsistent. In other words, it doesn't like the paranoia.
5351 As a consequence of this, the waitpid() below is now excluded if we are sure
5352 that SIG_IGN works. */
5354 if (!synchronous_delivery)
5357 struct sigaction act;
5358 act.sa_handler = SIG_IGN;
5359 sigemptyset(&(act.sa_mask));
5360 act.sa_flags = SA_NOCLDWAIT;
5361 sigaction(SIGCHLD, &act, NULL);
5363 signal(SIGCHLD, SIG_IGN);
5367 /* Save the current store pool point, for resetting at the start of
5368 each message, and save the real sender address, if any. */
5370 reset_point = store_get(0);
5371 real_sender_address = sender_address;
5373 /* Loop to receive messages; receive_msg() returns TRUE if there are more
5374 messages to be read (SMTP input), or FALSE otherwise (not SMTP, or SMTP channel
5381 /* Handle the SMTP case; call smtp_setup_mst() to deal with the initial SMTP
5382 input and build the recipients list, before calling receive_msg() to read the
5383 message proper. Whatever sender address is given in the SMTP transaction is
5384 often ignored for local senders - we use the actual sender, which is normally
5385 either the underlying user running this process or a -f argument provided by
5386 a trusted caller. It is saved in real_sender_address. The test for whether to
5387 accept the SMTP sender is encapsulated in receive_check_set_sender(). */
5392 if ((rc = smtp_setup_msg()) > 0)
5394 if (real_sender_address != NULL &&
5395 !receive_check_set_sender(sender_address))
5397 sender_address = raw_sender = real_sender_address;
5398 sender_address_unrewritten = NULL;
5401 /* For batched SMTP, we have to run the acl_not_smtp_start ACL, since it
5402 isn't really SMTP, so no other ACL will run until the acl_not_smtp one at
5403 the very end. The result of the ACL is ignored (as for other non-SMTP
5404 messages). It is run for its potential side effects. */
5406 if (smtp_batched_input && acl_not_smtp_start != NULL)
5408 uschar *user_msg, *log_msg;
5409 enable_dollar_recipients = TRUE;
5410 (void)acl_check(ACL_WHERE_NOTSMTP_START, NULL, acl_not_smtp_start,
5411 &user_msg, &log_msg);
5412 enable_dollar_recipients = FALSE;
5415 /* Now get the data for the message */
5417 more = receive_msg(extract_recipients);
5418 if (message_id[0] == 0)
5420 cancel_cutthrough_connection(TRUE, US"receive dropped");
5421 if (more) goto moreloop;
5422 smtp_log_no_mail(); /* Log no mail if configured */
5423 exim_exit(EXIT_FAILURE, US"receive toplevel");
5428 cancel_cutthrough_connection(TRUE, US"message setup dropped");
5429 smtp_log_no_mail(); /* Log no mail if configured */
5430 exim_exit(rc ? EXIT_FAILURE : EXIT_SUCCESS, US"msg setup toplevel");
5434 /* In the non-SMTP case, we have all the information from the command
5435 line, but must process it in case it is in the more general RFC822
5436 format, and in any case, to detect syntax errors. Also, it appears that
5437 the use of comma-separated lists as single arguments is common, so we
5438 had better support them. */
5444 int count = argc - recipients_arg;
5445 uschar **list = argv + recipients_arg;
5447 /* These options cannot be changed dynamically for non-SMTP messages */
5449 active_local_sender_retain = local_sender_retain;
5450 active_local_from_check = local_from_check;
5452 /* Save before any rewriting */
5454 raw_sender = string_copy(sender_address);
5456 /* Loop for each argument */
5458 for (i = 0; i < count; i++)
5460 int start, end, domain;
5462 uschar *s = list[i];
5464 /* Loop for each comma-separated address */
5468 BOOL finished = FALSE;
5470 uschar *ss = parse_find_address_end(s, FALSE);
5472 if (*ss == ',') *ss = 0; else finished = TRUE;
5474 /* Check max recipients - if -t was used, these aren't recipients */
5476 if (recipients_max > 0 && ++rcount > recipients_max &&
5477 !extract_recipients)
5478 if (error_handling == ERRORS_STDERR)
5480 fprintf(stderr, "exim: too many recipients\n");
5481 exim_exit(EXIT_FAILURE, US"main");
5485 moan_to_sender(ERRMESS_TOOMANYRECIP, NULL, NULL, stdin, TRUE)?
5486 errors_sender_rc : EXIT_FAILURE;
5490 BOOL b = allow_utf8_domains;
5491 allow_utf8_domains = TRUE;
5494 parse_extract_address(s, &errmess, &start, &end, &domain, FALSE);
5497 if (string_is_utf8(recipient))
5498 message_smtputf8 = TRUE;
5500 allow_utf8_domains = b;
5503 if (domain == 0 && !allow_unqualified_recipient)
5506 errmess = US"unqualified recipient address not allowed";
5509 if (recipient == NULL)
5511 if (error_handling == ERRORS_STDERR)
5513 fprintf(stderr, "exim: bad recipient address \"%s\": %s\n",
5514 string_printing(list[i]), errmess);
5515 exim_exit(EXIT_FAILURE, US"main");
5521 eblock.text1 = string_printing(list[i]);
5522 eblock.text2 = errmess;
5524 moan_to_sender(ERRMESS_BADARGADDRESS, &eblock, NULL, stdin, TRUE)?
5525 errors_sender_rc : EXIT_FAILURE;
5529 receive_add_recipient(recipient, -1);
5532 while (*(++s) != 0 && (*s == ',' || isspace(*s)));
5536 /* Show the recipients when debugging */
5541 if (sender_address != NULL) debug_printf("Sender: %s\n", sender_address);
5542 if (recipients_list != NULL)
5544 debug_printf("Recipients:\n");
5545 for (i = 0; i < recipients_count; i++)
5546 debug_printf(" %s\n", recipients_list[i].address);
5550 /* Run the acl_not_smtp_start ACL if required. The result of the ACL is
5551 ignored; rejecting here would just add complication, and it can just as
5552 well be done later. Allow $recipients to be visible in the ACL. */
5554 if (acl_not_smtp_start)
5556 uschar *user_msg, *log_msg;
5557 enable_dollar_recipients = TRUE;
5558 (void)acl_check(ACL_WHERE_NOTSMTP_START, NULL, acl_not_smtp_start,
5559 &user_msg, &log_msg);
5560 enable_dollar_recipients = FALSE;
5563 /* Pause for a while waiting for input. If none received in that time,
5564 close the logfile, if we had one open; then if we wait for a long-running
5565 datasource (months, in one use-case) log rotation will not leave us holding
5568 if (!receive_timeout)
5570 struct timeval t = { .tv_sec = 30*60, .tv_usec = 0 }; /* 30 minutes */
5573 FD_ZERO(&r); FD_SET(0, &r);
5574 if (select(1, &r, NULL, NULL, &t) == 0) mainlog_close();
5577 /* Read the data for the message. If filter_test is not FTEST_NONE, this
5578 will just read the headers for the message, and not write anything onto the
5581 message_ended = END_NOTENDED;
5582 more = receive_msg(extract_recipients);
5584 /* more is always FALSE here (not SMTP message) when reading a message
5585 for real; when reading the headers of a message for filter testing,
5586 it is TRUE if the headers were terminated by '.' and FALSE otherwise. */
5588 if (message_id[0] == 0) exim_exit(EXIT_FAILURE, US"main");
5589 } /* Non-SMTP message reception */
5591 /* If this is a filter testing run, there are headers in store, but
5592 no message on the spool. Run the filtering code in testing mode, setting
5593 the domain to the qualify domain and the local part to the current user,
5594 unless they have been set by options. The prefix and suffix are left unset
5595 unless specified. The the return path is set to to the sender unless it has
5596 already been set from a return-path header in the message. */
5598 if (filter_test != FTEST_NONE)
5600 deliver_domain = (ftest_domain != NULL)?
5601 ftest_domain : qualify_domain_recipient;
5602 deliver_domain_orig = deliver_domain;
5603 deliver_localpart = (ftest_localpart != NULL)?
5604 ftest_localpart : originator_login;
5605 deliver_localpart_orig = deliver_localpart;
5606 deliver_localpart_prefix = ftest_prefix;
5607 deliver_localpart_suffix = ftest_suffix;
5608 deliver_home = originator_home;
5610 if (return_path == NULL)
5612 printf("Return-path copied from sender\n");
5613 return_path = string_copy(sender_address);
5616 printf("Return-path = %s\n", (return_path[0] == 0)? US"<>" : return_path);
5617 printf("Sender = %s\n", (sender_address[0] == 0)? US"<>" : sender_address);
5619 receive_add_recipient(
5620 string_sprintf("%s%s%s@%s",
5621 (ftest_prefix == NULL)? US"" : ftest_prefix,
5623 (ftest_suffix == NULL)? US"" : ftest_suffix,
5624 deliver_domain), -1);
5626 printf("Recipient = %s\n", recipients_list[0].address);
5627 if (ftest_prefix != NULL) printf("Prefix = %s\n", ftest_prefix);
5628 if (ftest_suffix != NULL) printf("Suffix = %s\n", ftest_suffix);
5630 if (chdir("/")) /* Get away from wherever the user is running this from */
5632 DEBUG(D_receive) debug_printf("chdir(\"/\") failed\n");
5633 exim_exit(EXIT_FAILURE, US"main");
5636 /* Now we run either a system filter test, or a user filter test, or both.
5637 In the latter case, headers added by the system filter will persist and be
5638 available to the user filter. We need to copy the filter variables
5641 if ((filter_test & FTEST_SYSTEM) != 0)
5642 if (!filter_runtest(filter_sfd, filter_test_sfile, TRUE, more))
5643 exim_exit(EXIT_FAILURE, US"main");
5645 memcpy(filter_sn, filter_n, sizeof(filter_sn));
5647 if ((filter_test & FTEST_USER) != 0)
5648 if (!filter_runtest(filter_ufd, filter_test_ufile, FALSE, more))
5649 exim_exit(EXIT_FAILURE, US"main");
5651 exim_exit(EXIT_SUCCESS, US"main");
5654 /* Else act on the result of message reception. We should not get here unless
5655 message_id[0] is non-zero. If queue_only is set, session_local_queue_only
5656 will be TRUE. If it is not, check on the number of messages received in this
5659 if (!session_local_queue_only &&
5660 smtp_accept_queue_per_connection > 0 &&
5661 receive_messagecount > smtp_accept_queue_per_connection)
5663 session_local_queue_only = TRUE;
5664 queue_only_reason = 2;
5667 /* Initialize local_queue_only from session_local_queue_only. If it is false,
5668 and queue_only_load is set, check that the load average is below it. If it is
5669 not, set local_queue_only TRUE. If queue_only_load_latch is true (the
5670 default), we put the whole session into queue_only mode. It then remains this
5671 way for any subsequent messages on the same SMTP connection. This is a
5672 deliberate choice; even though the load average may fall, it doesn't seem
5673 right to deliver later messages on the same call when not delivering earlier
5674 ones. However, there are odd cases where this is not wanted, so this can be
5675 changed by setting queue_only_load_latch false. */
5677 local_queue_only = session_local_queue_only;
5678 if (!local_queue_only && queue_only_load >= 0)
5680 local_queue_only = (load_average = OS_GETLOADAVG()) > queue_only_load;
5681 if (local_queue_only)
5683 queue_only_reason = 3;
5684 if (queue_only_load_latch) session_local_queue_only = TRUE;
5688 /* If running as an MUA wrapper, all queueing options and freezing options
5692 local_queue_only = queue_only_policy = deliver_freeze = FALSE;
5694 /* Log the queueing here, when it will get a message id attached, but
5695 not if queue_only is set (case 0). Case 1 doesn't happen here (too many
5698 if (local_queue_only)
5700 cancel_cutthrough_connection(TRUE, US"no delivery; queueing");
5701 switch(queue_only_reason)
5704 log_write(L_delay_delivery,
5705 LOG_MAIN, "no immediate delivery: more than %d messages "
5706 "received in one connection", smtp_accept_queue_per_connection);
5710 log_write(L_delay_delivery,
5711 LOG_MAIN, "no immediate delivery: load average %.2f",
5712 (double)load_average/1000.0);
5717 else if (queue_only_policy || deliver_freeze)
5718 cancel_cutthrough_connection(TRUE, US"no delivery; queueing");
5720 /* Else do the delivery unless the ACL or local_scan() called for queue only
5721 or froze the message. Always deliver in a separate process. A fork failure is
5722 not a disaster, as the delivery will eventually happen on a subsequent queue
5723 run. The search cache must be tidied before the fork, as the parent will
5724 do it before exiting. The child will trigger a lookup failure and
5725 thereby defer the delivery if it tries to use (for example) a cached ldap
5726 connection that the parent has called unbind on. */
5733 if ((pid = fork()) == 0)
5736 close_unwanted(); /* Close unwanted file descriptors and TLS */
5737 exim_nullstd(); /* Ensure std{in,out,err} exist */
5739 /* Re-exec Exim if we need to regain privilege (note: in mua_wrapper
5740 mode, deliver_drop_privilege is forced TRUE). */
5742 if (geteuid() != root_uid && !deliver_drop_privilege && !unprivileged)
5744 delivery_re_exec(CEE_EXEC_EXIT);
5745 /* Control does not return here. */
5748 /* No need to re-exec */
5750 rc = deliver_message(message_id, FALSE, FALSE);
5752 _exit((!mua_wrapper || rc == DELIVER_MUA_SUCCEEDED)?
5753 EXIT_SUCCESS : EXIT_FAILURE);
5758 cancel_cutthrough_connection(TRUE, US"delivery fork failed");
5759 log_write(0, LOG_MAIN|LOG_PANIC, "failed to fork automatic delivery "
5760 "process: %s", strerror(errno));
5764 release_cutthrough_connection(US"msg passed for delivery");
5766 /* In the parent, wait if synchronous delivery is required. This will
5767 always be the case in MUA wrapper mode. */
5769 if (synchronous_delivery)
5772 while (wait(&status) != pid);
5773 if ((status & 0x00ff) != 0)
5774 log_write(0, LOG_MAIN|LOG_PANIC,
5775 "process %d crashed with signal %d while delivering %s",
5776 (int)pid, status & 0x00ff, message_id);
5777 if (mua_wrapper && (status & 0xffff) != 0) exim_exit(EXIT_FAILURE, US"main");
5782 /* The loop will repeat if more is TRUE. If we do not know know that the OS
5783 automatically reaps children (see comments above the loop), clear away any
5784 finished subprocesses here, in case there are lots of messages coming in
5785 from the same source. */
5787 #ifndef SIG_IGN_WORKS
5788 while (waitpid(-1, NULL, WNOHANG) > 0);
5792 return_path = sender_address = NULL;
5793 authenticated_sender = NULL;
5794 deliver_localpart_orig = NULL;
5795 deliver_domain_orig = NULL;
5796 deliver_host = deliver_host_address = NULL;
5797 dnslist_domain = dnslist_matched = NULL;
5798 #ifdef WITH_CONTENT_SCAN
5799 malware_name = NULL;
5801 callout_address = NULL;
5802 sending_ip_address = NULL;
5804 { int i; for(i=0; i<REGEX_VARS; i++) regex_vars[i] = NULL; }
5806 store_reset(reset_point);
5809 exim_exit(EXIT_SUCCESS, US"main"); /* Never returns */
5810 return 0; /* To stop compiler warning */