/* * imap.c -- IMAP2bis/IMAP4 protocol methods * * Copyright 1996 by Eric S. Raymond * All rights reserved. * For license terms, see the file COPYING in this directory. */ #include #include #include #include #if defined(STDC_HEADERS) #include #endif #include "fetchmail.h" #include "socket.h" extern char *strstr(); /* needed on sysV68 R3V7.1. */ /* imap_version values */ #define IMAP2 -1 /* IMAP2 or IMAP2BIS, RFC1176 */ #define IMAP4 0 /* IMAP4 rev 0, RFC1730 */ #define IMAP4rev1 1 /* IMAP4 rev 1, RFC2060 */ static int count, seen, recent, unseen, deletecount, imap_version; int imap_ok (int sock, char *argbuf) /* parse command response */ { char buf [POPBUFSIZE+1]; seen = 0; do { int ok; if ((ok = gen_recv(sock, buf, sizeof(buf)))) return(ok); /* interpret untagged status responses */ if (strstr(buf, "EXISTS")) count = atoi(buf+2); if (strstr(buf, "RECENT")) recent = atoi(buf+2); if (strstr(buf, "UNSEEN")) unseen = atoi(buf+2); if (strstr(buf, "FLAGS")) seen = (strstr(buf, "Seen") != (char *)NULL); } while (tag[0] != '\0' && strncmp(buf, tag, strlen(tag))); if (tag[0] == '\0') { strcpy(argbuf, buf); return(PS_SUCCESS); } else { char *cp; /* skip the tag */ for (cp = buf; !isspace(*cp); cp++) continue; while (isspace(*cp)) cp++; if (strncmp(cp, "OK", 2) == 0) { strcpy(argbuf, cp); return(PS_SUCCESS); } else if (strncmp(cp, "BAD", 2) == 0) return(PS_ERROR); else return(PS_PROTOCOL); } } int imap_getauth(int sock, struct query *ctl, char *buf) /* apply for connection authorization */ { char rbuf [POPBUFSIZE+1]; /* try to get authorized */ int ok = gen_transact(sock, "LOGIN %s \"%s\"", ctl->remotename, ctl->password); if (ok) return(ok); /* probe to see if we're running IMAP4 and can use RFC822.PEEK */ gen_send(sock, "CAPABILITY"); if ((ok = gen_recv(sock, rbuf, sizeof(rbuf)))) return(ok); if (strstr(rbuf, "BAD")) { imap_version = IMAP2; if (outlevel == O_VERBOSE) error(0, 0, "Protocol identified as IMAP2 or IMAP2BIS"); } else if (strstr(rbuf, "IMAP4rev1")) { imap_version = IMAP4rev1; if (outlevel == O_VERBOSE) error(0, 0, "Protocol identified as IMAP4 rev 1"); } else { imap_version = IMAP4; if (outlevel == O_VERBOSE) error(0, 0, "Protocol identified as IMAP4 rev 0"); } peek_capable = (imap_version >= IMAP4); return(PS_SUCCESS); } static int imap_getrange(int sock, struct query *ctl, const char *folder, int *countp, int *newp) /* get range of messages to be fetched */ { int ok; /* find out how many messages are waiting */ recent = unseen = 0; ok = gen_transact(sock, "SELECT %s", folder ? folder : "INBOX"); if (ok != 0) { error(0, 0, "mailbox selection failed"); return(ok); } *countp = count; if (unseen) /* optional response, but better if we see it */ *newp = unseen; else if (recent) /* mandatory */ *newp = recent; else *newp = -1; /* should never happen, RECENT is mandatory */ deletecount = 0; return(PS_SUCCESS); } static int imap_getsizes(int sock, int count, int *sizes) /* capture the sizes of all messages */ { char buf [POPBUFSIZE+1]; gen_send(sock, "FETCH 1:%d RFC822.SIZE", count); while (SockRead(sock, buf, sizeof(buf))) { int num, size, ok; if ((ok = gen_recv(sock, buf, sizeof(buf)))) return(ok); if (strstr(buf, "OK")) break; else if (sscanf(buf, "* %d FETCH (RFC822.SIZE %d)", &num, &size) == 2) sizes[num - 1] = size; else sizes[num - 1] = -1; } return(PS_SUCCESS); } static int imap_is_old(int sock, struct query *ctl, int number) /* is the given message old? */ { int ok; /* expunges change the fetch numbers */ number -= deletecount; if ((ok = gen_transact(sock, "FETCH %d FLAGS", number)) != 0) return(PS_ERROR); return(seen); } static int imap_fetch_headers(int sock, struct query *ctl,int number,int *lenp) /* request headers of nth message */ { char buf [POPBUFSIZE+1]; int num; /* expunges change the fetch numbers */ number -= deletecount; /* * This is blessed by RFC 1176, RFC1730, RFC2060. * According to the RFCs, it should *not* set the \Seen flag. */ gen_send(sock, "FETCH %d RFC822.HEADER", number); /* looking for FETCH response */ do { int ok; if ((ok = gen_recv(sock, buf, sizeof(buf)))) return(ok); } while (sscanf(buf+2, "%d FETCH (%*s {%d}", &num, lenp) != 2); if (num != number) return(PS_ERROR); else return(PS_SUCCESS); } static int imap_fetch_body(int sock, struct query *ctl, int number, int *lenp) /* request body of nth message */ { char buf [POPBUFSIZE+1]; int num; /* expunges change the fetch numbers */ number -= deletecount; /* * If we're using IMAP4, we can fetch the message without setting its * seen flag. This is good! It means that if the protocol exchange * craps out during the message, it will still be marked `unseen' on * the server. * * However...*don't* do this if we're using keep to suppress deletion! * In that case, marking the seen flag is the only way to prevent the * message from being re-fetched on subsequent runs. */ switch (imap_version) { case IMAP4rev1: /* RFC 2060 */ if (!ctl->keep) gen_send(sock, "FETCH %d BODY.PEEK[TEXT]", number); else gen_send(sock, "FETCH %d BODY[TEXT]", number); break; case IMAP4: /* RFC 1730 */ if (!ctl->keep) gen_send(sock, "FETCH %d RFC822.TEXT.PEEK", number); else gen_send(sock, "FETCH %d RFC822.TEXT", number); break; default: /* RFC 1176 */ gen_send(sock, "FETCH %d RFC822.TEXT", number); break; } /* looking for FETCH response */ do { int ok; if ((ok = gen_recv(sock, buf, sizeof(buf)))) return(ok); } while /* third token can be "RFC822" or "BODY[]" */ (sscanf(buf+2, "%d FETCH (%*s {%d}", &num, lenp) != 2); if (num != number) return(PS_ERROR); else return(PS_SUCCESS); } static int imap_trail(int sock, struct query *ctl, int number) /* discard tail of FETCH response after reading message text */ { char buf [POPBUFSIZE+1]; /* expunges change the fetch numbers */ /* number -= deletecount; */ return(gen_recv(sock, buf, sizeof(buf))); } static int imap_delete(int sock, struct query *ctl, int number) /* set delete flag for given message */ { int ok; /* expunges change the fetch numbers */ number -= deletecount; /* * Use SILENT if possible as a minor throughput optimization. * Note: this has been dropped from IMAP4rev1. */ if ((ok = gen_transact(sock, imap_version == IMAP4 ? "STORE %d +FLAGS.SILENT (\\Deleted)" : "STORE %d +FLAGS (\\Deleted)", number))) return(ok); /* * We do an expunge after each message, rather than just before quit, * so that a line hit during a long session won't result in lots of * messages being fetched again during the next session. */ if ((ok = gen_transact(sock, "EXPUNGE"))) return(ok); deletecount++; return(PS_SUCCESS); } const static struct method imap = { "IMAP", /* Internet Message Access Protocol */ 143, /* standard IMAP2bis/IMAP4 port */ 1, /* this is a tagged protocol */ 0, /* no message delimiter */ imap_ok, /* parse command response */ imap_getauth, /* get authorization */ imap_getrange, /* query range of messages */ imap_getsizes, /* grab message sizes */ imap_is_old, /* no UID check */ imap_fetch_headers, /* request given message headers */ imap_fetch_body, /* request given message body */ imap_trail, /* eat message trailer */ imap_delete, /* delete the message */ "LOGOUT", /* the IMAP exit command */ }; int doIMAP(struct query *ctl) /* retrieve messages using IMAP Version 2bis or Version 4 */ { return(do_protocol(ctl, &imap)); } /* imap.c ends here */