Error if -q is given more than once.
[exim.git] / src / src / exim.c
1 /* $Cambridge: exim/src/src/exim.c,v 1.49 2006/11/13 11:56:41 ph10 Exp $ */
2
3 /*************************************************
4 * Exim - an Internet mail transport agent *
5 *************************************************/
6
7 /* Copyright (c) University of Cambridge 1995 - 2006 */
8 /* See the file NOTICE for conditions of use and distribution. */
9
10
11 /* The main function: entry point, initialization, and high-level control.
12 Also a few functions that don't naturally fit elsewhere. */
13
14
15 #include "exim.h"
16
17
18
19 /*************************************************
20 * Function interface to store functions *
21 *************************************************/
22
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. */
30
31 static void *
32 function_store_get(size_t size)
33 {
34 return store_get((int)size);
35 }
36
37 static void
38 function_dummy_free(void *block) { block = block; }
39
40 static void *
41 function_store_malloc(size_t size)
42 {
43 return store_malloc((int)size);
44 }
45
46 static void
47 function_store_free(void *block)
48 {
49 store_free(block);
50 }
51
52
53
54
55 /*************************************************
56 * Compile regular expression and panic on fail *
57 *************************************************/
58
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.
64
65 Argument:
66 pattern the pattern to compile
67 caseless TRUE if caseless matching is required
68 use_malloc TRUE if compile into malloc store
69
70 Returns: pointer to the compiled pattern
71 */
72
73 const pcre *
74 regex_must_compile(uschar *pattern, BOOL caseless, BOOL use_malloc)
75 {
76 int offset;
77 int options = PCRE_COPT;
78 const pcre *yield;
79 const uschar *error;
80 if (use_malloc)
81 {
82 pcre_malloc = function_store_malloc;
83 pcre_free = function_store_free;
84 }
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;
89 if (yield == NULL)
90 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "regular expression error: "
91 "%s at offset %d while compiling %s", error, offset, pattern);
92 return yield;
93 }
94
95
96
97
98 /*************************************************
99 * Execute regular expression and set strings *
100 *************************************************/
101
102 /* This function runs a regular expression match, and sets up the pointers to
103 the matched substrings.
104
105 Arguments:
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
112
113 Returns: TRUE or FALSE
114 */
115
116 BOOL
117 regex_match_and_setup(const pcre *re, uschar *subject, int options, int setup)
118 {
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));
122 BOOL yield = n >= 0;
123 if (n == 0) n = EXPAND_MAXN + 1;
124 if (yield)
125 {
126 int nn;
127 expand_nmax = (setup < 0)? 0 : setup + 1;
128 for (nn = (setup < 0)? 0 : 2; nn < n*2; nn += 2)
129 {
130 expand_nstring[expand_nmax] = subject + ovector[nn];
131 expand_nlength[expand_nmax++] = ovector[nn+1] - ovector[nn];
132 }
133 expand_nmax--;
134 }
135 return yield;
136 }
137
138
139
140
141 /*************************************************
142 * Handler for SIGUSR1 *
143 *************************************************/
144
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.
149
150 Argument: the signal number (SIGUSR1)
151 Returns: nothing
152 */
153
154 static void
155 usr1_handler(int sig)
156 {
157 sig = sig; /* Keep picky compilers happy */
158 log_write(0, LOG_PROCESS, "%s", process_info);
159 log_close_all();
160 os_restarting_signal(SIGUSR1, usr1_handler);
161 }
162
163
164
165 /*************************************************
166 * Timeout handler *
167 *************************************************/
168
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
172 re-enables itself.
173
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.
178
179 Argument: the signal value (SIGALRM)
180 Returns: nothing
181 */
182
183 void
184 sigalrm_handler(int sig)
185 {
186 sig = sig; /* Keep picky compilers happy */
187 sigalrm_seen = TRUE;
188 os_non_restarting_signal(SIGALRM, sigalrm_handler);
189 }
190
191
192
193 /*************************************************
194 * Sleep for a fractional time interval *
195 *************************************************/
196
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. :-)
203
204 Argument: an itimerval structure containing the interval
205 Returns: nothing
206 */
207
208 static void
209 milliwait(struct itimerval *itval)
210 {
211 sigset_t sigmask;
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 */
223 }
224
225
226
227
228 /*************************************************
229 * Millisecond sleep function *
230 *************************************************/
231
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
234 spammers.
235
236 Argument: number of millseconds
237 Returns: nothing
238 */
239
240 void
241 millisleep(int msec)
242 {
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;
248 milliwait(&itval);
249 }
250
251
252
253 /*************************************************
254 * Compare microsecond times *
255 *************************************************/
256
257 /*
258 Arguments:
259 tv1 the first time
260 tv2 the second time
261
262 Returns: -1, 0, or +1
263 */
264
265 int
266 exim_tvcmp(struct timeval *t1, struct timeval *t2)
267 {
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;
272 return 0;
273 }
274
275
276
277
278 /*************************************************
279 * Clock tick wait function *
280 *************************************************/
281
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.
291
292 Arguments:
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)
298
299 Returns: nothing
300 */
301
302 void
303 exim_wait_tick(struct timeval *then_tv, int resolution)
304 {
305 struct timeval now_tv;
306 long int now_true_usec;
307
308 (void)gettimeofday(&now_tv, NULL);
309 now_true_usec = now_tv.tv_usec;
310 now_tv.tv_usec = (now_true_usec/resolution) * resolution;
311
312 if (exim_tvcmp(&now_tv, then_tv) <= 0)
313 {
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;
319
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. */
324
325 if (itval.it_value.tv_usec < 0)
326 {
327 itval.it_value.tv_usec += 1000000;
328 itval.it_value.tv_sec -= 1;
329 }
330
331 DEBUG(D_transport|D_receive)
332 {
333 if (!running_in_test_harness)
334 {
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);
339 }
340 }
341
342 milliwait(&itval);
343 }
344 }
345
346
347
348
349 /*************************************************
350 * Set up processing details *
351 *************************************************/
352
353 /* Save a text string for dumping when SIGUSR1 is received.
354 Do checks for overruns.
355
356 Arguments: format and arguments, as for printf()
357 Returns: nothing
358 */
359
360 void
361 set_process_info(char *format, ...)
362 {
363 int len;
364 va_list ap;
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);
371 va_end(ap);
372 }
373
374
375
376
377
378 /*************************************************
379 * Call fopen() with umask 777 and adjust mode *
380 *************************************************/
381
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.
388
389 Arguments:
390 filename the file name
391 options the fopen() options
392 mode the required mode
393
394 Returns: the fopened FILE or NULL
395 */
396
397 FILE *
398 modefopen(uschar *filename, char *options, mode_t mode)
399 {
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);
404 return f;
405 }
406
407
408
409
410 /*************************************************
411 * Ensure stdin, stdout, and stderr exist *
412 *************************************************/
413
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.
420
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.
423
424 Arguments: None
425 Returns: Nothing
426 */
427
428 void
429 exim_nullstd(void)
430 {
431 int i;
432 int devnull = -1;
433 struct stat statbuf;
434 for (i = 0; i <= 2; i++)
435 {
436 if (fstat(i, &statbuf) < 0 && errno == EBADF)
437 {
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);
442 }
443 }
444 if (devnull > 2) (void)close(devnull);
445 }
446
447
448
449
450 /*************************************************
451 * Close unwanted file descriptors for delivery *
452 *************************************************/
453
454 /* This function is called from a new process that has been forked to deliver
455 an incoming message, either directly, or using exec.
456
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.
463
464 If TLS is active, we want to shut down the TLS library, but without molesting
465 the parent's SSL connection.
466
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.
472
473 Exception: We do want it for synchronous delivery!
474
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
477 debugging output.
478
479 When we close stderr (which implies we've also closed stdout), we also get rid
480 of any controlling terminal.
481
482 Arguments: None
483 Returns: Nothing
484 */
485
486 static void
487 close_unwanted(void)
488 {
489 if (smtp_input)
490 {
491 #ifdef SUPPORT_TLS
492 tls_close(FALSE); /* Shut down the TLS library */
493 #endif
494 (void)close(fileno(smtp_in));
495 (void)close(fileno(smtp_out));
496 smtp_in = NULL;
497 }
498 else
499 {
500 (void)close(0); /* stdin */
501 if ((debug_selector & D_resolver) == 0) (void)close(1); /* stdout */
502 if (debug_selector == 0) /* stderr */
503 {
504 if (!synchronous_delivery)
505 {
506 (void)close(2);
507 log_stderr = NULL;
508 }
509 (void)setsid();
510 }
511 }
512 }
513
514
515
516
517 /*************************************************
518 * Set uid and gid *
519 *************************************************/
520
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.
526
527 Arguments:
528 uid the uid
529 gid the gid
530 igflag TRUE if initgroups() wanted
531 msg text to use in debugging output and failure log
532
533 Returns: nothing; bombs out on failure
534 */
535
536 void
537 exim_setugid(uid_t uid, gid_t gid, BOOL igflag, uschar *msg)
538 {
539 uid_t euid = geteuid();
540 gid_t egid = getegid();
541
542 if (euid == root_uid || euid != uid || egid != gid || igflag)
543 {
544 /* At least one OS returns +1 for initgroups failure, so just check for
545 non-zero. */
546
547 if (igflag)
548 {
549 struct passwd *pw = getpwuid(uid);
550 if (pw != NULL)
551 {
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));
555 }
556 else log_write(0, LOG_MAIN|LOG_PANIC_DIE, "cannot run initgroups(): "
557 "no passwd entry for uid=%ld", (long int)uid);
558 }
559
560 if (setgid(gid) < 0 || setuid(uid) < 0)
561 {
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);
564 }
565 }
566
567 /* Debugging output included uid/gid and all groups */
568
569 DEBUG(D_uid)
570 {
571 int group_count;
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:");
577 if (group_count > 0)
578 {
579 int i;
580 for (i = 0; i < group_count; i++) debug_printf(" %d", (int)group_list[i]);
581 }
582 else debug_printf(" <none>");
583 debug_printf("\n");
584 }
585 }
586
587
588
589
590 /*************************************************
591 * Exit point *
592 *************************************************/
593
594 /* Exim exits via this function so that it always clears up any open
595 databases.
596
597 Arguments:
598 rc return code
599
600 Returns: does not return
601 */
602
603 void
604 exim_exit(int rc)
605 {
606 search_tidyup();
607 DEBUG(D_any)
608 debug_printf(">>>>>>>>>>>>>>>> Exim pid=%d terminating with rc=%d "
609 ">>>>>>>>>>>>>>>>\n", (int)getpid(), rc);
610 exit(rc);
611 }
612
613
614
615
616 /*************************************************
617 * Extract port from host address *
618 *************************************************/
619
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.
623
624 Argument:
625 address the address, with possible port on the end
626
627 Returns: the port, or zero if there isn't one
628 bombs out on a syntax error
629 */
630
631 static int
632 check_port(uschar *address)
633 {
634 int port = host_address_extract_port(address);
635 if (string_is_ip_address(address, NULL) == 0)
636 {
637 fprintf(stderr, "exim abandoned: \"%s\" is not an IP address\n", address);
638 exit(EXIT_FAILURE);
639 }
640 return port;
641 }
642
643
644
645 /*************************************************
646 * Test/verify an address *
647 *************************************************/
648
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.
652
653 Arguments:
654 s the address string
655 flags flag bits for verify_address()
656 exit_value to be set for failures
657
658 Returns: nothing
659 */
660
661 static void
662 test_address(uschar *s, int flags, int *exit_value)
663 {
664 int start, end, domain;
665 uschar *parse_error = NULL;
666 uschar *address = parse_extract_address(s, &parse_error, &start, &end, &domain,
667 FALSE);
668 if (address == NULL)
669 {
670 fprintf(stdout, "syntax error: %s\n", parse_error);
671 *exit_value = 2;
672 }
673 else
674 {
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;
679 }
680 }
681
682
683
684 /*************************************************
685 * Decode bit settings for log/debug *
686 *************************************************/
687
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.
693
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.
697
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.
701
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...
705
706 Arguments:
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
713 count size of table
714 which "log" or "debug"
715
716 Returns: nothing on success - bomb out on failure
717 */
718
719 static void
720 decode_bits(unsigned int *selector1, unsigned int *selector2, int notall1,
721 int notall2, uschar *string, bit_table *options, int count, uschar *which)
722 {
723 uschar *errmsg;
724 if (string == NULL) return;
725
726 if (*string == '=')
727 {
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,
732 string);
733 goto ERROR_RETURN;
734 }
735
736 /* Handle symbolic setting */
737
738 else for(;;)
739 {
740 BOOL adding;
741 uschar *s;
742 int len;
743 bit_table *start, *end;
744
745 while (isspace(*string)) string++;
746 if (*string == 0) return;
747
748 if (*string != '+' && *string != '-')
749 {
750 errmsg = string_sprintf("malformed %s_selector setting: "
751 "+ or - expected but found \"%s\"", which, string);
752 goto ERROR_RETURN;
753 }
754
755 adding = *string++ == '+';
756 s = string;
757 while (isalnum(*string) || *string == '_') string++;
758 len = string - s;
759
760 start = options;
761 end = options + count;
762
763 while (start < end)
764 {
765 bit_table *middle = start + (end - start)/2;
766 int c = Ustrncmp(s, middle->name, len);
767 if (c == 0)
768 {
769 if (middle->name[len] != 0) c = -1; else
770 {
771 unsigned int bit = middle->bit;
772 unsigned int *selector;
773
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.
777 */
778
779 if (bit == 0xffffffff)
780 {
781 if (adding)
782 {
783 *selector1 = 0xffffffff ^ notall1;
784 if (selector2 != NULL) *selector2 = 0x7fffffff ^ notall2;
785 }
786 else
787 {
788 *selector1 = 0;
789 if (selector2 != NULL) *selector2 = 0;
790 }
791 }
792
793 /* Otherwise, the 0x80000000 bit means "this value, without the top
794 bit, belongs in the second selector". */
795
796 else
797 {
798 if ((bit & 0x80000000) != 0)
799 {
800 selector = selector2;
801 bit &= 0x7fffffff;
802 }
803 else selector = selector1;
804 if (adding) *selector |= bit; else *selector &= ~bit;
805 }
806 break; /* Out of loop to match selector name */
807 }
808 }
809 if (c < 0) end = middle; else start = middle + 1;
810 } /* Loop to match selector name */
811
812 if (start >= end)
813 {
814 errmsg = string_sprintf("unknown %s_selector setting: %c%.*s", which,
815 adding? '+' : '-', len, s);
816 goto ERROR_RETURN;
817 }
818 } /* Loop for selector names */
819
820 /* Handle disasters */
821
822 ERROR_RETURN:
823 if (Ustrcmp(which, "debug") == 0)
824 {
825 fprintf(stderr, "exim: %s\n", errmsg);
826 exit(EXIT_FAILURE);
827 }
828 else log_write(0, LOG_CONFIG|LOG_PANIC_DIE, "%s", errmsg);
829 }
830
831
832
833 /*************************************************
834 * Show supported features *
835 *************************************************/
836
837 /* This function is called for -bV and for -d to output the optional features
838 of the current Exim binary.
839
840 Arguments: a FILE for printing
841 Returns: nothing
842 */
843
844 static void
845 show_whats_supported(FILE *f)
846 {
847 #ifdef DB_VERSION_STRING
848 fprintf(f, "Berkeley DB: %s\n", DB_VERSION_STRING);
849 #elif defined(BTREEVERSION) && defined(HASHVERSION)
850 #ifdef USE_DB
851 fprintf(f, "Probably Berkeley DB version 1.8x (native mode)\n");
852 #else
853 fprintf(f, "Probably Berkeley DB version 1.8x (compatibility mode)\n");
854 #endif
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");
859 #else
860 #ifdef USE_GDBM
861 fprintf(f, "Probably GDBM (native mode)\n");
862 #else
863 fprintf(f, "Probably GDBM (compatibility mode)\n");
864 #endif
865 #endif
866
867 fprintf(f, "Support for:");
868 #ifdef SUPPORT_CRYPTEQ
869 fprintf(f, " crypteq");
870 #endif
871 #if HAVE_ICONV
872 fprintf(f, " iconv()");
873 #endif
874 #if HAVE_IPV6
875 fprintf(f, " IPv6");
876 #endif
877 #ifdef HAVE_SETCLASSRESOURCES
878 fprintf(f, " use_setclassresources");
879 #endif
880 #ifdef SUPPORT_PAM
881 fprintf(f, " PAM");
882 #endif
883 #ifdef EXIM_PERL
884 fprintf(f, " Perl");
885 #endif
886 #ifdef EXPAND_DLFUNC
887 fprintf(f, " Expand_dlfunc");
888 #endif
889 #ifdef USE_TCP_WRAPPERS
890 fprintf(f, " TCPwrappers");
891 #endif
892 #ifdef SUPPORT_TLS
893 #ifdef USE_GNUTLS
894 fprintf(f, " GnuTLS");
895 #else
896 fprintf(f, " OpenSSL");
897 #endif
898 #endif
899 #ifdef SUPPORT_TRANSLATE_IP_ADDRESS
900 fprintf(f, " translate_ip_address");
901 #endif
902 #ifdef SUPPORT_MOVE_FROZEN_MESSAGES
903 fprintf(f, " move_frozen_messages");
904 #endif
905 #ifdef WITH_CONTENT_SCAN
906 fprintf(f, " Content_Scanning");
907 #endif
908 #ifdef WITH_OLD_DEMIME
909 fprintf(f, " Old_Demime");
910 #endif
911 #ifdef EXPERIMENTAL_SPF
912 fprintf(f, " Experimental_SPF");
913 #endif
914 #ifdef EXPERIMENTAL_SRS
915 fprintf(f, " Experimental_SRS");
916 #endif
917 #ifdef EXPERIMENTAL_BRIGHTMAIL
918 fprintf(f, " Experimental_Brightmail");
919 #endif
920 #ifdef EXPERIMENTAL_DOMAINKEYS
921 fprintf(f, " Experimental_DomainKeys");
922 #endif
923 fprintf(f, "\n");
924
925 fprintf(f, "Lookups:");
926 #ifdef LOOKUP_LSEARCH
927 fprintf(f, " lsearch wildlsearch nwildlsearch iplsearch");
928 #endif
929 #ifdef LOOKUP_CDB
930 fprintf(f, " cdb");
931 #endif
932 #ifdef LOOKUP_DBM
933 fprintf(f, " dbm dbmnz");
934 #endif
935 #ifdef LOOKUP_DNSDB
936 fprintf(f, " dnsdb");
937 #endif
938 #ifdef LOOKUP_DSEARCH
939 fprintf(f, " dsearch");
940 #endif
941 #ifdef LOOKUP_IBASE
942 fprintf(f, " ibase");
943 #endif
944 #ifdef LOOKUP_LDAP
945 fprintf(f, " ldap ldapdn ldapm");
946 #endif
947 #ifdef LOOKUP_MYSQL
948 fprintf(f, " mysql");
949 #endif
950 #ifdef LOOKUP_NIS
951 fprintf(f, " nis nis0");
952 #endif
953 #ifdef LOOKUP_NISPLUS
954 fprintf(f, " nisplus");
955 #endif
956 #ifdef LOOKUP_ORACLE
957 fprintf(f, " oracle");
958 #endif
959 #ifdef LOOKUP_PASSWD
960 fprintf(f, " passwd");
961 #endif
962 #ifdef LOOKUP_PGSQL
963 fprintf(f, " pgsql");
964 #endif
965 #ifdef LOOKUP_SQLITE
966 fprintf(f, " sqlite");
967 #endif
968 #ifdef LOOKUP_TESTDB
969 fprintf(f, " testdb");
970 #endif
971 #ifdef LOOKUP_WHOSON
972 fprintf(f, " whoson");
973 #endif
974 fprintf(f, "\n");
975
976 fprintf(f, "Authenticators:");
977 #ifdef AUTH_CRAM_MD5
978 fprintf(f, " cram_md5");
979 #endif
980 #ifdef AUTH_CYRUS_SASL
981 fprintf(f, " cyrus_sasl");
982 #endif
983 #ifdef AUTH_DOVECOT
984 fprintf(f, " dovecot");
985 #endif
986 #ifdef AUTH_PLAINTEXT
987 fprintf(f, " plaintext");
988 #endif
989 #ifdef AUTH_SPA
990 fprintf(f, " spa");
991 #endif
992 fprintf(f, "\n");
993
994 fprintf(f, "Routers:");
995 #ifdef ROUTER_ACCEPT
996 fprintf(f, " accept");
997 #endif
998 #ifdef ROUTER_DNSLOOKUP
999 fprintf(f, " dnslookup");
1000 #endif
1001 #ifdef ROUTER_IPLITERAL
1002 fprintf(f, " ipliteral");
1003 #endif
1004 #ifdef ROUTER_IPLOOKUP
1005 fprintf(f, " iplookup");
1006 #endif
1007 #ifdef ROUTER_MANUALROUTE
1008 fprintf(f, " manualroute");
1009 #endif
1010 #ifdef ROUTER_QUERYPROGRAM
1011 fprintf(f, " queryprogram");
1012 #endif
1013 #ifdef ROUTER_REDIRECT
1014 fprintf(f, " redirect");
1015 #endif
1016 fprintf(f, "\n");
1017
1018 fprintf(f, "Transports:");
1019 #ifdef TRANSPORT_APPENDFILE
1020 fprintf(f, " appendfile");
1021 #ifdef SUPPORT_MAILDIR
1022 fprintf(f, "/maildir");
1023 #endif
1024 #ifdef SUPPORT_MAILSTORE
1025 fprintf(f, "/mailstore");
1026 #endif
1027 #ifdef SUPPORT_MBX
1028 fprintf(f, "/mbx");
1029 #endif
1030 #endif
1031 #ifdef TRANSPORT_AUTOREPLY
1032 fprintf(f, " autoreply");
1033 #endif
1034 #ifdef TRANSPORT_LMTP
1035 fprintf(f, " lmtp");
1036 #endif
1037 #ifdef TRANSPORT_PIPE
1038 fprintf(f, " pipe");
1039 #endif
1040 #ifdef TRANSPORT_SMTP
1041 fprintf(f, " smtp");
1042 #endif
1043 fprintf(f, "\n");
1044
1045 if (fixed_never_users[0] > 0)
1046 {
1047 int i;
1048 fprintf(f, "Fixed never_users: ");
1049 for (i = 1; i <= (int)fixed_never_users[0] - 1; i++)
1050 fprintf(f, "%d:", (unsigned int)fixed_never_users[i]);
1051 fprintf(f, "%d\n", (unsigned int)fixed_never_users[i]);
1052 }
1053
1054 fprintf(f, "Size of off_t: %d\n", sizeof(off_t));
1055 }
1056
1057
1058
1059
1060 /*************************************************
1061 * Quote a local part *
1062 *************************************************/
1063
1064 /* This function is used when a sender address or a From: or Sender: header
1065 line is being created from the caller's login, or from an authenticated_id. It
1066 applies appropriate quoting rules for a local part.
1067
1068 Argument: the local part
1069 Returns: the local part, quoted if necessary
1070 */
1071
1072 uschar *
1073 local_part_quote(uschar *lpart)
1074 {
1075 BOOL needs_quote = FALSE;
1076 int size, ptr;
1077 uschar *yield;
1078 uschar *t;
1079
1080 for (t = lpart; !needs_quote && *t != 0; t++)
1081 {
1082 needs_quote = !isalnum(*t) && strchr("!#$%&'*+-/=?^_`{|}~", *t) == NULL &&
1083 (*t != '.' || t == lpart || t[1] == 0);
1084 }
1085
1086 if (!needs_quote) return lpart;
1087
1088 size = ptr = 0;
1089 yield = string_cat(NULL, &size, &ptr, US"\"", 1);
1090
1091 for (;;)
1092 {
1093 uschar *nq = US Ustrpbrk(lpart, "\\\"");
1094 if (nq == NULL)
1095 {
1096 yield = string_cat(yield, &size, &ptr, lpart, Ustrlen(lpart));
1097 break;
1098 }
1099 yield = string_cat(yield, &size, &ptr, lpart, nq - lpart);
1100 yield = string_cat(yield, &size, &ptr, US"\\", 1);
1101 yield = string_cat(yield, &size, &ptr, nq, 1);
1102 lpart = nq + 1;
1103 }
1104
1105 yield = string_cat(yield, &size, &ptr, US"\"", 1);
1106 yield[ptr] = 0;
1107 return yield;
1108 }
1109
1110
1111
1112 #ifdef USE_READLINE
1113 /*************************************************
1114 * Load readline() functions *
1115 *************************************************/
1116
1117 /* This function is called from testing executions that read data from stdin,
1118 but only when running as the calling user. Currently, only -be does this. The
1119 function loads the readline() function library and passes back the functions.
1120 On some systems, it needs the curses library, so load that too, but try without
1121 it if loading fails. All this functionality has to be requested at build time.
1122
1123 Arguments:
1124 fn_readline_ptr pointer to where to put the readline pointer
1125 fn_addhist_ptr pointer to where to put the addhistory function
1126
1127 Returns: the dlopen handle or NULL on failure
1128 */
1129
1130 static void *
1131 set_readline(char * (**fn_readline_ptr)(char *),
1132 char * (**fn_addhist_ptr)(char *))
1133 {
1134 void *dlhandle;
1135 void *dlhandle_curses = dlopen("libcurses.so", RTLD_GLOBAL|RTLD_LAZY);
1136
1137 dlhandle = dlopen("libreadline.so", RTLD_GLOBAL|RTLD_NOW);
1138 if (dlhandle_curses != NULL) dlclose(dlhandle_curses);
1139
1140 if (dlhandle != NULL)
1141 {
1142 *fn_readline_ptr = (char *(*)(char*))dlsym(dlhandle, "readline");
1143 *fn_addhist_ptr = (char *(*)(char*))dlsym(dlhandle, "add_history");
1144 }
1145 else
1146 {
1147 DEBUG(D_any) debug_printf("failed to load readline: %s\n", dlerror());
1148 }
1149
1150 return dlhandle;
1151 }
1152 #endif
1153
1154
1155
1156 /*************************************************
1157 * Get a line from stdin for testing things *
1158 *************************************************/
1159
1160 /* This function is called when running tests that can take a number of lines
1161 of input (for example, -be and -bt). It handles continuations and trailing
1162 spaces. And prompting and a blank line output on eof. If readline() is in use,
1163 the arguments are non-NULL and provide the relevant functions.
1164
1165 Arguments:
1166 fn_readline readline function or NULL
1167 fn_addhist addhist function or NULL
1168
1169 Returns: pointer to dynamic memory, or NULL at end of file
1170 */
1171
1172 static uschar *
1173 get_stdinput(char *(*fn_readline)(char *), char *(*fn_addhist)(char *))
1174 {
1175 int i;
1176 int size = 0;
1177 int ptr = 0;
1178 uschar *yield = NULL;
1179
1180 if (fn_readline == NULL) { printf("> "); fflush(stdout); }
1181
1182 for (i = 0;; i++)
1183 {
1184 uschar buffer[1024];
1185 uschar *p, *ss;
1186
1187 #ifdef USE_READLINE
1188 char *readline_line = NULL;
1189 if (fn_readline != NULL)
1190 {
1191 if ((readline_line = fn_readline((i > 0)? "":"> ")) == NULL) break;
1192 if (*readline_line != 0 && fn_addhist != NULL) fn_addhist(readline_line);
1193 p = US readline_line;
1194 }
1195 else
1196 #endif
1197
1198 /* readline() not in use */
1199
1200 {
1201 if (Ufgets(buffer, sizeof(buffer), stdin) == NULL) break;
1202 p = buffer;
1203 }
1204
1205 /* Handle the line */
1206
1207 ss = p + (int)Ustrlen(p);
1208 while (ss > p && isspace(ss[-1])) ss--;
1209
1210 if (i > 0)
1211 {
1212 while (p < ss && isspace(*p)) p++; /* leading space after cont */
1213 }
1214
1215 yield = string_cat(yield, &size, &ptr, p, ss - p);
1216
1217 #ifdef USE_READLINE
1218 if (fn_readline != NULL) free(readline_line);
1219 #endif
1220
1221 if (ss == p || yield[ptr-1] != '\\')
1222 {
1223 yield[ptr] = 0;
1224 break;
1225 }
1226 yield[--ptr] = 0;
1227 }
1228
1229 if (yield == NULL) printf("\n");
1230 return yield;
1231 }
1232
1233
1234
1235 /*************************************************
1236 * Entry point and high-level code *
1237 *************************************************/
1238
1239 /* Entry point for the Exim mailer. Analyse the arguments and arrange to take
1240 the appropriate action. All the necessary functions are present in the one
1241 binary. I originally thought one should split it up, but it turns out that so
1242 much of the apparatus is needed in each chunk that one might as well just have
1243 it all available all the time, which then makes the coding easier as well.
1244
1245 Arguments:
1246 argc count of entries in argv
1247 argv argument strings, with argv[0] being the program name
1248
1249 Returns: EXIT_SUCCESS if terminated successfully
1250 EXIT_FAILURE otherwise, except when a message has been sent
1251 to the sender, and -oee was given
1252 */
1253
1254 int
1255 main(int argc, char **cargv)
1256 {
1257 uschar **argv = USS cargv;
1258 int arg_receive_timeout = -1;
1259 int arg_smtp_receive_timeout = -1;
1260 int arg_error_handling = error_handling;
1261 int filter_sfd = -1;
1262 int filter_ufd = -1;
1263 int group_count;
1264 int i;
1265 int list_queue_option = 0;
1266 int msg_action = 0;
1267 int msg_action_arg = -1;
1268 int namelen = (argv[0] == NULL)? 0 : Ustrlen(argv[0]);
1269 int queue_only_reason = 0;
1270 #ifdef EXIM_PERL
1271 int perl_start_option = 0;
1272 #endif
1273 int recipients_arg = argc;
1274 int sender_address_domain = 0;
1275 int test_retry_arg = -1;
1276 int test_rewrite_arg = -1;
1277 BOOL arg_queue_only = FALSE;
1278 BOOL bi_option = FALSE;
1279 BOOL checking = FALSE;
1280 BOOL count_queue = FALSE;
1281 BOOL expansion_test = FALSE;
1282 BOOL extract_recipients = FALSE;
1283 BOOL forced_delivery = FALSE;
1284 BOOL f_end_dot = FALSE;
1285 BOOL deliver_give_up = FALSE;
1286 BOOL list_queue = FALSE;
1287 BOOL list_options = FALSE;
1288 BOOL local_queue_only;
1289 BOOL more = TRUE;
1290 BOOL one_msg_action = FALSE;
1291 BOOL queue_only_set = FALSE;
1292 BOOL receiving_message = TRUE;
1293 BOOL sender_ident_set = FALSE;
1294 BOOL unprivileged;
1295 BOOL removed_privilege = FALSE;
1296 BOOL verify_address_mode = FALSE;
1297 BOOL verify_as_sender = FALSE;
1298 BOOL version_printed = FALSE;
1299 uschar *alias_arg = NULL;
1300 uschar *called_as = US"";
1301 uschar *start_queue_run_id = NULL;
1302 uschar *stop_queue_run_id = NULL;
1303 uschar *expansion_test_message = NULL;
1304 uschar *ftest_domain = NULL;
1305 uschar *ftest_localpart = NULL;
1306 uschar *ftest_prefix = NULL;
1307 uschar *ftest_suffix = NULL;
1308 uschar *real_sender_address;
1309 uschar *originator_home = US"/";
1310 void *reset_point;
1311
1312 struct passwd *pw;
1313 struct stat statbuf;
1314 pid_t passed_qr_pid = (pid_t)0;
1315 int passed_qr_pipe = -1;
1316 gid_t group_list[NGROUPS_MAX];
1317
1318 /* Possible options for -R and -S */
1319
1320 static uschar *rsopts[] = { US"f", US"ff", US"r", US"rf", US"rff" };
1321
1322 /* Need to define this in case we need to change the environment in order
1323 to get rid of a bogus time zone. We have to make it char rather than uschar
1324 because some OS define it in /usr/include/unistd.h. */
1325
1326 extern char **environ;
1327
1328 /* If the Exim user and/or group and/or the configuration file owner/group were
1329 defined by ref:name at build time, we must now find the actual uid/gid values.
1330 This is a feature to make the lives of binary distributors easier. */
1331
1332 #ifdef EXIM_USERNAME
1333 if (route_finduser(US EXIM_USERNAME, &pw, &exim_uid))
1334 {
1335 exim_gid = pw->pw_gid;
1336 }
1337 else
1338 {
1339 fprintf(stderr, "exim: failed to find uid for user name \"%s\"\n",
1340 EXIM_USERNAME);
1341 exit(EXIT_FAILURE);
1342 }
1343 #endif
1344
1345 #ifdef EXIM_GROUPNAME
1346 if (!route_findgroup(US EXIM_GROUPNAME, &exim_gid))
1347 {
1348 fprintf(stderr, "exim: failed to find gid for group name \"%s\"\n",
1349 EXIM_GROUPNAME);
1350 exit(EXIT_FAILURE);
1351 }
1352 #endif
1353
1354 #ifdef CONFIGURE_OWNERNAME
1355 if (!route_finduser(US CONFIGURE_OWNERNAME, NULL, &config_uid))
1356 {
1357 fprintf(stderr, "exim: failed to find uid for user name \"%s\"\n",
1358 CONFIGURE_OWNERNAME);
1359 exit(EXIT_FAILURE);
1360 }
1361 #endif
1362
1363 #ifdef CONFIGURE_GROUPNAME
1364 if (!route_findgroup(US CONFIGURE_GROUPNAME, &config_gid))
1365 {
1366 fprintf(stderr, "exim: failed to find gid for group name \"%s\"\n",
1367 CONFIGURE_GROUPNAME);
1368 exit(EXIT_FAILURE);
1369 }
1370 #endif
1371
1372 /* In the Cygwin environment, some initialization needs doing. It is fudged
1373 in by means of this macro. */
1374
1375 #ifdef OS_INIT
1376 OS_INIT
1377 #endif
1378
1379 /* Check a field which is patched when we are running Exim within its
1380 testing harness; do a fast initial check, and then the whole thing. */
1381
1382 running_in_test_harness =
1383 *running_status == '<' && Ustrcmp(running_status, "<<<testing>>>") == 0;
1384
1385 /* The C standard says that the equivalent of setlocale(LC_ALL, "C") is obeyed
1386 at the start of a program; however, it seems that some environments do not
1387 follow this. A "strange" locale can affect the formatting of timestamps, so we
1388 make quite sure. */
1389
1390 setlocale(LC_ALL, "C");
1391
1392 /* Set up the default handler for timing using alarm(). */
1393
1394 os_non_restarting_signal(SIGALRM, sigalrm_handler);
1395
1396 /* Ensure we have a buffer for constructing log entries. Use malloc directly,
1397 because store_malloc writes a log entry on failure. */
1398
1399 log_buffer = (uschar *)malloc(LOG_BUFFER_SIZE);
1400 if (log_buffer == NULL)
1401 {
1402 fprintf(stderr, "exim: failed to get store for log buffer\n");
1403 exit(EXIT_FAILURE);
1404 }
1405
1406 /* Set log_stderr to stderr, provided that stderr exists. This gets reset to
1407 NULL when the daemon is run and the file is closed. We have to use this
1408 indirection, because some systems don't allow writing to the variable "stderr".
1409 */
1410
1411 if (fstat(fileno(stderr), &statbuf) >= 0) log_stderr = stderr;
1412
1413 /* Arrange for the PCRE regex library to use our store functions. Note that
1414 the normal calls are actually macros that add additional arguments for
1415 debugging purposes so we have to assign specially constructed functions here.
1416 The default is to use store in the stacking pool, but this is overridden in the
1417 regex_must_compile() function. */
1418
1419 pcre_malloc = function_store_get;
1420 pcre_free = function_dummy_free;
1421
1422 /* Ensure there is a big buffer for temporary use in several places. It is put
1423 in malloc store so that it can be freed for enlargement if necessary. */
1424
1425 big_buffer = store_malloc(big_buffer_size);
1426
1427 /* Set up the handler for the data request signal, and set the initial
1428 descriptive text. */
1429
1430 set_process_info("initializing");
1431 os_restarting_signal(SIGUSR1, usr1_handler);
1432
1433 /* SIGHUP is used to get the daemon to reconfigure. It gets set as appropriate
1434 in the daemon code. For the rest of Exim's uses, we ignore it. */
1435
1436 signal(SIGHUP, SIG_IGN);
1437
1438 /* We don't want to die on pipe errors as the code is written to handle
1439 the write error instead. */
1440
1441 signal(SIGPIPE, SIG_IGN);
1442
1443 /* Under some circumstance on some OS, Exim can get called with SIGCHLD
1444 set to SIG_IGN. This causes subprocesses that complete before the parent
1445 process waits for them not to hang around, so when Exim calls wait(), nothing
1446 is there. The wait() code has been made robust against this, but let's ensure
1447 that SIGCHLD is set to SIG_DFL, because it's tidier to wait and get a process
1448 ending status. We use sigaction rather than plain signal() on those OS where
1449 SA_NOCLDWAIT exists, because we want to be sure it is turned off. (There was a
1450 problem on AIX with this.) */
1451
1452 #ifdef SA_NOCLDWAIT
1453 {
1454 struct sigaction act;
1455 act.sa_handler = SIG_DFL;
1456 sigemptyset(&(act.sa_mask));
1457 act.sa_flags = 0;
1458 sigaction(SIGCHLD, &act, NULL);
1459 }
1460 #else
1461 signal(SIGCHLD, SIG_DFL);
1462 #endif
1463
1464 /* Save the arguments for use if we re-exec exim as a daemon after receiving
1465 SIGHUP. */
1466
1467 sighup_argv = argv;
1468
1469 /* Set up the version number. Set up the leading 'E' for the external form of
1470 message ids, set the pointer to the internal form, and initialize it to
1471 indicate no message being processed. */
1472
1473 version_init();
1474 message_id_option[0] = '-';
1475 message_id_external = message_id_option + 1;
1476 message_id_external[0] = 'E';
1477 message_id = message_id_external + 1;
1478 message_id[0] = 0;
1479
1480 /* Set the umask to zero so that any files Exim creates using open() are
1481 created with the modes that it specifies. NOTE: Files created with fopen() have
1482 a problem, which was not recognized till rather late (February 2006). With this
1483 umask, such files will be world writeable. (They are all content scanning files
1484 in the spool directory, which isn't world-accessible, so this is not a
1485 disaster, but it's untidy.) I don't want to change this overall setting,
1486 however, because it will interact badly with the open() calls. Instead, there's
1487 now a function called modefopen() that fiddles with the umask while calling
1488 fopen(). */
1489
1490 (void)umask(0);
1491
1492 /* Precompile the regular expression for matching a message id. Keep this in
1493 step with the code that generates ids in the accept.c module. We need to do
1494 this here, because the -M options check their arguments for syntactic validity
1495 using mac_ismsgid, which uses this. */
1496
1497 regex_ismsgid =
1498 regex_must_compile(US"^(?:[^\\W_]{6}-){2}[^\\W_]{2}$", FALSE, TRUE);
1499
1500 /* Precompile the regular expression that is used for matching an SMTP error
1501 code, possibly extended, at the start of an error message. */
1502
1503 regex_smtp_code =
1504 regex_must_compile(US"^\\d\\d\\d\\s(?:\\d\\.\\d\\d?\\d?\\.\\d\\d?\\d?\\s)?",
1505 FALSE, TRUE);
1506
1507 /* If the program is called as "mailq" treat it as equivalent to "exim -bp";
1508 this seems to be a generally accepted convention, since one finds symbolic
1509 links called "mailq" in standard OS configurations. */
1510
1511 if ((namelen == 5 && Ustrcmp(argv[0], "mailq") == 0) ||
1512 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/mailq", 6) == 0))
1513 {
1514 list_queue = TRUE;
1515 receiving_message = FALSE;
1516 called_as = US"-mailq";
1517 }
1518
1519 /* If the program is called as "rmail" treat it as equivalent to
1520 "exim -i -oee", thus allowing UUCP messages to be input using non-SMTP mode,
1521 i.e. preventing a single dot on a line from terminating the message, and
1522 returning with zero return code, even in cases of error (provided an error
1523 message has been sent). */
1524
1525 if ((namelen == 5 && Ustrcmp(argv[0], "rmail") == 0) ||
1526 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/rmail", 6) == 0))
1527 {
1528 dot_ends = FALSE;
1529 called_as = US"-rmail";
1530 errors_sender_rc = EXIT_SUCCESS;
1531 }
1532
1533 /* If the program is called as "rsmtp" treat it as equivalent to "exim -bS";
1534 this is a smail convention. */
1535
1536 if ((namelen == 5 && Ustrcmp(argv[0], "rsmtp") == 0) ||
1537 (namelen > 5 && Ustrncmp(argv[0] + namelen - 6, "/rsmtp", 6) == 0))
1538 {
1539 smtp_input = smtp_batched_input = TRUE;
1540 called_as = US"-rsmtp";
1541 }
1542
1543 /* If the program is called as "runq" treat it as equivalent to "exim -q";
1544 this is a smail convention. */
1545
1546 if ((namelen == 4 && Ustrcmp(argv[0], "runq") == 0) ||
1547 (namelen > 4 && Ustrncmp(argv[0] + namelen - 5, "/runq", 5) == 0))
1548 {
1549 queue_interval = 0;
1550 receiving_message = FALSE;
1551 called_as = US"-runq";
1552 }
1553
1554 /* If the program is called as "newaliases" treat it as equivalent to
1555 "exim -bi"; this is a sendmail convention. */
1556
1557 if ((namelen == 10 && Ustrcmp(argv[0], "newaliases") == 0) ||
1558 (namelen > 10 && Ustrncmp(argv[0] + namelen - 11, "/newaliases", 11) == 0))
1559 {
1560 bi_option = TRUE;
1561 receiving_message = FALSE;
1562 called_as = US"-newaliases";
1563 }
1564
1565 /* Save the original effective uid for a couple of uses later. It should
1566 normally be root, but in some esoteric environments it may not be. */
1567
1568 original_euid = geteuid();
1569
1570 /* Get the real uid and gid. If the caller is root, force the effective uid/gid
1571 to be the same as the real ones. This makes a difference only if Exim is setuid
1572 (or setgid) to something other than root, which could be the case in some
1573 special configurations. */
1574
1575 real_uid = getuid();
1576 real_gid = getgid();
1577
1578 if (real_uid == root_uid)
1579 {
1580 setgid(real_gid);
1581 setuid(real_uid);
1582 }
1583
1584 /* If neither the original real uid nor the original euid was root, Exim is
1585 running in an unprivileged state. */
1586
1587 unprivileged = (real_uid != root_uid && original_euid != root_uid);
1588
1589 /* If the first argument is --help, pretend there are no arguments. This will
1590 cause a brief message to be given. */
1591
1592 if (argc > 1 && Ustrcmp(argv[1], "--help") == 0) argc = 1;
1593
1594 /* Scan the program's arguments. Some can be dealt with right away; others are
1595 simply recorded for checking and handling afterwards. Do a high-level switch
1596 on the second character (the one after '-'), to save some effort. */
1597
1598 for (i = 1; i < argc; i++)
1599 {
1600 BOOL badarg = FALSE;
1601 uschar *arg = argv[i];
1602 uschar *argrest;
1603 int switchchar;
1604
1605 /* An argument not starting with '-' is the start of a recipients list;
1606 break out of the options-scanning loop. */
1607
1608 if (arg[0] != '-')
1609 {
1610 recipients_arg = i;
1611 break;
1612 }
1613
1614 /* An option consistion of -- terminates the options */
1615
1616 if (Ustrcmp(arg, "--") == 0)
1617 {
1618 recipients_arg = i + 1;
1619 break;
1620 }
1621
1622 /* Handle flagged options */
1623
1624 switchchar = arg[1];
1625 argrest = arg+2;
1626
1627 /* Make all -ex options synonymous with -oex arguments, since that
1628 is assumed by various callers. Also make -qR options synonymous with -R
1629 options, as that seems to be required as well. Allow for -qqR too, and
1630 the same for -S options. */
1631
1632 if (Ustrncmp(arg+1, "oe", 2) == 0 ||
1633 Ustrncmp(arg+1, "qR", 2) == 0 ||
1634 Ustrncmp(arg+1, "qS", 2) == 0)
1635 {
1636 switchchar = arg[2];
1637 argrest++;
1638 }
1639 else if (Ustrncmp(arg+1, "qqR", 3) == 0 || Ustrncmp(arg+1, "qqS", 3) == 0)
1640 {
1641 switchchar = arg[3];
1642 argrest += 2;
1643 queue_2stage = TRUE;
1644 }
1645
1646 /* Make -r synonymous with -f, since it is a documented alias */
1647
1648 else if (arg[1] == 'r') switchchar = 'f';
1649
1650 /* Make -ov synonymous with -v */
1651
1652 else if (Ustrcmp(arg, "-ov") == 0)
1653 {
1654 switchchar = 'v';
1655 argrest++;
1656 }
1657
1658 /* High-level switch on active initial letter */
1659
1660 switch(switchchar)
1661 {
1662 /* -Btype is a sendmail option for 7bit/8bit setting. Exim is 8-bit clean
1663 so has no need of it. */
1664
1665 case 'B':
1666 if (*argrest == 0) i++; /* Skip over the type */
1667 break;
1668
1669
1670 case 'b':
1671 receiving_message = FALSE; /* Reset TRUE for -bm, -bS, -bs below */
1672
1673 /* -bd: Run in daemon mode, awaiting SMTP connections.
1674 -bdf: Ditto, but in the foreground.
1675 */
1676
1677 if (*argrest == 'd')
1678 {
1679 daemon_listen = TRUE;
1680 if (*(++argrest) == 'f') background_daemon = FALSE;
1681 else if (*argrest != 0) { badarg = TRUE; break; }
1682 }
1683
1684 /* -be: Run in expansion test mode
1685 -bem: Ditto, but read a message from a file first
1686 */
1687
1688 else if (*argrest == 'e')
1689 {
1690 expansion_test = checking = TRUE;
1691 if (argrest[1] == 'm')
1692 {
1693 if (++i >= argc) { badarg = TRUE; break; }
1694 expansion_test_message = argv[i];
1695 argrest++;
1696 }
1697 if (argrest[1] != 0) { badarg = TRUE; break; }
1698 }
1699
1700 /* -bF: Run system filter test */
1701
1702 else if (*argrest == 'F')
1703 {
1704 filter_test |= FTEST_SYSTEM;
1705 if (*(++argrest) != 0) { badarg = TRUE; break; }
1706 if (++i < argc) filter_test_sfile = argv[i]; else
1707 {
1708 fprintf(stderr, "exim: file name expected after %s\n", argv[i-1]);
1709 exit(EXIT_FAILURE);
1710 }
1711 }
1712
1713 /* -bf: Run user filter test
1714 -bfd: Set domain for filter testing
1715 -bfl: Set local part for filter testing
1716 -bfp: Set prefix for filter testing
1717 -bfs: Set suffix for filter testing
1718 */
1719
1720 else if (*argrest == 'f')
1721 {
1722 if (*(++argrest) == 0)
1723 {
1724 filter_test |= FTEST_USER;
1725 if (++i < argc) filter_test_ufile = argv[i]; else
1726 {
1727 fprintf(stderr, "exim: file name expected after %s\n", argv[i-1]);
1728 exit(EXIT_FAILURE);
1729 }
1730 }
1731 else
1732 {
1733 if (++i >= argc)
1734 {
1735 fprintf(stderr, "exim: string expected after %s\n", arg);
1736 exit(EXIT_FAILURE);
1737 }
1738 if (Ustrcmp(argrest, "d") == 0) ftest_domain = argv[i];
1739 else if (Ustrcmp(argrest, "l") == 0) ftest_localpart = argv[i];
1740 else if (Ustrcmp(argrest, "p") == 0) ftest_prefix = argv[i];
1741 else if (Ustrcmp(argrest, "s") == 0) ftest_suffix = argv[i];
1742 else { badarg = TRUE; break; }
1743 }
1744 }
1745
1746 /* -bh: Host checking - an IP address must follow. */
1747
1748 else if (Ustrcmp(argrest, "h") == 0 || Ustrcmp(argrest, "hc") == 0)
1749 {
1750 if (++i >= argc) { badarg = TRUE; break; }
1751 sender_host_address = argv[i];
1752 host_checking = checking = log_testing_mode = TRUE;
1753 host_checking_callout = argrest[1] == 'c';
1754 }
1755
1756 /* -bi: This option is used by sendmail to initialize *the* alias file,
1757 though it has the -oA option to specify a different file. Exim has no
1758 concept of *the* alias file, but since Sun's YP make script calls
1759 sendmail this way, some support must be provided. */
1760
1761 else if (Ustrcmp(argrest, "i") == 0) bi_option = TRUE;
1762
1763 /* -bm: Accept and deliver message - the default option. Reinstate
1764 receiving_message, which got turned off for all -b options. */
1765
1766 else if (Ustrcmp(argrest, "m") == 0) receiving_message = TRUE;
1767
1768 /* -bnq: For locally originating messages, do not qualify unqualified
1769 addresses. In the envelope, this causes errors; in header lines they
1770 just get left. */
1771
1772 else if (Ustrcmp(argrest, "nq") == 0)
1773 {
1774 allow_unqualified_sender = FALSE;
1775 allow_unqualified_recipient = FALSE;
1776 }
1777
1778 /* -bpxx: List the contents of the mail queue, in various forms. If
1779 the option is -bpc, just a queue count is needed. Otherwise, if the
1780 first letter after p is r, then order is random. */
1781
1782 else if (*argrest == 'p')
1783 {
1784 if (*(++argrest) == 'c')
1785 {
1786 count_queue = TRUE;
1787 if (*(++argrest) != 0) badarg = TRUE;
1788 break;
1789 }
1790
1791 if (*argrest == 'r')
1792 {
1793 list_queue_option = 8;
1794 argrest++;
1795 }
1796 else list_queue_option = 0;
1797
1798 list_queue = TRUE;
1799
1800 /* -bp: List the contents of the mail queue, top-level only */
1801
1802 if (*argrest == 0) {}
1803
1804 /* -bpu: List the contents of the mail queue, top-level undelivered */
1805
1806 else if (Ustrcmp(argrest, "u") == 0) list_queue_option += 1;
1807
1808 /* -bpa: List the contents of the mail queue, including all delivered */
1809
1810 else if (Ustrcmp(argrest, "a") == 0) list_queue_option += 2;
1811
1812 /* Unknown after -bp[r] */
1813
1814 else
1815 {
1816 badarg = TRUE;
1817 break;
1818 }
1819 }
1820
1821
1822 /* -bP: List the configuration variables given as the address list.
1823 Force -v, so configuration errors get displayed. */
1824
1825 else if (Ustrcmp(argrest, "P") == 0)
1826 {
1827 list_options = TRUE;
1828 debug_selector |= D_v;
1829 debug_file = stderr;
1830 }
1831
1832 /* -brt: Test retry configuration lookup */
1833
1834 else if (Ustrcmp(argrest, "rt") == 0)
1835 {
1836 test_retry_arg = i + 1;
1837 goto END_ARG;
1838 }
1839
1840 /* -brw: Test rewrite configuration */
1841
1842 else if (Ustrcmp(argrest, "rw") == 0)
1843 {
1844 test_rewrite_arg = i + 1;
1845 goto END_ARG;
1846 }
1847
1848 /* -bS: Read SMTP commands on standard input, but produce no replies -
1849 all errors are reported by sending messages. */
1850
1851 else if (Ustrcmp(argrest, "S") == 0)
1852 smtp_input = smtp_batched_input = receiving_message = TRUE;
1853
1854 /* -bs: Read SMTP commands on standard input and produce SMTP replies
1855 on standard output. */
1856
1857 else if (Ustrcmp(argrest, "s") == 0) smtp_input = receiving_message = TRUE;
1858
1859 /* -bt: address testing mode */
1860
1861 else if (Ustrcmp(argrest, "t") == 0)
1862 address_test_mode = checking = log_testing_mode = TRUE;
1863
1864 /* -bv: verify addresses */
1865
1866 else if (Ustrcmp(argrest, "v") == 0)
1867 verify_address_mode = checking = log_testing_mode = TRUE;
1868
1869 /* -bvs: verify sender addresses */
1870
1871 else if (Ustrcmp(argrest, "vs") == 0)
1872 {
1873 verify_address_mode = checking = log_testing_mode = TRUE;
1874 verify_as_sender = TRUE;
1875 }
1876
1877 /* -bV: Print version string and support details */
1878
1879 else if (Ustrcmp(argrest, "V") == 0)
1880 {
1881 printf("Exim version %s #%s built %s\n", version_string,
1882 version_cnumber, version_date);
1883 printf("%s\n", CS version_copyright);
1884 version_printed = TRUE;
1885 show_whats_supported(stdout);
1886 }
1887
1888 else badarg = TRUE;
1889 break;
1890
1891
1892 /* -C: change configuration file list; ignore if it isn't really
1893 a change! Enforce a prefix check if required. */
1894
1895 case 'C':
1896 if (*argrest == 0)
1897 {
1898 if(++i < argc) argrest = argv[i]; else
1899 { badarg = TRUE; break; }
1900 }
1901 if (Ustrcmp(config_main_filelist, argrest) != 0)
1902 {
1903 #ifdef ALT_CONFIG_PREFIX
1904 int sep = 0;
1905 int len = Ustrlen(ALT_CONFIG_PREFIX);
1906 uschar *list = argrest;
1907 uschar *filename;
1908 while((filename = string_nextinlist(&list, &sep, big_buffer,
1909 big_buffer_size)) != NULL)
1910 {
1911 if ((Ustrlen(filename) < len ||
1912 Ustrncmp(filename, ALT_CONFIG_PREFIX, len) != 0 ||
1913 Ustrstr(filename, "/../") != NULL) &&
1914 (Ustrcmp(filename, "/dev/null") != 0 || real_uid != root_uid))
1915 {
1916 fprintf(stderr, "-C Permission denied\n");
1917 exit(EXIT_FAILURE);
1918 }
1919 }
1920 #endif
1921
1922 config_main_filelist = argrest;
1923 config_changed = TRUE;
1924 }
1925 break;
1926
1927
1928 /* -D: set up a macro definition */
1929
1930 case 'D':
1931 #ifdef DISABLE_D_OPTION
1932 fprintf(stderr, "exim: -D is not available in this Exim binary\n");
1933 exit(EXIT_FAILURE);
1934 #else
1935 {
1936 int ptr = 0;
1937 macro_item *mlast = NULL;
1938 macro_item *m;
1939 uschar name[24];
1940 uschar *s = argrest;
1941
1942 while (isspace(*s)) s++;
1943
1944 if (*s < 'A' || *s > 'Z')
1945 {
1946 fprintf(stderr, "exim: macro name set by -D must start with "
1947 "an upper case letter\n");
1948 exit(EXIT_FAILURE);
1949 }
1950
1951 while (isalnum(*s) || *s == '_')
1952 {
1953 if (ptr < sizeof(name)-1) name[ptr++] = *s;
1954 s++;
1955 }
1956 name[ptr] = 0;
1957 if (ptr == 0) { badarg = TRUE; break; }
1958 while (isspace(*s)) s++;
1959 if (*s != 0)
1960 {
1961 if (*s++ != '=') { badarg = TRUE; break; }
1962 while (isspace(*s)) s++;
1963 }
1964
1965 for (m = macros; m != NULL; m = m->next)
1966 {
1967 if (Ustrcmp(m->name, name) == 0)
1968 {
1969 fprintf(stderr, "exim: duplicated -D in command line\n");
1970 exit(EXIT_FAILURE);
1971 }
1972 mlast = m;
1973 }
1974
1975 m = store_get(sizeof(macro_item) + Ustrlen(name));
1976 m->next = NULL;
1977 m->command_line = TRUE;
1978 if (mlast == NULL) macros = m; else mlast->next = m;
1979 Ustrcpy(m->name, name);
1980 m->replacement = string_copy(s);
1981
1982 if (clmacro_count >= MAX_CLMACROS)
1983 {
1984 fprintf(stderr, "exim: too many -D options on command line\n");
1985 exit(EXIT_FAILURE);
1986 }
1987 clmacros[clmacro_count++] = string_sprintf("-D%s=%s", m->name,
1988 m->replacement);
1989 }
1990 #endif
1991 break;
1992
1993 /* -d: Set debug level (see also -v below) or set the drop_cr option.
1994 The latter is now a no-op, retained for compatibility only. If -dd is used,
1995 debugging subprocesses of the daemon is disabled. */
1996
1997 case 'd':
1998 if (Ustrcmp(argrest, "ropcr") == 0)
1999 {
2000 /* drop_cr = TRUE; */
2001 }
2002
2003 /* Use an intermediate variable so that we don't set debugging while
2004 decoding the debugging bits. */
2005
2006 else
2007 {
2008 unsigned int selector = D_default;
2009 debug_selector = 0;
2010 debug_file = NULL;
2011 if (*argrest == 'd')
2012 {
2013 debug_daemon = TRUE;
2014 argrest++;
2015 }
2016 if (*argrest != 0)
2017 decode_bits(&selector, NULL, D_memory, 0, argrest, debug_options,
2018 debug_options_count, US"debug");
2019 debug_selector = selector;
2020 }
2021 break;
2022
2023
2024 /* -E: This is a local error message. This option is not intended for
2025 external use at all, but is not restricted to trusted callers because it
2026 does no harm (just suppresses certain error messages) and if Exim is run
2027 not setuid root it won't always be trusted when it generates error
2028 messages using this option. If there is a message id following -E, point
2029 message_reference at it, for logging. */
2030
2031 case 'E':
2032 local_error_message = TRUE;
2033 if (mac_ismsgid(argrest)) message_reference = argrest;
2034 break;
2035
2036
2037 /* -ex: The vacation program calls sendmail with the undocumented "-eq"
2038 option, so it looks as if historically the -oex options are also callable
2039 without the leading -o. So we have to accept them. Before the switch,
2040 anything starting -oe has been converted to -e. Exim does not support all
2041 of the sendmail error options. */
2042
2043 case 'e':
2044 if (Ustrcmp(argrest, "e") == 0)
2045 {
2046 arg_error_handling = ERRORS_SENDER;
2047 errors_sender_rc = EXIT_SUCCESS;
2048 }
2049 else if (Ustrcmp(argrest, "m") == 0) arg_error_handling = ERRORS_SENDER;
2050 else if (Ustrcmp(argrest, "p") == 0) arg_error_handling = ERRORS_STDERR;
2051 else if (Ustrcmp(argrest, "q") == 0) arg_error_handling = ERRORS_STDERR;
2052 else if (Ustrcmp(argrest, "w") == 0) arg_error_handling = ERRORS_SENDER;
2053 else badarg = TRUE;
2054 break;
2055
2056
2057 /* -F: Set sender's full name, used instead of the gecos entry from
2058 the password file. Since users can usually alter their gecos entries,
2059 there's no security involved in using this instead. The data can follow
2060 the -F or be in the next argument. */
2061
2062 case 'F':
2063 if (*argrest == 0)
2064 {
2065 if(++i < argc) argrest = argv[i]; else
2066 { badarg = TRUE; break; }
2067 }
2068 originator_name = argrest;
2069 sender_name_forced = TRUE;
2070 break;
2071
2072
2073 /* -f: Set sender's address - this value is only actually used if Exim is
2074 run by a trusted user, or if untrusted_set_sender is set and matches the
2075 address, except that the null address can always be set by any user. The
2076 test for this happens later, when the value given here is ignored when not
2077 permitted. For an untrusted user, the actual sender is still put in Sender:
2078 if it doesn't match the From: header (unless no_local_from_check is set).
2079 The data can follow the -f or be in the next argument. The -r switch is an
2080 obsolete form of -f but since there appear to be programs out there that
2081 use anything that sendmail has ever supported, better accept it - the
2082 synonymizing is done before the switch above.
2083
2084 At this stage, we must allow domain literal addresses, because we don't
2085 know what the setting of allow_domain_literals is yet. Ditto for trailing
2086 dots and strip_trailing_dot. */
2087
2088 case 'f':
2089 {
2090 int start, end;
2091 uschar *errmess;
2092 if (*argrest == 0)
2093 {
2094 if (i+1 < argc) argrest = argv[++i]; else
2095 { badarg = TRUE; break; }
2096 }
2097 if (*argrest == 0)
2098 {
2099 sender_address = string_sprintf(""); /* Ensure writeable memory */
2100 }
2101 else
2102 {
2103 uschar *temp = argrest + Ustrlen(argrest) - 1;
2104 while (temp >= argrest && isspace(*temp)) temp--;
2105 if (temp >= argrest && *temp == '.') f_end_dot = TRUE;
2106 allow_domain_literals = TRUE;
2107 strip_trailing_dot = TRUE;
2108 sender_address = parse_extract_address(argrest, &errmess, &start, &end,
2109 &sender_address_domain, TRUE);
2110 allow_domain_literals = FALSE;
2111 strip_trailing_dot = FALSE;
2112 if (sender_address == NULL)
2113 {
2114 fprintf(stderr, "exim: bad -f address \"%s\": %s\n", argrest, errmess);
2115 return EXIT_FAILURE;
2116 }
2117 }
2118 sender_address_forced = TRUE;
2119 }
2120 break;
2121
2122 /* This is some Sendmail thing which can be ignored */
2123
2124 case 'G':
2125 break;
2126
2127 /* -h: Set the hop count for an incoming message. Exim does not currently
2128 support this; it always computes it by counting the Received: headers.
2129 To put it in will require a change to the spool header file format. */
2130
2131 case 'h':
2132 if (*argrest == 0)
2133 {
2134 if(++i < argc) argrest = argv[i]; else
2135 { badarg = TRUE; break; }
2136 }
2137 if (!isdigit(*argrest)) badarg = TRUE;
2138 break;
2139
2140
2141 /* -i: Set flag so dot doesn't end non-SMTP input (same as -oi, seems
2142 not to be documented for sendmail but mailx (at least) uses it) */
2143
2144 case 'i':
2145 if (*argrest == 0) dot_ends = FALSE; else badarg = TRUE;
2146 break;
2147
2148
2149 case 'M':
2150 receiving_message = FALSE;
2151
2152 /* -MC: continue delivery of another message via an existing open
2153 file descriptor. This option is used for an internal call by the
2154 smtp transport when there is a pending message waiting to go to an
2155 address to which it has got a connection. Five subsequent arguments are
2156 required: transport name, host name, IP address, sequence number, and
2157 message_id. Transports may decline to create new processes if the sequence
2158 number gets too big. The channel is stdin. This (-MC) must be the last
2159 argument. There's a subsequent check that the real-uid is privileged.
2160
2161 If we are running in the test harness. delay for a bit, to let the process
2162 that set this one up complete. This makes for repeatability of the logging,
2163 etc. output. */
2164
2165 if (Ustrcmp(argrest, "C") == 0)
2166 {
2167 if (argc != i + 6)
2168 {
2169 fprintf(stderr, "exim: too many or too few arguments after -MC\n");
2170 return EXIT_FAILURE;
2171 }
2172
2173 if (msg_action_arg >= 0)
2174 {
2175 fprintf(stderr, "exim: incompatible arguments\n");
2176 return EXIT_FAILURE;
2177 }
2178
2179 continue_transport = argv[++i];
2180 continue_hostname = argv[++i];
2181 continue_host_address = argv[++i];
2182 continue_sequence = Uatoi(argv[++i]);
2183 msg_action = MSG_DELIVER;
2184 msg_action_arg = ++i;
2185 forced_delivery = TRUE;
2186 queue_run_pid = passed_qr_pid;
2187 queue_run_pipe = passed_qr_pipe;
2188
2189 if (!mac_ismsgid(argv[i]))
2190 {
2191 fprintf(stderr, "exim: malformed message id %s after -MC option\n",
2192 argv[i]);
2193 return EXIT_FAILURE;
2194 }
2195
2196 if (running_in_test_harness) millisleep(500);
2197 break;
2198 }
2199
2200 /* -MCA: set the smtp_authenticated flag; this is useful only when it
2201 precedes -MC (see above). The flag indicates that the host to which
2202 Exim is connected has accepted an AUTH sequence. */
2203
2204 else if (Ustrcmp(argrest, "CA") == 0)
2205 {
2206 smtp_authenticated = TRUE;
2207 break;
2208 }
2209
2210 /* -MCP: set the smtp_use_pipelining flag; this is useful only when
2211 it preceded -MC (see above) */
2212
2213 else if (Ustrcmp(argrest, "CP") == 0)
2214 {
2215 smtp_use_pipelining = TRUE;
2216 break;
2217 }
2218
2219 /* -MCQ: pass on the pid of the queue-running process that started
2220 this chain of deliveries and the fd of its synchronizing pipe; this
2221 is useful only when it precedes -MC (see above) */
2222
2223 else if (Ustrcmp(argrest, "CQ") == 0)
2224 {
2225 if(++i < argc) passed_qr_pid = (pid_t)(Uatol(argv[i]));
2226 else badarg = TRUE;
2227 if(++i < argc) passed_qr_pipe = (int)(Uatol(argv[i]));
2228 else badarg = TRUE;
2229 break;
2230 }
2231
2232 /* -MCS: set the smtp_use_size flag; this is useful only when it
2233 precedes -MC (see above) */
2234
2235 else if (Ustrcmp(argrest, "CS") == 0)
2236 {
2237 smtp_use_size = TRUE;
2238 break;
2239 }
2240
2241 /* -MCT: set the tls_offered flag; this is useful only when it
2242 precedes -MC (see above). The flag indicates that the host to which
2243 Exim is connected has offered TLS support. */
2244
2245 #ifdef SUPPORT_TLS
2246 else if (Ustrcmp(argrest, "CT") == 0)
2247 {
2248 tls_offered = TRUE;
2249 break;
2250 }
2251 #endif
2252
2253 /* -M[x]: various operations on the following list of message ids:
2254 -M deliver the messages, ignoring next retry times and thawing
2255 -Mc deliver the messages, checking next retry times, no thawing
2256 -Mf freeze the messages
2257 -Mg give up on the messages
2258 -Mt thaw the messages
2259 -Mrm remove the messages
2260 In the above cases, this must be the last option. There are also the
2261 following options which are followed by a single message id, and which
2262 act on that message. Some of them use the "recipient" addresses as well.
2263 -Mar add recipient(s)
2264 -Mmad mark all recipients delivered
2265 -Mmd mark recipients(s) delivered
2266 -Mes edit sender
2267 -Mset load a message for use with -be
2268 -Mvb show body
2269 -Mvh show header
2270 -Mvl show log
2271 */
2272
2273 else if (*argrest == 0)
2274 {
2275 msg_action = MSG_DELIVER;
2276 forced_delivery = deliver_force_thaw = TRUE;
2277 }
2278 else if (Ustrcmp(argrest, "ar") == 0)
2279 {
2280 msg_action = MSG_ADD_RECIPIENT;
2281 one_msg_action = TRUE;
2282 }
2283 else if (Ustrcmp(argrest, "c") == 0) msg_action = MSG_DELIVER;
2284 else if (Ustrcmp(argrest, "es") == 0)
2285 {
2286 msg_action = MSG_EDIT_SENDER;
2287 one_msg_action = TRUE;
2288 }
2289 else if (Ustrcmp(argrest, "f") == 0) msg_action = MSG_FREEZE;
2290 else if (Ustrcmp(argrest, "g") == 0)
2291 {
2292 msg_action = MSG_DELIVER;
2293 deliver_give_up = TRUE;
2294 }
2295 else if (Ustrcmp(argrest, "mad") == 0)
2296 {
2297 msg_action = MSG_MARK_ALL_DELIVERED;
2298 }
2299 else if (Ustrcmp(argrest, "md") == 0)
2300 {
2301 msg_action = MSG_MARK_DELIVERED;
2302 one_msg_action = TRUE;
2303 }
2304 else if (Ustrcmp(argrest, "rm") == 0) msg_action = MSG_REMOVE;
2305 else if (Ustrcmp(argrest, "set") == 0)
2306 {
2307 msg_action = MSG_LOAD;
2308 one_msg_action = TRUE;
2309 }
2310 else if (Ustrcmp(argrest, "t") == 0) msg_action = MSG_THAW;
2311 else if (Ustrcmp(argrest, "vb") == 0)
2312 {
2313 msg_action = MSG_SHOW_BODY;
2314 one_msg_action = TRUE;
2315 }
2316 else if (Ustrcmp(argrest, "vh") == 0)
2317 {
2318 msg_action = MSG_SHOW_HEADER;
2319 one_msg_action = TRUE;
2320 }
2321 else if (Ustrcmp(argrest, "vl") == 0)
2322 {
2323 msg_action = MSG_SHOW_LOG;
2324 one_msg_action = TRUE;
2325 }
2326 else { badarg = TRUE; break; }
2327
2328 /* All the -Mxx options require at least one message id. */
2329
2330 msg_action_arg = i + 1;
2331 if (msg_action_arg >= argc)
2332 {
2333 fprintf(stderr, "exim: no message ids given after %s option\n", arg);
2334 return EXIT_FAILURE;
2335 }
2336
2337 /* Some require only message ids to follow */
2338
2339 if (!one_msg_action)
2340 {
2341 int j;
2342 for (j = msg_action_arg; j < argc; j++) if (!mac_ismsgid(argv[j]))
2343 {
2344 fprintf(stderr, "exim: malformed message id %s after %s option\n",
2345 argv[j], arg);
2346 return EXIT_FAILURE;
2347 }
2348 goto END_ARG; /* Remaining args are ids */
2349 }
2350
2351 /* Others require only one message id, possibly followed by addresses,
2352 which will be handled as normal arguments. */
2353
2354 else
2355 {
2356 if (!mac_ismsgid(argv[msg_action_arg]))
2357 {
2358 fprintf(stderr, "exim: malformed message id %s after %s option\n",
2359 argv[msg_action_arg], arg);
2360 return EXIT_FAILURE;
2361 }
2362 i++;
2363 }
2364 break;
2365
2366
2367 /* Some programs seem to call the -om option without the leading o;
2368 for sendmail it askes for "me too". Exim always does this. */
2369
2370 case 'm':
2371 if (*argrest != 0) badarg = TRUE;
2372 break;
2373
2374
2375 /* -N: don't do delivery - a debugging option that stops transports doing
2376 their thing. It implies debugging at the D_v level. */
2377
2378 case 'N':
2379 if (*argrest == 0)
2380 {
2381 dont_deliver = TRUE;
2382 debug_selector |= D_v;
2383 debug_file = stderr;
2384 }
2385 else badarg = TRUE;
2386 break;
2387
2388
2389 /* -n: This means "don't alias" in sendmail, apparently. Just ignore
2390 it. */
2391
2392 case 'n':
2393 break;
2394
2395 /* -O: Just ignore it. In sendmail, apparently -O option=value means set
2396 option to the specified value. This form uses long names. We need to handle
2397 -O option=value and -Ooption=value. */
2398
2399 case 'O':
2400 if (*argrest == 0)
2401 {
2402 if (++i >= argc)
2403 {
2404 fprintf(stderr, "exim: string expected after -O\n");
2405 exit(EXIT_FAILURE);
2406 }
2407 }
2408 break;
2409
2410 case 'o':
2411
2412 /* -oA: Set an argument for the bi command (sendmail's "alternate alias
2413 file" option). */
2414
2415 if (*argrest == 'A')
2416 {
2417 alias_arg = argrest + 1;
2418 if (alias_arg[0] == 0)
2419 {
2420 if (i+1 < argc) alias_arg = argv[++i]; else
2421 {
2422 fprintf(stderr, "exim: string expected after -oA\n");
2423 exit(EXIT_FAILURE);
2424 }
2425 }
2426 }
2427
2428 /* -oB: Set a connection message max value for remote deliveries */
2429
2430 else if (*argrest == 'B')
2431 {
2432 uschar *p = argrest + 1;
2433 if (p[0] == 0)
2434 {
2435 if (i+1 < argc && isdigit((argv[i+1][0]))) p = argv[++i]; else
2436 {
2437 connection_max_messages = 1;
2438 p = NULL;
2439 }
2440 }
2441
2442 if (p != NULL)
2443 {
2444 if (!isdigit(*p))
2445 {
2446 fprintf(stderr, "exim: number expected after -oB\n");
2447 exit(EXIT_FAILURE);
2448 }
2449 connection_max_messages = Uatoi(p);
2450 }
2451 }
2452
2453 /* -odb: background delivery */
2454
2455 else if (Ustrcmp(argrest, "db") == 0)
2456 {
2457 synchronous_delivery = FALSE;
2458 arg_queue_only = FALSE;
2459 queue_only_set = TRUE;
2460 }
2461
2462 /* -odf: foreground delivery (smail-compatible option); same effect as
2463 -odi: interactive (synchronous) delivery (sendmail-compatible option)
2464 */
2465
2466 else if (Ustrcmp(argrest, "df") == 0 || Ustrcmp(argrest, "di") == 0)
2467 {
2468 synchronous_delivery = TRUE;
2469 arg_queue_only = FALSE;
2470 queue_only_set = TRUE;
2471 }
2472
2473 /* -odq: queue only */
2474
2475 else if (Ustrcmp(argrest, "dq") == 0)
2476 {
2477 synchronous_delivery = FALSE;
2478 arg_queue_only = TRUE;
2479 queue_only_set = TRUE;
2480 }
2481
2482 /* -odqs: queue SMTP only - do local deliveries and remote routing,
2483 but no remote delivery */
2484
2485 else if (Ustrcmp(argrest, "dqs") == 0)
2486 {
2487 queue_smtp = TRUE;
2488 arg_queue_only = FALSE;
2489 queue_only_set = TRUE;
2490 }
2491
2492 /* -oex: Sendmail error flags. As these are also accepted without the
2493 leading -o prefix, for compatibility with vacation and other callers,
2494 they are handled with -e above. */
2495
2496 /* -oi: Set flag so dot doesn't end non-SMTP input (same as -i)
2497 -oitrue: Another sendmail syntax for the same */
2498
2499 else if (Ustrcmp(argrest, "i") == 0 ||
2500 Ustrcmp(argrest, "itrue") == 0)
2501 dot_ends = FALSE;
2502
2503 /* -oM*: Set various characteristics for an incoming message; actually
2504 acted on for trusted callers only. */
2505
2506 else if (*argrest == 'M')
2507 {
2508 if (i+1 >= argc)
2509 {
2510 fprintf(stderr, "exim: data expected after -o%s\n", argrest);
2511 exit(EXIT_FAILURE);
2512 }
2513
2514 /* -oMa: Set sender host address */
2515
2516 if (Ustrcmp(argrest, "Ma") == 0) sender_host_address = argv[++i];
2517
2518 /* -oMaa: Set authenticator name */
2519
2520 else if (Ustrcmp(argrest, "Maa") == 0)
2521 sender_host_authenticated = argv[++i];
2522
2523 /* -oMas: setting authenticated sender */
2524
2525 else if (Ustrcmp(argrest, "Mas") == 0) authenticated_sender = argv[++i];
2526
2527 /* -oMai: setting authenticated id */
2528
2529 else if (Ustrcmp(argrest, "Mai") == 0) authenticated_id = argv[++i];
2530
2531 /* -oMi: Set incoming interface address */
2532
2533 else if (Ustrcmp(argrest, "Mi") == 0) interface_address = argv[++i];
2534
2535 /* -oMr: Received protocol */
2536
2537 else if (Ustrcmp(argrest, "Mr") == 0) received_protocol = argv[++i];
2538
2539 /* -oMs: Set sender host name */
2540
2541 else if (Ustrcmp(argrest, "Ms") == 0) sender_host_name = argv[++i];
2542
2543 /* -oMt: Set sender ident */
2544
2545 else if (Ustrcmp(argrest, "Mt") == 0)
2546 {
2547 sender_ident_set = TRUE;
2548 sender_ident = argv[++i];
2549 }
2550
2551 /* Else a bad argument */
2552
2553 else
2554 {
2555 badarg = TRUE;
2556 break;
2557 }
2558 }
2559
2560 /* -om: Me-too flag for aliases. Exim always does this. Some programs
2561 seem to call this as -m (undocumented), so that is also accepted (see
2562 above). */
2563
2564 else if (Ustrcmp(argrest, "m") == 0) {}
2565
2566 /* -oo: An ancient flag for old-style addresses which still seems to
2567 crop up in some calls (see in SCO). */
2568
2569 else if (Ustrcmp(argrest, "o") == 0) {}
2570
2571 /* -oP <name>: set pid file path for daemon */
2572
2573 else if (Ustrcmp(argrest, "P") == 0)
2574 override_pid_file_path = argv[++i];
2575
2576 /* -or <n>: set timeout for non-SMTP acceptance
2577 -os <n>: set timeout for SMTP acceptance */
2578
2579 else if (*argrest == 'r' || *argrest == 's')
2580 {
2581 int *tp = (*argrest == 'r')?
2582 &arg_receive_timeout : &arg_smtp_receive_timeout;
2583 if (argrest[1] == 0)
2584 {
2585 if (i+1 < argc) *tp= readconf_readtime(argv[++i], 0, FALSE);
2586 }
2587 else *tp = readconf_readtime(argrest + 1, 0, FALSE);
2588 if (*tp < 0)
2589 {
2590 fprintf(stderr, "exim: bad time value %s: abandoned\n", argv[i]);
2591 exit(EXIT_FAILURE);
2592 }
2593 }
2594
2595 /* -oX <list>: Override local_interfaces and/or default daemon ports */
2596
2597 else if (Ustrcmp(argrest, "X") == 0)
2598 override_local_interfaces = argv[++i];
2599
2600 /* Unknown -o argument */
2601
2602 else badarg = TRUE;
2603 break;
2604
2605
2606 /* -ps: force Perl startup; -pd force delayed Perl startup */
2607
2608 case 'p':
2609 #ifdef EXIM_PERL
2610 if (*argrest == 's' && argrest[1] == 0)
2611 {
2612 perl_start_option = 1;
2613 break;
2614 }
2615 if (*argrest == 'd' && argrest[1] == 0)
2616 {
2617 perl_start_option = -1;
2618 break;
2619 }
2620 #endif
2621
2622 /* -panythingelse is taken as the Sendmail-compatible argument -prval:sval,
2623 which sets the host protocol and host name */
2624
2625 if (*argrest == 0)
2626 {
2627 if (i+1 < argc) argrest = argv[++i]; else
2628 { badarg = TRUE; break; }
2629 }
2630
2631 if (*argrest != 0)
2632 {
2633 uschar *hn = Ustrchr(argrest, ':');
2634 if (hn == NULL)
2635 {
2636 received_protocol = argrest;
2637 }
2638 else
2639 {
2640 received_protocol = string_copyn(argrest, hn - argrest);
2641 sender_host_name = hn + 1;
2642 }
2643 }
2644 break;
2645
2646
2647 case 'q':
2648 receiving_message = FALSE;
2649 if (queue_interval >= 0)
2650 {
2651 fprintf(stderr, "exim: -q specified more than once\n");
2652 exit(EXIT_FAILURE);
2653 }
2654
2655 /* -qq...: Do queue runs in a 2-stage manner */
2656
2657 if (*argrest == 'q')
2658 {
2659 queue_2stage = TRUE;
2660 argrest++;
2661 }
2662
2663 /* -qi...: Do only first (initial) deliveries */
2664
2665 if (*argrest == 'i')
2666 {
2667 queue_run_first_delivery = TRUE;
2668 argrest++;
2669 }
2670
2671 /* -qf...: Run the queue, forcing deliveries
2672 -qff..: Ditto, forcing thawing as well */
2673
2674 if (*argrest == 'f')
2675 {
2676 queue_run_force = TRUE;
2677 if (*(++argrest) == 'f')
2678 {
2679 deliver_force_thaw = TRUE;
2680 argrest++;
2681 }
2682 }
2683
2684 /* -q[f][f]l...: Run the queue only on local deliveries */
2685
2686 if (*argrest == 'l')
2687 {
2688 queue_run_local = TRUE;
2689 argrest++;
2690 }
2691
2692 /* -q[f][f][l]: Run the queue, optionally forced, optionally local only,
2693 optionally starting from a given message id. */
2694
2695 if (*argrest == 0 &&
2696 (i + 1 >= argc || argv[i+1][0] == '-' || mac_ismsgid(argv[i+1])))
2697 {
2698 queue_interval = 0;
2699 if (i+1 < argc && mac_ismsgid(argv[i+1]))
2700 start_queue_run_id = argv[++i];
2701 if (i+1 < argc && mac_ismsgid(argv[i+1]))
2702 stop_queue_run_id = argv[++i];
2703 }
2704
2705 /* -q[f][f][l]<n>: Run the queue at regular intervals, optionally forced,
2706 optionally local only. */
2707
2708 else
2709 {
2710 if (*argrest != 0)
2711 queue_interval = readconf_readtime(argrest, 0, FALSE);
2712 else
2713 queue_interval = readconf_readtime(argv[++i], 0, FALSE);
2714 if (queue_interval <= 0)
2715 {
2716 fprintf(stderr, "exim: bad time value %s: abandoned\n", argv[i]);
2717 exit(EXIT_FAILURE);
2718 }
2719 }
2720 break;
2721
2722
2723 case 'R': /* Synonymous with -qR... */
2724 receiving_message = FALSE;
2725
2726 /* -Rf: As -R (below) but force all deliveries,
2727 -Rff: Ditto, but also thaw all frozen messages,
2728 -Rr: String is regex
2729 -Rrf: Regex and force
2730 -Rrff: Regex and force and thaw
2731
2732 in all cases provided there are no further characters in this
2733 argument. */
2734
2735 if (*argrest != 0)
2736 {
2737 int i;
2738 for (i = 0; i < sizeof(rsopts)/sizeof(uschar *); i++)
2739 {
2740 if (Ustrcmp(argrest, rsopts[i]) == 0)
2741 {
2742 if (i != 2) queue_run_force = TRUE;
2743 if (i >= 2) deliver_selectstring_regex = TRUE;
2744 if (i == 1 || i == 4) deliver_force_thaw = TRUE;
2745 argrest += Ustrlen(rsopts[i]);
2746 }
2747 }
2748 }
2749
2750 /* -R: Set string to match in addresses for forced queue run to
2751 pick out particular messages. */
2752
2753 if (*argrest == 0)
2754 {
2755 if (i+1 < argc) deliver_selectstring = argv[++i]; else
2756 {
2757 fprintf(stderr, "exim: string expected after -R\n");
2758 exit(EXIT_FAILURE);
2759 }
2760 }
2761 else deliver_selectstring = argrest;
2762 break;
2763
2764
2765 /* -r: an obsolete synonym for -f (see above) */
2766
2767
2768 /* -S: Like -R but works on sender. */
2769
2770 case 'S': /* Synonymous with -qS... */
2771 receiving_message = FALSE;
2772
2773 /* -Sf: As -S (below) but force all deliveries,
2774 -Sff: Ditto, but also thaw all frozen messages,
2775 -Sr: String is regex
2776 -Srf: Regex and force
2777 -Srff: Regex and force and thaw
2778
2779 in all cases provided there are no further characters in this
2780 argument. */
2781
2782 if (*argrest != 0)
2783 {
2784 int i;
2785 for (i = 0; i < sizeof(rsopts)/sizeof(uschar *); i++)
2786 {
2787 if (Ustrcmp(argrest, rsopts[i]) == 0)
2788 {
2789 if (i != 2) queue_run_force = TRUE;
2790 if (i >= 2) deliver_selectstring_sender_regex = TRUE;
2791 if (i == 1 || i == 4) deliver_force_thaw = TRUE;
2792 argrest += Ustrlen(rsopts[i]);
2793 }
2794 }
2795 }
2796
2797 /* -S: Set string to match in addresses for forced queue run to
2798 pick out particular messages. */
2799
2800 if (*argrest == 0)
2801 {
2802 if (i+1 < argc) deliver_selectstring_sender = argv[++i]; else
2803 {
2804 fprintf(stderr, "exim: string expected after -S\n");
2805 exit(EXIT_FAILURE);
2806 }
2807 }
2808 else deliver_selectstring_sender = argrest;
2809 break;
2810
2811 /* -Tqt is an option that is exclusively for use by the testing suite.
2812 It is not recognized in other circumstances. It allows for the setting up
2813 of explicit "queue times" so that various warning/retry things can be
2814 tested. Otherwise variability of clock ticks etc. cause problems. */
2815
2816 case 'T':
2817 if (running_in_test_harness && Ustrcmp(argrest, "qt") == 0)
2818 fudged_queue_times = argv[++i];
2819 else badarg = TRUE;
2820 break;
2821
2822
2823 /* -t: Set flag to extract recipients from body of message. */
2824
2825 case 't':
2826 if (*argrest == 0) extract_recipients = TRUE;
2827
2828 /* -ti: Set flag to extract recipients from body of message, and also
2829 specify that dot does not end the message. */
2830
2831 else if (Ustrcmp(argrest, "i") == 0)
2832 {
2833 extract_recipients = TRUE;
2834 dot_ends = FALSE;
2835 }
2836
2837 /* -tls-on-connect: don't wait for STARTTLS (for old clients) */
2838
2839 #ifdef SUPPORT_TLS
2840 else if (Ustrcmp(argrest, "ls-on-connect") == 0) tls_on_connect = TRUE;
2841 #endif
2842
2843 else badarg = TRUE;
2844 break;
2845
2846
2847 /* -U: This means "initial user submission" in sendmail, apparently. The
2848 doc claims that in future sendmail may refuse syntactically invalid
2849 messages instead of fixing them. For the moment, we just ignore it. */
2850
2851 case 'U':
2852 break;
2853
2854
2855 /* -v: verify things - this is a very low-level debugging */
2856
2857 case 'v':
2858 if (*argrest == 0)
2859 {
2860 debug_selector |= D_v;
2861 debug_file = stderr;
2862 }
2863 else badarg = TRUE;
2864 break;
2865
2866
2867 /* -x: AIX uses this to indicate some fancy 8-bit character stuff:
2868
2869 The -x flag tells the sendmail command that mail from a local
2870 mail program has National Language Support (NLS) extended characters
2871 in the body of the mail item. The sendmail command can send mail with
2872 extended NLS characters across networks that normally corrupts these
2873 8-bit characters.
2874
2875 As Exim is 8-bit clean, it just ignores this flag. */
2876
2877 case 'x':
2878 if (*argrest != 0) badarg = TRUE;
2879 break;
2880
2881 /* All other initial characters are errors */
2882
2883 default:
2884 badarg = TRUE;
2885 break;
2886 } /* End of high-level switch statement */
2887
2888 /* Failed to recognize the option, or syntax error */
2889
2890 if (badarg)
2891 {
2892 fprintf(stderr, "exim abandoned: unknown, malformed, or incomplete "
2893 "option %s\n", arg);
2894 exit(EXIT_FAILURE);
2895 }
2896 }
2897
2898
2899 /* If -R or -S have been specified without -q, assume a single queue run. */
2900
2901 if ((deliver_selectstring != NULL || deliver_selectstring_sender != NULL) &&
2902 queue_interval < 0) queue_interval = 0;
2903
2904
2905 /* Arguments have been processed. Check for incompatibilities. */
2906
2907 END_ARG:
2908 if ((
2909 (smtp_input || extract_recipients || recipients_arg < argc) &&
2910 (daemon_listen || queue_interval >= 0 || bi_option ||
2911 test_retry_arg >= 0 || test_rewrite_arg >= 0 ||
2912 filter_test != FTEST_NONE || (msg_action_arg > 0 && !one_msg_action))
2913 ) ||
2914 (
2915 msg_action_arg > 0 &&
2916 (daemon_listen || queue_interval >= 0 || list_options ||
2917 (checking && msg_action != MSG_LOAD) ||
2918 bi_option || test_retry_arg >= 0 || test_rewrite_arg >= 0)
2919 ) ||
2920 (
2921 (daemon_listen || queue_interval >= 0) &&
2922 (sender_address != NULL || list_options || list_queue || checking ||
2923 bi_option)
2924 ) ||
2925 (
2926 daemon_listen && queue_interval == 0
2927 ) ||
2928 (
2929 list_options &&
2930 (checking || smtp_input || extract_recipients ||
2931 filter_test != FTEST_NONE || bi_option)
2932 ) ||
2933 (
2934 verify_address_mode &&
2935 (address_test_mode || smtp_input || extract_recipients ||
2936 filter_test != FTEST_NONE || bi_option)
2937 ) ||
2938 (
2939 address_test_mode && (smtp_input || extract_recipients ||
2940 filter_test != FTEST_NONE || bi_option)
2941 ) ||
2942 (
2943 smtp_input && (sender_address != NULL || filter_test != FTEST_NONE ||
2944 extract_recipients)
2945 ) ||
2946 (
2947 deliver_selectstring != NULL && queue_interval < 0
2948 ) ||
2949 (
2950 msg_action == MSG_LOAD &&
2951 (!expansion_test || expansion_test_message != NULL)
2952 )
2953 )
2954 {
2955 fprintf(stderr, "exim: incompatible command-line options or arguments\n");
2956 exit(EXIT_FAILURE);
2957 }
2958
2959 /* If debugging is set up, set the file and the file descriptor to pass on to
2960 child processes. It should, of course, be 2 for stderr. Also, force the daemon
2961 to run in the foreground. */
2962
2963 if (debug_selector != 0)
2964 {
2965 debug_file = stderr;
2966 debug_fd = fileno(debug_file);
2967 background_daemon = FALSE;
2968 if (running_in_test_harness) millisleep(100); /* lets caller finish */
2969 if (debug_selector != D_v) /* -v only doesn't show this */
2970 {
2971 debug_printf("Exim version %s uid=%ld gid=%ld pid=%d D=%x\n",
2972 version_string, (long int)real_uid, (long int)real_gid, (int)getpid(),
2973 debug_selector);
2974 show_whats_supported(stderr);
2975 }
2976 }
2977
2978 /* When started with root privilege, ensure that the limits on the number of
2979 open files and the number of processes (where that is accessible) are
2980 sufficiently large, or are unset, in case Exim has been called from an
2981 environment where the limits are screwed down. Not all OS have the ability to
2982 change some of these limits. */
2983
2984 if (unprivileged)
2985 {
2986 DEBUG(D_any) debug_print_ids(US"Exim has no root privilege:");
2987 }
2988 else
2989 {
2990 struct rlimit rlp;
2991
2992 #ifdef RLIMIT_NOFILE
2993 if (getrlimit(RLIMIT_NOFILE, &rlp) < 0)
2994 {
2995 log_write(0, LOG_MAIN|LOG_PANIC, "getrlimit(RLIMIT_NOFILE) failed: %s",
2996 strerror(errno));
2997 rlp.rlim_cur = rlp.rlim_max = 0;
2998 }
2999
3000 /* I originally chose 1000 as a nice big number that was unlikely to
3001 be exceeded. It turns out that some older OS have a fixed upper limit of
3002 256. */
3003
3004 if (rlp.rlim_cur < 1000)
3005 {
3006 rlp.rlim_cur = rlp.rlim_max = 1000;
3007 if (setrlimit(RLIMIT_NOFILE, &rlp) < 0)
3008 {
3009 rlp.rlim_cur = rlp.rlim_max = 256;
3010 if (setrlimit(RLIMIT_NOFILE, &rlp) < 0)
3011 log_write(0, LOG_MAIN|LOG_PANIC, "setrlimit(RLIMIT_NOFILE) failed: %s",
3012 strerror(errno));
3013 }
3014 }
3015 #endif
3016
3017 #ifdef RLIMIT_NPROC
3018 if (getrlimit(RLIMIT_NPROC, &rlp) < 0)
3019 {
3020 log_write(0, LOG_MAIN|LOG_PANIC, "getrlimit(RLIMIT_NPROC) failed: %s",
3021 strerror(errno));
3022 rlp.rlim_cur = rlp.rlim_max = 0;
3023 }
3024
3025 #ifdef RLIM_INFINITY
3026 if (rlp.rlim_cur != RLIM_INFINITY && rlp.rlim_cur < 1000)
3027 {
3028 rlp.rlim_cur = rlp.rlim_max = RLIM_INFINITY;
3029 #else
3030 if (rlp.rlim_cur < 1000)
3031 {
3032 rlp.rlim_cur = rlp.rlim_max = 1000;
3033 #endif
3034 if (setrlimit(RLIMIT_NPROC, &rlp) < 0)
3035 log_write(0, LOG_MAIN|LOG_PANIC, "setrlimit(RLIMIT_NPROC) failed: %s",
3036 strerror(errno));
3037 }
3038 #endif
3039 }
3040
3041 /* Exim is normally entered as root (but some special configurations are
3042 possible that don't do this). However, it always spins off sub-processes that
3043 set their uid and gid as required for local delivery. We don't want to pass on
3044 any extra groups that root may belong to, so we want to get rid of them all at
3045 this point.
3046
3047 We need to obey setgroups() at this stage, before possibly giving up root
3048 privilege for a changed configuration file, but later on we might need to
3049 check on the additional groups for the admin user privilege - can't do that
3050 till after reading the config, which might specify the exim gid. Therefore,
3051 save the group list here first. */
3052
3053 group_count = getgroups(NGROUPS_MAX, group_list);
3054
3055 /* There is a fundamental difference in some BSD systems in the matter of
3056 groups. FreeBSD and BSDI are known to be different; NetBSD and OpenBSD are
3057 known not to be different. On the "different" systems there is a single group
3058 list, and the first entry in it is the current group. On all other versions of
3059 Unix there is a supplementary group list, which is in *addition* to the current
3060 group. Consequently, to get rid of all extraneous groups on a "standard" system
3061 you pass over 0 groups to setgroups(), while on a "different" system you pass
3062 over a single group - the current group, which is always the first group in the
3063 list. Calling setgroups() with zero groups on a "different" system results in
3064 an error return. The following code should cope with both types of system.
3065
3066 However, if this process isn't running as root, setgroups() can't be used
3067 since you have to be root to run it, even if throwing away groups. Not being
3068 root here happens only in some unusual configurations. We just ignore the
3069 error. */
3070
3071 if (setgroups(0, NULL) != 0)
3072 {
3073 if (setgroups(1, group_list) != 0 && !unprivileged)
3074 {
3075 fprintf(stderr, "exim: setgroups() failed: %s\n", strerror(errno));
3076 exit(EXIT_FAILURE);
3077 }
3078 }
3079
3080 /* If the configuration file name has been altered by an argument on the
3081 command line (either a new file name or a macro definition) and the caller is
3082 not root or the exim user, or if this is a filter testing run, remove any
3083 setuid privilege the program has, and run as the underlying user.
3084
3085 If ALT_CONFIG_ROOT_ONLY is defined, the exim user is locked out of this, which
3086 severely restricts the use of -C for some purposes.
3087
3088 Otherwise, set the real ids to the effective values (should be root unless run
3089 from inetd, which it can either be root or the exim uid, if one is configured).
3090
3091 There is a private mechanism for bypassing some of this, in order to make it
3092 possible to test lots of configurations automatically, without having either to
3093 recompile each time, or to patch in an actual configuration file name and other
3094 values (such as the path name). If running in the test harness, pretend that
3095 configuration file changes and macro definitions haven't happened. */
3096
3097 if (( /* EITHER */
3098 (config_changed || macros != NULL) && /* Config changed, and */
3099 real_uid != root_uid && /* Not root, and */
3100 #ifndef ALT_CONFIG_ROOT_ONLY /* (when not locked out) */
3101 real_uid != exim_uid && /* Not exim, and */
3102 #endif
3103 !running_in_test_harness /* Not fudged */
3104 ) || /* OR */
3105 expansion_test /* expansion testing */
3106 || /* OR */
3107 filter_test != FTEST_NONE) /* Filter testing */
3108 {
3109 setgroups(group_count, group_list);
3110 exim_setugid(real_uid, real_gid, FALSE,
3111 US"-C, -D, -be or -bf forces real uid");
3112 removed_privilege = TRUE;
3113
3114 /* In the normal case when Exim is called like this, stderr is available
3115 and should be used for any logging information because attempts to write
3116 to the log will usually fail. To arrange this, we unset really_exim. However,
3117 if no stderr is available there is no point - we might as well have a go
3118 at the log (if it fails, syslog will be written). */
3119
3120 if (log_stderr != NULL) really_exim = FALSE;
3121 }
3122
3123 /* Privilege is to be retained for the moment. It may be dropped later,
3124 depending on the job that this Exim process has been asked to do. For now, set
3125 the real uid to the effective so that subsequent re-execs of Exim are done by a
3126 privileged user. */
3127
3128 else exim_setugid(geteuid(), getegid(), FALSE, US"forcing real = effective");
3129
3130 /* If testing a filter, open the file(s) now, before wasting time doing other
3131 setups and reading the message. */
3132
3133 if ((filter_test & FTEST_SYSTEM) != 0)
3134 {
3135 filter_sfd = Uopen(filter_test_sfile, O_RDONLY, 0);
3136 if (filter_sfd < 0)
3137 {
3138 fprintf(stderr, "exim: failed to open %s: %s\n", filter_test_sfile,
3139 strerror(errno));
3140 return EXIT_FAILURE;
3141 }
3142 }
3143
3144 if ((filter_test & FTEST_USER) != 0)
3145 {
3146 filter_ufd = Uopen(filter_test_ufile, O_RDONLY, 0);
3147 if (filter_ufd < 0)
3148 {
3149 fprintf(stderr, "exim: failed to open %s: %s\n", filter_test_ufile,
3150 strerror(errno));
3151 return EXIT_FAILURE;
3152 }
3153 }
3154
3155 /* Read the main runtime configuration data; this gives up if there
3156 is a failure. It leaves the configuration file open so that the subsequent
3157 configuration data for delivery can be read if needed. */
3158
3159 readconf_main();
3160
3161 /* Handle the decoding of logging options. */
3162
3163 decode_bits(&log_write_selector, &log_extra_selector, 0, 0, log_selector_string,
3164 log_options, log_options_count, US"log");
3165
3166 DEBUG(D_any)
3167 {
3168 debug_printf("configuration file is %s\n", config_main_filename);
3169 debug_printf("log selectors = %08x %08x\n", log_write_selector,
3170 log_extra_selector);
3171 }
3172
3173 /* If domain literals are not allowed, check the sender address that was
3174 supplied with -f. Ditto for a stripped trailing dot. */
3175
3176 if (sender_address != NULL)
3177 {
3178 if (sender_address[sender_address_domain] == '[' && !allow_domain_literals)
3179 {
3180 fprintf(stderr, "exim: bad -f address \"%s\": domain literals not "
3181 "allowed\n", sender_address);
3182 return EXIT_FAILURE;
3183 }
3184 if (f_end_dot && !strip_trailing_dot)
3185 {
3186 fprintf(stderr, "exim: bad -f address \"%s.\": domain is malformed "
3187 "(trailing dot not allowed)\n", sender_address);
3188 return EXIT_FAILURE;
3189 }
3190 }
3191
3192 /* Paranoia check of maximum lengths of certain strings. There is a check
3193 on the length of the log file path in log.c, which will come into effect
3194 if there are any calls to write the log earlier than this. However, if we
3195 get this far but the string is very long, it is better to stop now than to
3196 carry on and (e.g.) receive a message and then have to collapse. The call to
3197 log_write() from here will cause the ultimate panic collapse if the complete
3198 file name exceeds the buffer length. */
3199
3200 if (Ustrlen(log_file_path) > 200)
3201 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3202 "log_file_path is longer than 200 chars: aborting");
3203
3204 if (Ustrlen(pid_file_path) > 200)
3205 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3206 "pid_file_path is longer than 200 chars: aborting");
3207
3208 if (Ustrlen(spool_directory) > 200)
3209 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3210 "spool_directory is longer than 200 chars: aborting");
3211
3212 /* Length check on the process name given to syslog for its TAG field,
3213 which is only permitted to be 32 characters or less. See RFC 3164. */
3214
3215 if (Ustrlen(syslog_processname) > 32)
3216 log_write(0, LOG_MAIN|LOG_PANIC_DIE,
3217 "syslog_processname is longer than 32 chars: aborting");
3218
3219 /* In some operating systems, the environment variable TMPDIR controls where
3220 temporary files are created; Exim doesn't use these (apart from when delivering
3221 to MBX mailboxes), but called libraries such as DBM libraries may require them.
3222 If TMPDIR is found in the environment, reset it to the value defined in the
3223 TMPDIR macro, if this macro is defined. */
3224
3225 #ifdef TMPDIR
3226 {
3227 uschar **p;
3228 for (p = USS environ; *p != NULL; p++)
3229 {
3230 if (Ustrncmp(*p, "TMPDIR=", 7) == 0 &&
3231 Ustrcmp(*p+7, TMPDIR) != 0)
3232 {
3233 uschar *newp = malloc(Ustrlen(TMPDIR) + 8);
3234 sprintf(CS newp, "TMPDIR=%s", TMPDIR);
3235 *p = newp;
3236 DEBUG(D_any) debug_printf("reset TMPDIR=%s in environment\n", TMPDIR);
3237 }
3238 }
3239 }
3240 #endif
3241
3242 /* Timezone handling. If timezone_string is "utc", set a flag to cause all
3243 timestamps to be in UTC (gmtime() is used instead of localtime()). Otherwise,
3244 we may need to get rid of a bogus timezone setting. This can arise when Exim is
3245 called by a user who has set the TZ variable. This then affects the timestamps
3246 in log files and in Received: headers, and any created Date: header lines. The
3247 required timezone is settable in the configuration file, so nothing can be done
3248 about this earlier - but hopefully nothing will normally be logged earlier than
3249 this. We have to make a new environment if TZ is wrong, but don't bother if
3250 timestamps_utc is set, because then all times are in UTC anyway. */
3251
3252 if (timezone_string != NULL && strcmpic(timezone_string, US"UTC") == 0)
3253 {
3254 timestamps_utc = TRUE;
3255 }
3256 else
3257 {
3258 uschar *envtz = US getenv("TZ");
3259 if ((envtz == NULL && timezone_string != NULL) ||
3260 (envtz != NULL &&
3261 (timezone_string == NULL ||
3262 Ustrcmp(timezone_string, envtz) != 0)))
3263 {
3264 uschar **p = USS environ;
3265 uschar **new;
3266 uschar **newp;
3267 int count = 0;
3268 while (*p++ != NULL) count++;
3269 if (envtz == NULL) count++;
3270 newp = new = malloc(sizeof(uschar *) * (count + 1));
3271 for (p = USS environ; *p != NULL; p++)
3272 {
3273 if (Ustrncmp(*p, "TZ=", 3) == 0) continue;
3274 *newp++ = *p;
3275 }
3276 if (timezone_string != NULL)
3277 {
3278 *newp = malloc(Ustrlen(timezone_string) + 4);
3279 sprintf(CS *newp++, "TZ=%s", timezone_string);
3280 }
3281 *newp = NULL;
3282 environ = CSS new;
3283 tzset();
3284 DEBUG(D_any) debug_printf("Reset TZ to %s: time is %s\n", timezone_string,
3285 tod_stamp(tod_log));
3286 }
3287 }
3288
3289 /* Handle the case when we have removed the setuid privilege because of -C or
3290 -D. This means that the caller of Exim was not root, and, provided that
3291 ALT_CONFIG_ROOT_ONLY is not defined, was not the Exim user that is built into
3292 the binary.
3293
3294 If ALT_CONFIG_ROOT_ONLY is not defined, there is a problem if it turns out we
3295 were running as the exim user defined in the configuration file (different to
3296 the one in the binary). The sysadmin may expect this case to retain privilege
3297 because "the binary was called by the Exim user", but it hasn't, because of the
3298 order in which it handles this stuff. There are two possibilities:
3299
3300 (1) If deliver_drop_privilege is set, Exim is not going to re-exec in order
3301 to do message deliveries. Thus, the fact that it is running as a
3302 non-privileged user is plausible, and might be wanted in some special
3303 configurations. However, really_exim will have been set false when
3304 privilege was dropped, to stop Exim trying to write to its normal log
3305 files. Therefore, re-enable normal log processing, assuming the sysadmin
3306 has set up the log directory correctly.
3307
3308 (2) If deliver_drop_privilege is not set, the configuration won't work as
3309 apparently intended, and so we log a panic message. In order to retain
3310 root for -C or -D, the caller must either be root or the Exim user
3311 defined in the binary (when deliver_drop_ privilege is false).
3312
3313 If ALT_CONFIG_ROOT_ONLY is defined, we don't know whether we were called by the
3314 built-in exim user or one defined in the configuration. In either event,
3315 re-enable log processing, assuming the sysadmin knows what they are doing. */
3316
3317 if (removed_privilege && (config_changed || macros != NULL) &&
3318 real_uid == exim_uid)
3319 {
3320 #ifdef ALT_CONFIG_ROOT_ONLY
3321 really_exim = TRUE; /* let logging work normally */
3322 #else
3323
3324 if (deliver_drop_privilege)
3325 really_exim = TRUE; /* let logging work normally */
3326 else
3327 log_write(0, LOG_MAIN|LOG_PANIC,
3328 "exim user (uid=%d) is defined only at runtime; privilege lost for %s",
3329 (int)exim_uid, config_changed? "-C" : "-D");
3330 #endif
3331 }
3332
3333 /* Start up Perl interpreter if Perl support is configured and there is a
3334 perl_startup option, and the configuration or the command line specifies
3335 initializing starting. Note that the global variables are actually called
3336 opt_perl_xxx to avoid clashing with perl's namespace (perl_*). */
3337
3338 #ifdef EXIM_PERL
3339 if (perl_start_option != 0)
3340 opt_perl_at_start = (perl_start_option > 0);
3341 if (opt_perl_at_start && opt_perl_startup != NULL)
3342 {
3343 uschar *errstr;
3344 DEBUG(D_any) debug_printf("Starting Perl interpreter\n");
3345 errstr = init_perl(opt_perl_startup);
3346 if (errstr != NULL)
3347 {
3348 fprintf(stderr, "exim: error in perl_startup code: %s\n", errstr);
3349 return EXIT_FAILURE;
3350 }
3351 opt_perl_started = TRUE;
3352 }
3353 #endif /* EXIM_PERL */
3354
3355 /* Log the arguments of the call if the configuration file said so. This is
3356 a debugging feature for finding out what arguments certain MUAs actually use.
3357 Don't attempt it if logging is disabled, or if listing variables or if
3358 verifying/testing addresses or expansions. */
3359
3360 if (((debug_selector & D_any) != 0 || (log_extra_selector & LX_arguments) != 0)
3361 && really_exim && !list_options && !checking)
3362 {
3363 int i;
3364 uschar *p = big_buffer;
3365 Ustrcpy(p, "cwd=");
3366 (void)getcwd(CS p+4, big_buffer_size - 4);
3367 while (*p) p++;
3368 (void)string_format(p, big_buffer_size - (p - big_buffer), " %d args:", argc);
3369 while (*p) p++;
3370 for (i = 0; i < argc; i++)
3371 {
3372 int len = Ustrlen(argv[i]);
3373 uschar *printing;
3374 uschar *quote;
3375 if (p + len + 8 >= big_buffer + big_buffer_size)
3376 {
3377 Ustrcpy(p, " ...");
3378 log_write(0, LOG_MAIN, "%s", big_buffer);
3379 Ustrcpy(big_buffer, "...");
3380 p = big_buffer + 3;
3381 }
3382 printing = string_printing(argv[i]);
3383 if (printing[0] == 0) quote = US"\""; else
3384 {
3385 uschar *pp = printing;
3386 quote = US"";
3387 while (*pp != 0) if (isspace(*pp++)) { quote = US"\""; break; }
3388 }
3389 sprintf(CS p, " %s%.*s%s", quote, (int)(big_buffer_size -
3390 (p - big_buffer) - 4), printing, quote);
3391 while (*p) p++;
3392 }
3393
3394 if ((log_extra_selector & LX_arguments) != 0)
3395 log_write(0, LOG_MAIN, "%s", big_buffer);
3396 else
3397 debug_printf("%s\n", big_buffer);
3398 }
3399
3400 /* Set the working directory to be the top-level spool directory. We don't rely
3401 on this in the code, which always uses fully qualified names, but it's useful
3402 for core dumps etc. Don't complain if it fails - the spool directory might not
3403 be generally accessible and calls with the -C option (and others) have lost
3404 privilege by now. Before the chdir, we try to ensure that the directory exists.
3405 */
3406
3407 if (Uchdir(spool_directory) != 0)
3408 {
3409 (void)directory_make(spool_directory, US"", SPOOL_DIRECTORY_MODE, FALSE);
3410 (void)Uchdir(spool_directory);
3411 }
3412
3413 /* Handle calls with the -bi option. This is a sendmail option to rebuild *the*
3414 alias file. Exim doesn't have such a concept, but this call is screwed into
3415 Sun's YP makefiles. Handle this by calling a configured script, as the real
3416 user who called Exim. The -oA option can be used to pass an argument to the
3417 script. */
3418
3419 if (bi_option)
3420 {
3421 (void)fclose(config_file);
3422 if (bi_command != NULL)
3423 {
3424 int i = 0;
3425 uschar *argv[3];
3426 argv[i++] = bi_command;
3427 if (alias_arg != NULL) argv[i++] = alias_arg;
3428 argv[i++] = NULL;
3429
3430 setgroups(group_count, group_list);
3431 exim_setugid(real_uid, real_gid, FALSE, US"running bi_command");
3432
3433 DEBUG(D_exec) debug_printf("exec %.256s %.256s\n", argv[0],
3434 (argv[1] == NULL)? US"" : argv[1]);
3435
3436 execv(CS argv[0], (char *const *)argv);
3437 fprintf(stderr, "exim: exec failed: %s\n", strerror(errno));
3438 exit(EXIT_FAILURE);
3439 }
3440 else
3441 {
3442 DEBUG(D_any) debug_printf("-bi used but bi_command not set; exiting\n");
3443 exit(EXIT_SUCCESS);
3444 }
3445 }
3446
3447 /* If an action on specific messages is requested, or if a daemon or queue
3448 runner is being started, we need to know if Exim was called by an admin user.
3449 This is the case if the real user is root or exim, or if the real group is
3450 exim, or if one of the supplementary groups is exim or a group listed in
3451 admin_groups. We don't fail all message actions immediately if not admin_user,
3452 since some actions can be performed by non-admin users. Instead, set admin_user
3453 for later interrogation. */
3454
3455 if (real_uid == root_uid || real_uid == exim_uid || real_gid == exim_gid)
3456 admin_user = TRUE;
3457 else
3458 {
3459 int i, j;
3460
3461 for (i = 0; i < group_count; i++)
3462 {
3463 if (group_list[i] == exim_gid) admin_user = TRUE;
3464 else if (admin_groups != NULL)
3465 {
3466 for (j = 1; j <= (int)(admin_groups[0]); j++)
3467 if (admin_groups[j] == group_list[i])
3468 { admin_user = TRUE; break; }
3469 }
3470 if (admin_user) break;
3471 }
3472 }
3473
3474 /* Another group of privileged users are the trusted users. These are root,
3475 exim, and any caller matching trusted_users or trusted_groups. Trusted callers
3476 are permitted to specify sender_addresses with -f on the command line, and
3477 other message parameters as well. */
3478
3479 if (real_uid == root_uid || real_uid == exim_uid)
3480 trusted_caller = TRUE;
3481 else
3482 {
3483 int i, j;
3484
3485 if (trusted_users != NULL)
3486 {
3487 for (i = 1; i <= (int)(trusted_users[0]); i++)
3488 if (trusted_users[i] == real_uid)
3489 { trusted_caller = TRUE; break; }
3490 }
3491
3492 if (!trusted_caller && trusted_groups != NULL)
3493 {
3494 for (i = 1; i <= (int)(trusted_groups[0]); i++)
3495 {
3496 if (trusted_groups[i] == real_gid)
3497 trusted_caller = TRUE;
3498 else for (j = 0; j < group_count; j++)
3499 {
3500 if (trusted_groups[i] == group_list[j])
3501 { trusted_caller = TRUE; break; }
3502 }
3503 if (trusted_caller) break;
3504 }
3505 }
3506 }
3507
3508 if (trusted_caller) DEBUG(D_any) debug_printf("trusted user\n");
3509 if (admin_user) DEBUG(D_any) debug_printf("admin user\n");
3510
3511 /* Only an admin user may start the daemon or force a queue run in the default
3512 configuration, but the queue run restriction can be relaxed. Only an admin
3513 user may request that a message be returned to its sender forthwith. Only an
3514 admin user may specify a debug level greater than D_v (because it might show
3515 passwords, etc. in lookup queries). Only an admin user may request a queue
3516 count. */
3517