citadel/server/modules/smtp/serv_smtpclient.c

   1 // Transmit outbound SMTP mail to the big wide world of the Internet
   2 //
   3 // This is the new, exciting, clever version that makes libcurl do all the work  :)
   4 //
   5 // Copyright (c) 1997-2023 by the citadel.org team
   6 //
   7 // This program is open source software.  Use, duplication, or disclosure
   8 // is subject to the terms of the GNU General Public License, version 3.
   9
  10 #include <stdlib.h>
  11 #include <unistd.h>
  12 #include <stdio.h>
  13 #include <time.h>
  14 #include <ctype.h>
  15 #include <string.h>
  16 #include <errno.h>
  17 #include <sys/types.h>
  18 #include <sys/stat.h>
  19 #include <libcitadel.h>
  20 #include <curl/curl.h>
  21 #include "../../sysconfig.h"
  22 #include "../../citadel_defs.h"
  23 #include "../../server.h"
  24 #include "../../citserver.h"
  25 #include "../../support.h"
  26 #include "../../config.h"
  27 #include "../../ctdl_module.h"
  28 #include "../../clientsocket.h"
  29 #include "../../msgbase.h"
  30 #include "../../domain.h"
  31 #include "../../internet_addressing.h"
  32 #include "../../citadel_dirs.h"
  33 #include "../smtp/smtp_util.h"
  34
  35 long last_queue_job_submitted = 0;
  36 long last_queue_job_processed = 0;
  37
  38 struct smtpmsgsrc {             // Data passed in and out of libcurl for message upload
  39         StrBuf *TheMessage;
  40         int bytes_total;
  41         int bytes_sent;
  42 };
  43
  44 // Initialize the SMTP outbound queue
  45 void smtp_init_spoolout(void) {
  46         struct ctdlroom qrbuf;
  47
  48         // Create the room.  This will silently fail if the room already
  49         // exists, and that's perfectly ok, because we want it to exist.
  50         CtdlCreateRoom(SMTP_SPOOLOUT_ROOM, 3, "", 0, 1, 0, VIEW_QUEUE);
  51
  52         // Make sure it's set to be a "system room" so it doesn't show up
  53         // in the <K>nown rooms list for administrators.
  54         if (CtdlGetRoomLock(&qrbuf, SMTP_SPOOLOUT_ROOM) == 0) {
  55                 qrbuf.QRflags2 |= QR2_SYSTEM;
  56                 CtdlPutRoomLock(&qrbuf);
  57         }
  58 }
  59
  60
  61 // For internet mail, generate a delivery job.
  62 // Yes, this is recursive.  Deal with it.  Infinite recursion does
  63 // not happen because the message containing the delivery job does not
  64 // have a recipient.
  65 int smtp_aftersave(struct CtdlMessage *msg, struct recptypes *recps) {
  66         if ((recps != NULL) && (recps->num_internet > 0)) {
  67                 struct CtdlMessage *imsg = NULL;
  68                 char recipient[SIZ];
  69                 StrBuf *SpoolMsg = NewStrBuf();
  70                 long nTokens;
  71                 int i;
  72
  73                 syslog(LOG_DEBUG, "smtpclient: generating delivery job");
  74
  75                 StrBufPrintf(SpoolMsg,
  76                              "Content-type: " SPOOLMIME "\n"
  77                              "\n"
  78                              "msgid|%s\n"
  79                              "submitted|%ld\n" "bounceto|%s\n", msg->cm_fields[eVltMsgNum], (long) time(NULL), recps->bounce_to);
  80
  81                 if (recps->envelope_from != NULL) {
  82                         StrBufAppendBufPlain(SpoolMsg, HKEY("envelope_from|"), 0);
  83                         StrBufAppendBufPlain(SpoolMsg, recps->envelope_from, -1, 0);
  84                         StrBufAppendBufPlain(SpoolMsg, HKEY("\n"), 0);
  85                 }
  86                 if (recps->sending_room != NULL) {
  87                         StrBufAppendBufPlain(SpoolMsg, HKEY("source_room|"), 0);
  88                         StrBufAppendBufPlain(SpoolMsg, recps->sending_room, -1, 0);
  89                         StrBufAppendBufPlain(SpoolMsg, HKEY("\n"), 0);
  90                 }
  91
  92                 nTokens = num_tokens(recps->recp_internet, '|');
  93                 for (i = 0; i < nTokens; i++) {
  94                         long len;
  95                         len = extract_token(recipient, recps->recp_internet, i, '|', sizeof recipient);
  96                         if (len > 0) {
  97                                 StrBufAppendBufPlain(SpoolMsg, HKEY("remote|"), 0);
  98                                 StrBufAppendBufPlain(SpoolMsg, recipient, len, 0);
  99                                 StrBufAppendBufPlain(SpoolMsg, HKEY("|0||\n"), 0);
 100                         }
 101                 }
 102
 103                 imsg = malloc(sizeof(struct CtdlMessage));
 104                 memset(imsg, 0, sizeof(struct CtdlMessage));
 105                 imsg->cm_magic = CTDLMESSAGE_MAGIC;
 106                 imsg->cm_anon_type = MES_NORMAL;
 107                 imsg->cm_format_type = FMT_RFC822;
 108                 CM_SetField(imsg, eMsgSubject, "QMSG");
 109                 CM_SetField(imsg, eAuthor, "Citadel");
 110                 CM_SetField(imsg, eJournal, "do not journal");
 111                 CM_SetAsFieldSB(imsg, eMessageText, &SpoolMsg);
 112                 last_queue_job_submitted = CtdlSubmitMsg(imsg, NULL, SMTP_SPOOLOUT_ROOM);
 113                 CM_Free(imsg);
 114         }
 115         return 0;
 116 }
 117
 118
 119 // Callback for smtp_attempt_delivery() to supply libcurl with upload data.
 120 static size_t upload_source(void *ptr, size_t size, size_t nmemb, void *userp) {
 121         struct smtpmsgsrc *s = (struct smtpmsgsrc *) userp;
 122         int sendbytes = 0;
 123         const char *send_this = NULL;
 124
 125         sendbytes = (size * nmemb);
 126
 127         if (s->bytes_sent >= s->bytes_total) {
 128                 return (0);                                     // no data remaining; we are done
 129         }
 130
 131         if (sendbytes > (s->bytes_total - s->bytes_sent)) {
 132                 sendbytes = s->bytes_total - s->bytes_sent;     // can't send more than we have
 133         }
 134
 135         send_this = ChrPtr(s->TheMessage);
 136         send_this += s->bytes_sent;                             // start where we last left off
 137
 138         memcpy(ptr, send_this, sendbytes);
 139         s->bytes_sent += sendbytes;
 140         return(sendbytes);                                      // return the number of bytes _actually_ copied
 141 }
 142
 143
 144 // The libcurl API doesn't provide a way to capture the actual SMTP result message returned
 145 // by the remote server.  This is an ugly way to extract it, by capturing debug data from
 146 // the library and filtering on the lines we want.
 147 int ctdl_libcurl_smtp_debug_callback(CURL *handle, curl_infotype type, char *data, size_t size, void *userptr) {
 148         if (type != CURLINFO_HEADER_IN)
 149                 return 0;
 150         if (!userptr)
 151                 return 0;
 152         char *debugbuf = (char *) userptr;
 153
 154         int len = strlen(debugbuf);
 155         if (len + size > SIZ)
 156                 return 0;
 157
 158         memcpy(&debugbuf[len], data, size);
 159         debugbuf[len + size] = 0;
 160         return 0;
 161 }
 162
 163
 164 // Go through the debug output of an SMTP transaction, and boil it down to just the final success or error response message.
 165 void trim_response(long response_code, char *response) {
 166         if ((response_code < 100) || (response_code > 999) || (IsEmptyStr(response))) {
 167                 return;
 168         }
 169
 170         char *p;
 171         for (p = response; *p != 0; ++p) {
 172                 if ( (*p != '\n') && (!isprint(*p)) ) {         // expunge any nonprintables except for newlines
 173                         *p = ' ';
 174                 }
 175         }
 176
 177         char response_code_str[4];
 178         snprintf(response_code_str, sizeof response_code_str, "%ld", response_code);
 179         char *respstart = strstr(response, response_code_str);
 180         if (respstart == NULL) {                                // If we have a response code but no response text,
 181                 strcpy(response, smtpstatus(response_code));    // use one of our canned messages.
 182                 return;
 183         }
 184         strcpy(response, respstart);
 185
 186         p = strstr(response, "\n");
 187         if (p != NULL) {
 188                 *p = 0;
 189         }
 190 }
 191
 192
 193 // Attempt a delivery to one recipient.
 194 // Returns a three-digit SMTP status code.
 195 int smtp_attempt_delivery(long msgid, char *recp, char *envelope_from, char *source_room, char *response) {
 196         struct smtpmsgsrc s;
 197         char *fromaddr = NULL;
 198         CURL *curl;
 199         CURLcode res = CURLE_OK;
 200         struct curl_slist *recipients = NULL;
 201         long response_code = 421;
 202         int num_mx = 0;
 203         char mxes[SIZ];
 204         char user[1024];
 205         char node[1024];
 206         char name[1024];
 207         char try_this_mx[256];
 208         char smtp_url[512];
 209         int i;
 210
 211         syslog(LOG_DEBUG, "smtpclient: smtp_attempt_delivery(%ld, %s)", msgid, recp);
 212
 213         process_rfc822_addr(recp, user, node, name);    // split recipient address into username, hostname, displayname
 214         num_mx = getmx(mxes, node);
 215         if (num_mx < 1) {
 216                 return (421);
 217         }
 218
 219         CC->redirect_buffer = NewStrBufPlain(NULL, SIZ);
 220         if (!IsEmptyStr(source_room)) {
 221                 // If we have a source room, it's probably a mailing list message; generate an unsubscribe header
 222                 char esc_room[ROOMNAMELEN*2];
 223                 char esc_email[1024];
 224                 urlesc(esc_room, sizeof esc_room, source_room);
 225                 urlesc(esc_email, sizeof esc_email, recp);
 226                 cprintf("List-Unsubscribe: <http://%s/listsub?cmd=unsubscribe&room=%s&email=%s>\r\n",
 227                         CtdlGetConfigStr("c_fqdn"),
 228                         esc_room,
 229                         esc_email
 230                 );
 231         }
 232         CtdlOutputMsg(msgid, MT_RFC822, HEADERS_ALL, 0, 1, NULL, 0, NULL, &fromaddr, NULL);
 233         s.TheMessage = CC->redirect_buffer;
 234         s.bytes_total = StrLength(CC->redirect_buffer);
 235         s.bytes_sent = 0;
 236         CC->redirect_buffer = NULL;
 237         response_code = 421;
 238                                         // keep trying MXes until one works or we run out
 239         for (i = 0; ((i < num_mx) && ((response_code / 100) == 4)); ++i) {
 240                 response_code = 421;    // default 421 makes non-protocol errors transient
 241                 s.bytes_sent = 0;       // rewind our buffer in case we try multiple MXes
 242
 243                 curl = curl_easy_init();
 244                 if (curl) {
 245                         response[0] = 0;
 246
 247                         if (!IsEmptyStr(envelope_from)) {
 248                                 curl_easy_setopt(curl, CURLOPT_MAIL_FROM, envelope_from);
 249                         }
 250                         else {
 251                                 curl_easy_setopt(curl, CURLOPT_MAIL_FROM, fromaddr);
 252                         }
 253
 254                         recipients = curl_slist_append(recipients, recp);
 255                         curl_easy_setopt(curl, CURLOPT_MAIL_RCPT, recipients);
 256                         curl_easy_setopt(curl, CURLOPT_READFUNCTION, upload_source);
 257                         curl_easy_setopt(curl, CURLOPT_READDATA, &s);
 258                         curl_easy_setopt(curl, CURLOPT_UPLOAD, 1);                              // tell libcurl we are uploading
 259                         curl_easy_setopt(curl, CURLOPT_TIMEOUT, 20L);                           // Time out after 20 seconds
 260                         if (CtdlGetConfigInt("c_smtpclient_disable_starttls") == 0) {
 261                                 curl_easy_setopt(curl, CURLOPT_USE_SSL, CURLUSESSL_TRY);        // Attempt STARTTLS if offered
 262                         }
 263                         curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L);
 264                         curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L);
 265                         curl_easy_setopt(curl, CURLOPT_DEBUGFUNCTION, ctdl_libcurl_smtp_debug_callback);
 266                         curl_easy_setopt(curl, CURLOPT_DEBUGDATA, (void *) response);
 267                         curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);
 268
 269                         // Construct an SMTP URL in the form of:
 270                         //      smtp[s]://target_host/source_host
 271                         // This looks weird but libcurl uses that last part to set our name for EHLO or HELO.
 272                         // We check for "smtp://" and "smtps://" because an admin may have put those prefixes in a smart-host entry
 273                         // If there is no prefix we add "smtp://"
 274                         extract_token(try_this_mx, mxes, i, '|', (sizeof try_this_mx - 7));
 275                         snprintf(smtp_url, sizeof smtp_url,
 276                                 "%s%s/%s",
 277                                 (((!strncasecmp(try_this_mx, HKEY("smtp://")))
 278                                 || (!strncasecmp(try_this_mx, HKEY("smtps://")))) ? "" : "smtp://"),
 279                                 try_this_mx, CtdlGetConfigStr("c_fqdn")
 280                         );
 281                         curl_easy_setopt(curl, CURLOPT_URL, smtp_url);
 282                         syslog(LOG_DEBUG, "smtpclient: trying MX %d of %d <%s>", i+1, num_mx, smtp_url);        // send the message
 283                         res = curl_easy_perform(curl);
 284                         curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &response_code);
 285                         syslog(LOG_DEBUG,
 286                                "smtpclient: libcurl returned %d (%s) , SMTP response %ld",
 287                                res, curl_easy_strerror(res), response_code
 288                         );
 289
 290                         if ((res != CURLE_OK) && (response_code == 0)) {        // check for errors
 291                                 response_code = 421;
 292                         }
 293
 294                         curl_slist_free_all(recipients);
 295                         recipients = NULL;                                      // this gets reused; avoid double-free
 296                         curl_easy_cleanup(curl);
 297                         curl = NULL;                                            // this gets reused; avoid double-free
 298
 299                         // Trim the error message buffer down to just the actual message
 300                         trim_response(response_code, response);
 301                 }
 302         }
 303
 304         FreeStrBuf(&s.TheMessage);
 305         if (fromaddr) {
 306                 free(fromaddr);
 307         }
 308         return ((int) response_code);
 309 }
 310
 311
 312 // Process one outbound message.
 313 void smtp_process_one_msg(long qmsgnum) {
 314         struct CtdlMessage *msg = NULL;
 315         char *instr = NULL;
 316         int i;
 317         int num_success = 0;
 318         int num_fail = 0;
 319         int num_delayed = 0;
 320         long deletes[2];
 321         int delete_this_queue = 0;
 322         char server_response[SIZ];
 323
 324         msg = CtdlFetchMessage(qmsgnum, 1);
 325         if (msg == NULL) {
 326                 syslog(LOG_WARNING, "smtpclient: %ld does not exist", qmsgnum);
 327                 return;
 328         }
 329
 330         instr = msg->cm_fields[eMessageText];
 331         msg->cm_fields[eMessageText] = NULL;
 332         CM_Free(msg);
 333
 334         // if the queue job message has any CRLF's convert them to LF's
 335         char *crlf = NULL;
 336         while (crlf = strstr(instr, "\r\n"), crlf != NULL) {
 337                 strcpy(crlf, crlf + 1);
 338         }
 339
 340         // Strip out the headers and we are now left with just the instructions.
 341         char *soi = strstr(instr, "\n\n");
 342         if (soi) {
 343                 strcpy(instr, soi + 2);
 344         }
 345
 346         long msgid = 0;
 347         time_t submitted = time(NULL);
 348         time_t attempted = 0;
 349         char *bounceto = NULL;
 350         char *envelope_from = NULL;
 351         char *source_room = NULL;
 352
 353         char cfgline[SIZ];
 354         for (i = 0; i < num_tokens(instr, '\n'); ++i) {
 355                 extract_token(cfgline, instr, i, '\n', sizeof cfgline);
 356                 if (!strncasecmp(cfgline, HKEY("msgid|")))              msgid = atol(&cfgline[6]);
 357                 if (!strncasecmp(cfgline, HKEY("submitted|")))          submitted = atol(&cfgline[10]);
 358                 if (!strncasecmp(cfgline, HKEY("attempted|")))          attempted = atol(&cfgline[10]);
 359                 if (!strncasecmp(cfgline, HKEY("bounceto|")))           bounceto = strdup(&cfgline[9]);
 360                 if (!strncasecmp(cfgline, HKEY("envelope_from|")))      envelope_from = strdup(&cfgline[14]);
 361                 if (!strncasecmp(cfgline, HKEY("source_room|")))        source_room = strdup(&cfgline[12]);
 362         }
 363
 364         int should_try_now = 0;
 365         if (attempted < submitted) {                    // If no attempts have been made yet, try now
 366                 should_try_now = 1;
 367         }
 368         else if ((attempted - submitted) <= 14400) {
 369                 if ((time(NULL) - attempted) > 1800) {  // First four hours, retry every 30 minutes
 370                         should_try_now = 1;
 371                 }
 372         }
 373         else {
 374                 if ((time(NULL) - attempted) > 14400) { // After that, retry once every 4 hours
 375                         should_try_now = 1;
 376                 }
 377         }
 378
 379         if (should_try_now) {
 380                 syslog(LOG_DEBUG, "smtpclient: attempting delivery of message <%ld> now", qmsgnum);
 381                 if (source_room) {
 382                         syslog(LOG_DEBUG, "smtpclient: this message originated in <%s>", source_room);
 383                 }
 384                 StrBuf *NewInstr = NewStrBuf();
 385                 StrBufAppendPrintf(NewInstr, "Content-type: " SPOOLMIME "\n\n");
 386                 StrBufAppendPrintf(NewInstr, "msgid|%ld\n", msgid);
 387                 StrBufAppendPrintf(NewInstr, "submitted|%ld\n", submitted);
 388                 if (bounceto) {
 389                         StrBufAppendPrintf(NewInstr, "bounceto|%s\n", bounceto);
 390                 }
 391                 if (envelope_from) {
 392                         StrBufAppendPrintf(NewInstr, "envelope_from|%s\n", envelope_from);
 393                 }
 394                 for (i = 0; i < num_tokens(instr, '\n'); ++i) {
 395                         extract_token(cfgline, instr, i, '\n', sizeof cfgline);
 396                         if (!strncasecmp(cfgline, HKEY("remote|"))) {
 397                                 char recp[SIZ];
 398                                 int previous_result = extract_int(cfgline, 2);
 399                                 if ((previous_result == 0) || (previous_result == 4)) {
 400                                         int new_result = 421;
 401                                         extract_token(recp, cfgline, 1, '|', sizeof recp);
 402                                         new_result = smtp_attempt_delivery(msgid, recp, envelope_from, source_room, server_response);
 403                                         syslog(LOG_DEBUG, "smtpclient: recp: <%s> , result: %d (%s)", recp, new_result, server_response);
 404                                         if ((new_result / 100) == 2) {
 405                                                 ++num_success;
 406                                         }
 407                                         else {
 408                                                 if ((new_result / 100) == 5) {
 409                                                         ++num_fail;
 410                                                 }
 411                                                 else {
 412                                                         ++num_delayed;
 413                                                 }
 414                                                 StrBufAppendPrintf(NewInstr, "remote|%s|%ld|%ld (%s)\n", recp, (new_result / 100), new_result, server_response);
 415                                         }
 416                                 }
 417                         }
 418                 }
 419
 420                 StrBufAppendPrintf(NewInstr, "attempted|%ld\n", time(NULL));
 421
 422                 // All deliveries have now been attempted.  Now determine the disposition of this queue entry.
 423
 424                 time_t age = time(NULL) - submitted;
 425                 syslog(LOG_DEBUG,
 426                        "smtpclient: submission age: %ldd%ldh%ldm%lds",
 427                        (age / 86400), ((age % 86400) / 3600), ((age % 3600) / 60), (age % 60));
 428                 syslog(LOG_DEBUG, "smtpclient: num_success=%d , num_fail=%d , num_delayed=%d", num_success, num_fail, num_delayed);
 429
 430                 // If there are permanent fails on this attempt, deliver a bounce to the user.
 431                 // The 5XX fails will be recorded in the rewritten queue, but they will be removed before the next attempt.
 432                 if (num_fail > 0) {
 433                         smtp_do_bounce(ChrPtr(NewInstr), SDB_BOUNCE_FATALS);
 434                 }
 435                 // If all deliveries have either succeeded or failed, we are finished with this queue entry.
 436                 if (num_delayed == 0) {
 437                         delete_this_queue = 1;
 438                 }
 439                 // If it's been more than five days, give up and tell the sender that delivery failed
 440                 else if ((time(NULL) - submitted) > SMTP_DELIVER_FAIL) {
 441                         smtp_do_bounce(ChrPtr(NewInstr), SDB_BOUNCE_ALL);
 442                         delete_this_queue = 1;
 443                 }
 444                 // If it's been more than four hours but less than five days, warn the sender that delivery is delayed
 445                 else if (((attempted - submitted) < SMTP_DELIVER_WARN) && ((time(NULL) - submitted) >= SMTP_DELIVER_WARN)) {
 446                         smtp_do_bounce(ChrPtr(NewInstr), SDB_WARN);
 447                 }
 448
 449                 if (delete_this_queue) {
 450                         syslog(LOG_DEBUG, "smtpclient: %ld deleting", qmsgnum);
 451                         deletes[0] = qmsgnum;
 452                         deletes[1] = msgid;
 453                         CtdlDeleteMessages(SMTP_SPOOLOUT_ROOM, deletes, 2, "");
 454                         FreeStrBuf(&NewInstr);  // We have to free NewInstr here, no longer needed
 455                 }
 456                 else {
 457                         // replace the old queue entry with the new one
 458                         syslog(LOG_DEBUG, "smtpclient: %ld rewriting", qmsgnum);
 459                         msg = convert_internet_message_buf(&NewInstr);  // This function will free NewInstr for us
 460                         CtdlSubmitMsg(msg, NULL, SMTP_SPOOLOUT_ROOM);
 461                         CM_Free(msg);
 462                         CtdlDeleteMessages(SMTP_SPOOLOUT_ROOM, &qmsgnum, 1, "");
 463                 }
 464         }
 465         else {
 466                 syslog(LOG_DEBUG, "smtpclient: %ld retry time not reached", qmsgnum);
 467         }
 468
 469         if (bounceto != NULL) {
 470                 free(bounceto);
 471         }
 472         if (envelope_from != NULL) {
 473                 free(envelope_from);
 474         }
 475         if (source_room != NULL) {
 476                 free(source_room);
 477         }
 478         free(instr);
 479 }
 480
 481
 482 // Callback for smtp_do_queue()
 483 void smtp_add_msg(long msgnum, void *userdata) {
 484         Array *smtp_queue = (Array *) userdata;
 485         array_append(smtp_queue, &msgnum);
 486 }
 487
 488
 489 enum {
 490         FULL_QUEUE_RUN,         // try to process the entire queue, including messages that have already been attempted
 491         QUICK_QUEUE_RUN         // only process jobs in the queue that have not been tried yet
 492 };
 493
 494
 495 // Run through the queue sending out messages.
 496 void smtp_do_queue(int type_of_queue_run) {
 497         static int doing_smtpclient = 0;
 498         int i = 0;
 499
 500         // This is a concurrency check to make sure only one smtpclient run is done at a time.
 501         begin_critical_section(S_SMTPQUEUE);
 502         if (doing_smtpclient) {
 503                 end_critical_section(S_SMTPQUEUE);
 504                 return;
 505         }
 506         doing_smtpclient = 1;
 507         end_critical_section(S_SMTPQUEUE);
 508
 509         syslog(LOG_DEBUG, "smtpclient: start %s queue run , last_queue_job_processed=%ld , last_queue_job_submitted=%ld",
 510                 (type_of_queue_run == QUICK_QUEUE_RUN ? "quick" : "full"),
 511                 last_queue_job_processed, last_queue_job_submitted
 512         );
 513
 514         if (CtdlGetRoom(&CC->room, SMTP_SPOOLOUT_ROOM) != 0) {
 515                 syslog(LOG_WARNING, "smtpclient: cannot find room <%s>", SMTP_SPOOLOUT_ROOM);
 516                 doing_smtpclient = 0;
 517                 return;
 518         }
 519
 520         // This array will hold the list of queue job messages
 521         Array *smtp_queue = array_new(sizeof(long));
 522         if (smtp_queue == NULL) {
 523                 syslog(LOG_WARNING, "smtpclient: cannot allocate queue array");
 524                 doing_smtpclient = 0;
 525                 return;
 526         }
 527
 528         // Put the queue in memory so we can close the db cursor
 529         CtdlForEachMessage(
 530                 (type_of_queue_run == QUICK_QUEUE_RUN ? MSGS_GT : MSGS_ALL),            // quick = new jobs; full = all jobs
 531                 (type_of_queue_run == QUICK_QUEUE_RUN ? last_queue_job_processed : 0),  // quick = new jobs; full = all jobs
 532                 NULL,
 533                 SPOOLMIME,              // Searching for Content-type of SPOOLIME will give us only queue instruction messages
 534                 NULL,
 535                 smtp_add_msg,           // That's our callback function to add a job to the queue
 536                 (void *)smtp_queue
 537         );
 538
 539         // We are ready to run through the queue now.
 540         syslog(LOG_DEBUG, "smtpclient: %d messages to be processed", array_len(smtp_queue));
 541         for (i = 0; i < array_len(smtp_queue); ++i) {
 542                 long m;
 543                 memcpy(&m, array_get_element_at(smtp_queue, i), sizeof(long));
 544                 smtp_process_one_msg(m);
 545         }
 546
 547         array_free(smtp_queue);
 548         last_queue_job_processed = last_queue_job_submitted;
 549         doing_smtpclient = 0;
 550         syslog(LOG_DEBUG, "smtpclient: end %s queue run , last_queue_job_processed=%ld , last_queue_job_submitted=%ld",
 551                 (type_of_queue_run == QUICK_QUEUE_RUN ? "quick" : "full"),
 552                 last_queue_job_processed, last_queue_job_submitted
 553         );
 554 }
 555
 556
 557 // The "full" queue run goes through the entire queue, attempting delivery for newly submitted messages,
 558 // retrying failed deliveries periodically, and handling undeliverable messages.
 559 void smtp_do_queue_full(void) {
 560         smtp_do_queue(FULL_QUEUE_RUN);
 561 }
 562
 563
 564 // The "quick" queue run only handles newly submitted messages, allowing them to be delivered immediately
 565 // instead of waiting for the next "full" queue run.
 566 void smtp_do_queue_quick(void) {
 567         if (last_queue_job_submitted > last_queue_job_processed) {
 568                 smtp_do_queue(QUICK_QUEUE_RUN);
 569         }
 570 }
 571
 572
 573 // Initialization function, called from modules_init.c
 574 char *ctdl_module_init_smtpclient(void) {
 575         if (!threading) {
 576                 CtdlRegisterMessageHook(smtp_aftersave, EVT_AFTERSAVE);
 577                 CtdlRegisterSessionHook(smtp_do_queue_quick, EVT_HOUSE, PRIO_AGGR + 51);
 578                 CtdlRegisterSessionHook(smtp_do_queue_full, EVT_TIMER, PRIO_AGGR + 51);
 579                 smtp_init_spoolout();
 580         }
 581
 582         // return our module id for the log
 583         return "smtpclient";
 584 }