* More IMAP tweaks
[citadel.git] / citadel / imap_fetch.c
1 /*
2  * $Id$
3  *
4  * Implements the FETCH command in IMAP.
5  * This command is way too convoluted.  Marc Crispin is a fscking idiot.
6  *
7  */
8
9
10 #include "sysdep.h"
11 #include <stdlib.h>
12 #include <unistd.h>
13 #include <stdio.h>
14 #include <fcntl.h>
15 #include <signal.h>
16 #include <pwd.h>
17 #include <errno.h>
18 #include <sys/types.h>
19 #include <sys/time.h>
20 #include <sys/wait.h>
21 #include <ctype.h>
22 #include <string.h>
23 #include <limits.h>
24 #include "citadel.h"
25 #include "server.h"
26 #include <time.h>
27 #include "sysdep_decls.h"
28 #include "citserver.h"
29 #include "support.h"
30 #include "config.h"
31 #include "dynloader.h"
32 #include "room_ops.h"
33 #include "user_ops.h"
34 #include "policy.h"
35 #include "database.h"
36 #include "msgbase.h"
37 #include "tools.h"
38 #include "internet_addressing.h"
39 #include "mime_parser.h"
40 #include "serv_imap.h"
41 #include "imap_tools.h"
42 #include "imap_fetch.h"
43 #include "genstamp.h"
44
45
46
47 struct imap_fetch_part {
48         char desired_section[256];
49         FILE *output_fp;
50 };
51
52 /*
53  * Individual field functions for imap_do_fetch_msg() ...
54  */
55
56
57
58 void imap_fetch_uid(int seq) {
59         cprintf("UID %ld", IMAP->msgids[seq-1]);
60 }
61
62 void imap_fetch_flags(struct CtdlMessage *msg) {
63         cprintf("FLAGS ()");    /* FIXME do something here */
64 }
65
66 void imap_fetch_internaldate(struct CtdlMessage *msg) {
67         char buf[256];
68         time_t msgdate;
69
70         if (msg->cm_fields['T'] != NULL) {
71                 msgdate = atol(msg->cm_fields['T']);
72         }
73         else {
74                 msgdate = time(NULL);
75         }
76
77         datestring(buf, msgdate, DATESTRING_IMAP);
78         cprintf("INTERNALDATE \"%s\"", buf);
79 }
80
81
82 /*
83  * Fetch RFC822-formatted messages.
84  *
85  * 'whichfmt' should be set to one of:
86  *      "RFC822"        entire message
87  *      "RFC822.HEADER" headers only (with trailing blank line)
88  *      "RFC822.SIZE"   size of translated message
89  *      "RFC822.TEXT"   body only (without leading blank line)
90  */
91 void imap_fetch_rfc822(int msgnum, char *whichfmt, struct CtdlMessage *msg) {
92         FILE *tmp;
93         char buf[1024];
94         char *ptr;
95         long headers_size, text_size, total_size;
96         long bytes_remaining = 0;
97         long blocksize;
98
99         tmp = tmpfile();
100         if (tmp == NULL) {
101                 lprintf(1, "Cannot open temp file: %s\n", strerror(errno));
102                 return;
103         }
104
105         /*
106          * Load the message into a temp file for translation and measurement
107          */ 
108         CtdlRedirectOutput(tmp, -1);
109         CtdlOutputPreLoadedMsg(msg, msgnum, MT_RFC822, 0, 0, 1);
110         CtdlRedirectOutput(NULL, -1);
111         if (!is_valid_message(msg)) {
112                 lprintf(1, "WARNING: output clobbered the message!\n");
113         }
114
115         /*
116          * Now figure out where the headers/text break is.  IMAP considers the
117          * intervening blank line to be part of the headers, not the text.
118          */
119         rewind(tmp);
120         headers_size = 0L;
121         do {
122                 ptr = fgets(buf, sizeof buf, tmp);
123                 if (ptr != NULL) {
124                         striplt(buf);
125                         if (strlen(buf) == 0) headers_size = ftell(tmp);
126                 }
127         } while ( (headers_size == 0L) && (ptr != NULL) );
128         fseek(tmp, 0L, SEEK_END);
129         total_size = ftell(tmp);
130         text_size = total_size - headers_size;
131
132         if (!strcasecmp(whichfmt, "RFC822.SIZE")) {
133                 cprintf("RFC822.SIZE %ld", total_size);
134                 fclose(tmp);
135                 return;
136         }
137
138         else if (!strcasecmp(whichfmt, "RFC822")) {
139                 bytes_remaining = total_size;
140                 rewind(tmp);
141         }
142
143         else if (!strcasecmp(whichfmt, "RFC822.HEADER")) {
144                 bytes_remaining = headers_size;
145                 rewind(tmp);
146         }
147
148         else if (!strcasecmp(whichfmt, "RFC822.TEXT")) {
149                 bytes_remaining = text_size;
150                 fseek(tmp, headers_size, SEEK_SET);
151         }
152
153         cprintf("%s {%ld}\r\n", whichfmt, bytes_remaining);
154         blocksize = sizeof(buf);
155         while (bytes_remaining > 0L) {
156                 if (blocksize > bytes_remaining) blocksize = bytes_remaining;
157                 fread(buf, blocksize, 1, tmp);
158                 client_write(buf, blocksize);
159                 bytes_remaining = bytes_remaining - blocksize;
160         }
161
162         fclose(tmp);
163 }
164
165
166
167 /*
168  * Load a specific part of a message into the temp file to be output to a
169  * client.  FIXME we can handle parts like "2" and "2.1" and even "2.MIME"
170  * but we still can't handle "2.HEADER" (which might not be a problem, because
171  * we currently don't have the ability to break out nested RFC822's anyway).
172  *
173  * Note: mime_parser() was called with dont_decode set to 1, so we have the
174  * luxury of simply spewing without having to re-encode.
175  */
176 void imap_load_part(char *name, char *filename, char *partnum, char *disp,
177                     void *content, char *cbtype, size_t length, char *encoding,
178                     void *cbuserdata)
179 {
180         struct imap_fetch_part *imfp;
181         char mbuf2[1024];
182
183         imfp = (struct imap_fetch_part *)cbuserdata;
184
185         if (!strcasecmp(partnum, imfp->desired_section)) {
186                 fwrite(content, length, 1, imfp->output_fp);
187         }
188
189         sprintf(mbuf2, "%s.MIME", partnum);
190
191         if (!strcasecmp(imfp->desired_section, mbuf2)) {
192                 fprintf(imfp->output_fp, "Content-type: %s", cbtype);
193                 if (strlen(name) > 0)
194                         fprintf(imfp->output_fp, "; name=\"%s\"", name);
195                 fprintf(imfp->output_fp, "\r\n");
196                 if (strlen(encoding) > 0)
197                         fprintf(imfp->output_fp,
198                                 "Content-Transfer-Encoding: %s\r\n", encoding);
199                 if (strlen(encoding) > 0) {
200                         fprintf(imfp->output_fp, "Content-Disposition: %s",
201                                         disp);
202                         if (strlen(filename) > 0) {
203                                 fprintf(imfp->output_fp, "; filename=\"%s\"",
204                                         filename);
205                         }
206                         fprintf(imfp->output_fp, "\r\n");
207                 }
208                 fprintf(imfp->output_fp, "Content-Length: %d\r\n", length);
209                 fprintf(imfp->output_fp, "\r\n");
210         }
211                         
212
213 }
214
215
216 /* 
217  * Called by imap_fetch_envelope() to output the "From" field.
218  * This is in its own function because its logic is kind of complex.  We
219  * really need to make this suck less.
220  */
221 void imap_output_envelope_from(struct CtdlMessage *msg) {
222         char user[1024], node[1024], name[1024];
223
224         cprintf("((");                          /* open double-parens */
225         imap_strout(msg->cm_fields['A']);       /* personal name */
226         cprintf(" NIL ");                       /* source route (not used) */
227
228         if (msg->cm_fields['F'] != NULL) {
229                 process_rfc822_addr(msg->cm_fields['F'], user, node, name);
230                 imap_strout(user);              /* mailbox name (user id) */
231                 cprintf(" ");
232                 if (!strcasecmp(node, config.c_nodename)) {
233                         imap_strout(config.c_fqdn);
234                 }
235                 else {
236                         imap_strout(node);              /* host name */
237                 }
238         }
239         else {
240                 imap_strout(msg->cm_fields['A']); /* mailbox name (user id) */
241                 cprintf(" ");
242                 imap_strout(msg->cm_fields['N']);       /* host name */
243         }
244         
245         cprintf(")) ");                         /* close double-parens */
246 }
247
248
249 /*
250  * Implements the ENVELOPE fetch item
251  * 
252  * FIXME ... we only output some of the fields right now.  Definitely need
253  *           to do all of them.  Accurately, too.
254  *
255  * Note that the imap_strout() function can cleverly output NULL fields as NIL,
256  * so we don't have to check for that condition like we do elsewhere.
257  */
258 void imap_fetch_envelope(long msgnum, struct CtdlMessage *msg) {
259         char datestringbuf[256];
260         time_t msgdate;
261         char *fieldptr = NULL;
262
263         /* Parse the message date into an IMAP-format date string */
264         if (msg->cm_fields['T'] != NULL) {
265                 msgdate = atol(msg->cm_fields['T']);
266         }
267         else {
268                 msgdate = time(NULL);
269         }
270         datestring(datestringbuf, msgdate, DATESTRING_IMAP);
271
272         /* Now start spewing data fields.  The order is important, as it is
273          * defined by the protocol specification.  Nonexistent fields must
274          * be output as NIL, existent fields must be quoted or literalled.
275          * The imap_strout() function conveniently does all this for us.
276          */
277         cprintf("ENVELOPE (");
278
279         /* Date */
280         imap_strout(datestringbuf);
281         cprintf(" ");
282
283         /* Subject */
284         imap_strout(msg->cm_fields['U']);
285         cprintf(" ");
286
287         /* From */
288         imap_output_envelope_from(msg);
289
290         /* Sender */
291         if (0) {
292                 /* FIXME ... check for a *real* Sender: field */
293         }
294         else {
295                 imap_output_envelope_from(msg);
296         }
297
298         /* Reply-to */
299         if (0) {
300                 /* FIXME ... check for a *real* Reply-to: field */
301         }
302         else {
303                 imap_output_envelope_from(msg);
304         }
305
306         cprintf("NIL ");        /* to */
307
308         cprintf("NIL ");        /* cc */
309
310         cprintf("NIL ");        /* bcc */
311
312         /* In-reply-to */
313         fieldptr = rfc822_fetch_field(msg->cm_fields['M'], "In-reply-to");
314         imap_strout(fieldptr);
315         cprintf(" ");
316         if (fieldptr != NULL) phree(fieldptr);
317
318         /* message ID */
319         imap_strout(msg->cm_fields['I']);
320
321         cprintf(") ");
322 }
323
324
325 /*
326  * Strip any non header information out of a chunk of RFC822 data on disk
327  */
328 void imap_strip_headers(FILE *fp) {
329         char buf[1024];
330
331         rewind(fp);
332         while (fgets(buf, sizeof buf, fp) != NULL) {
333                 striplt(buf);
334                 if (strlen(buf) == 0) {
335                         fflush(fp);
336                         ftruncate(fileno(fp), ftell(fp));
337                 }
338         }
339         fflush(fp);
340         fprintf(fp, "\r\n");    /* add the trailing newline */
341         rewind(fp);
342 }
343
344
345 /*
346  * Implements the BODY and BODY.PEEK fetch items
347  */
348 void imap_fetch_body(long msgnum, char *item, int is_peek,
349                 struct CtdlMessage *msg) {
350         char section[1024];
351         char partial[1024];
352         int is_partial = 0;
353         char buf[1024];
354         int i;
355         FILE *tmp;
356         long bytes_remaining = 0;
357         long blocksize;
358         long pstart, pbytes;
359         struct imap_fetch_part imfp;
360
361         /* extract section */
362         strcpy(section, item);
363         for (i=0; i<strlen(section); ++i) {
364                 if (section[i]=='[') strcpy(section, &section[i+1]);
365         }
366         for (i=0; i<strlen(section); ++i) {
367                 if (section[i]==']') section[i] = 0;
368         }
369         lprintf(9, "Section is %s\n", section);
370
371         /* extract partial */
372         strcpy(partial, item);
373         for (i=0; i<strlen(partial); ++i) {
374                 if (partial[i]=='<') {
375                         strcpy(partial, &partial[i+1]);
376                         is_partial = 1;
377                 }
378         }
379         for (i=0; i<strlen(partial); ++i) {
380                 if (partial[i]=='>') partial[i] = 0;
381         }
382         if (is_partial == 0) strcpy(partial, "");
383         lprintf(9, "Partial is %s\n", partial);
384
385         tmp = tmpfile();
386         if (tmp == NULL) {
387                 lprintf(1, "Cannot open temp file: %s\n", strerror(errno));
388                 return;
389         }
390
391         /* Now figure out what the client wants, and get it */
392
393         if (!strcmp(section, "")) {             /* the whole thing */
394                 CtdlRedirectOutput(tmp, -1);
395                 CtdlOutputPreLoadedMsg(msg, msgnum, MT_RFC822, 0, 0, 1);
396                 CtdlRedirectOutput(NULL, -1);
397         }
398
399         /*
400          * Be obnoxious and send the entire header, even if the client only
401          * asks for certain fields.  FIXME this shortcut later.
402          */
403         else if (!strncasecmp(section, "HEADER", 6)) {
404                 CtdlRedirectOutput(tmp, -1);
405                 CtdlOutputPreLoadedMsg(msg, msgnum, MT_RFC822, 1, 0, 1);
406                 CtdlRedirectOutput(NULL, -1);
407                 imap_strip_headers(tmp);
408         }
409
410         /*
411          * Anything else must be a part specifier.
412          * (Note value of 1 passed as 'dont_decode' so client gets it encoded)
413          */
414         else {
415                 safestrncpy(imfp.desired_section, section,
416                                 sizeof(imfp.desired_section));
417                 imfp.output_fp = tmp;
418
419                 mime_parser(msg->cm_fields['M'], NULL,
420                                 *imap_load_part,
421                                 (void *)&imfp,
422                                 1);
423         }
424
425
426         fseek(tmp, 0L, SEEK_END);
427         bytes_remaining = ftell(tmp);
428
429         if (is_partial == 0) {
430                 rewind(tmp);
431                 cprintf("BODY[%s] {%ld}\r\n", section, bytes_remaining);
432         }
433         else {
434                 sscanf(partial, "%ld.%ld", &pstart, &pbytes);
435                 if ((bytes_remaining - pstart) < pbytes) {
436                         pbytes = bytes_remaining - pstart;
437                 }
438                 fseek(tmp, pstart, SEEK_SET);
439                 bytes_remaining = pbytes;
440                 cprintf("BODY[%s] {%ld}<%ld>\r\n",
441                         section, bytes_remaining, pstart);
442         }
443
444         blocksize = sizeof(buf);
445         while (bytes_remaining > 0L) {
446                 if (blocksize > bytes_remaining) blocksize = bytes_remaining;
447                 fread(buf, blocksize, 1, tmp);
448                 client_write(buf, blocksize);
449                 bytes_remaining = bytes_remaining - blocksize;
450         }
451
452         fclose(tmp);
453
454         if (is_peek) {
455                 /* FIXME set the last read pointer or something */
456         }
457 }
458
459
460 /*
461  * Spew the BODYSTRUCTURE data for a message.  (Do you need a silencer if
462  * you're going to shoot a MIME?  Do you need a reason to shoot Mark Crispin?
463  * No, and no.)
464  *
465  * FIXME finish the implementation
466  */
467 void imap_fetch_bodystructure (long msgnum, char *item,
468                 struct CtdlMessage *msg) {
469         FILE *tmp;
470         char buf[1024];
471         long lines = 0L;
472         long bytes = 0L;
473
474
475         /* For non-RFC822 (ordinary Citadel) messages, this is short and
476          * sweet...
477          */
478         if (msg->cm_format_type != FMT_RFC822) {
479
480                 /* *sigh* We have to RFC822-format the message just to be able
481                  * to measure it.
482                  */
483                 tmp = tmpfile();
484                 if (tmp == NULL) return;
485                 CtdlRedirectOutput(tmp, -1);
486                 CtdlOutputPreLoadedMsg(msg, msgnum, MT_RFC822, 0, 0, 1);
487                 CtdlRedirectOutput(NULL, -1);
488
489                 rewind(tmp);
490                 while (fgets(buf, sizeof buf, tmp) != NULL) ++lines;
491                 bytes = ftell(tmp);
492                 fclose(tmp);
493
494                 cprintf("BODYSTRUCTURE (\"TEXT\" \"PLAIN\" "
495                         "(\"CHARSET\" \"US-ASCII\") NIL NIL "
496                         "\"7BIT\" %ld %ld) ", bytes, lines);
497
498                 return;
499         }
500
501         /* For messages already stored in RFC822 format, we have to parse. */
502         /* FIXME do this! */
503
504
505 }
506
507
508
509
510
511
512 /*
513  * imap_do_fetch() calls imap_do_fetch_msg() to output the deta of an
514  * individual message, once it has been successfully loaded from disk.
515  */
516 void imap_do_fetch_msg(int seq, struct CtdlMessage *msg,
517                         int num_items, char **itemlist) {
518         int i;
519
520         cprintf("* %d FETCH (", seq);
521
522         for (i=0; i<num_items; ++i) {
523
524                 if (!strncasecmp(itemlist[i], "BODY[", 5)) {
525                         imap_fetch_body(IMAP->msgids[seq-1], itemlist[i],
526                                         0, msg);
527                 }
528                 else if (!strncasecmp(itemlist[i], "BODY.PEEK[", 10)) {
529                         imap_fetch_body(IMAP->msgids[seq-1], itemlist[i],
530                                         1, msg);
531                 }
532                 else if (!strcasecmp(itemlist[i], "BODYSTRUCTURE")) {
533                         imap_fetch_bodystructure(IMAP->msgids[seq-1],
534                                         itemlist[i], msg);
535                 }
536                 else if (!strcasecmp(itemlist[i], "ENVELOPE")) {
537                         imap_fetch_envelope(IMAP->msgids[seq-1], msg);
538                 }
539                 else if (!strcasecmp(itemlist[i], "FLAGS")) {
540                         imap_fetch_flags(msg);
541                 }
542                 else if (!strcasecmp(itemlist[i], "INTERNALDATE")) {
543                         imap_fetch_internaldate(msg);
544                 }
545                 else if (!strcasecmp(itemlist[i], "RFC822")) {
546                         imap_fetch_rfc822(IMAP->msgids[seq-1], itemlist[i], msg);
547                 }
548                 else if (!strcasecmp(itemlist[i], "RFC822.HEADER")) {
549                         imap_fetch_rfc822(IMAP->msgids[seq-1], itemlist[i], msg);
550                 }
551                 else if (!strcasecmp(itemlist[i], "RFC822.SIZE")) {
552                         imap_fetch_rfc822(IMAP->msgids[seq-1], itemlist[i], msg);
553                 }
554                 else if (!strcasecmp(itemlist[i], "RFC822.TEXT")) {
555                         imap_fetch_rfc822(IMAP->msgids[seq-1], itemlist[i], msg);
556                 }
557                 else if (!strcasecmp(itemlist[i], "UID")) {
558                         imap_fetch_uid(seq);
559                 }
560
561                 if (i != num_items-1) cprintf(" ");
562         }
563
564         cprintf(")\r\n");
565 }
566
567
568
569 /*
570  * imap_fetch() calls imap_do_fetch() to do its actual work, once it's
571  * validated and boiled down the request a bit.
572  */
573 void imap_do_fetch(int num_items, char **itemlist) {
574         int i;
575         struct CtdlMessage *msg;
576
577         if (IMAP->num_msgs > 0)
578          for (i = 0; i < IMAP->num_msgs; ++i)
579           if (IMAP->flags[i] && IMAP_FETCHED) {
580                 msg = CtdlFetchMessage(IMAP->msgids[i]);
581                 if (msg != NULL) {
582                         imap_do_fetch_msg(i+1, msg, num_items, itemlist);
583                         CtdlFreeMessage(msg);
584                 }
585                 else {
586                         cprintf("* %d FETCH <internal error>\r\n", i+1);
587                 }
588         }
589 }
590
591
592
593 /*
594  * Back end for imap_handle_macros()
595  * Note that this function *only* looks at the beginning of the string.  It
596  * is not a generic search-and-replace function.
597  */
598 void imap_macro_replace(char *str, char *find, char *replace) {
599         char holdbuf[1024];
600
601         if (!strncasecmp(str, find, strlen(find))) {
602                 if (str[strlen(find)]==' ') {
603                         strcpy(holdbuf, &str[strlen(find)+1]);
604                         strcpy(str, replace);
605                         strcat(str, " ");
606                         strcat(str, holdbuf);
607                 }
608                 if (str[strlen(find)]==0) {
609                         strcpy(holdbuf, &str[strlen(find)+1]);
610                         strcpy(str, replace);
611                 }
612         }
613 }
614
615
616
617 /*
618  * Handle macros embedded in FETCH data items.
619  * (What the heck are macros doing in a wire protocol?  Are we trying to save
620  * the computer at the other end the trouble of typing a lot of characters?)
621  */
622 void imap_handle_macros(char *str) {
623         int i;
624         int nest = 0;
625
626         for (i=0; i<strlen(str); ++i) {
627                 if (str[i]=='(') ++nest;
628                 if (str[i]=='[') ++nest;
629                 if (str[i]=='<') ++nest;
630                 if (str[i]=='{') ++nest;
631                 if (str[i]==')') --nest;
632                 if (str[i]==']') --nest;
633                 if (str[i]=='>') --nest;
634                 if (str[i]=='}') --nest;
635
636                 if (nest <= 0) {
637                         imap_macro_replace(&str[i],
638                                 "ALL",
639                                 "FLAGS INTERNALDATE RFC822.SIZE ENVELOPE"
640                         );
641                         imap_macro_replace(&str[i],
642                                 "BODY",
643                                 "BODYSTRUCTURE"
644                         );
645                         imap_macro_replace(&str[i],
646                                 "FAST",
647                                 "FLAGS INTERNALDATE RFC822.SIZE"
648                         );
649                         imap_macro_replace(&str[i],
650                                 "FULL",
651                                 "FLAGS INTERNALDATE RFC822.SIZE ENVELOPE BODY"
652                         );
653                 }
654         }
655 }
656
657
658 /*
659  * Break out the data items requested, possibly a parenthesized list.
660  * Returns the number of data items, or -1 if the list is invalid.
661  * NOTE: this function alters the string it is fed, and uses it as a buffer
662  * to hold the data for the pointers it returns.
663  */
664 int imap_extract_data_items(char **argv, char *items) {
665         int num_items = 0;
666         int nest = 0;
667         int i, initial_len;
668         char *start;
669
670         /* Convert all whitespace to ordinary space characters. */
671         for (i=0; i<strlen(items); ++i) {
672                 if (isspace(items[i])) items[i]=' ';
673         }
674
675         /* Strip leading and trailing whitespace, then strip leading and
676          * trailing parentheses if it's a list
677          */
678         striplt(items);
679         if ( (items[0]=='(') && (items[strlen(items)-1]==')') ) {
680                 items[strlen(items)-1] = 0;
681                 strcpy(items, &items[1]);
682                 striplt(items);
683         }
684
685         /* Parse any macro data items */
686         imap_handle_macros(items);
687
688         /*
689          * Now break out the data items.  We throw in one trailing space in
690          * order to avoid having to break out the last one manually.
691          */
692         strcat(items, " ");
693         start = items;
694         initial_len = strlen(items);
695         for (i=0; i<initial_len; ++i) {
696                 if (items[i]=='(') ++nest;
697                 if (items[i]=='[') ++nest;
698                 if (items[i]=='<') ++nest;
699                 if (items[i]=='{') ++nest;
700                 if (items[i]==')') --nest;
701                 if (items[i]==']') --nest;
702                 if (items[i]=='>') --nest;
703                 if (items[i]=='}') --nest;
704
705                 if (nest <= 0) if (items[i]==' ') {
706                         items[i] = 0;
707                         argv[num_items++] = start;
708                         start = &items[i+1];
709                 }
710         }
711
712         return(num_items);
713
714 }
715
716
717 /*
718  * One particularly hideous aspect of IMAP is that we have to allow the client
719  * to specify arbitrary ranges and/or sets of messages to fetch.  Citadel IMAP
720  * handles this by setting the IMAP_FETCHED flag for each message specified in
721  * the ranges/sets, then looping through the message array, outputting messages
722  * with the flag set.  We don't bother returning an error if an out-of-range
723  * number is specified (we just return quietly) because any client braindead
724  * enough to request a bogus message number isn't going to notice the
725  * difference anyway.
726  *
727  * This function clears out the IMAP_FETCHED bits, then sets that bit for each
728  * message included in the specified range.
729  *
730  * Set is_uid to 1 to fetch by UID instead of sequence number.
731  */
732 void imap_pick_range(char *range, int is_uid) {
733         int i;
734         int num_sets;
735         int s;
736         char setstr[1024], lostr[1024], histr[1024];
737         int lo, hi;
738
739         /*
740          * Clear out the IMAP_FETCHED flags for all messages.
741          */
742         for (i = 1; i <= IMAP->num_msgs; ++i) {
743                 IMAP->flags[i-1] = IMAP->flags[i-1] & ~IMAP_FETCHED;
744         }
745
746         /*
747          * Now set it for all specified messages.
748          */
749         num_sets = num_tokens(range, ',');
750         for (s=0; s<num_sets; ++s) {
751                 extract_token(setstr, range, s, ',');
752
753                 extract_token(lostr, setstr, 0, ':');
754                 if (num_tokens(setstr, ':') >= 2) {
755                         extract_token(histr, setstr, 1, ':');
756                         if (!strcmp(histr, "*")) sprintf(histr, "%d", INT_MAX);
757                 } 
758                 else {
759                         strcpy(histr, lostr);
760                 }
761                 lo = atoi(lostr);
762                 hi = atoi(histr);
763
764                 /* Loop through the array, flipping bits where appropriate */
765                 for (i = 1; i <= IMAP->num_msgs; ++i) {
766                         if (is_uid) {   /* fetch by sequence number */
767                                 if ( (IMAP->msgids[i-1]>=lo)
768                                    && (IMAP->msgids[i-1]<=hi)) {
769                                         IMAP->flags[i-1] =
770                                                 IMAP->flags[i-1] | IMAP_FETCHED;
771                                 }
772                         }
773                         else {          /* fetch by uid */
774                                 if ( (i>=lo) && (i<=hi)) {
775                                         IMAP->flags[i-1] =
776                                                 IMAP->flags[i-1] | IMAP_FETCHED;
777                                 }
778                         }
779                 }
780         }
781 }
782
783
784
785 /*
786  * This function is called by the main command loop.
787  */
788 void imap_fetch(int num_parms, char *parms[]) {
789         char items[1024];
790         char *itemlist[256];
791         int num_items;
792         int i;
793
794         if (num_parms < 4) {
795                 cprintf("%s BAD invalid parameters\r\n", parms[0]);
796                 return;
797         }
798
799         imap_pick_range(parms[2], 0);
800
801         strcpy(items, "");
802         for (i=3; i<num_parms; ++i) {
803                 strcat(items, parms[i]);
804                 if (i < (num_parms-1)) strcat(items, " ");
805         }
806
807         num_items = imap_extract_data_items(itemlist, items);
808         if (num_items < 1) {
809                 cprintf("%s BAD invalid data item list\r\n", parms[0]);
810                 return;
811         }
812
813         imap_do_fetch(num_items, itemlist);
814         cprintf("%s OK FETCH completed\r\n", parms[0]);
815 }
816
817 /*
818  * This function is called by the main command loop.
819  */
820 void imap_uidfetch(int num_parms, char *parms[]) {
821         char items[1024];
822         char *itemlist[256];
823         int num_items;
824         int i;
825         int have_uid_item = 0;
826
827         if (num_parms < 5) {
828                 cprintf("%s BAD invalid parameters\r\n", parms[0]);
829                 return;
830         }
831
832         imap_pick_range(parms[3], 1);
833
834         strcpy(items, "");
835         for (i=4; i<num_parms; ++i) {
836                 strcat(items, parms[i]);
837                 if (i < (num_parms-1)) strcat(items, " ");
838         }
839
840         num_items = imap_extract_data_items(itemlist, items);
841         if (num_items < 1) {
842                 cprintf("%s BAD invalid data item list\r\n", parms[0]);
843                 return;
844         }
845
846         /* If the "UID" item was not included, we include it implicitly
847          * because this is a UID FETCH command
848          */
849         for (i=0; i<num_items; ++i) {
850                 if (!strcasecmp(itemlist[i], "UID")) ++have_uid_item;
851         }
852         if (have_uid_item == 0) itemlist[num_items++] = "UID";
853
854         imap_do_fetch(num_items, itemlist);
855         cprintf("%s OK UID FETCH completed\r\n", parms[0]);
856 }
857
858