4 * Utility functions for the IMAP module.
14 #include "sysdep_decls.h"
17 #include "internet_addressing.h"
18 #include "imap_tools.h"
26 * Output a string to the IMAP client, either as a literal or quoted.
27 * (We do a literal if it has any double-quotes or backslashes.)
29 void imap_strout(char *buf)
34 if (buf == NULL) { /* yeah, we handle this */
38 for (i = 0; i < strlen(buf); ++i) {
39 if ((buf[i] == '\"') || (buf[i] == '\\'))
44 cprintf("{%ld}\r\n%s", (long)strlen(buf), buf);
46 cprintf("\"%s\"", buf);
55 * Break a command down into tokens, taking into consideration the
56 * possibility of escaping spaces using quoted tokens
58 int imap_parameterize(char **args, char *buf)
68 original_len = strlen(buf);
70 for (i = 0; i < original_len; ++i) {
72 if ((isspace(buf[i])) && (!in_quote)) {
74 args[num] = &buf[start];
76 if (args[num][0] == '\"') {
78 args[num][strlen(args[num]) - 1] = 0;
81 } else if ((buf[i] == '\"') && (!in_quote)) {
83 } else if ((buf[i] == '\"') && (in_quote)) {
92 * Convert a struct ctdlroom to an IMAP-compatible mailbox name.
94 void imap_mailboxname(char *buf, int bufsize, struct ctdlroom *qrbuf)
102 * For mailboxes, just do it straight.
103 * Do the Cyrus-compatible thing: all private folders are
104 * subfolders of INBOX.
106 if (qrbuf->QRflags & QR_MAILBOX) {
107 safestrncpy(buf, qrbuf->QRname, bufsize);
108 strcpy(buf, &buf[11]);
109 if (!strcasecmp(buf, MAILROOM)) {
110 strcpy(buf, "INBOX");
114 sprintf(buf2, "INBOX/%s", buf);
120 * Otherwise, prefix the floor name as a "public folders" moniker
123 fl = cgetfloor(qrbuf->QRfloor);
124 snprintf(buf, bufsize, "%s/%s",
127 sfstart = strlen(fl->f_name) + 1;
131 * Replace delimiter characters with "/" for pseudo-folder-delimiting
132 * and replace actual slashes with "|" because they're illegal here.
134 for (i=sfstart; i<strlen(buf); ++i) {
135 if (buf[i] == FDELIM) buf[i] = '/';
136 else if (buf[i] == '/') buf[i] = '|';
142 * Convert an inputted folder name to our best guess as to what an equivalent
143 * room name should be.
145 * If an error occurs, it returns -1. Otherwise...
147 * The lower eight bits of the return value are the floor number on which the
148 * room most likely resides. The upper eight bits may contain flags,
149 * including IR_MAILBOX if we're dealing with a personal room.
152 int imap_roomname(char *rbuf, int bufsize, char *foldername)
161 if (foldername == NULL) return(-1);
162 levels = num_tokens(foldername, '/');
165 * Convert the crispy idiot's reserved names to our reserved names.
166 * Also handle Cyrus-compatible folder names.
168 if (!strcasecmp(foldername, "INBOX")) {
169 safestrncpy(rbuf, MAILROOM, bufsize);
170 ret = (0 | IR_MAILBOX);
172 else if (!strncasecmp(foldername, "INBOX/", 6)) {
173 safestrncpy(rbuf, &foldername[6], bufsize);
174 ret = (0 | IR_MAILBOX);
176 else if (levels > 1) {
177 extract_token(floorname, foldername, 0, '/');
178 strcpy(roomname, &foldername[strlen(floorname)+1]);
179 for (i = 0; i < MAXFLOORS; ++i) {
181 if (fl->f_flags & F_INUSE) {
182 if (!strcasecmp(floorname, fl->f_name)) {
183 strcpy(rbuf, roomname);
190 /* No subfolderificationalisticism on this one... */
191 safestrncpy(rbuf, foldername, bufsize);
192 ret = (0 | IR_MAILBOX);
197 safestrncpy(rbuf, foldername, bufsize);
198 ret = (0 | IR_MAILBOX);
201 /* Undelimiterizationalisticize the room name (change '/' and '|') */
202 for (i=0; i<strlen(rbuf); ++i) {
203 if (rbuf[i] == '/') rbuf[i] = FDELIM;
204 else if (rbuf[i] == '|') rbuf[i] = '/';
207 lprintf(CTDL_DEBUG, "(That translates to \"%s\")\n", rbuf);
216 * Output a struct internet_address_list in the form an IMAP client wants
218 void imap_ial_out(struct internet_address_list *ialist)
220 struct internet_address_list *iptr;
222 if (ialist == NULL) {
228 for (iptr = ialist; iptr != NULL; iptr = iptr->next) {
230 imap_strout(iptr->ial_name);
232 imap_strout(iptr->ial_user);
234 imap_strout(iptr->ial_node);
244 * Determine whether the supplied string is a valid message set.
245 * If the string contains only numbers, colons, commas, and asterisks,
246 * return 1 for a valid message set. If any other character is found,
249 int imap_is_message_set(char *buf)
254 return (0); /* stupidity checks */
255 if (strlen(buf) == 0)
258 if (!strcasecmp(buf, "ALL"))
259 return (1); /* macro? why? */
261 for (i = 0; i < strlen(buf); ++i) { /* now start the scan */
271 return (1); /* looks like we're good */
276 * imap_match.c, based on wildmat.c from INN
277 * hacked for Citadel/IMAP by Daniel Malament
280 /* note: not all return statements use these; don't change them */
281 #define WILDMAT_TRUE 1
282 #define WILDMAT_FALSE 0
283 #define WILDMAT_ABORT -1
284 #define WILDMAT_DELIM '/'
287 * Match text and p, return TRUE, FALSE, or ABORT.
289 static int do_imap_match(const char *supplied_text, const char *supplied_p)
292 char lcase_text[SIZ], lcase_p[SIZ];
293 char *text = lcase_text;
296 /* Copy both strings and lowercase them, in order to
297 * make this entire operation case-insensitive.
299 for (i=0; i<=strlen(supplied_text); ++i)
300 lcase_text[i] = tolower(supplied_text[i]);
301 for (i=0; i<=strlen(supplied_p); ++i)
302 p[i] = tolower(supplied_p[i]);
305 for (; *p; text++, p++) {
306 if ((*text == '\0') && (*p != '*') && (*p != '%')) {
307 return WILDMAT_ABORT;
312 return WILDMAT_FALSE;
317 while (++p, ((*p == '*') || (*p == '%'))) {
318 /* Consecutive stars or %'s act
319 * just like one star.
324 /* Trailing star matches everything. */
328 if ((matched = do_imap_match(text++, p))
333 return WILDMAT_ABORT;
335 while (++p, ((*p == '*') || (*p == '%'))) {
336 /* Consecutive %'s act just like one, but even
337 * a single star makes the sequence act like
347 * Trailing % matches everything
348 * without a delimiter.
351 if (*text == WILDMAT_DELIM) {
352 return WILDMAT_FALSE;
358 while (*text && (*(text - 1) != WILDMAT_DELIM)) {
359 if ((matched = do_imap_match(text++, p))
364 return WILDMAT_ABORT;
368 return (*text == '\0');
374 * Support function for mailbox pattern name matching in LIST and LSUB
375 * Returns nonzero if the supplied mailbox name matches the supplied pattern.
377 int imap_mailbox_matches_pattern(char *pattern, char *mailboxname)
379 /* handle just-star case quickly */
380 if ((pattern[0] == '*') && (pattern[1] == '\0')) {
383 return (do_imap_match(mailboxname, pattern) == WILDMAT_TRUE);
389 * Compare an IMAP date string (date only, no time) to the date found in
392 int imap_datecmp(char *datestr, time_t msgtime) {
397 int day, month, year;
398 int msgday, msgmonth, msgyear;
401 if (datestr == NULL) return(0);
403 /* Expecting a date in the form dd-Mmm-yyyy */
404 extract_token(daystr, datestr, 0, '-');
405 extract_token(monthstr, datestr, 1, '-');
406 extract_token(yearstr, datestr, 2, '-');
409 year = atoi(yearstr);
411 for (i=0; i<12; ++i) {
412 if (!strcasecmp(monthstr, ascmonths[i])) {
417 /* Extract day/month/year from message timestamp */
418 memcpy(&msgtm, localtime(&msgtime), sizeof(struct tm));
419 msgday = msgtm.tm_mday;
420 msgmonth = msgtm.tm_mon;
421 msgyear = msgtm.tm_year + 1900;
423 /* Now start comparing */
425 if (year < msgyear) return(+1);
426 if (year > msgyear) return(-1);
428 if (month < msgmonth) return(+1);
429 if (month > msgmonth) return(-1);
431 if (day < msgday) return(+1);
432 if (day > msgday) return(-1);