1 /* $Cambridge: exim/src/src/queue.c,v 1.11 2007/01/08 10:50:18 ph10 Exp $ */
3 /*************************************************
4 * Exim - an Internet mail transport agent *
5 *************************************************/
7 /* Copyright (c) University of Cambridge 1995 - 2007 */
8 /* See the file NOTICE for conditions of use and distribution. */
10 /* Functions that operate on the input queue. */
17 /* The number of nodes to use for the bottom-up merge sort when a list of queue
18 items is to be ordered. The code for this sort was contributed as a patch by
21 #define LOG2_MAXNODES 32
25 /*************************************************
26 * Helper sort function for queue_get_spool_list *
27 *************************************************/
29 /* This function is used when sorting the queue list in the function
30 queue_get_spool_list() below.
33 a points to an ordered list of queue_filename items
34 b points to another ordered list
36 Returns: a pointer to a merged ordered list
39 static queue_filename *
40 merge_queue_lists(queue_filename *a, queue_filename *b)
42 queue_filename *first = NULL;
43 queue_filename **append = &first;
45 while (a != NULL && b != NULL)
47 if (Ustrcmp(a->text, b->text) < 0)
61 *append=((a != NULL)? a : b);
69 /*************************************************
70 * Get list of spool files *
71 *************************************************/
73 /* Scan the spool directory and return a list of the relevant file names
74 therein. Single-character sub-directories are handled as follows:
76 If the first argument is > 0, a sub-directory is scanned; the letter is
77 taken from the nth entry in subdirs.
79 If the first argument is 0, sub-directories are not scanned. However, a
80 list of them is returned.
82 If the first argument is < 0, sub-directories are scanned for messages,
83 and a single, unified list is created. The returned data blocks contain the
84 identifying character of the subdirectory, if any. The subdirs vector is
85 still required as an argument.
87 If the randomize argument is TRUE, messages are returned in "randomized" order.
88 Actually, the order is anything but random, but the algorithm is cheap, and the
89 point is simply to ensure that the same order doesn't occur every time, in case
90 a particular message is causing a remote MTA to barf - we would like to try
91 other messages to that MTA first.
93 If the randomize argument is FALSE, sort the list according to the file name.
94 This should give the order in which the messages arrived. It is normally used
95 only for presentation to humans, in which case the (possibly expensive) sort
96 that it does is not part of the normal operational code. However, if
97 queue_run_in_order is set, sorting has to take place for queue runs as well.
98 When randomize is FALSE, the first argument is normally -1, so all messages are
102 subdiroffset sub-directory character offset, or 0 or -1 (see above)
103 subdirs vector to store list of subdirchars
104 subcount pointer to int in which to store count of subdirs
105 randomize TRUE if the order of the list is to be unpredictable
107 Returns: pointer to a chain of queue name items
110 static queue_filename *
111 queue_get_spool_list(int subdiroffset, uschar *subdirs, int *subcount,
118 queue_filename *yield = NULL;
119 queue_filename *last = NULL;
123 queue_filename *root[LOG2_MAXNODES];
125 /* When randomizing, the file names are added to the start or end of the list
126 according to the bits of the flags variable. Get a collection of bits from the
127 current time. Use the bottom 16 and just keep re-using them if necessary. When
128 not randomizing, initialize the sublists for the bottom-up merge sort. */
130 if (randomize) resetflags = time(NULL) & 0xFFFF;
131 else for (i = 0; i < LOG2_MAXNODES; i++) root[i] = NULL;
133 /* If processing the full queue, or just the top-level, start at the base
134 directory, and initialize the first subdirectory name (as none). Otherwise,
135 start at the sub-directory offset. */
137 if (subdiroffset <= 0)
143 else i = subdiroffset;
145 /* Set up prototype for the directory name. */
147 sprintf(CS buffer, "%s/input", spool_directory);
148 subptr = Ustrlen(buffer);
149 buffer[subptr+2] = 0; /* terminator for lengthened name */
151 /* This loop runs at least once, for the main or given directory, and then as
152 many times as necessary to scan any subdirectories encountered in the main
153 directory, if they are to be scanned at this time. */
155 for (; i <= *subcount; i++)
158 int subdirchar = subdirs[i]; /* 0 for main directory */
162 buffer[subptr] = '/';
163 buffer[subptr+1] = subdirchar;
166 dd = opendir(CS buffer);
167 if (dd == NULL) continue;
169 /* Now scan the directory. */
171 while ((ent = readdir(dd)) != NULL)
173 uschar *name = US ent->d_name;
174 int len = Ustrlen(name);
180 /* If we find a single alphameric sub-directory in the base directory,
181 add it to the list for subsequent scans. */
183 if (i == 0 && len == 1 && isalnum(*name))
185 *subcount = *subcount + 1;
186 subdirs[*subcount] = *name;
190 /* Otherwise, if it is a header spool file, add it to the list */
192 if (len == SPOOL_NAME_LENGTH &&
193 Ustrcmp(name + SPOOL_NAME_LENGTH - 2, "-H") == 0)
195 queue_filename *next =
196 store_get(sizeof(queue_filename) + Ustrlen(name));
197 Ustrcpy(next->text, name);
198 next->dir_uschar = subdirchar;
200 /* Handle the creation of a randomized list. The first item becomes both
201 the top and bottom of the list. Subsequent items are inserted either at
202 the top or the bottom, randomly. This is, I argue, faster than doing a
203 sort by allocating a random number to each item, and it also saves having
204 to store the number with each item. */
215 if (flags == 0) flags = resetflags;
216 if ((flags & 1) == 0)
231 /* Otherwise do a bottom-up merge sort based on the name. */
237 for (j = 0; j < LOG2_MAXNODES; j++)
241 next = merge_queue_lists(next, root[j]);
242 root[j] = (j == LOG2_MAXNODES - 1)? next : NULL;
254 /* Finished with this directory */
258 /* If we have just scanned a sub-directory, and it was empty (count == 2
259 implies just "." and ".." entries), and Exim is no longer configured to
260 use sub-directories, attempt to get rid of it. At the same time, try to
261 get rid of any corresponding msglog subdirectory. These are just cosmetic
262 tidying actions, so just ignore failures. If we are scanning just a single
263 sub-directory, break the loop. */
267 if (!split_spool_directory && count <= 2)
270 sprintf(CS big_buffer, "%s/msglog/%c", spool_directory, subdirchar);
271 rmdir(CS big_buffer);
273 if (subdiroffset > 0) break; /* Single sub-directory */
276 /* If we have just scanned the base directory, and subdiroffset is 0,
277 we do not want to continue scanning the sub-directories. */
281 if (subdiroffset == 0) break;
283 } /* Loop for multiple subdirectories */
285 /* When using a bottom-up merge sort, do the final merging of the sublists.
286 Then pass back the final list of file items. */
289 for (i = 0; i < LOG2_MAXNODES; ++i)
290 yield = merge_queue_lists(yield, root[i]);
298 /*************************************************
299 * Perform a queue run *
300 *************************************************/
302 /* The arguments give the messages to start and stop at; NULL means start at
303 the beginning or stop at the end. If the given start message doesn't exist, we
304 start at the next lexically greater one, and likewise we stop at the after the
305 previous lexically lesser one if the given stop message doesn't exist. Because
306 a queue run can take some time, stat each file before forking, in case it has
307 been delivered in the meantime by some other means.
309 The global variables queue_run_force and queue_run_local may be set to cause
310 forced deliveries or local-only deliveries, respectively.
312 If deliver_selectstring[_sender] is not NULL, skip messages whose recipients do
313 not contain the string. As this option is typically used when a machine comes
314 back online, we want to ensure that at least one delivery attempt takes place,
315 so force the first one. The selecting string can optionally be a regex, or
316 refer to the sender instead of recipients.
318 If queue_2stage is set, the queue is scanned twice. The first time, queue_smtp
319 is set so that routing is done for all messages. Thus in the second run those
320 that are routed to the same host should go down the same SMTP connection.
323 start_id message id to start at, or NULL for all
324 stop_id message id to end at, or NULL for all
325 recurse TRUE if recursing for 2-stage run
331 queue_run(uschar *start_id, uschar *stop_id, BOOL recurse)
333 BOOL force_delivery = queue_run_force || deliver_selectstring != NULL ||
334 deliver_selectstring_sender != NULL;
335 const pcre *selectstring_regex = NULL;
336 const pcre *selectstring_regex_sender = NULL;
337 uschar *log_detail = NULL;
342 /* Cancel any specific queue domains. Turn off the flag that causes SMTP
343 deliveries not to happen, unless doing a 2-stage queue run, when the SMTP flag
344 gets set. Save the queue_runner's pid and the flag that indicates any
345 deliveries run directly from this process. Deliveries that are run by handing
346 on TCP/IP channels have queue_run_pid set, but not queue_running. */
348 queue_domains = NULL;
349 queue_smtp_domains = NULL;
350 queue_smtp = queue_2stage;
352 queue_run_pid = getpid();
353 queue_running = TRUE;
355 /* Log the true start of a queue run, and fancy options */
362 if (queue_2stage) *p++ = 'q';
363 if (queue_run_first_delivery) *p++ = 'i';
364 if (queue_run_force) *p++ = 'f';
365 if (deliver_force_thaw) *p++ = 'f';
366 if (queue_run_local) *p++ = 'l';
370 sprintf(CS p, "pid=%d", (int)queue_run_pid);
375 sprintf(CS p, " -q%s", extras);
379 if (deliver_selectstring != NULL)
381 sprintf(CS p, " -R%s %s", deliver_selectstring_regex? "r" : "",
382 deliver_selectstring);
386 if (deliver_selectstring_sender != NULL)
388 sprintf(CS p, " -S%s %s", deliver_selectstring_sender_regex? "r" : "",
389 deliver_selectstring_sender);
393 log_detail = string_copy(big_buffer);
394 log_write(L_queue_run, LOG_MAIN, "Start queue run: %s", log_detail);
397 /* If deliver_selectstring is a regex, compile it. */
399 if (deliver_selectstring != NULL && deliver_selectstring_regex)
400 selectstring_regex = regex_must_compile(deliver_selectstring, TRUE, FALSE);
402 if (deliver_selectstring_sender != NULL && deliver_selectstring_sender_regex)
403 selectstring_regex_sender =
404 regex_must_compile(deliver_selectstring_sender, TRUE, FALSE);
406 /* If the spool is split into subdirectories, we want to process it one
407 directory at a time, so as to spread out the directory scanning and the
408 delivering when there are lots of messages involved, except when
409 queue_run_in_order is set.
411 In the random order case, this loop runs once for the main directory (handling
412 any messages therein), and then repeats for any subdirectories that were found.
413 When the first argument of queue_get_spool_list() is 0, it scans the top
414 directory, fills in subdirs, and sets subcount. The order of the directories is
415 then randomized after the first time through, before they are scanned in
416 subsqeuent iterations.
418 When the first argument of queue_get_spool_list() is -1 (for queue_run_in_
419 order), it scans all directories and makes a single message list. */
421 for (i = (queue_run_in_order? -1 : 0);
422 i <= (queue_run_in_order? -1 : subcount);
426 void *reset_point1 = store_get(0);
431 debug_printf("queue running main directory\n");
433 debug_printf("queue running combined directories\n");
435 debug_printf("queue running subdirectory '%c'\n", subdirs[i]);
438 for (f = queue_get_spool_list(i, subdirs, &subcount, !queue_run_in_order);
448 /* Unless deliveries are forced, if deliver_queue_load_max is non-negative,
449 check that the load average is low enough to permit deliveries. */
451 if (!queue_run_force && deliver_queue_load_max >= 0)
453 load_average = os_getloadavg();
454 if (load_average > deliver_queue_load_max)
456 log_write(L_queue_run, LOG_MAIN, "Abandon queue run: %s (load %.2f, max %.2f)",
458 (double)load_average/1000.0,
459 (double)deliver_queue_load_max/1000.0);
460 i = subcount; /* Don't process other directories */
465 DEBUG(D_load) debug_printf("load average = %.2f max = %.2f\n",
466 (double)load_average/1000.0,
467 (double)deliver_queue_load_max/1000.0);
471 /* Skip this message unless it's within the ID limits */
473 if (stop_id != NULL && Ustrncmp(f->text, stop_id, MESSAGE_ID_LENGTH) > 0)
475 if (start_id != NULL && Ustrncmp(f->text, start_id, MESSAGE_ID_LENGTH) < 0)
478 /* Check that the message still exists */
480 message_subdir[0] = f->dir_uschar;
481 sprintf(CS buffer, "%s/input/%s/%s", spool_directory, message_subdir,
483 if (Ustat(buffer, &statbuf) < 0) continue;
485 /* There are some tests that require the reading of the header file. Ensure
486 the store used is scavenged afterwards so that this process doesn't keep
487 growing its store. We have to read the header file again when actually
488 delivering, but it's cheaper than forking a delivery process for each
489 message when many are not going to be delivered. */
491 if (deliver_selectstring != NULL || deliver_selectstring_sender != NULL ||
492 queue_run_first_delivery)
495 BOOL orig_dont_deliver = dont_deliver;
496 void *reset_point2 = store_get(0);
498 /* Restore the original setting of dont_deliver after reading the header,
499 so that a setting for a particular message doesn't force it for any that
500 follow. If the message is chosen for delivery, the header is read again
501 in the deliver_message() function, in a subprocess. */
503 if (spool_read_header(f->text, FALSE, TRUE) != spool_read_OK) continue;
504 dont_deliver = orig_dont_deliver;
506 /* Now decide if we want to deliver this message. As we have read the
507 header file, we might as well do the freeze test now, and save forking
510 if (deliver_freeze && !deliver_force_thaw)
512 log_write(L_skip_delivery, LOG_MAIN, "Message is frozen");
516 /* Check first_delivery in the case when there are no message logs. */
518 else if (queue_run_first_delivery && !deliver_firsttime)
520 DEBUG(D_queue_run) debug_printf("%s: not first delivery\n", f->text);
524 /* Check for a matching address if deliver_selectstring[_sender} is set.
525 If so, we do a fully delivery - don't want to omit other addresses since
526 their routing might trigger re-writing etc. */
528 /* Sender matching */
530 else if (deliver_selectstring_sender != NULL &&
531 !(deliver_selectstring_sender_regex?
532 (pcre_exec(selectstring_regex_sender, NULL, CS sender_address,
533 Ustrlen(sender_address), 0, PCRE_EOPT, NULL, 0) >= 0)
535 (strstric(sender_address, deliver_selectstring_sender, FALSE)
538 DEBUG(D_queue_run) debug_printf("%s: sender address did not match %s\n",
539 f->text, deliver_selectstring_sender);
543 /* Recipient matching */
545 else if (deliver_selectstring != NULL)
548 for (i = 0; i < recipients_count; i++)
550 uschar *address = recipients_list[i].address;
551 if ((deliver_selectstring_regex?
552 (pcre_exec(selectstring_regex, NULL, CS address,
553 Ustrlen(address), 0, PCRE_EOPT, NULL, 0) >= 0)
555 (strstric(address, deliver_selectstring, FALSE) != NULL))
557 tree_search(tree_nonrecipients, address) == NULL)
561 if (i >= recipients_count)
564 debug_printf("%s: no recipient address matched %s\n",
565 f->text, deliver_selectstring);
570 /* Recover store used when reading the header */
572 store_reset(reset_point2);
573 if (!wanted) continue; /* With next message */
576 /* OK, got a message we want to deliver. Create a pipe which will
577 serve as a means of detecting when all the processes created by the
578 delivery process are finished. This is relevant when the delivery
579 process passes one or more SMTP channels on to its own children. The
580 pipe gets passed down; by reading on it here we detect when the last
581 descendent dies by the unblocking of the read. It's a pity that for
582 most of the time the pipe isn't used, but creating a pipe should be
587 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "failed to create pipe in queue "
588 "runner process %d: %s", queue_run_pid, strerror(errno));
590 queue_run_pipe = pfd[pipe_write]; /* To ensure it gets passed on. */
592 /* Make sure it isn't stdin. This seems unlikely, but just to be on the
595 if (queue_run_pipe == 0)
597 queue_run_pipe = dup(queue_run_pipe);
601 /* Before forking to deliver the message, ensure any open and cached
602 lookup files or databases are closed. Otherwise, closing in the subprocess
603 can make the next subprocess have problems. There won't often be anything
604 open here, but it is possible (e.g. if spool_directory is an expanded
605 string). A single call before this loop would probably suffice, but just in
606 case expansions get inserted at some point, I've taken the heavy-handed
607 approach. When nothing is open, the call should be cheap. */
611 /* Now deliver the message; get the id by cutting the -H off the file
612 name. The return of the process is zero if a delivery was attempted. */
614 set_process_info("running queue: %s", f->text);
615 f->text[SPOOL_NAME_LENGTH-2] = 0;
616 if ((pid = fork()) == 0)
619 if (running_in_test_harness) millisleep(100);
620 (void)close(pfd[pipe_read]);
621 rc = deliver_message(f->text, force_delivery, FALSE);
622 _exit(rc == DELIVER_NOT_ATTEMPTED);
625 log_write(0, LOG_MAIN|LOG_PANIC_DIE, "fork of delivery process from "
626 "queue runner %d failed\n", queue_run_pid);
628 /* Close the writing end of the synchronizing pipe in this process,
629 then wait for the first level process to terminate. */
631 (void)close(pfd[pipe_write]);
632 set_process_info("running queue: waiting for %s (%d)", f->text, pid);
633 while (wait(&status) != pid);
635 /* A zero return means a delivery was attempted; turn off the force flag
636 for any subsequent calls unless queue_force is set. */
638 if ((status & 0xffff) == 0) force_delivery = queue_run_force;
640 /* If the process crashed, tell somebody */
642 else if ((status & 0x00ff) != 0)
644 log_write(0, LOG_MAIN|LOG_PANIC,
645 "queue run: process %d crashed with signal %d while delivering %s",
646 (int)pid, status & 0x00ff, f->text);
649 /* Before continuing, wait till the pipe gets closed at the far end. This
650 tells us that any children created by the delivery to re-use any SMTP
651 channels have all finished. Since no process actually writes to the pipe,
652 the mere fact that read() unblocks is enough. */
654 set_process_info("running queue: waiting for children of %d", pid);
655 (void)read(pfd[pipe_read], buffer, sizeof(buffer));
656 (void)close(pfd[pipe_read]);
657 set_process_info("running queue");
659 /* If we are in the test harness, and this is not the first of a 2-stage
660 queue run, update fudged queue times. */
662 if (running_in_test_harness && !queue_2stage)
664 uschar *fqtnext = Ustrchr(fudged_queue_times, '/');
665 if (fqtnext != NULL) fudged_queue_times = fqtnext + 1;
667 } /* End loop for list of messages */
669 store_reset(reset_point1); /* Scavenge list of messages */
671 /* If this was the first time through for random order processing, and
672 sub-directories have been found, randomize their order if necessary. */
674 if (i == 0 && subcount > 1 && !queue_run_in_order)
677 for (j = 1; j <= subcount; j++)
679 int r = random_number(100);
682 int k = (r % subcount) + 1;
684 subdirs[j] = subdirs[k];
689 } /* End loop for multiple directories */
691 /* If queue_2stage is true, we do it all again, with the 2stage flag
696 queue_2stage = FALSE;
697 queue_run(start_id, stop_id, TRUE);
700 /* At top level, log the end of the run. */
702 if (!recurse) log_write(L_queue_run, LOG_MAIN, "End queue run: %s", log_detail);
708 /************************************************
709 * Count messages on the queue *
710 ************************************************/
712 /* Called as a result of -bpc
723 queue_filename *f = NULL;
725 f = queue_get_spool_list(
726 -1, /* entire queue */
727 subdirs, /* for holding sub list */
728 &subcount, /* for subcount */
729 FALSE); /* not random */
730 for (; f != NULL; f = f->next) count++;
731 fprintf(stdout, "%d\n", count);
736 /************************************************
737 * List extra deliveries *
738 ************************************************/
740 /* This is called from queue_list below to print out all addresses that
741 have received a message but which were not primary addresses. That is, all
742 the addresses in the tree of non-recipients that are not primary addresses.
743 The tree has been scanned and the data field filled in for those that are
746 Argument: points to the tree node
750 static void queue_list_extras(tree_node *p)
752 if (p->left != NULL) queue_list_extras(p->left);
753 if (!p->data.val) printf(" +D %s\n", p->name);
754 if (p->right != NULL) queue_list_extras(p->right);
759 /************************************************
760 * List messages on the queue *
761 ************************************************/
763 /* Or a given list of messages. In the "all" case, we get a list of file names
764 as quickly as possible, then scan each one for information to output. If any
765 disappear while we are processing, just leave them out, but give an error if an
766 explicit list was given. This function is a top-level function that is obeyed
767 as a result of the -bp argument. As there may be a lot of messages on the
768 queue, we must tidy up the store after reading the headers for each one.
771 option 0 => list top-level recipients, with "D" for those delivered
772 1 => list only undelivered top-level recipients
773 2 => as 0, plus any generated delivered recipients
774 If 8 is added to any of these values, the queue is listed in
776 list => first of any message ids to list
777 count count of message ids; 0 => all
783 queue_list(int option, uschar **list, int count)
787 int now = (int)time(NULL);
789 queue_filename *f = NULL;
792 /* If given a list of messages, build a chain containing their ids. */
796 queue_filename *last = NULL;
797 for (i = 0; i < count; i++)
799 queue_filename *next =
800 store_get(sizeof(queue_filename) + Ustrlen(list[i]) + 2);
801 sprintf(CS next->text, "%s-H", list[i]);
802 next->dir_uschar = '*';
804 if (i == 0) f = next; else last->next = next;
809 /* Otherwise get a list of the entire queue, in order if necessary. */
812 f = queue_get_spool_list(
813 -1, /* entire queue */
814 subdirs, /* for holding sub list */
815 &subcount, /* for subcount */
816 option >= 8); /* randomize if required */
818 if (option >= 8) option -= 8;
820 /* Now scan the chain and print information, resetting store used
823 reset_point = store_get(0);
825 for (; f != NULL; f = f->next)
831 store_reset(reset_point);
833 message_subdir[0] = f->dir_uschar;
834 rc = spool_read_header(f->text, FALSE, count <= 0);
835 if (rc == spool_read_notopen && errno == ENOENT && count <= 0) continue;
838 env_read = (rc == spool_read_OK || rc == spool_read_hdrerror);
846 sprintf(CS big_buffer, "%s/input/%s/%s", spool_directory, message_subdir,
848 ptr = Ustrlen(big_buffer)-1;
849 big_buffer[ptr] = 'D';
851 /* Add the data size to the header size; don't count the file name
852 at the start of the data file, but add one for the notional blank line
853 that precedes the data. */
855 if (Ustat(big_buffer, &statbuf) == 0)
856 size = message_size + statbuf.st_size - SPOOL_DATA_START_OFFSET + 1;
857 i = (now - received_time)/60; /* minutes on queue */
861 if (i > 72) printf("%2dd ", (i + 12)/24); else printf("%2dh ", i);
863 else printf("%2dm ", i);
865 /* Collect delivered addresses from any J file */
867 big_buffer[ptr] = 'J';
868 jread = Ufopen(big_buffer, "rb");
871 while (Ufgets(big_buffer, big_buffer_size, jread) != NULL)
873 int n = Ustrlen(big_buffer);
875 tree_add_nonrecipient(big_buffer);
881 fprintf(stdout, "%s ", string_format_size(size, big_buffer));
882 for (i = 0; i < 16; i++) fputc(f->text[i], stdout);
884 if (env_read && sender_address != NULL)
886 printf(" <%s>", sender_address);
887 if (sender_set_untrusted) printf(" (%s)", originator_login);
890 if (rc != spool_read_OK)
893 if (save_errno == ERRNO_SPOOLFORMAT)
896 sprintf(CS big_buffer, "%s/input/%s/%s", spool_directory, message_subdir,
898 if (Ustat(big_buffer, &statbuf) == 0)
899 printf("*** spool format error: size=" OFF_T_FMT " ***",
901 else printf("*** spool format error ***");
903 else printf("*** spool read error: %s ***", strerror(save_errno));
904 if (rc != spool_read_hdrerror)
911 if (deliver_freeze) printf(" *** frozen ***");
915 if (recipients_list != NULL)
917 for (i = 0; i < recipients_count; i++)
919 tree_node *delivered =
920 tree_search(tree_nonrecipients, recipients_list[i].address);
921 if (!delivered || option != 1)
922 printf(" %s %s\n", (delivered != NULL)? "D":" ",
923 recipients_list[i].address);
924 if (delivered != NULL) delivered->data.val = TRUE;
926 if (option == 2 && tree_nonrecipients != NULL)
927 queue_list_extras(tree_nonrecipients);
935 /*************************************************
936 * Act on a specific message *
937 *************************************************/
939 /* Actions that require a list of addresses make use of
940 argv/argc/recipients_arg. Other actions do not. This function does its
941 own authority checking.
944 id id of the message to work on
945 action which action is required (MSG_xxx)
946 argv the original argv for Exim
947 argc the original argc for Exim
948 recipients_arg offset to the list of recipients in argv
950 Returns: FALSE if there was any problem
954 queue_action(uschar *id, int action, uschar **argv, int argc, int recipients_arg)
958 BOOL removed = FALSE;
960 uschar *doing = NULL;
963 uschar spoolname[256];
965 /* Set the global message_id variable, used when re-writing spool files. This
966 also causes message ids to be added to log messages. */
968 Ustrcpy(message_id, id);
970 /* The "actions" that just list the files do not require any locking to be
971 done. Only admin users may read the spool files. */
973 if (action >= MSG_SHOW_BODY)
976 uschar *subdirectory, *suffix;
980 printf("Permission denied\n");
984 if (recipients_arg < argc)
986 printf("*** Only one message can be listed at once\n");
990 if (action == MSG_SHOW_BODY)
992 subdirectory = US"input";
995 else if (action == MSG_SHOW_HEADER)
997 subdirectory = US"input";
1002 subdirectory = US"msglog";
1006 for (i = 0; i < 2; i++)
1008 message_subdir[0] = (split_spool_directory == (i == 0))? id[5] : 0;
1009 sprintf(CS spoolname, "%s/%s/%s/%s%s", spool_directory, subdirectory,
1010 message_subdir, id, suffix);
1011 fd = Uopen(spoolname, O_RDONLY, 0);
1013 if (i == 0) continue;
1014 printf("Failed to open %s file for %s%s: %s\n", subdirectory, id, suffix,
1016 if (action == MSG_SHOW_LOG && !message_logs)
1017 printf("(No message logs are being created because the message_logs "
1018 "option is false.)\n");
1022 while((rc = read(fd, big_buffer, big_buffer_size)) > 0)
1023 (void)write(fileno(stdout), big_buffer, rc);
1029 /* For actions that actually act, open and lock the data file to ensure that no
1030 other process is working on this message. If the file does not exist, continue
1031 only if the action is remove and the user is an admin user, to allow for
1032 tidying up broken states. */
1034 if (!spool_open_datafile(id))
1036 if (errno == ENOENT)
1039 printf("Spool data file for %s does not exist\n", id);
1040 if (action != MSG_REMOVE || !admin_user) return FALSE;
1041 printf("Continuing, to ensure all files removed\n");
1045 if (errno == 0) printf("Message %s is locked\n", id);
1046 else printf("Couldn't open spool file for %s: %s\n", id,
1052 /* Read the spool header file for the message. Again, continue after an
1053 error only in the case of deleting by an administrator. Setting the third
1054 argument false causes it to look both in the main spool directory and in
1055 the appropriate subdirectory, and set message_subdir according to where it
1056 found the message. */
1058 sprintf(CS spoolname, "%s-H", id);
1059 if (spool_read_header(spoolname, TRUE, FALSE) != spool_read_OK)
1062 if (errno != ERRNO_SPOOLFORMAT)
1063 printf("Spool read error for %s: %s\n", spoolname, strerror(errno));
1065 printf("Spool format error for %s\n", spoolname);
1066 if (action != MSG_REMOVE || !admin_user)
1068 (void)close(deliver_datafile);
1069 deliver_datafile = -1;
1072 printf("Continuing to ensure all files removed\n");
1075 /* Check that the user running this process is entitled to operate on this
1076 message. Only admin users may freeze/thaw, add/cancel recipients, or otherwise
1077 mess about, but the original sender is permitted to remove a message. That's
1078 why we leave this check until after the headers are read. */
1080 if (!admin_user && (action != MSG_REMOVE || real_uid != originator_uid))
1082 printf("Permission denied\n");
1083 (void)close(deliver_datafile);
1084 deliver_datafile = -1;
1088 /* Set up the user name for logging. */
1090 pw = getpwuid(real_uid);
1091 username = (pw != NULL)?
1092 US pw->pw_name : string_sprintf("uid %ld", (long int)real_uid);
1094 /* Take the necessary action. */
1096 printf("Message %s ", id);
1104 printf("is already frozen\n");
1108 deliver_freeze = TRUE;
1109 deliver_manual_thaw = FALSE;
1110 deliver_frozen_at = time(NULL);
1111 if (spool_write_header(id, SW_MODIFYING, &errmsg) >= 0)
1113 printf("is now frozen\n");
1114 log_write(0, LOG_MAIN, "frozen by %s", username);
1119 printf("could not be frozen: %s\n", errmsg);
1126 if (!deliver_freeze)
1129 printf("is not frozen\n");
1133 deliver_freeze = FALSE;
1134 deliver_manual_thaw = TRUE;
1135 if (spool_write_header(id, SW_MODIFYING, &errmsg) >= 0)
1137 printf("is no longer frozen\n");
1138 log_write(0, LOG_MAIN, "unfrozen by %s", username);
1143 printf("could not be unfrozen: %s\n", errmsg);
1149 /* We must ensure all files are removed from both the input directory
1150 and the appropriate subdirectory, to clean up cases when there are odd
1151 files left lying around in odd places. In the normal case message_subdir
1152 will have been set correctly by spool_read_header, but as this is a rare
1153 operation, just run everything twice. */
1156 message_subdir[0] = id[5];
1157 for (j = 0; j < 2; message_subdir[0] = 0, j++)
1159 sprintf(CS spoolname, "%s/msglog/%s/%s", spool_directory, message_subdir, id);
1160 if (Uunlink(spoolname) < 0)
1162 if (errno != ENOENT)
1165 printf("Error while removing %s: %s\n", spoolname,
1169 else removed = TRUE;
1171 for (i = 0; i < 3; i++)
1173 sprintf(CS spoolname, "%s/input/%s/%s-%c", spool_directory, message_subdir,
1175 if (Uunlink(spoolname) < 0)
1177 if (errno != ENOENT)
1180 printf("Error while removing %s: %s\n", spoolname,
1184 else removed = TRUE;
1188 /* In the common case, the datafile is open (and locked), so give the
1189 obvious message. Otherwise be more specific. */
1191 if (deliver_datafile >= 0) printf("has been removed\n");
1192 else printf("has been removed or did not exist\n");
1195 log_write(0, LOG_MAIN, "removed by %s", username);
1196 log_write(0, LOG_MAIN, "Completed");
1201 case MSG_MARK_ALL_DELIVERED:
1202 for (i = 0; i < recipients_count; i++)
1204 tree_add_nonrecipient(recipients_list[i].address);
1206 if (spool_write_header(id, SW_MODIFYING, &errmsg) >= 0)
1208 printf("has been modified\n");
1209 for (i = 0; i < recipients_count; i++)
1210 log_write(0, LOG_MAIN, "address <%s> marked delivered by %s",
1211 recipients_list[i].address, username);
1216 printf("- could not mark all delivered: %s\n", errmsg);
1221 case MSG_EDIT_SENDER:
1222 if (recipients_arg < argc - 1)
1225 printf("- only one sender address can be specified\n");
1228 doing = US"editing sender";
1231 case MSG_ADD_RECIPIENT:
1232 if (doing == NULL) doing = US"adding recipient";
1235 case MSG_MARK_DELIVERED:
1236 if (doing == NULL) doing = US"marking as delivered";
1238 /* Common code for EDIT_SENDER, ADD_RECIPIENT, & MARK_DELIVERED */
1240 if (recipients_arg >= argc)
1243 printf("- error while %s: no address given\n", doing);
1247 for (; recipients_arg < argc; recipients_arg++)
1249 int start, end, domain;
1252 parse_extract_address(argv[recipients_arg], &errmess, &start, &end,
1253 &domain, (action == MSG_EDIT_SENDER));
1255 if (recipient == NULL)
1258 printf("- error while %s:\n bad address %s: %s\n",
1259 doing, argv[recipients_arg], errmess);
1261 else if (recipient[0] != 0 && domain == 0)
1264 printf("- error while %s:\n bad address %s: "
1265 "domain missing\n", doing, argv[recipients_arg]);
1269 if (action == MSG_ADD_RECIPIENT)
1271 receive_add_recipient(recipient, -1);
1272 log_write(0, LOG_MAIN, "recipient <%s> added by %s",
1273 recipient, username);
1275 else if (action == MSG_MARK_DELIVERED)
1277 for (i = 0; i < recipients_count; i++)
1278 if (Ustrcmp(recipients_list[i].address, recipient) == 0) break;
1279 if (i >= recipients_count)
1281 printf("- error while %s:\n %s is not a recipient:"
1282 " message not updated\n", doing, recipient);
1287 tree_add_nonrecipient(recipients_list[i].address);
1288 log_write(0, LOG_MAIN, "address <%s> marked delivered by %s",
1289 recipient, username);
1292 else /* MSG_EDIT_SENDER */
1294 sender_address = recipient;
1295 log_write(0, LOG_MAIN, "sender address changed to <%s> by %s",
1296 recipient, username);
1303 if (spool_write_header(id, SW_MODIFYING, &errmsg) >= 0)
1304 printf("has been modified\n");
1308 printf("- while %s: %s\n", doing, errmsg);
1315 /* Closing the datafile releases the lock and permits other processes
1316 to operate on the message (if it still exists). */
1318 (void)close(deliver_datafile);
1319 deliver_datafile = -1;
1325 /*************************************************
1326 * Check the queue_only_file condition *
1327 *************************************************/
1329 /* The queue_only_file option forces certain kinds of queueing if a given file
1337 queue_check_only(void)
1341 struct stat statbuf;
1342 uschar *s, *ss, *name;
1343 uschar buffer[1024];
1345 if (queue_only_file == NULL) return;
1347 s = queue_only_file;
1348 while ((ss = string_nextinlist(&s, &sep, buffer, sizeof(buffer))) != NULL)
1350 if (Ustrncmp(ss, "smtp", 4) == 0)
1352 name = US"queue_smtp";
1358 name = US"queue_only";
1362 if (Ustat(ss, &statbuf) == 0)
1365 DEBUG(D_receive) debug_printf("%s set because %s exists\n", name, ss);
1370 /* End of queue.c */