Silence the compiler
[exim.git] / src / src / log.c
1 /*************************************************
2 *     Exim - an Internet mail transport agent    *
3 *************************************************/
4
5 /* Copyright (c) University of Cambridge 1995 - 2018 */
6 /* Copyright (c) The Exim Maintainers 2020 */
7 /* See the file NOTICE for conditions of use and distribution. */
8
9 /* Functions for writing log files. The code for maintaining datestamped
10 log files was originally contributed by Tony Sheen. */
11
12
13 #include "exim.h"
14
15 #define LOG_NAME_SIZE 256
16 #define MAX_SYSLOG_LEN 870
17
18 #define LOG_MODE_FILE   1
19 #define LOG_MODE_SYSLOG 2
20
21 enum { lt_main, lt_reject, lt_panic, lt_debug };
22
23 static uschar *log_names[] = { US"main", US"reject", US"panic", US"debug" };
24
25
26
27 /*************************************************
28 *           Local static variables               *
29 *************************************************/
30
31 static uschar mainlog_name[LOG_NAME_SIZE];
32 static uschar rejectlog_name[LOG_NAME_SIZE];
33 static uschar debuglog_name[LOG_NAME_SIZE];
34
35 static uschar *mainlog_datestamp = NULL;
36 static uschar *rejectlog_datestamp = NULL;
37
38 static int    mainlogfd = -1;
39 static int    rejectlogfd = -1;
40 static ino_t  mainlog_inode = 0;
41 static ino_t  rejectlog_inode = 0;
42
43 static uschar *panic_save_buffer = NULL;
44 static BOOL   panic_recurseflag = FALSE;
45
46 static BOOL   syslog_open = FALSE;
47 static BOOL   path_inspected = FALSE;
48 static int    logging_mode = LOG_MODE_FILE;
49 static uschar *file_path = US"";
50
51 static size_t pid_position[2];
52
53
54 /* These should be kept in-step with the private delivery error
55 number definitions in macros.h */
56
57 static const uschar * exim_errstrings[] = {
58   US"",
59   US"unknown error",
60   US"user slash",
61   US"exist race",
62   US"not regular",
63   US"not directory",
64   US"bad ugid",
65   US"bad mode",
66   US"inode changed",
67   US"lock failed",
68   US"bad address2",
69   US"forbid pipe",
70   US"forbid file",
71   US"forbid reply",
72   US"missing pipe",
73   US"missing file",
74   US"missing reply",
75   US"bad redirect",
76   US"smtp closed",
77   US"smtp format",
78   US"spool format",
79   US"not absolute",
80   US"Exim-imposed quota",
81   US"held",
82   US"Delivery filter process failure",
83   US"Delivery add/remove header failure",
84   US"Delivery write incomplete error",
85   US"Some expansion failed",
86   US"Failed to get gid",
87   US"Failed to get uid",
88   US"Unset or non-existent transport",
89   US"MBX length mismatch",
90   US"Lookup failed routing or in smtp tpt",
91   US"Can't match format in appendfile",
92   US"Creation outside home in appendfile",
93   US"Can't check a list; lookup defer",
94   US"DNS lookup defer",
95   US"Failed to start TLS session",
96   US"Mandatory TLS session not started",
97   US"Failed to chown a file",
98   US"Failed to create a pipe",
99   US"When verifying",
100   US"When required by client",
101   US"Used internally in smtp transport",
102   US"RCPT gave 4xx error",
103   US"MAIL gave 4xx error",
104   US"DATA gave 4xx error",
105   US"Negotiation failed for proxy configured host",
106   US"Authenticator 'other' failure",
107   US"target not supporting SMTPUTF8",
108   US"host is local",
109   US"tainted filename",
110
111   US"Not time for routing",
112   US"Not time for local delivery",
113   US"Not time for any remote host",
114   US"Local-only delivery",
115   US"Domain in queue_domains",
116   US"Transport concurrency limit",
117   US"Event requests alternate response",
118 };
119
120
121 /************************************************/
122 const uschar *
123 exim_errstr(int err)
124 {
125 return err < 0 ? exim_errstrings[-err] : CUS strerror(err);
126 }
127
128 /*************************************************
129 *              Write to syslog                   *
130 *************************************************/
131
132 /* The given string is split into sections according to length, or at embedded
133 newlines, and syslogged as a numbered sequence if it is overlong or if there is
134 more than one line. However, if we are running in the test harness, do not do
135 anything. (The test harness doesn't use syslog - for obvious reasons - but we
136 can get here if there is a failure to open the panic log.)
137
138 Arguments:
139   priority       syslog priority
140   s              the string to be written
141
142 Returns:         nothing
143 */
144
145 static void
146 write_syslog(int priority, const uschar *s)
147 {
148 int len;
149 int linecount = 0;
150
151 if (!syslog_pid && LOGGING(pid))
152   s = string_sprintf("%.*s%s", (int)pid_position[0], s, s + pid_position[1]);
153 if (!syslog_timestamp)
154   {
155   len = log_timezone ? 26 : 20;
156   if (LOGGING(millisec)) len += 4;
157   s += len;
158   }
159
160 len = Ustrlen(s);
161
162 #ifndef NO_OPENLOG
163 if (!syslog_open && !f.running_in_test_harness)
164   {
165 # ifdef SYSLOG_LOG_PID
166   openlog(CS syslog_processname, LOG_PID|LOG_CONS, syslog_facility);
167 # else
168   openlog(CS syslog_processname, LOG_CONS, syslog_facility);
169 # endif
170   syslog_open = TRUE;
171   }
172 #endif
173
174 /* First do a scan through the message in order to determine how many lines
175 it is going to end up as. Then rescan to output it. */
176
177 for (int pass = 0; pass < 2; pass++)
178   {
179   const uschar * ss = s;
180   for (int i = 1, tlen = len; tlen > 0; i++)
181     {
182     int plen = tlen;
183     uschar *nlptr = Ustrchr(ss, '\n');
184     if (nlptr != NULL) plen = nlptr - ss;
185 #ifndef SYSLOG_LONG_LINES
186     if (plen > MAX_SYSLOG_LEN) plen = MAX_SYSLOG_LEN;
187 #endif
188     tlen -= plen;
189     if (ss[plen] == '\n') tlen--;    /* chars left */
190
191     if (pass == 0)
192       linecount++;
193     else if (f.running_in_test_harness)
194       if (linecount == 1)
195         fprintf(stderr, "SYSLOG: '%.*s'\n", plen, ss);
196       else
197         fprintf(stderr, "SYSLOG: '[%d%c%d] %.*s'\n", i,
198           ss[plen] == '\n' && tlen != 0 ? '\\' : '/',
199           linecount, plen, ss);
200     else
201       if (linecount == 1)
202         syslog(priority, "%.*s", plen, ss);
203       else
204         syslog(priority, "[%d%c%d] %.*s", i,
205           ss[plen] == '\n' && tlen != 0 ? '\\' : '/',
206           linecount, plen, ss);
207
208     ss += plen;
209     if (*ss == '\n') ss++;
210     }
211   }
212 }
213
214
215
216 /*************************************************
217 *             Die tidily                         *
218 *************************************************/
219
220 /* This is called when Exim is dying as a result of something going wrong in
221 the logging, or after a log call with LOG_PANIC_DIE set. Optionally write a
222 message to debug_file or a stderr file, if they exist. Then, if in the middle
223 of accepting a message, throw it away tidily by calling receive_bomb_out();
224 this will attempt to send an SMTP response if appropriate. Passing NULL as the
225 first argument stops it trying to run the NOTQUIT ACL (which might try further
226 logging and thus cause problems). Otherwise, try to close down an outstanding
227 SMTP call tidily.
228
229 Arguments:
230   s1         Error message to write to debug_file and/or stderr and syslog
231   s2         Error message for any SMTP call that is in progress
232 Returns:     The function does not return
233 */
234
235 static void
236 die(uschar *s1, uschar *s2)
237 {
238 if (s1)
239   {
240   write_syslog(LOG_CRIT, s1);
241   if (debug_file) debug_printf("%s\n", s1);
242   if (log_stderr && log_stderr != debug_file)
243     fprintf(log_stderr, "%s\n", s1);
244   }
245 if (f.receive_call_bombout) receive_bomb_out(NULL, s2);  /* does not return */
246 if (smtp_input) smtp_closedown(s2);
247 exim_exit(EXIT_FAILURE);
248 }
249
250
251
252 /*************************************************
253 *             Create a log file                  *
254 *************************************************/
255
256 /* This function is called to create and open a log file. It may be called in a
257 subprocess when the original process is root.
258
259 Arguments:
260   name         the file name
261
262 The file name has been build in a working buffer, so it is permissible to
263 overwrite it temporarily if it is necessary to create the directory.
264
265 Returns:       a file descriptor, or < 0 on failure (errno set)
266 */
267
268 static int
269 log_open_already_exim(uschar * const name)
270 {
271 int fd = -1;
272 const int flags = O_WRONLY | O_APPEND | O_CREAT | O_NONBLOCK;
273
274 if (geteuid() != exim_uid)
275   {
276   errno = EACCES;
277   return -1;
278   }
279
280 fd = Uopen(name, flags, LOG_MODE);
281
282 /* If creation failed, attempt to build a log directory in case that is the
283 problem. */
284
285 if (fd < 0 && errno == ENOENT)
286   {
287   BOOL created;
288   uschar *lastslash = Ustrrchr(name, '/');
289   *lastslash = 0;
290   created = directory_make(NULL, name, LOG_DIRECTORY_MODE, FALSE);
291   DEBUG(D_any) debug_printf("%s log directory %s\n",
292     created ? "created" : "failed to create", name);
293   *lastslash = '/';
294   if (created) fd = Uopen(name, flags, LOG_MODE);
295   }
296
297 return fd;
298 }
299
300
301
302 /* Inspired by OpenSSH's mm_send_fd(). Thanks!
303 Send fd over socketpair.
304 Return: true iff good.
305 */
306
307 static BOOL
308 log_send_fd(const int sock, const int fd)
309 {
310 struct msghdr msg;
311 union {
312   struct cmsghdr hdr;
313   char buf[CMSG_SPACE(sizeof(int))];
314 } cmsgbuf;
315 struct cmsghdr *cmsg;
316 char ch = 'A';
317 struct iovec vec = {.iov_base = &ch, .iov_len = 1};
318 ssize_t n;
319
320 memset(&msg, 0, sizeof(msg));
321 memset(&cmsgbuf, 0, sizeof(cmsgbuf));
322 msg.msg_control = &cmsgbuf.buf;
323 msg.msg_controllen = sizeof(cmsgbuf.buf);
324
325 cmsg = CMSG_FIRSTHDR(&msg);
326 cmsg->cmsg_len = CMSG_LEN(sizeof(int));
327 cmsg->cmsg_level = SOL_SOCKET;
328 cmsg->cmsg_type = SCM_RIGHTS;
329 *(int *)CMSG_DATA(cmsg) = fd;
330
331 msg.msg_iov = &vec;
332 msg.msg_iovlen = 1;
333
334 while ((n = sendmsg(sock, &msg, 0)) == -1 && errno == EINTR);
335 return n == 1;
336 }
337
338 /* Inspired by OpenSSH's mm_receive_fd(). Thanks!
339 Return fd passed over socketpair, or -1 on error.
340 */
341
342 static int
343 log_recv_fd(const int sock)
344 {
345 struct msghdr msg;
346 union {
347   struct cmsghdr hdr;
348   char buf[CMSG_SPACE(sizeof(int))];
349 } cmsgbuf;
350 struct cmsghdr *cmsg;
351 char ch = '\0';
352 struct iovec vec = {.iov_base = &ch, .iov_len = 1};
353 ssize_t n;
354 int fd;
355
356 memset(&msg, 0, sizeof(msg));
357 msg.msg_iov = &vec;
358 msg.msg_iovlen = 1;
359
360 memset(&cmsgbuf, 0, sizeof(cmsgbuf));
361 msg.msg_control = &cmsgbuf.buf;
362 msg.msg_controllen = sizeof(cmsgbuf.buf);
363
364 while ((n = recvmsg(sock, &msg, 0)) == -1 && errno == EINTR) ;
365 if (n != 1 || ch != 'A') return -1;
366
367 if (!(cmsg = CMSG_FIRSTHDR(&msg))) return -1;
368 if (cmsg->cmsg_type != SCM_RIGHTS) return -1;
369 if ((fd = *(const int *)CMSG_DATA(cmsg)) < 0) return -1;
370 return fd;
371 }
372
373
374
375 /*************************************************
376 *     Create a log file as the exim user         *
377 *************************************************/
378
379 /* This function is called when we are root to spawn an exim:exim subprocess
380 in which we can create a log file. It must be signal-safe since it is called
381 by the usr1_handler().
382
383 Arguments:
384   name         the file name
385
386 Returns:       a file descriptor, or < 0 on failure (errno set)
387 */
388
389 int
390 log_open_as_exim(uschar * const name)
391 {
392 int fd = -1;
393 const uid_t euid = geteuid();
394
395 if (euid == exim_uid)
396   fd = log_open_already_exim(name);
397 else if (euid == root_uid)
398   {
399   int sock[2];
400   if (socketpair(AF_UNIX, SOCK_STREAM, 0, sock) == 0)
401     {
402     const pid_t pid = fork();
403     if (pid == 0)
404       {
405       (void)close(sock[0]);
406       if (  setgroups(1, &exim_gid) != 0
407          || setgid(exim_gid) != 0
408          || setuid(exim_uid) != 0
409
410          || getuid() != exim_uid || geteuid() != exim_uid
411          || getgid() != exim_gid || getegid() != exim_gid
412
413          || (fd = log_open_already_exim(name)) < 0
414          || !log_send_fd(sock[1], fd)
415          ) _exit(EXIT_FAILURE);
416       (void)close(sock[1]);
417       _exit(EXIT_SUCCESS);
418       }
419
420     (void)close(sock[1]);
421     if (pid > 0)
422       {
423       fd = log_recv_fd(sock[0]);
424       while (waitpid(pid, NULL, 0) == -1 && errno == EINTR);
425       }
426     (void)close(sock[0]);
427     }
428   }
429
430 if (fd >= 0)
431   {
432   int flags;
433   flags = fcntl(fd, F_GETFD);
434   if (flags != -1) (void)fcntl(fd, F_SETFD, flags | FD_CLOEXEC);
435   flags = fcntl(fd, F_GETFL);
436   if (flags != -1) (void)fcntl(fd, F_SETFL, flags & ~O_NONBLOCK);
437   }
438 else
439   errno = EACCES;
440
441 return fd;
442 }
443
444
445
446
447 /*************************************************
448 *                Open a log file                 *
449 *************************************************/
450
451 /* This function opens one of a number of logs, creating the log directory if
452 it does not exist. This may be called recursively on failure, in order to open
453 the panic log.
454
455 The directory is in the static variable file_path. This is static so that it
456 the work of sorting out the path is done just once per Exim process.
457
458 Exim is normally configured to avoid running as root wherever possible, the log
459 files must be owned by the non-privileged exim user. To ensure this, first try
460 an open without O_CREAT - most of the time this will succeed. If it fails, try
461 to create the file; if running as root, this must be done in a subprocess to
462 avoid races.
463
464 Arguments:
465   fd         where to return the resulting file descriptor
466   type       lt_main, lt_reject, lt_panic, or lt_debug
467   tag        optional tag to include in the name (only hooked up for debug)
468
469 Returns:   nothing
470 */
471
472 static void
473 open_log(int *fd, int type, uschar *tag)
474 {
475 uid_t euid;
476 BOOL ok, ok2;
477 uschar buffer[LOG_NAME_SIZE];
478
479 /* The names of the log files are controlled by file_path. The panic log is
480 written to the same directory as the main and reject logs, but its name does
481 not have a datestamp. The use of datestamps is indicated by %D/%M in file_path.
482 When opening the panic log, if %D or %M is present, we remove the datestamp
483 from the generated name; if it is at the start, remove a following
484 non-alphanumeric character as well; otherwise, remove a preceding
485 non-alphanumeric character. This is definitely kludgy, but it sort of does what
486 people want, I hope. */
487
488 ok = string_format(buffer, sizeof(buffer), CS file_path, log_names[type]);
489
490 switch (type)
491   {
492   case lt_main:
493     /* Save the name of the mainlog for rollover processing. Without a datestamp,
494     it gets statted to see if it has been cycled. With a datestamp, the datestamp
495     will be compared. The static slot for saving it is the same size as buffer,
496     and the text has been checked above to fit, so this use of strcpy() is OK. */
497     Ustrcpy(mainlog_name, buffer);
498     if (string_datestamp_offset > 0)
499       mainlog_datestamp = mainlog_name + string_datestamp_offset;
500   case lt_reject:
501     /* Ditto for the reject log */
502     Ustrcpy(rejectlog_name, buffer);
503     if (string_datestamp_offset > 0)
504       rejectlog_datestamp = rejectlog_name + string_datestamp_offset;
505   case lt_debug:
506     /* and deal with the debug log (which keeps the datestamp, but does not
507     update it) */
508     Ustrcpy(debuglog_name, buffer);
509     if (tag)
510       {
511       /* this won't change the offset of the datestamp */
512       ok2 = string_format(buffer, sizeof(buffer), "%s%s",
513         debuglog_name, tag);
514       if (ok2)
515         Ustrcpy(debuglog_name, buffer);
516       }
517   default:
518     /* Remove any datestamp if this is the panic log. This is rare, so there's no
519   need to optimize getting the datestamp length. We remove one non-alphanumeric
520   char afterwards if at the start, otherwise one before. */
521     if (string_datestamp_offset >= 0)
522       {
523       uschar * from = buffer + string_datestamp_offset;
524       uschar * to = from + string_datestamp_length;
525
526       if (from == buffer || from[-1] == '/')
527         {
528         if (!isalnum(*to)) to++;
529         }
530       else
531         if (!isalnum(from[-1])) from--;
532
533       /* This copy is ok, because we know that to is a substring of from. But
534       due to overlap we must use memmove() not Ustrcpy(). */
535       memmove(from, to, Ustrlen(to)+1);
536       }
537   }
538
539 /* If the file name is too long, it is an unrecoverable disaster */
540
541 if (!ok)
542   die(US"exim: log file path too long: aborting",
543       US"Logging failure; please try later");
544
545 /* We now have the file name. After a successful open, return. */
546
547 *fd = log_open_as_exim(buffer);
548
549 if (*fd >= 0)
550   {
551   return;
552   }
553
554 euid = geteuid();
555
556 /* Creation failed. There are some circumstances in which we get here when
557 the effective uid is not root or exim, which is the problem. (For example, a
558 non-setuid binary with log_arguments set, called in certain ways.) Rather than
559 just bombing out, force the log to stderr and carry on if stderr is available.
560 */
561
562 if (euid != root_uid && euid != exim_uid && log_stderr)
563   {
564   *fd = fileno(log_stderr);
565   return;
566   }
567
568 /* Otherwise this is a disaster. This call is deliberately ONLY to the panic
569 log. If possible, save a copy of the original line that was being logged. If we
570 are recursing (can't open the panic log either), the pointer will already be
571 set.  Also, when we had to use a subprocess for the create we didn't retrieve
572 errno from it, so get the error from the open attempt above (which is often
573 meaningful enough, so leave it). */
574
575 if (!panic_save_buffer)
576   if ((panic_save_buffer = US malloc(LOG_BUFFER_SIZE)))
577     memcpy(panic_save_buffer, log_buffer, LOG_BUFFER_SIZE);
578
579 log_write(0, LOG_PANIC_DIE, "Cannot open %s log file \"%s\": %s: "
580   "euid=%d egid=%d", log_names[type], buffer, strerror(errno), euid, getegid());
581 /* Never returns */
582 }
583
584
585 static void
586 unlink_log(int type)
587 {
588 if (type == lt_debug) unlink(CS debuglog_name);
589 }
590
591
592
593 /*************************************************
594 *     Add configuration file info to log line    *
595 *************************************************/
596
597 /* This is put in a function because it's needed twice (once for debugging,
598 once for real).
599
600 Arguments:
601   ptr         pointer to the end of the line we are building
602   flags       log flags
603
604 Returns:      updated pointer
605 */
606
607 static gstring *
608 log_config_info(gstring * g, int flags)
609 {
610 g = string_cat(g, US"Exim configuration error");
611
612 if (flags & (LOG_CONFIG_FOR & ~LOG_CONFIG))
613   return string_cat(g, US" for ");
614
615 if (flags & (LOG_CONFIG_IN & ~LOG_CONFIG))
616   g = string_fmt_append(g, " in line %d of %s", config_lineno, config_filename);
617
618 return string_catn(g, US":\n  ", 4);
619 }
620
621
622 /*************************************************
623 *           A write() operation failed           *
624 *************************************************/
625
626 /* This function is called when write() fails on anything other than the panic
627 log, which can happen if a disk gets full or a file gets too large or whatever.
628 We try to save the relevant message in the panic_save buffer before crashing
629 out.
630
631 The potential invoker should probably not call us for EINTR -1 writes.  But
632 otherwise, short writes are bad as we don't do non-blocking writes to fds
633 subject to flow control.  (If we do, that's new and the logic of this should
634 be reconsidered).
635
636 Arguments:
637   name      the name of the log being written
638   length    the string length being written
639   rc        the return value from write()
640
641 Returns:    does not return
642 */
643
644 static void
645 log_write_failed(uschar *name, int length, int rc)
646 {
647 int save_errno = errno;
648
649 if (!panic_save_buffer)
650   if ((panic_save_buffer = US malloc(LOG_BUFFER_SIZE)))
651     memcpy(panic_save_buffer, log_buffer, LOG_BUFFER_SIZE);
652
653 log_write(0, LOG_PANIC_DIE, "failed to write to %s: length=%d result=%d "
654   "errno=%d (%s)", name, length, rc, save_errno,
655   (save_errno == 0)? "write incomplete" : strerror(save_errno));
656 /* Never returns */
657 }
658
659
660
661 /*************************************************
662 *     Write to an fd, retrying after signals     *
663 *************************************************/
664
665 /* Basic write to fd for logs, handling EINTR.
666
667 Arguments:
668   fd        the fd to write to
669   buf       the string to write
670   length    the string length being written
671
672 Returns:
673   length actually written, persisting an errno from write()
674 */
675 ssize_t
676 write_to_fd_buf(int fd, const uschar *buf, size_t length)
677 {
678 ssize_t wrote;
679 size_t total_written = 0;
680 const uschar *p = buf;
681 size_t left = length;
682
683 while (1)
684   {
685   wrote = write(fd, p, left);
686   if (wrote == (ssize_t)-1)
687     {
688     if (errno == EINTR) continue;
689     return wrote;
690     }
691   total_written += wrote;
692   if (wrote == left)
693     break;
694   else
695     {
696     p += wrote;
697     left -= wrote;
698     }
699   }
700 return total_written;
701 }
702
703
704 void
705 set_file_path(BOOL *multiple)
706 {
707 uschar *s;
708 int sep = ':';              /* Fixed separator - outside use */
709 const uschar *ss = *log_file_path ? log_file_path : US LOG_FILE_PATH;
710
711 logging_mode = 0;
712 while ((s = string_nextinlist(&ss, &sep, log_buffer, LOG_BUFFER_SIZE)))
713   {
714   if (Ustrcmp(s, "syslog") == 0)
715     logging_mode |= LOG_MODE_SYSLOG;
716   else if (logging_mode & LOG_MODE_FILE)  /* we know a file already */
717     {
718     if (multiple) *multiple = TRUE;
719     }
720   else
721     {
722     logging_mode |= LOG_MODE_FILE;
723
724     /* If a non-empty path is given, use it */
725
726     if (*s)
727       file_path = string_copy(s);
728
729     /* If the path is empty, we want to use the first non-empty, non-
730     syslog item in LOG_FILE_PATH, if there is one, since the value of
731     log_file_path may have been set at runtime. If there is no such item,
732     use the ultimate default in the spool directory. */
733     }
734   }
735 }
736
737
738 void
739 mainlog_close(void)
740 {
741 /* avoid closing it if it is closed already or if we do not see a chance
742 to open the file mainlog later again */
743 if (mainlogfd < 0 /* already closed */
744    || !(geteuid() == 0 || geteuid() == exim_uid))
745   return;
746 (void)close(mainlogfd);
747 mainlogfd = -1;
748 mainlog_inode = 0;
749 }
750
751 /*************************************************
752 *            Write message to log file           *
753 *************************************************/
754
755 /* Exim can be configured to log to local files, or use syslog, or both. This
756 is controlled by the setting of log_file_path. The following cases are
757 recognized:
758
759   log_file_path = ""               write files in the spool/log directory
760   log_file_path = "xxx"            write files in the xxx directory
761   log_file_path = "syslog"         write to syslog
762   log_file_path = "syslog : xxx"   write to syslog and to files (any order)
763
764 The message always gets '\n' added on the end of it, since more than one
765 process may be writing to the log at once and we don't want intermingling to
766 happen in the middle of lines. To be absolutely sure of this we write the data
767 into a private buffer and then put it out in a single write() call.
768
769 The flags determine which log(s) the message is written to, or for syslogging,
770 which priority to use, and in the case of the panic log, whether the process
771 should die afterwards.
772
773 The variable really_exim is TRUE only when exim is running in privileged state
774 (i.e. not with a changed configuration or with testing options such as -brw).
775 If it is not, don't try to write to the log because permission will probably be
776 denied.
777
778 Avoid actually writing to the logs when exim is called with -bv or -bt to
779 test an address, but take other actions, such as panicking.
780
781 In Exim proper, the buffer for building the message is got at start-up, so that
782 nothing gets done if it can't be got. However, some functions that are also
783 used in utilities occasionally obey log_write calls in error situations, and it
784 is simplest to put a single malloc() here rather than put one in each utility.
785 Malloc is used directly because the store functions may call log_write().
786
787 If a message_id exists, we include it after the timestamp.
788
789 Arguments:
790   selector  write to main log or LOG_INFO only if this value is zero, or if
791               its bit is set in log_selector[0]
792   flags     each bit indicates some independent action:
793               LOG_SENDER      add raw sender to the message
794               LOG_RECIPIENTS  add raw recipients list to message
795               LOG_CONFIG      add "Exim configuration error"
796               LOG_CONFIG_FOR  add " for " instead of ":\n  "
797               LOG_CONFIG_IN   add " in line x[ of file y]"
798               LOG_MAIN        write to main log or syslog LOG_INFO
799               LOG_REJECT      write to reject log or syslog LOG_NOTICE
800               LOG_PANIC       write to panic log or syslog LOG_ALERT
801               LOG_PANIC_DIE   write to panic log or LOG_ALERT and then crash
802   format    a printf() format
803   ...       arguments for format
804
805 Returns:    nothing
806 */
807
808 void
809 log_write(unsigned int selector, int flags, const char *format, ...)
810 {
811 int paniclogfd;
812 ssize_t written_len;
813 gstring gs = { .size = LOG_BUFFER_SIZE-1, .ptr = 0, .s = log_buffer };
814 gstring * g;
815 va_list ap;
816
817 /* If panic_recurseflag is set, we have failed to open the panic log. This is
818 the ultimate disaster. First try to write the message to a debug file and/or
819 stderr and also to syslog. If panic_save_buffer is not NULL, it contains the
820 original log line that caused the problem. Afterwards, expire. */
821
822 if (panic_recurseflag)
823   {
824   uschar *extra = panic_save_buffer ? panic_save_buffer : US"";
825   if (debug_file) debug_printf("%s%s", extra, log_buffer);
826   if (log_stderr && log_stderr != debug_file)
827     fprintf(log_stderr, "%s%s", extra, log_buffer);
828   if (*extra) write_syslog(LOG_CRIT, extra);
829   write_syslog(LOG_CRIT, log_buffer);
830   die(US"exim: could not open panic log - aborting: see message(s) above",
831     US"Unexpected log failure, please try later");
832   }
833
834 /* Ensure we have a buffer (see comment above); this should never be obeyed
835 when running Exim proper, only when running utilities. */
836
837 if (!log_buffer)
838   if (!(log_buffer = US malloc(LOG_BUFFER_SIZE)))
839     {
840     fprintf(stderr, "exim: failed to get store for log buffer\n");
841     exim_exit(EXIT_FAILURE);
842     }
843
844 /* If we haven't already done so, inspect the setting of log_file_path to
845 determine whether to log to files and/or to syslog. Bits in logging_mode
846 control this, and for file logging, the path must end up in file_path. This
847 variable must be in permanent store because it may be required again later in
848 the process. */
849
850 if (!path_inspected)
851   {
852   BOOL multiple = FALSE;
853   int old_pool = store_pool;
854
855   store_pool = POOL_PERM;
856
857   /* If nothing has been set, don't waste effort... the default values for the
858   statics are file_path="" and logging_mode = LOG_MODE_FILE. */
859
860   if (*log_file_path) set_file_path(&multiple);
861
862   /* If no modes have been selected, it is a major disaster */
863
864   if (logging_mode == 0)
865     die(US"Neither syslog nor file logging set in log_file_path",
866         US"Unexpected logging failure");
867
868   /* Set up the ultimate default if necessary. Then revert to the old store
869   pool, and record that we've sorted out the path. */
870
871   if (logging_mode & LOG_MODE_FILE  &&  !file_path[0])
872     file_path = string_sprintf("%s/log/%%slog", spool_directory);
873   store_pool = old_pool;
874   path_inspected = TRUE;
875
876   /* If more than one file path was given, log a complaint. This recursive call
877   should work since we have now set up the routing. */
878
879   if (multiple)
880     log_write(0, LOG_MAIN|LOG_PANIC,
881       "More than one path given in log_file_path: using %s", file_path);
882   }
883
884 /* If debugging, show all log entries, but don't show headers. Do it all
885 in one go so that it doesn't get split when multi-processing. */
886
887 DEBUG(D_any|D_v)
888   {
889   int i;
890
891   g = string_catn(&gs, US"LOG:", 4);
892
893   /* Show the selector that was passed into the call. */
894
895   for (i = 0; i < log_options_count; i++)
896     {
897     unsigned int bitnum = log_options[i].bit;
898     if (bitnum < BITWORDSIZE && selector == BIT(bitnum))
899       g = string_fmt_append(g, " %s", log_options[i].name);
900     }
901
902   g = string_fmt_append(g, "%s%s%s%s\n  ",
903     flags & LOG_MAIN ?    " MAIN"   : "",
904     flags & LOG_PANIC ?   " PANIC"  : "",
905     (flags & LOG_PANIC_DIE) == LOG_PANIC_DIE ? " DIE" : "",
906     flags & LOG_REJECT ?  " REJECT" : "");
907
908   if (flags & LOG_CONFIG) g = log_config_info(g, flags);
909
910   /* We want to be able to log tainted info, but log_buffer is directly
911   malloc'd.  So use deliberately taint-nonchecking routines to build into
912   it, trusting that we will never expand the results. */
913
914   va_start(ap, format);
915   i = g->ptr;
916   if (!string_vformat(g, SVFMT_TAINT_NOCHK, format, ap))
917     {
918     g->ptr = i;
919     g = string_cat(g, US"**** log string overflowed log buffer ****");
920     }
921   va_end(ap);
922
923   g->size = LOG_BUFFER_SIZE;
924   g = string_catn(g, US"\n", 1);
925   debug_printf("%s", string_from_gstring(g));
926
927   gs.size = LOG_BUFFER_SIZE-1;  /* Having used the buffer for debug output, */
928   gs.ptr = 0;                   /* reset it for the real use. */
929   gs.s = log_buffer;
930   }
931 /* If no log file is specified, we are in a mess. */
932
933 if (!(flags & (LOG_MAIN|LOG_PANIC|LOG_REJECT)))
934   log_write(0, LOG_MAIN|LOG_PANIC_DIE, "log_write called with no log "
935     "flags set");
936
937 /* There are some weird circumstances in which logging is disabled. */
938
939 if (f.disable_logging)
940   {
941   DEBUG(D_any) debug_printf("log writing disabled\n");
942   if ((flags & LOG_PANIC_DIE) == LOG_PANIC_DIE) exim_exit(EXIT_FAILURE);
943   return;
944   }
945
946 /* Handle disabled reject log */
947
948 if (!write_rejectlog) flags &= ~LOG_REJECT;
949
950 /* Create the main message in the log buffer. Do not include the message id
951 when called by a utility. */
952
953 g = string_fmt_append(&gs, "%s ", tod_stamp(tod_log));
954
955 if (LOGGING(pid))
956   {
957   if (!syslog_pid) pid_position[0] = g->ptr;            /* remember begin â€¦ */
958   g = string_fmt_append(g, "[%d] ", (int)getpid());
959   if (!syslog_pid) pid_position[1] = g->ptr;            /*  â€¦ and end+1 of the PID */
960   }
961
962 if (f.really_exim && message_id[0] != 0)
963   g = string_fmt_append(g, "%s ", message_id);
964
965 if (flags & LOG_CONFIG)
966   g = log_config_info(g, flags);
967
968 va_start(ap, format);
969   {
970   int i = g->ptr;
971
972   /* We want to be able to log tainted info, but log_buffer is directly
973   malloc'd.  So use deliberately taint-nonchecking routines to build into
974   it, trusting that we will never expand the results. */
975
976   if (!string_vformat(g, SVFMT_TAINT_NOCHK, format, ap))
977     {
978     g->ptr = i;
979     g = string_cat(g, US"**** log string overflowed log buffer ****\n");
980     }
981   }
982 va_end(ap);
983
984 /* Add the raw, unrewritten, sender to the message if required. This is done
985 this way because it kind of fits with LOG_RECIPIENTS. */
986
987 if (   flags & LOG_SENDER
988    && g->ptr < LOG_BUFFER_SIZE - 10 - Ustrlen(raw_sender))
989   g = string_fmt_append_f(g, SVFMT_TAINT_NOCHK, " from <%s>", raw_sender);
990
991 /* Add list of recipients to the message if required; the raw list,
992 before rewriting, was saved in raw_recipients. There may be none, if an ACL
993 discarded them all. */
994
995 if (  flags & LOG_RECIPIENTS
996    && g->ptr < LOG_BUFFER_SIZE - 6
997    && raw_recipients_count > 0)
998   {
999   int i;
1000   g = string_fmt_append_f(g, SVFMT_TAINT_NOCHK, " for", NULL);
1001   for (i = 0; i < raw_recipients_count; i++)
1002     {
1003     uschar * s = raw_recipients[i];
1004     if (LOG_BUFFER_SIZE - g->ptr < Ustrlen(s) + 3) break;
1005     g = string_fmt_append_f(g, SVFMT_TAINT_NOCHK, " %s", s);
1006     }
1007   }
1008
1009 g = string_catn(g, US"\n", 1);
1010 string_from_gstring(g);
1011
1012 /* Handle loggable errors when running a utility, or when address testing.
1013 Write to log_stderr unless debugging (when it will already have been written),
1014 or unless there is no log_stderr (expn called from daemon, for example). */
1015
1016 if (!f.really_exim || f.log_testing_mode)
1017   {
1018   if (  !debug_selector
1019      && log_stderr
1020      && (selector == 0 || (selector & log_selector[0]) != 0)
1021     )
1022     if (host_checking)
1023       fprintf(log_stderr, "LOG: %s", CS(log_buffer + 20));  /* no timestamp */
1024     else
1025       fprintf(log_stderr, "%s", CS log_buffer);
1026
1027   if ((flags & LOG_PANIC_DIE) == LOG_PANIC_DIE) exim_exit(EXIT_FAILURE);
1028   return;
1029   }
1030
1031 /* Handle the main log. We know that either syslog or file logging (or both) is
1032 set up. A real file gets left open during reception or delivery once it has
1033 been opened, but we don't want to keep on writing to it for too long after it
1034 has been renamed. Therefore, do a stat() and see if the inode has changed, and
1035 if so, re-open. */
1036
1037 if (  flags & LOG_MAIN
1038    && (!selector ||  selector & log_selector[0]))
1039   {
1040   if (  logging_mode & LOG_MODE_SYSLOG
1041      && (syslog_duplication || !(flags & (LOG_REJECT|LOG_PANIC))))
1042     write_syslog(LOG_INFO, log_buffer);
1043
1044   if (logging_mode & LOG_MODE_FILE)
1045     {
1046     struct stat statbuf;
1047
1048     /* Check for a change to the mainlog file name when datestamping is in
1049     operation. This happens at midnight, at which point we want to roll over
1050     the file. Closing it has the desired effect. */
1051
1052     if (mainlog_datestamp)
1053       {
1054       uschar *nowstamp = tod_stamp(string_datestamp_type);
1055       if (Ustrncmp (mainlog_datestamp, nowstamp, Ustrlen(nowstamp)) != 0)
1056         {
1057         (void)close(mainlogfd);       /* Close the file */
1058         mainlogfd = -1;               /* Clear the file descriptor */
1059         mainlog_inode = 0;            /* Unset the inode */
1060         mainlog_datestamp = NULL;     /* Clear the datestamp */
1061         }
1062       }
1063
1064     /* Otherwise, we want to check whether the file has been renamed by a
1065     cycling script. This could be "if else", but for safety's sake, leave it as
1066     "if" so that renaming the log starts a new file even when datestamping is
1067     happening. */
1068
1069     if (mainlogfd >= 0)
1070       if (Ustat(mainlog_name, &statbuf) < 0 || statbuf.st_ino != mainlog_inode)
1071         mainlog_close();
1072
1073     /* If the log is closed, open it. Then write the line. */
1074
1075     if (mainlogfd < 0)
1076       {
1077       open_log(&mainlogfd, lt_main, NULL);     /* No return on error */
1078       if (fstat(mainlogfd, &statbuf) >= 0) mainlog_inode = statbuf.st_ino;
1079       }
1080
1081     /* Failing to write to the log is disastrous */
1082
1083     written_len = write_to_fd_buf(mainlogfd, g->s, g->ptr);
1084     if (written_len != g->ptr)
1085       {
1086       log_write_failed(US"main log", g->ptr, written_len);
1087       /* That function does not return */
1088       }
1089     }
1090   }
1091
1092 /* Handle the log for rejected messages. This can be globally disabled, in
1093 which case the flags are altered above. If there are any header lines (i.e. if
1094 the rejection is happening after the DATA phase), log the recipients and the
1095 headers. */
1096
1097 if (flags & LOG_REJECT)
1098   {
1099   if (header_list && LOGGING(rejected_header))
1100     {
1101     gstring * g2;
1102     int i;
1103
1104     if (recipients_count > 0)
1105       {
1106       /* List the sender */
1107
1108       g2 = string_fmt_append_f(g, SVFMT_TAINT_NOCHK,
1109                         "Envelope-from: <%s>\n", sender_address);
1110       if (g2) g = g2;
1111
1112       /* List up to 5 recipients */
1113
1114       g2 = string_fmt_append_f(g, SVFMT_TAINT_NOCHK,
1115                         "Envelope-to: <%s>\n", recipients_list[0].address);
1116       if (g2) g = g2;
1117
1118       for (i = 1; i < recipients_count && i < 5; i++)
1119         {
1120         g2 = string_fmt_append_f(g, SVFMT_TAINT_NOCHK,
1121                         "    <%s>\n", recipients_list[i].address);
1122         if (g2) g = g2;
1123         }
1124
1125       if (i < recipients_count)
1126         {
1127         g2 = string_fmt_append_f(g, SVFMT_TAINT_NOCHK, "    ...\n", NULL);
1128         if (g2) g = g2;
1129         }
1130       }
1131
1132     /* A header with a NULL text is an unfilled in Received: header */
1133
1134     for (header_line * h = header_list; h; h = h->next) if (h->text)
1135       {
1136       g2 = string_fmt_append_f(g, SVFMT_TAINT_NOCHK,
1137                         "%c %s", h->type, h->text);
1138       if (g2)
1139         g = g2;
1140       else              /* Buffer is full; truncate */
1141         {
1142         g->ptr -= 100;        /* For message and separator */
1143         if (g->s[g->ptr-1] == '\n') g->ptr--;
1144         g = string_cat(g, US"\n*** truncated ***\n");
1145         break;
1146         }
1147       }
1148     }
1149
1150   /* Write to syslog or to a log file */
1151
1152   if (  logging_mode & LOG_MODE_SYSLOG
1153      && (syslog_duplication || !(flags & LOG_PANIC)))
1154     write_syslog(LOG_NOTICE, string_from_gstring(g));
1155
1156   /* Check for a change to the rejectlog file name when datestamping is in
1157   operation. This happens at midnight, at which point we want to roll over
1158   the file. Closing it has the desired effect. */
1159
1160   if (logging_mode & LOG_MODE_FILE)
1161     {
1162     struct stat statbuf;
1163
1164     if (rejectlog_datestamp)
1165       {
1166       uschar *nowstamp = tod_stamp(string_datestamp_type);
1167       if (Ustrncmp (rejectlog_datestamp, nowstamp, Ustrlen(nowstamp)) != 0)
1168         {
1169         (void)close(rejectlogfd);       /* Close the file */
1170         rejectlogfd = -1;               /* Clear the file descriptor */
1171         rejectlog_inode = 0;            /* Unset the inode */
1172         rejectlog_datestamp = NULL;     /* Clear the datestamp */
1173         }
1174       }
1175
1176     /* Otherwise, we want to check whether the file has been renamed by a
1177     cycling script. This could be "if else", but for safety's sake, leave it as
1178     "if" so that renaming the log starts a new file even when datestamping is
1179     happening. */
1180
1181     if (rejectlogfd >= 0)
1182       if (Ustat(rejectlog_name, &statbuf) < 0 ||
1183            statbuf.st_ino != rejectlog_inode)
1184         {
1185         (void)close(rejectlogfd);
1186         rejectlogfd = -1;
1187         rejectlog_inode = 0;
1188         }
1189
1190     /* Open the file if necessary, and write the data */
1191
1192     if (rejectlogfd < 0)
1193       {
1194       open_log(&rejectlogfd, lt_reject, NULL); /* No return on error */
1195       if (fstat(rejectlogfd, &statbuf) >= 0) rejectlog_inode = statbuf.st_ino;
1196       }
1197
1198     written_len = write_to_fd_buf(rejectlogfd, g->s, g->ptr);
1199     if (written_len != g->ptr)
1200       {
1201       log_write_failed(US"reject log", g->ptr, written_len);
1202       /* That function does not return */
1203       }
1204     }
1205   }
1206
1207
1208 /* Handle the panic log, which is not kept open like the others. If it fails to
1209 open, there will be a recursive call to log_write(). We detect this above and
1210 attempt to write to the system log as a last-ditch try at telling somebody. In
1211 all cases except mua_wrapper, try to write to log_stderr. */
1212
1213 if (flags & LOG_PANIC)
1214   {
1215   if (log_stderr && log_stderr != debug_file && !mua_wrapper)
1216     fprintf(log_stderr, "%s", CS string_from_gstring(g));
1217
1218   if (logging_mode & LOG_MODE_SYSLOG)
1219     write_syslog(LOG_ALERT, log_buffer);
1220
1221   /* If this panic logging was caused by a failure to open the main log,
1222   the original log line is in panic_save_buffer. Make an attempt to write it. */
1223
1224   if (logging_mode & LOG_MODE_FILE)
1225     {
1226     panic_recurseflag = TRUE;
1227     open_log(&paniclogfd, lt_panic, NULL);  /* Won't return on failure */
1228     panic_recurseflag = FALSE;
1229
1230     if (panic_save_buffer)
1231       (void) write(paniclogfd, panic_save_buffer, Ustrlen(panic_save_buffer));
1232
1233     written_len = write_to_fd_buf(paniclogfd, g->s, g->ptr);
1234     if (written_len != g->ptr)
1235       {
1236       int save_errno = errno;
1237       write_syslog(LOG_CRIT, log_buffer);
1238       sprintf(CS log_buffer, "write failed on panic log: length=%d result=%d "
1239         "errno=%d (%s)", g->ptr, (int)written_len, save_errno, strerror(save_errno));
1240       write_syslog(LOG_CRIT, string_from_gstring(g));
1241       flags |= LOG_PANIC_DIE;
1242       }
1243
1244     (void)close(paniclogfd);
1245     }
1246
1247   /* Give up if the DIE flag is set */
1248
1249   if ((flags & LOG_PANIC_DIE) != LOG_PANIC)
1250     die(NULL, US"Unexpected failure, please try later");
1251   }
1252 }
1253
1254
1255
1256 /*************************************************
1257 *            Close any open log files            *
1258 *************************************************/
1259
1260 void
1261 log_close_all(void)
1262 {
1263 if (mainlogfd >= 0)
1264   { (void)close(mainlogfd); mainlogfd = -1; }
1265 if (rejectlogfd >= 0)
1266   { (void)close(rejectlogfd); rejectlogfd = -1; }
1267 closelog();
1268 syslog_open = FALSE;
1269 }
1270
1271
1272
1273 /*************************************************
1274 *             Multi-bit set or clear             *
1275 *************************************************/
1276
1277 /* These functions take a list of bit indexes (terminated by -1) and
1278 clear or set the corresponding bits in the selector.
1279
1280 Arguments:
1281   selector       address of the bit string
1282   selsize        number of words in the bit string
1283   bits           list of bits to set
1284 */
1285
1286 void
1287 bits_clear(unsigned int *selector, size_t selsize, int *bits)
1288 {
1289 for(; *bits != -1; ++bits)
1290   BIT_CLEAR(selector, selsize, *bits);
1291 }
1292
1293 void
1294 bits_set(unsigned int *selector, size_t selsize, int *bits)
1295 {
1296 for(; *bits != -1; ++bits)
1297   BIT_SET(selector, selsize, *bits);
1298 }
1299
1300
1301
1302 /*************************************************
1303 *         Decode bit settings for log/debug      *
1304 *************************************************/
1305
1306 /* This function decodes a string containing bit settings in the form of +name
1307 and/or -name sequences, and sets/unsets bits in a bit string accordingly. It
1308 also recognizes a numeric setting of the form =<number>, but this is not
1309 intended for user use. It's an easy way for Exim to pass the debug settings
1310 when it is re-exec'ed.
1311
1312 The option table is a list of names and bit indexes. The index -1
1313 means "set all bits, except for those listed in notall". The notall
1314 list is terminated by -1.
1315
1316 The action taken for bad values varies depending upon why we're here.
1317 For log messages, or if the debugging is triggered from config, then we write
1318 to the log on the way out.  For debug setting triggered from the command-line,
1319 we treat it as an unknown option: error message to stderr and die.
1320
1321 Arguments:
1322   selector       address of the bit string
1323   selsize        number of words in the bit string
1324   notall         list of bits to exclude from "all"
1325   string         the configured string
1326   options        the table of option names
1327   count          size of table
1328   which          "log" or "debug"
1329   flags          DEBUG_FROM_CONFIG
1330
1331 Returns:         nothing on success - bomb out on failure
1332 */
1333
1334 void
1335 decode_bits(unsigned int *selector, size_t selsize, int *notall,
1336   uschar *string, bit_table *options, int count, uschar *which, int flags)
1337 {
1338 uschar *errmsg;
1339 if (!string) return;
1340
1341 if (*string == '=')
1342   {
1343   char *end;    /* Not uschar */
1344   memset(selector, 0, sizeof(*selector)*selsize);
1345   *selector = strtoul(CS string+1, &end, 0);
1346   if (!*end) return;
1347   errmsg = string_sprintf("malformed numeric %s_selector setting: %s", which,
1348     string);
1349   goto ERROR_RETURN;
1350   }
1351
1352 /* Handle symbolic setting */
1353
1354 else for(;;)
1355   {
1356   BOOL adding;
1357   uschar *s;
1358   int len;
1359   bit_table *start, *end;
1360
1361   Uskip_whitespace(&string);
1362   if (!*string) return;
1363
1364   if (*string != '+' && *string != '-')
1365     {
1366     errmsg = string_sprintf("malformed %s_selector setting: "
1367       "+ or - expected but found \"%s\"", which, string);
1368     goto ERROR_RETURN;
1369     }
1370
1371   adding = *string++ == '+';
1372   s = string;
1373   while (isalnum(*string) || *string == '_') string++;
1374   len = string - s;
1375
1376   start = options;
1377   end = options + count;
1378
1379   while (start < end)
1380     {
1381     bit_table *middle = start + (end - start)/2;
1382     int c = Ustrncmp(s, middle->name, len);
1383     if (c == 0)
1384       if (middle->name[len] != 0) c = -1; else
1385         {
1386         unsigned int bit = middle->bit;
1387
1388         if (bit == -1)
1389           {
1390           if (adding)
1391             {
1392             memset(selector, -1, sizeof(*selector)*selsize);
1393             bits_clear(selector, selsize, notall);
1394             }
1395           else
1396             memset(selector, 0, sizeof(*selector)*selsize);
1397           }
1398         else if (adding)
1399           BIT_SET(selector, selsize, bit);
1400         else
1401           BIT_CLEAR(selector, selsize, bit);
1402
1403         break;  /* Out of loop to match selector name */
1404         }
1405     if (c < 0) end = middle; else start = middle + 1;
1406     }  /* Loop to match selector name */
1407
1408   if (start >= end)
1409     {
1410     errmsg = string_sprintf("unknown %s_selector setting: %c%.*s", which,
1411       adding? '+' : '-', len, s);
1412     goto ERROR_RETURN;
1413     }
1414   }    /* Loop for selector names */
1415
1416 /* Handle disasters */
1417
1418 ERROR_RETURN:
1419 if (Ustrcmp(which, "debug") == 0)
1420   {
1421   if (flags & DEBUG_FROM_CONFIG)
1422     {
1423     log_write(0, LOG_CONFIG|LOG_PANIC, "%s", errmsg);
1424     return;
1425     }
1426   fprintf(stderr, "exim: %s\n", errmsg);
1427   exit(EXIT_FAILURE);
1428   }
1429 else log_write(0, LOG_CONFIG|LOG_PANIC_DIE, "%s", errmsg);
1430 }
1431
1432
1433
1434 /*************************************************
1435 *        Activate a debug logfile (late)         *
1436 *************************************************/
1437
1438 /* Normally, debugging is activated from the command-line; it may be useful
1439 within the configuration to activate debugging later, based on certain
1440 conditions.  If debugging is already in progress, we return early, no action
1441 taken (besides debug-logging that we wanted debug-logging).
1442
1443 Failures in options are not fatal but will result in paniclog entries for the
1444 misconfiguration.
1445
1446 The first use of this is in ACL logic, "control = debug/tag=foo/opts=+expand"
1447 which can be combined with conditions, etc, to activate extra logging only
1448 for certain sources. The second use is inetd wait mode debug preservation. */
1449
1450 void
1451 debug_logging_activate(uschar *tag_name, uschar *opts)
1452 {
1453 int fd = -1;
1454
1455 if (debug_file)
1456   {
1457   debug_printf("DEBUGGING ACTIVATED FROM WITHIN CONFIG.\n"
1458       "DEBUG: Tag=\"%s\" opts=\"%s\"\n", tag_name, opts ? opts : US"");
1459   return;
1460   }
1461
1462 if (tag_name != NULL && (Ustrchr(tag_name, '/') != NULL))
1463   {
1464   log_write(0, LOG_MAIN|LOG_PANIC, "debug tag may not contain a '/' in: %s",
1465       tag_name);
1466   return;
1467   }
1468
1469 debug_selector = D_default;
1470 if (opts)
1471   decode_bits(&debug_selector, 1, debug_notall, opts,
1472       debug_options, debug_options_count, US"debug", DEBUG_FROM_CONFIG);
1473
1474 /* When activating from a transport process we may never have logged at all
1475 resulting in certain setup not having been done.  Hack this for now so we
1476 do not segfault; note that nondefault log locations will not work */
1477
1478 if (!*file_path) set_file_path(NULL);
1479
1480 open_log(&fd, lt_debug, tag_name);
1481
1482 if (fd != -1)
1483   debug_file = fdopen(fd, "w");
1484 else
1485   log_write(0, LOG_MAIN|LOG_PANIC, "unable to open debug log");
1486 }
1487
1488
1489 void
1490 debug_logging_stop(void)
1491 {
1492 if (!debug_file || !debuglog_name[0]) return;
1493
1494 debug_selector = 0;
1495 fclose(debug_file);
1496 debug_file = NULL;
1497 unlink_log(lt_debug);
1498 }
1499
1500 void
1501 open_logs(void)
1502 {
1503 set_file_path(NULL);
1504 open_log(&mainlogfd, lt_main, 0);
1505 open_log(&rejectlogfd, lt_reject, 0);
1506 }
1507
1508 /* End of log.c */