4 * IMAP server for the Citadel/UX system
5 * Copyright (C) 2000-2001 by Art Cancro and others.
6 * This code is released under the terms of the GNU General Public License.
8 * WARNING: this is an incomplete implementation, still in progress. Parts of
9 * it work, but it's not really usable yet from a user perspective.
11 * WARNING: Mark Crispin is an idiot. IMAP is the most brain-damaged protocol
12 * you will ever have the profound lack of pleasure to encounter.
24 #include <sys/types.h>
33 #include "sysdep_decls.h"
34 #include "citserver.h"
37 #include "dynloader.h"
44 #include "internet_addressing.h"
45 #include "serv_imap.h"
46 #include "imap_tools.h"
47 #include "imap_fetch.h"
48 #include "imap_search.h"
49 #include "imap_store.h"
50 #include "imap_misc.h"
57 * If there is a message ID map in memory, free it
59 void imap_free_msgids(void) {
60 if (IMAP->msgids != NULL) {
65 if (IMAP->flags != NULL) {
73 * Back end for imap_load_msgids()
75 * FIXME: this should be optimized by figuring out a way to allocate memory
76 * once rather than doing a reallok() for each message.
78 void imap_add_single_msgid(long msgnum, void *userdata) {
80 IMAP->num_msgs = IMAP->num_msgs + 1;
81 if (IMAP->msgids == NULL) {
82 IMAP->msgids = mallok(IMAP->num_msgs * sizeof(long));
85 IMAP->msgids = reallok(IMAP->msgids,
86 IMAP->num_msgs * sizeof(long));
88 if (IMAP->flags == NULL) {
89 IMAP->flags = mallok(IMAP->num_msgs * sizeof(long));
92 IMAP->flags = reallok(IMAP->flags,
93 IMAP->num_msgs * sizeof(long));
95 IMAP->msgids[IMAP->num_msgs - 1] = msgnum;
96 IMAP->flags[IMAP->num_msgs - 1] = 0;
102 * Set up a message ID map for the current room (folder)
104 void imap_load_msgids(void) {
106 if (IMAP->selected == 0) {
107 lprintf(5, "imap_load_msgids() can't run; no room selected\n");
111 imap_free_msgids(); /* If there was already a map, free it */
113 CtdlForEachMessage(MSGS_ALL, 0L, (-63), NULL, NULL,
114 imap_add_single_msgid, NULL);
116 lprintf(9, "imap_load_msgids() mapped %d messages\n", IMAP->num_msgs);
121 * Re-scan the selected room (folder) and see if it's been changed at all
123 void imap_rescan_msgids(void) {
125 int original_num_msgs = 0;
126 long original_highest = 0L;
130 if (IMAP->selected == 0) {
131 lprintf(5, "imap_load_msgids() can't run; no room selected\n");
137 * Check to see if any of the messages we know about have been expunged
139 if (IMAP->num_msgs > 0)
140 for (i=0; i<IMAP->num_msgs; ++i) {
142 count = CtdlForEachMessage(MSGS_EQ, IMAP->msgids[i],
143 (-63), NULL, NULL, NULL, NULL);
146 cprintf("* %d EXPUNGE\r\n", i+1);
148 /* Here's some nice stupid nonsense. When a message
149 * is expunged, we have to slide all the existing
150 * messages up in the message array.
153 memcpy(&IMAP->msgids[i], &IMAP->msgids[i+1],
154 (sizeof(long)*(IMAP->num_msgs-i)) );
155 memcpy(&IMAP->flags[i], &IMAP->flags[i+1],
156 (sizeof(long)*(IMAP->num_msgs-i)) );
164 * Remember how many messages were here before we re-scanned.
166 original_num_msgs = IMAP->num_msgs;
167 if (IMAP->num_msgs > 0) {
168 original_highest = IMAP->msgids[IMAP->num_msgs - 1];
171 original_highest = 0L;
175 * Now peruse the room for *new* messages only.
177 CtdlForEachMessage(MSGS_GT, original_highest, (-63), NULL, NULL,
178 imap_add_single_msgid, NULL);
181 * If new messages have arrived, tell the client about them.
183 if (IMAP->num_msgs > original_num_msgs) {
184 cprintf("* %d EXISTS\r\n", IMAP->num_msgs);
196 * This cleanup function blows away the temporary memory and files used by
199 void imap_cleanup_function(void) {
201 /* Don't do this stuff if this is not a IMAP session! */
202 if (CC->h_command_function != imap_command_loop) return;
204 lprintf(9, "Performing IMAP cleanup hook\n");
206 lprintf(9, "Finished IMAP cleanup hook\n");
212 * Here's where our IMAP session begins its happy day.
214 void imap_greeting(void) {
216 strcpy(CC->cs_clientname, "IMAP session");
217 CtdlAllocUserData(SYM_IMAP, sizeof(struct citimap));
218 IMAP->authstate = imap_as_normal;
220 cprintf("* OK %s Citadel/UX IMAP4rev1 server ready\r\n",
226 * implements the LOGIN command (ordinary username/password login)
228 void imap_login(int num_parms, char *parms[]) {
229 if (CtdlLoginExistingUser(parms[2]) == login_ok) {
230 if (CtdlTryPassword(parms[3]) == pass_ok) {
231 cprintf("%s OK login successful\r\n", parms[0]);
236 cprintf("%s BAD Login incorrect\r\n", parms[0]);
241 * Implements the AUTHENTICATE command
243 void imap_authenticate(int num_parms, char *parms[]) {
246 if (num_parms != 3) {
247 cprintf("%s BAD incorrect number of parameters\r\n", parms[0]);
251 if (!strcasecmp(parms[2], "LOGIN")) {
252 encode_base64(buf, "Username:");
253 cprintf("+ %s\r\n", buf);
254 IMAP->authstate = imap_as_expecting_username;
255 strcpy(IMAP->authseq, parms[0]);
260 cprintf("%s NO AUTHENTICATE %s failed\r\n",
265 void imap_auth_login_user(char *cmd) {
268 decode_base64(buf, cmd);
269 CtdlLoginExistingUser(buf);
270 encode_base64(buf, "Password:");
271 cprintf("+ %s\r\n", buf);
272 IMAP->authstate = imap_as_expecting_password;
276 void imap_auth_login_pass(char *cmd) {
279 decode_base64(buf, cmd);
280 if (CtdlTryPassword(buf) == pass_ok) {
281 cprintf("%s OK authentication succeeded\r\n", IMAP->authseq);
284 cprintf("%s NO authentication failed\r\n", IMAP->authseq);
286 IMAP->authstate = imap_as_normal;
293 * implements the CAPABILITY command
295 void imap_capability(int num_parms, char *parms[]) {
296 cprintf("* CAPABILITY IMAP4 IMAP4REV1 AUTH=LOGIN\r\n");
297 cprintf("%s OK CAPABILITY completed\r\n", parms[0]);
305 * implements the SELECT command
307 void imap_select(int num_parms, char *parms[]) {
309 char augmented_roomname[ROOMNAMELEN];
313 struct quickroom QRscratch;
319 /* Convert the supplied folder name to a roomname */
320 i = imap_roomname(towhere, sizeof towhere, parms[2]);
322 cprintf("%s NO Invalid mailbox name.\r\n", parms[0]);
326 floornum = (i & 0x00ff);
327 roomflags = (i & 0xff00);
329 /* First try a regular match */
330 c = getroom(&QRscratch, towhere);
332 /* Then try a mailbox name match */
334 MailboxName(augmented_roomname, &CC->usersupp, towhere);
335 c = getroom(&QRscratch, augmented_roomname);
337 strcpy(towhere, augmented_roomname);
340 /* If the room exists, check security/access */
342 /* See if there is an existing user/room relationship */
343 ra = CtdlRoomAccess(&QRscratch, &CC->usersupp);
345 /* normal clients have to pass through security */
351 /* Fail here if no such room */
353 cprintf("%s NO ... no such room, or access denied\r\n",
360 * usergoto() formally takes us to the desired room, happily returning
361 * the number of messages and number of new messages.
363 usergoto(QRscratch.QRname, 0, &msgs, &new);
366 if (!strcasecmp(parms[1], "EXAMINE")) {
375 /* FIXME ... much more info needs to be supplied here */
376 cprintf("* %d EXISTS\r\n", msgs);
377 cprintf("* %d RECENT\r\n", new);
378 cprintf("* FLAGS (\\Deleted)\r\n");
379 cprintf("* OK [PERMANENTFLAGS (\\Deleted)] permanent flags\r\n");
380 cprintf("* OK [UIDVALIDITY 0] UIDs valid\r\n");
381 cprintf("%s OK [%s] %s completed\r\n",
383 (IMAP->readonly ? "READ-ONLY" : "READ-WRITE"),
390 * does the real work for expunge
392 int imap_do_expunge(void) {
394 int num_expunged = 0;
396 if (IMAP->num_msgs > 0) for (i=0; i<IMAP->num_msgs; ++i) {
397 if (IMAP->flags[i] & IMAP_DELETED) {
398 CtdlDeleteMessages(CC->quickroom.QRname,
399 IMAP->msgids[i], "");
404 if (num_expunged > 0) {
405 imap_rescan_msgids();
408 return(num_expunged);
413 * implements the EXPUNGE command syntax
415 void imap_expunge(int num_parms, char *parms[]) {
416 int num_expunged = 0;
418 cprintf("%s OK expunged %d messages.\r\n", parms[0], num_expunged);
423 * implements the CLOSE command
425 void imap_close(int num_parms, char *parms[]) {
427 /* Yes, we always expunge on close. */
433 cprintf("%s OK CLOSE completed\r\n", parms[0]);
440 * Used by LIST and LSUB to show the floors in the listing
442 void imap_list_floors(char *cmd) {
446 for (i=0; i<MAXFLOORS; ++i) {
448 if (fl->f_flags & F_INUSE) {
449 cprintf("* %s (\\NoSelect) \"|\" ", cmd);
450 imap_strout(fl->f_name);
459 * Back end for imap_lsub()
461 * IMAP "subscribed folder" is equivocated to Citadel "known rooms." This
462 * may or may not be the desired behavior in the future.
464 void imap_lsub_listroom(struct quickroom *qrbuf, void *data) {
469 pattern = (char *)data;
470 lprintf(9, "lsub pattern: <%s>\n", pattern);
472 /* Only list rooms to which the user has access!! */
473 ra = CtdlRoomAccess(qrbuf, &CC->usersupp);
475 imap_mailboxname(buf, sizeof buf, qrbuf);
476 if (imap_mailbox_matches_pattern(pattern, buf)) {
477 cprintf("* LSUB (\\NoInferiors) \"|\" ");
486 * Implements the LSUB command
488 * FIXME: Handle wildcards, please.
490 void imap_lsub(int num_parms, char *parms[]) {
493 cprintf("%s BAD arguments invalid\r\n", parms[0]);
496 sprintf(pattern, "%s%s", parms[2], parms[3]);
498 if (strlen(parms[3])==0) {
499 cprintf("* LIST (\\Noselect) \"|\" \"\"\r\n");
503 imap_list_floors("LSUB");
504 ForEachRoom(imap_lsub_listroom, pattern);
507 cprintf("%s OK LSUB completed\r\n", parms[0]);
513 * Back end for imap_list()
515 void imap_list_listroom(struct quickroom *qrbuf, void *data) {
520 pattern = (char *)data;
521 lprintf(9, "list pattern: <%s>\n", pattern);
523 /* Only list rooms to which the user has access!! */
524 ra = CtdlRoomAccess(qrbuf, &CC->usersupp);
526 || ((ra & UA_GOTOALLOWED) && (ra & UA_ZAPPED))) {
527 imap_mailboxname(buf, sizeof buf, qrbuf);
528 if (imap_mailbox_matches_pattern(pattern, buf)) {
529 cprintf("* LIST (\\NoInferiors) \"|\" ");
538 * Implements the LIST command
540 * FIXME: Handle wildcards, please.
542 void imap_list(int num_parms, char *parms[]) {
545 cprintf("%s BAD arguments invalid\r\n", parms[0]);
548 sprintf(pattern, "%s%s", parms[2], parms[3]);
550 if (strlen(parms[3])==0) {
551 cprintf("* LIST (\\Noselect) \"|\" \"\"\r\n");
555 imap_list_floors("LIST");
556 ForEachRoom(imap_list_listroom, pattern);
559 cprintf("%s OK LIST completed\r\n", parms[0]);
565 * Implements the CREATE command
568 void imap_create(int num_parms, char *parms[]) {
570 char roomname[ROOMNAMELEN];
575 ret = imap_roomname(roomname, sizeof roomname, parms[2]);
577 cprintf("%s NO Invalid mailbox name or location\r\n",
581 floornum = ( ret & 0x00ff ); /* lower 8 bits = floor number */
582 flags = ( ret & 0xff00 ); /* upper 8 bits = flags */
584 if (flags & IR_MAILBOX) {
585 newroomtype = 4; /* private mailbox */
588 newroomtype = 0; /* public folder */
591 lprintf(7, "Create new room <%s> on floor <%d> with type <%d>\n",
592 roomname, floornum, newroomtype);
594 ret = create_room(roomname, newroomtype, "", floornum, 1);
596 cprintf("%s NO Mailbox already exists, or create failed\r\n",
600 cprintf("%s OK CREATE completed\r\n", parms[0]);
606 * Locate a room by its IMAP folder name, and check access to it
608 int imap_grabroom(char *returned_roomname, char *foldername) {
610 char augmented_roomname[ROOMNAMELEN];
611 char roomname[ROOMNAMELEN];
613 struct quickroom QRscratch;
617 ret = imap_roomname(roomname, sizeof roomname, foldername);
622 /* First try a regular match */
623 c = getroom(&QRscratch, roomname);
625 /* Then try a mailbox name match */
627 MailboxName(augmented_roomname, &CC->usersupp, roomname);
628 c = getroom(&QRscratch, augmented_roomname);
630 strcpy(roomname, augmented_roomname);
633 /* If the room exists, check security/access */
635 /* See if there is an existing user/room relationship */
636 ra = CtdlRoomAccess(&QRscratch, &CC->usersupp);
638 /* normal clients have to pass through security */
644 /* Fail here if no such room */
646 strcpy(returned_roomname, "");
650 strcpy(returned_roomname, QRscratch.QRname);
657 * Implements the STATUS command (sort of)
660 void imap_status(int num_parms, char *parms[]) {
662 char roomname[ROOMNAMELEN];
664 char savedroom[ROOMNAMELEN];
667 ret = imap_grabroom(roomname, parms[2]);
669 cprintf("%s NO Invalid mailbox name or location, or access denied\r\n",
675 * usergoto() formally takes us to the desired room, happily returning
676 * the number of messages and number of new messages. (If another
677 * folder is selected, save its name so we can return there!!!!!)
679 if (IMAP->selected) {
680 strcpy(savedroom, CC->quickroom.QRname);
682 usergoto(roomname, 0, &msgs, &new);
685 * Tell the client what it wants to know. In fact, tell it *more* than
686 * it wants to know. We happily IGnore the supplied status data item
687 * names and simply spew all possible data items. It's far easier to
688 * code and probably saves us some processing time too.
690 * FIXME we need to implement RECENT and UNSEEN eventually...
693 imap_mailboxname(buf, sizeof buf, &CC->quickroom);
694 cprintf("* STATUS ");
696 cprintf(" (MESSAGES %d RECENT 0 UIDNEXT %ld "
697 "UIDVALIDITY 0 UNSEEN 0)\r\n",
699 CitControl.MMhighest + 1
703 * If another folder is selected, go back to that room so we can resume
704 * our happy day without violent explosions.
706 if (IMAP->selected) {
707 usergoto(savedroom, 0, &msgs, &new);
711 * Oooh, look, we're done!
713 cprintf("%s OK STATUS completed\r\n", parms[0]);
719 * Implements the SUBSCRIBE command
722 void imap_subscribe(int num_parms, char *parms[]) {
724 char roomname[ROOMNAMELEN];
725 char savedroom[ROOMNAMELEN];
728 ret = imap_grabroom(roomname, parms[2]);
730 cprintf("%s NO Invalid mailbox name or location, or access denied\r\n",
736 * usergoto() formally takes us to the desired room, which has the side
737 * effect of marking the room as not-zapped ... exactly the effect
740 if (IMAP->selected) {
741 strcpy(savedroom, CC->quickroom.QRname);
743 usergoto(roomname, 0, &msgs, &new);
746 * If another folder is selected, go back to that room so we can resume
747 * our happy day without violent explosions.
749 if (IMAP->selected) {
750 usergoto(savedroom, 0, &msgs, &new);
753 cprintf("%s OK SUBSCRIBE completed\r\n", parms[0]);
758 * Implements the UNSUBSCRIBE command
761 void imap_unsubscribe(int num_parms, char *parms[]) {
763 char roomname[ROOMNAMELEN];
764 char savedroom[ROOMNAMELEN];
767 ret = imap_grabroom(roomname, parms[2]);
769 cprintf("%s NO Invalid mailbox name or location, or access denied\r\n",
775 * usergoto() formally takes us to the desired room.
777 if (IMAP->selected) {
778 strcpy(savedroom, CC->quickroom.QRname);
780 usergoto(roomname, 0, &msgs, &new);
783 * Now make the API call to zap the room
785 if (CtdlForgetThisRoom() == 0) {
786 cprintf("%s OK UNSUBSCRIBE completed\r\n", parms[0]);
789 cprintf("%s NO You may not unsubscribe from this folder.\r\n",
794 * If another folder is selected, go back to that room so we can resume
795 * our happy day without violent explosions.
797 if (IMAP->selected) {
798 usergoto(savedroom, 0, &msgs, &new);
805 * Implements the DELETE command
808 void imap_delete(int num_parms, char *parms[]) {
810 char roomname[ROOMNAMELEN];
811 char savedroom[ROOMNAMELEN];
814 ret = imap_grabroom(roomname, parms[2]);
816 cprintf("%s NO Invalid mailbox name, or access denied\r\n",
822 * usergoto() formally takes us to the desired room, happily returning
823 * the number of messages and number of new messages. (If another
824 * folder is selected, save its name so we can return there!!!!!)
826 if (IMAP->selected) {
827 strcpy(savedroom, CC->quickroom.QRname);
829 usergoto(roomname, 0, &msgs, &new);
832 * Now delete the room.
834 if (CtdlDoIHavePermissionToDeleteThisRoom(&CC->quickroom)) {
835 cprintf("%s OK DELETE completed\r\n", parms[0]);
836 delete_room(&CC->quickroom);
839 cprintf("%s NO Can't delete this folder.\r\n", parms[0]);
843 * If another folder is selected, go back to that room so we can resume
844 * our happy day without violent explosions.
846 if (IMAP->selected) {
847 usergoto(savedroom, 0, &msgs, &new);
854 * Implements the RENAME command
857 void imap_rename(int num_parms, char *parms[]) {
858 cprintf("%s NO The RENAME command is not yet implemented (FIXME)\r\n",
865 * Main command loop for IMAP sessions.
867 void imap_command_loop(void) {
873 memset(cmdbuf, 0, sizeof cmdbuf); /* Clear it, just in case */
874 if (client_gets(cmdbuf) < 1) {
875 lprintf(3, "IMAP socket is broken. Ending session.\r\n");
880 lprintf(5, "citserver[%3d]: %s\r\n", CC->cs_pid, cmdbuf);
881 while (strlen(cmdbuf) < 5) strcat(cmdbuf, " ");
884 /* strip off l/t whitespace and CRLF */
885 if (cmdbuf[strlen(cmdbuf)-1]=='\n') cmdbuf[strlen(cmdbuf)-1]=0;
886 if (cmdbuf[strlen(cmdbuf)-1]=='\r') cmdbuf[strlen(cmdbuf)-1]=0;
889 /* If we're in the middle of a multi-line command, handle that */
890 if (IMAP->authstate == imap_as_expecting_username) {
891 imap_auth_login_user(cmdbuf);
894 if (IMAP->authstate == imap_as_expecting_password) {
895 imap_auth_login_pass(cmdbuf);
900 /* Ok, at this point we're in normal command mode. The first thing
901 * we do is print any incoming pages (yeah! we really do!)
903 imap_print_express_messages();
906 * Before processing the command that was just entered... if we happen
907 * to have a folder selected, we'd like to rescan that folder for new
908 * messages, and for deletions/changes of existing messages. This
909 * could probably be optimized somehow, but IMAP sucks...
911 if (IMAP->selected) {
912 imap_rescan_msgids();
915 /* Now for the command set. */
917 /* Grab the tag, command, and parameters. Check syntax. */
918 num_parms = imap_parameterize(parms, cmdbuf);
920 cprintf("BAD syntax error\r\n");
923 /* The commands below may be executed in any state */
925 else if ( (!strcasecmp(parms[1], "NOOP"))
926 || (!strcasecmp(parms[1], "CHECK")) ) {
927 cprintf("%s OK This command successfully did nothing.\r\n",
931 else if (!strcasecmp(parms[1], "LOGOUT")) {
932 cprintf("* BYE %s logging out\r\n", config.c_fqdn);
933 cprintf("%s OK thank you for using Citadel IMAP\r\n", parms[0]);
938 else if (!strcasecmp(parms[1], "LOGIN")) {
939 imap_login(num_parms, parms);
942 else if (!strcasecmp(parms[1], "AUTHENTICATE")) {
943 imap_authenticate(num_parms, parms);
946 else if (!strcasecmp(parms[1], "CAPABILITY")) {
947 imap_capability(num_parms, parms);
950 else if (!CC->logged_in) {
951 cprintf("%s BAD Not logged in.\r\n", parms[0]);
954 /* The commans below require a logged-in state */
956 else if (!strcasecmp(parms[1], "SELECT")) {
957 imap_select(num_parms, parms);
960 else if (!strcasecmp(parms[1], "EXAMINE")) {
961 imap_select(num_parms, parms);
964 else if (!strcasecmp(parms[1], "LSUB")) {
965 imap_lsub(num_parms, parms);
968 else if (!strcasecmp(parms[1], "LIST")) {
969 imap_list(num_parms, parms);
972 else if (!strcasecmp(parms[1], "CREATE")) {
973 imap_create(num_parms, parms);
976 else if (!strcasecmp(parms[1], "DELETE")) {
977 imap_delete(num_parms, parms);
980 else if (!strcasecmp(parms[1], "RENAME")) {
981 imap_rename(num_parms, parms);
984 else if (!strcasecmp(parms[1], "STATUS")) {
985 imap_status(num_parms, parms);
988 else if (!strcasecmp(parms[1], "SUBSCRIBE")) {
989 imap_subscribe(num_parms, parms);
992 else if (!strcasecmp(parms[1], "UNSUBSCRIBE")) {
993 imap_unsubscribe(num_parms, parms);
996 else if (IMAP->selected == 0) {
997 cprintf("%s BAD no folder selected\r\n", parms[0]);
1000 /* The commands below require the SELECT state on a mailbox */
1002 else if (!strcasecmp(parms[1], "FETCH")) {
1003 imap_fetch(num_parms, parms);
1006 else if ( (!strcasecmp(parms[1], "UID"))
1007 && (!strcasecmp(parms[2], "FETCH")) ) {
1008 imap_uidfetch(num_parms, parms);
1011 else if (!strcasecmp(parms[1], "SEARCH")) {
1012 imap_search(num_parms, parms);
1015 else if ( (!strcasecmp(parms[1], "UID"))
1016 && (!strcasecmp(parms[2], "SEARCH")) ) {
1017 imap_uidsearch(num_parms, parms);
1020 else if (!strcasecmp(parms[1], "STORE")) {
1021 imap_store(num_parms, parms);
1024 else if ( (!strcasecmp(parms[1], "UID"))
1025 && (!strcasecmp(parms[2], "STORE")) ) {
1026 imap_uidstore(num_parms, parms);
1029 else if (!strcasecmp(parms[1], "COPY")) {
1030 imap_copy(num_parms, parms);
1033 else if ( (!strcasecmp(parms[1], "UID"))
1034 && (!strcasecmp(parms[2], "COPY")) ) {
1035 imap_uidcopy(num_parms, parms);
1038 else if (!strcasecmp(parms[1], "EXPUNGE")) {
1039 imap_expunge(num_parms, parms);
1042 else if (!strcasecmp(parms[1], "CLOSE")) {
1043 imap_close(num_parms, parms);
1046 /* End of commands. If we get here, the command is either invalid
1051 cprintf("%s BAD command unrecognized\r\n", parms[0]);
1059 * This function is called by dynloader.c to register the IMAP module
1060 * with the Citadel server.
1062 char *Dynamic_Module_Init(void)
1064 SYM_IMAP = CtdlGetDynamicSymbol();
1065 CtdlRegisterServiceHook(config.c_imap_port,
1069 CtdlRegisterSessionHook(imap_cleanup_function, EVT_STOP);