1 /* $Cambridge: exim/src/src/exim.c,v 1.68 2010/06/06 02:08:50 pdp Exp $ */
3 /*************************************************
4 * Exim - an Internet mail transport agent *
5 *************************************************/
7 /* Copyright (c) University of Cambridge 1995 - 2009 */
8 /* See the file NOTICE for conditions of use and distribution. */
11 /* The main function: entry point, initialization, and high-level control.
12 Also a few functions that don't naturally fit elsewhere. */
19 /*************************************************
20 * Function interface to store functions *
21 *************************************************/
23 /* We need some real functions to pass to the PCRE regular expression library
24 for store allocation via Exim's store manager. The normal calls are actually
25 macros that pass over location information to make tracing easier. These
26 functions just interface to the standard macro calls. A good compiler will
27 optimize out the tail recursion and so not make them too expensive. There
28 are two sets of functions; one for use when we want to retain the compiled
29 regular expression for a long time; the other for short-term use. */
32 function_store_get(size_t size)
34 return store_get((int)size);
38 function_dummy_free(void *block) { block = block; }
41 function_store_malloc(size_t size)
43 return store_malloc((int)size);
47 function_store_free(void *block)
55 /*************************************************
56 * Compile regular expression and panic on fail *
57 *************************************************/
59 /* This function is called when failure to compile a regular expression leads
60 to a panic exit. In other cases, pcre_compile() is called directly. In many
61 cases where this function is used, the results of the compilation are to be
62 placed in long-lived store, so we temporarily reset the store management
63 functions that PCRE uses if the use_malloc flag is set.
66 pattern the pattern to compile
67 caseless TRUE if caseless matching is required
68 use_malloc TRUE if compile into malloc store
70 Returns: pointer to the compiled pattern
74 regex_must_compile(uschar *pattern, BOOL caseless, BOOL use_malloc)
77 int options = PCRE_COPT;
82 pcre_malloc = function_store_malloc;
83 pcre_free = function_store_free;
85 if (caseless) options |= PCRE_CASELESS;
86 yield = pcre_compile(CS pattern, options, (const char **)&error, &offset, NULL);
87 pcre_malloc = function_store_get;
88 pcre_free = function_dummy_free;
90 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "regular expression error: "
91 "%s at offset %d while compiling %s", error, offset, pattern);
98 /*************************************************
99 * Execute regular expression and set strings *
100 *************************************************/
102 /* This function runs a regular expression match, and sets up the pointers to
103 the matched substrings.
106 re the compiled expression
107 subject the subject string
108 options additional PCRE options
109 setup if < 0 do full setup
110 if >= 0 setup from setup+1 onwards,
111 excluding the full matched string
113 Returns: TRUE or FALSE
117 regex_match_and_setup(const pcre *re, uschar *subject, int options, int setup)
119 int ovector[3*(EXPAND_MAXN+1)];
120 int n = pcre_exec(re, NULL, CS subject, Ustrlen(subject), 0,
121 PCRE_EOPT | options, ovector, sizeof(ovector)/sizeof(int));
123 if (n == 0) n = EXPAND_MAXN + 1;
127 expand_nmax = (setup < 0)? 0 : setup + 1;
128 for (nn = (setup < 0)? 0 : 2; nn < n*2; nn += 2)
130 expand_nstring[expand_nmax] = subject + ovector[nn];
131 expand_nlength[expand_nmax++] = ovector[nn+1] - ovector[nn];
141 /*************************************************
142 * Handler for SIGUSR1 *
143 *************************************************/
145 /* SIGUSR1 causes any exim process to write to the process log details of
146 what it is currently doing. It will only be used if the OS is capable of
147 setting up a handler that causes automatic restarting of any system call
148 that is in progress at the time.
150 Argument: the signal number (SIGUSR1)
155 usr1_handler(int sig)
157 sig = sig; /* Keep picky compilers happy */
158 log_write(0, LOG_PROCESS, "%s", process_info);
160 os_restarting_signal(SIGUSR1, usr1_handler);
165 /*************************************************
167 *************************************************/
169 /* This handler is enabled most of the time that Exim is running. The handler
170 doesn't actually get used unless alarm() has been called to set a timer, to
171 place a time limit on a system call of some kind. When the handler is run, it
174 There are some other SIGALRM handlers that are used in special cases when more
175 than just a flag setting is required; for example, when reading a message's
176 input. These are normally set up in the code module that uses them, and the
177 SIGALRM handler is reset to this one afterwards.
179 Argument: the signal value (SIGALRM)
184 sigalrm_handler(int sig)
186 sig = sig; /* Keep picky compilers happy */
188 os_non_restarting_signal(SIGALRM, sigalrm_handler);
193 /*************************************************
194 * Sleep for a fractional time interval *
195 *************************************************/
197 /* This function is called by millisleep() and exim_wait_tick() to wait for a
198 period of time that may include a fraction of a second. The coding is somewhat
199 tedious. We do not expect setitimer() ever to fail, but if it does, the process
200 will wait for ever, so we panic in this instance. (There was a case of this
201 when a bug in a function that calls milliwait() caused it to pass invalid data.
202 That's when I added the check. :-)
204 Argument: an itimerval structure containing the interval
209 milliwait(struct itimerval *itval)
212 sigset_t old_sigmask;
213 (void)sigemptyset(&sigmask); /* Empty mask */
214 (void)sigaddset(&sigmask, SIGALRM); /* Add SIGALRM */
215 (void)sigprocmask(SIG_BLOCK, &sigmask, &old_sigmask); /* Block SIGALRM */
216 if (setitimer(ITIMER_REAL, itval, NULL) < 0) /* Start timer */
217 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
218 "setitimer() failed: %s", strerror(errno));
219 (void)sigfillset(&sigmask); /* All signals */
220 (void)sigdelset(&sigmask, SIGALRM); /* Remove SIGALRM */
221 (void)sigsuspend(&sigmask); /* Until SIGALRM */
222 (void)sigprocmask(SIG_SETMASK, &old_sigmask, NULL); /* Restore mask */
228 /*************************************************
229 * Millisecond sleep function *
230 *************************************************/
232 /* The basic sleep() function has a granularity of 1 second, which is too rough
233 in some cases - for example, when using an increasing delay to slow down
236 Argument: number of millseconds
243 struct itimerval itval;
244 itval.it_interval.tv_sec = 0;
245 itval.it_interval.tv_usec = 0;
246 itval.it_value.tv_sec = msec/1000;
247 itval.it_value.tv_usec = (msec % 1000) * 1000;
253 /*************************************************
254 * Compare microsecond times *
255 *************************************************/
262 Returns: -1, 0, or +1
266 exim_tvcmp(struct timeval *t1, struct timeval *t2)
268 if (t1->tv_sec > t2->tv_sec) return +1;
269 if (t1->tv_sec < t2->tv_sec) return -1;
270 if (t1->tv_usec > t2->tv_usec) return +1;
271 if (t1->tv_usec < t2->tv_usec) return -1;
278 /*************************************************
279 * Clock tick wait function *
280 *************************************************/
282 /* Exim uses a time + a pid to generate a unique identifier in two places: its
283 message IDs, and in file names for maildir deliveries. Because some OS now
284 re-use pids within the same second, sub-second times are now being used.
285 However, for absolute certaintly, we must ensure the clock has ticked before
286 allowing the relevant process to complete. At the time of implementation of
287 this code (February 2003), the speed of processors is such that the clock will
288 invariably have ticked already by the time a process has done its job. This
289 function prepares for the time when things are faster - and it also copes with
290 clocks that go backwards.
293 then_tv A timeval which was used to create uniqueness; its usec field
294 has been rounded down to the value of the resolution.
295 We want to be sure the current time is greater than this.
296 resolution The resolution that was used to divide the microseconds
297 (1 for maildir, larger for message ids)
303 exim_wait_tick(struct timeval *then_tv, int resolution)
305 struct timeval now_tv;
306 long int now_true_usec;
308 (void)gettimeofday(&now_tv, NULL);
309 now_true_usec = now_tv.tv_usec;
310 now_tv.tv_usec = (now_true_usec/resolution) * resolution;
312 if (exim_tvcmp(&now_tv, then_tv) <= 0)
314 struct itimerval itval;
315 itval.it_interval.tv_sec = 0;
316 itval.it_interval.tv_usec = 0;
317 itval.it_value.tv_sec = then_tv->tv_sec - now_tv.tv_sec;
318 itval.it_value.tv_usec = then_tv->tv_usec + resolution - now_true_usec;
320 /* We know that, overall, "now" is less than or equal to "then". Therefore, a
321 negative value for the microseconds is possible only in the case when "now"
322 is more than a second less than "then". That means that itval.it_value.tv_sec
323 is greater than zero. The following correction is therefore safe. */
325 if (itval.it_value.tv_usec < 0)
327 itval.it_value.tv_usec += 1000000;
328 itval.it_value.tv_sec -= 1;
331 DEBUG(D_transport|D_receive)
333 if (!running_in_test_harness)
335 debug_printf("tick check: %lu.%06lu %lu.%06lu\n",
336 then_tv->tv_sec, then_tv->tv_usec, now_tv.tv_sec, now_tv.tv_usec);
337 debug_printf("waiting %lu.%06lu\n", itval.it_value.tv_sec,
338 itval.it_value.tv_usec);
349 /*************************************************
350 * Set up processing details *
351 *************************************************/
353 /* Save a text string for dumping when SIGUSR1 is received.
354 Do checks for overruns.
356 Arguments: format and arguments, as for printf()
361 set_process_info(char *format, ...)
365 sprintf(CS process_info, "%5d ", (int)getpid());
366 len = Ustrlen(process_info);
367 va_start(ap, format);
368 if (!string_vformat(process_info + len, PROCESS_INFO_SIZE - len, format, ap))
369 Ustrcpy(process_info + len, "**** string overflowed buffer ****");
370 DEBUG(D_process_info) debug_printf("set_process_info: %s\n", process_info);
378 /*************************************************
379 * Call fopen() with umask 777 and adjust mode *
380 *************************************************/
382 /* Exim runs with umask(0) so that files created with open() have the mode that
383 is specified in the open() call. However, there are some files, typically in
384 the spool directory, that are created with fopen(). They end up world-writeable
385 if no precautions are taken. Although the spool directory is not accessible to
386 the world, this is an untidiness. So this is a wrapper function for fopen()
387 that sorts out the mode of the created file.
390 filename the file name
391 options the fopen() options
392 mode the required mode
394 Returns: the fopened FILE or NULL
398 modefopen(uschar *filename, char *options, mode_t mode)
400 mode_t saved_umask = umask(0777);
401 FILE *f = Ufopen(filename, options);
402 (void)umask(saved_umask);
403 if (f != NULL) (void)fchmod(fileno(f), mode);
410 /*************************************************
411 * Ensure stdin, stdout, and stderr exist *
412 *************************************************/
414 /* Some operating systems grumble if an exec() happens without a standard
415 input, output, and error (fds 0, 1, 2) being defined. The worry is that some
416 file will be opened and will use these fd values, and then some other bit of
417 code will assume, for example, that it can write error messages to stderr.
418 This function ensures that fds 0, 1, and 2 are open if they do not already
419 exist, by connecting them to /dev/null.
421 This function is also used to ensure that std{in,out,err} exist at all times,
422 so that if any library that Exim calls tries to use them, it doesn't crash.
434 for (i = 0; i <= 2; i++)
436 if (fstat(i, &statbuf) < 0 && errno == EBADF)
438 if (devnull < 0) devnull = open("/dev/null", O_RDWR);
439 if (devnull < 0) log_write(0, LOG_MAIN|LOG_PANIC_DIE, "%s",
440 string_open_failed(errno, "/dev/null"));
441 if (devnull != i) (void)dup2(devnull, i);
444 if (devnull > 2) (void)close(devnull);
450 /*************************************************
451 * Close unwanted file descriptors for delivery *
452 *************************************************/
454 /* This function is called from a new process that has been forked to deliver
455 an incoming message, either directly, or using exec.
457 We want any smtp input streams to be closed in this new process. However, it
458 has been observed that using fclose() here causes trouble. When reading in -bS
459 input, duplicate copies of messages have been seen. The files will be sharing a
460 file pointer with the parent process, and it seems that fclose() (at least on
461 some systems - I saw this on Solaris 2.5.1) messes with that file pointer, at
462 least sometimes. Hence we go for closing the underlying file descriptors.
464 If TLS is active, we want to shut down the TLS library, but without molesting
465 the parent's SSL connection.
467 For delivery of a non-SMTP message, we want to close stdin and stdout (and
468 stderr unless debugging) because the calling process might have set them up as
469 pipes and be waiting for them to close before it waits for the submission
470 process to terminate. If they aren't closed, they hold up the calling process
471 until the initial delivery process finishes, which is not what we want.
473 Exception: We do want it for synchronous delivery!
475 And notwithstanding all the above, if D_resolver is set, implying resolver
476 debugging, leave stdout open, because that's where the resolver writes its
479 When we close stderr (which implies we've also closed stdout), we also get rid
480 of any controlling terminal.
492 tls_close(FALSE); /* Shut down the TLS library */
494 (void)close(fileno(smtp_in));
495 (void)close(fileno(smtp_out));
500 (void)close(0); /* stdin */
501 if ((debug_selector & D_resolver) == 0) (void)close(1); /* stdout */
502 if (debug_selector == 0) /* stderr */
504 if (!synchronous_delivery)
517 /*************************************************
519 *************************************************/
521 /* This function sets a new uid and gid permanently, optionally calling
522 initgroups() to set auxiliary groups. There are some special cases when running
523 Exim in unprivileged modes. In these situations the effective uid will not be
524 root; if we already have the right effective uid/gid, and don't need to
525 initialize any groups, leave things as they are.
530 igflag TRUE if initgroups() wanted
531 msg text to use in debugging output and failure log
533 Returns: nothing; bombs out on failure
537 exim_setugid(uid_t uid, gid_t gid, BOOL igflag, uschar *msg)
539 uid_t euid = geteuid();
540 gid_t egid = getegid();
542 if (euid == root_uid || euid != uid || egid != gid || igflag)
544 /* At least one OS returns +1 for initgroups failure, so just check for
549 struct passwd *pw = getpwuid(uid);
552 if (initgroups(pw->pw_name, gid) != 0)
553 log_write(0,LOG_MAIN|LOG_PANIC_DIE,"initgroups failed for uid=%ld: %s",
554 (long int)uid, strerror(errno));
556 else log_write(0, LOG_MAIN|LOG_PANIC_DIE, "cannot run initgroups(): "
557 "no passwd entry for uid=%ld", (long int)uid);
560 if (setgid(gid) < 0 || setuid(uid) < 0)
562 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "unable to set gid=%ld or uid=%ld "
563 "(euid=%ld): %s", (long int)gid, (long int)uid, (long int)euid, msg);
567 /* Debugging output included uid/gid and all groups */
572 gid_t group_list[NGROUPS_MAX];
573 debug_printf("changed uid/gid: %s\n uid=%ld gid=%ld pid=%ld\n", msg,
574 (long int)geteuid(), (long int)getegid(), (long int)getpid());
575 group_count = getgroups(NGROUPS_MAX, group_list);
576 debug_printf(" auxiliary group list:");
580 for (i = 0; i < group_count; i++) debug_printf(" %d", (int)group_list[i]);
582 else debug_printf(" <none>");
590 /*************************************************
592 *************************************************/
594 /* Exim exits via this function so that it always clears up any open
600 Returns: does not return
608 debug_printf(">>>>>>>>>>>>>>>> Exim pid=%d terminating with rc=%d "
609 ">>>>>>>>>>>>>>>>\n", (int)getpid(), rc);
616 /*************************************************
617 * Extract port from host address *
618 *************************************************/
620 /* Called to extract the port from the values given to -oMa and -oMi.
621 It also checks the syntax of the address, and terminates it before the
622 port data when a port is extracted.
625 address the address, with possible port on the end
627 Returns: the port, or zero if there isn't one
628 bombs out on a syntax error
632 check_port(uschar *address)
634 int port = host_address_extract_port(address);
635 if (string_is_ip_address(address, NULL) == 0)
637 fprintf(stderr, "exim abandoned: \"%s\" is not an IP address\n", address);
645 /*************************************************
646 * Test/verify an address *
647 *************************************************/
649 /* This function is called by the -bv and -bt code. It extracts a working
650 address from a full RFC 822 address. This isn't really necessary per se, but it
651 has the effect of collapsing source routes.
655 flags flag bits for verify_address()
656 exit_value to be set for failures
662 test_address(uschar *s, int flags, int *exit_value)
664 int start, end, domain;
665 uschar *parse_error = NULL;
666 uschar *address = parse_extract_address(s, &parse_error, &start, &end, &domain,
670 fprintf(stdout, "syntax error: %s\n", parse_error);
675 int rc = verify_address(deliver_make_addr(address,TRUE), stdout, flags, -1,
676 -1, -1, NULL, NULL, NULL);
677 if (rc == FAIL) *exit_value = 2;
678 else if (rc == DEFER && *exit_value == 0) *exit_value = 1;
684 /*************************************************
685 * Show supported features *
686 *************************************************/
688 /* This function is called for -bV/--version and for -d to output the optional
689 features of the current Exim binary.
691 Arguments: a FILE for printing
696 show_whats_supported(FILE *f)
698 #ifdef DB_VERSION_STRING
699 fprintf(f, "Berkeley DB: %s\n", DB_VERSION_STRING);
700 #elif defined(BTREEVERSION) && defined(HASHVERSION)
702 fprintf(f, "Probably Berkeley DB version 1.8x (native mode)\n");
704 fprintf(f, "Probably Berkeley DB version 1.8x (compatibility mode)\n");
706 #elif defined(_DBM_RDONLY) || defined(dbm_dirfno)
707 fprintf(f, "Probably ndbm\n");
708 #elif defined(USE_TDB)
709 fprintf(f, "Using tdb\n");
712 fprintf(f, "Probably GDBM (native mode)\n");
714 fprintf(f, "Probably GDBM (compatibility mode)\n");
718 fprintf(f, "Support for:");
719 #ifdef SUPPORT_CRYPTEQ
720 fprintf(f, " crypteq");
723 fprintf(f, " iconv()");
728 #ifdef HAVE_SETCLASSRESOURCES
729 fprintf(f, " use_setclassresources");
738 fprintf(f, " Expand_dlfunc");
740 #ifdef USE_TCP_WRAPPERS
741 fprintf(f, " TCPwrappers");
745 fprintf(f, " GnuTLS");
747 fprintf(f, " OpenSSL");
750 #ifdef SUPPORT_TRANSLATE_IP_ADDRESS
751 fprintf(f, " translate_ip_address");
753 #ifdef SUPPORT_MOVE_FROZEN_MESSAGES
754 fprintf(f, " move_frozen_messages");
756 #ifdef WITH_CONTENT_SCAN
757 fprintf(f, " Content_Scanning");
762 #ifdef WITH_OLD_DEMIME
763 fprintf(f, " Old_Demime");
765 #ifdef EXPERIMENTAL_SPF
766 fprintf(f, " Experimental_SPF");
768 #ifdef EXPERIMENTAL_SRS
769 fprintf(f, " Experimental_SRS");
771 #ifdef EXPERIMENTAL_BRIGHTMAIL
772 fprintf(f, " Experimental_Brightmail");
774 #ifdef EXPERIMENTAL_DCC
775 fprintf(f, " Experimental_DCC");
779 fprintf(f, "Lookups:");
780 #ifdef LOOKUP_LSEARCH
781 fprintf(f, " lsearch wildlsearch nwildlsearch iplsearch");
787 fprintf(f, " dbm dbmnz");
790 fprintf(f, " dnsdb");
792 #ifdef LOOKUP_DSEARCH
793 fprintf(f, " dsearch");
796 fprintf(f, " ibase");
799 fprintf(f, " ldap ldapdn ldapm");
802 fprintf(f, " mysql");
805 fprintf(f, " nis nis0");
807 #ifdef LOOKUP_NISPLUS
808 fprintf(f, " nisplus");
811 fprintf(f, " oracle");
814 fprintf(f, " passwd");
817 fprintf(f, " pgsql");
820 fprintf(f, " sqlite");
823 fprintf(f, " testdb");
826 fprintf(f, " whoson");
830 fprintf(f, "Authenticators:");
832 fprintf(f, " cram_md5");
834 #ifdef AUTH_CYRUS_SASL
835 fprintf(f, " cyrus_sasl");
838 fprintf(f, " dovecot");
840 #ifdef AUTH_PLAINTEXT
841 fprintf(f, " plaintext");
848 fprintf(f, "Routers:");
850 fprintf(f, " accept");
852 #ifdef ROUTER_DNSLOOKUP
853 fprintf(f, " dnslookup");
855 #ifdef ROUTER_IPLITERAL
856 fprintf(f, " ipliteral");
858 #ifdef ROUTER_IPLOOKUP
859 fprintf(f, " iplookup");
861 #ifdef ROUTER_MANUALROUTE
862 fprintf(f, " manualroute");
864 #ifdef ROUTER_QUERYPROGRAM
865 fprintf(f, " queryprogram");
867 #ifdef ROUTER_REDIRECT
868 fprintf(f, " redirect");
872 fprintf(f, "Transports:");
873 #ifdef TRANSPORT_APPENDFILE
874 fprintf(f, " appendfile");
875 #ifdef SUPPORT_MAILDIR
876 fprintf(f, "/maildir");
878 #ifdef SUPPORT_MAILSTORE
879 fprintf(f, "/mailstore");
885 #ifdef TRANSPORT_AUTOREPLY
886 fprintf(f, " autoreply");
888 #ifdef TRANSPORT_LMTP
891 #ifdef TRANSPORT_PIPE
894 #ifdef TRANSPORT_SMTP
899 if (fixed_never_users[0] > 0)
902 fprintf(f, "Fixed never_users: ");
903 for (i = 1; i <= (int)fixed_never_users[0] - 1; i++)
904 fprintf(f, "%d:", (unsigned int)fixed_never_users[i]);
905 fprintf(f, "%d\n", (unsigned int)fixed_never_users[i]);
908 fprintf(f, "Size of off_t: %d\n", sizeof(off_t));
910 /* This runtime check is to help diagnose library linkage mismatches which
911 result in segfaults and the like; as such, it's left until the end,
912 just in case. There will still be a "Configuration file is" line still to
915 tls_version_report(f);
922 /*************************************************
923 * Quote a local part *
924 *************************************************/
926 /* This function is used when a sender address or a From: or Sender: header
927 line is being created from the caller's login, or from an authenticated_id. It
928 applies appropriate quoting rules for a local part.
930 Argument: the local part
931 Returns: the local part, quoted if necessary
935 local_part_quote(uschar *lpart)
937 BOOL needs_quote = FALSE;
942 for (t = lpart; !needs_quote && *t != 0; t++)
944 needs_quote = !isalnum(*t) && strchr("!#$%&'*+-/=?^_`{|}~", *t) == NULL &&
945 (*t != '.' || t == lpart || t[1] == 0);
948 if (!needs_quote) return lpart;
951 yield = string_cat(NULL, &size, &ptr, US"\"", 1);
955 uschar *nq = US Ustrpbrk(lpart, "\\\"");
958 yield = string_cat(yield, &size, &ptr, lpart, Ustrlen(lpart));
961 yield = string_cat(yield, &size, &ptr, lpart, nq - lpart);
962 yield = string_cat(yield, &size, &ptr, US"\\", 1);
963 yield = string_cat(yield, &size, &ptr, nq, 1);
967 yield = string_cat(yield, &size, &ptr, US"\"", 1);
975 /*************************************************
976 * Load readline() functions *
977 *************************************************/
979 /* This function is called from testing executions that read data from stdin,
980 but only when running as the calling user. Currently, only -be does this. The
981 function loads the readline() function library and passes back the functions.
982 On some systems, it needs the curses library, so load that too, but try without
983 it if loading fails. All this functionality has to be requested at build time.
986 fn_readline_ptr pointer to where to put the readline pointer
987 fn_addhist_ptr pointer to where to put the addhistory function
989 Returns: the dlopen handle or NULL on failure
993 set_readline(char * (**fn_readline_ptr)(char *),
994 char * (**fn_addhist_ptr)(char *))
997 void *dlhandle_curses = dlopen("libcurses.so", RTLD_GLOBAL|RTLD_LAZY);
999 dlhandle = dlopen("libreadline.so", RTLD_GLOBAL|RTLD_NOW);
1000 if (dlhandle_curses != NULL) dlclose(dlhandle_curses);
1002 if (dlhandle != NULL)
1004 *fn_readline_ptr = (char *(*)(char*))dlsym(dlhandle, "readline");
1005 *fn_addhist_ptr = (char *(*)(char*))dlsym(dlhandle, "add_history");
1009 DEBUG(D_any) debug_printf("failed to load readline: %s\n", dlerror());
1018 /*************************************************
1019 * Get a line from stdin for testing things *
1020 *************************************************/
1022 /* This function is called when running tests that can take a number of lines
1023 of input (for example, -be and -bt). It handles continuations and trailing
1024 spaces. And prompting and a blank line output on eof. If readline() is in use,
1025 the arguments are non-NULL and provide the relevant functions.
1028 fn_readline readline function or NULL
1029 fn_addhist addhist function or NULL
1031 Returns: pointer to dynamic memory, or NULL at end of file
1035 get_stdinput(char *(*fn_readline)(char *), char *(*fn_addhist)(char *))
1040 uschar *yield = NULL;
1042 if (fn_readline == NULL) { printf("> "); fflush(stdout); }
1046 uschar buffer[1024];
1050 char *readline_line = NULL;
1051 if (fn_readline != NULL)
1053 if ((readline_line = fn_readline((i > 0)? "":"> ")) == NULL) break;
1054 if (*readline_line != 0 && fn_addhist != NULL) fn_addhist(readline_line);
1055 p = US readline_line;
1060 /* readline() not in use */
1063 if (Ufgets(buffer, sizeof(buffer), stdin) == NULL) break;
1067 /* Handle the line */
1069 ss = p + (int)Ustrlen(p);
1070 while (ss > p && isspace(ss[-1])) ss--;
1074 while (p < ss && isspace(*p)) p++; /* leading space after cont */
1077 yield = string_cat(yield, &size, &ptr, p, ss - p);
1080 if (fn_readline != NULL) free(readline_line);
1083 if (ss == p || yield[ptr-1] != '\\')
1091 if (yield == NULL) printf("\n");
1097 /*************************************************
1098 * Output usage information for the program *
1099 *************************************************/
1101 /* This function is called when there are no recipients
1102 or a specific --help argument was added.
1105 progname information on what name we were called by
1107 Returns: DOES NOT RETURN
1111 exim_usage(uschar *progname)
1114 /* Handle specific program invocation varients */
1115 if (Ustrcmp(progname, US"-mailq") == 0)
1118 "mailq - list the contents of the mail queue\n\n"
1119 "For a list of options, see the Exim documentation.\n");
1123 /* Generic usage - we output this whatever happens */
1125 "Exim is a Mail Transfer Agent. It is normally called by Mail User Agents,\n"
1126 "not directly from a shell command line. Options and/or arguments control\n"
1127 "what it does when called. For a list of options, see the Exim documentation.\n");
1134 /*************************************************
1135 * Entry point and high-level code *
1136 *************************************************/
1138 /* Entry point for the Exim mailer. Analyse the arguments and arrange to take
1139 the appropriate action. All the necessary functions are present in the one
1140 binary. I originally thought one should split it up, but it turns out that so
1141 much of the apparatus is needed in each chunk that one might as well just have
1142 it all available all the time, which then makes the coding easier as well.
1145 argc count of entries in argv
1146 argv argument strings, with argv[0] being the program name
1148 Returns: EXIT_SUCCESS if terminated successfully
1149 EXIT_FAILURE otherwise, except when a message has been sent
1150 to the sender, and -oee was given
1154 main(int argc, char **cargv)
1156 uschar **argv = USS cargv;
1157 int arg_receive_timeout = -1;
1158 int arg_smtp_receive_timeout = -1;
1159 int arg_error_handling = error_handling;
1160 int filter_sfd = -1;
1161 int filter_ufd = -1;
1164 int list_queue_option = 0;
1166 int msg_action_arg = -1;
1167 int namelen = (argv[0] == NULL)? 0 : Ustrlen(argv[0]);
1168 int queue_only_reason = 0;
1170 int perl_start_option = 0;
1172 int recipients_arg = argc;
1173 int sender_address_domain = 0;
1174 int test_retry_arg = -1;
1175 int test_rewrite_arg = -1;
1176 BOOL arg_queue_only = FALSE;
1177 BOOL bi_option = FALSE;
1178 BOOL checking = FALSE;
1179 BOOL count_queue = FALSE;
1180 BOOL expansion_test = FALSE;
1181 BOOL extract_recipients = FALSE;
1182 BOOL forced_delivery = FALSE;
1183 BOOL f_end_dot = FALSE;
1184 BOOL deliver_give_up = FALSE;
1185 BOOL list_queue = FALSE;
1186 BOOL list_options = FALSE;
1187 BOOL local_queue_only;
1189 BOOL one_msg_action = FALSE;
1190 BOOL queue_only_set = FALSE;
1191 BOOL receiving_message = TRUE;
1192 BOOL sender_ident_set = FALSE;
1193 BOOL session_local_queue_only;
1195 BOOL removed_privilege = FALSE;
1196 BOOL usage_wanted = FALSE;
1197 BOOL verify_address_mode = FALSE;
1198 BOOL verify_as_sender = FALSE;
1199 BOOL version_printed = FALSE;
1200 uschar *alias_arg = NULL;
1201 uschar *called_as = US"";
1202 uschar *start_queue_run_id = NULL;
1203 uschar *stop_queue_run_id = NULL;
1204 uschar *expansion_test_message = NULL;
1205 uschar *ftest_domain = NULL;
1206 uschar *ftest_localpart = NULL;
1207 uschar *ftest_prefix = NULL;
1208 uschar *ftest_suffix = NULL;
1209 uschar *malware_test_file = NULL;
1210 uschar *real_sender_address;
1211 uschar *originator_home = US"/";
1215 struct stat statbuf;
1216 pid_t passed_qr_pid = (pid_t)0;
1217 int passed_qr_pipe = -1;
1218 gid_t group_list[NGROUPS_MAX];
1220 /* Possible options for -R and -S */
1222 static uschar *rsopts[] = { US"f", US"ff", US"r", US"rf", US"rff" };
1224 /* Need to define this in case we need to change the environment in order
1225 to get rid of a bogus time zone. We have to make it char rather than uschar
1226 because some OS define it in /usr/include/unistd.h. */
1228 extern char **environ;
1230 /* If the Exim user and/or group and/or the configuration file owner/group were
1231 defined by ref:name at build time, we must now find the actual uid/gid values.
1232 This is a feature to make the lives of binary distributors easier. */
1234 #ifdef EXIM_USERNAME
1235 if (route_finduser(US EXIM_USERNAME, &pw, &exim_uid))
1237 exim_gid = pw->pw_gid;
1241 fprintf(stderr, "exim: failed to find uid for user name \"%s\"\n",
1247 #ifdef EXIM_GROUPNAME
1248 if (!route_findgroup(US EXIM_GROUPNAME, &exim_gid))
1250 fprintf(stderr, "exim: failed to find gid for group name \"%s\"\n",
1256 #ifdef CONFIGURE_OWNERNAME
1257 if (!route_finduser(US CONFIGURE_OWNERNAME, NULL, &config_uid))
1259 fprintf(stderr, "exim: failed to find uid for user name \"%s\"\n",
1260 CONFIGURE_OWNERNAME);
1265 #ifdef CONFIGURE_GROUPNAME
1266 if (!route_findgroup(US CONFIGURE_GROUPNAME, &config_gid))
1268 fprintf(stderr, "exim: failed to find gid for group name \"%s\"\n",
1269 CONFIGURE_GROUPNAME);
1274 /* In the Cygwin environment, some initialization needs doing. It is fudged
1275 in by means of this macro. */
1281 /* Check a field which is patched when we are running Exim within its
1282 testing harness; do a fast initial check, and then the whole thing. */
1284 running_in_test_harness =
1285 *running_status == '<' && Ustrcmp(running_status, "<<<testing>>>") == 0;
1287 /* The C standard says that the equivalent of setlocale(LC_ALL, "C") is obeyed
1288 at the start of a program; however, it seems that some environments do not
1289 follow this. A "strange" locale can affect the formatting of timestamps, so we
1292 setlocale(LC_ALL, "C");
1294 /* Set up the default handler for timing using alarm(). */
1296 os_non_restarting_signal(SIGALRM, sigalrm_handler);
1298 /* Ensure we have a buffer for constructing log entries. Use malloc directly,
1299 because store_malloc writes a log entry on failure. */
1301 log_buffer = (uschar *)malloc(LOG_BUFFER_SIZE);
1302 if (log_buffer == NULL)
1304 fprintf(stderr, "exim: failed to get store for log buffer\n");
1308 /* Set log_stderr to stderr, provided that stderr exists. This gets reset to
1309 NULL when the daemon is run and the file is closed. We have to use this
1310 indirection, because some systems don't allow writing to the variable "stderr".
1313 if (fstat(fileno(stderr), &statbuf) >= 0) log_stderr = stderr;
1315 /* Arrange for the PCRE regex library to use our store functions. Note that
1316 the normal calls are actually macros that add additional arguments for
1317 debugging purposes so we have to assign specially constructed functions here.
1318 The default is to use store in the stacking pool, but this is overridden in the
1319 regex_must_compile() function. */
1321 pcre_malloc = function_store_get;
1322 pcre_free = function_dummy_free;
1324 /* Ensure there is a big buffer for temporary use in several places. It is put
1325 in malloc store so that it can be freed for enlargement if necessary. */
1327 big_buffer = store_malloc(big_buffer_size);
1329 /* Set up the handler for the data request signal, and set the initial
1330 descriptive text. */
1332 set_process_info("initializing");
1333 os_restarting_signal(SIGUSR1, usr1_handler);
1335 /* SIGHUP is used to get the daemon to reconfigure. It gets set as appropriate
1336 in the daemon code. For the rest of Exim's uses, we ignore it. */
1338 signal(SIGHUP, SIG_IGN);
1340 /* We don't want to die on pipe errors as the code is written to handle
1341 the write error instead. */
1343 signal(SIGPIPE, SIG_IGN);
1345 /* Under some circumstance on some OS, Exim can get called with SIGCHLD
1346 set to SIG_IGN. This causes subprocesses that complete before the parent
1347 process waits for them not to hang around, so when Exim calls wait(), nothing
1348 is there. The wait() code has been made robust against this, but let's ensure
1349 that SIGCHLD is set to SIG_DFL, because it's tidier to wait and get a process
1350 ending status. We use sigaction rather than plain signal() on those OS where
1351 SA_NOCLDWAIT exists, because we want to be sure it is turned off. (There was a
1352 problem on AIX with this.) */
1356 struct sigaction act;
1357 act.sa_handler = SIG_DFL;
1358 sigemptyset(&(act.sa_mask));
1360 sigaction(SIGCHLD, &act, NULL);
1363 signal(SIGCHLD, SIG_DFL);
1366 /* Save the arguments for use if we re-exec exim as a daemon after receiving
1371 /* Set up the version number. Set up the leading 'E' for the external form of
1372 message ids, set the pointer to the internal form, and initialize it to
1373 indicate no message being processed. */
1376 message_id_option[0] = '-';
1377 message_id_external = message_id_option + 1;
1378 message_id_external[0] = 'E';
1379 message_id = message_id_external + 1;
1382 /* Set the umask to zero so that any files Exim creates using open() are
1383 created with the modes that it specifies. NOTE: Files created with fopen() have
1384 a problem, which was not recognized till rather late (February 2006). With this
1385 umask, such files will be world writeable. (They are all content scanning files
1386 in the spool directory, which isn't world-accessible, so this is not a
1387 disaster, but it's untidy.) I don't want to change this overall setting,
1388 however, because it will interact badly with the open() calls. Instead, there's
1389 now a function called modefopen() that fiddles with the umask while calling
1394 /* Precompile the regular expression for matching a message id. Keep this in
1395 step with the code that generates ids in the accept.c module. We need to do
1396 this here, because the -M options check their arguments for syntactic validity
1397 using mac_ismsgid, which uses this. */
1400 regex_must_compile(US"^(?:[^\\W_]{6}-){2}[^\\W_]{2}$", FALSE, TRUE);
1402 /* Precompile the regular expression that is used for matching an SMTP error
1403 code, possibly extended, at the start of an error message. Note that the
1404 terminating whitespace character is included. */
1407 regex_must_compile(US"^\\d\\d\\d\\s(?:\\d\\.\\d\\d?\\d?\\.\\d\\d?\\d?\\s)?",
1410 /* If the program is called as "mailq" treat it as equivalent to "exim -bp";
1411 this seems to be a generally accepted convention, since one finds symbolic
1412 links called "mailq" in standard OS configurations. */
1414 if ((namelen == 5 && Ustrcmp(argv[0], "mailq") == 0) ||
1415 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/mailq", 6) == 0))
1418 receiving_message = FALSE;
1419 called_as = US"-mailq";
1422 /* If the program is called as "rmail" treat it as equivalent to
1423 "exim -i -oee", thus allowing UUCP messages to be input using non-SMTP mode,
1424 i.e. preventing a single dot on a line from terminating the message, and
1425 returning with zero return code, even in cases of error (provided an error
1426 message has been sent). */
1428 if ((namelen == 5 && Ustrcmp(argv[0], "rmail") == 0) ||
1429 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/rmail", 6) == 0))
1432 called_as = US"-rmail";
1433 errors_sender_rc = EXIT_SUCCESS;
1436 /* If the program is called as "rsmtp" treat it as equivalent to "exim -bS";
1437 this is a smail convention. */
1439 if ((namelen == 5 && Ustrcmp(argv[0], "rsmtp") == 0) ||
1440 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/rsmtp", 6) == 0))
1442 smtp_input = smtp_batched_input = TRUE;
1443 called_as = US"-rsmtp";
1446 /* If the program is called as "runq" treat it as equivalent to "exim -q";
1447 this is a smail convention. */
1449 if ((namelen == 4 && Ustrcmp(argv[0], "runq") == 0) ||
1450 (namelen > 4 && Ustrncmp(argv[0] + namelen - 5, "/runq", 5) == 0))
1453 receiving_message = FALSE;
1454 called_as = US"-runq";
1457 /* If the program is called as "newaliases" treat it as equivalent to
1458 "exim -bi"; this is a sendmail convention. */
1460 if ((namelen == 10 && Ustrcmp(argv[0], "newaliases") == 0) ||
1461 (namelen > 10 && Ustrncmp(argv[0] + namelen - 11, "/newaliases", 11) == 0))
1464 receiving_message = FALSE;
1465 called_as = US"-newaliases";
1468 /* Save the original effective uid for a couple of uses later. It should
1469 normally be root, but in some esoteric environments it may not be. */
1471 original_euid = geteuid();
1473 /* Get the real uid and gid. If the caller is root, force the effective uid/gid
1474 to be the same as the real ones. This makes a difference only if Exim is setuid
1475 (or setgid) to something other than root, which could be the case in some
1476 special configurations. */
1478 real_uid = getuid();
1479 real_gid = getgid();
1481 if (real_uid == root_uid)
1487 /* If neither the original real uid nor the original euid was root, Exim is
1488 running in an unprivileged state. */
1490 unprivileged = (real_uid != root_uid && original_euid != root_uid);
1492 /* Scan the program's arguments. Some can be dealt with right away; others are
1493 simply recorded for checking and handling afterwards. Do a high-level switch
1494 on the second character (the one after '-'), to save some effort. */
1496 for (i = 1; i < argc; i++)
1498 BOOL badarg = FALSE;
1499 uschar *arg = argv[i];
1503 /* An argument not starting with '-' is the start of a recipients list;
1504 break out of the options-scanning loop. */
1512 /* An option consistion of -- terminates the options */
1514 if (Ustrcmp(arg, "--") == 0)
1516 recipients_arg = i + 1;
1520 /* Handle flagged options */
1522 switchchar = arg[1];
1525 /* Make all -ex options synonymous with -oex arguments, since that
1526 is assumed by various callers. Also make -qR options synonymous with -R
1527 options, as that seems to be required as well. Allow for -qqR too, and
1528 the same for -S options. */
1530 if (Ustrncmp(arg+1, "oe", 2) == 0 ||
1531 Ustrncmp(arg+1, "qR", 2) == 0 ||
1532 Ustrncmp(arg+1, "qS", 2) == 0)
1534 switchchar = arg[2];
1537 else if (Ustrncmp(arg+1, "qqR", 3) == 0 || Ustrncmp(arg+1, "qqS", 3) == 0)
1539 switchchar = arg[3];
1541 queue_2stage = TRUE;
1544 /* Make -r synonymous with -f, since it is a documented alias */
1546 else if (arg[1] == 'r') switchchar = 'f';
1548 /* Make -ov synonymous with -v */
1550 else if (Ustrcmp(arg, "-ov") == 0)
1556 /* deal with --option_aliases */
1557 else if (switchchar == '-')
1559 if (Ustrcmp(argrest, "help") == 0)
1561 usage_wanted = TRUE;
1564 else if (Ustrcmp(argrest, "version") == 0)
1571 /* High-level switch on active initial letter */
1575 /* -Btype is a sendmail option for 7bit/8bit setting. Exim is 8-bit clean
1576 so has no need of it. */
1579 if (*argrest == 0) i++; /* Skip over the type */
1584 receiving_message = FALSE; /* Reset TRUE for -bm, -bS, -bs below */
1586 /* -bd: Run in daemon mode, awaiting SMTP connections.
1587 -bdf: Ditto, but in the foreground.
1590 if (*argrest == 'd')
1592 daemon_listen = TRUE;
1593 if (*(++argrest) == 'f') background_daemon = FALSE;
1594 else if (*argrest != 0) { badarg = TRUE; break; }
1597 /* -be: Run in expansion test mode
1598 -bem: Ditto, but read a message from a file first
1601 else if (*argrest == 'e')
1603 expansion_test = checking = TRUE;
1604 if (argrest[1] == 'm')
1606 if (++i >= argc) { badarg = TRUE; break; }
1607 expansion_test_message = argv[i];
1610 if (argrest[1] != 0) { badarg = TRUE; break; }
1613 /* -bF: Run system filter test */
1615 else if (*argrest == 'F')
1617 filter_test |= FTEST_SYSTEM;
1618 if (*(++argrest) != 0) { badarg = TRUE; break; }
1619 if (++i < argc) filter_test_sfile = argv[i]; else
1621 fprintf(stderr, "exim: file name expected after %s\n", argv[i-1]);
1626 /* -bf: Run user filter test
1627 -bfd: Set domain for filter testing
1628 -bfl: Set local part for filter testing
1629 -bfp: Set prefix for filter testing
1630 -bfs: Set suffix for filter testing
1633 else if (*argrest == 'f')
1635 if (*(++argrest) == 0)
1637 filter_test |= FTEST_USER;
1638 if (++i < argc) filter_test_ufile = argv[i]; else
1640 fprintf(stderr, "exim: file name expected after %s\n", argv[i-1]);
1648 fprintf(stderr, "exim: string expected after %s\n", arg);
1651 if (Ustrcmp(argrest, "d") == 0) ftest_domain = argv[i];
1652 else if (Ustrcmp(argrest, "l") == 0) ftest_localpart = argv[i];
1653 else if (Ustrcmp(argrest, "p") == 0) ftest_prefix = argv[i];
1654 else if (Ustrcmp(argrest, "s") == 0) ftest_suffix = argv[i];
1655 else { badarg = TRUE; break; }
1659 /* -bh: Host checking - an IP address must follow. */
1661 else if (Ustrcmp(argrest, "h") == 0 || Ustrcmp(argrest, "hc") == 0)
1663 if (++i >= argc) { badarg = TRUE; break; }
1664 sender_host_address = argv[i];
1665 host_checking = checking = log_testing_mode = TRUE;
1666 host_checking_callout = argrest[1] == 'c';
1669 /* -bi: This option is used by sendmail to initialize *the* alias file,
1670 though it has the -oA option to specify a different file. Exim has no
1671 concept of *the* alias file, but since Sun's YP make script calls
1672 sendmail this way, some support must be provided. */
1674 else if (Ustrcmp(argrest, "i") == 0) bi_option = TRUE;
1676 /* -bm: Accept and deliver message - the default option. Reinstate
1677 receiving_message, which got turned off for all -b options. */
1679 else if (Ustrcmp(argrest, "m") == 0) receiving_message = TRUE;
1681 /* -bmalware: test the filename given for malware */
1683 else if (Ustrcmp(argrest, "malware") == 0)
1685 if (++i >= argc) { badarg = TRUE; break; }
1686 malware_test_file = argv[i];
1689 /* -bnq: For locally originating messages, do not qualify unqualified
1690 addresses. In the envelope, this causes errors; in header lines they
1693 else if (Ustrcmp(argrest, "nq") == 0)
1695 allow_unqualified_sender = FALSE;
1696 allow_unqualified_recipient = FALSE;
1699 /* -bpxx: List the contents of the mail queue, in various forms. If
1700 the option is -bpc, just a queue count is needed. Otherwise, if the
1701 first letter after p is r, then order is random. */
1703 else if (*argrest == 'p')
1705 if (*(++argrest) == 'c')
1708 if (*(++argrest) != 0) badarg = TRUE;
1712 if (*argrest == 'r')
1714 list_queue_option = 8;
1717 else list_queue_option = 0;
1721 /* -bp: List the contents of the mail queue, top-level only */
1723 if (*argrest == 0) {}
1725 /* -bpu: List the contents of the mail queue, top-level undelivered */
1727 else if (Ustrcmp(argrest, "u") == 0) list_queue_option += 1;
1729 /* -bpa: List the contents of the mail queue, including all delivered */
1731 else if (Ustrcmp(argrest, "a") == 0) list_queue_option += 2;
1733 /* Unknown after -bp[r] */
1743 /* -bP: List the configuration variables given as the address list.
1744 Force -v, so configuration errors get displayed. */
1746 else if (Ustrcmp(argrest, "P") == 0)
1748 list_options = TRUE;
1749 debug_selector |= D_v;
1750 debug_file = stderr;
1753 /* -brt: Test retry configuration lookup */
1755 else if (Ustrcmp(argrest, "rt") == 0)
1757 test_retry_arg = i + 1;
1761 /* -brw: Test rewrite configuration */
1763 else if (Ustrcmp(argrest, "rw") == 0)
1765 test_rewrite_arg = i + 1;
1769 /* -bS: Read SMTP commands on standard input, but produce no replies -
1770 all errors are reported by sending messages. */
1772 else if (Ustrcmp(argrest, "S") == 0)
1773 smtp_input = smtp_batched_input = receiving_message = TRUE;
1775 /* -bs: Read SMTP commands on standard input and produce SMTP replies
1776 on standard output. */
1778 else if (Ustrcmp(argrest, "s") == 0) smtp_input = receiving_message = TRUE;
1780 /* -bt: address testing mode */
1782 else if (Ustrcmp(argrest, "t") == 0)
1783 address_test_mode = checking = log_testing_mode = TRUE;
1785 /* -bv: verify addresses */
1787 else if (Ustrcmp(argrest, "v") == 0)
1788 verify_address_mode = checking = log_testing_mode = TRUE;
1790 /* -bvs: verify sender addresses */
1792 else if (Ustrcmp(argrest, "vs") == 0)
1794 verify_address_mode = checking = log_testing_mode = TRUE;
1795 verify_as_sender = TRUE;
1798 /* -bV: Print version string and support details */
1800 else if (Ustrcmp(argrest, "V") == 0)
1802 printf("Exim version %s #%s built %s\n", version_string,
1803 version_cnumber, version_date);
1804 printf("%s\n", CS version_copyright);
1805 version_printed = TRUE;
1806 show_whats_supported(stdout);
1813 /* -C: change configuration file list; ignore if it isn't really
1814 a change! Enforce a prefix check if required. */
1819 if(++i < argc) argrest = argv[i]; else
1820 { badarg = TRUE; break; }
1822 if (Ustrcmp(config_main_filelist, argrest) != 0)
1824 #ifdef ALT_CONFIG_PREFIX
1826 int len = Ustrlen(ALT_CONFIG_PREFIX);
1827 uschar *list = argrest;
1829 while((filename = string_nextinlist(&list, &sep, big_buffer,
1830 big_buffer_size)) != NULL)
1832 if ((Ustrlen(filename) < len ||
1833 Ustrncmp(filename, ALT_CONFIG_PREFIX, len) != 0 ||
1834 Ustrstr(filename, "/../") != NULL) &&
1835 (Ustrcmp(filename, "/dev/null") != 0 || real_uid != root_uid))
1837 fprintf(stderr, "-C Permission denied\n");
1843 config_main_filelist = argrest;
1844 config_changed = TRUE;
1849 /* -D: set up a macro definition */
1852 #ifdef DISABLE_D_OPTION
1853 fprintf(stderr, "exim: -D is not available in this Exim binary\n");
1858 macro_item *mlast = NULL;
1861 uschar *s = argrest;
1863 while (isspace(*s)) s++;
1865 if (*s < 'A' || *s > 'Z')
1867 fprintf(stderr, "exim: macro name set by -D must start with "
1868 "an upper case letter\n");
1872 while (isalnum(*s) || *s == '_')
1874 if (ptr < sizeof(name)-1) name[ptr++] = *s;
1878 if (ptr == 0) { badarg = TRUE; break; }
1879 while (isspace(*s)) s++;
1882 if (*s++ != '=') { badarg = TRUE; break; }
1883 while (isspace(*s)) s++;
1886 for (m = macros; m != NULL; m = m->next)
1888 if (Ustrcmp(m->name, name) == 0)
1890 fprintf(stderr, "exim: duplicated -D in command line\n");
1896 m = store_get(sizeof(macro_item) + Ustrlen(name));
1898 m->command_line = TRUE;
1899 if (mlast == NULL) macros = m; else mlast->next = m;
1900 Ustrcpy(m->name, name);
1901 m->replacement = string_copy(s);
1903 if (clmacro_count >= MAX_CLMACROS)
1905 fprintf(stderr, "exim: too many -D options on command line\n");
1908 clmacros[clmacro_count++] = string_sprintf("-D%s=%s", m->name,
1914 /* -d: Set debug level (see also -v below) or set the drop_cr option.
1915 The latter is now a no-op, retained for compatibility only. If -dd is used,
1916 debugging subprocesses of the daemon is disabled. */
1919 if (Ustrcmp(argrest, "ropcr") == 0)
1921 /* drop_cr = TRUE; */
1924 /* Use an intermediate variable so that we don't set debugging while
1925 decoding the debugging bits. */
1929 unsigned int selector = D_default;
1932 if (*argrest == 'd')
1934 debug_daemon = TRUE;
1938 decode_bits(&selector, NULL, D_memory, 0, argrest, debug_options,
1939 debug_options_count, US"debug", 0);
1940 debug_selector = selector;
1945 /* -E: This is a local error message. This option is not intended for
1946 external use at all, but is not restricted to trusted callers because it
1947 does no harm (just suppresses certain error messages) and if Exim is run
1948 not setuid root it won't always be trusted when it generates error
1949 messages using this option. If there is a message id following -E, point
1950 message_reference at it, for logging. */
1953 local_error_message = TRUE;
1954 if (mac_ismsgid(argrest)) message_reference = argrest;
1958 /* -ex: The vacation program calls sendmail with the undocumented "-eq"
1959 option, so it looks as if historically the -oex options are also callable
1960 without the leading -o. So we have to accept them. Before the switch,
1961 anything starting -oe has been converted to -e. Exim does not support all
1962 of the sendmail error options. */
1965 if (Ustrcmp(argrest, "e") == 0)
1967 arg_error_handling = ERRORS_SENDER;
1968 errors_sender_rc = EXIT_SUCCESS;
1970 else if (Ustrcmp(argrest, "m") == 0) arg_error_handling = ERRORS_SENDER;
1971 else if (Ustrcmp(argrest, "p") == 0) arg_error_handling = ERRORS_STDERR;
1972 else if (Ustrcmp(argrest, "q") == 0) arg_error_handling = ERRORS_STDERR;
1973 else if (Ustrcmp(argrest, "w") == 0) arg_error_handling = ERRORS_SENDER;
1978 /* -F: Set sender's full name, used instead of the gecos entry from
1979 the password file. Since users can usually alter their gecos entries,
1980 there's no security involved in using this instead. The data can follow
1981 the -F or be in the next argument. */
1986 if(++i < argc) argrest = argv[i]; else
1987 { badarg = TRUE; break; }
1989 originator_name = argrest;
1990 sender_name_forced = TRUE;
1994 /* -f: Set sender's address - this value is only actually used if Exim is
1995 run by a trusted user, or if untrusted_set_sender is set and matches the
1996 address, except that the null address can always be set by any user. The
1997 test for this happens later, when the value given here is ignored when not
1998 permitted. For an untrusted user, the actual sender is still put in Sender:
1999 if it doesn't match the From: header (unless no_local_from_check is set).
2000 The data can follow the -f or be in the next argument. The -r switch is an
2001 obsolete form of -f but since there appear to be programs out there that
2002 use anything that sendmail has ever supported, better accept it - the
2003 synonymizing is done before the switch above.
2005 At this stage, we must allow domain literal addresses, because we don't
2006 know what the setting of allow_domain_literals is yet. Ditto for trailing
2007 dots and strip_trailing_dot. */
2015 if (i+1 < argc) argrest = argv[++i]; else
2016 { badarg = TRUE; break; }
2020 sender_address = string_sprintf(""); /* Ensure writeable memory */
2024 uschar *temp = argrest + Ustrlen(argrest) - 1;
2025 while (temp >= argrest && isspace(*temp)) temp--;
2026 if (temp >= argrest && *temp == '.') f_end_dot = TRUE;
2027 allow_domain_literals = TRUE;
2028 strip_trailing_dot = TRUE;
2029 sender_address = parse_extract_address(argrest, &errmess, &start, &end,
2030 &sender_address_domain, TRUE);
2031 allow_domain_literals = FALSE;
2032 strip_trailing_dot = FALSE;
2033 if (sender_address == NULL)
2035 fprintf(stderr, "exim: bad -f address \"%s\": %s\n", argrest, errmess);
2036 return EXIT_FAILURE;
2039 sender_address_forced = TRUE;
2043 /* This is some Sendmail thing which can be ignored */
2048 /* -h: Set the hop count for an incoming message. Exim does not currently
2049 support this; it always computes it by counting the Received: headers.
2050 To put it in will require a change to the spool header file format. */
2055 if(++i < argc) argrest = argv[i]; else
2056 { badarg = TRUE; break; }
2058 if (!isdigit(*argrest)) badarg = TRUE;
2062 /* -i: Set flag so dot doesn't end non-SMTP input (same as -oi, seems
2063 not to be documented for sendmail but mailx (at least) uses it) */
2066 if (*argrest == 0) dot_ends = FALSE; else badarg = TRUE;
2071 receiving_message = FALSE;
2073 /* -MC: continue delivery of another message via an existing open
2074 file descriptor. This option is used for an internal call by the
2075 smtp transport when there is a pending message waiting to go to an
2076 address to which it has got a connection. Five subsequent arguments are
2077 required: transport name, host name, IP address, sequence number, and
2078 message_id. Transports may decline to create new processes if the sequence
2079 number gets too big. The channel is stdin. This (-MC) must be the last
2080 argument. There's a subsequent check that the real-uid is privileged.
2082 If we are running in the test harness. delay for a bit, to let the process
2083 that set this one up complete. This makes for repeatability of the logging,
2086 if (Ustrcmp(argrest, "C") == 0)
2088 union sockaddr_46 interface_sock;
2089 EXIM_SOCKLEN_T size = sizeof(interface_sock);
2093 fprintf(stderr, "exim: too many or too few arguments after -MC\n");
2094 return EXIT_FAILURE;
2097 if (msg_action_arg >= 0)
2099 fprintf(stderr, "exim: incompatible arguments\n");
2100 return EXIT_FAILURE;
2103 continue_transport = argv[++i];
2104 continue_hostname = argv[++i];
2105 continue_host_address = argv[++i];
2106 continue_sequence = Uatoi(argv[++i]);
2107 msg_action = MSG_DELIVER;
2108 msg_action_arg = ++i;
2109 forced_delivery = TRUE;
2110 queue_run_pid = passed_qr_pid;
2111 queue_run_pipe = passed_qr_pipe;
2113 if (!mac_ismsgid(argv[i]))
2115 fprintf(stderr, "exim: malformed message id %s after -MC option\n",
2117 return EXIT_FAILURE;
2120 /* Set up $sending_ip_address and $sending_port */
2122 if (getsockname(fileno(stdin), (struct sockaddr *)(&interface_sock),
2124 sending_ip_address = host_ntoa(-1, &interface_sock, NULL,
2128 fprintf(stderr, "exim: getsockname() failed after -MC option: %s\n",
2130 return EXIT_FAILURE;
2133 if (running_in_test_harness) millisleep(500);
2137 /* -MCA: set the smtp_authenticated flag; this is useful only when it
2138 precedes -MC (see above). The flag indicates that the host to which
2139 Exim is connected has accepted an AUTH sequence. */
2141 else if (Ustrcmp(argrest, "CA") == 0)
2143 smtp_authenticated = TRUE;
2147 /* -MCP: set the smtp_use_pipelining flag; this is useful only when
2148 it preceded -MC (see above) */
2150 else if (Ustrcmp(argrest, "CP") == 0)
2152 smtp_use_pipelining = TRUE;
2156 /* -MCQ: pass on the pid of the queue-running process that started
2157 this chain of deliveries and the fd of its synchronizing pipe; this
2158 is useful only when it precedes -MC (see above) */
2160 else if (Ustrcmp(argrest, "CQ") == 0)
2162 if(++i < argc) passed_qr_pid = (pid_t)(Uatol(argv[i]));
2164 if(++i < argc) passed_qr_pipe = (int)(Uatol(argv[i]));
2169 /* -MCS: set the smtp_use_size flag; this is useful only when it
2170 precedes -MC (see above) */
2172 else if (Ustrcmp(argrest, "CS") == 0)
2174 smtp_use_size = TRUE;
2178 /* -MCT: set the tls_offered flag; this is useful only when it
2179 precedes -MC (see above). The flag indicates that the host to which
2180 Exim is connected has offered TLS support. */
2183 else if (Ustrcmp(argrest, "CT") == 0)
2190 /* -M[x]: various operations on the following list of message ids:
2191 -M deliver the messages, ignoring next retry times and thawing
2192 -Mc deliver the messages, checking next retry times, no thawing
2193 -Mf freeze the messages
2194 -Mg give up on the messages
2195 -Mt thaw the messages
2196 -Mrm remove the messages
2197 In the above cases, this must be the last option. There are also the
2198 following options which are followed by a single message id, and which
2199 act on that message. Some of them use the "recipient" addresses as well.
2200 -Mar add recipient(s)
2201 -Mmad mark all recipients delivered
2202 -Mmd mark recipients(s) delivered
2204 -Mset load a message for use with -be
2206 -Mvc show copy (of whole message, in RFC 2822 format)
2211 else if (*argrest == 0)
2213 msg_action = MSG_DELIVER;
2214 forced_delivery = deliver_force_thaw = TRUE;
2216 else if (Ustrcmp(argrest, "ar") == 0)
2218 msg_action = MSG_ADD_RECIPIENT;
2219 one_msg_action = TRUE;
2221 else if (Ustrcmp(argrest, "c") == 0) msg_action = MSG_DELIVER;
2222 else if (Ustrcmp(argrest, "es") == 0)
2224 msg_action = MSG_EDIT_SENDER;
2225 one_msg_action = TRUE;
2227 else if (Ustrcmp(argrest, "f") == 0) msg_action = MSG_FREEZE;
2228 else if (Ustrcmp(argrest, "g") == 0)
2230 msg_action = MSG_DELIVER;
2231 deliver_give_up = TRUE;
2233 else if (Ustrcmp(argrest, "mad") == 0)
2235 msg_action = MSG_MARK_ALL_DELIVERED;
2237 else if (Ustrcmp(argrest, "md") == 0)
2239 msg_action = MSG_MARK_DELIVERED;
2240 one_msg_action = TRUE;
2242 else if (Ustrcmp(argrest, "rm") == 0) msg_action = MSG_REMOVE;
2243 else if (Ustrcmp(argrest, "set") == 0)
2245 msg_action = MSG_LOAD;
2246 one_msg_action = TRUE;
2248 else if (Ustrcmp(argrest, "t") == 0) msg_action = MSG_THAW;
2249 else if (Ustrcmp(argrest, "vb") == 0)
2251 msg_action = MSG_SHOW_BODY;
2252 one_msg_action = TRUE;
2254 else if (Ustrcmp(argrest, "vc") == 0)
2256 msg_action = MSG_SHOW_COPY;
2257 one_msg_action = TRUE;
2259 else if (Ustrcmp(argrest, "vh") == 0)
2261 msg_action = MSG_SHOW_HEADER;
2262 one_msg_action = TRUE;
2264 else if (Ustrcmp(argrest, "vl") == 0)
2266 msg_action = MSG_SHOW_LOG;
2267 one_msg_action = TRUE;
2269 else { badarg = TRUE; break; }
2271 /* All the -Mxx options require at least one message id. */
2273 msg_action_arg = i + 1;
2274 if (msg_action_arg >= argc)
2276 fprintf(stderr, "exim: no message ids given after %s option\n", arg);
2277 return EXIT_FAILURE;
2280 /* Some require only message ids to follow */
2282 if (!one_msg_action)
2285 for (j = msg_action_arg; j < argc; j++) if (!mac_ismsgid(argv[j]))
2287 fprintf(stderr, "exim: malformed message id %s after %s option\n",
2289 return EXIT_FAILURE;
2291 goto END_ARG; /* Remaining args are ids */
2294 /* Others require only one message id, possibly followed by addresses,
2295 which will be handled as normal arguments. */
2299 if (!mac_ismsgid(argv[msg_action_arg]))
2301 fprintf(stderr, "exim: malformed message id %s after %s option\n",
2302 argv[msg_action_arg], arg);
2303 return EXIT_FAILURE;
2310 /* Some programs seem to call the -om option without the leading o;
2311 for sendmail it askes for "me too". Exim always does this. */
2314 if (*argrest != 0) badarg = TRUE;
2318 /* -N: don't do delivery - a debugging option that stops transports doing
2319 their thing. It implies debugging at the D_v level. */
2324 dont_deliver = TRUE;
2325 debug_selector |= D_v;
2326 debug_file = stderr;
2332 /* -n: This means "don't alias" in sendmail, apparently. Just ignore
2338 /* -O: Just ignore it. In sendmail, apparently -O option=value means set
2339 option to the specified value. This form uses long names. We need to handle
2340 -O option=value and -Ooption=value. */
2347 fprintf(stderr, "exim: string expected after -O\n");
2355 /* -oA: Set an argument for the bi command (sendmail's "alternate alias
2358 if (*argrest == 'A')
2360 alias_arg = argrest + 1;
2361 if (alias_arg[0] == 0)
2363 if (i+1 < argc) alias_arg = argv[++i]; else
2365 fprintf(stderr, "exim: string expected after -oA\n");
2371 /* -oB: Set a connection message max value for remote deliveries */
2373 else if (*argrest == 'B')
2375 uschar *p = argrest + 1;
2378 if (i+1 < argc && isdigit((argv[i+1][0]))) p = argv[++i]; else
2380 connection_max_messages = 1;
2389 fprintf(stderr, "exim: number expected after -oB\n");
2392 connection_max_messages = Uatoi(p);
2396 /* -odb: background delivery */
2398 else if (Ustrcmp(argrest, "db") == 0)
2400 synchronous_delivery = FALSE;
2401 arg_queue_only = FALSE;
2402 queue_only_set = TRUE;
2405 /* -odf: foreground delivery (smail-compatible option); same effect as
2406 -odi: interactive (synchronous) delivery (sendmail-compatible option)
2409 else if (Ustrcmp(argrest, "df") == 0 || Ustrcmp(argrest, "di") == 0)
2411 synchronous_delivery = TRUE;
2412 arg_queue_only = FALSE;
2413 queue_only_set = TRUE;
2416 /* -odq: queue only */
2418 else if (Ustrcmp(argrest, "dq") == 0)
2420 synchronous_delivery = FALSE;
2421 arg_queue_only = TRUE;
2422 queue_only_set = TRUE;
2425 /* -odqs: queue SMTP only - do local deliveries and remote routing,
2426 but no remote delivery */
2428 else if (Ustrcmp(argrest, "dqs") == 0)
2431 arg_queue_only = FALSE;
2432 queue_only_set = TRUE;
2435 /* -oex: Sendmail error flags. As these are also accepted without the
2436 leading -o prefix, for compatibility with vacation and other callers,
2437 they are handled with -e above. */
2439 /* -oi: Set flag so dot doesn't end non-SMTP input (same as -i)
2440 -oitrue: Another sendmail syntax for the same */
2442 else if (Ustrcmp(argrest, "i") == 0 ||
2443 Ustrcmp(argrest, "itrue") == 0)
2446 /* -oM*: Set various characteristics for an incoming message; actually
2447 acted on for trusted callers only. */
2449 else if (*argrest == 'M')
2453 fprintf(stderr, "exim: data expected after -o%s\n", argrest);
2457 /* -oMa: Set sender host address */
2459 if (Ustrcmp(argrest, "Ma") == 0) sender_host_address = argv[++i];
2461 /* -oMaa: Set authenticator name */
2463 else if (Ustrcmp(argrest, "Maa") == 0)
2464 sender_host_authenticated = argv[++i];
2466 /* -oMas: setting authenticated sender */
2468 else if (Ustrcmp(argrest, "Mas") == 0) authenticated_sender = argv[++i];
2470 /* -oMai: setting authenticated id */
2472 else if (Ustrcmp(argrest, "Mai") == 0) authenticated_id = argv[++i];
2474 /* -oMi: Set incoming interface address */
2476 else if (Ustrcmp(argrest, "Mi") == 0) interface_address = argv[++i];
2478 /* -oMr: Received protocol */
2480 else if (Ustrcmp(argrest, "Mr") == 0) received_protocol = argv[++i];
2482 /* -oMs: Set sender host name */
2484 else if (Ustrcmp(argrest, "Ms") == 0) sender_host_name = argv[++i];
2486 /* -oMt: Set sender ident */
2488 else if (Ustrcmp(argrest, "Mt") == 0)
2490 sender_ident_set = TRUE;
2491 sender_ident = argv[++i];
2494 /* Else a bad argument */
2503 /* -om: Me-too flag for aliases. Exim always does this. Some programs
2504 seem to call this as -m (undocumented), so that is also accepted (see
2507 else if (Ustrcmp(argrest, "m") == 0) {}
2509 /* -oo: An ancient flag for old-style addresses which still seems to
2510 crop up in some calls (see in SCO). */
2512 else if (Ustrcmp(argrest, "o") == 0) {}
2514 /* -oP <name>: set pid file path for daemon */
2516 else if (Ustrcmp(argrest, "P") == 0)
2517 override_pid_file_path = argv[++i];
2519 /* -or <n>: set timeout for non-SMTP acceptance
2520 -os <n>: set timeout for SMTP acceptance */
2522 else if (*argrest == 'r' || *argrest == 's')
2524 int *tp = (*argrest == 'r')?
2525 &arg_receive_timeout : &arg_smtp_receive_timeout;
2526 if (argrest[1] == 0)
2528 if (i+1 < argc) *tp= readconf_readtime(argv[++i], 0, FALSE);
2530 else *tp = readconf_readtime(argrest + 1, 0, FALSE);
2533 fprintf(stderr, "exim: bad time value %s: abandoned\n", argv[i]);
2538 /* -oX <list>: Override local_interfaces and/or default daemon ports */
2540 else if (Ustrcmp(argrest, "X") == 0)
2541 override_local_interfaces = argv[++i];
2543 /* Unknown -o argument */
2549 /* -ps: force Perl startup; -pd force delayed Perl startup */
2553 if (*argrest == 's' && argrest[1] == 0)
2555 perl_start_option = 1;
2558 if (*argrest == 'd' && argrest[1] == 0)
2560 perl_start_option = -1;
2565 /* -panythingelse is taken as the Sendmail-compatible argument -prval:sval,
2566 which sets the host protocol and host name */
2570 if (i+1 < argc) argrest = argv[++i]; else
2571 { badarg = TRUE; break; }
2576 uschar *hn = Ustrchr(argrest, ':');
2579 received_protocol = argrest;
2583 received_protocol = string_copyn(argrest, hn - argrest);
2584 sender_host_name = hn + 1;
2591 receiving_message = FALSE;
2592 if (queue_interval >= 0)
2594 fprintf(stderr, "exim: -q specified more than once\n");
2598 /* -qq...: Do queue runs in a 2-stage manner */
2600 if (*argrest == 'q')
2602 queue_2stage = TRUE;
2606 /* -qi...: Do only first (initial) deliveries */
2608 if (*argrest == 'i')
2610 queue_run_first_delivery = TRUE;
2614 /* -qf...: Run the queue, forcing deliveries
2615 -qff..: Ditto, forcing thawing as well */
2617 if (*argrest == 'f')
2619 queue_run_force = TRUE;
2620 if (*(++argrest) == 'f')
2622 deliver_force_thaw = TRUE;
2627 /* -q[f][f]l...: Run the queue only on local deliveries */
2629 if (*argrest == 'l')
2631 queue_run_local = TRUE;
2635 /* -q[f][f][l]: Run the queue, optionally forced, optionally local only,
2636 optionally starting from a given message id. */
2638 if (*argrest == 0 &&
2639 (i + 1 >= argc || argv[i+1][0] == '-' || mac_ismsgid(argv[i+1])))
2642 if (i+1 < argc && mac_ismsgid(argv[i+1]))
2643 start_queue_run_id = argv[++i];
2644 if (i+1 < argc && mac_ismsgid(argv[i+1]))
2645 stop_queue_run_id = argv[++i];
2648 /* -q[f][f][l]<n>: Run the queue at regular intervals, optionally forced,
2649 optionally local only. */
2654 queue_interval = readconf_readtime(argrest, 0, FALSE);
2656 queue_interval = readconf_readtime(argv[++i], 0, FALSE);
2657 if (queue_interval <= 0)
2659 fprintf(stderr, "exim: bad time value %s: abandoned\n", argv[i]);
2666 case 'R': /* Synonymous with -qR... */
2667 receiving_message = FALSE;
2669 /* -Rf: As -R (below) but force all deliveries,
2670 -Rff: Ditto, but also thaw all frozen messages,
2671 -Rr: String is regex
2672 -Rrf: Regex and force
2673 -Rrff: Regex and force and thaw
2675 in all cases provided there are no further characters in this
2681 for (i = 0; i < sizeof(rsopts)/sizeof(uschar *); i++)
2683 if (Ustrcmp(argrest, rsopts[i]) == 0)
2685 if (i != 2) queue_run_force = TRUE;
2686 if (i >= 2) deliver_selectstring_regex = TRUE;
2687 if (i == 1 || i == 4) deliver_force_thaw = TRUE;
2688 argrest += Ustrlen(rsopts[i]);
2693 /* -R: Set string to match in addresses for forced queue run to
2694 pick out particular messages. */
2698 if (i+1 < argc) deliver_selectstring = argv[++i]; else
2700 fprintf(stderr, "exim: string expected after -R\n");
2704 else deliver_selectstring = argrest;
2708 /* -r: an obsolete synonym for -f (see above) */
2711 /* -S: Like -R but works on sender. */
2713 case 'S': /* Synonymous with -qS... */
2714 receiving_message = FALSE;
2716 /* -Sf: As -S (below) but force all deliveries,
2717 -Sff: Ditto, but also thaw all frozen messages,
2718 -Sr: String is regex
2719 -Srf: Regex and force
2720 -Srff: Regex and force and thaw
2722 in all cases provided there are no further characters in this
2728 for (i = 0; i < sizeof(rsopts)/sizeof(uschar *); i++)
2730 if (Ustrcmp(argrest, rsopts[i]) == 0)
2732 if (i != 2) queue_run_force = TRUE;
2733 if (i >= 2) deliver_selectstring_sender_regex = TRUE;
2734 if (i == 1 || i == 4) deliver_force_thaw = TRUE;
2735 argrest += Ustrlen(rsopts[i]);
2740 /* -S: Set string to match in addresses for forced queue run to
2741 pick out particular messages. */
2745 if (i+1 < argc) deliver_selectstring_sender = argv[++i]; else
2747 fprintf(stderr, "exim: string expected after -S\n");
2751 else deliver_selectstring_sender = argrest;
2754 /* -Tqt is an option that is exclusively for use by the testing suite.
2755 It is not recognized in other circumstances. It allows for the setting up
2756 of explicit "queue times" so that various warning/retry things can be
2757 tested. Otherwise variability of clock ticks etc. cause problems. */
2760 if (running_in_test_harness && Ustrcmp(argrest, "qt") == 0)
2761 fudged_queue_times = argv[++i];
2766 /* -t: Set flag to extract recipients from body of message. */
2769 if (*argrest == 0) extract_recipients = TRUE;
2771 /* -ti: Set flag to extract recipients from body of message, and also
2772 specify that dot does not end the message. */
2774 else if (Ustrcmp(argrest, "i") == 0)
2776 extract_recipients = TRUE;
2780 /* -tls-on-connect: don't wait for STARTTLS (for old clients) */
2783 else if (Ustrcmp(argrest, "ls-on-connect") == 0) tls_on_connect = TRUE;
2790 /* -U: This means "initial user submission" in sendmail, apparently. The
2791 doc claims that in future sendmail may refuse syntactically invalid
2792 messages instead of fixing them. For the moment, we just ignore it. */
2798 /* -v: verify things - this is a very low-level debugging */
2803 debug_selector |= D_v;
2804 debug_file = stderr;
2810 /* -x: AIX uses this to indicate some fancy 8-bit character stuff:
2812 The -x flag tells the sendmail command that mail from a local
2813 mail program has National Language Support (NLS) extended characters
2814 in the body of the mail item. The sendmail command can send mail with
2815 extended NLS characters across networks that normally corrupts these
2818 As Exim is 8-bit clean, it just ignores this flag. */
2821 if (*argrest != 0) badarg = TRUE;
2824 /* All other initial characters are errors */
2829 } /* End of high-level switch statement */
2831 /* Failed to recognize the option, or syntax error */
2835 fprintf(stderr, "exim abandoned: unknown, malformed, or incomplete "
2836 "option %s\n", arg);
2842 /* If -R or -S have been specified without -q, assume a single queue run. */
2844 if ((deliver_selectstring != NULL || deliver_selectstring_sender != NULL) &&
2845 queue_interval < 0) queue_interval = 0;
2849 /* If usage_wanted is set we call the usage function - which never returns */
2850 if (usage_wanted) exim_usage(called_as);
2852 /* Arguments have been processed. Check for incompatibilities. */
2854 (smtp_input || extract_recipients || recipients_arg < argc) &&
2855 (daemon_listen || queue_interval >= 0 || bi_option ||
2856 test_retry_arg >= 0 || test_rewrite_arg >= 0 ||
2857 filter_test != FTEST_NONE || (msg_action_arg > 0 && !one_msg_action))
2860 msg_action_arg > 0 &&
2861 (daemon_listen || queue_interval >= 0 || list_options ||
2862 (checking && msg_action != MSG_LOAD) ||
2863 bi_option || test_retry_arg >= 0 || test_rewrite_arg >= 0)
2866 (daemon_listen || queue_interval >= 0) &&
2867 (sender_address != NULL || list_options || list_queue || checking ||
2871 daemon_listen && queue_interval == 0
2875 (checking || smtp_input || extract_recipients ||
2876 filter_test != FTEST_NONE || bi_option)
2879 verify_address_mode &&
2880 (address_test_mode || smtp_input || extract_recipients ||
2881 filter_test != FTEST_NONE || bi_option)
2884 address_test_mode && (smtp_input || extract_recipients ||
2885 filter_test != FTEST_NONE || bi_option)
2888 smtp_input && (sender_address != NULL || filter_test != FTEST_NONE ||
2892 deliver_selectstring != NULL && queue_interval < 0
2895 msg_action == MSG_LOAD &&
2896 (!expansion_test || expansion_test_message != NULL)
2900 fprintf(stderr, "exim: incompatible command-line options or arguments\n");
2904 /* If debugging is set up, set the file and the file descriptor to pass on to
2905 child processes. It should, of course, be 2 for stderr. Also, force the daemon
2906 to run in the foreground. */
2908 if (debug_selector != 0)
2910 debug_file = stderr;
2911 debug_fd = fileno(debug_file);
2912 background_daemon = FALSE;
2913 if (running_in_test_harness) millisleep(100); /* lets caller finish */
2914 if (debug_selector != D_v) /* -v only doesn't show this */
2916 debug_printf("Exim version %s uid=%ld gid=%ld pid=%d D=%x\n",
2917 version_string, (long int)real_uid, (long int)real_gid, (int)getpid(),
2919 show_whats_supported(stderr);
2923 /* When started with root privilege, ensure that the limits on the number of
2924 open files and the number of processes (where that is accessible) are
2925 sufficiently large, or are unset, in case Exim has been called from an
2926 environment where the limits are screwed down. Not all OS have the ability to
2927 change some of these limits. */
2931 DEBUG(D_any) debug_print_ids(US"Exim has no root privilege:");
2937 #ifdef RLIMIT_NOFILE
2938 if (getrlimit(RLIMIT_NOFILE, &rlp) < 0)
2940 log_write(0, LOG_MAIN|LOG_PANIC, "getrlimit(RLIMIT_NOFILE) failed: %s",
2942 rlp.rlim_cur = rlp.rlim_max = 0;
2945 /* I originally chose 1000 as a nice big number that was unlikely to
2946 be exceeded. It turns out that some older OS have a fixed upper limit of
2949 if (rlp.rlim_cur < 1000)
2951 rlp.rlim_cur = rlp.rlim_max = 1000;
2952 if (setrlimit(RLIMIT_NOFILE, &rlp) < 0)
2954 rlp.rlim_cur = rlp.rlim_max = 256;
2955 if (setrlimit(RLIMIT_NOFILE, &rlp) < 0)
2956 log_write(0, LOG_MAIN|LOG_PANIC, "setrlimit(RLIMIT_NOFILE) failed: %s",
2963 if (getrlimit(RLIMIT_NPROC, &rlp) < 0)
2965 log_write(0, LOG_MAIN|LOG_PANIC, "getrlimit(RLIMIT_NPROC) failed: %s",
2967 rlp.rlim_cur = rlp.rlim_max = 0;
2970 #ifdef RLIM_INFINITY
2971 if (rlp.rlim_cur != RLIM_INFINITY && rlp.rlim_cur < 1000)
2973 rlp.rlim_cur = rlp.rlim_max = RLIM_INFINITY;
2975 if (rlp.rlim_cur < 1000)
2977 rlp.rlim_cur = rlp.rlim_max = 1000;
2979 if (setrlimit(RLIMIT_NPROC, &rlp) < 0)
2980 log_write(0, LOG_MAIN|LOG_PANIC, "setrlimit(RLIMIT_NPROC) failed: %s",
2986 /* Exim is normally entered as root (but some special configurations are
2987 possible that don't do this). However, it always spins off sub-processes that
2988 set their uid and gid as required for local delivery. We don't want to pass on
2989 any extra groups that root may belong to, so we want to get rid of them all at
2992 We need to obey setgroups() at this stage, before possibly giving up root
2993 privilege for a changed configuration file, but later on we might need to
2994 check on the additional groups for the admin user privilege - can't do that
2995 till after reading the config, which might specify the exim gid. Therefore,
2996 save the group list here first. */
2998 group_count = getgroups(NGROUPS_MAX, group_list);
3000 /* There is a fundamental difference in some BSD systems in the matter of
3001 groups. FreeBSD and BSDI are known to be different; NetBSD and OpenBSD are
3002 known not to be different. On the "different" systems there is a single group
3003 list, and the first entry in it is the current group. On all other versions of
3004 Unix there is a supplementary group list, which is in *addition* to the current
3005 group. Consequently, to get rid of all extraneous groups on a "standard" system
3006 you pass over 0 groups to setgroups(), while on a "different" system you pass
3007 over a single group - the current group, which is always the first group in the
3008 list. Calling setgroups() with zero groups on a "different" system results in
3009 an error return. The following code should cope with both types of system.
3011 However, if this process isn't running as root, setgroups() can't be used
3012 since you have to be root to run it, even if throwing away groups. Not being
3013 root here happens only in some unusual configurations. We just ignore the
3016 if (setgroups(0, NULL) != 0)
3018 if (setgroups(1, group_list) != 0 && !unprivileged)
3020 fprintf(stderr, "exim: setgroups() failed: %s\n", strerror(errno));
3025 /* If the configuration file name has been altered by an argument on the
3026 command line (either a new file name or a macro definition) and the caller is
3027 not root or the exim user, or if this is a filter testing run, remove any
3028 setuid privilege the program has, and run as the underlying user.
3030 If ALT_CONFIG_ROOT_ONLY is defined, the exim user is locked out of this, which
3031 severely restricts the use of -C for some purposes.
3033 Otherwise, set the real ids to the effective values (should be root unless run
3034 from inetd, which it can either be root or the exim uid, if one is configured).
3036 There is a private mechanism for bypassing some of this, in order to make it
3037 possible to test lots of configurations automatically, without having either to
3038 recompile each time, or to patch in an actual configuration file name and other
3039 values (such as the path name). If running in the test harness, pretend that
3040 configuration file changes and macro definitions haven't happened. */
3043 (config_changed || macros != NULL) && /* Config changed, and */
3044 real_uid != root_uid && /* Not root, and */
3045 #ifndef ALT_CONFIG_ROOT_ONLY /* (when not locked out) */
3046 real_uid != exim_uid && /* Not exim, and */
3048 !running_in_test_harness /* Not fudged */
3050 expansion_test /* expansion testing */
3052 filter_test != FTEST_NONE) /* Filter testing */
3054 setgroups(group_count, group_list);
3055 exim_setugid(real_uid, real_gid, FALSE,
3056 US"-C, -D, -be or -bf forces real uid");
3057 removed_privilege = TRUE;
3059 /* In the normal case when Exim is called like this, stderr is available
3060 and should be used for any logging information because attempts to write
3061 to the log will usually fail. To arrange this, we unset really_exim. However,
3062 if no stderr is available there is no point - we might as well have a go
3063 at the log (if it fails, syslog will be written). */
3065 if (log_stderr != NULL) really_exim = FALSE;
3068 /* Privilege is to be retained for the moment. It may be dropped later,
3069 depending on the job that this Exim process has been asked to do. For now, set
3070 the real uid to the effective so that subsequent re-execs of Exim are done by a
3073 else exim_setugid(geteuid(), getegid(), FALSE, US"forcing real = effective");
3075 /* If testing a filter, open the file(s) now, before wasting time doing other
3076 setups and reading the message. */
3078 if ((filter_test & FTEST_SYSTEM) != 0)
3080 filter_sfd = Uopen(filter_test_sfile, O_RDONLY, 0);
3083 fprintf(stderr, "exim: failed to open %s: %s\n", filter_test_sfile,
3085 return EXIT_FAILURE;
3089 if ((filter_test & FTEST_USER) != 0)
3091 filter_ufd = Uopen(filter_test_ufile, O_RDONLY, 0);
3094 fprintf(stderr, "exim: failed to open %s: %s\n", filter_test_ufile,
3096 return EXIT_FAILURE;
3100 /* Read the main runtime configuration data; this gives up if there
3101 is a failure. It leaves the configuration file open so that the subsequent
3102 configuration data for delivery can be read if needed. */
3106 /* Handle the decoding of logging options. */
3108 decode_bits(&log_write_selector, &log_extra_selector, 0, 0,
3109 log_selector_string, log_options, log_options_count, US"log", 0);
3113 debug_printf("configuration file is %s\n", config_main_filename);
3114 debug_printf("log selectors = %08x %08x\n", log_write_selector,
3115 log_extra_selector);
3118 /* If domain literals are not allowed, check the sender address that was
3119 supplied with -f. Ditto for a stripped trailing dot. */
3121 if (sender_address != NULL)
3123 if (sender_address[sender_address_domain] == '[' && !allow_domain_literals)
3125 fprintf(stderr, "exim: bad -f address \"%s\": domain literals not "
3126 "allowed\n", sender_address);
3127 return EXIT_FAILURE;
3129 if (f_end_dot && !strip_trailing_dot)
3131 fprintf(stderr, "exim: bad -f address \"%s.\": domain is malformed "
3132 "(trailing dot not allowed)\n", sender_address);
3133 return EXIT_FAILURE;
3137 /* Paranoia check of maximum lengths of certain strings. There is a check
3138 on the length of the log file path in log.c, which will come into effect
3139 if there are any calls to write the log earlier than this. However, if we
3140 get this far but the string is very long, it is better to stop now than to
3141 carry on and (e.g.) receive a message and then have to collapse. The call to
3142 log_write() from here will cause the ultimate panic collapse if the complete
3143 file name exceeds the buffer length. */
3145 if (Ustrlen(log_file_path) > 200)
3146 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3147 "log_file_path is longer than 200 chars: aborting");
3149 if (Ustrlen(pid_file_path) > 200)
3150 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3151 "pid_file_path is longer than 200 chars: aborting");
3153 if (Ustrlen(spool_directory) > 200)
3154 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3155 "spool_directory is longer than 200 chars: aborting");
3157 /* Length check on the process name given to syslog for its TAG field,
3158 which is only permitted to be 32 characters or less. See RFC 3164. */
3160 if (Ustrlen(syslog_processname) > 32)
3161 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3162 "syslog_processname is longer than 32 chars: aborting");
3164 /* In some operating systems, the environment variable TMPDIR controls where
3165 temporary files are created; Exim doesn't use these (apart from when delivering
3166 to MBX mailboxes), but called libraries such as DBM libraries may require them.
3167 If TMPDIR is found in the environment, reset it to the value defined in the
3168 TMPDIR macro, if this macro is defined. */
3173 for (p = USS environ; *p != NULL; p++)
3175 if (Ustrncmp(*p, "TMPDIR=", 7) == 0 &&
3176 Ustrcmp(*p+7, TMPDIR) != 0)
3178 uschar *newp = malloc(Ustrlen(TMPDIR) + 8);
3179 sprintf(CS newp, "TMPDIR=%s", TMPDIR);
3181 DEBUG(D_any) debug_printf("reset TMPDIR=%s in environment\n", TMPDIR);
3187 /* Timezone handling. If timezone_string is "utc", set a flag to cause all
3188 timestamps to be in UTC (gmtime() is used instead of localtime()). Otherwise,
3189 we may need to get rid of a bogus timezone setting. This can arise when Exim is
3190 called by a user who has set the TZ variable. This then affects the timestamps
3191 in log files and in Received: headers, and any created Date: header lines. The
3192 required timezone is settable in the configuration file, so nothing can be done
3193 about this earlier - but hopefully nothing will normally be logged earlier than
3194 this. We have to make a new environment if TZ is wrong, but don't bother if
3195 timestamps_utc is set, because then all times are in UTC anyway. */
3197 if (timezone_string != NULL && strcmpic(timezone_string, US"UTC") == 0)
3199 timestamps_utc = TRUE;
3203 uschar *envtz = US getenv("TZ");
3204 if ((envtz == NULL && timezone_string != NULL) ||
3206 (timezone_string == NULL ||
3207 Ustrcmp(timezone_string, envtz) != 0)))
3209 uschar **p = USS environ;
3213 while (*p++ != NULL) count++;
3214 if (envtz == NULL) count++;
3215 newp = new = malloc(sizeof(uschar *) * (count + 1));
3216 for (p = USS environ; *p != NULL; p++)
3218 if (Ustrncmp(*p, "TZ=", 3) == 0) continue;
3221 if (timezone_string != NULL)
3223 *newp = malloc(Ustrlen(timezone_string) + 4);
3224 sprintf(CS *newp++, "TZ=%s", timezone_string);
3229 DEBUG(D_any) debug_printf("Reset TZ to %s: time is %s\n", timezone_string,
3230 tod_stamp(tod_log));
3234 /* Handle the case when we have removed the setuid privilege because of -C or
3235 -D. This means that the caller of Exim was not root, and, provided that
3236 ALT_CONFIG_ROOT_ONLY is not defined, was not the Exim user that is built into
3239 If ALT_CONFIG_ROOT_ONLY is not defined, there is a problem if it turns out we
3240 were running as the exim user defined in the configuration file (different to
3241 the one in the binary). The sysadmin may expect this case to retain privilege
3242 because "the binary was called by the Exim user", but it hasn't, because of the
3243 order in which it handles this stuff. There are two possibilities:
3245 (1) If deliver_drop_privilege is set, Exim is not going to re-exec in order
3246 to do message deliveries. Thus, the fact that it is running as a
3247 non-privileged user is plausible, and might be wanted in some special
3248 configurations. However, really_exim will have been set false when
3249 privilege was dropped, to stop Exim trying to write to its normal log
3250 files. Therefore, re-enable normal log processing, assuming the sysadmin
3251 has set up the log directory correctly.
3253 (2) If deliver_drop_privilege is not set, the configuration won't work as
3254 apparently intended, and so we log a panic message. In order to retain
3255 root for -C or -D, the caller must either be root or the Exim user
3256 defined in the binary (when deliver_drop_ privilege is false).
3258 If ALT_CONFIG_ROOT_ONLY is defined, we don't know whether we were called by the
3259 built-in exim user or one defined in the configuration. In either event,
3260 re-enable log processing, assuming the sysadmin knows what they are doing. */
3262 if (removed_privilege && (config_changed || macros != NULL) &&
3263 real_uid == exim_uid)
3265 #ifdef ALT_CONFIG_ROOT_ONLY
3266 really_exim = TRUE; /* let logging work normally */
3269 if (deliver_drop_privilege)
3270 really_exim = TRUE; /* let logging work normally */
3272 log_write(0, LOG_MAIN|LOG_PANIC,
3273 "exim user (uid=%d) is defined only at runtime; privilege lost for %s",
3274 (int)exim_uid, config_changed? "-C" : "-D");
3278 /* Start up Perl interpreter if Perl support is configured and there is a
3279 perl_startup option, and the configuration or the command line specifies
3280 initializing starting. Note that the global variables are actually called
3281 opt_perl_xxx to avoid clashing with perl's namespace (perl_*). */
3284 if (perl_start_option != 0)
3285 opt_perl_at_start = (perl_start_option > 0);
3286 if (opt_perl_at_start && opt_perl_startup != NULL)
3289 DEBUG(D_any) debug_printf("Starting Perl interpreter\n");
3290 errstr = init_perl(opt_perl_startup);
3293 fprintf(stderr, "exim: error in perl_startup code: %s\n", errstr);
3294 return EXIT_FAILURE;
3296 opt_perl_started = TRUE;
3298 #endif /* EXIM_PERL */
3300 /* Log the arguments of the call if the configuration file said so. This is
3301 a debugging feature for finding out what arguments certain MUAs actually use.
3302 Don't attempt it if logging is disabled, or if listing variables or if
3303 verifying/testing addresses or expansions. */
3305 if (((debug_selector & D_any) != 0 || (log_extra_selector & LX_arguments) != 0)
3306 && really_exim && !list_options && !checking)
3309 uschar *p = big_buffer;
3311 (void)getcwd(CS p+4, big_buffer_size - 4);
3313 (void)string_format(p, big_buffer_size - (p - big_buffer), " %d args:", argc);
3315 for (i = 0; i < argc; i++)
3317 int len = Ustrlen(argv[i]);
3320 if (p + len + 8 >= big_buffer + big_buffer_size)
3323 log_write(0, LOG_MAIN, "%s", big_buffer);
3324 Ustrcpy(big_buffer, "...");
3327 printing = string_printing(argv[i]);
3328 if (printing[0] == 0) quote = US"\""; else
3330 uschar *pp = printing;
3332 while (*pp != 0) if (isspace(*pp++)) { quote = US"\""; break; }
3334 sprintf(CS p, " %s%.*s%s", quote, (int)(big_buffer_size -
3335 (p - big_buffer) - 4), printing, quote);
3339 if ((log_extra_selector & LX_arguments) != 0)
3340 log_write(0, LOG_MAIN, "%s", big_buffer);
3342 debug_printf("%s\n", big_buffer);
3345 /* Set the working directory to be the top-level spool directory. We don't rely
3346 on this in the code, which always uses fully qualified names, but it's useful
3347 for core dumps etc. Don't complain if it fails - the spool directory might not
3348 be generally accessible and calls with the -C option (and others) have lost
3349 privilege by now. Before the chdir, we try to ensure that the directory exists.
3352 if (Uchdir(spool_directory) != 0)
3354 (void)directory_make(spool_directory, US"", SPOOL_DIRECTORY_MODE, FALSE);
3355 (void)Uchdir(spool_directory);
3358 /* Handle calls with the -bi option. This is a sendmail option to rebuild *the*
3359 alias file. Exim doesn't have such a concept, but this call is screwed into
3360 Sun's YP makefiles. Handle this by calling a configured script, as the real
3361 user who called Exim. The -oA option can be used to pass an argument to the
3366 (void)fclose(config_file);
3367 if (bi_command != NULL)
3371 argv[i++] = bi_command;
3372 if (alias_arg != NULL) argv[i++] = alias_arg;
3375 setgroups(group_count, group_list);
3376 exim_setugid(real_uid, real_gid, FALSE, US"running bi_command");
3378 DEBUG(D_exec) debug_printf("exec %.256s %.256s\n", argv[0],
3379 (argv[1] == NULL)? US"" : argv[1]);
3381 execv(CS argv[0], (char *const *)argv);
3382 fprintf(stderr, "exim: exec failed: %s\n", strerror(errno));
3387 DEBUG(D_any) debug_printf("-bi used but bi_command not set; exiting\n");
3392 /* If an action on specific messages is requested, or if a daemon or queue
3393 runner is being started, we need to know if Exim was called by an admin user.
3394 This is the case if the real user is root or exim, or if the real group is
3395 exim, or if one of the supplementary groups is exim or a group listed in
3396 admin_groups. We don't fail all message actions immediately if not admin_user,
3397 since some actions can be performed by non-admin users. Instead, set admin_user
3398 for later interrogation. */
3400 if (real_uid == root_uid || real_uid == exim_uid || real_gid == exim_gid)
3405 for (i = 0; i < group_count; i++)
3407 if (group_list[i] == exim_gid) admin_user = TRUE;
3408 else if (admin_groups != NULL)
3410 for (j = 1; j <= (int)(admin_groups[0]); j++)
3411 if (admin_groups[j] == group_list[i])
3412 { admin_user = TRUE; break; }
3414 if (admin_user) break;
3418 /* Another group of privileged users are the trusted users. These are root,
3419 exim, and any caller matching trusted_users or trusted_groups. Trusted callers
3420 are permitted to specify sender_addresses with -f on the command line, and
3421 other message parameters as well. */
3423 if (real_uid == root_uid || real_uid == exim_uid)
3424 trusted_caller = TRUE;
3429 if (trusted_users != NULL)
3431 for (i = 1; i <= (int)(trusted_users[0]); i++)
3432 if (trusted_users[i] == real_uid)
3433 { trusted_caller = TRUE; break; }
3436 if (!trusted_caller && trusted_groups != NULL)
3438 for (i = 1; i <= (int)(trusted_groups[0]); i++)
3440 if (trusted_groups[i] == real_gid)
3441 trusted_caller = TRUE;
3442 else for (j = 0; j < group_count; j++)
3444 if (trusted_groups[i] == group_list[j])
3445 { trusted_caller = TRUE; break; }
3447 if (trusted_caller) break;
3452 if (trusted_caller) DEBUG(D_any) debug_printf("trusted user\n");
3453 if (admin_user) DEBUG(D_any) debug_printf("admin user\n");
3455 /* Only an admin user may start the daemon or force a queue run in the default
3456 configuration, but the queue run restriction can be relaxed. Only an admin
3457 user may request that a message be returned to its sender forthwith. Only an
3458 admin user may specify a debug level greater than D_v (because it might show
3459 passwords, etc. in lookup queries). Only an admin user may request a queue
3460 count. Only an admin user can use the test interface to scan for email
3461 (because Exim will be in the spool dir and able to look at mails). */
3465 BOOL debugset = (debug_selector & ~D_v) != 0;
3466 if (deliver_give_up || daemon_listen || malware_test_file ||
3467 (count_queue && queue_list_requires_admin) ||
3468 (list_queue && queue_list_requires_admin) ||
3469 (queue_interval >= 0 && prod_requires_admin) ||
3470 (debugset && !running_in_test_harness))
3472 fprintf(stderr, "exim:%s permission denied\n", debugset? " debugging" : "");
3477 /* If the real user is not root or the exim uid, the argument for passing
3478 in an open TCP/IP connection for another message is not permitted, nor is
3479 running with the -N option for any delivery action, unless this call to exim is
3480 one that supplied an input message, or we are using a patched exim for
3481 regression testing. */
3483 if (real_uid != root_uid && real_uid != exim_uid &&
3484 (continue_hostname != NULL ||
3486 (queue_interval >= 0 || daemon_listen || msg_action_arg > 0)
3487 )) && !running_in_test_harness)
3489 fprintf(stderr, "exim: Permission denied\n");
3490 return EXIT_FAILURE;
3493 /* If the caller is not trusted, certain arguments are ignored when running for
3494 real, but are permitted when checking things (-be, -bv, -bt, -bh, -bf, -bF).
3495 Note that authority for performing certain actions on messages is tested in the
3496 queue_action() function. */
3498 if (!trusted_caller && !checking && filter_test == FTEST_NONE)
3500 sender_host_name = sender_host_address = interface_address =
3501 sender_ident = received_protocol = NULL;
3502 sender_host_port = interface_port = 0;
3503 sender_host_authenticated = authenticated_sender = authenticated_id = NULL;
3506 /* If a sender host address is set, extract the optional port number off the
3507 end of it and check its syntax. Do the same thing for the interface address.
3508 Exim exits if the syntax is bad. */
3512 if (sender_host_address != NULL)
3513 sender_host_port = check_port(sender_host_address);
3514 if (interface_address != NULL)
3515 interface_port = check_port(interface_address);
3518 /* If an SMTP message is being received check to see if the standard input is a
3519 TCP/IP socket. If it is, we assume that Exim was called from inetd if the
3520 caller is root or the Exim user, or if the port is a privileged one. Otherwise,
3525 union sockaddr_46 inetd_sock;
3526 EXIM_SOCKLEN_T size = sizeof(inetd_sock);
3527 if (getpeername(0, (struct sockaddr *)(&inetd_sock), &size) == 0)
3529 int family = ((struct sockaddr *)(&inetd_sock))->sa_family;
3530 if (family == AF_INET || family == AF_INET6)
3532 union sockaddr_46 interface_sock;
3533 size = sizeof(interface_sock);
3535 if (getsockname(0, (struct sockaddr *)(&interface_sock), &size) == 0)
3536 interface_address = host_ntoa(-1, &interface_sock, NULL,
3539 if (host_is_tls_on_connect_port(interface_port)) tls_on_connect = TRUE;
3541 if (real_uid == root_uid || real_uid == exim_uid || interface_port < 1024)
3544 sender_host_address = host_ntoa(-1, (struct sockaddr *)(&inetd_sock),
3545 NULL, &sender_host_port);
3546 if (mua_wrapper) log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Input from "
3547 "inetd is not supported when mua_wrapper is set");
3552 "exim: Permission denied (unprivileged user, unprivileged port)\n");
3553 return EXIT_FAILURE;
3559 /* If the load average is going to be needed while receiving a message, get it
3560 now for those OS that require the first call to os_getloadavg() to be done as
3561 root. There will be further calls later for each message received. */
3563 #ifdef LOAD_AVG_NEEDS_ROOT
3564 if (receiving_message &&
3565 (queue_only_load >= 0 ||
3566 (is_inetd && smtp_load_reserve >= 0)
3569 load_average = OS_GETLOADAVG();
3573 /* The queue_only configuration option can be overridden by -odx on the command
3574 line, except that if queue_only_override is false, queue_only cannot be unset
3575 from the command line. */
3577 if (queue_only_set && (queue_only_override || arg_queue_only))
3578 queue_only = arg_queue_only;
3580 /* The receive_timeout and smtp_receive_timeout options can be overridden by
3583 if (arg_receive_timeout >= 0) receive_timeout = arg_receive_timeout;
3584 if (arg_smtp_receive_timeout >= 0)
3585 smtp_receive_timeout = arg_smtp_receive_timeout;
3587 /* If Exim was started with root privilege, unless we have already removed the
3588 root privilege above as a result of -C, -D, -be, -bf or -bF, remove it now
3589 except when starting the daemon or doing some kind of delivery or address
3590 testing (-bt). These are the only cases when root need to be retained. We run
3591 as exim for -bv and -bh. However, if deliver_drop_privilege is set, root is
3592 retained only for starting the daemon. We always do the initgroups() in this
3593 situation (controlled by the TRUE below), in order to be as close as possible
3594 to the state Exim usually runs in. */
3596 if (!unprivileged && /* originally had root AND */
3597 !removed_privilege && /* still got root AND */
3598 !daemon_listen && /* not starting the daemon */
3599 queue_interval <= 0 && /* (either kind of daemon) */
3601 deliver_drop_privilege || /* requested unprivileged */
3603 queue_interval < 0 && /* not running the queue */
3604 (msg_action_arg < 0 || /* and */
3605 msg_action != MSG_DELIVER) && /* not delivering and */
3606 (!checking || !address_test_mode) /* not address checking */
3610 exim_setugid(exim_uid, exim_gid, TRUE, US"privilege not needed");
3613 /* When we are retaining a privileged uid, we still change to the exim gid. */
3615 else setgid(exim_gid);
3617 /* Handle a request to scan a file for malware */
3618 if (malware_test_file)
3621 set_process_info("scanning file for malware");
3622 result = malware_in_file(malware_test_file);
3625 printf("No malware found.\n");
3630 printf("Malware lookup returned non-okay/fail: %d\n", result);
3634 printf("Malware found: %s\n", malware_name);
3636 printf("Malware scan detected malware of unknown name.\n");
3640 /* Handle a request to list the delivery queue */
3644 set_process_info("listing the queue");
3645 queue_list(list_queue_option, argv + recipients_arg, argc - recipients_arg);
3649 /* Handle a request to count the delivery queue */
3653 set_process_info("counting the queue");
3658 /* Handle actions on specific messages, except for the force delivery and
3659 message load actions, which are done below. Some actions take a whole list of
3660 message ids, which are known to continue up to the end of the arguments. Others
3661 take a single message id and then operate on the recipients list. */
3663 if (msg_action_arg > 0 && msg_action != MSG_DELIVER && msg_action != MSG_LOAD)
3665 int yield = EXIT_SUCCESS;
3666 set_process_info("acting on specified messages");
3668 if (!one_msg_action)
3670 for (i = msg_action_arg; i < argc; i++)
3671 if (!queue_action(argv[i], msg_action, NULL, 0, 0))
3672 yield = EXIT_FAILURE;
3675 else if (!queue_action(argv[msg_action_arg], msg_action, argv, argc,
3676 recipients_arg)) yield = EXIT_FAILURE;
3680 /* All the modes below here require the remaining configuration sections
3681 to be read, except that we can skip over the ACL setting when delivering
3682 specific messages, or doing a queue run. (For various testing cases we could
3683 skip too, but as they are rare, it doesn't really matter.) The argument is TRUE
3686 readconf_rest(msg_action_arg > 0 || (queue_interval == 0 && !daemon_listen));
3688 /* The configuration data will have been read into POOL_PERM because we won't
3689 ever want to reset back past it. Change the current pool to POOL_MAIN. In fact,
3690 this is just a bit of pedantic tidiness. It wouldn't really matter if the
3691 configuration were read into POOL_MAIN, because we don't do any resets till
3692 later on. However, it seems right, and it does ensure that both pools get used.
3695 store_pool = POOL_MAIN;
3697 /* Handle the -brt option. This is for checking out retry configurations.
3698 The next three arguments are a domain name or a complete address, and
3699 optionally two error numbers. All it does is to call the function that
3700 scans the retry configuration data. */
3702 if (test_retry_arg >= 0)
3704 retry_config *yield;
3705 int basic_errno = 0;
3709 if (test_retry_arg >= argc)
3711 printf("-brt needs a domain or address argument\n");
3712 exim_exit(EXIT_FAILURE);
3714 s1 = argv[test_retry_arg++];
3717 /* If the first argument contains no @ and no . it might be a local user
3718 or it might be a single-component name. Treat as a domain. */
3720 if (Ustrchr(s1, '@') == NULL && Ustrchr(s1, '.') == NULL)
3722 printf("Warning: \"%s\" contains no '@' and no '.' characters. It is "
3723 "being \ntreated as a one-component domain, not as a local part.\n\n",
3727 /* There may be an optional second domain arg. */
3729 if (test_retry_arg < argc && Ustrchr(argv[test_retry_arg], '.') != NULL)
3730 s2 = argv[test_retry_arg++];
3732 /* The final arg is an error name */
3734 if (test_retry_arg < argc)
3736 uschar *ss = argv[test_retry_arg];
3738 readconf_retry_error(ss, ss + Ustrlen(ss), &basic_errno, &more_errno);
3741 printf("%s\n", CS error);
3742 return EXIT_FAILURE;
3745 /* For the {MAIL,RCPT,DATA}_4xx errors, a value of 255 means "any", and a
3746 code > 100 as an error is for matching codes to the decade. Turn them into
3747 a real error code, off the decade. */
3749 if (basic_errno == ERRNO_MAIL4XX ||
3750 basic_errno == ERRNO_RCPT4XX ||
3751 basic_errno == ERRNO_DATA4XX)
3753 int code = (more_errno >> 8) & 255;
3755 more_errno = (more_errno & 0xffff00ff) | (21 << 8);
3756 else if (code > 100)
3757 more_errno = (more_errno & 0xffff00ff) | ((code - 96) << 8);
3761 yield = retry_find_config(s1, s2, basic_errno, more_errno);
3762 if (yield == NULL) printf("No retry information found\n"); else
3765 more_errno = yield->more_errno;
3766 printf("Retry rule: %s ", yield->pattern);
3768 if (yield->basic_errno == ERRNO_EXIMQUOTA)
3770 printf("quota%s%s ",
3771 (more_errno > 0)? "_" : "",
3772 (more_errno > 0)? readconf_printtime(more_errno) : US"");
3774 else if (yield->basic_errno == ECONNREFUSED)
3776 printf("refused%s%s ",
3777 (more_errno > 0)? "_" : "",
3778 (more_errno == 'M')? "MX" :
3779 (more_errno == 'A')? "A" : "");
3781 else if (yield->basic_errno == ETIMEDOUT)
3784 if ((more_errno & RTEF_CTOUT) != 0) printf("_connect");
3786 if (more_errno != 0) printf("_%s",
3787 (more_errno == 'M')? "MX" : "A");
3790 else if (yield->basic_errno == ERRNO_AUTHFAIL)
3791 printf("auth_failed ");
3794 for (r = yield->rules; r != NULL; r = r->next)
3796 printf("%c,%s", r->rule, readconf_printtime(r->timeout)); /* Do not */
3797 printf(",%s", readconf_printtime(r->p1)); /* amalgamate */
3803 printf(",%d.", x/1000);
3817 exim_exit(EXIT_SUCCESS);
3820 /* Handle a request to list one or more configuration options */
3824 set_process_info("listing variables");
3825 if (recipients_arg >= argc) readconf_print(US"all", NULL);
3826 else for (i = recipients_arg; i < argc; i++)
3829 (Ustrcmp(argv[i], "router") == 0 ||
3830 Ustrcmp(argv[i], "transport") == 0 ||
3831 Ustrcmp(argv[i], "authenticator") == 0 ||
3832 Ustrcmp(argv[i], "macro") == 0))
3834 readconf_print(argv[i+1], argv[i]);
3837 else readconf_print(argv[i], NULL);
3839 exim_exit(EXIT_SUCCESS);
3843 /* Handle a request to deliver one or more messages that are already on the
3844 queue. Values of msg_action other than MSG_DELIVER and MSG_LOAD are dealt with
3845 above. MSG_LOAD is handled with -be (which is the only time it applies) below.
3847 Delivery of specific messages is typically used for a small number when
3848 prodding by hand (when the option forced_delivery will be set) or when
3849 re-execing to regain root privilege. Each message delivery must happen in a
3850 separate process, so we fork a process for each one, and run them sequentially
3851 so that debugging output doesn't get intertwined, and to avoid spawning too
3852 many processes if a long list is given. However, don't fork for the last one;
3853 this saves a process in the common case when Exim is called to deliver just one
3856 if (msg_action_arg > 0 && msg_action != MSG_LOAD)
3858 if (prod_requires_admin && !admin_user)
3860 fprintf(stderr, "exim: Permission denied\n");
3861 exim_exit(EXIT_FAILURE);
3863 set_process_info("delivering specified messages");
3864 if (deliver_give_up) forced_delivery = deliver_force_thaw = TRUE;
3865 for (i = msg_action_arg; i < argc; i++)
3870 (void)deliver_message(argv[i], forced_delivery, deliver_give_up);
3871 else if ((pid = fork()) == 0)
3873 (void)deliver_message(argv[i], forced_delivery, deliver_give_up);
3874 _exit(EXIT_SUCCESS);
3878 fprintf(stderr, "failed to fork delivery process for %s: %s\n", argv[i],
3880 exim_exit(EXIT_FAILURE);
3884 exim_exit(EXIT_SUCCESS);
3888 /* If only a single queue run is requested, without SMTP listening, we can just
3889 turn into a queue runner, with an optional starting message id. */
3891 if (queue_interval == 0 && !daemon_listen)
3893 DEBUG(D_queue_run) debug_printf("Single queue run%s%s%s%s\n",
3894 (start_queue_run_id == NULL)? US"" : US" starting at ",
3895 (start_queue_run_id == NULL)? US"" : start_queue_run_id,
3896 (stop_queue_run_id == NULL)? US"" : US" stopping at ",
3897 (stop_queue_run_id == NULL)? US"" : stop_queue_run_id);
3898 set_process_info("running the queue (single queue run)");
3899 queue_run(start_queue_run_id, stop_queue_run_id, FALSE);
3900 exim_exit(EXIT_SUCCESS);
3904 /* Find the login name of the real user running this process. This is always
3905 needed when receiving a message, because it is written into the spool file. It
3906 may also be used to construct a from: or a sender: header, and in this case we
3907 need the user's full name as well, so save a copy of it, checked for RFC822
3908 syntax and munged if necessary, if it hasn't previously been set by the -F
3909 argument. We may try to get the passwd entry more than once, in case NIS or
3910 other delays are in evidence. Save the home directory for use in filter testing
3915 if ((pw = getpwuid(real_uid)) != NULL)
3917 originator_login = string_copy(US pw->pw_name);
3918 originator_home = string_copy(US pw->pw_dir);
3920 /* If user name has not been set by -F, set it from the passwd entry
3921 unless -f has been used to set the sender address by a trusted user. */
3923 if (originator_name == NULL)
3925 if (sender_address == NULL ||
3926 (!trusted_caller && filter_test == FTEST_NONE))
3928 uschar *name = US pw->pw_gecos;
3929 uschar *amp = Ustrchr(name, '&');
3932 /* Most Unix specify that a '&' character in the gecos field is
3933 replaced by a copy of the login name, and some even specify that
3934 the first character should be upper cased, so that's what we do. */
3939 string_format(buffer, sizeof(buffer), "%.*s%n%s%s",
3940 amp - name, name, &loffset, originator_login, amp + 1);
3941 buffer[loffset] = toupper(buffer[loffset]);
3945 /* If a pattern for matching the gecos field was supplied, apply
3946 it and then expand the name string. */
3948 if (gecos_pattern != NULL && gecos_name != NULL)
3951 re = regex_must_compile(gecos_pattern, FALSE, TRUE); /* Use malloc */
3953 if (regex_match_and_setup(re, name, 0, -1))
3955 uschar *new_name = expand_string(gecos_name);
3957 if (new_name != NULL)
3959 DEBUG(D_receive) debug_printf("user name \"%s\" extracted from "
3960 "gecos field \"%s\"\n", new_name, name);
3963 else DEBUG(D_receive) debug_printf("failed to expand gecos_name string "
3964 "\"%s\": %s\n", gecos_name, expand_string_message);
3966 else DEBUG(D_receive) debug_printf("gecos_pattern \"%s\" did not match "
3967 "gecos field \"%s\"\n", gecos_pattern, name);
3968 store_free((void *)re);
3970 originator_name = string_copy(name);
3973 /* A trusted caller has used -f but not -F */
3975 else originator_name = US"";
3978 /* Break the retry loop */
3983 if (++i > finduser_retries) break;
3987 /* If we cannot get a user login, log the incident and give up, unless the
3988 configuration specifies something to use. When running in the test harness,
3989 any setting of unknown_login overrides the actual name. */
3991 if (originator_login == NULL || running_in_test_harness)
3993 if (unknown_login != NULL)
3995 originator_login = expand_string(unknown_login);
3996 if (originator_name == NULL && unknown_username != NULL)
3997 originator_name = expand_string(unknown_username);
3998 if (originator_name == NULL) originator_name = US"";
4000 if (originator_login == NULL)
4001 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Failed to get user name for uid %d",
4005 /* Ensure that the user name is in a suitable form for use as a "phrase" in an
4008 originator_name = string_copy(parse_fix_phrase(originator_name,
4009 Ustrlen(originator_name), big_buffer, big_buffer_size));
4011 /* If a message is created by this call of Exim, the uid/gid of its originator
4012 are those of the caller. These values are overridden if an existing message is
4013 read in from the spool. */
4015 originator_uid = real_uid;
4016 originator_gid = real_gid;
4018 DEBUG(D_receive) debug_printf("originator: uid=%d gid=%d login=%s name=%s\n",
4019 (int)originator_uid, (int)originator_gid, originator_login, originator_name);
4021 /* Run in daemon and/or queue-running mode. The function daemon_go() never
4022 returns. We leave this till here so that the originator_ fields are available
4023 for incoming messages via the daemon. The daemon cannot be run in mua_wrapper
4026 if (daemon_listen || queue_interval > 0)
4030 fprintf(stderr, "Daemon cannot be run when mua_wrapper is set\n");
4031 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Daemon cannot be run when "
4032 "mua_wrapper is set");
4037 /* If the sender ident has not been set (by a trusted caller) set it to
4038 the caller. This will get overwritten below for an inetd call. If a trusted
4039 caller has set it empty, unset it. */
4041 if (sender_ident == NULL) sender_ident = originator_login;
4042 else if (sender_ident[0] == 0) sender_ident = NULL;
4044 /* Handle the -brw option, which is for checking out rewriting rules. Cause log
4045 writes (on errors) to go to stderr instead. Can't do this earlier, as want the
4046 originator_* variables set. */
4048 if (test_rewrite_arg >= 0)
4050 really_exim = FALSE;
4051 if (test_rewrite_arg >= argc)
4053 printf("-brw needs an address argument\n");
4054 exim_exit(EXIT_FAILURE);
4056 rewrite_test(argv[test_rewrite_arg]);
4057 exim_exit(EXIT_SUCCESS);
4060 /* A locally-supplied message is considered to be coming from a local user
4061 unless a trusted caller supplies a sender address with -f, or is passing in the
4062 message via SMTP (inetd invocation or otherwise). */
4064 if ((sender_address == NULL && !smtp_input) ||
4065 (!trusted_caller && filter_test == FTEST_NONE))
4067 sender_local = TRUE;
4069 /* A trusted caller can supply authenticated_sender and authenticated_id
4070 via -oMas and -oMai and if so, they will already be set. Otherwise, force
4071 defaults except when host checking. */
4073 if (authenticated_sender == NULL && !host_checking)
4074 authenticated_sender = string_sprintf("%s@%s", originator_login,
4075 qualify_domain_sender);
4076 if (authenticated_id == NULL && !host_checking)
4077 authenticated_id = originator_login;
4080 /* Trusted callers are always permitted to specify the sender address.
4081 Untrusted callers may specify it if it matches untrusted_set_sender, or if what
4082 is specified is the empty address. However, if a trusted caller does not
4083 specify a sender address for SMTP input, we leave sender_address unset. This
4084 causes the MAIL commands to be honoured. */
4086 if ((!smtp_input && sender_address == NULL) ||
4087 !receive_check_set_sender(sender_address))
4089 /* Either the caller is not permitted to set a general sender, or this is
4090 non-SMTP input and the trusted caller has not set a sender. If there is no
4091 sender, or if a sender other than <> is set, override with the originator's
4092 login (which will get qualified below), except when checking things. */
4094 if (sender_address == NULL /* No sender_address set */
4096 (sender_address[0] != 0 && /* Non-empty sender address, AND */
4097 !checking && /* Not running tests, AND */
4098 filter_test == FTEST_NONE)) /* Not testing a filter */
4100 sender_address = originator_login;
4101 sender_address_forced = FALSE;
4102 sender_address_domain = 0;
4106 /* Remember whether an untrusted caller set the sender address */
4108 sender_set_untrusted = sender_address != originator_login && !trusted_caller;
4110 /* Ensure that the sender address is fully qualified unless it is the empty
4111 address, which indicates an error message, or doesn't exist (root caller, smtp
4112 interface, no -f argument). */
4114 if (sender_address != NULL && sender_address[0] != 0 &&
4115 sender_address_domain == 0)
4116 sender_address = string_sprintf("%s@%s", local_part_quote(sender_address),
4117 qualify_domain_sender);
4119 DEBUG(D_receive) debug_printf("sender address = %s\n", sender_address);
4121 /* Handle a request to verify a list of addresses, or test them for delivery.
4122 This must follow the setting of the sender address, since routers can be
4123 predicated upon the sender. If no arguments are given, read addresses from
4124 stdin. Set debug_level to at least D_v to get full output for address testing.
4127 if (verify_address_mode || address_test_mode)
4130 int flags = vopt_qualify;
4132 if (verify_address_mode)
4134 if (!verify_as_sender) flags |= vopt_is_recipient;
4135 DEBUG(D_verify) debug_print_ids(US"Verifying:");
4140 flags |= vopt_is_recipient;
4141 debug_selector |= D_v;
4142 debug_file = stderr;
4143 debug_fd = fileno(debug_file);
4144 DEBUG(D_verify) debug_print_ids(US"Address testing:");
4147 if (recipients_arg < argc)
4149 while (recipients_arg < argc)
4151 uschar *s = argv[recipients_arg++];
4154 BOOL finished = FALSE;
4155 uschar *ss = parse_find_address_end(s, FALSE);
4156 if (*ss == ',') *ss = 0; else finished = TRUE;
4157 test_address(s, flags, &exit_value);
4160 while (*(++s) != 0 && (*s == ',' || isspace(*s)));
4167 uschar *s = get_stdinput(NULL, NULL);
4168 if (s == NULL) break;
4169 test_address(s, flags, &exit_value);
4173 exim_exit(exit_value);
4176 /* Handle expansion checking. Either expand items on the command line, or read
4177 from stdin if there aren't any. If -Mset was specified, load the message so
4178 that its variables can be used, but restrict this facility to admin users.
4179 Otherwise, if -bem was used, read a message from stdin. */
4183 if (msg_action_arg > 0 && msg_action == MSG_LOAD)
4185 uschar spoolname[256]; /* Not big_buffer; used in spool_read_header() */
4188 fprintf(stderr, "exim: permission denied\n");
4191 message_id = argv[msg_action_arg];
4192 (void)string_format(spoolname, sizeof(spoolname), "%s-H", message_id);
4193 if (!spool_open_datafile(message_id))
4194 printf ("Failed to load message datafile %s\n", message_id);
4195 if (spool_read_header(spoolname, TRUE, FALSE) != spool_read_OK)
4196 printf ("Failed to load message %s\n", message_id);
4199 /* Read a test message from a file. We fudge it up to be on stdin, saving
4200 stdin itself for later reading of expansion strings. */
4202 else if (expansion_test_message != NULL)
4204 int save_stdin = dup(0);
4205 int fd = Uopen(expansion_test_message, O_RDONLY, 0);
4208 fprintf(stderr, "exim: failed to open %s: %s\n", expansion_test_message,
4210 return EXIT_FAILURE;
4213 filter_test = FTEST_USER; /* Fudge to make it look like filter test */
4214 message_ended = END_NOTENDED;
4215 read_message_body(receive_msg(extract_recipients));
4216 message_linecount += body_linecount;
4217 (void)dup2(save_stdin, 0);
4218 (void)close(save_stdin);
4219 clearerr(stdin); /* Required by Darwin */
4222 /* Allow $recipients for this testing */
4224 enable_dollar_recipients = TRUE;
4226 /* Expand command line items */
4228 if (recipients_arg < argc)
4230 while (recipients_arg < argc)
4232 uschar *s = argv[recipients_arg++];
4233 uschar *ss = expand_string(s);
4234 if (ss == NULL) printf ("Failed: %s\n", expand_string_message);
4235 else printf("%s\n", CS ss);
4243 char *(*fn_readline)(char *) = NULL;
4244 char *(*fn_addhist)(char *) = NULL;
4247 void *dlhandle = set_readline(&fn_readline, &fn_addhist);
4253 uschar *source = get_stdinput(fn_readline, fn_addhist);
4254 if (source == NULL) break;
4255 ss = expand_string(source);
4257 printf ("Failed: %s\n", expand_string_message);
4258 else printf("%s\n", CS ss);
4262 if (dlhandle != NULL) dlclose(dlhandle);
4266 /* The data file will be open after -Mset */
4268 if (deliver_datafile >= 0)
4270 (void)close(deliver_datafile);
4271 deliver_datafile = -1;
4274 exim_exit(EXIT_SUCCESS);
4278 /* The active host name is normally the primary host name, but it can be varied
4279 for hosts that want to play several parts at once. We need to ensure that it is
4280 set for host checking, and for receiving messages. */
4282 smtp_active_hostname = primary_hostname;
4283 if (raw_active_hostname != NULL)
4285 uschar *nah = expand_string(raw_active_hostname);
4288 if (!expand_string_forcedfail)
4289 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to expand \"%s\" "
4290 "(smtp_active_hostname): %s", raw_active_hostname,
4291 expand_string_message);
4293 else if (nah[0] != 0) smtp_active_hostname = nah;
4296 /* Handle host checking: this facility mocks up an incoming SMTP call from a
4297 given IP address so that the blocking and relay configuration can be tested.
4298 Unless a sender_ident was set by -oMt, we discard it (the default is the
4299 caller's login name). An RFC 1413 call is made only if we are running in the
4300 test harness and an incoming interface and both ports are specified, because
4301 there is no TCP/IP call to find the ident for. */
4308 if (!sender_ident_set)
4310 sender_ident = NULL;
4311 if (running_in_test_harness && sender_host_port != 0 &&
4312 interface_address != NULL && interface_port != 0)
4313 verify_get_ident(1413);
4316 /* In case the given address is a non-canonical IPv6 address, canonicize
4317 it. The code works for both IPv4 and IPv6, as it happens. */
4319 size = host_aton(sender_host_address, x);
4320 sender_host_address = store_get(48); /* large enough for full IPv6 */
4321 (void)host_nmtoa(size, x, -1, sender_host_address, ':');
4323 /* Now set up for testing */
4325 host_build_sender_fullhost();
4329 sender_local = FALSE;
4330 sender_host_notsocket = TRUE;
4331 debug_file = stderr;
4332 debug_fd = fileno(debug_file);
4333 fprintf(stdout, "\n**** SMTP testing session as if from host %s\n"
4334 "**** but without any ident (RFC 1413) callback.\n"
4335 "**** This is not for real!\n\n",
4336 sender_host_address);
4338 if (verify_check_host(&hosts_connection_nolog) == OK)
4339 log_write_selector &= ~L_smtp_connection;
4340 log_write(L_smtp_connection, LOG_MAIN, "%s", smtp_get_connection_info());
4342 /* NOTE: We do *not* call smtp_log_no_mail() if smtp_start_session() fails,
4343 because a log line has already been written for all its failure exists
4344 (usually "connection refused: <reason>") and writing another one is
4345 unnecessary clutter. */
4347 if (smtp_start_session())
4349 reset_point = store_get(0);
4352 store_reset(reset_point);
4353 if (smtp_setup_msg() <= 0) break;
4354 if (!receive_msg(FALSE)) break;
4358 exim_exit(EXIT_SUCCESS);
4362 /* Arrange for message reception if recipients or SMTP were specified;
4363 otherwise complain unless a version print (-bV) happened or this is a filter
4364 verification test. In the former case, show the configuration file name. */
4366 if (recipients_arg >= argc && !extract_recipients && !smtp_input)
4368 if (version_printed)
4370 printf("Configuration file is %s\n", config_main_filename);
4371 return EXIT_SUCCESS;
4374 if (filter_test == FTEST_NONE)
4375 exim_usage(called_as);
4379 /* If mua_wrapper is set, Exim is being used to turn an MUA that submits on the
4380 standard input into an MUA that submits to a smarthost over TCP/IP. We know
4381 that we are not called from inetd, because that is rejected above. The
4382 following configuration settings are forced here:
4384 (1) Synchronous delivery (-odi)
4385 (2) Errors to stderr (-oep == -oeq)
4386 (3) No parallel remote delivery
4387 (4) Unprivileged delivery
4389 We don't force overall queueing options because there are several of them;
4390 instead, queueing is avoided below when mua_wrapper is set. However, we do need
4391 to override any SMTP queueing. */
4395 synchronous_delivery = TRUE;
4396 arg_error_handling = ERRORS_STDERR;
4397 remote_max_parallel = 1;
4398 deliver_drop_privilege = TRUE;
4400 queue_smtp_domains = NULL;
4404 /* Prepare to accept one or more new messages on the standard input. When a
4405 message has been read, its id is returned in message_id[]. If doing immediate
4406 delivery, we fork a delivery process for each received message, except for the
4407 last one, where we can save a process switch.
4409 It is only in non-smtp mode that error_handling is allowed to be changed from
4410 its default of ERRORS_SENDER by argument. (Idle thought: are any of the
4411 sendmail error modes other than -oem ever actually used? Later: yes.) */
4413 if (!smtp_input) error_handling = arg_error_handling;
4415 /* If this is an inetd call, ensure that stderr is closed to prevent panic
4416 logging being sent down the socket and make an identd call to get the
4421 (void)fclose(stderr);
4422 exim_nullstd(); /* Re-open to /dev/null */
4423 verify_get_ident(IDENT_PORT);
4424 host_build_sender_fullhost();
4425 set_process_info("handling incoming connection from %s via inetd",
4429 /* If the sender host address has been set, build sender_fullhost if it hasn't
4430 already been done (which it will have been for inetd). This caters for the
4431 case when it is forced by -oMa. However, we must flag that it isn't a socket,
4432 so that the test for IP options is skipped for -bs input. */
4434 if (sender_host_address != NULL && sender_fullhost == NULL)
4436 host_build_sender_fullhost();
4437 set_process_info("handling incoming connection from %s via -oMa",
4439 sender_host_notsocket = TRUE;
4442 /* Otherwise, set the sender host as unknown except for inetd calls. This
4443 prevents host checking in the case of -bs not from inetd and also for -bS. */
4445 else if (!is_inetd) sender_host_unknown = TRUE;
4447 /* If stdout does not exist, then dup stdin to stdout. This can happen
4448 if exim is started from inetd. In this case fd 0 will be set to the socket,
4449 but fd 1 will not be set. This also happens for passed SMTP channels. */
4451 if (fstat(1, &statbuf) < 0) (void)dup2(0, 1);
4453 /* Set up the incoming protocol name and the state of the program. Root is
4454 allowed to force received protocol via the -oMr option above. If we have come
4455 via inetd, the process info has already been set up. We don't set
4456 received_protocol here for smtp input, as it varies according to
4457 batch/HELO/EHLO/AUTH/TLS. */
4461 if (!is_inetd) set_process_info("accepting a local %sSMTP message from <%s>",
4462 smtp_batched_input? "batched " : "",
4463 (sender_address!= NULL)? sender_address : originator_login);
4467 if (received_protocol == NULL)
4468 received_protocol = string_sprintf("local%s", called_as);
4469 set_process_info("accepting a local non-SMTP message from <%s>",
4473 /* Initialize the session_local_queue-only flag (this will be ignored if
4474 mua_wrapper is set) */
4477 session_local_queue_only = queue_only;
4479 /* For non-SMTP and for batched SMTP input, check that there is enough space on
4480 the spool if so configured. On failure, we must not attempt to send an error
4481 message! (For interactive SMTP, the check happens at MAIL FROM and an SMTP
4482 error code is given.) */
4484 if ((!smtp_input || smtp_batched_input) && !receive_check_fs(0))
4486 fprintf(stderr, "exim: insufficient disk space\n");
4487 return EXIT_FAILURE;
4490 /* If this is smtp input of any kind, real or batched, handle the start of the
4493 NOTE: We do *not* call smtp_log_no_mail() if smtp_start_session() fails,
4494 because a log line has already been written for all its failure exists
4495 (usually "connection refused: <reason>") and writing another one is
4496 unnecessary clutter. */
4502 if (verify_check_host(&hosts_connection_nolog) == OK)
4503 log_write_selector &= ~L_smtp_connection;
4504 log_write(L_smtp_connection, LOG_MAIN, "%s", smtp_get_connection_info());
4505 if (!smtp_start_session())
4508 exim_exit(EXIT_SUCCESS);
4512 /* Otherwise, set up the input size limit here. */
4516 thismessage_size_limit = expand_string_integer(message_size_limit, TRUE);
4517 if (expand_string_message != NULL)
4519 if (thismessage_size_limit == -1)
4520 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to expand "
4521 "message_size_limit: %s", expand_string_message);
4523 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "invalid value for "
4524 "message_size_limit: %s", expand_string_message);
4528 /* Loop for several messages when reading SMTP input. If we fork any child
4529 processes, we don't want to wait for them unless synchronous delivery is
4530 requested, so set SIGCHLD to SIG_IGN in that case. This is not necessarily the
4531 same as SIG_DFL, despite the fact that documentation often lists the default as
4532 "ignore". This is a confusing area. This is what I know:
4534 At least on some systems (e.g. Solaris), just setting SIG_IGN causes child
4535 processes that complete simply to go away without ever becoming defunct. You
4536 can't then wait for them - but we don't want to wait for them in the
4537 non-synchronous delivery case. However, this behaviour of SIG_IGN doesn't
4538 happen for all OS (e.g. *BSD is different).
4540 But that's not the end of the story. Some (many? all?) systems have the
4541 SA_NOCLDWAIT option for sigaction(). This requests the behaviour that Solaris
4542 has by default, so it seems that the difference is merely one of default
4543 (compare restarting vs non-restarting signals).
4545 To cover all cases, Exim sets SIG_IGN with SA_NOCLDWAIT here if it can. If not,
4546 it just sets SIG_IGN. To be on the safe side it also calls waitpid() at the end
4547 of the loop below. Paranoia rules.
4549 February 2003: That's *still* not the end of the story. There are now versions
4550 of Linux (where SIG_IGN does work) that are picky. If, having set SIG_IGN, a
4551 process then calls waitpid(), a grumble is written to the system log, because
4552 this is logically inconsistent. In other words, it doesn't like the paranoia.
4553 As a consequenc of this, the waitpid() below is now excluded if we are sure
4554 that SIG_IGN works. */
4556 if (!synchronous_delivery)
4559 struct sigaction act;
4560 act.sa_handler = SIG_IGN;
4561 sigemptyset(&(act.sa_mask));
4562 act.sa_flags = SA_NOCLDWAIT;
4563 sigaction(SIGCHLD, &act, NULL);
4565 signal(SIGCHLD, SIG_IGN);
4569 /* Save the current store pool point, for resetting at the start of
4570 each message, and save the real sender address, if any. */
4572 reset_point = store_get(0);
4573 real_sender_address = sender_address;
4575 /* Loop to receive messages; receive_msg() returns TRUE if there are more
4576 messages to be read (SMTP input), or FALSE otherwise (not SMTP, or SMTP channel
4581 store_reset(reset_point);
4584 /* Handle the SMTP case; call smtp_setup_mst() to deal with the initial SMTP
4585 input and build the recipients list, before calling receive_msg() to read the
4586 message proper. Whatever sender address is given in the SMTP transaction is
4587 often ignored for local senders - we use the actual sender, which is normally
4588 either the underlying user running this process or a -f argument provided by
4589 a trusted caller. It is saved in real_sender_address. The test for whether to
4590 accept the SMTP sender is encapsulated in receive_check_set_sender(). */
4595 if ((rc = smtp_setup_msg()) > 0)
4597 if (real_sender_address != NULL &&
4598 !receive_check_set_sender(sender_address))
4600 sender_address = raw_sender = real_sender_address;
4601 sender_address_unrewritten = NULL;
4604 /* For batched SMTP, we have to run the acl_not_smtp_start ACL, since it
4605 isn't really SMTP, so no other ACL will run until the acl_not_smtp one at
4606 the very end. The result of the ACL is ignored (as for other non-SMTP
4607 messages). It is run for its potential side effects. */
4609 if (smtp_batched_input && acl_not_smtp_start != NULL)
4611 uschar *user_msg, *log_msg;
4612 enable_dollar_recipients = TRUE;
4613 (void)acl_check(ACL_WHERE_NOTSMTP_START, NULL, acl_not_smtp_start,
4614 &user_msg, &log_msg);
4615 enable_dollar_recipients = FALSE;
4618 /* Now get the data for the message */
4620 more = receive_msg(extract_recipients);
4621 if (message_id[0] == 0)
4624 smtp_log_no_mail(); /* Log no mail if configured */
4625 exim_exit(EXIT_FAILURE);
4630 smtp_log_no_mail(); /* Log no mail if configured */
4631 exim_exit((rc == 0)? EXIT_SUCCESS : EXIT_FAILURE);
4635 /* In the non-SMTP case, we have all the information from the command
4636 line, but must process it in case it is in the more general RFC822
4637 format, and in any case, to detect syntax errors. Also, it appears that
4638 the use of comma-separated lists as single arguments is common, so we
4639 had better support them. */
4645 int count = argc - recipients_arg;
4646 uschar **list = argv + recipients_arg;
4648 /* These options cannot be changed dynamically for non-SMTP messages */
4650 active_local_sender_retain = local_sender_retain;
4651 active_local_from_check = local_from_check;
4653 /* Save before any rewriting */
4655 raw_sender = string_copy(sender_address);
4657 /* Loop for each argument */
4659 for (i = 0; i < count; i++)
4661 int start, end, domain;
4663 uschar *s = list[i];
4665 /* Loop for each comma-separated address */
4669 BOOL finished = FALSE;
4671 uschar *ss = parse_find_address_end(s, FALSE);
4673 if (*ss == ',') *ss = 0; else finished = TRUE;
4675 /* Check max recipients - if -t was used, these aren't recipients */
4677 if (recipients_max > 0 && ++rcount > recipients_max &&
4678 !extract_recipients)
4680 if (error_handling == ERRORS_STDERR)
4682 fprintf(stderr, "exim: too many recipients\n");
4683 exim_exit(EXIT_FAILURE);
4688 moan_to_sender(ERRMESS_TOOMANYRECIP, NULL, NULL, stdin, TRUE)?
4689 errors_sender_rc : EXIT_FAILURE;
4694 parse_extract_address(s, &errmess, &start, &end, &domain, FALSE);
4696 if (domain == 0 && !allow_unqualified_recipient)
4699 errmess = US"unqualified recipient address not allowed";
4702 if (recipient == NULL)
4704 if (error_handling == ERRORS_STDERR)
4706 fprintf(stderr, "exim: bad recipient address \"%s\": %s\n",
4707 string_printing(list[i]), errmess);
4708 exim_exit(EXIT_FAILURE);
4714 eblock.text1 = string_printing(list[i]);
4715 eblock.text2 = errmess;
4717 moan_to_sender(ERRMESS_BADARGADDRESS, &eblock, NULL, stdin, TRUE)?
4718 errors_sender_rc : EXIT_FAILURE;
4722 receive_add_recipient(recipient, -1);
4725 while (*(++s) != 0 && (*s == ',' || isspace(*s)));
4729 /* Show the recipients when debugging */
4734 if (sender_address != NULL) debug_printf("Sender: %s\n", sender_address);
4735 if (recipients_list != NULL)
4737 debug_printf("Recipients:\n");
4738 for (i = 0; i < recipients_count; i++)
4739 debug_printf(" %s\n", recipients_list[i].address);
4743 /* Run the acl_not_smtp_start ACL if required. The result of the ACL is
4744 ignored; rejecting here would just add complication, and it can just as
4745 well be done later. Allow $recipients to be visible in the ACL. */
4747 if (acl_not_smtp_start != NULL)
4749 uschar *user_msg, *log_msg;
4750 enable_dollar_recipients = TRUE;
4751 (void)acl_check(ACL_WHERE_NOTSMTP_START, NULL, acl_not_smtp_start,
4752 &user_msg, &log_msg);
4753 enable_dollar_recipients = FALSE;
4756 /* Read the data for the message. If filter_test is not FTEST_NONE, this
4757 will just read the headers for the message, and not write anything onto the
4760 message_ended = END_NOTENDED;
4761 more = receive_msg(extract_recipients);
4763 /* more is always FALSE here (not SMTP message) when reading a message
4764 for real; when reading the headers of a message for filter testing,
4765 it is TRUE if the headers were terminated by '.' and FALSE otherwise. */
4767 if (message_id[0] == 0) exim_exit(EXIT_FAILURE);
4768 } /* Non-SMTP message reception */
4770 /* If this is a filter testing run, there are headers in store, but
4771 no message on the spool. Run the filtering code in testing mode, setting
4772 the domain to the qualify domain and the local part to the current user,
4773 unless they have been set by options. The prefix and suffix are left unset
4774 unless specified. The the return path is set to to the sender unless it has
4775 already been set from a return-path header in the message. */
4777 if (filter_test != FTEST_NONE)
4779 deliver_domain = (ftest_domain != NULL)?
4780 ftest_domain : qualify_domain_recipient;
4781 deliver_domain_orig = deliver_domain;
4782 deliver_localpart = (ftest_localpart != NULL)?
4783 ftest_localpart : originator_login;
4784 deliver_localpart_orig = deliver_localpart;
4785 deliver_localpart_prefix = ftest_prefix;
4786 deliver_localpart_suffix = ftest_suffix;
4787 deliver_home = originator_home;
4789 if (return_path == NULL)
4791 printf("Return-path copied from sender\n");
4792 return_path = string_copy(sender_address);
4796 printf("Return-path = %s\n", (return_path[0] == 0)? US"<>" : return_path);
4798 printf("Sender = %s\n", (sender_address[0] == 0)? US"<>" : sender_address);
4800 receive_add_recipient(
4801 string_sprintf("%s%s%s@%s",
4802 (ftest_prefix == NULL)? US"" : ftest_prefix,
4804 (ftest_suffix == NULL)? US"" : ftest_suffix,
4805 deliver_domain), -1);
4807 printf("Recipient = %s\n", recipients_list[0].address);
4808 if (ftest_prefix != NULL) printf("Prefix = %s\n", ftest_prefix);
4809 if (ftest_suffix != NULL) printf("Suffix = %s\n", ftest_suffix);
4811 (void)chdir("/"); /* Get away from wherever the user is running this from */
4813 /* Now we run either a system filter test, or a user filter test, or both.
4814 In the latter case, headers added by the system filter will persist and be
4815 available to the user filter. We need to copy the filter variables
4818 if ((filter_test & FTEST_SYSTEM) != 0)
4820 if (!filter_runtest(filter_sfd, filter_test_sfile, TRUE, more))
4821 exim_exit(EXIT_FAILURE);
4824 memcpy(filter_sn, filter_n, sizeof(filter_sn));
4826 if ((filter_test & FTEST_USER) != 0)
4828 if (!filter_runtest(filter_ufd, filter_test_ufile, FALSE, more))
4829 exim_exit(EXIT_FAILURE);
4832 exim_exit(EXIT_SUCCESS);
4835 /* Else act on the result of message reception. We should not get here unless
4836 message_id[0] is non-zero. If queue_only is set, session_local_queue_only
4837 will be TRUE. If it is not, check on the number of messages received in this
4840 if (!session_local_queue_only &&
4841 smtp_accept_queue_per_connection > 0 &&
4842 receive_messagecount > smtp_accept_queue_per_connection)
4844 session_local_queue_only = TRUE;
4845 queue_only_reason = 2;
4848 /* Initialize local_queue_only from session_local_queue_only. If it is false,
4849 and queue_only_load is set, check that the load average is below it. If it is
4850 not, set local_queue_only TRUE. If queue_only_load_latch is true (the
4851 default), we put the whole session into queue_only mode. It then remains this
4852 way for any subsequent messages on the same SMTP connection. This is a
4853 deliberate choice; even though the load average may fall, it doesn't seem
4854 right to deliver later messages on the same call when not delivering earlier
4855 ones. However, there are odd cases where this is not wanted, so this can be
4856 changed by setting queue_only_load_latch false. */
4858 local_queue_only = session_local_queue_only;
4859 if (!local_queue_only && queue_only_load >= 0)
4861 local_queue_only = (load_average = OS_GETLOADAVG()) > queue_only_load;
4862 if (local_queue_only)
4864 queue_only_reason = 3;
4865 if (queue_only_load_latch) session_local_queue_only = TRUE;
4869 /* If running as an MUA wrapper, all queueing options and freezing options
4873 local_queue_only = queue_only_policy = deliver_freeze = FALSE;
4875 /* Log the queueing here, when it will get a message id attached, but
4876 not if queue_only is set (case 0). Case 1 doesn't happen here (too many
4879 if (local_queue_only) switch(queue_only_reason)
4882 log_write(L_delay_delivery,
4883 LOG_MAIN, "no immediate delivery: more than %d messages "
4884 "received in one connection", smtp_accept_queue_per_connection);
4888 log_write(L_delay_delivery,
4889 LOG_MAIN, "no immediate delivery: load average %.2f",
4890 (double)load_average/1000.0);
4894 /* Else do the delivery unless the ACL or local_scan() called for queue only
4895 or froze the message. Always deliver in a separate process. A fork failure is
4896 not a disaster, as the delivery will eventually happen on a subsequent queue
4897 run. The search cache must be tidied before the fork, as the parent will
4898 do it before exiting. The child will trigger a lookup failure and
4899 thereby defer the delivery if it tries to use (for example) a cached ldap
4900 connection that the parent has called unbind on. */
4902 else if (!queue_only_policy && !deliver_freeze)
4907 if ((pid = fork()) == 0)
4910 close_unwanted(); /* Close unwanted file descriptors and TLS */
4911 exim_nullstd(); /* Ensure std{in,out,err} exist */
4913 /* Re-exec Exim if we need to regain privilege (note: in mua_wrapper
4914 mode, deliver_drop_privilege is forced TRUE). */
4916 if (geteuid() != root_uid && !deliver_drop_privilege && !unprivileged)
4918 (void)child_exec_exim(CEE_EXEC_EXIT, FALSE, NULL, FALSE, 2, US"-Mc",
4920 /* Control does not return here. */
4923 /* No need to re-exec */
4925 rc = deliver_message(message_id, FALSE, FALSE);
4927 _exit((!mua_wrapper || rc == DELIVER_MUA_SUCCEEDED)?
4928 EXIT_SUCCESS : EXIT_FAILURE);
4933 log_write(0, LOG_MAIN|LOG_PANIC, "failed to fork automatic delivery "
4934 "process: %s", strerror(errno));
4937 /* In the parent, wait if synchronous delivery is required. This will
4938 always be the case in MUA wrapper mode. */
4940 else if (synchronous_delivery)
4943 while (wait(&status) != pid);
4944 if ((status & 0x00ff) != 0)
4945 log_write(0, LOG_MAIN|LOG_PANIC,
4946 "process %d crashed with signal %d while delivering %s",
4947 (int)pid, status & 0x00ff, message_id);
4948 if (mua_wrapper && (status & 0xffff) != 0) exim_exit(EXIT_FAILURE);
4952 /* The loop will repeat if more is TRUE. If we do not know know that the OS
4953 automatically reaps children (see comments above the loop), clear away any
4954 finished subprocesses here, in case there are lots of messages coming in
4955 from the same source. */
4957 #ifndef SIG_IGN_WORKS
4958 while (waitpid(-1, NULL, WNOHANG) > 0);
4962 exim_exit(EXIT_SUCCESS); /* Never returns */
4963 return 0; /* To stop compiler warning */