2 * IMAP server for the Citadel system
3 * Copyright (C) 2000-2009 by Art Cancro and others.
4 * This code is released under the terms of the GNU General Public License.
6 * WARNING: the IMAP protocol is badly designed. No implementation of it
7 * is perfect. Indeed, with so much gratuitous complexity, *all* IMAP
8 * implementations have bugs.
10 * This program is free software; you can redistribute it and/or modify
11 * it under the terms of the GNU General Public License as published by
12 * the Free Software Foundation; either version 3 of the License, or
13 * (at your option) any later version.
15 * This program is distributed in the hope that it will be useful,
16 * but WITHOUT ANY WARRANTY; without even the implied warranty of
17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
18 * GNU General Public License for more details.
20 * You should have received a copy of the GNU General Public License
21 * along with this program; if not, write to the Free Software
22 * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
33 #include <sys/types.h>
35 #if TIME_WITH_SYS_TIME
36 # include <sys/time.h>
40 # include <sys/time.h>
50 #include <libcitadel.h>
53 #include "citserver.h"
59 #include "internet_addressing.h"
60 #include "serv_imap.h"
61 #include "imap_tools.h"
62 #include "imap_list.h"
63 #include "imap_fetch.h"
64 #include "imap_search.h"
65 #include "imap_store.h"
67 #include "imap_metadata.h"
68 #include "imap_misc.h"
70 #include "ctdl_module.h"
72 HashList *ImapCmds = NULL;
73 void registerImapCMD(const char *First, long FLen,
74 const char *Second, long SLen,
80 h = (imap_handler_hook*) malloc(sizeof(imap_handler_hook));
81 memset(h, 0, sizeof(imap_handler_hook));
86 Put(ImapCmds, First, FLen, h, NULL);
90 memcpy(CMD, First, FLen);
91 memcpy(CMD+FLen, Second, SLen);
92 CMD[FLen+SLen] = '\0';
93 Put(ImapCmds, CMD, FLen + SLen, h, NULL);
97 const imap_handler_hook *imap_lookup(int num_parms, ConstStr *Params)
100 citimap *Imap = IMAP;
105 /* we abuse the Reply-buffer for uppercasing... */
106 StrBufPlain(Imap->Reply, CKEY(Params[1]));
107 StrBufUpCase(Imap->Reply);
109 CtdlLogPrintf(CTDL_DEBUG, "---- Looking up [%s] -----",
110 ChrPtr(Imap->Reply));
111 if (GetHash(ImapCmds, SKEY(Imap->Reply), &v))
113 CtdlLogPrintf(CTDL_DEBUG, "Found. \n");
114 FlushStrBuf(Imap->Reply);
115 return (imap_handler_hook *) v;
120 CtdlLogPrintf(CTDL_DEBUG, "NOT Found. \n");
121 FlushStrBuf(Imap->Reply);
125 CtdlLogPrintf(CTDL_DEBUG, "---- Looking up [%s] -----",
126 ChrPtr(Imap->Reply));
127 StrBufAppendBufPlain(Imap->Reply, CKEY(Params[2]), 0);
128 StrBufUpCase(Imap->Reply);
129 if (GetHash(ImapCmds, SKEY(Imap->Reply), &v))
131 CtdlLogPrintf(CTDL_DEBUG, "Found. \n");
132 FlushStrBuf(Imap->Reply);
133 return (imap_handler_hook *) v;
135 CtdlLogPrintf(CTDL_DEBUG, "NOT Found. \n");
136 FlushStrBuf(Imap->Reply);
140 /* imap_rename() uses this struct containing list of rooms to rename */
143 char irl_oldroom[ROOMNAMELEN];
144 char irl_newroom[ROOMNAMELEN];
148 /* Data which is passed between imap_rename() and imap_rename_backend() */
157 * If there is a message ID map in memory, free it
159 void imap_free_msgids(void)
161 citimap *Imap = IMAP;
162 if (Imap->msgids != NULL) {
168 if (Imap->flags != NULL) {
172 Imap->last_mtime = (-1);
177 * If there is a transmitted message in memory, free it
179 void imap_free_transmitted_message(void)
181 FreeStrBuf(&IMAP->TransmittedMessage);
186 * Set the \Seen, \Recent. and \Answered flags, based on the sequence
187 * sets stored in the visit record for this user/room. Note that we have
188 * to parse each sequence set manually here, because calling the utility
189 * function is_msg_in_sequence_set() over and over again is too expensive.
191 * first_msg should be set to 0 to rescan the flags for every message in the
192 * room, or some other value if we're only interested in an incremental
195 void imap_set_seen_flags(int first_msg)
197 citimap *Imap = IMAP;
202 char setstr[64], lostr[64], histr[64];
205 if (Imap->num_msgs < 1) return;
206 CtdlGetRelationship(&vbuf, &CC->user, &CC->room);
208 for (i = first_msg; i < Imap->num_msgs; ++i) {
209 Imap->flags[i] = Imap->flags[i] & ~IMAP_SEEN;
210 Imap->flags[i] |= IMAP_RECENT;
211 Imap->flags[i] = Imap->flags[i] & ~IMAP_ANSWERED;
215 * Do the "\Seen" flag.
216 * (Any message not "\Seen" is considered "\Recent".)
218 num_sets = num_tokens(vbuf.v_seen, ',');
219 for (s=0; s<num_sets; ++s) {
220 extract_token(setstr, vbuf.v_seen, s, ',', sizeof setstr);
222 extract_token(lostr, setstr, 0, ':', sizeof lostr);
223 if (num_tokens(setstr, ':') >= 2) {
224 extract_token(histr, setstr, 1, ':', sizeof histr);
225 if (!strcmp(histr, "*")) {
226 snprintf(histr, sizeof histr, "%ld", LONG_MAX);
230 strcpy(histr, lostr);
235 for (i = first_msg; i < Imap->num_msgs; ++i) {
236 if ((Imap->msgids[i] >= lo) && (Imap->msgids[i] <= hi)){
237 Imap->flags[i] |= IMAP_SEEN;
238 Imap->flags[i] = Imap->flags[i] & ~IMAP_RECENT;
243 /* Do the ANSWERED flag */
244 num_sets = num_tokens(vbuf.v_answered, ',');
245 for (s=0; s<num_sets; ++s) {
246 extract_token(setstr, vbuf.v_answered, s, ',', sizeof setstr);
248 extract_token(lostr, setstr, 0, ':', sizeof lostr);
249 if (num_tokens(setstr, ':') >= 2) {
250 extract_token(histr, setstr, 1, ':', sizeof histr);
251 if (!strcmp(histr, "*")) {
252 snprintf(histr, sizeof histr, "%ld", LONG_MAX);
256 strcpy(histr, lostr);
261 for (i = first_msg; i < Imap->num_msgs; ++i) {
262 if ((Imap->msgids[i] >= lo) && (Imap->msgids[i] <= hi)){
263 Imap->flags[i] |= IMAP_ANSWERED;
273 * Back end for imap_load_msgids()
275 * Optimization: instead of calling realloc() to add each message, we
276 * allocate space in the list for REALLOC_INCREMENT messages at a time. This
277 * allows the mapping to proceed much faster.
279 void imap_add_single_msgid(long msgnum, void *userdata)
281 citimap *Imap = IMAP;
284 if (Imap->num_msgs > Imap->num_alloc) {
285 Imap->num_alloc += REALLOC_INCREMENT;
286 Imap->msgids = realloc(Imap->msgids, (Imap->num_alloc * sizeof(long)) );
287 Imap->flags = realloc(Imap->flags, (Imap->num_alloc * sizeof(long)) );
289 Imap->msgids[Imap->num_msgs - 1] = msgnum;
290 Imap->flags[Imap->num_msgs - 1] = 0;
296 * Set up a message ID map for the current room (folder)
298 void imap_load_msgids(void)
300 struct cdbdata *cdbfr;
301 citimap *Imap = IMAP;
303 if (Imap->selected == 0) {
304 CtdlLogPrintf(CTDL_ERR,
305 "imap_load_msgids() can't run; no room selected\n");
309 imap_free_msgids(); /* If there was already a map, free it */
311 /* Load the message list */
312 cdbfr = cdb_fetch(CDB_MSGLISTS, &CC->room.QRnumber, sizeof(long));
314 Imap->msgids = malloc(cdbfr->len);
315 memcpy(Imap->msgids, cdbfr->ptr, cdbfr->len);
316 Imap->num_msgs = cdbfr->len / sizeof(long);
317 Imap->num_alloc = cdbfr->len / sizeof(long);
321 if (Imap->num_msgs) {
322 Imap->flags = malloc(Imap->num_alloc * sizeof(long));
323 memset(Imap->flags, 0, (Imap->num_alloc * sizeof(long)) );
326 imap_set_seen_flags(0);
331 * Re-scan the selected room (folder) and see if it's been changed at all
333 void imap_rescan_msgids(void)
335 citimap *Imap = IMAP;
336 int original_num_msgs = 0;
337 long original_highest = 0L;
339 int message_still_exists;
340 struct cdbdata *cdbfr;
341 long *msglist = NULL;
345 if (Imap->selected == 0) {
346 CtdlLogPrintf(CTDL_ERR, "imap_load_msgids() can't run; no room selected\n");
351 * Check to see if the room's contents have changed.
352 * If not, we can avoid this rescan.
354 CtdlGetRoom(&CC->room, CC->room.QRname);
355 if (Imap->last_mtime == CC->room.QRmtime) { /* No changes! */
359 /* Load the *current* message list from disk, so we can compare it
360 * to what we have in memory.
362 cdbfr = cdb_fetch(CDB_MSGLISTS, &CC->room.QRnumber, sizeof(long));
364 msglist = malloc(cdbfr->len);
365 if (msglist == NULL) {
366 CtdlLogPrintf(CTDL_CRIT, "malloc() failed\n");
369 memcpy(msglist, cdbfr->ptr, (size_t)cdbfr->len);
370 num_msgs = cdbfr->len / sizeof(long);
377 * Check to see if any of the messages we know about have been expunged
379 if (Imap->num_msgs > 0) {
381 for (i = 0; i < Imap->num_msgs; ++i) {
383 message_still_exists = 0;
385 for (j = jstart; j < num_msgs; ++j) {
386 if (msglist[j] == Imap->msgids[i]) {
387 message_still_exists = 1;
394 if (message_still_exists == 0) {
395 IAPrintf("* %d EXPUNGE\r\n", i + 1);
397 /* Here's some nice stupid nonsense. When a
398 * message is expunged, we have to slide all
399 * the existing messages up in the message
403 memcpy(&Imap->msgids[i],
404 &Imap->msgids[i + 1],
406 (Imap->num_msgs - i)));
407 memcpy(&Imap->flags[i],
410 (Imap->num_msgs - i)));
419 * Remember how many messages were here before we re-scanned.
421 original_num_msgs = Imap->num_msgs;
422 if (Imap->num_msgs > 0) {
423 original_highest = Imap->msgids[Imap->num_msgs - 1];
425 original_highest = 0L;
429 * Now peruse the room for *new* messages only.
430 * This logic is probably the cause of Bug # 368
431 * [ http://bugzilla.citadel.org/show_bug.cgi?id=368 ]
434 for (j = 0; j < num_msgs; ++j) {
435 if (msglist[j] > original_highest) {
436 imap_add_single_msgid(msglist[j], NULL);
440 imap_set_seen_flags(original_num_msgs);
443 * If new messages have arrived, tell the client about them.
445 if (Imap->num_msgs > original_num_msgs) {
447 for (j = 0; j < num_msgs; ++j) {
448 if (Imap->flags[j] & IMAP_RECENT) {
453 IAPrintf("* %d EXISTS\r\n", Imap->num_msgs);
454 IAPrintf("* %d RECENT\r\n", num_recent);
460 Imap->last_mtime = CC->room.QRmtime;
465 * This cleanup function blows away the temporary memory and files used by
468 void imap_cleanup_function(void)
470 citimap *Imap = IMAP;
472 /* Don't do this stuff if this is not a Imap session! */
473 if (CC->h_command_function != imap_command_loop)
476 /* If there is a mailbox selected, auto-expunge it. */
477 if (Imap->selected) {
481 CtdlLogPrintf(CTDL_DEBUG, "Performing IMAP cleanup hook\n");
483 imap_free_transmitted_message();
485 if (Imap->cached_rfc822 != NULL) {
486 FreeStrBuf(&Imap->cached_rfc822);
487 Imap->cached_rfc822_msgnum = (-1);
488 Imap->cached_rfc822_withbody = 0;
491 if (Imap->cached_body != NULL) {
492 free(Imap->cached_body);
493 Imap->cached_body = NULL;
494 Imap->cached_body_len = 0;
495 Imap->cached_bodymsgnum = (-1);
497 FreeStrBuf(&Imap->Cmd.CmdBuf);
498 FreeStrBuf(&Imap->Reply);
499 if (Imap->Cmd.Params != NULL) free(Imap->Cmd.Params);
501 CtdlLogPrintf(CTDL_DEBUG, "Finished IMAP cleanup hook\n");
506 * Does the actual work of the CAPABILITY command (because we need to
507 * output this stuff in other places as well)
509 void imap_output_capability_string(void) {
510 IAPuts("CAPABILITY IMAP4REV1 NAMESPACE ID AUTH=PLAIN AUTH=LOGIN UIDPLUS");
513 if (!CC->redirect_ssl) IAPuts(" STARTTLS");
516 #ifndef DISABLE_IMAP_ACL
520 /* We are building a partial implementation of METADATA for the sole purpose
521 * of interoperating with the ical/vcard version of the Bynari Insight Connector.
522 * It is not a full RFC5464 implementation, but it should refuse non-Bynari
523 * metadata in a compatible and graceful way.
528 * LIST-EXTENDED was originally going to be required by the METADATA extension.
529 * It was mercifully removed prior to the finalization of RFC5464. We started
530 * implementing this but stopped when we learned that it would not be needed.
531 * If you uncomment this declaration you are responsible for writing a lot of new
534 * IAPuts(" LIST-EXTENDED")
540 * implements the CAPABILITY command
542 void imap_capability(int num_parms, ConstStr *Params)
545 imap_output_capability_string();
547 IReply("OK CAPABILITY completed");
552 * Implements the ID command (specified by RFC2971)
554 * We ignore the client-supplied information, and output a NIL response.
555 * Although this is technically a valid implementation of the extension, it
556 * is quite useless. It exists only so that we may see which clients are
557 * making use of this extension.
560 void imap_id(int num_parms, ConstStr *Params)
562 IAPuts("* ID NIL\r\n");
563 IReply("OK ID completed");
568 * Here's where our IMAP session begins its happy day.
570 void imap_greeting(void)
573 CitContext *CCC = CC;
575 strcpy(CCC->cs_clientname, "IMAP session");
576 CCC->session_specific_data = malloc(sizeof(citimap));
577 Imap = (citimap *)CCC->session_specific_data;
578 memset(Imap, 0, sizeof(citimap));
579 Imap->authstate = imap_as_normal;
580 Imap->cached_rfc822_msgnum = (-1);
581 Imap->cached_rfc822_withbody = 0;
582 Imap->Reply = NewStrBufPlain(NULL, SIZ * 10); /* 40k */
586 IAPuts("* BYE; Server busy, try later\r\n");
593 imap_output_capability_string();
594 IAPrintf("] %s IMAP4rev1 %s ready\r\n", config.c_fqdn, CITADEL);
600 * IMAPS is just like IMAP, except it goes crypto right away.
602 void imaps_greeting(void) {
603 CtdlModuleStartCryptoMsgs(NULL, NULL, NULL);
605 if (!CC->redirect_ssl) CC->kill_me = 1; /* kill session if no crypto */
612 * implements the LOGIN command (ordinary username/password login)
614 void imap_login(int num_parms, ConstStr *Params)
619 if (Params[2].Key[0] == '{') {
620 IAPuts("+ go ahead\r\n");
621 IMAP->authstate = imap_as_expecting_multilineusername;
622 strcpy(IMAP->authseq, Params[0].Key);
626 IReply("BAD incorrect number of parameters");
630 if (CtdlLoginExistingUser(NULL, Params[2].Key) == login_ok) {
631 if (CtdlTryPassword(Params[3].Key, Params[3].len) == pass_ok) {
632 /* hm, thats not doable by IReply :-( */
633 IAPrintf("%s OK [", Params[0].Key);
634 imap_output_capability_string();
635 IAPrintf("] Hello, %s\r\n", CC->user.fullname);
640 IReplyPrintf("NO AUTHENTICATE %s failed",
645 IReply("BAD Login incorrect");
647 IReply("BAD incorrect number of parameters");
655 * Implements the AUTHENTICATE command
657 void imap_authenticate(int num_parms, ConstStr *Params)
661 if (num_parms != 3) {
662 IReply("BAD incorrect number of parameters");
667 IReply("BAD Already logged in.");
671 if (!strcasecmp(Params[2].Key, "LOGIN")) {
672 CtdlEncodeBase64(UsrBuf, "Username:", 9, 0);
673 IAPrintf("+ %s\r\n", UsrBuf);
674 IMAP->authstate = imap_as_expecting_username;
675 strcpy(IMAP->authseq, Params[0].Key);
679 if (!strcasecmp(Params[2].Key, "PLAIN")) {
680 // CtdlEncodeBase64(UsrBuf, "Username:", 9, 0);
681 // IAPuts("+ %s\r\n", UsrBuf);
683 IMAP->authstate = imap_as_expecting_plainauth;
684 strcpy(IMAP->authseq, Params[0].Key);
689 IReplyPrintf("NO AUTHENTICATE %s failed",
695 void imap_auth_plain(void)
697 citimap *Imap = IMAP;
698 const char *decoded_authstring;
705 memset(pass, 0, sizeof(pass));
706 StrBufDecodeBase64(Imap->Cmd.CmdBuf);
708 decoded_authstring = ChrPtr(Imap->Cmd.CmdBuf);
709 safestrncpy(ident, decoded_authstring, sizeof ident);
710 safestrncpy(user, &decoded_authstring[strlen(ident) + 1], sizeof user);
711 len = safestrncpy(pass, &decoded_authstring[strlen(ident) + strlen(user) + 2], sizeof pass);
713 len = sizeof(pass) - 1;
715 Imap->authstate = imap_as_normal;
717 if (!IsEmptyStr(ident)) {
718 result = CtdlLoginExistingUser(user, ident);
721 result = CtdlLoginExistingUser(NULL, user);
724 if (result == login_ok) {
725 if (CtdlTryPassword(pass, len) == pass_ok) {
726 IAPrintf("%s OK authentication succeeded\r\n", Imap->authseq);
730 IAPrintf("%s NO authentication failed\r\n", Imap->authseq);
734 void imap_auth_login_user(long state)
737 citimap *Imap = IMAP;
740 case imap_as_expecting_username:
741 StrBufDecodeBase64(Imap->Cmd.CmdBuf);
742 CtdlLoginExistingUser(NULL, ChrPtr(Imap->Cmd.CmdBuf));
743 CtdlEncodeBase64(PWBuf, "Password:", 9, 0);
744 IAPrintf("+ %s\r\n", PWBuf);
746 Imap->authstate = imap_as_expecting_password;
748 case imap_as_expecting_multilineusername:
749 extract_token(PWBuf, ChrPtr(Imap->Cmd.CmdBuf), 1, ' ', sizeof(PWBuf));
750 CtdlLoginExistingUser(NULL, ChrPtr(Imap->Cmd.CmdBuf));
751 IAPuts("+ go ahead\r\n");
752 Imap->authstate = imap_as_expecting_multilinepassword;
758 void imap_auth_login_pass(long state)
760 citimap *Imap = IMAP;
761 const char *pass = NULL;
766 case imap_as_expecting_password:
767 StrBufDecodeBase64(Imap->Cmd.CmdBuf);
768 pass = ChrPtr(Imap->Cmd.CmdBuf);
769 len = StrLength(Imap->Cmd.CmdBuf);
771 case imap_as_expecting_multilinepassword:
772 pass = ChrPtr(Imap->Cmd.CmdBuf);
773 len = StrLength(Imap->Cmd.CmdBuf);
776 if (len > USERNAME_SIZE)
777 StrBufCutAt(Imap->Cmd.CmdBuf, USERNAME_SIZE, NULL);
779 if (CtdlTryPassword(pass, len) == pass_ok) {
780 IAPrintf("%s OK authentication succeeded\r\n", Imap->authseq);
782 IAPrintf("%s NO authentication failed\r\n", Imap->authseq);
784 Imap->authstate = imap_as_normal;
790 * implements the STARTTLS command (Citadel API version)
792 void imap_starttls(int num_parms, ConstStr *Params)
794 char ok_response[SIZ];
795 char nosup_response[SIZ];
796 char error_response[SIZ];
798 snprintf(ok_response, SIZ, "%s OK begin TLS negotiation now\r\n", Params[0].Key);
799 snprintf(nosup_response, SIZ, "%s NO TLS not supported here\r\n", Params[0].Key);
800 snprintf(error_response, SIZ, "%s BAD Internal error\r\n", Params[0].Key);
801 CtdlModuleStartCryptoMsgs(ok_response, nosup_response, error_response);
806 * implements the SELECT command
808 void imap_select(int num_parms, ConstStr *Params)
810 citimap *Imap = IMAP;
811 char towhere[ROOMNAMELEN];
812 char augmented_roomname[ROOMNAMELEN];
816 struct ctdlroom QRscratch;
822 /* Convert the supplied folder name to a roomname */
823 i = imap_roomname(towhere, sizeof towhere, Params[2].Key);
825 IReply("NO Invalid mailbox name.");
829 floornum = (i & 0x00ff);
830 roomflags = (i & 0xff00);
832 /* First try a regular match */
833 c = CtdlGetRoom(&QRscratch, towhere);
835 /* Then try a mailbox name match */
837 CtdlMailboxName(augmented_roomname, sizeof augmented_roomname, &CC->user, towhere);
838 c = CtdlGetRoom(&QRscratch, augmented_roomname);
840 safestrncpy(towhere, augmented_roomname, sizeof(towhere));
844 /* If the room exists, check security/access */
846 /* See if there is an existing user/room relationship */
847 CtdlRoomAccess(&QRscratch, &CC->user, &ra, NULL);
849 /* normal clients have to pass through security */
855 /* Fail here if no such room */
857 IReply("NO ... no such room, or access denied");
861 /* If we already had some other folder selected, auto-expunge it */
865 * CtdlUserGoto() formally takes us to the desired room, happily returning
866 * the number of messages and number of new messages.
868 memcpy(&CC->room, &QRscratch, sizeof(struct ctdlroom));
869 CtdlUserGoto(NULL, 0, 0, &msgs, &new);
872 if (!strcasecmp(Params[1].Key, "EXAMINE")) {
879 Imap->last_mtime = CC->room.QRmtime;
881 IAPrintf("* %d EXISTS\r\n", msgs);
882 IAPrintf("* %d RECENT\r\n", new);
884 IAPrintf("* OK [UIDVALIDITY %ld] UID validity status\r\n", GLOBAL_UIDVALIDITY_VALUE);
885 IAPrintf("* OK [UIDNEXT %ld] Predicted next UID\r\n", CitControl.MMhighest + 1);
887 /* Technically, \Deleted is a valid flag, but not a permanent flag,
888 * because we don't maintain its state across sessions. Citadel
889 * automatically expunges mailboxes when they are de-selected.
891 * Unfortunately, omitting \Deleted as a PERMANENTFLAGS flag causes
892 * some clients (particularly Thunderbird) to misbehave -- they simply
893 * elect not to transmit the flag at all. So we have to advertise
894 * \Deleted as a PERMANENTFLAGS flag, even though it technically isn't.
896 IAPuts("* FLAGS (\\Deleted \\Seen \\Answered)\r\n");
897 IAPuts("* OK [PERMANENTFLAGS (\\Deleted \\Seen \\Answered)] permanent flags\r\n");
899 IReplyPrintf("OK [%s] %s completed",
900 (Imap->readonly ? "READ-ONLY" : "READ-WRITE"), Params[1].Key
906 * Does the real work for expunge.
908 int imap_do_expunge(void)
910 citimap *Imap = IMAP;
912 int num_expunged = 0;
913 long *delmsgs = NULL;
916 CtdlLogPrintf(CTDL_DEBUG, "imap_do_expunge() called\n");
917 if (Imap->selected == 0) {
921 if (Imap->num_msgs > 0) {
922 delmsgs = malloc(Imap->num_msgs * sizeof(long));
923 for (i = 0; i < Imap->num_msgs; ++i) {
924 if (Imap->flags[i] & IMAP_DELETED) {
925 delmsgs[num_delmsgs++] = Imap->msgids[i];
928 if (num_delmsgs > 0) {
929 CtdlDeleteMessages(CC->room.QRname, delmsgs, num_delmsgs, "");
931 num_expunged += num_delmsgs;
935 if (num_expunged > 0) {
936 imap_rescan_msgids();
939 CtdlLogPrintf(CTDL_DEBUG, "Expunged %d messages from <%s>\n", num_expunged, CC->room.QRname);
940 return (num_expunged);
945 * implements the EXPUNGE command syntax
947 void imap_expunge(int num_parms, ConstStr *Params)
949 int num_expunged = 0;
951 num_expunged = imap_do_expunge();
952 IReplyPrintf("OK expunged %d messages.", num_expunged);
957 * implements the CLOSE command
959 void imap_close(int num_parms, ConstStr *Params)
962 /* Yes, we always expunge on close. */
963 if (IMAP->selected) {
970 IReply("OK CLOSE completed");
975 * Implements the NAMESPACE command.
977 void imap_namespace(int num_parms, ConstStr *Params)
984 IAPuts("* NAMESPACE ");
986 /* All personal folders are subordinate to INBOX. */
987 IAPuts("((\"INBOX/\" \"/\")) ");
989 /* Other users' folders ... coming soon! FIXME */
992 /* Show all floors as shared namespaces. Neato! */
994 for (i = 0; i < MAXFLOORS; ++i) {
995 fl = CtdlGetCachedFloor(i);
996 if (fl->f_flags & F_INUSE) {
997 /* if (floors > 0) IAPuts(" "); samjam says this confuses javamail */
999 snprintf(Namespace, sizeof(Namespace), "%s/", fl->f_name);
1000 plain_imap_strout(Namespace);
1007 /* Wind it up with a newline and a completion message. */
1009 IReply("OK NAMESPACE completed");
1014 * Implements the CREATE command
1017 void imap_create(int num_parms, ConstStr *Params)
1020 char roomname[ROOMNAMELEN];
1023 int newroomtype = 0;
1024 int newroomview = 0;
1025 char *notification_message = NULL;
1027 if (num_parms < 3) {
1028 IReply("NO A foder name must be specified");
1032 if (strchr(Params[2].Key, '\\') != NULL) {
1033 IReply("NO Invalid character in folder name");
1034 CtdlLogPrintf(CTDL_DEBUG, "invalid character in folder name\n");
1038 ret = imap_roomname(roomname, sizeof roomname, Params[2].Key);
1040 IReply("NO Invalid mailbox name or location");
1041 CtdlLogPrintf(CTDL_DEBUG, "invalid mailbox name or location\n");
1044 floornum = (ret & 0x00ff); /* lower 8 bits = floor number */
1045 flags = (ret & 0xff00); /* upper 8 bits = flags */
1047 if (flags & IR_MAILBOX) {
1048 if (strncasecmp(Params[2].Key, "INBOX/", 6)) {
1049 IReply("NO Personal folders must be created under INBOX");
1050 CtdlLogPrintf(CTDL_DEBUG, "not subordinate to inbox\n");
1055 if (flags & IR_MAILBOX) {
1056 newroomtype = 4; /* private mailbox */
1057 newroomview = VIEW_MAILBOX;
1059 newroomtype = 0; /* public folder */
1060 newroomview = VIEW_BBS;
1063 CtdlLogPrintf(CTDL_INFO, "Create new room <%s> on floor <%d> with type <%d>\n",
1064 roomname, floornum, newroomtype);
1066 ret = CtdlCreateRoom(roomname, newroomtype, "", floornum, 1, 0, newroomview);
1068 /*** DO NOT CHANGE THIS ERROR MESSAGE IN ANY WAY! BYNARI CONNECTOR DEPENDS ON IT! ***/
1069 IReply("NO Mailbox already exists, or create failed");
1071 IReply("OK CREATE completed");
1072 /* post a message in Aide> describing the new room */
1073 notification_message = malloc(1024);
1074 snprintf(notification_message, 1024,
1075 "A new room called \"%s\" has been created by %s%s%s%s\n",
1078 ((ret & QR_MAILBOX) ? " [personal]" : ""),
1079 ((ret & QR_PRIVATE) ? " [private]" : ""),
1080 ((ret & QR_GUESSNAME) ? " [hidden]" : "")
1082 CtdlAideMessage(notification_message, "Room Creation Message");
1083 free(notification_message);
1085 CtdlLogPrintf(CTDL_DEBUG, "imap_create() completed\n");
1090 * Locate a room by its IMAP folder name, and check access to it.
1091 * If zapped_ok is nonzero, we can also look for the room in the zapped list.
1093 int imap_grabroom(char *returned_roomname, const char *foldername, int zapped_ok)
1096 char augmented_roomname[ROOMNAMELEN];
1097 char roomname[ROOMNAMELEN];
1099 struct ctdlroom QRscratch;
1103 ret = imap_roomname(roomname, sizeof roomname, foldername);
1108 /* First try a regular match */
1109 c = CtdlGetRoom(&QRscratch, roomname);
1111 /* Then try a mailbox name match */
1113 CtdlMailboxName(augmented_roomname, sizeof augmented_roomname,
1114 &CC->user, roomname);
1115 c = CtdlGetRoom(&QRscratch, augmented_roomname);
1117 safestrncpy(roomname, augmented_roomname, sizeof(roomname));
1120 /* If the room exists, check security/access */
1122 /* See if there is an existing user/room relationship */
1123 CtdlRoomAccess(&QRscratch, &CC->user, &ra, NULL);
1125 /* normal clients have to pass through security */
1126 if (ra & UA_KNOWN) {
1129 if ((zapped_ok) && (ra & UA_ZAPPED)) {
1134 /* Fail here if no such room */
1136 strcpy(returned_roomname, "");
1139 safestrncpy(returned_roomname, QRscratch.QRname, ROOMNAMELEN);
1146 * Implements the STATUS command (sort of)
1149 void imap_status(int num_parms, ConstStr *Params)
1152 char roomname[ROOMNAMELEN];
1153 char imaproomname[SIZ];
1154 char savedroom[ROOMNAMELEN];
1157 ret = imap_grabroom(roomname, Params[2].Key, 1);
1159 IReply("NO Invalid mailbox name or location, or access denied");
1164 * CtdlUserGoto() formally takes us to the desired room, happily returning
1165 * the number of messages and number of new messages. (If another
1166 * folder is selected, save its name so we can return there!!!!!)
1168 if (IMAP->selected) {
1169 strcpy(savedroom, CC->room.QRname);
1171 CtdlUserGoto(roomname, 0, 0, &msgs, &new);
1174 * Tell the client what it wants to know. In fact, tell it *more* than
1175 * it wants to know. We happily IGnore the supplied status data item
1176 * names and simply spew all possible data items. It's far easier to
1177 * code and probably saves us some processing time too.
1179 imap_mailboxname(imaproomname, sizeof imaproomname, &CC->room);
1180 IAPuts("* STATUS ");
1181 plain_imap_strout(imaproomname);
1182 IAPrintf(" (MESSAGES %d ", msgs);
1183 IAPrintf("RECENT %d ", new); /* Initially, new==recent */
1184 IAPrintf("UIDNEXT %ld ", CitControl.MMhighest + 1);
1185 IAPrintf("UNSEEN %d)\r\n", new);
1188 * If another folder is selected, go back to that room so we can resume
1189 * our happy day without violent explosions.
1191 if (IMAP->selected) {
1192 CtdlUserGoto(savedroom, 0, 0, &msgs, &new);
1196 * Oooh, look, we're done!
1198 IReply("OK STATUS completed");
1203 * Implements the SUBSCRIBE command
1206 void imap_subscribe(int num_parms, ConstStr *Params)
1209 char roomname[ROOMNAMELEN];
1210 char savedroom[ROOMNAMELEN];
1213 ret = imap_grabroom(roomname, Params[2].Key, 1);
1216 "NO Error %d: invalid mailbox name or location, or access denied",
1223 * CtdlUserGoto() formally takes us to the desired room, which has the side
1224 * effect of marking the room as not-zapped ... exactly the effect
1225 * we're looking for.
1227 if (IMAP->selected) {
1228 strcpy(savedroom, CC->room.QRname);
1230 CtdlUserGoto(roomname, 0, 0, &msgs, &new);
1233 * If another folder is selected, go back to that room so we can resume
1234 * our happy day without violent explosions.
1236 if (IMAP->selected) {
1237 CtdlUserGoto(savedroom, 0, 0, &msgs, &new);
1240 IReply("OK SUBSCRIBE completed");
1245 * Implements the UNSUBSCRIBE command
1248 void imap_unsubscribe(int num_parms, ConstStr *Params)
1251 char roomname[ROOMNAMELEN];
1252 char savedroom[ROOMNAMELEN];
1255 ret = imap_grabroom(roomname, Params[2].Key, 1);
1257 IReply("NO Invalid mailbox name or location, or access denied");
1262 * CtdlUserGoto() formally takes us to the desired room.
1264 if (IMAP->selected) {
1265 strcpy(savedroom, CC->room.QRname);
1267 CtdlUserGoto(roomname, 0, 0, &msgs, &new);
1270 * Now make the API call to zap the room
1272 if (CtdlForgetThisRoom() == 0) {
1273 IReply("OK UNSUBSCRIBE completed");
1275 IReply("NO You may not unsubscribe from this folder.");
1279 * If another folder is selected, go back to that room so we can resume
1280 * our happy day without violent explosions.
1282 if (IMAP->selected) {
1283 CtdlUserGoto(savedroom, 0, 0, &msgs, &new);
1289 * Implements the DELETE command
1292 void imap_delete(int num_parms, ConstStr *Params)
1295 char roomname[ROOMNAMELEN];
1296 char savedroom[ROOMNAMELEN];
1299 ret = imap_grabroom(roomname, Params[2].Key, 1);
1301 IReply("NO Invalid mailbox name, or access denied");
1306 * CtdlUserGoto() formally takes us to the desired room, happily returning
1307 * the number of messages and number of new messages. (If another
1308 * folder is selected, save its name so we can return there!!!!!)
1310 if (IMAP->selected) {
1311 strcpy(savedroom, CC->room.QRname);
1313 CtdlUserGoto(roomname, 0, 0, &msgs, &new);
1316 * Now delete the room.
1318 if (CtdlDoIHavePermissionToDeleteThisRoom(&CC->room)) {
1319 CtdlScheduleRoomForDeletion(&CC->room);
1320 IReply("OK DELETE completed");
1322 IReply("NO Can't delete this folder.");
1326 * If another folder is selected, go back to that room so we can resume
1327 * our happy day without violent explosions.
1329 if (IMAP->selected) {
1330 CtdlUserGoto(savedroom, 0, 0, &msgs, &new);
1336 * Back end function for imap_rename()
1338 void imap_rename_backend(struct ctdlroom *qrbuf, void *data)
1340 char foldername[SIZ];
1341 char newfoldername[SIZ];
1342 char newroomname[ROOMNAMELEN];
1344 struct irl *irlp = NULL; /* scratch pointer */
1345 struct irlparms *irlparms;
1347 irlparms = (struct irlparms *) data;
1348 imap_mailboxname(foldername, sizeof foldername, qrbuf);
1350 /* Rename subfolders */
1351 if ((!strncasecmp(foldername, irlparms->oldname,
1352 strlen(irlparms->oldname))
1353 && (foldername[strlen(irlparms->oldname)] == '/'))) {
1355 sprintf(newfoldername, "%s/%s",
1357 &foldername[strlen(irlparms->oldname) + 1]
1360 newfloor = imap_roomname(newroomname,
1362 newfoldername) & 0xFF;
1364 irlp = (struct irl *) malloc(sizeof(struct irl));
1365 strcpy(irlp->irl_newroom, newroomname);
1366 strcpy(irlp->irl_oldroom, qrbuf->QRname);
1367 irlp->irl_newfloor = newfloor;
1368 irlp->next = *(irlparms->irl);
1369 *(irlparms->irl) = irlp;
1375 * Implements the RENAME command
1378 void imap_rename(int num_parms, ConstStr *Params)
1380 char old_room[ROOMNAMELEN];
1381 char new_room[ROOMNAMELEN];
1385 struct irl *irl = NULL; /* the list */
1386 struct irl *irlp = NULL; /* scratch pointer */
1387 struct irlparms irlparms;
1390 if (strchr(Params[3].Key, '\\') != NULL) {
1391 IReply("NO Invalid character in folder name");
1395 oldr = imap_roomname(old_room, sizeof old_room, Params[2].Key);
1396 newr = imap_roomname(new_room, sizeof new_room, Params[3].Key);
1397 new_floor = (newr & 0xFF);
1399 r = CtdlRenameRoom(old_room, new_room, new_floor);
1401 if (r == crr_room_not_found) {
1402 IReply("NO Could not locate this folder");
1405 if (r == crr_already_exists) {
1406 IReplyPrintf("NO '%s' already exists.");
1409 if (r == crr_noneditable) {
1410 IReply("NO This folder is not editable.");
1413 if (r == crr_invalid_floor) {
1414 IReply("NO Folder root does not exist.");
1417 if (r == crr_access_denied) {
1418 IReply("NO You do not have permission to edit this folder.");
1422 IReplyPrintf("NO Rename failed - undefined error %d", r);
1426 /* If this is the INBOX, then RFC2060 says we have to just move the
1427 * contents. In a Citadel environment it's easier to rename the room
1428 * (already did that) and create a new inbox.
1430 if (!strcasecmp(Params[2].Key, "INBOX")) {
1431 CtdlCreateRoom(MAILROOM, 4, "", 0, 1, 0, VIEW_MAILBOX);
1434 /* Otherwise, do the subfolders. Build a list of rooms to rename... */
1436 irlparms.oldname = Params[2].Key;
1437 irlparms.newname = Params[3].Key;
1438 irlparms.irl = &irl;
1439 CtdlForEachRoom(imap_rename_backend, (void *) &irlparms);
1441 /* ... and now rename them. */
1442 while (irl != NULL) {
1443 r = CtdlRenameRoom(irl->irl_oldroom,
1447 /* FIXME handle error returns better */
1448 CtdlLogPrintf(CTDL_ERR, "CtdlRenameRoom() error %d\n", r);
1456 snprintf(aidemsg, sizeof aidemsg, "IMAP folder \"%s\" renamed to \"%s\" by %s\n",
1461 CtdlAideMessage(aidemsg, "IMAP folder rename");
1463 IReply("OK RENAME completed");
1468 * Main command loop for IMAP sessions.
1470 void imap_command_loop(void)
1472 struct timeval tv1, tv2;
1473 suseconds_t total_time = 0;
1474 int untagged_ok = 1;
1476 const char *pchs, *pche;
1477 const imap_handler_hook *h;
1479 gettimeofday(&tv1, NULL);
1480 CC->lastcmd = time(NULL);
1484 if (Imap->Cmd.CmdBuf == NULL)
1485 Imap->Cmd.CmdBuf = NewStrBufPlain(NULL, SIZ);
1487 FlushStrBuf(Imap->Cmd.CmdBuf);
1489 if (CtdlClientGetLine(Imap->Cmd.CmdBuf) < 1) {
1490 CtdlLogPrintf(CTDL_ERR, "Client disconnected: ending session.\r\n");
1495 if (Imap->authstate == imap_as_expecting_password) {
1496 CtdlLogPrintf(CTDL_INFO, "IMAP: <password>\n");
1498 else if (Imap->authstate == imap_as_expecting_plainauth) {
1499 CtdlLogPrintf(CTDL_INFO, "IMAP: <plain_auth>\n");
1501 else if ((Imap->authstate == imap_as_expecting_multilineusername) ||
1502 cbmstrcasestr(ChrPtr(Imap->Cmd.CmdBuf), " LOGIN ")) {
1503 CtdlLogPrintf(CTDL_INFO, "IMAP: LOGIN...\n");
1506 CtdlLogPrintf(CTDL_INFO, "IMAP: %s\n", ChrPtr(Imap->Cmd.CmdBuf));
1509 pchs = ChrPtr(Imap->Cmd.CmdBuf);
1510 pche = pchs + StrLength(Imap->Cmd.CmdBuf);
1512 while ((pche > pchs) &&
1517 StrBufCutRight(Imap->Cmd.CmdBuf, 1);
1519 StrBufTrim(Imap->Cmd.CmdBuf);
1521 /* If we're in the middle of a multi-line command, handle that */
1522 switch (Imap->authstate){
1523 case imap_as_expecting_username:
1524 imap_auth_login_user(imap_as_expecting_username);
1527 case imap_as_expecting_multilineusername:
1528 imap_auth_login_user(imap_as_expecting_multilineusername);
1531 case imap_as_expecting_plainauth:
1535 case imap_as_expecting_password:
1536 imap_auth_login_pass(imap_as_expecting_password);
1539 case imap_as_expecting_multilinepassword:
1540 imap_auth_login_pass(imap_as_expecting_multilinepassword);
1547 /* Ok, at this point we're in normal command mode.
1548 * If the command just submitted does not contain a literal, we
1549 * might think about delivering some untagged stuff...
1551 if (*(ChrPtr(Imap->Cmd.CmdBuf) + StrLength(Imap->Cmd.CmdBuf) - 1)
1556 /* Grab the tag, command, and parameters. */
1557 imap_parameterize(&Imap->Cmd);
1559 /* debug output the parsed vector */
1562 CtdlLogPrintf(CTDL_DEBUG, "----- %ld params \n",
1563 Imap->Cmd.num_parms);
1565 for (i=0; i < Imap->Cmd.num_parms; i++) {
1566 if (Imap->Cmd.Params[i].len != strlen(Imap->Cmd.Params[i].Key))
1567 CtdlLogPrintf(CTDL_DEBUG, "*********** %ld != %ld : %s\n",
1568 Imap->Cmd.Params[i].len,
1569 strlen(Imap->Cmd.Params[i].Key),
1570 Imap->Cmd.Params[i].Key);
1572 CtdlLogPrintf(CTDL_DEBUG, "%ld : %s\n",
1573 Imap->Cmd.Params[i].len,
1574 Imap->Cmd.Params[i].Key);
1578 /* Now for the command set. */
1579 h = imap_lookup(Imap->Cmd.num_parms, Imap->Cmd.Params);
1583 IReply("BAD command unrecognized");
1587 /* RFC3501 says that we cannot output untagged data during these commands */
1588 if ((h->Flags & I_FLAG_UNTAGGED) == 0) {
1590 /* we can put any additional untagged stuff right here in the future */
1593 * Before processing the command that was just entered... if we happen
1594 * to have a folder selected, we'd like to rescan that folder for new
1595 * messages, and for deletions/changes of existing messages. This
1596 * could probably be optimized better with some deep thought...
1598 if (Imap->selected) {
1599 imap_rescan_msgids();
1603 /* does our command require a logged-in state */
1604 if ((!CC->logged_in) && ((h->Flags & I_FLAG_LOGGED_IN) != 0)) {
1605 IReply("BAD Not logged in.");
1609 /* does our command require the SELECT state on a mailbox */
1610 if ((Imap->selected == 0) && ((h->Flags & I_FLAG_SELECT) != 0)){
1611 IReply("BAD no folder selected");
1614 h->h(Imap->Cmd.num_parms, Imap->Cmd.Params);
1616 /* If the client transmitted a message we can free it now */
1621 imap_free_transmitted_message();
1623 gettimeofday(&tv2, NULL);
1624 total_time = (tv2.tv_usec + (tv2.tv_sec * 1000000)) - (tv1.tv_usec + (tv1.tv_sec * 1000000));
1625 CtdlLogPrintf(CTDL_DEBUG, "IMAP command completed in %ld.%ld seconds\n",
1626 (total_time / 1000000),
1627 (total_time % 1000000)
1631 void imap_noop (int num_parms, ConstStr *Params)
1633 IReply("OK No operation");
1636 void imap_logout(int num_parms, ConstStr *Params)
1638 if (IMAP->selected) {
1639 imap_do_expunge(); /* yes, we auto-expunge at logout */
1641 IAPrintf("* BYE %s logging out\r\n", config.c_fqdn);
1642 IReply("OK Citadel IMAP session ended.");
1647 const char *CitadelServiceIMAP="IMAP";
1648 const char *CitadelServiceIMAPS="IMAPS";
1652 * This function is called to register the IMAP extension with Citadel.
1654 CTDL_MODULE_INIT(imap)
1656 if (ImapCmds == NULL)
1657 ImapCmds = NewHash(1, NULL);
1659 RegisterImapCMD("NOOP", "", imap_noop, I_FLAG_NONE);
1660 RegisterImapCMD("CHECK", "", imap_noop, I_FLAG_NONE);
1661 RegisterImapCMD("ID", "", imap_id, I_FLAG_NONE);
1662 RegisterImapCMD("LOGOUT", "", imap_logout, I_FLAG_NONE);
1663 RegisterImapCMD("LOGIN", "", imap_login, I_FLAG_NONE);
1664 RegisterImapCMD("AUTHENTICATE", "", imap_authenticate, I_FLAG_NONE);
1665 RegisterImapCMD("CAPABILITY", "", imap_capability, I_FLAG_NONE);
1667 RegisterImapCMD("STARTTLS", "", imap_starttls, I_FLAG_NONE);
1670 /* The commans below require a logged-in state */
1671 RegisterImapCMD("SELECT", "", imap_select, I_FLAG_LOGGED_IN);
1672 RegisterImapCMD("EXAMINE", "", imap_select, I_FLAG_LOGGED_IN);
1673 RegisterImapCMD("LSUB", "", imap_list, I_FLAG_LOGGED_IN);
1674 RegisterImapCMD("LIST", "", imap_list, I_FLAG_LOGGED_IN);
1675 RegisterImapCMD("CREATE", "", imap_create, I_FLAG_LOGGED_IN);
1676 RegisterImapCMD("DELETE", "", imap_delete, I_FLAG_LOGGED_IN);
1677 RegisterImapCMD("RENAME", "", imap_rename, I_FLAG_LOGGED_IN);
1678 RegisterImapCMD("STATUS", "", imap_status, I_FLAG_LOGGED_IN);
1679 RegisterImapCMD("SUBSCRIBE", "", imap_subscribe, I_FLAG_LOGGED_IN);
1680 RegisterImapCMD("UNSUBSCRIBE", "", imap_unsubscribe, I_FLAG_LOGGED_IN);
1681 RegisterImapCMD("APPEND", "", imap_append, I_FLAG_LOGGED_IN);
1682 RegisterImapCMD("NAMESPACE", "", imap_namespace, I_FLAG_LOGGED_IN);
1683 RegisterImapCMD("SETACL", "", imap_setacl, I_FLAG_LOGGED_IN);
1684 RegisterImapCMD("DELETEACL", "", imap_deleteacl, I_FLAG_LOGGED_IN);
1685 RegisterImapCMD("GETACL", "", imap_getacl, I_FLAG_LOGGED_IN);
1686 RegisterImapCMD("LISTRIGHTS", "", imap_listrights, I_FLAG_LOGGED_IN);
1687 RegisterImapCMD("MYRIGHTS", "", imap_myrights, I_FLAG_LOGGED_IN);
1688 RegisterImapCMD("GETMETADATA", "", imap_getmetadata, I_FLAG_LOGGED_IN);
1689 RegisterImapCMD("SETMETADATA", "", imap_setmetadata, I_FLAG_LOGGED_IN);
1691 /* The commands below require the SELECT state on a mailbox */
1692 RegisterImapCMD("FETCH", "", imap_fetch, I_FLAG_LOGGED_IN | I_FLAG_SELECT | I_FLAG_UNTAGGED);
1693 RegisterImapCMD("UID", "FETCH", imap_uidfetch, I_FLAG_LOGGED_IN | I_FLAG_SELECT);
1694 RegisterImapCMD("SEARCH", "", imap_search, I_FLAG_LOGGED_IN | I_FLAG_SELECT | I_FLAG_UNTAGGED);
1695 RegisterImapCMD("UID", "SEARCH", imap_uidsearch, I_FLAG_LOGGED_IN | I_FLAG_SELECT);
1696 RegisterImapCMD("STORE", "", imap_store, I_FLAG_LOGGED_IN | I_FLAG_SELECT | I_FLAG_UNTAGGED);
1697 RegisterImapCMD("UID", "STORE", imap_uidstore, I_FLAG_LOGGED_IN | I_FLAG_SELECT);
1698 RegisterImapCMD("COPY", "", imap_copy, I_FLAG_LOGGED_IN | I_FLAG_SELECT);
1699 RegisterImapCMD("UID", "COPY", imap_uidcopy, I_FLAG_LOGGED_IN | I_FLAG_SELECT);
1700 RegisterImapCMD("EXPUNGE", "", imap_expunge, I_FLAG_LOGGED_IN | I_FLAG_SELECT);
1701 RegisterImapCMD("UID", "EXPUNGE", imap_expunge, I_FLAG_LOGGED_IN | I_FLAG_SELECT);
1702 RegisterImapCMD("CLOSE", "", imap_close, I_FLAG_LOGGED_IN | I_FLAG_SELECT);
1706 CtdlRegisterServiceHook(config.c_imap_port,
1707 NULL, imap_greeting, imap_command_loop, NULL, CitadelServiceIMAP);
1709 CtdlRegisterServiceHook(config.c_imaps_port,
1710 NULL, imaps_greeting, imap_command_loop, NULL, CitadelServiceIMAPS);
1712 CtdlRegisterSessionHook(imap_cleanup_function, EVT_STOP);
1715 /* return our Subversion id for the Log */