]> code.citadel.org Git - citadel.git/blob - citadel/server/modules/smtp/serv_smtpclient.c
Extract private key from config database
[citadel.git] / 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-2024 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
221         // If we have a source room, it's probably a mailing list message; generate an unsubscribe header
222         if (!IsEmptyStr(source_room)) {
223                 char base_url[SIZ];
224                 char unsubscribe_url[SIZ];
225                 snprintf(base_url, sizeof base_url, "https://%s/listsub", CtdlGetConfigStr("c_fqdn"));
226                 generate_one_click_url(unsubscribe_url, base_url, "unsubscribe", source_room, recp);
227                 cprintf("List-Unsubscribe: %s\r\n", unsubscribe_url);
228                 cprintf("List-Unsubscribe-Post: List-Unsubscribe=One-Click\r\n");       // RFC 8058
229
230         }
231
232         CtdlOutputMsg(msgid, MT_RFC822, HEADERS_ALL, 0, 1, NULL, 0, NULL, &fromaddr, NULL);
233         s.TheMessage = CC->redirect_buffer;
234         CC->redirect_buffer = NULL;
235
236         // If we have a DKIM key, try to sign the message.
237         char *dkim_private_key = CtdlGetConfigStr("dkim_private_key");
238         char *dkim_selector = CtdlGetConfigStr("dkim_selector");
239         if (!IsEmptyStr(dkim_private_key) && !IsEmptyStr(dkim_selector)) {
240                 char *pkey = strdup(dkim_private_key);
241                 if (pkey) {
242                         char *sp;
243                         while (sp = strchr(pkey, '_')) {
244                                 *sp = '\n';
245                         }
246                         syslog(LOG_DEBUG, "private key: <%s>\n", pkey);
247                         dkim_sign(s.TheMessage, pkey, "dev.citadel.org", dkim_selector);        // FIXME use the right hostname
248                         free(pkey);
249                 }
250         }
251
252         // Prepare the buffer for transmittal
253         s.bytes_total = StrLength(s.TheMessage);
254         s.bytes_sent = 0;
255         response_code = 421;
256
257
258         // Keep trying MXes until one works or we run out.
259         for (i = 0; ((i < num_mx) && ((response_code / 100) == 4)); ++i) {
260                 response_code = 421;    // default 421 makes non-protocol errors transient
261                 s.bytes_sent = 0;       // rewind our buffer in case we try multiple MXes
262
263                 curl = curl_easy_init();
264                 if (curl) {
265                         response[0] = 0;
266
267                         if (!IsEmptyStr(envelope_from)) {
268                                 curl_easy_setopt(curl, CURLOPT_MAIL_FROM, envelope_from);
269                         }
270                         else {
271                                 curl_easy_setopt(curl, CURLOPT_MAIL_FROM, fromaddr);
272                         }
273
274                         recipients = curl_slist_append(recipients, recp);
275                         curl_easy_setopt(curl, CURLOPT_MAIL_RCPT, recipients);
276                         curl_easy_setopt(curl, CURLOPT_READFUNCTION, upload_source);
277                         curl_easy_setopt(curl, CURLOPT_READDATA, &s);
278                         curl_easy_setopt(curl, CURLOPT_UPLOAD, 1);                              // tell libcurl we are uploading
279                         curl_easy_setopt(curl, CURLOPT_TIMEOUT, 20L);                           // Time out after 20 seconds
280                         if (CtdlGetConfigInt("c_smtpclient_disable_starttls") == 0) {
281                                 curl_easy_setopt(curl, CURLOPT_USE_SSL, CURLUSESSL_TRY);        // Attempt STARTTLS if offered
282                         }
283                         curl_easy_setopt(curl, CURLOPT_SSL_VERIFYPEER, 0L);
284                         curl_easy_setopt(curl, CURLOPT_SSL_VERIFYHOST, 0L);
285                         curl_easy_setopt(curl, CURLOPT_DEBUGFUNCTION, ctdl_libcurl_smtp_debug_callback);
286                         curl_easy_setopt(curl, CURLOPT_DEBUGDATA, (void *) response);
287                         curl_easy_setopt(curl, CURLOPT_VERBOSE, 1L);
288
289                         // Construct an SMTP URL in the form of:
290                         //      smtp[s]://target_host/source_host
291                         // This looks weird but libcurl uses that last part to set our name for EHLO or HELO.
292                         // We check for "smtp://" and "smtps://" because an admin may have put those prefixes in a smart-host entry
293                         // If there is no prefix we add "smtp://"
294                         extract_token(try_this_mx, mxes, i, '|', (sizeof try_this_mx - 7));
295                         snprintf(smtp_url, sizeof smtp_url,
296                                 "%s%s/%s",
297                                 (((!strncasecmp(try_this_mx, HKEY("smtp://")))
298                                 || (!strncasecmp(try_this_mx, HKEY("smtps://")))) ? "" : "smtp://"),
299                                 try_this_mx, CtdlGetConfigStr("c_fqdn")
300                         );
301                         curl_easy_setopt(curl, CURLOPT_URL, smtp_url);
302                         syslog(LOG_DEBUG, "smtpclient: trying MX %d of %d <%s>", i+1, num_mx, smtp_url);        // send the message
303                         res = curl_easy_perform(curl);
304                         curl_easy_getinfo(curl, CURLINFO_RESPONSE_CODE, &response_code);
305                         syslog(LOG_DEBUG,
306                                "smtpclient: libcurl returned %d (%s) , SMTP response %ld",
307                                res, curl_easy_strerror(res), response_code
308                         );
309
310                         if ((res != CURLE_OK) && (response_code == 0)) {        // check for errors
311                                 response_code = 421;
312                         }
313
314                         curl_slist_free_all(recipients);
315                         recipients = NULL;                                      // this gets reused; avoid double-free
316                         curl_easy_cleanup(curl);
317                         curl = NULL;                                            // this gets reused; avoid double-free
318
319                         // Trim the error message buffer down to just the actual message
320                         trim_response(response_code, response);
321                 }
322         }
323
324         FreeStrBuf(&s.TheMessage);
325         if (fromaddr) {
326                 free(fromaddr);
327         }
328         return ((int) response_code);
329 }
330
331
332 // Process one outbound message.
333 void smtp_process_one_msg(long qmsgnum) {
334         struct CtdlMessage *msg = NULL;
335         char *instr = NULL;
336         int i;
337         int num_success = 0;
338         int num_fail = 0;
339         int num_delayed = 0;
340         long deletes[2];
341         int delete_this_queue = 0;
342         char server_response[SIZ];
343
344         msg = CtdlFetchMessage(qmsgnum, 1);
345         if (msg == NULL) {
346                 syslog(LOG_WARNING, "smtpclient: msg#%ld does not exist", qmsgnum);
347                 return;
348         }
349
350         instr = msg->cm_fields[eMessageText];
351         msg->cm_fields[eMessageText] = NULL;
352         CM_Free(msg);
353
354         // if the queue job message has any CRLF's convert them to LF's
355         char *crlf = NULL;
356         while (crlf = strstr(instr, "\r\n"), crlf != NULL) {
357                 strcpy(crlf, crlf + 1);
358         }
359
360         // Strip out the headers and we are now left with just the instructions.
361         char *soi = strstr(instr, "\n\n");
362         if (soi) {
363                 strcpy(instr, soi + 2);
364         }
365
366         long msgid = 0;
367         time_t submitted = time(NULL);
368         time_t attempted = 0;
369         char *bounceto = NULL;
370         char *envelope_from = NULL;
371         char *source_room = NULL;
372
373         char cfgline[SIZ];
374         for (i = 0; i < num_tokens(instr, '\n'); ++i) {
375                 extract_token(cfgline, instr, i, '\n', sizeof cfgline);
376                 if (!strncasecmp(cfgline, HKEY("msgid|")))              msgid = atol(&cfgline[6]);
377                 if (!strncasecmp(cfgline, HKEY("submitted|")))          submitted = atol(&cfgline[10]);
378                 if (!strncasecmp(cfgline, HKEY("attempted|")))          attempted = atol(&cfgline[10]);
379                 if (!strncasecmp(cfgline, HKEY("bounceto|")))           bounceto = strdup(&cfgline[9]);
380                 if (!strncasecmp(cfgline, HKEY("envelope_from|")))      envelope_from = strdup(&cfgline[14]);
381                 if (!strncasecmp(cfgline, HKEY("source_room|")))        source_room = strdup(&cfgline[12]);
382         }
383
384         int should_try_now = 0;
385         if (attempted < submitted) {                    // If no attempts have been made yet, try now
386                 should_try_now = 1;
387         }
388         else if ((attempted - submitted) <= 14400) {
389                 if ((time(NULL) - attempted) > 1800) {  // First four hours, retry every 30 minutes
390                         should_try_now = 1;
391                 }
392         }
393         else {
394                 if ((time(NULL) - attempted) > 14400) { // After that, retry once every 4 hours
395                         should_try_now = 1;
396                 }
397         }
398
399         if (should_try_now) {
400                 syslog(LOG_DEBUG, "smtpclient: attempting delivery of message <%ld> now", qmsgnum);
401                 if (source_room) {
402                         syslog(LOG_DEBUG, "smtpclient: this message originated in <%s>", source_room);
403                 }
404                 StrBuf *NewInstr = NewStrBuf();
405                 StrBufAppendPrintf(NewInstr, "Content-type: " SPOOLMIME "\n\n");
406                 StrBufAppendPrintf(NewInstr, "msgid|%ld\n", msgid);
407                 StrBufAppendPrintf(NewInstr, "submitted|%ld\n", submitted);
408                 if (bounceto) {
409                         StrBufAppendPrintf(NewInstr, "bounceto|%s\n", bounceto);
410                 }
411                 if (envelope_from) {
412                         StrBufAppendPrintf(NewInstr, "envelope_from|%s\n", envelope_from);
413                 }
414                 for (i = 0; i < num_tokens(instr, '\n'); ++i) {
415                         extract_token(cfgline, instr, i, '\n', sizeof cfgline);
416                         if (!strncasecmp(cfgline, HKEY("remote|"))) {
417                                 char recp[SIZ];
418                                 int previous_result = extract_int(cfgline, 2);
419                                 if ((previous_result == 0) || (previous_result == 4)) {
420                                         int new_result = 421;
421                                         extract_token(recp, cfgline, 1, '|', sizeof recp);
422                                         new_result = smtp_attempt_delivery(msgid, recp, envelope_from, source_room, server_response);
423                                         syslog(LOG_DEBUG, "smtpclient: recp: <%s> , result: %d (%s)", recp, new_result, server_response);
424                                         if ((new_result / 100) == 2) {
425                                                 ++num_success;
426                                         }
427                                         else {
428                                                 if ((new_result / 100) == 5) {
429                                                         ++num_fail;
430                                                 }
431                                                 else {
432                                                         ++num_delayed;
433                                                 }
434                                                 StrBufAppendPrintf(NewInstr, "remote|%s|%ld|%ld (%s)\n", recp, (new_result / 100), new_result, server_response);
435                                         }
436                                 }
437                         }
438                 }
439
440                 StrBufAppendPrintf(NewInstr, "attempted|%ld\n", time(NULL));
441
442                 // All deliveries have now been attempted.  Now determine the disposition of this queue entry.
443
444                 time_t age = time(NULL) - submitted;
445                 syslog(LOG_DEBUG,
446                        "smtpclient: submission age: %ldd%ldh%ldm%lds",
447                        (age / 86400), ((age % 86400) / 3600), ((age % 3600) / 60), (age % 60));
448                 syslog(LOG_DEBUG, "smtpclient: num_success=%d , num_fail=%d , num_delayed=%d", num_success, num_fail, num_delayed);
449
450                 // If there are permanent fails on this attempt, deliver a bounce to the user.
451                 // The 5XX fails will be recorded in the rewritten queue, but they will be removed before the next attempt.
452                 if (num_fail > 0) {
453                         smtp_do_bounce(ChrPtr(NewInstr), SDB_BOUNCE_FATALS);
454                 }
455                 // If all deliveries have either succeeded or failed, we are finished with this queue entry.
456                 if (num_delayed == 0) {
457                         delete_this_queue = 1;
458                 }
459                 // If it's been more than five days, give up and tell the sender that delivery failed
460                 else if ((time(NULL) - submitted) > SMTP_DELIVER_FAIL) {
461                         smtp_do_bounce(ChrPtr(NewInstr), SDB_BOUNCE_ALL);
462                         delete_this_queue = 1;
463                 }
464                 // If it's been more than four hours but less than five days, warn the sender that delivery is delayed
465                 else if (((attempted - submitted) < SMTP_DELIVER_WARN) && ((time(NULL) - submitted) >= SMTP_DELIVER_WARN)) {
466                         smtp_do_bounce(ChrPtr(NewInstr), SDB_WARN);
467                 }
468
469                 if (delete_this_queue) {
470                         syslog(LOG_DEBUG, "smtpclient: %ld deleting", qmsgnum);
471                         deletes[0] = qmsgnum;
472                         deletes[1] = msgid;
473                         CtdlDeleteMessages(SMTP_SPOOLOUT_ROOM, deletes, 2, "");
474                         FreeStrBuf(&NewInstr);  // We have to free NewInstr here, no longer needed
475                 }
476                 else {
477                         // replace the old queue entry with the new one
478                         syslog(LOG_DEBUG, "smtpclient: %ld rewriting", qmsgnum);
479                         msg = convert_internet_message_buf(&NewInstr);  // This function will free NewInstr for us
480                         CtdlSubmitMsg(msg, NULL, SMTP_SPOOLOUT_ROOM);
481                         CM_Free(msg);
482                         CtdlDeleteMessages(SMTP_SPOOLOUT_ROOM, &qmsgnum, 1, "");
483                 }
484         }
485         else {
486                 syslog(LOG_DEBUG, "smtpclient: msg#%ld retry time not reached", qmsgnum);
487         }
488
489         if (bounceto != NULL) {
490                 free(bounceto);
491         }
492         if (envelope_from != NULL) {
493                 free(envelope_from);
494         }
495         if (source_room != NULL) {
496                 free(source_room);
497         }
498         free(instr);
499 }
500
501
502 // Callback for smtp_do_queue()
503 void smtp_add_msg(long msgnum, void *userdata) {
504         Array *smtp_queue = (Array *) userdata;
505         array_append(smtp_queue, &msgnum);
506 }
507
508
509 enum {
510         FULL_QUEUE_RUN,         // try to process the entire queue, including messages that have already been attempted
511         QUICK_QUEUE_RUN         // only process jobs in the queue that have not been tried yet
512 };
513
514
515 // Run through the queue sending out messages.
516 void smtp_do_queue(int type_of_queue_run) {
517         static int doing_smtpclient = 0;
518         int i = 0;
519
520         // This is a concurrency check to make sure only one smtpclient run is done at a time.
521         begin_critical_section(S_SMTPQUEUE);
522         if (doing_smtpclient) {
523                 end_critical_section(S_SMTPQUEUE);
524                 return;
525         }
526         doing_smtpclient = 1;
527         end_critical_section(S_SMTPQUEUE);
528
529         syslog(LOG_DEBUG, "smtpclient: start %s queue run , last_queue_job_processed=%ld , last_queue_job_submitted=%ld",
530                 (type_of_queue_run == QUICK_QUEUE_RUN ? "quick" : "full"),
531                 last_queue_job_processed, last_queue_job_submitted
532         );
533
534         if (CtdlGetRoom(&CC->room, SMTP_SPOOLOUT_ROOM) != 0) {
535                 syslog(LOG_WARNING, "smtpclient: cannot find room <%s>", SMTP_SPOOLOUT_ROOM);
536                 doing_smtpclient = 0;
537                 return;
538         }
539
540         // This array will hold the list of queue job messages
541         Array *smtp_queue = array_new(sizeof(long));
542         if (smtp_queue == NULL) {
543                 syslog(LOG_WARNING, "smtpclient: cannot allocate queue array");
544                 doing_smtpclient = 0;
545                 return;
546         }
547
548         // Put the queue in memory so we can close the db cursor
549         CtdlForEachMessage(
550                 (type_of_queue_run == QUICK_QUEUE_RUN ? MSGS_GT : MSGS_ALL),            // quick = new jobs; full = all jobs
551                 (type_of_queue_run == QUICK_QUEUE_RUN ? last_queue_job_processed : 0),  // quick = new jobs; full = all jobs
552                 NULL,
553                 SPOOLMIME,              // Searching for Content-type of SPOOLIME will give us only queue instruction messages
554                 NULL,
555                 smtp_add_msg,           // That's our callback function to add a job to the queue
556                 (void *)smtp_queue
557         );
558
559         // We are ready to run through the queue now.
560         syslog(LOG_DEBUG, "smtpclient: %d messages to be processed", array_len(smtp_queue));
561         for (i = 0; i < array_len(smtp_queue); ++i) {
562                 long m;
563                 memcpy(&m, array_get_element_at(smtp_queue, i), sizeof(long));
564                 smtp_process_one_msg(m);
565         }
566
567         array_free(smtp_queue);
568         last_queue_job_processed = last_queue_job_submitted;
569         doing_smtpclient = 0;
570         syslog(LOG_DEBUG, "smtpclient: end %s queue run , last_queue_job_processed=%ld , last_queue_job_submitted=%ld",
571                 (type_of_queue_run == QUICK_QUEUE_RUN ? "quick" : "full"),
572                 last_queue_job_processed, last_queue_job_submitted
573         );
574 }
575
576
577 // The "full" queue run goes through the entire queue, attempting delivery for newly submitted messages,
578 // retrying failed deliveries periodically, and handling undeliverable messages.
579 void smtp_do_queue_full(void) {
580         smtp_do_queue(FULL_QUEUE_RUN);
581 }
582
583
584 // The "quick" queue run only handles newly submitted messages, allowing them to be delivered immediately
585 // instead of waiting for the next "full" queue run.
586 void smtp_do_queue_quick(void) {
587         if (last_queue_job_submitted > last_queue_job_processed) {
588                 smtp_do_queue(QUICK_QUEUE_RUN);
589         }
590 }
591
592
593 // Initialization function, called from modules_init.c
594 char *ctdl_module_init_smtpclient(void) {
595         if (!threading) {
596                 CtdlRegisterMessageHook(smtp_aftersave, EVT_AFTERSAVE);
597                 CtdlRegisterSessionHook(smtp_do_queue_quick, EVT_HOUSE, PRIO_AGGR + 51);
598                 CtdlRegisterSessionHook(smtp_do_queue_full, EVT_TIMER, PRIO_AGGR + 51);
599                 smtp_init_spoolout();
600         }
601
602         // return our module id for the log
603         return "smtpclient";
604 }