1 /* $Cambridge: exim/src/src/exim.c,v 1.36 2006/02/23 10:25:01 ph10 Exp $ */
3 /*************************************************
4 * Exim - an Internet mail transport agent *
5 *************************************************/
7 /* Copyright (c) University of Cambridge 1995 - 2006 */
8 /* See the file NOTICE for conditions of use and distribution. */
11 /* The main function: entry point, initialization, and high-level control.
12 Also a few functions that don't naturally fit elsewhere. */
19 /*************************************************
20 * Function interface to store functions *
21 *************************************************/
23 /* We need some real functions to pass to the PCRE regular expression library
24 for store allocation via Exim's store manager. The normal calls are actually
25 macros that pass over location information to make tracing easier. These
26 functions just interface to the standard macro calls. A good compiler will
27 optimize out the tail recursion and so not make them too expensive. There
28 are two sets of functions; one for use when we want to retain the compiled
29 regular expression for a long time; the other for short-term use. */
32 function_store_get(size_t size)
34 return store_get((int)size);
38 function_dummy_free(void *block) { block = block; }
41 function_store_malloc(size_t size)
43 return store_malloc((int)size);
47 function_store_free(void *block)
55 /*************************************************
56 * Compile regular expression and panic on fail *
57 *************************************************/
59 /* This function is called when failure to compile a regular expression leads
60 to a panic exit. In other cases, pcre_compile() is called directly. In many
61 cases where this function is used, the results of the compilation are to be
62 placed in long-lived store, so we temporarily reset the store management
63 functions that PCRE uses if the use_malloc flag is set.
66 pattern the pattern to compile
67 caseless TRUE if caseless matching is required
68 use_malloc TRUE if compile into malloc store
70 Returns: pointer to the compiled pattern
74 regex_must_compile(uschar *pattern, BOOL caseless, BOOL use_malloc)
77 int options = PCRE_COPT;
82 pcre_malloc = function_store_malloc;
83 pcre_free = function_store_free;
85 if (caseless) options |= PCRE_CASELESS;
86 yield = pcre_compile(CS pattern, options, (const char **)&error, &offset, NULL);
87 pcre_malloc = function_store_get;
88 pcre_free = function_dummy_free;
90 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "regular expression error: "
91 "%s at offset %d while compiling %s", error, offset, pattern);
98 /*************************************************
99 * Execute regular expression and set strings *
100 *************************************************/
102 /* This function runs a regular expression match, and sets up the pointers to
103 the matched substrings.
106 re the compiled expression
107 subject the subject string
108 options additional PCRE options
109 setup if < 0 do full setup
110 if >= 0 setup from setup+1 onwards,
111 excluding the full matched string
113 Returns: TRUE or FALSE
117 regex_match_and_setup(const pcre *re, uschar *subject, int options, int setup)
119 int ovector[3*(EXPAND_MAXN+1)];
120 int n = pcre_exec(re, NULL, CS subject, Ustrlen(subject), 0,
121 PCRE_EOPT | options, ovector, sizeof(ovector)/sizeof(int));
123 if (n == 0) n = EXPAND_MAXN + 1;
127 expand_nmax = (setup < 0)? 0 : setup + 1;
128 for (nn = (setup < 0)? 0 : 2; nn < n*2; nn += 2)
130 expand_nstring[expand_nmax] = subject + ovector[nn];
131 expand_nlength[expand_nmax++] = ovector[nn+1] - ovector[nn];
141 /*************************************************
142 * Handler for SIGUSR1 *
143 *************************************************/
145 /* SIGUSR1 causes any exim process to write to the process log details of
146 what it is currently doing. It will only be used if the OS is capable of
147 setting up a handler that causes automatic restarting of any system call
148 that is in progress at the time.
150 Argument: the signal number (SIGUSR1)
155 usr1_handler(int sig)
157 sig = sig; /* Keep picky compilers happy */
158 log_write(0, LOG_PROCESS, "%s", process_info);
160 os_restarting_signal(SIGUSR1, usr1_handler);
165 /*************************************************
167 *************************************************/
169 /* This handler is enabled most of the time that Exim is running. The handler
170 doesn't actually get used unless alarm() has been called to set a timer, to
171 place a time limit on a system call of some kind. When the handler is run, it
174 There are some other SIGALRM handlers that are used in special cases when more
175 than just a flag setting is required; for example, when reading a message's
176 input. These are normally set up in the code module that uses them, and the
177 SIGALRM handler is reset to this one afterwards.
179 Argument: the signal value (SIGALRM)
184 sigalrm_handler(int sig)
186 sig = sig; /* Keep picky compilers happy */
188 os_non_restarting_signal(SIGALRM, sigalrm_handler);
193 /*************************************************
194 * Sleep for a fractional time interval *
195 *************************************************/
197 /* This function is called by millisleep() and exim_wait_tick() to wait for a
198 period of time that may include a fraction of a second. The coding is somewhat
199 tedious. We do not expect setitimer() ever to fail, but if it does, the process
200 will wait for ever, so we panic in this instance. (There was a case of this
201 when a bug in a function that calls milliwait() caused it to pass invalid data.
202 That's when I added the check. :-)
204 Argument: an itimerval structure containing the interval
209 milliwait(struct itimerval *itval)
212 sigset_t old_sigmask;
213 (void)sigemptyset(&sigmask); /* Empty mask */
214 (void)sigaddset(&sigmask, SIGALRM); /* Add SIGALRM */
215 (void)sigprocmask(SIG_BLOCK, &sigmask, &old_sigmask); /* Block SIGALRM */
216 if (setitimer(ITIMER_REAL, itval, NULL) < 0) /* Start timer */
217 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
218 "setitimer() failed: %s", strerror(errno));
219 (void)sigfillset(&sigmask); /* All signals */
220 (void)sigdelset(&sigmask, SIGALRM); /* Remove SIGALRM */
221 (void)sigsuspend(&sigmask); /* Until SIGALRM */
222 (void)sigprocmask(SIG_SETMASK, &old_sigmask, NULL); /* Restore mask */
228 /*************************************************
229 * Millisecond sleep function *
230 *************************************************/
232 /* The basic sleep() function has a granularity of 1 second, which is too rough
233 in some cases - for example, when using an increasing delay to slow down
236 Argument: number of millseconds
243 struct itimerval itval;
244 itval.it_interval.tv_sec = 0;
245 itval.it_interval.tv_usec = 0;
246 itval.it_value.tv_sec = msec/1000;
247 itval.it_value.tv_usec = (msec % 1000) * 1000;
253 /*************************************************
254 * Compare microsecond times *
255 *************************************************/
262 Returns: -1, 0, or +1
266 exim_tvcmp(struct timeval *t1, struct timeval *t2)
268 if (t1->tv_sec > t2->tv_sec) return +1;
269 if (t1->tv_sec < t2->tv_sec) return -1;
270 if (t1->tv_usec > t2->tv_usec) return +1;
271 if (t1->tv_usec < t2->tv_usec) return -1;
278 /*************************************************
279 * Clock tick wait function *
280 *************************************************/
282 /* Exim uses a time + a pid to generate a unique identifier in two places: its
283 message IDs, and in file names for maildir deliveries. Because some OS now
284 re-use pids within the same second, sub-second times are now being used.
285 However, for absolute certaintly, we must ensure the clock has ticked before
286 allowing the relevant process to complete. At the time of implementation of
287 this code (February 2003), the speed of processors is such that the clock will
288 invariably have ticked already by the time a process has done its job. This
289 function prepares for the time when things are faster - and it also copes with
290 clocks that go backwards.
293 then_tv A timeval which was used to create uniqueness; its usec field
294 has been rounded down to the value of the resolution.
295 We want to be sure the current time is greater than this.
296 resolution The resolution that was used to divide the microseconds
297 (1 for maildir, larger for message ids)
303 exim_wait_tick(struct timeval *then_tv, int resolution)
305 struct timeval now_tv;
306 long int now_true_usec;
308 (void)gettimeofday(&now_tv, NULL);
309 now_true_usec = now_tv.tv_usec;
310 now_tv.tv_usec = (now_true_usec/resolution) * resolution;
312 if (exim_tvcmp(&now_tv, then_tv) <= 0)
314 struct itimerval itval;
315 itval.it_interval.tv_sec = 0;
316 itval.it_interval.tv_usec = 0;
317 itval.it_value.tv_sec = then_tv->tv_sec - now_tv.tv_sec;
318 itval.it_value.tv_usec = then_tv->tv_usec + resolution - now_true_usec;
320 /* We know that, overall, "now" is less than or equal to "then". Therefore, a
321 negative value for the microseconds is possible only in the case when "now"
322 is more than a second less than "then". That means that itval.it_value.tv_sec
323 is greater than zero. The following correction is therefore safe. */
325 if (itval.it_value.tv_usec < 0)
327 itval.it_value.tv_usec += 1000000;
328 itval.it_value.tv_sec -= 1;
331 DEBUG(D_transport|D_receive)
333 if (!running_in_test_harness)
335 debug_printf("tick check: %lu.%06lu %lu.%06lu\n",
336 then_tv->tv_sec, then_tv->tv_usec, now_tv.tv_sec, now_tv.tv_usec);
337 debug_printf("waiting %lu.%06lu\n", itval.it_value.tv_sec,
338 itval.it_value.tv_usec);
349 /*************************************************
350 * Set up processing details *
351 *************************************************/
353 /* Save a text string for dumping when SIGUSR1 is received.
354 Do checks for overruns.
356 Arguments: format and arguments, as for printf()
361 set_process_info(char *format, ...)
365 sprintf(CS process_info, "%5d ", (int)getpid());
366 len = Ustrlen(process_info);
367 va_start(ap, format);
368 if (!string_vformat(process_info + len, PROCESS_INFO_SIZE - len, format, ap))
369 Ustrcpy(process_info + len, "**** string overflowed buffer ****");
370 DEBUG(D_process_info) debug_printf("set_process_info: %s\n", process_info);
378 /*************************************************
379 * Call fopen() with umask 777 and adjust mode *
380 *************************************************/
382 /* Exim runs with umask(0) so that files created with open() have the mode that
383 is specified in the open() call. However, there are some files, typically in
384 the spool directory, that are created with fopen(). They end up world-writeable
385 if no precautions are taken. Although the spool directory is not accessible to
386 the world, this is an untidiness. So this is a wrapper function for fopen()
387 that sorts out the mode of the created file.
390 filename the file name
391 options the fopen() options
392 mode the required mode
394 Returns: the fopened FILE or NULL
398 modefopen(uschar *filename, char *options, mode_t mode)
400 mode_t saved_umask = umask(0777);
401 FILE *f = Ufopen(filename, options);
402 (void)umask(saved_umask);
403 if (f != NULL) (void)fchmod(fileno(f), mode);
410 /*************************************************
411 * Ensure stdin, stdout, and stderr exist *
412 *************************************************/
414 /* Some operating systems grumble if an exec() happens without a standard
415 input, output, and error (fds 0, 1, 2) being defined. The worry is that some
416 file will be opened and will use these fd values, and then some other bit of
417 code will assume, for example, that it can write error messages to stderr.
418 This function ensures that fds 0, 1, and 2 are open if they do not already
419 exist, by connecting them to /dev/null.
421 This function is also used to ensure that std{in,out,err} exist at all times,
422 so that if any library that Exim calls tries to use them, it doesn't crash.
434 for (i = 0; i <= 2; i++)
436 if (fstat(i, &statbuf) < 0 && errno == EBADF)
438 if (devnull < 0) devnull = open("/dev/null", O_RDWR);
439 if (devnull < 0) log_write(0, LOG_MAIN|LOG_PANIC_DIE, "%s",
440 string_open_failed(errno, "/dev/null"));
441 if (devnull != i) (void)dup2(devnull, i);
444 if (devnull > 2) (void)close(devnull);
450 /*************************************************
451 * Close unwanted file descriptors for delivery *
452 *************************************************/
454 /* This function is called from a new process that has been forked to deliver
455 an incoming message, either directly, or using exec.
457 We want any smtp input streams to be closed in this new process. However, it
458 has been observed that using fclose() here causes trouble. When reading in -bS
459 input, duplicate copies of messages have been seen. The files will be sharing a
460 file pointer with the parent process, and it seems that fclose() (at least on
461 some systems - I saw this on Solaris 2.5.1) messes with that file pointer, at
462 least sometimes. Hence we go for closing the underlying file descriptors.
464 If TLS is active, we want to shut down the TLS library, but without molesting
465 the parent's SSL connection.
467 For delivery of a non-SMTP message, we want to close stdin and stdout (and
468 stderr unless debugging) because the calling process might have set them up as
469 pipes and be waiting for them to close before it waits for the submission
470 process to terminate. If they aren't closed, they hold up the calling process
471 until the initial delivery process finishes, which is not what we want.
473 Exception: We do want it for synchronous delivery!
475 And notwithstanding all the above, if D_resolver is set, implying resolver
476 debugging, leave stdout open, because that's where the resolver writes its
479 When we close stderr (which implies we've also closed stdout), we also get rid
480 of any controlling terminal.
492 tls_close(FALSE); /* Shut down the TLS library */
494 (void)close(fileno(smtp_in));
495 (void)close(fileno(smtp_out));
500 (void)close(0); /* stdin */
501 if ((debug_selector & D_resolver) == 0) (void)close(1); /* stdout */
502 if (debug_selector == 0) /* stderr */
504 if (!synchronous_delivery)
517 /*************************************************
519 *************************************************/
521 /* This function sets a new uid and gid permanently, optionally calling
522 initgroups() to set auxiliary groups. There are some special cases when running
523 Exim in unprivileged modes. In these situations the effective uid will not be
524 root; if we already have the right effective uid/gid, and don't need to
525 initialize any groups, leave things as they are.
530 igflag TRUE if initgroups() wanted
531 msg text to use in debugging output and failure log
533 Returns: nothing; bombs out on failure
537 exim_setugid(uid_t uid, gid_t gid, BOOL igflag, uschar *msg)
539 uid_t euid = geteuid();
540 gid_t egid = getegid();
542 if (euid == root_uid || euid != uid || egid != gid || igflag)
544 /* At least one OS returns +1 for initgroups failure, so just check for
549 struct passwd *pw = getpwuid(uid);
552 if (initgroups(pw->pw_name, gid) != 0)
553 log_write(0,LOG_MAIN|LOG_PANIC_DIE,"initgroups failed for uid=%ld: %s",
554 (long int)uid, strerror(errno));
556 else log_write(0, LOG_MAIN|LOG_PANIC_DIE, "cannot run initgroups(): "
557 "no passwd entry for uid=%ld", (long int)uid);
560 if (setgid(gid) < 0 || setuid(uid) < 0)
562 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "unable to set gid=%ld or uid=%ld "
563 "(euid=%ld): %s", (long int)gid, (long int)uid, (long int)euid, msg);
567 /* Debugging output included uid/gid and all groups */
572 gid_t group_list[NGROUPS_MAX];
573 debug_printf("changed uid/gid: %s\n uid=%ld gid=%ld pid=%ld\n", msg,
574 (long int)geteuid(), (long int)getegid(), (long int)getpid());
575 group_count = getgroups(NGROUPS_MAX, group_list);
576 debug_printf(" auxiliary group list:");
580 for (i = 0; i < group_count; i++) debug_printf(" %d", (int)group_list[i]);
582 else debug_printf(" <none>");
590 /*************************************************
592 *************************************************/
594 /* Exim exits via this function so that it always clears up any open
600 Returns: does not return
608 debug_printf(">>>>>>>>>>>>>>>> Exim pid=%d terminating with rc=%d "
609 ">>>>>>>>>>>>>>>>\n", (int)getpid(), rc);
616 /*************************************************
617 * Extract port from host address *
618 *************************************************/
620 /* Called to extract the port from the values given to -oMa and -oMi.
621 It also checks the syntax of the address, and terminates it before the
622 port data when a port is extracted.
625 address the address, with possible port on the end
627 Returns: the port, or zero if there isn't one
628 bombs out on a syntax error
632 check_port(uschar *address)
634 int port = host_address_extract_port(address);
635 if (string_is_ip_address(address, NULL) == 0)
637 fprintf(stderr, "exim abandoned: \"%s\" is not an IP address\n", address);
645 /*************************************************
646 * Test/verify an address *
647 *************************************************/
649 /* This function is called by the -bv and -bt code. It extracts a working
650 address from a full RFC 822 address. This isn't really necessary per se, but it
651 has the effect of collapsing source routes.
655 flags flag bits for verify_address()
656 exit_value to be set for failures
662 test_address(uschar *s, int flags, int *exit_value)
664 int start, end, domain;
665 uschar *parse_error = NULL;
666 uschar *address = parse_extract_address(s, &parse_error, &start, &end, &domain,
670 fprintf(stdout, "syntax error: %s\n", parse_error);
675 int rc = verify_address(deliver_make_addr(address,TRUE), stdout, flags, -1,
676 -1, -1, NULL, NULL, NULL);
677 if (rc == FAIL) *exit_value = 2;
678 else if (rc == DEFER && *exit_value == 0) *exit_value = 1;
684 /*************************************************
685 * Decode bit settings for log/debug *
686 *************************************************/
688 /* This function decodes a string containing bit settings in the form of +name
689 and/or -name sequences, and sets/unsets bits in a bit string accordingly. It
690 also recognizes a numeric setting of the form =<number>, but this is not
691 intended for user use. It's an easy way for Exim to pass the debug settings
692 when it is re-exec'ed.
694 The log options are held in two unsigned ints (because there became too many
695 for one). The top bit in the table means "put in 2nd selector". This does not
696 yet apply to debug options, so the "=" facility sets only the first selector.
698 The "all" selector, which must be equal to 0xffffffff, is recognized specially.
699 It sets all the bits in both selectors. However, there is a facility for then
700 unsetting certain bits, because we want to turn off "memory" in the debug case.
702 A bad value for a debug setting is treated as an unknown option - error message
703 to stderr and die. For log settings, which come from the configuration file,
704 we write to the log on the way out...
707 selector1 address of the first bit string
708 selector2 address of the second bit string, or NULL
709 notall1 bits to exclude from "all" for selector1
710 notall2 bits to exclude from "all" for selector2
711 string the configured string
712 options the table of option names
714 which "log" or "debug"
716 Returns: nothing on success - bomb out on failure
720 decode_bits(unsigned int *selector1, unsigned int *selector2, int notall1,
721 int notall2, uschar *string, bit_table *options, int count, uschar *which)
724 if (string == NULL) return;
728 char *end; /* Not uschar */
729 *selector1 = strtoul(CS string+1, &end, 0);
730 if (*end == 0) return;
731 errmsg = string_sprintf("malformed numeric %s_selector setting: %s", which,
736 /* Handle symbolic setting */
743 bit_table *start, *end;
745 while (isspace(*string)) string++;
746 if (*string == 0) return;
748 if (*string != '+' && *string != '-')
750 errmsg = string_sprintf("malformed %s_selector setting: "
751 "+ or - expected but found \"%s\"", which, string);
755 adding = *string++ == '+';
757 while (isalnum(*string) || *string == '_') string++;
761 end = options + count;
765 bit_table *middle = start + (end - start)/2;
766 int c = Ustrncmp(s, middle->name, len);
769 if (middle->name[len] != 0) c = -1; else
771 unsigned int bit = middle->bit;
772 unsigned int *selector;
774 /* The value with all bits set means "force all bits in both selectors"
775 in the case where two are being handled. However, the top bit in the
776 second selector is never set. When setting, some bits can be excluded.
779 if (bit == 0xffffffff)
783 *selector1 = 0xffffffff ^ notall1;
784 if (selector2 != NULL) *selector2 = 0x7fffffff ^ notall2;
789 if (selector2 != NULL) *selector2 = 0;
793 /* Otherwise, the 0x80000000 bit means "this value, without the top
794 bit, belongs in the second selector". */
798 if ((bit & 0x80000000) != 0)
800 selector = selector2;
803 else selector = selector1;
804 if (adding) *selector |= bit; else *selector &= ~bit;
806 break; /* Out of loop to match selector name */
809 if (c < 0) end = middle; else start = middle + 1;
810 } /* Loop to match selector name */
814 errmsg = string_sprintf("unknown %s_selector setting: %c%.*s", which,
815 adding? '+' : '-', len, s);
818 } /* Loop for selector names */
820 /* Handle disasters */
823 if (Ustrcmp(which, "debug") == 0)
825 fprintf(stderr, "exim: %s\n", errmsg);
828 else log_write(0, LOG_CONFIG|LOG_PANIC_DIE, "%s", errmsg);
833 /*************************************************
834 * Show supported features *
835 *************************************************/
837 /* This function is called for -bV and for -d to output the optional features
838 of the current Exim binary.
840 Arguments: a FILE for printing
845 show_whats_supported(FILE *f)
847 #ifdef DB_VERSION_STRING
848 fprintf(f, "Berkeley DB: %s\n", DB_VERSION_STRING);
849 #elif defined(BTREEVERSION) && defined(HASHVERSION)
851 fprintf(f, "Probably Berkeley DB version 1.8x (native mode)\n");
853 fprintf(f, "Probably Berkeley DB version 1.8x (compatibility mode)\n");
855 #elif defined(_DBM_RDONLY) || defined(dbm_dirfno)
856 fprintf(f, "Probably ndbm\n");
857 #elif defined(USE_TDB)
858 fprintf(f, "Using tdb\n");
861 fprintf(f, "Probably GDBM (native mode)\n");
863 fprintf(f, "Probably GDBM (compatibility mode)\n");
867 fprintf(f, "Support for:");
868 #ifdef SUPPORT_CRYPTEQ
869 fprintf(f, " crypteq");
872 fprintf(f, " iconv()");
877 #ifdef HAVE_LOGIN_CAP
878 fprintf(f, " use_classresources");
887 fprintf(f, " Expand_dlfunc");
889 #ifdef USE_TCP_WRAPPERS
890 fprintf(f, " TCPwrappers");
894 fprintf(f, " GnuTLS");
896 fprintf(f, " OpenSSL");
899 #ifdef SUPPORT_TRANSLATE_IP_ADDRESS
900 fprintf(f, " translate_ip_address");
902 #ifdef SUPPORT_MOVE_FROZEN_MESSAGES
903 fprintf(f, " move_frozen_messages");
905 #ifdef WITH_CONTENT_SCAN
906 fprintf(f, " Content_Scanning");
908 #ifdef WITH_OLD_DEMIME
909 fprintf(f, " Old_Demime");
911 #ifdef EXPERIMENTAL_SPF
912 fprintf(f, " Experimental_SPF");
914 #ifdef EXPERIMENTAL_SRS
915 fprintf(f, " Experimental_SRS");
917 #ifdef EXPERIMENTAL_BRIGHTMAIL
918 fprintf(f, " Experimental_Brightmail");
920 #ifdef EXPERIMENTAL_DOMAINKEYS
921 fprintf(f, " Experimental_DomainKeys");
925 fprintf(f, "Lookups:");
926 #ifdef LOOKUP_LSEARCH
927 fprintf(f, " lsearch wildlsearch nwildlsearch iplsearch");
933 fprintf(f, " dbm dbmnz");
936 fprintf(f, " dnsdb");
938 #ifdef LOOKUP_DSEARCH
939 fprintf(f, " dsearch");
942 fprintf(f, " ibase");
945 fprintf(f, " ldap ldapdn ldapm");
948 fprintf(f, " mysql");
951 fprintf(f, " nis nis0");
953 #ifdef LOOKUP_NISPLUS
954 fprintf(f, " nisplus");
957 fprintf(f, " oracle");
960 fprintf(f, " passwd");
963 fprintf(f, " pgsql");
966 fprintf(f, " sqlite");
969 fprintf(f, " testdb");
972 fprintf(f, " whoson");
976 fprintf(f, "Authenticators:");
978 fprintf(f, " cram_md5");
980 #ifdef AUTH_CYRUS_SASL
981 fprintf(f, " cyrus_sasl");
983 #ifdef AUTH_PLAINTEXT
984 fprintf(f, " plaintext");
991 fprintf(f, "Routers:");
993 fprintf(f, " accept");
995 #ifdef ROUTER_DNSLOOKUP
996 fprintf(f, " dnslookup");
998 #ifdef ROUTER_IPLITERAL
999 fprintf(f, " ipliteral");
1001 #ifdef ROUTER_IPLOOKUP
1002 fprintf(f, " iplookup");
1004 #ifdef ROUTER_MANUALROUTE
1005 fprintf(f, " manualroute");
1007 #ifdef ROUTER_QUERYPROGRAM
1008 fprintf(f, " queryprogram");
1010 #ifdef ROUTER_REDIRECT
1011 fprintf(f, " redirect");
1015 fprintf(f, "Transports:");
1016 #ifdef TRANSPORT_APPENDFILE
1017 fprintf(f, " appendfile");
1018 #ifdef SUPPORT_MAILDIR
1019 fprintf(f, "/maildir");
1021 #ifdef SUPPORT_MAILSTORE
1022 fprintf(f, "/mailstore");
1028 #ifdef TRANSPORT_AUTOREPLY
1029 fprintf(f, " autoreply");
1031 #ifdef TRANSPORT_LMTP
1032 fprintf(f, " lmtp");
1034 #ifdef TRANSPORT_PIPE
1035 fprintf(f, " pipe");
1037 #ifdef TRANSPORT_SMTP
1038 fprintf(f, " smtp");
1042 if (fixed_never_users[0] > 0)
1045 fprintf(f, "Fixed never_users: ");
1046 for (i = 1; i <= (int)fixed_never_users[0] - 1; i++)
1047 fprintf(f, "%d:", (unsigned int)fixed_never_users[i]);
1048 fprintf(f, "%d\n", (unsigned int)fixed_never_users[i]);
1051 fprintf(f, "Size of off_t: %d\n", sizeof(off_t));
1057 /*************************************************
1058 * Quote a local part *
1059 *************************************************/
1061 /* This function is used when a sender address or a From: or Sender: header
1062 line is being created from the caller's login, or from an authenticated_id. It
1063 applies appropriate quoting rules for a local part.
1065 Argument: the local part
1066 Returns: the local part, quoted if necessary
1070 local_part_quote(uschar *lpart)
1072 BOOL needs_quote = FALSE;
1077 for (t = lpart; !needs_quote && *t != 0; t++)
1079 needs_quote = !isalnum(*t) && strchr("!#$%&'*+-/=?^_`{|}~", *t) == NULL &&
1080 (*t != '.' || t == lpart || t[1] == 0);
1083 if (!needs_quote) return lpart;
1086 yield = string_cat(NULL, &size, &ptr, US"\"", 1);
1090 uschar *nq = US Ustrpbrk(lpart, "\\\"");
1093 yield = string_cat(yield, &size, &ptr, lpart, Ustrlen(lpart));
1096 yield = string_cat(yield, &size, &ptr, lpart, nq - lpart);
1097 yield = string_cat(yield, &size, &ptr, US"\\", 1);
1098 yield = string_cat(yield, &size, &ptr, nq, 1);
1102 yield = string_cat(yield, &size, &ptr, US"\"", 1);
1110 /*************************************************
1111 * Load readline() functions *
1112 *************************************************/
1114 /* This function is called from testing executions that read data from stdin,
1115 but only when running as the calling user. Currently, only -be does this. The
1116 function loads the readline() function library and passes back the functions.
1117 On some systems, it needs the curses library, so load that too, but try without
1118 it if loading fails. All this functionality has to be requested at build time.
1121 fn_readline_ptr pointer to where to put the readline pointer
1122 fn_addhist_ptr pointer to where to put the addhistory function
1124 Returns: the dlopen handle or NULL on failure
1128 set_readline(char * (**fn_readline_ptr)(char *),
1129 char * (**fn_addhist_ptr)(char *))
1132 void *dlhandle_curses = dlopen("libcurses.so", RTLD_GLOBAL|RTLD_LAZY);
1134 dlhandle = dlopen("libreadline.so", RTLD_GLOBAL|RTLD_NOW);
1135 if (dlhandle_curses != NULL) dlclose(dlhandle_curses);
1137 if (dlhandle != NULL)
1139 *fn_readline_ptr = (char *(*)(char*))dlsym(dlhandle, "readline");
1140 *fn_addhist_ptr = (char *(*)(char*))dlsym(dlhandle, "add_history");
1144 DEBUG(D_any) debug_printf("failed to load readline: %s\n", dlerror());
1153 /*************************************************
1154 * Get a line from stdin for testing things *
1155 *************************************************/
1157 /* This function is called when running tests that can take a number of lines
1158 of input (for example, -be and -bt). It handles continuations and trailing
1159 spaces. And prompting and a blank line output on eof. If readline() is in use,
1160 the arguments are non-NULL and provide the relevant functions.
1163 fn_readline readline function or NULL
1164 fn_addhist addhist function or NULL
1166 Returns: pointer to dynamic memory, or NULL at end of file
1170 get_stdinput(char *(*fn_readline)(char *), char *(*fn_addhist)(char *))
1175 uschar *yield = NULL;
1177 if (fn_readline == NULL) printf("> ");
1181 uschar buffer[1024];
1185 char *readline_line = NULL;
1186 if (fn_readline != NULL)
1188 if ((readline_line = fn_readline((i > 0)? "":"> ")) == NULL) break;
1189 if (*readline_line != 0 && fn_addhist != NULL) fn_addhist(readline_line);
1190 p = US readline_line;
1195 /* readline() not in use */
1198 if (Ufgets(buffer, sizeof(buffer), stdin) == NULL) break;
1202 /* Handle the line */
1204 ss = p + (int)Ustrlen(p);
1205 while (ss > p && isspace(ss[-1])) ss--;
1209 while (p < ss && isspace(*p)) p++; /* leading space after cont */
1212 yield = string_cat(yield, &size, &ptr, p, ss - p);
1215 if (fn_readline != NULL) free(readline_line);
1218 if (ss == p || yield[ptr-1] != '\\')
1226 if (yield == NULL) printf("\n");
1232 /*************************************************
1233 * Entry point and high-level code *
1234 *************************************************/
1236 /* Entry point for the Exim mailer. Analyse the arguments and arrange to take
1237 the appropriate action. All the necessary functions are present in the one
1238 binary. I originally thought one should split it up, but it turns out that so
1239 much of the apparatus is needed in each chunk that one might as well just have
1240 it all available all the time, which then makes the coding easier as well.
1243 argc count of entries in argv
1244 argv argument strings, with argv[0] being the program name
1246 Returns: EXIT_SUCCESS if terminated successfully
1247 EXIT_FAILURE otherwise, except when a message has been sent
1248 to the sender, and -oee was given
1252 main(int argc, char **cargv)
1254 uschar **argv = USS cargv;
1255 int arg_receive_timeout = -1;
1256 int arg_smtp_receive_timeout = -1;
1257 int arg_error_handling = error_handling;
1258 int filter_sfd = -1;
1259 int filter_ufd = -1;
1262 int list_queue_option = 0;
1264 int msg_action_arg = -1;
1265 int namelen = (argv[0] == NULL)? 0 : Ustrlen(argv[0]);
1266 int queue_only_reason = 0;
1268 int perl_start_option = 0;
1270 int recipients_arg = argc;
1271 int sender_address_domain = 0;
1272 int test_retry_arg = -1;
1273 int test_rewrite_arg = -1;
1274 BOOL arg_queue_only = FALSE;
1275 BOOL bi_option = FALSE;
1276 BOOL checking = FALSE;
1277 BOOL count_queue = FALSE;
1278 BOOL expansion_test = FALSE;
1279 BOOL extract_recipients = FALSE;
1280 BOOL forced_delivery = FALSE;
1281 BOOL f_end_dot = FALSE;
1282 BOOL deliver_give_up = FALSE;
1283 BOOL list_queue = FALSE;
1284 BOOL list_options = FALSE;
1285 BOOL local_queue_only;
1287 BOOL one_msg_action = FALSE;
1288 BOOL queue_only_set = FALSE;
1289 BOOL receiving_message = TRUE;
1291 BOOL removed_privilege = FALSE;
1292 BOOL verify_address_mode = FALSE;
1293 BOOL verify_as_sender = FALSE;
1294 BOOL version_printed = FALSE;
1295 uschar *alias_arg = NULL;
1296 uschar *called_as = US"";
1297 uschar *start_queue_run_id = NULL;
1298 uschar *stop_queue_run_id = NULL;
1299 uschar *ftest_domain = NULL;
1300 uschar *ftest_localpart = NULL;
1301 uschar *ftest_prefix = NULL;
1302 uschar *ftest_suffix = NULL;
1303 uschar *real_sender_address;
1304 uschar *originator_home = US"/";
1308 struct stat statbuf;
1309 pid_t passed_qr_pid = (pid_t)0;
1310 int passed_qr_pipe = -1;
1311 gid_t group_list[NGROUPS_MAX];
1313 /* Possible options for -R and -S */
1315 static uschar *rsopts[] = { US"f", US"ff", US"r", US"rf", US"rff" };
1317 /* Need to define this in case we need to change the environment in order
1318 to get rid of a bogus time zone. We have to make it char rather than uschar
1319 because some OS define it in /usr/include/unistd.h. */
1321 extern char **environ;
1323 /* If the Exim user and/or group and/or the configuration file owner/group were
1324 defined by ref:name at build time, we must now find the actual uid/gid values.
1325 This is a feature to make the lives of binary distributors easier. */
1327 #ifdef EXIM_USERNAME
1328 if (route_finduser(US EXIM_USERNAME, &pw, &exim_uid))
1330 exim_gid = pw->pw_gid;
1334 fprintf(stderr, "exim: failed to find uid for user name \"%s\"\n",
1340 #ifdef EXIM_GROUPNAME
1341 if (!route_findgroup(US EXIM_GROUPNAME, &exim_gid))
1343 fprintf(stderr, "exim: failed to find gid for group name \"%s\"\n",
1349 #ifdef CONFIGURE_OWNERNAME
1350 if (!route_finduser(US CONFIGURE_OWNERNAME, NULL, &config_uid))
1352 fprintf(stderr, "exim: failed to find uid for user name \"%s\"\n",
1353 CONFIGURE_OWNERNAME);
1358 #ifdef CONFIGURE_GROUPNAME
1359 if (!route_findgroup(US CONFIGURE_GROUPNAME, &config_gid))
1361 fprintf(stderr, "exim: failed to find gid for group name \"%s\"\n",
1362 CONFIGURE_GROUPNAME);
1367 /* In the Cygwin environment, some initialization needs doing. It is fudged
1368 in by means of this macro. */
1374 /* Check a field which is patched when we are running Exim within its
1375 testing harness; do a fast initial check, and then the whole thing. */
1377 running_in_test_harness =
1378 *running_status == '<' && Ustrcmp(running_status, "<<<testing>>>") == 0;
1380 /* The C standard says that the equivalent of setlocale(LC_ALL, "C") is obeyed
1381 at the start of a program; however, it seems that some environments do not
1382 follow this. A "strange" locale can affect the formatting of timestamps, so we
1385 setlocale(LC_ALL, "C");
1387 /* Set up the default handler for timing using alarm(). */
1389 os_non_restarting_signal(SIGALRM, sigalrm_handler);
1391 /* Ensure we have a buffer for constructing log entries. Use malloc directly,
1392 because store_malloc writes a log entry on failure. */
1394 log_buffer = (uschar *)malloc(LOG_BUFFER_SIZE);
1395 if (log_buffer == NULL)
1397 fprintf(stderr, "exim: failed to get store for log buffer\n");
1401 /* Set log_stderr to stderr, provided that stderr exists. This gets reset to
1402 NULL when the daemon is run and the file is closed. We have to use this
1403 indirection, because some systems don't allow writing to the variable "stderr".
1406 if (fstat(fileno(stderr), &statbuf) >= 0) log_stderr = stderr;
1408 /* Arrange for the PCRE regex library to use our store functions. Note that
1409 the normal calls are actually macros that add additional arguments for
1410 debugging purposes so we have to assign specially constructed functions here.
1411 The default is to use store in the stacking pool, but this is overridden in the
1412 regex_must_compile() function. */
1414 pcre_malloc = function_store_get;
1415 pcre_free = function_dummy_free;
1417 /* Ensure there is a big buffer for temporary use in several places. It is put
1418 in malloc store so that it can be freed for enlargement if necessary. */
1420 big_buffer = store_malloc(big_buffer_size);
1422 /* Set up the handler for the data request signal, and set the initial
1423 descriptive text. */
1425 set_process_info("initializing");
1426 os_restarting_signal(SIGUSR1, usr1_handler);
1428 /* SIGHUP is used to get the daemon to reconfigure. It gets set as appropriate
1429 in the daemon code. For the rest of Exim's uses, we ignore it. */
1431 signal(SIGHUP, SIG_IGN);
1433 /* We don't want to die on pipe errors as the code is written to handle
1434 the write error instead. */
1436 signal(SIGPIPE, SIG_IGN);
1438 /* Under some circumstance on some OS, Exim can get called with SIGCHLD
1439 set to SIG_IGN. This causes subprocesses that complete before the parent
1440 process waits for them not to hang around, so when Exim calls wait(), nothing
1441 is there. The wait() code has been made robust against this, but let's ensure
1442 that SIGCHLD is set to SIG_DFL, because it's tidier to wait and get a process
1443 ending status. We use sigaction rather than plain signal() on those OS where
1444 SA_NOCLDWAIT exists, because we want to be sure it is turned off. (There was a
1445 problem on AIX with this.) */
1449 struct sigaction act;
1450 act.sa_handler = SIG_DFL;
1451 sigemptyset(&(act.sa_mask));
1453 sigaction(SIGCHLD, &act, NULL);
1456 signal(SIGCHLD, SIG_DFL);
1459 /* Save the arguments for use if we re-exec exim as a daemon after receiving
1464 /* Set up the version number. Set up the leading 'E' for the external form of
1465 message ids, set the pointer to the internal form, and initialize it to
1466 indicate no message being processed. */
1469 message_id_option[0] = '-';
1470 message_id_external = message_id_option + 1;
1471 message_id_external[0] = 'E';
1472 message_id = message_id_external + 1;
1475 /* Set the umask to zero so that any files Exim creates using open() are
1476 created with the modes that it specifies. NOTE: Files created with fopen() have
1477 a problem, which was not recognized till rather late (February 2006). With this
1478 umask, such files will be world writeable. (They are all content scanning files
1479 in the spool directory, which isn't world-accessible, so this is not a
1480 disaster, but it's untidy.) I don't want to change this overall setting,
1481 however, because it will interact badly with the open() calls. Instead, there's
1482 now a function called modefopen() that fiddles with the umask while calling
1487 /* Precompile the regular expression for matching a message id. Keep this in
1488 step with the code that generates ids in the accept.c module. We need to do
1489 this here, because the -M options check their arguments for syntactic validity
1490 using mac_ismsgid, which uses this. */
1493 regex_must_compile(US"^(?:[^\\W_]{6}-){2}[^\\W_]{2}$", FALSE, TRUE);
1495 /* If the program is called as "mailq" treat it as equivalent to "exim -bp";
1496 this seems to be a generally accepted convention, since one finds symbolic
1497 links called "mailq" in standard OS configurations. */
1499 if ((namelen == 5 && Ustrcmp(argv[0], "mailq") == 0) ||
1500 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/mailq", 6) == 0))
1503 receiving_message = FALSE;
1504 called_as = US"-mailq";
1507 /* If the program is called as "rmail" treat it as equivalent to
1508 "exim -i -oee", thus allowing UUCP messages to be input using non-SMTP mode,
1509 i.e. preventing a single dot on a line from terminating the message, and
1510 returning with zero return code, even in cases of error (provided an error
1511 message has been sent). */
1513 if ((namelen == 5 && Ustrcmp(argv[0], "rmail") == 0) ||
1514 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/rmail", 6) == 0))
1517 called_as = US"-rmail";
1518 errors_sender_rc = EXIT_SUCCESS;
1521 /* If the program is called as "rsmtp" treat it as equivalent to "exim -bS";
1522 this is a smail convention. */
1524 if ((namelen == 5 && Ustrcmp(argv[0], "rsmtp") == 0) ||
1525 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/rsmtp", 6) == 0))
1527 smtp_input = smtp_batched_input = TRUE;
1528 called_as = US"-rsmtp";
1531 /* If the program is called as "runq" treat it as equivalent to "exim -q";
1532 this is a smail convention. */
1534 if ((namelen == 4 && Ustrcmp(argv[0], "runq") == 0) ||
1535 (namelen > 4 && Ustrncmp(argv[0] + namelen - 5, "/runq", 5) == 0))
1538 receiving_message = FALSE;
1539 called_as = US"-runq";
1542 /* If the program is called as "newaliases" treat it as equivalent to
1543 "exim -bi"; this is a sendmail convention. */
1545 if ((namelen == 10 && Ustrcmp(argv[0], "newaliases") == 0) ||
1546 (namelen > 10 && Ustrncmp(argv[0] + namelen - 11, "/newaliases", 11) == 0))
1549 receiving_message = FALSE;
1550 called_as = US"-newaliases";
1553 /* Save the original effective uid for a couple of uses later. It should
1554 normally be root, but in some esoteric environments it may not be. */
1556 original_euid = geteuid();
1558 /* Get the real uid and gid. If the caller is root, force the effective uid/gid
1559 to be the same as the real ones. This makes a difference only if Exim is setuid
1560 (or setgid) to something other than root, which could be the case in some
1561 special configurations. */
1563 real_uid = getuid();
1564 real_gid = getgid();
1566 if (real_uid == root_uid)
1572 /* If neither the original real uid nor the original euid was root, Exim is
1573 running in an unprivileged state. */
1575 unprivileged = (real_uid != root_uid && original_euid != root_uid);
1577 /* If the first argument is --help, pretend there are no arguments. This will
1578 cause a brief message to be given. */
1580 if (argc > 1 && Ustrcmp(argv[1], "--help") == 0) argc = 1;
1582 /* Scan the program's arguments. Some can be dealt with right away; others are
1583 simply recorded for checking and handling afterwards. Do a high-level switch
1584 on the second character (the one after '-'), to save some effort. */
1586 for (i = 1; i < argc; i++)
1588 BOOL badarg = FALSE;
1589 uschar *arg = argv[i];
1593 /* An argument not starting with '-' is the start of a recipients list;
1594 break out of the options-scanning loop. */
1602 /* An option consistion of -- terminates the options */
1604 if (Ustrcmp(arg, "--") == 0)
1606 recipients_arg = i + 1;
1610 /* Handle flagged options */
1612 switchchar = arg[1];
1615 /* Make all -ex options synonymous with -oex arguments, since that
1616 is assumed by various callers. Also make -qR options synonymous with -R
1617 options, as that seems to be required as well. Allow for -qqR too, and
1618 the same for -S options. */
1620 if (Ustrncmp(arg+1, "oe", 2) == 0 ||
1621 Ustrncmp(arg+1, "qR", 2) == 0 ||
1622 Ustrncmp(arg+1, "qS", 2) == 0)
1624 switchchar = arg[2];
1627 else if (Ustrncmp(arg+1, "qqR", 3) == 0 || Ustrncmp(arg+1, "qqS", 3) == 0)
1629 switchchar = arg[3];
1631 queue_2stage = TRUE;
1634 /* Make -r synonymous with -f, since it is a documented alias */
1636 else if (arg[1] == 'r') switchchar = 'f';
1638 /* Make -ov synonymous with -v */
1640 else if (Ustrcmp(arg, "-ov") == 0)
1646 /* High-level switch on active initial letter */
1650 /* -Btype is a sendmail option for 7bit/8bit setting. Exim is 8-bit clean
1651 so has no need of it. */
1654 if (*argrest == 0) i++; /* Skip over the type */
1659 receiving_message = FALSE; /* Reset TRUE for -bm, -bS, -bs below */
1661 /* -bd: Run in daemon mode, awaiting SMTP connections.
1662 -bdf: Ditto, but in the foreground.
1665 if (*argrest == 'd')
1667 daemon_listen = TRUE;
1668 if (*(++argrest) == 'f') background_daemon = FALSE;
1669 else if (*argrest != 0) { badarg = TRUE; break; }
1672 /* -be: Run in expansion test mode */
1674 else if (*argrest == 'e')
1675 expansion_test = checking = TRUE;
1677 /* -bF: Run system filter test */
1679 else if (*argrest == 'F')
1681 filter_test |= FTEST_SYSTEM;
1682 if (*(++argrest) != 0) { badarg = TRUE; break; }
1683 if (++i < argc) filter_test_sfile = argv[i]; else
1685 fprintf(stderr, "exim: file name expected after %s\n", argv[i-1]);
1690 /* -bf: Run user filter test
1691 -bfd: Set domain for filter testing
1692 -bfl: Set local part for filter testing
1693 -bfp: Set prefix for filter testing
1694 -bfs: Set suffix for filter testing
1697 else if (*argrest == 'f')
1699 if (*(++argrest) == 0)
1701 filter_test |= FTEST_USER;
1702 if (++i < argc) filter_test_ufile = argv[i]; else
1704 fprintf(stderr, "exim: file name expected after %s\n", argv[i-1]);
1712 fprintf(stderr, "exim: string expected after %s\n", arg);
1715 if (Ustrcmp(argrest, "d") == 0) ftest_domain = argv[i];
1716 else if (Ustrcmp(argrest, "l") == 0) ftest_localpart = argv[i];
1717 else if (Ustrcmp(argrest, "p") == 0) ftest_prefix = argv[i];
1718 else if (Ustrcmp(argrest, "s") == 0) ftest_suffix = argv[i];
1719 else { badarg = TRUE; break; }
1723 /* -bh: Host checking - an IP address must follow. */
1725 else if (Ustrcmp(argrest, "h") == 0 || Ustrcmp(argrest, "hc") == 0)
1727 if (++i >= argc) { badarg = TRUE; break; }
1728 sender_host_address = argv[i];
1729 host_checking = checking = log_testing_mode = TRUE;
1730 host_checking_callout = argrest[1] == 'c';
1733 /* -bi: This option is used by sendmail to initialize *the* alias file,
1734 though it has the -oA option to specify a different file. Exim has no
1735 concept of *the* alias file, but since Sun's YP make script calls
1736 sendmail this way, some support must be provided. */
1738 else if (Ustrcmp(argrest, "i") == 0) bi_option = TRUE;
1740 /* -bm: Accept and deliver message - the default option. Reinstate
1741 receiving_message, which got turned off for all -b options. */
1743 else if (Ustrcmp(argrest, "m") == 0) receiving_message = TRUE;
1745 /* -bnq: For locally originating messages, do not qualify unqualified
1746 addresses. In the envelope, this causes errors; in header lines they
1749 else if (Ustrcmp(argrest, "nq") == 0)
1751 allow_unqualified_sender = FALSE;
1752 allow_unqualified_recipient = FALSE;
1755 /* -bpxx: List the contents of the mail queue, in various forms. If
1756 the option is -bpc, just a queue count is needed. Otherwise, if the
1757 first letter after p is r, then order is random. */
1759 else if (*argrest == 'p')
1761 if (*(++argrest) == 'c')
1764 if (*(++argrest) != 0) badarg = TRUE;
1768 if (*argrest == 'r')
1770 list_queue_option = 8;
1773 else list_queue_option = 0;
1777 /* -bp: List the contents of the mail queue, top-level only */
1779 if (*argrest == 0) {}
1781 /* -bpu: List the contents of the mail queue, top-level undelivered */
1783 else if (Ustrcmp(argrest, "u") == 0) list_queue_option += 1;
1785 /* -bpa: List the contents of the mail queue, including all delivered */
1787 else if (Ustrcmp(argrest, "a") == 0) list_queue_option += 2;
1789 /* Unknown after -bp[r] */
1799 /* -bP: List the configuration variables given as the address list.
1800 Force -v, so configuration errors get displayed. */
1802 else if (Ustrcmp(argrest, "P") == 0)
1804 list_options = TRUE;
1805 debug_selector |= D_v;
1806 debug_file = stderr;
1809 /* -brt: Test retry configuration lookup */
1811 else if (Ustrcmp(argrest, "rt") == 0)
1813 test_retry_arg = i + 1;
1817 /* -brw: Test rewrite configuration */
1819 else if (Ustrcmp(argrest, "rw") == 0)
1821 test_rewrite_arg = i + 1;
1825 /* -bS: Read SMTP commands on standard input, but produce no replies -
1826 all errors are reported by sending messages. */
1828 else if (Ustrcmp(argrest, "S") == 0)
1829 smtp_input = smtp_batched_input = receiving_message = TRUE;
1831 /* -bs: Read SMTP commands on standard input and produce SMTP replies
1832 on standard output. */
1834 else if (Ustrcmp(argrest, "s") == 0) smtp_input = receiving_message = TRUE;
1836 /* -bt: address testing mode */
1838 else if (Ustrcmp(argrest, "t") == 0)
1839 address_test_mode = checking = log_testing_mode = TRUE;
1841 /* -bv: verify addresses */
1843 else if (Ustrcmp(argrest, "v") == 0)
1844 verify_address_mode = checking = log_testing_mode = TRUE;
1846 /* -bvs: verify sender addresses */
1848 else if (Ustrcmp(argrest, "vs") == 0)
1850 verify_address_mode = checking = log_testing_mode = TRUE;
1851 verify_as_sender = TRUE;
1854 /* -bV: Print version string and support details */
1856 else if (Ustrcmp(argrest, "V") == 0)
1858 printf("Exim version %s #%s built %s\n", version_string,
1859 version_cnumber, version_date);
1860 printf("%s\n", CS version_copyright);
1861 version_printed = TRUE;
1862 show_whats_supported(stdout);
1869 /* -C: change configuration file list; ignore if it isn't really
1870 a change! Enforce a prefix check if required. */
1875 if(++i < argc) argrest = argv[i]; else
1876 { badarg = TRUE; break; }
1878 if (Ustrcmp(config_main_filelist, argrest) != 0)
1880 #ifdef ALT_CONFIG_PREFIX
1882 int len = Ustrlen(ALT_CONFIG_PREFIX);
1883 uschar *list = argrest;
1885 while((filename = string_nextinlist(&list, &sep, big_buffer,
1886 big_buffer_size)) != NULL)
1888 if ((Ustrlen(filename) < len ||
1889 Ustrncmp(filename, ALT_CONFIG_PREFIX, len) != 0 ||
1890 Ustrstr(filename, "/../") != NULL) &&
1891 (Ustrcmp(filename, "/dev/null") != 0 || real_uid != root_uid))
1893 fprintf(stderr, "-C Permission denied\n");
1899 config_main_filelist = argrest;
1900 config_changed = TRUE;
1905 /* -D: set up a macro definition */
1908 #ifdef DISABLE_D_OPTION
1909 fprintf(stderr, "exim: -D is not available in this Exim binary\n");
1914 macro_item *mlast = NULL;
1917 uschar *s = argrest;
1919 while (isspace(*s)) s++;
1921 if (*s < 'A' || *s > 'Z')
1923 fprintf(stderr, "exim: macro name set by -D must start with "
1924 "an upper case letter\n");
1928 while (isalnum(*s) || *s == '_')
1930 if (ptr < sizeof(name)-1) name[ptr++] = *s;
1934 if (ptr == 0) { badarg = TRUE; break; }
1935 while (isspace(*s)) s++;
1938 if (*s++ != '=') { badarg = TRUE; break; }
1939 while (isspace(*s)) s++;
1942 for (m = macros; m != NULL; m = m->next)
1944 if (Ustrcmp(m->name, name) == 0)
1946 fprintf(stderr, "exim: duplicated -D in command line\n");
1952 m = store_get(sizeof(macro_item) + Ustrlen(name));
1954 m->command_line = TRUE;
1955 if (mlast == NULL) macros = m; else mlast->next = m;
1956 Ustrcpy(m->name, name);
1957 m->replacement = string_copy(s);
1959 if (clmacro_count >= MAX_CLMACROS)
1961 fprintf(stderr, "exim: too many -D options on command line\n");
1964 clmacros[clmacro_count++] = string_sprintf("-D%s=%s", m->name,
1970 /* -d: Set debug level (see also -v below) or set the drop_cr option.
1971 The latter is now a no-op, retained for compatibility only. If -dd is used,
1972 debugging subprocesses of the daemon is disabled. */
1975 if (Ustrcmp(argrest, "ropcr") == 0)
1977 /* drop_cr = TRUE; */
1980 /* Use an intermediate variable so that we don't set debugging while
1981 decoding the debugging bits. */
1985 unsigned int selector = D_default;
1988 if (*argrest == 'd')
1990 debug_daemon = TRUE;
1994 decode_bits(&selector, NULL, D_memory, 0, argrest, debug_options,
1995 debug_options_count, US"debug");
1996 debug_selector = selector;
2001 /* -E: This is a local error message. This option is not intended for
2002 external use at all, but is not restricted to trusted callers because it
2003 does no harm (just suppresses certain error messages) and if Exim is run
2004 not setuid root it won't always be trusted when it generates error
2005 messages using this option. If there is a message id following -E, point
2006 message_reference at it, for logging. */
2009 local_error_message = TRUE;
2010 if (mac_ismsgid(argrest)) message_reference = argrest;
2014 /* -ex: The vacation program calls sendmail with the undocumented "-eq"
2015 option, so it looks as if historically the -oex options are also callable
2016 without the leading -o. So we have to accept them. Before the switch,
2017 anything starting -oe has been converted to -e. Exim does not support all
2018 of the sendmail error options. */
2021 if (Ustrcmp(argrest, "e") == 0)
2023 arg_error_handling = ERRORS_SENDER;
2024 errors_sender_rc = EXIT_SUCCESS;
2026 else if (Ustrcmp(argrest, "m") == 0) arg_error_handling = ERRORS_SENDER;
2027 else if (Ustrcmp(argrest, "p") == 0) arg_error_handling = ERRORS_STDERR;
2028 else if (Ustrcmp(argrest, "q") == 0) arg_error_handling = ERRORS_STDERR;
2029 else if (Ustrcmp(argrest, "w") == 0) arg_error_handling = ERRORS_SENDER;
2034 /* -F: Set sender's full name, used instead of the gecos entry from
2035 the password file. Since users can usually alter their gecos entries,
2036 there's no security involved in using this instead. The data can follow
2037 the -F or be in the next argument. */
2042 if(++i < argc) argrest = argv[i]; else
2043 { badarg = TRUE; break; }
2045 originator_name = argrest;
2046 sender_name_forced = TRUE;
2050 /* -f: Set sender's address - this value is only actually used if Exim is
2051 run by a trusted user, or if untrusted_set_sender is set and matches the
2052 address, except that the null address can always be set by any user. The
2053 test for this happens later, when the value given here is ignored when not
2054 permitted. For an untrusted user, the actual sender is still put in Sender:
2055 if it doesn't match the From: header (unless no_local_from_check is set).
2056 The data can follow the -f or be in the next argument. The -r switch is an
2057 obsolete form of -f but since there appear to be programs out there that
2058 use anything that sendmail has ever supported, better accept it - the
2059 synonymizing is done before the switch above.
2061 At this stage, we must allow domain literal addresses, because we don't
2062 know what the setting of allow_domain_literals is yet. Ditto for trailing
2063 dots and strip_trailing_dot. */
2071 if (i+1 < argc) argrest = argv[++i]; else
2072 { badarg = TRUE; break; }
2076 sender_address = string_sprintf(""); /* Ensure writeable memory */
2080 uschar *temp = argrest + Ustrlen(argrest) - 1;
2081 while (temp >= argrest && isspace(*temp)) temp--;
2082 if (temp >= argrest && *temp == '.') f_end_dot = TRUE;
2083 allow_domain_literals = TRUE;
2084 strip_trailing_dot = TRUE;
2085 sender_address = parse_extract_address(argrest, &errmess, &start, &end,
2086 &sender_address_domain, TRUE);
2087 allow_domain_literals = FALSE;
2088 strip_trailing_dot = FALSE;
2089 if (sender_address == NULL)
2091 fprintf(stderr, "exim: bad -f address \"%s\": %s\n", argrest, errmess);
2092 return EXIT_FAILURE;
2095 sender_address_forced = TRUE;
2099 /* This is some Sendmail thing which can be ignored */
2104 /* -h: Set the hop count for an incoming message. Exim does not currently
2105 support this; it always computes it by counting the Received: headers.
2106 To put it in will require a change to the spool header file format. */
2111 if(++i < argc) argrest = argv[i]; else
2112 { badarg = TRUE; break; }
2114 if (!isdigit(*argrest)) badarg = TRUE;
2118 /* -i: Set flag so dot doesn't end non-SMTP input (same as -oi, seems
2119 not to be documented for sendmail but mailx (at least) uses it) */
2122 if (*argrest == 0) dot_ends = FALSE; else badarg = TRUE;
2127 receiving_message = FALSE;
2129 /* -MC: continue delivery of another message via an existing open
2130 file descriptor. This option is used for an internal call by the
2131 smtp transport when there is a pending message waiting to go to an
2132 address to which it has got a connection. Five subsequent arguments are
2133 required: transport name, host name, IP address, sequence number, and
2134 message_id. Transports may decline to create new processes if the sequence
2135 number gets too big. The channel is stdin. This (-MC) must be the last
2136 argument. There's a subsequent check that the real-uid is privileged.
2138 If we are running in the test harness. delay for a bit, to let the process
2139 that set this one up complete. This makes for repeatability of the logging,
2142 if (Ustrcmp(argrest, "C") == 0)
2146 fprintf(stderr, "exim: too many or too few arguments after -MC\n");
2147 return EXIT_FAILURE;
2150 if (msg_action_arg >= 0)
2152 fprintf(stderr, "exim: incompatible arguments\n");
2153 return EXIT_FAILURE;
2156 continue_transport = argv[++i];
2157 continue_hostname = argv[++i];
2158 continue_host_address = argv[++i];
2159 continue_sequence = Uatoi(argv[++i]);
2160 msg_action = MSG_DELIVER;
2161 msg_action_arg = ++i;
2162 forced_delivery = TRUE;
2163 queue_run_pid = passed_qr_pid;
2164 queue_run_pipe = passed_qr_pipe;
2166 if (!mac_ismsgid(argv[i]))
2168 fprintf(stderr, "exim: malformed message id %s after -MC option\n",
2170 return EXIT_FAILURE;
2173 if (running_in_test_harness) millisleep(500);
2177 /* -MCA: set the smtp_authenticated flag; this is useful only when it
2178 precedes -MC (see above). The flag indicates that the host to which
2179 Exim is connected has accepted an AUTH sequence. */
2181 else if (Ustrcmp(argrest, "CA") == 0)
2183 smtp_authenticated = TRUE;
2187 /* -MCP: set the smtp_use_pipelining flag; this is useful only when
2188 it preceded -MC (see above) */
2190 else if (Ustrcmp(argrest, "CP") == 0)
2192 smtp_use_pipelining = TRUE;
2196 /* -MCQ: pass on the pid of the queue-running process that started
2197 this chain of deliveries and the fd of its synchronizing pipe; this
2198 is useful only when it precedes -MC (see above) */
2200 else if (Ustrcmp(argrest, "CQ") == 0)
2202 if(++i < argc) passed_qr_pid = (pid_t)(Uatol(argv[i]));
2204 if(++i < argc) passed_qr_pipe = (int)(Uatol(argv[i]));
2209 /* -MCS: set the smtp_use_size flag; this is useful only when it
2210 precedes -MC (see above) */
2212 else if (Ustrcmp(argrest, "CS") == 0)
2214 smtp_use_size = TRUE;
2218 /* -MCT: set the tls_offered flag; this is useful only when it
2219 precedes -MC (see above). The flag indicates that the host to which
2220 Exim is connected has offered TLS support. */
2223 else if (Ustrcmp(argrest, "CT") == 0)
2230 /* -M[x]: various operations on the following list of message ids:
2231 -M deliver the messages, ignoring next retry times and thawing
2232 -Mc deliver the messages, checking next retry times, no thawing
2233 -Mf freeze the messages
2234 -Mg give up on the messages
2235 -Mt thaw the messages
2236 -Mrm remove the messages
2237 In the above cases, this must be the last option. There are also the
2238 following options which are followed by a single message id, and which
2239 act on that message. Some of them use the "recipient" addresses as well.
2240 -Mar add recipient(s)
2241 -Mmad mark all recipients delivered
2242 -Mmd mark recipients(s) delivered
2249 else if (*argrest == 0)
2251 msg_action = MSG_DELIVER;
2252 forced_delivery = deliver_force_thaw = TRUE;
2254 else if (Ustrcmp(argrest, "ar") == 0)
2256 msg_action = MSG_ADD_RECIPIENT;
2257 one_msg_action = TRUE;
2259 else if (Ustrcmp(argrest, "c") == 0) msg_action = MSG_DELIVER;
2260 else if (Ustrcmp(argrest, "es") == 0)
2262 msg_action = MSG_EDIT_SENDER;
2263 one_msg_action = TRUE;
2265 else if (Ustrcmp(argrest, "f") == 0) msg_action = MSG_FREEZE;
2266 else if (Ustrcmp(argrest, "g") == 0)
2268 msg_action = MSG_DELIVER;
2269 deliver_give_up = TRUE;
2271 else if (Ustrcmp(argrest, "mad") == 0)
2273 msg_action = MSG_MARK_ALL_DELIVERED;
2275 else if (Ustrcmp(argrest, "md") == 0)
2277 msg_action = MSG_MARK_DELIVERED;
2278 one_msg_action = TRUE;
2280 else if (Ustrcmp(argrest, "rm") == 0) msg_action = MSG_REMOVE;
2281 else if (Ustrcmp(argrest, "t") == 0) msg_action = MSG_THAW;
2282 else if (Ustrcmp(argrest, "vb") == 0)
2284 msg_action = MSG_SHOW_BODY;
2285 one_msg_action = TRUE;
2287 else if (Ustrcmp(argrest, "vh") == 0)
2289 msg_action = MSG_SHOW_HEADER;
2290 one_msg_action = TRUE;
2292 else if (Ustrcmp(argrest, "vl") == 0)
2294 msg_action = MSG_SHOW_LOG;
2295 one_msg_action = TRUE;
2297 else { badarg = TRUE; break; }
2299 /* All the -Mxx options require at least one message id. */
2301 msg_action_arg = i + 1;
2302 if (msg_action_arg >= argc)
2304 fprintf(stderr, "exim: no message ids given after %s option\n", arg);
2305 return EXIT_FAILURE;
2308 /* Some require only message ids to follow */
2310 if (!one_msg_action)
2313 for (j = msg_action_arg; j < argc; j++) if (!mac_ismsgid(argv[j]))
2315 fprintf(stderr, "exim: malformed message id %s after %s option\n",
2317 return EXIT_FAILURE;
2319 goto END_ARG; /* Remaining args are ids */
2322 /* Others require only one message id, possibly followed by addresses,
2323 which will be handled as normal arguments. */
2327 if (!mac_ismsgid(argv[msg_action_arg]))
2329 fprintf(stderr, "exim: malformed message id %s after %s option\n",
2330 argv[msg_action_arg], arg);
2331 return EXIT_FAILURE;
2338 /* Some programs seem to call the -om option without the leading o;
2339 for sendmail it askes for "me too". Exim always does this. */
2342 if (*argrest != 0) badarg = TRUE;
2346 /* -N: don't do delivery - a debugging option that stops transports doing
2347 their thing. It implies debugging at the D_v level. */
2352 dont_deliver = TRUE;
2353 debug_selector |= D_v;
2354 debug_file = stderr;
2360 /* -n: This means "don't alias" in sendmail, apparently. Just ignore
2366 /* -O: Just ignore it. In sendmail, apparently -O option=value means set
2367 option to the specified value. This form uses long names. We need to handle
2368 -O option=value and -Ooption=value. */
2375 fprintf(stderr, "exim: string expected after -O\n");
2383 /* -oA: Set an argument for the bi command (sendmail's "alternate alias
2386 if (*argrest == 'A')
2388 alias_arg = argrest + 1;
2389 if (alias_arg[0] == 0)
2391 if (i+1 < argc) alias_arg = argv[++i]; else
2393 fprintf(stderr, "exim: string expected after -oA\n");
2399 /* -oB: Set a connection message max value for remote deliveries */
2401 else if (*argrest == 'B')
2403 uschar *p = argrest + 1;
2406 if (i+1 < argc && isdigit((argv[i+1][0]))) p = argv[++i]; else
2408 connection_max_messages = 1;
2417 fprintf(stderr, "exim: number expected after -oB\n");
2420 connection_max_messages = Uatoi(p);
2424 /* -odb: background delivery */
2426 else if (Ustrcmp(argrest, "db") == 0)
2428 synchronous_delivery = FALSE;
2429 arg_queue_only = FALSE;
2430 queue_only_set = TRUE;
2433 /* -odf: foreground delivery (smail-compatible option); same effect as
2434 -odi: interactive (synchronous) delivery (sendmail-compatible option)
2437 else if (Ustrcmp(argrest, "df") == 0 || Ustrcmp(argrest, "di") == 0)
2439 synchronous_delivery = TRUE;
2440 arg_queue_only = FALSE;
2441 queue_only_set = TRUE;
2444 /* -odq: queue only */
2446 else if (Ustrcmp(argrest, "dq") == 0)
2448 synchronous_delivery = FALSE;
2449 arg_queue_only = TRUE;
2450 queue_only_set = TRUE;
2453 /* -odqs: queue SMTP only - do local deliveries and remote routing,
2454 but no remote delivery */
2456 else if (Ustrcmp(argrest, "dqs") == 0)
2459 arg_queue_only = FALSE;
2460 queue_only_set = TRUE;
2463 /* -oex: Sendmail error flags. As these are also accepted without the
2464 leading -o prefix, for compatibility with vacation and other callers,
2465 they are handled with -e above. */
2467 /* -oi: Set flag so dot doesn't end non-SMTP input (same as -i)
2468 -oitrue: Another sendmail syntax for the same */
2470 else if (Ustrcmp(argrest, "i") == 0 ||
2471 Ustrcmp(argrest, "itrue") == 0)
2474 /* -oM*: Set various characteristics for an incoming message; actually
2475 acted on for trusted callers only. */
2477 else if (*argrest == 'M')
2481 fprintf(stderr, "exim: data expected after -o%s\n", argrest);
2485 /* -oMa: Set sender host address */
2487 if (Ustrcmp(argrest, "Ma") == 0) sender_host_address = argv[++i];
2489 /* -oMaa: Set authenticator name */
2491 else if (Ustrcmp(argrest, "Maa") == 0)
2492 sender_host_authenticated = argv[++i];
2494 /* -oMas: setting authenticated sender */
2496 else if (Ustrcmp(argrest, "Mas") == 0) authenticated_sender = argv[++i];
2498 /* -oMai: setting authenticated id */
2500 else if (Ustrcmp(argrest, "Mai") == 0) authenticated_id = argv[++i];
2502 /* -oMi: Set incoming interface address */
2504 else if (Ustrcmp(argrest, "Mi") == 0) interface_address = argv[++i];
2506 /* -oMr: Received protocol */
2508 else if (Ustrcmp(argrest, "Mr") == 0) received_protocol = argv[++i];
2510 /* -oMs: Set sender host name */
2512 else if (Ustrcmp(argrest, "Ms") == 0) sender_host_name = argv[++i];
2514 /* -oMt: Set sender ident */
2516 else if (Ustrcmp(argrest, "Mt") == 0) sender_ident = argv[++i];
2518 /* Else a bad argument */
2527 /* -om: Me-too flag for aliases. Exim always does this. Some programs
2528 seem to call this as -m (undocumented), so that is also accepted (see
2531 else if (Ustrcmp(argrest, "m") == 0) {}
2533 /* -oo: An ancient flag for old-style addresses which still seems to
2534 crop up in some calls (see in SCO). */
2536 else if (Ustrcmp(argrest, "o") == 0) {}
2538 /* -oP <name>: set pid file path for daemon */
2540 else if (Ustrcmp(argrest, "P") == 0)
2541 override_pid_file_path = argv[++i];
2543 /* -or <n>: set timeout for non-SMTP acceptance
2544 -os <n>: set timeout for SMTP acceptance */
2546 else if (*argrest == 'r' || *argrest == 's')
2548 int *tp = (*argrest == 'r')?
2549 &arg_receive_timeout : &arg_smtp_receive_timeout;
2550 if (argrest[1] == 0)
2552 if (i+1 < argc) *tp= readconf_readtime(argv[++i], 0, FALSE);
2554 else *tp = readconf_readtime(argrest + 1, 0, FALSE);
2557 fprintf(stderr, "exim: bad time value %s: abandoned\n", argv[i]);
2562 /* -oX <list>: Override local_interfaces and/or default daemon ports */
2564 else if (Ustrcmp(argrest, "X") == 0)
2565 override_local_interfaces = argv[++i];
2567 /* Unknown -o argument */
2573 /* -ps: force Perl startup; -pd force delayed Perl startup */
2577 if (*argrest == 's' && argrest[1] == 0)
2579 perl_start_option = 1;
2582 if (*argrest == 'd' && argrest[1] == 0)
2584 perl_start_option = -1;
2589 /* -panythingelse is taken as the Sendmail-compatible argument -prval:sval,
2590 which sets the host protocol and host name */
2594 if (i+1 < argc) argrest = argv[++i]; else
2595 { badarg = TRUE; break; }
2600 uschar *hn = Ustrchr(argrest, ':');
2603 received_protocol = argrest;
2607 received_protocol = string_copyn(argrest, hn - argrest);
2608 sender_host_name = hn + 1;
2615 receiving_message = FALSE;
2617 /* -qq...: Do queue runs in a 2-stage manner */
2619 if (*argrest == 'q')
2621 queue_2stage = TRUE;
2625 /* -qi...: Do only first (initial) deliveries */
2627 if (*argrest == 'i')
2629 queue_run_first_delivery = TRUE;
2633 /* -qf...: Run the queue, forcing deliveries
2634 -qff..: Ditto, forcing thawing as well */
2636 if (*argrest == 'f')
2638 queue_run_force = TRUE;
2639 if (*(++argrest) == 'f')
2641 deliver_force_thaw = TRUE;
2646 /* -q[f][f]l...: Run the queue only on local deliveries */
2648 if (*argrest == 'l')
2650 queue_run_local = TRUE;
2654 /* -q[f][f][l]: Run the queue, optionally forced, optionally local only,
2655 optionally starting from a given message id. */
2657 if (*argrest == 0 &&
2658 (i + 1 >= argc || argv[i+1][0] == '-' || mac_ismsgid(argv[i+1])))
2661 if (i+1 < argc && mac_ismsgid(argv[i+1]))
2662 start_queue_run_id = argv[++i];
2663 if (i+1 < argc && mac_ismsgid(argv[i+1]))
2664 stop_queue_run_id = argv[++i];
2667 /* -q[f][f][l]<n>: Run the queue at regular intervals, optionally forced,
2668 optionally local only. */
2673 queue_interval = readconf_readtime(argrest, 0, FALSE);
2675 queue_interval = readconf_readtime(argv[++i], 0, FALSE);
2676 if (queue_interval <= 0)
2678 fprintf(stderr, "exim: bad time value %s: abandoned\n", argv[i]);
2685 case 'R': /* Synonymous with -qR... */
2686 receiving_message = FALSE;
2688 /* -Rf: As -R (below) but force all deliveries,
2689 -Rff: Ditto, but also thaw all frozen messages,
2690 -Rr: String is regex
2691 -Rrf: Regex and force
2692 -Rrff: Regex and force and thaw
2694 in all cases provided there are no further characters in this
2700 for (i = 0; i < sizeof(rsopts)/sizeof(uschar *); i++)
2702 if (Ustrcmp(argrest, rsopts[i]) == 0)
2704 if (i != 2) queue_run_force = TRUE;
2705 if (i >= 2) deliver_selectstring_regex = TRUE;
2706 if (i == 1 || i == 4) deliver_force_thaw = TRUE;
2707 argrest += Ustrlen(rsopts[i]);
2712 /* -R: Set string to match in addresses for forced queue run to
2713 pick out particular messages. */
2717 if (i+1 < argc) deliver_selectstring = argv[++i]; else
2719 fprintf(stderr, "exim: string expected after -R\n");
2723 else deliver_selectstring = argrest;
2724 if (queue_interval < 0) queue_interval = 0;
2728 /* -r: an obsolete synonym for -f (see above) */
2731 /* -S: Like -R but works on sender. */
2733 case 'S': /* Synonymous with -qS... */
2734 receiving_message = FALSE;
2736 /* -Sf: As -S (below) but force all deliveries,
2737 -Sff: Ditto, but also thaw all frozen messages,
2738 -Sr: String is regex
2739 -Srf: Regex and force
2740 -Srff: Regex and force and thaw
2742 in all cases provided there are no further characters in this
2748 for (i = 0; i < sizeof(rsopts)/sizeof(uschar *); i++)
2750 if (Ustrcmp(argrest, rsopts[i]) == 0)
2752 if (i != 2) queue_run_force = TRUE;
2753 if (i >= 2) deliver_selectstring_sender_regex = TRUE;
2754 if (i == 1 || i == 4) deliver_force_thaw = TRUE;
2755 argrest += Ustrlen(rsopts[i]);
2760 /* -S: Set string to match in addresses for forced queue run to
2761 pick out particular messages. */
2765 if (i+1 < argc) deliver_selectstring_sender = argv[++i]; else
2767 fprintf(stderr, "exim: string expected after -S\n");
2771 else deliver_selectstring_sender = argrest;
2772 if (queue_interval < 0) queue_interval = 0;
2775 /* -Tqt is an option that is exclusively for use by the testing suite.
2776 It is not recognized in other circumstances. It allows for the setting up
2777 of explicit "queue times" so that various warning/retry things can be
2778 tested. Otherwise variability of clock ticks etc. cause problems. */
2781 if (running_in_test_harness && Ustrcmp(argrest, "qt") == 0)
2782 fudged_queue_times = argv[++i];
2787 /* -t: Set flag to extract recipients from body of message. */
2790 if (*argrest == 0) extract_recipients = TRUE;
2792 /* -ti: Set flag to extract recipients from body of message, and also
2793 specify that dot does not end the message. */
2795 else if (Ustrcmp(argrest, "i") == 0)
2797 extract_recipients = TRUE;
2801 /* -tls-on-connect: don't wait for STARTTLS (for old clients) */
2804 else if (Ustrcmp(argrest, "ls-on-connect") == 0) tls_on_connect = TRUE;
2811 /* -U: This means "initial user submission" in sendmail, apparently. The
2812 doc claims that in future sendmail may refuse syntactically invalid
2813 messages instead of fixing them. For the moment, we just ignore it. */
2819 /* -v: verify things - this is a very low-level debugging */
2824 debug_selector |= D_v;
2825 debug_file = stderr;
2831 /* -x: AIX uses this to indicate some fancy 8-bit character stuff:
2833 The -x flag tells the sendmail command that mail from a local
2834 mail program has National Language Support (NLS) extended characters
2835 in the body of the mail item. The sendmail command can send mail with
2836 extended NLS characters across networks that normally corrupts these
2839 As Exim is 8-bit clean, it just ignores this flag. */
2842 if (*argrest != 0) badarg = TRUE;
2845 /* All other initial characters are errors */
2850 } /* End of high-level switch statement */
2852 /* Failed to recognize the option, or syntax error */
2856 fprintf(stderr, "exim abandoned: unknown, malformed, or incomplete "
2857 "option %s\n", arg);
2863 /* Arguments have been processed. Check for incompatibilities. */
2867 (smtp_input || extract_recipients || recipients_arg < argc) &&
2868 (daemon_listen || queue_interval >= 0 || bi_option ||
2869 test_retry_arg >= 0 || test_rewrite_arg >= 0 ||
2870 filter_test != FTEST_NONE || (msg_action_arg > 0 && !one_msg_action))
2873 msg_action_arg > 0 &&
2874 (daemon_listen || queue_interval >= 0 || list_options || checking ||
2875 bi_option || test_retry_arg >= 0 || test_rewrite_arg >= 0)
2878 (daemon_listen || queue_interval >= 0) &&
2879 (sender_address != NULL || list_options || list_queue || checking ||
2883 daemon_listen && queue_interval == 0
2887 (checking || smtp_input || extract_recipients ||
2888 filter_test != FTEST_NONE || bi_option)
2891 verify_address_mode &&
2892 (address_test_mode || smtp_input || extract_recipients ||
2893 filter_test != FTEST_NONE || bi_option)
2896 address_test_mode && (smtp_input || extract_recipients ||
2897 filter_test != FTEST_NONE || bi_option)
2900 smtp_input && (sender_address != NULL || filter_test != FTEST_NONE ||
2904 deliver_selectstring != NULL && queue_interval < 0
2908 fprintf(stderr, "exim: incompatible command-line options or arguments\n");
2912 /* If debugging is set up, set the file and the file descriptor to pass on to
2913 child processes. It should, of course, be 2 for stderr. Also, force the daemon
2914 to run in the foreground. */
2916 if (debug_selector != 0)
2918 debug_file = stderr;
2919 debug_fd = fileno(debug_file);
2920 background_daemon = FALSE;
2921 if (running_in_test_harness) millisleep(100); /* lets caller finish */
2922 if (debug_selector != D_v) /* -v only doesn't show this */
2924 debug_printf("Exim version %s uid=%ld gid=%ld pid=%d D=%x\n",
2925 version_string, (long int)real_uid, (long int)real_gid, (int)getpid(),
2927 show_whats_supported(stderr);
2931 /* When started with root privilege, ensure that the limits on the number of
2932 open files and the number of processes (where that is accessible) are
2933 sufficiently large, or are unset, in case Exim has been called from an
2934 environment where the limits are screwed down. Not all OS have the ability to
2935 change some of these limits. */
2939 DEBUG(D_any) debug_print_ids(US"Exim has no root privilege:");
2945 #ifdef RLIMIT_NOFILE
2946 if (getrlimit(RLIMIT_NOFILE, &rlp) < 0)
2948 log_write(0, LOG_MAIN|LOG_PANIC, "getrlimit(RLIMIT_NOFILE) failed: %s",
2950 rlp.rlim_cur = rlp.rlim_max = 0;
2953 /* I originally chose 1000 as a nice big number that was unlikely to
2954 be exceeded. It turns out that some older OS have a fixed upper limit of
2957 if (rlp.rlim_cur < 1000)
2959 rlp.rlim_cur = rlp.rlim_max = 1000;
2960 if (setrlimit(RLIMIT_NOFILE, &rlp) < 0)
2962 rlp.rlim_cur = rlp.rlim_max = 256;
2963 if (setrlimit(RLIMIT_NOFILE, &rlp) < 0)
2964 log_write(0, LOG_MAIN|LOG_PANIC, "setrlimit(RLIMIT_NOFILE) failed: %s",
2971 if (getrlimit(RLIMIT_NPROC, &rlp) < 0)
2973 log_write(0, LOG_MAIN|LOG_PANIC, "getrlimit(RLIMIT_NPROC) failed: %s",
2975 rlp.rlim_cur = rlp.rlim_max = 0;
2978 #ifdef RLIM_INFINITY
2979 if (rlp.rlim_cur != RLIM_INFINITY && rlp.rlim_cur < 1000)
2981 rlp.rlim_cur = rlp.rlim_max = RLIM_INFINITY;
2983 if (rlp.rlim_cur < 1000)
2985 rlp.rlim_cur = rlp.rlim_max = 1000;
2987 if (setrlimit(RLIMIT_NPROC, &rlp) < 0)
2988 log_write(0, LOG_MAIN|LOG_PANIC, "setrlimit(RLIMIT_NPROC) failed: %s",
2994 /* Exim is normally entered as root (but some special configurations are
2995 possible that don't do this). However, it always spins off sub-processes that
2996 set their uid and gid as required for local delivery. We don't want to pass on
2997 any extra groups that root may belong to, so we want to get rid of them all at
3000 We need to obey setgroups() at this stage, before possibly giving up root
3001 privilege for a changed configuration file, but later on we might need to
3002 check on the additional groups for the admin user privilege - can't do that
3003 till after reading the config, which might specify the exim gid. Therefore,
3004 save the group list here first. */
3006 group_count = getgroups(NGROUPS_MAX, group_list);
3008 /* There is a fundamental difference in some BSD systems in the matter of
3009 groups. FreeBSD and BSDI are known to be different; NetBSD and OpenBSD are
3010 known not to be different. On the "different" systems there is a single group
3011 list, and the first entry in it is the current group. On all other versions of
3012 Unix there is a supplementary group list, which is in *addition* to the current
3013 group. Consequently, to get rid of all extraneous groups on a "standard" system
3014 you pass over 0 groups to setgroups(), while on a "different" system you pass
3015 over a single group - the current group, which is always the first group in the
3016 list. Calling setgroups() with zero groups on a "different" system results in
3017 an error return. The following code should cope with both types of system.
3019 However, if this process isn't running as root, setgroups() can't be used
3020 since you have to be root to run it, even if throwing away groups. Not being
3021 root here happens only in some unusual configurations. We just ignore the
3024 if (setgroups(0, NULL) != 0)
3026 if (setgroups(1, group_list) != 0 && !unprivileged)
3028 fprintf(stderr, "exim: setgroups() failed: %s\n", strerror(errno));
3033 /* If the configuration file name has been altered by an argument on the
3034 command line (either a new file name or a macro definition) and the caller is
3035 not root or the exim user, or if this is a filter testing run, remove any
3036 setuid privilege the program has, and run as the underlying user.
3038 If ALT_CONFIG_ROOT_ONLY is defined, the exim user is locked out of this, which
3039 severely restricts the use of -C for some purposes.
3041 Otherwise, set the real ids to the effective values (should be root unless run
3042 from inetd, which it can either be root or the exim uid, if one is configured).
3044 There is a private mechanism for bypassing some of this, in order to make it
3045 possible to test lots of configurations automatically, without having either to
3046 recompile each time, or to patch in an actual configuration file name and other
3047 values (such as the path name). If running in the test harness, pretend that
3048 configuration file changes and macro definitions haven't happened. */
3051 (config_changed || macros != NULL) && /* Config changed, and */
3052 real_uid != root_uid && /* Not root, and */
3053 #ifndef ALT_CONFIG_ROOT_ONLY /* (when not locked out) */
3054 real_uid != exim_uid && /* Not exim, and */
3056 !running_in_test_harness /* Not fudged */
3058 expansion_test /* expansion testing */
3060 filter_test != FTEST_NONE) /* Filter testing */
3062 setgroups(group_count, group_list);
3063 exim_setugid(real_uid, real_gid, FALSE,
3064 US"-C, -D, -be or -bf forces real uid");
3065 removed_privilege = TRUE;
3067 /* In the normal case when Exim is called like this, stderr is available
3068 and should be used for any logging information because attempts to write
3069 to the log will usually fail. To arrange this, we unset really_exim. However,
3070 if no stderr is available there is no point - we might as well have a go
3071 at the log (if it fails, syslog will be written). */
3073 if (log_stderr != NULL) really_exim = FALSE;
3076 /* Privilege is to be retained for the moment. It may be dropped later,
3077 depending on the job that this Exim process has been asked to do. For now, set
3078 the real uid to the effective so that subsequent re-execs of Exim are done by a
3081 else exim_setugid(geteuid(), getegid(), FALSE, US"forcing real = effective");
3083 /* If testing a filter, open the file(s) now, before wasting time doing other
3084 setups and reading the message. */
3086 if ((filter_test & FTEST_SYSTEM) != 0)
3088 filter_sfd = Uopen(filter_test_sfile, O_RDONLY, 0);
3091 fprintf(stderr, "exim: failed to open %s: %s\n", filter_test_sfile,
3093 return EXIT_FAILURE;
3097 if ((filter_test & FTEST_USER) != 0)
3099 filter_ufd = Uopen(filter_test_ufile, O_RDONLY, 0);
3102 fprintf(stderr, "exim: failed to open %s: %s\n", filter_test_ufile,
3104 return EXIT_FAILURE;
3108 /* Read the main runtime configuration data; this gives up if there
3109 is a failure. It leaves the configuration file open so that the subsequent
3110 configuration data for delivery can be read if needed. */
3114 /* Handle the decoding of logging options. */
3116 decode_bits(&log_write_selector, &log_extra_selector, 0, 0, log_selector_string,
3117 log_options, log_options_count, US"log");
3121 debug_printf("configuration file is %s\n", config_main_filename);
3122 debug_printf("log selectors = %08x %08x\n", log_write_selector,
3123 log_extra_selector);
3126 /* If domain literals are not allowed, check the sender address that was
3127 supplied with -f. Ditto for a stripped trailing dot. */
3129 if (sender_address != NULL)
3131 if (sender_address[sender_address_domain] == '[' && !allow_domain_literals)
3133 fprintf(stderr, "exim: bad -f address \"%s\": domain literals not "
3134 "allowed\n", sender_address);
3135 return EXIT_FAILURE;
3137 if (f_end_dot && !strip_trailing_dot)
3139 fprintf(stderr, "exim: bad -f address \"%s.\": domain is malformed "
3140 "(trailing dot not allowed)\n", sender_address);
3141 return EXIT_FAILURE;
3145 /* Paranoia check of maximum lengths of certain strings. There is a check
3146 on the length of the log file path in log.c, which will come into effect
3147 if there are any calls to write the log earlier than this. However, if we
3148 get this far but the string is very long, it is better to stop now than to
3149 carry on and (e.g.) receive a message and then have to collapse. The call to
3150 log_write() from here will cause the ultimate panic collapse if the complete
3151 file name exceeds the buffer length. */
3153 if (Ustrlen(log_file_path) > 200)
3154 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3155 "log_file_path is longer than 200 chars: aborting");
3157 if (Ustrlen(pid_file_path) > 200)
3158 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3159 "pid_file_path is longer than 200 chars: aborting");
3161 if (Ustrlen(spool_directory) > 200)
3162 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3163 "spool_directory is longer than 200 chars: aborting");
3165 /* Length check on the process name given to syslog for its TAG field,
3166 which is only permitted to be 32 characters or less. See RFC 3164. */
3168 if (Ustrlen(syslog_processname) > 32)
3169 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3170 "syslog_processname is longer than 32 chars: aborting");
3172 /* In some operating systems, the environment variable TMPDIR controls where
3173 temporary files are created; Exim doesn't use these (apart from when delivering
3174 to MBX mailboxes), but called libraries such as DBM libraries may require them.
3175 If TMPDIR is found in the environment, reset it to the value defined in the
3176 TMPDIR macro, if this macro is defined. */
3181 for (p = USS environ; *p != NULL; p++)
3183 if (Ustrncmp(*p, "TMPDIR=", 7) == 0 &&
3184 Ustrcmp(*p+7, TMPDIR) != 0)
3186 uschar *newp = malloc(Ustrlen(TMPDIR) + 8);
3187 sprintf(CS newp, "TMPDIR=%s", TMPDIR);
3189 DEBUG(D_any) debug_printf("reset TMPDIR=%s in environment\n", TMPDIR);
3195 /* Timezone handling. If timezone_string is "utc", set a flag to cause all
3196 timestamps to be in UTC (gmtime() is used instead of localtime()). Otherwise,
3197 we may need to get rid of a bogus timezone setting. This can arise when Exim is
3198 called by a user who has set the TZ variable. This then affects the timestamps
3199 in log files and in Received: headers, and any created Date: header lines. The
3200 required timezone is settable in the configuration file, so nothing can be done
3201 about this earlier - but hopefully nothing will normally be logged earlier than
3202 this. We have to make a new environment if TZ is wrong, but don't bother if
3203 timestamps_utc is set, because then all times are in UTC anyway. */
3205 if (timezone_string != NULL && strcmpic(timezone_string, US"UTC") == 0)
3207 timestamps_utc = TRUE;
3211 uschar *envtz = US getenv("TZ");
3212 if ((envtz == NULL && timezone_string != NULL) ||
3214 (timezone_string == NULL ||
3215 Ustrcmp(timezone_string, envtz) != 0)))
3217 uschar **p = USS environ;
3221 while (*p++ != NULL) count++;
3222 if (envtz == NULL) count++;
3223 newp = new = malloc(sizeof(uschar *) * (count + 1));
3224 for (p = USS environ; *p != NULL; p++)
3226 if (Ustrncmp(*p, "TZ=", 3) == 0) continue;
3229 if (timezone_string != NULL)
3231 *newp = malloc(Ustrlen(timezone_string) + 4);
3232 sprintf(CS *newp++, "TZ=%s", timezone_string);
3237 DEBUG(D_any) debug_printf("Reset TZ to %s: time is %s\n", timezone_string,
3238 tod_stamp(tod_log));
3242 /* Handle the case when we have removed the setuid privilege because of -C or
3243 -D. This means that the caller of Exim was not root, and, provided that
3244 ALT_CONFIG_ROOT_ONLY is not defined, was not the Exim user that is built into
3247 If ALT_CONFIG_ROOT_ONLY is not defined, there is a problem if it turns out we
3248 were running as the exim user defined in the configuration file (different to
3249 the one in the binary). The sysadmin may expect this case to retain privilege
3250 because "the binary was called by the Exim user", but it hasn't, because of the
3251 order in which it handles this stuff. There are two possibilities:
3253 (1) If deliver_drop_privilege is set, Exim is not going to re-exec in order
3254 to do message deliveries. Thus, the fact that it is running as a
3255 non-privileged user is plausible, and might be wanted in some special
3256 configurations. However, really_exim will have been set false when
3257 privilege was dropped, to stop Exim trying to write to its normal log
3258 files. Therefore, re-enable normal log processing, assuming the sysadmin
3259 has set up the log directory correctly.
3261 (2) If deliver_drop_privilege is not set, the configuration won't work as
3262 apparently intended, and so we log a panic message. In order to retain
3263 root for -C or -D, the caller must either be root or the Exim user
3264 defined in the binary (when deliver_drop_ privilege is false).
3266 If ALT_CONFIG_ROOT_ONLY is defined, we don't know whether we were called by the
3267 built-in exim user or one defined in the configuration. In either event,
3268 re-enable log processing, assuming the sysadmin knows what they are doing. */
3270 if (removed_privilege && (config_changed || macros != NULL) &&
3271 real_uid == exim_uid)
3273 #ifdef ALT_CONFIG_ROOT_ONLY
3274 really_exim = TRUE; /* let logging work normally */
3277 if (deliver_drop_privilege)
3278 really_exim = TRUE; /* let logging work normally */
3280 log_write(0, LOG_MAIN|LOG_PANIC,
3281 "exim user (uid=%d) is defined only at runtime; privilege lost for %s",
3282 (int)exim_uid, config_changed? "-C" : "-D");
3286 /* Start up Perl interpreter if Perl support is configured and there is a
3287 perl_startup option, and the configuration or the command line specifies
3288 initializing starting. Note that the global variables are actually called
3289 opt_perl_xxx to avoid clashing with perl's namespace (perl_*). */
3292 if (perl_start_option != 0)
3293 opt_perl_at_start = (perl_start_option > 0);
3294 if (opt_perl_at_start && opt_perl_startup != NULL)
3297 DEBUG(D_any) debug_printf("Starting Perl interpreter\n");
3298 errstr = init_perl(opt_perl_startup);
3301 fprintf(stderr, "exim: error in perl_startup code: %s\n", errstr);
3302 return EXIT_FAILURE;
3304 opt_perl_started = TRUE;
3306 #endif /* EXIM_PERL */
3308 /* Log the arguments of the call if the configuration file said so. This is
3309 a debugging feature for finding out what arguments certain MUAs actually use.
3310 Don't attempt it if logging is disabled, or if listing variables or if
3311 verifying/testing addresses or expansions. */
3313 if (((debug_selector & D_any) != 0 || (log_extra_selector & LX_arguments) != 0)
3314 && really_exim && !list_options && !checking)
3317 uschar *p = big_buffer;
3319 (void)getcwd(CS p+4, big_buffer_size - 4);
3321 (void)string_format(p, big_buffer_size - (p - big_buffer), " %d args:", argc);
3323 for (i = 0; i < argc; i++)
3325 int len = Ustrlen(argv[i]);
3328 if (p + len + 8 >= big_buffer + big_buffer_size)
3331 log_write(0, LOG_MAIN, "%s", big_buffer);
3332 Ustrcpy(big_buffer, "...");
3335 printing = string_printing(argv[i]);
3336 if (printing[0] == 0) quote = US"\""; else
3338 uschar *pp = printing;
3340 while (*pp != 0) if (isspace(*pp++)) { quote = US"\""; break; }
3342 sprintf(CS p, " %s%.*s%s", quote, (int)(big_buffer_size -
3343 (p - big_buffer) - 4), printing, quote);
3347 if ((log_extra_selector & LX_arguments) != 0)
3348 log_write(0, LOG_MAIN, "%s", big_buffer);
3350 debug_printf("%s\n", big_buffer);
3353 /* Set the working directory to be the top-level spool directory. We don't rely
3354 on this in the code, which always uses fully qualified names, but it's useful
3355 for core dumps etc. Don't complain if it fails - the spool directory might not
3356 be generally accessible and calls with the -C option (and others) have lost
3357 privilege by now. Before the chdir, we try to ensure that the directory exists.
3360 if (Uchdir(spool_directory) != 0)
3362 (void)directory_make(spool_directory, US"", SPOOL_DIRECTORY_MODE, FALSE);
3363 (void)Uchdir(spool_directory);
3366 /* Handle calls with the -bi option. This is a sendmail option to rebuild *the*
3367 alias file. Exim doesn't have such a concept, but this call is screwed into
3368 Sun's YP makefiles. Handle this by calling a configured script, as the real
3369 user who called Exim. The -oA option can be used to pass an argument to the
3374 (void)fclose(config_file);
3375 if (bi_command != NULL)
3379 argv[i++] = bi_command;
3380 if (alias_arg != NULL) argv[i++] = alias_arg;
3383 setgroups(group_count, group_list);
3384 exim_setugid(real_uid, real_gid, FALSE, US"running bi_command");
3386 DEBUG(D_exec) debug_printf("exec %.256s %.256s\n", argv[0],
3387 (argv[1] == NULL)? US"" : argv[1]);
3389 execv(CS argv[0], (char *const *)argv);
3390 fprintf(stderr, "exim: exec failed: %s\n", strerror(errno));
3395 DEBUG(D_any) debug_printf("-bi used but bi_command not set; exiting\n");
3400 /* If an action on specific messages is requested, or if a daemon or queue
3401 runner is being started, we need to know if Exim was called by an admin user.
3402 This is the case if the real user is root or exim, or if the real group is
3403 exim, or if one of the supplementary groups is exim or a group listed in
3404 admin_groups. We don't fail all message actions immediately if not admin_user,
3405 since some actions can be performed by non-admin users. Instead, set admin_user
3406 for later interrogation. */
3408 if (real_uid == root_uid || real_uid == exim_uid || real_gid == exim_gid)
3414 for (i = 0; i < group_count; i++)
3416 if (group_list[i] == exim_gid) admin_user = TRUE;
3417 else if (admin_groups != NULL)
3419 for (j = 1; j <= (int)(admin_groups[0]); j++)
3420 if (admin_groups[j] == group_list[i])
3421 { admin_user = TRUE; break; }
3423 if (admin_user) break;
3427 /* Another group of privileged users are the trusted users. These are root,
3428 exim, and any caller matching trusted_users or trusted_groups. Trusted callers
3429 are permitted to specify sender_addresses with -f on the command line, and
3430 other message parameters as well. */
3432 if (real_uid == root_uid || real_uid == exim_uid)
3433 trusted_caller = TRUE;
3438 if (trusted_users != NULL)
3440 for (i = 1; i <= (int)(trusted_users[0]); i++)
3441 if (trusted_users[i] == real_uid)
3442 { trusted_caller = TRUE; break; }
3445 if (!trusted_caller && trusted_groups != NULL)
3447 for (i = 1; i <= (int)(trusted_groups[0]); i++)
3449 if (trusted_groups[i] == real_gid)
3450 trusted_caller = TRUE;
3451 else for (j = 0; j < group_count; j++)
3453 if (trusted_groups[i] == group_list[j])
3454 { trusted_caller = TRUE; break; }
3456 if (trusted_caller) break;
3461 if (trusted_caller) DEBUG(D_any) debug_printf("trusted user\n");
3462 if (admin_user) DEBUG(D_any) debug_printf("admin user\n");
3464 /* Only an admin user may start the daemon or force a queue run in the default
3465 configuration, but the queue run restriction can be relaxed. Only an admin
3466 user may request that a message be returned to its sender forthwith. Only an
3467 admin user may specify a debug level greater than D_v (because it might show
3468 passwords, etc. in lookup queries). Only an admin user may request a queue
3473 BOOL debugset = (debug_selector & ~D_v) != 0;
3474 if (deliver_give_up || daemon_listen ||
3475 (count_queue && queue_list_requires_admin) ||
3476 (list_queue && queue_list_requires_admin) ||
3477 (queue_interval >= 0 && prod_requires_admin) ||
3478 (debugset && !running_in_test_harness))
3480 fprintf(stderr, "exim:%s permission denied\n", debugset? " debugging" : "");
3485 /* If the real user is not root or the exim uid, the argument for passing
3486 in an open TCP/IP connection for another message is not permitted, nor is
3487 running with the -N option for any delivery action, unless this call to exim is
3488 one that supplied an input message, or we are using a patched exim for
3489 regression testing. */
3491 if (real_uid != root_uid && real_uid != exim_uid &&
3492 (continue_hostname != NULL ||
3494 (queue_interval >= 0 || daemon_listen || msg_action_arg > 0)
3495 )) && !running_in_test_harness)
3497 fprintf(stderr, "exim: Permission denied\n");
3498 return EXIT_FAILURE;
3501 /* If the caller is not trusted, certain arguments are ignored when running for
3502 real, but are permitted when checking things (-be, -bv, -bt, -bh, -bf, -bF).
3503 Note that authority for performing certain actions on messages is tested in the
3504 queue_action() function. */
3506 if (!trusted_caller && !checking && filter_test == FTEST_NONE)
3508 sender_host_name = sender_host_address = interface_address =
3509 sender_ident = received_protocol = NULL;
3510 sender_host_port = interface_port = 0;
3511 sender_host_authenticated = authenticated_sender = authenticated_id = NULL;
3514 /* If a sender host address is set, extract the optional port number off the
3515 end of it and check its syntax. Do the same thing for the interface address.
3516 Exim exits if the syntax is bad. */
3520 if (sender_host_address != NULL)
3521 sender_host_port = check_port(sender_host_address);
3522 if (interface_address != NULL)
3523 interface_port = check_port(interface_address);
3526 /* If an SMTP message is being received check to see if the standard input is a
3527 TCP/IP socket. If it is, we assume that Exim was called from inetd if the
3528 caller is root or the Exim user, or if the port is a privileged one. Otherwise,
3533 union sockaddr_46 inetd_sock;
3534 EXIM_SOCKLEN_T size = sizeof(inetd_sock);
3535 if (getpeername(0, (struct sockaddr *)(&inetd_sock), &size) == 0)
3537 int family = ((struct sockaddr *)(&inetd_sock))->sa_family;
3538 if (family == AF_INET || family == AF_INET6)
3540 union sockaddr_46 interface_sock;
3541 size = sizeof(interface_sock);
3543 if (getsockname(0, (struct sockaddr *)(&interface_sock), &size) == 0)
3544 interface_address = host_ntoa(-1, &interface_sock, NULL,
3547 if (host_is_tls_on_connect_port(interface_port)) tls_on_connect = TRUE;
3549 if (real_uid == root_uid || real_uid == exim_uid || interface_port < 1024)
3552 sender_host_address = host_ntoa(-1, (struct sockaddr *)(&inetd_sock),
3553 NULL, &sender_host_port);
3554 if (mua_wrapper) log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Input from "
3555 "inetd is not supported when mua_wrapper is set");
3560 "exim: Permission denied (unprivileged user, unprivileged port)\n");
3561 return EXIT_FAILURE;
3567 /* If the load average is going to be needed while receiving a message, get it
3568 now for those OS that require the first call to os_getloadavg() to be done as
3569 root. There will be further calls later for each message received. */
3571 #ifdef LOAD_AVG_NEEDS_ROOT
3572 if (receiving_message &&
3573 (queue_only_load >= 0 ||
3574 (is_inetd && smtp_load_reserve >= 0)
3577 load_average = os_getloadavg();
3581 /* The queue_only configuration option can be overridden by -odx on the command
3582 line, except that if queue_only_override is false, queue_only cannot be unset
3583 from the command line. */
3585 if (queue_only_set && (queue_only_override || arg_queue_only))
3586 queue_only = arg_queue_only;
3588 /* The receive_timeout and smtp_receive_timeout options can be overridden by
3591 if (arg_receive_timeout >= 0) receive_timeout = arg_receive_timeout;
3592 if (arg_smtp_receive_timeout >= 0)
3593 smtp_receive_timeout = arg_smtp_receive_timeout;
3595 /* If Exim was started with root privilege, unless we have already removed the
3596 root privilege above as a result of -C, -D, -be, -bf or -bF, remove it now
3597 except when starting the daemon or doing some kind of delivery or address
3598 testing (-bt). These are the only cases when root need to be retained. We run
3599 as exim for -bv and -bh. However, if deliver_drop_privilege is set, root is
3600 retained only for starting the daemon. */
3602 if (!unprivileged && /* originally had root AND */
3603 !removed_privilege && /* still got root AND */
3604 !daemon_listen && /* not starting the daemon */
3605 queue_interval <= 0 && /* (either kind of daemon) */
3607 deliver_drop_privilege || /* requested unprivileged */
3609 queue_interval < 0 && /* not running the queue */
3610 (msg_action_arg < 0 || /* and */
3611 msg_action != MSG_DELIVER) && /* not delivering and */
3612 (!checking || !address_test_mode) /* not address checking */
3616 exim_setugid(exim_uid, exim_gid, FALSE, US"privilege not needed");
3619 /* When we are retaining a privileged uid, we still change to the exim gid. */
3621 else setgid(exim_gid);
3623 /* Handle a request to list the delivery queue */
3627 set_process_info("listing the queue");
3628 queue_list(list_queue_option, argv + recipients_arg, argc - recipients_arg);
3632 /* Handle a request to count the delivery queue */
3636 set_process_info("counting the queue");
3641 /* Handle actions on specific messages, except for the force delivery action,
3642 which is done below. Some actions take a whole list of message ids, which
3643 are known to continue up to the end of the arguments. Others take a single
3644 message id and then operate on the recipients list. */
3646 if (msg_action_arg > 0 && msg_action != MSG_DELIVER)
3648 int yield = EXIT_SUCCESS;
3649 set_process_info("acting on specified messages");
3651 if (!one_msg_action)
3653 for (i = msg_action_arg; i < argc; i++)
3654 if (!queue_action(argv[i], msg_action, NULL, 0, 0))
3655 yield = EXIT_FAILURE;
3658 else if (!queue_action(argv[msg_action_arg], msg_action, argv, argc,
3659 recipients_arg)) yield = EXIT_FAILURE;
3663 /* All the modes below here require the remaining configuration sections
3664 to be read, except that we can skip over the ACL setting when delivering
3665 specific messages, or doing a queue run. (For various testing cases we could
3666 skip too, but as they are rare, it doesn't really matter.) The argument is TRUE
3669 readconf_rest(msg_action_arg > 0 || (queue_interval == 0 && !daemon_listen));
3671 /* The configuration data will have been read into POOL_PERM because we won't
3672 ever want to reset back past it. Change the current pool to POOL_MAIN. In fact,
3673 this is just a bit of pedantic tidiness. It wouldn't really matter if the
3674 configuration were read into POOL_MAIN, because we don't do any resets till
3675 later on. However, it seems right, and it does ensure that both pools get used.
3678 store_pool = POOL_MAIN;
3680 /* Handle the -brt option. This is for checking out retry configurations.
3681 The next three arguments are a domain name or a complete address, and
3682 optionally two error numbers. All it does is to call the function that
3683 scans the retry configuration data. */
3685 if (test_retry_arg >= 0)
3687 retry_config *yield;
3688 int basic_errno = 0;
3692 if (test_retry_arg >= argc)
3694 printf("-brt needs a domain or address argument\n");
3695 exim_exit(EXIT_FAILURE);
3697 s1 = argv[test_retry_arg++];
3700 /* If the first argument contains no @ and no . it might be a local user
3701 or it might be a single-component name. Treat as a domain. */
3703 if (Ustrchr(s1, '@') == NULL && Ustrchr(s1, '.') == NULL)
3705 printf("Warning: \"%s\" contains no '@' and no '.' characters. It is "
3706 "being \ntreated as a one-component domain, not as a local part.\n\n",
3710 /* There may be an optional second domain arg. */
3712 if (test_retry_arg < argc && Ustrchr(argv[test_retry_arg], '.') != NULL)
3713 s2 = argv[test_retry_arg++];
3715 /* The final arg is an error name */
3717 if (test_retry_arg < argc)
3719 uschar *ss = argv[test_retry_arg];
3721 readconf_retry_error(ss, ss + Ustrlen(ss), &basic_errno, &more_errno);
3724 printf("%s\n", CS error);
3725 return EXIT_FAILURE;
3728 /* For the rcpt_4xx errors, a value of 255 means "any", and a code > 100 as
3729 an error is for matching codes to the decade. Turn them into a real error
3730 code, off the decade. */
3732 if (basic_errno == ERRNO_RCPT4XX)
3734 int code = (more_errno >> 8) & 255;
3736 more_errno = (more_errno & 0xffff00ff) | (21 << 8);
3737 else if (code > 100)
3738 more_errno = (more_errno & 0xffff00ff) | ((code - 96) << 8);
3742 yield = retry_find_config(s1, s2, basic_errno, more_errno);
3743 if (yield == NULL) printf("No retry information found\n"); else
3746 more_errno = yield->more_errno;
3747 printf("Retry rule: %s ", yield->pattern);
3749 if (yield->basic_errno == ERRNO_EXIMQUOTA)
3751 printf("quota%s%s ",
3752 (more_errno > 0)? "_" : "",
3753 (more_errno > 0)? readconf_printtime(more_errno) : US"");
3755 else if (yield->basic_errno == ECONNREFUSED)
3757 printf("refused%s%s ",
3758 (more_errno > 0)? "_" : "",
3759 (more_errno == 'M')? "MX" :
3760 (more_errno == 'A')? "A" : "");
3762 else if (yield->basic_errno == ETIMEDOUT)
3765 if ((more_errno & RTEF_CTOUT) != 0) printf("_connect");
3767 if (more_errno != 0) printf("_%s",
3768 (more_errno == 'M')? "MX" : "A");
3771 else if (yield->basic_errno == ERRNO_AUTHFAIL)
3772 printf("auth_failed ");
3775 for (r = yield->rules; r != NULL; r = r->next)
3777 printf("%c,%s", r->rule, readconf_printtime(r->timeout)); /* Do not */
3778 printf(",%s", readconf_printtime(r->p1)); /* amalgamate */
3784 printf(",%d.", x/1000);
3798 exim_exit(EXIT_SUCCESS);
3801 /* Handle a request to list one or more configuration options */
3805 set_process_info("listing variables");
3806 if (recipients_arg >= argc) readconf_print(US"all", NULL);
3807 else for (i = recipients_arg; i < argc; i++)
3810 (Ustrcmp(argv[i], "router") == 0 ||
3811 Ustrcmp(argv[i], "transport") == 0 ||
3812 Ustrcmp(argv[i], "authenticator") == 0))
3814 readconf_print(argv[i+1], argv[i]);
3817 else readconf_print(argv[i], NULL);
3819 exim_exit(EXIT_SUCCESS);
3823 /* Handle a request to deliver one or more messages that are already on the
3824 queue. Values of msg_action other than MSG_DELIVER are dealt with above. This
3825 is typically used for a small number when prodding by hand (when the option
3826 forced_delivery will be set) or when re-execing to regain root privilege.
3827 Each message delivery must happen in a separate process, so we fork a process
3828 for each one, and run them sequentially so that debugging output doesn't get
3829 intertwined, and to avoid spawning too many processes if a long list is given.
3830 However, don't fork for the last one; this saves a process in the common case
3831 when Exim is called to deliver just one message. */
3833 if (msg_action_arg > 0)
3835 if (prod_requires_admin && !admin_user)
3837 fprintf(stderr, "exim: Permission denied\n");
3838 exim_exit(EXIT_FAILURE);
3840 set_process_info("delivering specified messages");
3841 if (deliver_give_up) forced_delivery = deliver_force_thaw = TRUE;
3842 for (i = msg_action_arg; i < argc; i++)
3847 (void)deliver_message(argv[i], forced_delivery, deliver_give_up);
3848 else if ((pid = fork()) == 0)
3850 (void)deliver_message(argv[i], forced_delivery, deliver_give_up);
3851 _exit(EXIT_SUCCESS);
3855 fprintf(stderr, "failed to fork delivery process for %s: %s\n", argv[i],
3857 exim_exit(EXIT_FAILURE);
3861 exim_exit(EXIT_SUCCESS);
3865 /* If only a single queue run is requested, without SMTP listening, we can just
3866 turn into a queue runner, with an optional starting message id. */
3868 if (queue_interval == 0 && !daemon_listen)
3870 DEBUG(D_queue_run) debug_printf("Single queue run%s%s%s%s\n",
3871 (start_queue_run_id == NULL)? US"" : US" starting at ",
3872 (start_queue_run_id == NULL)? US"" : start_queue_run_id,
3873 (stop_queue_run_id == NULL)? US"" : US" stopping at ",
3874 (stop_queue_run_id == NULL)? US"" : stop_queue_run_id);
3875 set_process_info("running the queue (single queue run)");
3876 queue_run(start_queue_run_id, stop_queue_run_id, FALSE);
3877 exim_exit(EXIT_SUCCESS);
3881 /* Find the login name of the real user running this process. This is always
3882 needed when receiving a message, because it is written into the spool file. It
3883 may also be used to construct a from: or a sender: header, and in this case we
3884 need the user's full name as well, so save a copy of it, checked for RFC822
3885 syntax and munged if necessary, if it hasn't previously been set by the -F
3886 argument. We may try to get the passwd entry more than once, in case NIS or
3887 other delays are in evidence. Save the home directory for use in filter testing
3892 if ((pw = getpwuid(real_uid)) != NULL)
3894 originator_login = string_copy(US pw->pw_name);
3895 originator_home = string_copy(US pw->pw_dir);
3897 /* If user name has not been set by -F, set it from the passwd entry
3898 unless -f has been used to set the sender address by a trusted user. */
3900 if (originator_name == NULL)
3902 if (sender_address == NULL ||
3903 (!trusted_caller && filter_test == FTEST_NONE))
3905 uschar *name = US pw->pw_gecos;
3906 uschar *amp = Ustrchr(name, '&');
3909 /* Most Unix specify that a '&' character in the gecos field is
3910 replaced by a copy of the login name, and some even specify that
3911 the first character should be upper cased, so that's what we do. */
3916 string_format(buffer, sizeof(buffer), "%.*s%n%s%s",
3917 amp - name, name, &loffset, originator_login, amp + 1);
3918 buffer[loffset] = toupper(buffer[loffset]);
3922 /* If a pattern for matching the gecos field was supplied, apply
3923 it and then expand the name string. */
3925 if (gecos_pattern != NULL && gecos_name != NULL)
3928 re = regex_must_compile(gecos_pattern, FALSE, TRUE); /* Use malloc */
3930 if (regex_match_and_setup(re, name, 0, -1))
3932 uschar *new_name = expand_string(gecos_name);
3934 if (new_name != NULL)
3936 DEBUG(D_receive) debug_printf("user name \"%s\" extracted from "
3937 "gecos field \"%s\"\n", new_name, name);
3940 else DEBUG(D_receive) debug_printf("failed to expand gecos_name string "
3941 "\"%s\": %s\n", gecos_name, expand_string_message);
3943 else DEBUG(D_receive) debug_printf("gecos_pattern \"%s\" did not match "
3944 "gecos field \"%s\"\n", gecos_pattern, name);
3945 store_free((void *)re);
3947 originator_name = string_copy(name);
3950 /* A trusted caller has used -f but not -F */
3952 else originator_name = US"";
3955 /* Break the retry loop */
3960 if (++i > finduser_retries) break;
3964 /* If we cannot get a user login, log the incident and give up, unless the
3965 configuration specifies something to use. When running in the test harness,
3966 any setting of unknown_login overrides the actual name. */
3968 if (originator_login == NULL || running_in_test_harness)
3970 if (unknown_login != NULL)
3972 originator_login = expand_string(unknown_login);
3973 if (originator_name == NULL && unknown_username != NULL)
3974 originator_name = expand_string(unknown_username);
3975 if (originator_name == NULL) originator_name = US"";
3977 if (originator_login == NULL)
3978 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Failed to get user name for uid %d",
3982 /* Ensure that the user name is in a suitable form for use as a "phrase" in an
3985 originator_name = string_copy(parse_fix_phrase(originator_name,
3986 Ustrlen(originator_name), big_buffer, big_buffer_size));
3988 /* If a message is created by this call of Exim, the uid/gid of its originator
3989 are those of the caller. These values are overridden if an existing message is
3990 read in from the spool. */
3992 originator_uid = real_uid;
3993 originator_gid = real_gid;
3995 DEBUG(D_receive) debug_printf("originator: uid=%d gid=%d login=%s name=%s\n",
3996 (int)originator_uid, (int)originator_gid, originator_login, originator_name);
3998 /* Run in daemon and/or queue-running mode. The function daemon_go() never
3999 returns. We leave this till here so that the originator_ fields are available
4000 for incoming messages via the daemon. The daemon cannot be run in mua_wrapper
4003 if (daemon_listen || queue_interval > 0)
4007 fprintf(stderr, "Daemon cannot be run when mua_wrapper is set\n");
4008 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "Daemon cannot be run when "
4009 "mua_wrapper is set");
4014 /* If the sender ident has not been set (by a trusted caller) set it to
4015 the caller. This will get overwritten below for an inetd call. If a trusted
4016 caller has set it empty, unset it. */
4018 if (sender_ident == NULL) sender_ident = originator_login;
4019 else if (sender_ident[0] == 0) sender_ident = NULL;
4021 /* Handle the -brw option, which is for checking out rewriting rules. Cause log
4022 writes (on errors) to go to stderr instead. Can't do this earlier, as want the
4023 originator_* variables set. */
4025 if (test_rewrite_arg >= 0)
4027 really_exim = FALSE;
4028 if (test_rewrite_arg >= argc)
4030 printf("-brw needs an address argument\n");
4031 exim_exit(EXIT_FAILURE);
4033 rewrite_test(argv[test_rewrite_arg]);
4034 exim_exit(EXIT_SUCCESS);
4037 /* A locally-supplied message is considered to be coming from a local user
4038 unless a trusted caller supplies a sender address with -f, or is passing in the
4039 message via SMTP (inetd invocation or otherwise). */
4041 if ((sender_address == NULL && !smtp_input) ||
4042 (!trusted_caller && filter_test == FTEST_NONE))
4044 sender_local = TRUE;
4046 /* A trusted caller can supply authenticated_sender and authenticated_id
4047 via -oMas and -oMai and if so, they will already be set. */
4049 if (authenticated_sender == NULL)
4050 authenticated_sender = string_sprintf("%s@%s", originator_login,
4051 qualify_domain_sender);
4052 if (authenticated_id == NULL) authenticated_id = originator_login;
4055 /* Trusted callers are always permitted to specify the sender address.
4056 Untrusted callers may specify it if it matches untrusted_set_sender, or if what
4057 is specified is the empty address. However, if a trusted caller does not
4058 specify a sender address for SMTP input, we leave sender_address unset. This
4059 causes the MAIL commands to be honoured. */
4061 if ((!smtp_input && sender_address == NULL) ||
4062 !receive_check_set_sender(sender_address))
4064 /* Either the caller is not permitted to set a general sender, or this is
4065 non-SMTP input and the trusted caller has not set a sender. If there is no
4066 sender, or if a sender other than <> is set, override with the originator's
4067 login (which will get qualified below), except when checking things. */
4069 if (sender_address == NULL /* No sender_address set */
4071 (sender_address[0] != 0 && /* Non-empty sender address, AND */
4072 !checking && /* Not running tests, AND */
4073 filter_test == FTEST_NONE)) /* Not testing a filter */
4075 sender_address = originator_login;
4076 sender_address_forced = FALSE;
4077 sender_address_domain = 0;
4081 /* Remember whether an untrusted caller set the sender address */
4083 sender_set_untrusted = sender_address != originator_login && !trusted_caller;
4085 /* Ensure that the sender address is fully qualified unless it is the empty
4086 address, which indicates an error message, or doesn't exist (root caller, smtp
4087 interface, no -f argument). */
4089 if (sender_address != NULL && sender_address[0] != 0 &&
4090 sender_address_domain == 0)
4091 sender_address = string_sprintf("%s@%s", local_part_quote(sender_address),
4092 qualify_domain_sender);
4094 DEBUG(D_receive) debug_printf("sender address = %s\n", sender_address);
4096 /* Handle a request to verify a list of addresses, or test them for delivery.
4097 This must follow the setting of the sender address, since routers can be
4098 predicated upon the sender. If no arguments are given, read addresses from
4099 stdin. Set debug_level to at least D_v to get full output for address testing.
4102 if (verify_address_mode || address_test_mode)
4105 int flags = vopt_qualify;
4107 if (verify_address_mode)
4109 if (!verify_as_sender) flags |= vopt_is_recipient;
4110 DEBUG(D_verify) debug_print_ids(US"Verifying:");
4115 flags |= vopt_is_recipient;
4116 debug_selector |= D_v;
4117 debug_file = stderr;
4118 debug_fd = fileno(debug_file);
4119 DEBUG(D_verify) debug_print_ids(US"Address testing:");
4122 if (recipients_arg < argc)
4124 while (recipients_arg < argc)
4126 uschar *s = argv[recipients_arg++];
4129 BOOL finished = FALSE;
4130 uschar *ss = parse_find_address_end(s, FALSE);
4131 if (*ss == ',') *ss = 0; else finished = TRUE;
4132 test_address(s, flags, &exit_value);
4135 while (*(++s) != 0 && (*s == ',' || isspace(*s)));
4142 uschar *s = get_stdinput(NULL, NULL);
4143 if (s == NULL) break;
4144 test_address(s, flags, &exit_value);
4148 exim_exit(exit_value);
4151 /* Handle expansion checking */
4155 if (recipients_arg < argc)
4157 while (recipients_arg < argc)
4159 uschar *s = argv[recipients_arg++];
4160 uschar *ss = expand_string(s);
4162 printf ("Failed: %s\n", expand_string_message);
4163 else printf("%s\n", CS ss);
4171 char *(*fn_readline)(char *) = NULL;
4172 char *(*fn_addhist)(char *) = NULL;
4175 void *dlhandle = set_readline(&fn_readline, &fn_addhist);
4181 uschar *source = get_stdinput(fn_readline, fn_addhist);
4182 if (source == NULL) break;
4183 ss = expand_string(source);
4185 printf ("Failed: %s\n", expand_string_message);
4186 else printf("%s\n", CS ss);
4190 if (dlhandle != NULL) dlclose(dlhandle);
4194 exim_exit(EXIT_SUCCESS);
4198 /* The active host name is normally the primary host name, but it can be varied
4199 for hosts that want to play several parts at once. We need to ensure that it is
4200 set for host checking, and for receiving messages. */
4202 smtp_active_hostname = primary_hostname;
4203 if (raw_active_hostname != NULL)
4205 uschar *nah = expand_string(raw_active_hostname);
4208 if (!expand_string_forcedfail)
4209 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to expand \"%s\" "
4210 "(smtp_active_hostname): %s", raw_active_hostname,
4211 expand_string_message);
4213 else if (nah[0] != 0) smtp_active_hostname = nah;
4216 /* Handle host checking: this facility mocks up an incoming SMTP call from a
4217 given IP address so that the blocking and relay configuration can be tested. An
4218 RFC 1413 call is made only if we are running in the test harness and an
4219 incoming interface and both ports are specified, because there is no TCP/IP
4220 call to find the ident for. */
4227 sender_ident = NULL;
4228 if (running_in_test_harness && sender_host_port != 0 &&
4229 interface_address != NULL && interface_port != 0)
4230 verify_get_ident(1413);
4232 /* In case the given address is a non-canonical IPv6 address, canonicize
4233 it. The code works for both IPv4 and IPv6, as it happens. */
4235 size = host_aton(sender_host_address, x);
4236 sender_host_address = store_get(48); /* large enough for full IPv6 */
4237 (void)host_nmtoa(size, x, -1, sender_host_address, ':');
4239 /* Now set up for testing */
4241 host_build_sender_fullhost();
4245 sender_local = FALSE;
4246 sender_host_notsocket = TRUE;
4247 debug_file = stderr;
4248 debug_fd = fileno(debug_file);
4249 fprintf(stdout, "\n**** SMTP testing session as if from host %s\n"
4250 "**** but without any ident (RFC 1413) callback.\n"
4251 "**** This is not for real!\n\n",
4252 sender_host_address);
4254 if (verify_check_host(&hosts_connection_nolog) == OK)
4255 log_write_selector &= ~L_smtp_connection;
4256 log_write(L_smtp_connection, LOG_MAIN, "%s", smtp_get_connection_info());
4258 if (smtp_start_session())
4260 reset_point = store_get(0);
4263 store_reset(reset_point);
4264 if (smtp_setup_msg() <= 0) break;
4265 if (!receive_msg(FALSE)) break;
4268 exim_exit(EXIT_SUCCESS);
4272 /* Arrange for message reception if recipients or SMTP were specified;
4273 otherwise complain unless a version print (-bV) happened or this is a filter
4274 verification test. In the former case, show the configuration file name. */
4276 if (recipients_arg >= argc && !extract_recipients && !smtp_input)
4278 if (version_printed)
4280 printf("Configuration file is %s\n", config_main_filename);
4281 return EXIT_SUCCESS;
4283 if (filter_test == FTEST_NONE)
4286 "Exim is a Mail Transfer Agent. It is normally called by Mail User Agents,\n"
4287 "not directly from a shell command line. Options and/or arguments control\n"
4288 "what it does when called. For a list of options, see the Exim documentation.\n");
4289 return EXIT_FAILURE;
4294 /* If mua_wrapper is set, Exim is being used to turn an MUA that submits on the
4295 standard input into an MUA that submits to a smarthost over TCP/IP. We know
4296 that we are not called from inetd, because that is rejected above. The
4297 following configuration settings are forced here:
4299 (1) Synchronous delivery (-odi)
4300 (2) Errors to stderr (-oep == -oeq)
4301 (3) No parallel remote delivery
4302 (4) Unprivileged delivery
4304 We don't force overall queueing options because there are several of them;
4305 instead, queueing is avoided below when mua_wrapper is set. However, we do need
4306 to override any SMTP queueing. */
4310 synchronous_delivery = TRUE;
4311 arg_error_handling = ERRORS_STDERR;
4312 remote_max_parallel = 1;
4313 deliver_drop_privilege = TRUE;
4315 queue_smtp_domains = NULL;
4319 /* Prepare to accept one or more new messages on the standard input. When a
4320 message has been read, its id is returned in message_id[]. If doing immediate
4321 delivery, we fork a delivery process for each received message, except for the
4322 last one, where we can save a process switch.
4324 It is only in non-smtp mode that error_handling is allowed to be changed from
4325 its default of ERRORS_SENDER by argument. (Idle thought: are any of the
4326 sendmail error modes other than -oem ever actually used? Later: yes.) */
4328 if (!smtp_input) error_handling = arg_error_handling;
4330 /* If this is an inetd call, ensure that stderr is closed to prevent panic
4331 logging being sent down the socket and make an identd call to get the
4336 (void)fclose(stderr);
4337 exim_nullstd(); /* Re-open to /dev/null */
4338 verify_get_ident(IDENT_PORT);
4339 host_build_sender_fullhost();
4340 set_process_info("handling incoming connection from %s via inetd",
4344 /* If the sender host address has been set, build sender_fullhost if it hasn't
4345 already been done (which it will have been for inetd). This caters for the
4346 case when it is forced by -oMa. However, we must flag that it isn't a socket,
4347 so that the test for IP options is skipped for -bs input. */
4349 if (sender_host_address != NULL && sender_fullhost == NULL)
4351 host_build_sender_fullhost();
4352 set_process_info("handling incoming connection from %s via -oMa",
4354 sender_host_notsocket = TRUE;
4357 /* Otherwise, set the sender host as unknown except for inetd calls. This
4358 prevents host checking in the case of -bs not from inetd and also for -bS. */
4360 else if (!is_inetd) sender_host_unknown = TRUE;
4362 /* If stdout does not exist, then dup stdin to stdout. This can happen
4363 if exim is started from inetd. In this case fd 0 will be set to the socket,
4364 but fd 1 will not be set. This also happens for passed SMTP channels. */
4366 if (fstat(1, &statbuf) < 0) (void)dup2(0, 1);
4368 /* Set up the incoming protocol name and the state of the program. Root
4369 is allowed to force received protocol via the -oMr option above, and if we are
4370 in a non-local SMTP state it means we have come via inetd and the process info
4371 has already been set up. We don't set received_protocol here for smtp input,
4372 as it varies according to batch/HELO/EHLO/AUTH/TLS. */
4376 if (sender_local) set_process_info("accepting a local SMTP message from <%s>",
4381 if (received_protocol == NULL)
4382 received_protocol = string_sprintf("local%s", called_as);
4383 set_process_info("accepting a local non-SMTP message from <%s>",
4387 /* Initialize the local_queue-only flag (this will be ignored if mua_wrapper is
4391 local_queue_only = queue_only;
4393 /* For non-SMTP and for batched SMTP input, check that there is enough space on
4394 the spool if so configured. On failure, we must not attempt to send an error
4395 message! (For interactive SMTP, the check happens at MAIL FROM and an SMTP
4396 error code is given.) */
4398 if ((!smtp_input || smtp_batched_input) && !receive_check_fs(0))
4400 fprintf(stderr, "exim: insufficient disk space\n");
4401 return EXIT_FAILURE;
4404 /* If this is smtp input of any kind, handle the start of the SMTP
4411 if (verify_check_host(&hosts_connection_nolog) == OK)
4412 log_write_selector &= ~L_smtp_connection;
4413 log_write(L_smtp_connection, LOG_MAIN, "%s", smtp_get_connection_info());
4414 if (!smtp_start_session())
4417 exim_exit(EXIT_SUCCESS);
4421 /* Otherwise, set up the input size limit here */
4425 thismessage_size_limit = expand_string_integer(message_size_limit);
4426 if (thismessage_size_limit < 0)
4428 if (thismessage_size_limit == -1)
4429 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to expand "
4430 "message_size_limit: %s", expand_string_message);
4432 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "invalid value for "
4433 "message_size_limit: %s", expand_string_message);
4437 /* Loop for several messages when reading SMTP input. If we fork any child
4438 processes, we don't want to wait for them unless synchronous delivery is
4439 requested, so set SIGCHLD to SIG_IGN in that case. This is not necessarily the
4440 same as SIG_DFL, despite the fact that documentation often lists the default as
4441 "ignore". This is a confusing area. This is what I know:
4443 At least on some systems (e.g. Solaris), just setting SIG_IGN causes child
4444 processes that complete simply to go away without ever becoming defunct. You
4445 can't then wait for them - but we don't want to wait for them in the
4446 non-synchronous delivery case. However, this behaviour of SIG_IGN doesn't
4447 happen for all OS (e.g. *BSD is different).
4449 But that's not the end of the story. Some (many? all?) systems have the
4450 SA_NOCLDWAIT option for sigaction(). This requests the behaviour that Solaris
4451 has by default, so it seems that the difference is merely one of default
4452 (compare restarting vs non-restarting signals).
4454 To cover all cases, Exim sets SIG_IGN with SA_NOCLDWAIT here if it can. If not,
4455 it just sets SIG_IGN. To be on the safe side it also calls waitpid() at the end
4456 of the loop below. Paranoia rules.
4458 February 2003: That's *still* not the end of the story. There are now versions
4459 of Linux (where SIG_IGN does work) that are picky. If, having set SIG_IGN, a
4460 process then calls waitpid(), a grumble is written to the system log, because
4461 this is logically inconsistent. In other words, it doesn't like the paranoia.
4462 As a consequenc of this, the waitpid() below is now excluded if we are sure
4463 that SIG_IGN works. */
4465 if (!synchronous_delivery)
4468 struct sigaction act;
4469 act.sa_handler = SIG_IGN;
4470 sigemptyset(&(act.sa_mask));
4471 act.sa_flags = SA_NOCLDWAIT;
4472 sigaction(SIGCHLD, &act, NULL);
4474 signal(SIGCHLD, SIG_IGN);
4478 /* Save the current store pool point, for resetting at the start of
4479 each message, and save the real sender address, if any. */
4481 reset_point = store_get(0);
4482 real_sender_address = sender_address;
4484 /* Loop to receive messages; receive_msg() returns TRUE if there are more
4485 messages to be read (SMTP input), or FALSE otherwise (not SMTP, or SMTP channel
4490 store_reset(reset_point);
4493 /* In the SMTP case, we have to handle the initial SMTP input and build the
4494 recipients list, before calling receive_msg() to read the message proper.
4495 Whatever sender address is actually given in the SMTP transaction is
4496 actually ignored for local senders - we use the actual sender, which is
4497 normally either the underlying user running this process or a -f argument
4498 provided by a trusted caller. It is saved in real_sender_address.
4500 However, if this value is NULL, we are dealing with a trusted caller when
4501 -f was not used; in this case, the SMTP sender is allowed to stand.
4503 Also, if untrusted_set_sender is set, we permit sender addresses that match
4504 anything in its list.
4506 The variable raw_sender_address holds the sender address before rewriting. */
4511 if ((rc = smtp_setup_msg()) > 0)
4513 if (real_sender_address != NULL &&
4514 !receive_check_set_sender(sender_address))
4516 sender_address = raw_sender = real_sender_address;
4517 sender_address_unrewritten = NULL;
4519 more = receive_msg(extract_recipients);
4520 if (message_id[0] == 0)
4523 exim_exit(EXIT_FAILURE);
4526 else exim_exit((rc == 0)? EXIT_SUCCESS : EXIT_FAILURE);
4529 /* In the non-SMTP case, we have all the information from the command
4530 line, but must process it in case it is in the more general RFC822
4531 format, and in any case, to detect syntax errors. Also, it appears that
4532 the use of comma-separated lists as single arguments is common, so we
4533 had better support them. */
4539 int count = argc - recipients_arg;
4540 uschar **list = argv + recipients_arg;
4542 /* These options cannot be changed dynamically for non-SMTP messages */
4544 active_local_sender_retain = local_sender_retain;
4545 active_local_from_check = local_from_check;
4547 /* Save before any rewriting */
4549 raw_sender = string_copy(sender_address);
4551 /* Loop for each argument */
4553 for (i = 0; i < count; i++)
4555 int start, end, domain;
4557 uschar *s = list[i];
4559 /* Loop for each comma-separated address */
4563 BOOL finished = FALSE;
4565 uschar *ss = parse_find_address_end(s, FALSE);
4567 if (*ss == ',') *ss = 0; else finished = TRUE;
4569 /* Check max recipients - if -t was used, these aren't recipients */
4571 if (recipients_max > 0 && ++rcount > recipients_max &&
4572 !extract_recipients)
4574 if (error_handling == ERRORS_STDERR)
4576 fprintf(stderr, "exim: too many recipients\n");
4577 exim_exit(EXIT_FAILURE);
4582 moan_to_sender(ERRMESS_TOOMANYRECIP, NULL, NULL, stdin, TRUE)?
4583 errors_sender_rc : EXIT_FAILURE;
4588 parse_extract_address(s, &errmess, &start, &end, &domain, FALSE);
4590 if (domain == 0 && !allow_unqualified_recipient)
4593 errmess = US"unqualified recipient address not allowed";
4596 if (recipient == NULL)
4598 if (error_handling == ERRORS_STDERR)
4600 fprintf(stderr, "exim: bad recipient address \"%s\": %s\n",
4601 string_printing(list[i]), errmess);
4602 exim_exit(EXIT_FAILURE);
4608 eblock.text1 = string_printing(list[i]);
4609 eblock.text2 = errmess;
4611 moan_to_sender(ERRMESS_BADARGADDRESS, &eblock, NULL, stdin, TRUE)?
4612 errors_sender_rc : EXIT_FAILURE;
4616 receive_add_recipient(recipient, -1);
4619 while (*(++s) != 0 && (*s == ',' || isspace(*s)));
4623 /* Show the recipients when debugging */
4628 if (sender_address != NULL) debug_printf("Sender: %s\n", sender_address);
4629 if (recipients_list != NULL)
4631 debug_printf("Recipients:\n");
4632 for (i = 0; i < recipients_count; i++)
4633 debug_printf(" %s\n", recipients_list[i].address);
4637 /* Read the data for the message. If filter_test is not FTEST_NONE, this
4638 will just read the headers for the message, and not write anything onto the
4641 message_ended = END_NOTENDED;
4642 more = receive_msg(extract_recipients);
4644 /* more is always FALSE here (not SMTP message) when reading a message
4645 for real; when reading the headers of a message for filter testing,
4646 it is TRUE if the headers were terminated by '.' and FALSE otherwise. */
4648 if (message_id[0] == 0) exim_exit(EXIT_FAILURE);
4649 } /* Non-SMTP message reception */
4651 /* If this is a filter testing run, there are headers in store, but
4652 no message on the spool. Run the filtering code in testing mode, setting
4653 the domain to the qualify domain and the local part to the current user,
4654 unless they have been set by options. The prefix and suffix are left unset
4655 unless specified. The the return path is set to to the sender unless it has
4656 already been set from a return-path header in the message. */
4658 if (filter_test != FTEST_NONE)
4660 deliver_domain = (ftest_domain != NULL)?
4661 ftest_domain : qualify_domain_recipient;
4662 deliver_domain_orig = deliver_domain;
4663 deliver_localpart = (ftest_localpart != NULL)?
4664 ftest_localpart : originator_login;
4665 deliver_localpart_orig = deliver_localpart;
4666 deliver_localpart_prefix = ftest_prefix;
4667 deliver_localpart_suffix = ftest_suffix;
4668 deliver_home = originator_home;
4670 if (return_path == NULL)
4672 printf("Return-path copied from sender\n");
4673 return_path = string_copy(sender_address);
4677 printf("Return-path = %s\n", (return_path[0] == 0)? US"<>" : return_path);
4679 printf("Sender = %s\n", (sender_address[0] == 0)? US"<>" : sender_address);
4681 receive_add_recipient(
4682 string_sprintf("%s%s%s@%s",
4683 (ftest_prefix == NULL)? US"" : ftest_prefix,
4685 (ftest_suffix == NULL)? US"" : ftest_suffix,
4686 deliver_domain), -1);
4688 printf("Recipient = %s\n", recipients_list[0].address);
4689 if (ftest_prefix != NULL) printf("Prefix = %s\n", ftest_prefix);
4690 if (ftest_suffix != NULL) printf("Suffix = %s\n", ftest_suffix);
4692 (void)chdir("/"); /* Get away from wherever the user is running this from */
4694 /* Now we run either a system filter test, or a user filter test, or both.
4695 In the latter case, headers added by the system filter will persist and be
4696 available to the user filter. We need to copy the filter variables
4699 if ((filter_test & FTEST_SYSTEM) != 0)
4701 if (!filter_runtest(filter_sfd, filter_test_sfile, TRUE, more))
4702 exim_exit(EXIT_FAILURE);
4705 memcpy(filter_sn, filter_n, sizeof(filter_sn));
4707 if ((filter_test & FTEST_USER) != 0)
4709 if (!filter_runtest(filter_ufd, filter_test_ufile, FALSE, more))
4710 exim_exit(EXIT_FAILURE);
4713 exim_exit(EXIT_SUCCESS);
4716 /* Else act on the result of message reception. We should not get here unless
4717 message_id[0] is non-zero. If queue_only is set, local_queue_only will be
4718 TRUE. If it is not, check on the number of messages received in this
4719 connection. If that's OK and queue_only_load is set, check that the load
4720 average is below it. If it is not, set local_queue_only TRUE. Note that it
4721 then remains this way for any subsequent messages on the same SMTP connection.
4722 This is a deliberate choice; even though the load average may fall, it
4723 doesn't seem right to deliver later messages on the same call when not
4724 delivering earlier ones. */
4726 if (!local_queue_only)
4728 if (smtp_accept_queue_per_connection > 0 &&
4729 receive_messagecount > smtp_accept_queue_per_connection)
4731 local_queue_only = TRUE;
4732 queue_only_reason = 2;
4734 else if (queue_only_load >= 0)
4736 local_queue_only = (load_average = os_getloadavg()) > queue_only_load;
4737 if (local_queue_only) queue_only_reason = 3;
4741 /* If running as an MUA wrapper, all queueing options and freezing options
4745 local_queue_only = queue_only_policy = deliver_freeze = FALSE;
4747 /* Log the queueing here, when it will get a message id attached, but
4748 not if queue_only is set (case 0). Case 1 doesn't happen here (too many
4751 if (local_queue_only) switch(queue_only_reason)
4754 log_write(L_delay_delivery,
4755 LOG_MAIN, "no immediate delivery: more than %d messages "
4756 "received in one connection", smtp_accept_queue_per_connection);
4760 log_write(L_delay_delivery,
4761 LOG_MAIN, "no immediate delivery: load average %.2f",
4762 (double)load_average/1000.0);
4766 /* Else do the delivery unless the ACL or local_scan() called for queue only
4767 or froze the message. Always deliver in a separate process. A fork failure is
4768 not a disaster, as the delivery will eventually happen on a subsequent queue
4769 run. The search cache must be tidied before the fork, as the parent will
4770 do it before exiting. The child will trigger a lookup failure and
4771 thereby defer the delivery if it tries to use (for example) a cached ldap
4772 connection that the parent has called unbind on. */
4774 else if (!queue_only_policy && !deliver_freeze)
4779 if ((pid = fork()) == 0)
4782 close_unwanted(); /* Close unwanted file descriptors and TLS */
4783 exim_nullstd(); /* Ensure std{in,out,err} exist */
4785 /* Re-exec Exim if we need to regain privilege (note: in mua_wrapper
4786 mode, deliver_drop_privilege is forced TRUE). */
4788 if (geteuid() != root_uid && !deliver_drop_privilege && !unprivileged)
4790 (void)child_exec_exim(CEE_EXEC_EXIT, FALSE, NULL, FALSE, 2, US"-Mc",
4792 /* Control does not return here. */
4795 /* No need to re-exec */
4797 rc = deliver_message(message_id, FALSE, FALSE);
4799 _exit((!mua_wrapper || rc == DELIVER_MUA_SUCCEEDED)?
4800 EXIT_SUCCESS : EXIT_FAILURE);
4805 log_write(0, LOG_MAIN|LOG_PANIC, "failed to fork automatic delivery "
4806 "process: %s", strerror(errno));
4809 /* In the parent, wait if synchronous delivery is required. This will
4810 always be the case in MUA wrapper mode. */
4812 else if (synchronous_delivery)
4815 while (wait(&status) != pid);
4816 if ((status & 0x00ff) != 0)
4817 log_write(0, LOG_MAIN|LOG_PANIC,
4818 "process %d crashed with signal %d while delivering %s",
4819 (int)pid, status & 0x00ff, message_id);
4820 if (mua_wrapper && (status & 0xffff) != 0) exim_exit(EXIT_FAILURE);
4824 /* The loop will repeat if more is TRUE. If we do not know know that the OS
4825 automatically reaps children (see comments above the loop), clear away any
4826 finished subprocesses here, in case there are lots of messages coming in
4827 from the same source. */
4829 #ifndef SIG_IGN_WORKS
4830 while (waitpid(-1, NULL, WNOHANG) > 0);
4834 exim_exit(EXIT_SUCCESS); /* Never returns */
4835 return 0; /* To stop compiler warning */