NeoMutt  2023-03-22-27-g3cb248
Teaching an old dog new tricks
DOXYGEN
private.h
Go to the documentation of this file.
1
25#ifndef MUTT_IMAP_PRIVATE_H
26#define MUTT_IMAP_PRIVATE_H
27
28#include "config.h"
29#include <stdbool.h>
30#include <stdint.h>
31#include <stdio.h>
32#include "config/lib.h"
33#include "mutt.h"
34
35struct Buffer;
36struct ConnAccount;
37struct Email;
38struct ImapAccountData;
39struct ImapMboxData;
40struct ListHead;
41struct Mailbox;
42struct Message;
43struct Progress;
44
45#define IMAP_PORT 143
46#define IMAP_SSL_PORT 993
47
48/* logging levels */
49#define IMAP_LOG_CMD 2
50#define IMAP_LOG_LTRL 3
51#define IMAP_LOG_PASS 5
52
53/* IMAP command responses. Used in ImapCommand.state too */
54#define IMAP_RES_NO -2
55#define IMAP_RES_BAD -1
56#define IMAP_RES_OK 0
57#define IMAP_RES_CONTINUE 1
58#define IMAP_RES_RESPOND 2
59#define IMAP_RES_NEW 3
60
61#define SEQ_LEN 16
62#define IMAP_MAX_CMDLEN 1024
63
64typedef uint8_t ImapOpenFlags;
65#define IMAP_OPEN_NO_FLAGS 0
66#define IMAP_REOPEN_ALLOW (1 << 0)
67#define IMAP_EXPUNGE_EXPECTED (1 << 1)
68#define IMAP_EXPUNGE_PENDING (1 << 2)
69#define IMAP_NEWMAIL_PENDING (1 << 3)
70#define IMAP_FLAGS_PENDING (1 << 4)
71
72typedef uint8_t ImapCmdFlags;
73#define IMAP_CMD_NO_FLAGS 0
74#define IMAP_CMD_PASS (1 << 0)
75#define IMAP_CMD_QUEUE (1 << 1)
76#define IMAP_CMD_POLL (1 << 2)
77#define IMAP_CMD_SINGLE (1 << 3)
78
83{
87};
88
89/* length of "DD-MMM-YYYY HH:MM:SS +ZZzz" (null-terminated) */
90#define IMAP_DATELEN 27
91
96{
99};
100
105{
106 /* States */
111
112 /* and pseudo-states */
114};
115
121typedef uint32_t ImapCapFlags;
122#define IMAP_CAP_NO_FLAGS 0
123#define IMAP_CAP_IMAP4 (1 << 0)
124#define IMAP_CAP_IMAP4REV1 (1 << 1)
125#define IMAP_CAP_STATUS (1 << 2)
126#define IMAP_CAP_ACL (1 << 3)
127#define IMAP_CAP_NAMESPACE (1 << 4)
128#define IMAP_CAP_AUTH_CRAM_MD5 (1 << 5)
129#define IMAP_CAP_AUTH_GSSAPI (1 << 6)
130#define IMAP_CAP_AUTH_ANONYMOUS (1 << 7)
131#define IMAP_CAP_AUTH_OAUTHBEARER (1 << 8)
132#define IMAP_CAP_AUTH_XOAUTH2 (1 << 9)
133#define IMAP_CAP_STARTTLS (1 << 10)
134#define IMAP_CAP_LOGINDISABLED (1 << 11)
135#define IMAP_CAP_IDLE (1 << 12)
136#define IMAP_CAP_SASL_IR (1 << 13)
137#define IMAP_CAP_ENABLE (1 << 14)
138#define IMAP_CAP_CONDSTORE (1 << 15)
139#define IMAP_CAP_QRESYNC (1 << 16)
140#define IMAP_CAP_LIST_EXTENDED (1 << 17)
141#define IMAP_CAP_COMPRESS (1 << 18)
142#define IMAP_CAP_X_GM_EXT_1 (1 << 19)
143#define IMAP_CAP_ID (1 << 20)
144
145#define IMAP_CAP_ALL ((1 << 21) - 1)
146
151{
152 char *name;
153 char delim;
156};
157
162{
163 char seq[SEQ_LEN + 1];
164 int state;
165};
166
171{
173 char *eostr;
175 int down;
176 unsigned int range_cur;
177 unsigned int range_end;
180};
181
182/* -- private IMAP functions -- */
183/* imap.c */
184int imap_create_mailbox(struct ImapAccountData *adata, const char *mailbox);
185int imap_rename_mailbox(struct ImapAccountData *adata, char *oldname, const char *newname);
186int imap_exec_msgset(struct Mailbox *m, const char *pre, const char *post,
187 enum MessageType flag, bool changed, bool invert);
188int imap_open_connection(struct ImapAccountData *adata);
189void imap_close_connection(struct ImapAccountData *adata);
190int imap_read_literal(FILE *fp, struct ImapAccountData *adata, unsigned long bytes, struct Progress *progress);
191void imap_expunge_mailbox(struct Mailbox *m, bool resort);
192int imap_login(struct ImapAccountData *adata);
193int imap_sync_message_for_copy(struct Mailbox *m, struct Email *e, struct Buffer *cmd, enum QuadOption *err_continue);
194bool imap_has_flag(struct ListHead *flag_list, const char *flag);
195int imap_adata_find(const char *path, struct ImapAccountData **adata, struct ImapMboxData **mdata);
196
197/* auth.c */
198int imap_authenticate(struct ImapAccountData *adata);
199
200/* command.c */
201int imap_cmd_start(struct ImapAccountData *adata, const char *cmdstr);
202int imap_cmd_step(struct ImapAccountData *adata);
203void imap_cmd_finish(struct ImapAccountData *adata);
204bool imap_code(const char *s);
205const char *imap_cmd_trailer(struct ImapAccountData *adata);
206int imap_exec(struct ImapAccountData *adata, const char *cmdstr, ImapCmdFlags flags);
207int imap_cmd_idle(struct ImapAccountData *adata);
208
209/* message.c */
210int imap_read_headers(struct Mailbox *m, unsigned int msn_begin, unsigned int msn_end, bool initial_download);
211char *imap_set_flags(struct Mailbox *m, struct Email *e, char *s, bool *server_changes);
212int imap_cache_del(struct Mailbox *m, struct Email *e);
213int imap_cache_clean(struct Mailbox *m);
214int imap_append_message(struct Mailbox *m, struct Message *msg);
215
216bool imap_msg_open(struct Mailbox *m, struct Message *msg, int msgno);
217int imap_msg_close(struct Mailbox *m, struct Message *msg);
218int imap_msg_commit(struct Mailbox *m, struct Message *msg);
219int imap_msg_save_hcache(struct Mailbox *m, struct Email *e);
220
221/* util.c */
222#ifdef USE_HCACHE
223void imap_hcache_open(struct ImapAccountData *adata, struct ImapMboxData *mdata);
224void imap_hcache_close(struct ImapMboxData *mdata);
225struct Email *imap_hcache_get(struct ImapMboxData *mdata, unsigned int uid);
226int imap_hcache_put(struct ImapMboxData *mdata, struct Email *e);
227int imap_hcache_del(struct ImapMboxData *mdata, unsigned int uid);
230char *imap_hcache_get_uid_seqset(struct ImapMboxData *mdata);
231#endif
232
233enum QuadOption imap_continue(const char *msg, const char *resp);
234void imap_error(const char *where, const char *msg);
235void imap_mdata_cache_reset(struct ImapMboxData *mdata);
236char *imap_fix_path(char delim, const char *mailbox, char *path, size_t plen);
237void imap_cachepath(char delim, const char *mailbox, struct Buffer *dest);
238int imap_get_literal_count(const char *buf, unsigned int *bytes);
239char *imap_get_qualifier(char *buf);
240char *imap_next_word(char *s);
241void imap_qualify_path(char *buf, size_t buflen, struct ConnAccount *conn_account, char *path);
242void imap_quote_string(char *dest, size_t dlen, const char *src, bool quote_backtick);
243void imap_unquote_string(char *s);
244void imap_munge_mbox_name(bool unicode, char *dest, size_t dlen, const char *src);
245void imap_unmunge_mbox_name(bool unicode, char *s);
246struct SeqsetIterator *mutt_seqset_iterator_new(const char *seqset);
247int mutt_seqset_iterator_next(struct SeqsetIterator *iter, unsigned int *next);
249bool imap_account_match(const struct ConnAccount *a1, const struct ConnAccount *a2);
250void imap_get_parent(const char *mbox, char delim, char *buf, size_t buflen);
251bool mutt_account_match(const struct ConnAccount *a1, const struct ConnAccount *a2);
252
253/* utf7.c */
254void imap_utf_encode(bool unicode, char **s);
255void imap_utf_decode(bool unicode, char **s);
256void imap_allow_reopen(struct Mailbox *m);
257void imap_disallow_reopen(struct Mailbox *m);
258
259/* search.c */
260void cmd_parse_search(struct ImapAccountData *adata, const char *s);
261
262#endif /* MUTT_IMAP_PRIVATE_H */
Convenience wrapper for the config headers.
int imap_msg_close(struct Mailbox *m, struct Message *msg)
Close an email - Implements MxOps::msg_close() -.
Definition: message.c:2158
int imap_msg_commit(struct Mailbox *m, struct Message *msg)
Save changes to an email - Implements MxOps::msg_commit() -.
Definition: message.c:2144
bool imap_msg_open(struct Mailbox *m, struct Message *msg, int msgno)
Open an email message in a Mailbox - Implements MxOps::msg_open() -.
Definition: message.c:1942
int imap_msg_save_hcache(struct Mailbox *m, struct Email *e)
Save message to the header cache - Implements MxOps::msg_save_hcache() -.
Definition: message.c:2166
int imap_cmd_start(struct ImapAccountData *adata, const char *cmdstr)
Given an IMAP command, send it to the server.
Definition: command.c:1071
void imap_unmunge_mbox_name(bool unicode, char *s)
Remove quoting from a mailbox name.
Definition: util.c:924
int imap_cache_clean(struct Mailbox *m)
Delete all the entries in the message cache.
Definition: message.c:1853
void imap_close_connection(struct ImapAccountData *adata)
Close an IMAP connection.
Definition: imap.c:863
void imap_qualify_path(char *buf, size_t buflen, struct ConnAccount *conn_account, char *path)
Make an absolute IMAP folder target.
Definition: util.c:816
char * imap_set_flags(struct Mailbox *m, struct Email *e, char *s, bool *server_changes)
Fill the message header according to the server flags.
Definition: message.c:1885
void imap_allow_reopen(struct Mailbox *m)
Allow re-opening a folder upon expunge.
Definition: util.c:1012
void imap_disallow_reopen(struct Mailbox *m)
Disallow re-opening a folder upon expunge.
Definition: util.c:1025
ImapState
IMAP connection state.
Definition: private.h:105
@ IMAP_DISCONNECTED
Disconnected from server.
Definition: private.h:107
@ IMAP_IDLE
Connection is idle.
Definition: private.h:113
@ IMAP_AUTHENTICATED
Connection is authenticated.
Definition: private.h:109
@ IMAP_SELECTED
Mailbox is selected.
Definition: private.h:110
@ IMAP_CONNECTED
Connected to server.
Definition: private.h:108
uint8_t ImapOpenFlags
Flags, e.g. MUTT_THREAD_COLLAPSE.
Definition: private.h:64
int imap_get_literal_count(const char *buf, unsigned int *bytes)
Write number of bytes in an IMAP literal into bytes.
Definition: util.c:741
int imap_hcache_store_uid_seqset(struct ImapMboxData *mdata)
Store a UID Sequence Set in the header cache.
Definition: util.c:414
int imap_hcache_put(struct ImapMboxData *mdata, struct Email *e)
Add an entry to the header cache.
Definition: util.c:379
void imap_mdata_cache_reset(struct ImapMboxData *mdata)
Release and clear cache data of ImapMboxData structure.
Definition: util.c:105
void imap_get_parent(const char *mbox, char delim, char *buf, size_t buflen)
Get an IMAP folder's parent.
Definition: util.c:119
struct SeqsetIterator * mutt_seqset_iterator_new(const char *seqset)
Create a new Sequence Set Iterator.
Definition: util.c:1072
int imap_exec_msgset(struct Mailbox *m, const char *pre, const char *post, enum MessageType flag, bool changed, bool invert)
Prepare commands for all messages matching conditions.
Definition: imap.c:940
bool mutt_account_match(const struct ConnAccount *a1, const struct ConnAccount *a2)
void imap_utf_encode(bool unicode, char **s)
Encode email from local charset to UTF-8.
Definition: utf7.c:392
void imap_quote_string(char *dest, size_t dlen, const char *src, bool quote_backtick)
Quote string according to IMAP rules.
Definition: util.c:833
char * imap_hcache_get_uid_seqset(struct ImapMboxData *mdata)
Get a UID Sequence Set from the header cache.
Definition: util.c:450
enum QuadOption imap_continue(const char *msg, const char *resp)
Display a message and ask the user if they want to go on.
Definition: util.c:646
void imap_unquote_string(char *s)
Equally stupid unquoting routine.
Definition: util.c:870
struct Email * imap_hcache_get(struct ImapMboxData *mdata, unsigned int uid)
Get a header cache entry by its UID.
Definition: util.c:354
const char * imap_cmd_trailer(struct ImapAccountData *adata)
Extra information after tagged command response if any.
Definition: command.c:1223
int imap_append_message(struct Mailbox *m, struct Message *msg)
Write an email back to the server.
Definition: message.c:1528
int mutt_seqset_iterator_next(struct SeqsetIterator *iter, unsigned int *next)
Get the next UID from a Sequence Set.
Definition: util.c:1093
ImapExecResult
Imap_exec return code.
Definition: private.h:83
@ IMAP_EXEC_SUCCESS
Imap command executed or queued successfully.
Definition: private.h:84
@ IMAP_EXEC_ERROR
Imap command failure.
Definition: private.h:85
@ IMAP_EXEC_FATAL
Imap connection failure.
Definition: private.h:86
void mutt_seqset_iterator_free(struct SeqsetIterator **ptr)
Free a Sequence Set Iterator.
Definition: util.c:1152
int imap_cmd_idle(struct ImapAccountData *adata)
Enter the IDLE state.
Definition: command.c:1392
int imap_cmd_step(struct ImapAccountData *adata)
Reads server responses from an IMAP command.
Definition: command.c:1085
char * imap_fix_path(char delim, const char *mailbox, char *path, size_t plen)
Fix up the imap path.
Definition: util.c:679
void imap_expunge_mailbox(struct Mailbox *m, bool resort)
Purge messages from the server.
Definition: imap.c:683
int imap_open_connection(struct ImapAccountData *adata)
Open an IMAP connection.
Definition: imap.c:755
#define SEQ_LEN
Definition: private.h:61
void imap_cachepath(char delim, const char *mailbox, struct Buffer *dest)
Generate a cache path for a mailbox.
Definition: util.c:710
int imap_rename_mailbox(struct ImapAccountData *adata, char *oldname, const char *newname)
Rename a mailbox.
Definition: imap.c:494
int imap_create_mailbox(struct ImapAccountData *adata, const char *mailbox)
Create a new mailbox.
Definition: imap.c:453
void imap_utf_decode(bool unicode, char **s)
Decode email from UTF-8 to local charset.
Definition: utf7.c:422
void imap_error(const char *where, const char *msg)
Show an error and abort.
Definition: util.c:657
void imap_hcache_close(struct ImapMboxData *mdata)
Close the header cache.
Definition: util.c:338
int imap_cache_del(struct Mailbox *m, struct Email *e)
Delete an email from the body cache.
Definition: message.c:1834
ImapFlags
IMAP server responses.
Definition: private.h:96
@ IMAP_BYE
Logged out from server.
Definition: private.h:98
@ IMAP_FATAL
Unrecoverable error occurred.
Definition: private.h:97
int imap_hcache_del(struct ImapMboxData *mdata, unsigned int uid)
Delete an item from the header cache.
Definition: util.c:397
int imap_read_headers(struct Mailbox *m, unsigned int msn_begin, unsigned int msn_end, bool initial_download)
Read headers from the server.
Definition: message.c:1330
int imap_sync_message_for_copy(struct Mailbox *m, struct Email *e, struct Buffer *cmd, enum QuadOption *err_continue)
Update server to reflect the flags of a single message.
Definition: imap.c:1017
bool imap_code(const char *s)
Was the command successful.
Definition: command.c:1212
int imap_hcache_clear_uid_seqset(struct ImapMboxData *mdata)
Delete a UID Sequence Set from the header cache.
Definition: util.c:436
int imap_adata_find(const char *path, struct ImapAccountData **adata, struct ImapMboxData **mdata)
Find the Account data for this path.
Definition: util.c:71
bool imap_account_match(const struct ConnAccount *a1, const struct ConnAccount *a2)
Compare two Accounts.
Definition: util.c:1040
void cmd_parse_search(struct ImapAccountData *adata, const char *s)
Store SEARCH response for later use.
Definition: search.c:259
void imap_munge_mbox_name(bool unicode, char *dest, size_t dlen, const char *src)
Quote awkward characters in a mailbox name.
Definition: util.c:907
void imap_hcache_open(struct ImapAccountData *adata, struct ImapMboxData *mdata)
Open a header cache.
Definition: util.c:296
int imap_read_literal(FILE *fp, struct ImapAccountData *adata, unsigned long bytes, struct Progress *progress)
Read bytes bytes from server into file.
Definition: imap.c:604
int imap_authenticate(struct ImapAccountData *adata)
Authenticate to an IMAP server.
Definition: auth.c:110
bool imap_has_flag(struct ListHead *flag_list, const char *flag)
Does the flag exist in the list.
Definition: imap.c:888
char * imap_next_word(char *s)
Find where the next IMAP word begins.
Definition: util.c:785
int imap_exec(struct ImapAccountData *adata, const char *cmdstr, ImapCmdFlags flags)
Execute a command and wait for the response from the server.
Definition: command.c:1260
uint8_t ImapCmdFlags
Flags for imap_exec(), e.g. IMAP_CMD_PASS.
Definition: private.h:72
uint32_t ImapCapFlags
Capabilities we are interested in.
Definition: private.h:121
int imap_login(struct ImapAccountData *adata)
Open an IMAP connection.
Definition: imap.c:1861
void imap_cmd_finish(struct ImapAccountData *adata)
Attempt to perform cleanup.
Definition: command.c:1325
char * imap_get_qualifier(char *buf)
Get the qualifier from a tagged response.
Definition: util.c:768
Many unsorted constants and some structs.
MessageType
To set flags or match patterns.
Definition: mutt.h:75
static size_t plen
Length of cached packet.
Definition: pgppacket.c:39
QuadOption
Possible values for a quad-option.
Definition: quad.h:36
String manipulation buffer.
Definition: buffer.h:34
Login details for a remote server.
Definition: connaccount.h:53
The envelope/body of an email.
Definition: email.h:37
char * path
Path of Email (for local Mailboxes)
Definition: email.h:68
IMAP-specific Account data -.
Definition: adata.h:40
IMAP command structure.
Definition: private.h:162
int state
Command state, e.g. IMAP_RES_NEW.
Definition: private.h:164
char seq[SEQ_LEN+1]
Command tag, e.g. 'a0001'.
Definition: private.h:163
Items in an IMAP browser.
Definition: private.h:151
bool noselect
Definition: private.h:154
bool noinferiors
Definition: private.h:155
char * name
Definition: private.h:152
char delim
Definition: private.h:153
IMAP-specific Mailbox data -.
Definition: mdata.h:39
A mailbox.
Definition: mailbox.h:79
A local copy of an email.
Definition: mxapi.h:43
UID Sequence Set Iterator.
Definition: private.h:171
char * eostr
Definition: private.h:173
char * substr_end
Definition: private.h:179
unsigned int range_end
Definition: private.h:177
char * substr_cur
Definition: private.h:178
char * full_seqset
Definition: private.h:172
unsigned int range_cur
Definition: private.h:176