NeoMutt  2022-04-29-247-gc6aae8
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
144#define IMAP_CAP_ALL ((1 << 20) - 1)
145
150{
151 char *name;
152 char delim;
155};
156
161{
162 char seq[SEQ_LEN + 1];
163 int state;
164};
165
170{
172 char *eostr;
174 int down;
175 unsigned int range_cur;
176 unsigned int range_end;
179};
180
181/* -- private IMAP functions -- */
182/* imap.c */
183int imap_create_mailbox(struct ImapAccountData *adata, const char *mailbox);
184int imap_rename_mailbox(struct ImapAccountData *adata, char *oldname, const char *newname);
185int imap_exec_msgset(struct Mailbox *m, const char *pre, const char *post,
186 enum MessageType flag, bool changed, bool invert);
187int imap_open_connection(struct ImapAccountData *adata);
188void imap_close_connection(struct ImapAccountData *adata);
189int imap_read_literal(FILE *fp, struct ImapAccountData *adata, unsigned long bytes, struct Progress *progress);
190void imap_expunge_mailbox(struct Mailbox *m, bool resort);
191int imap_login(struct ImapAccountData *adata);
192int imap_sync_message_for_copy(struct Mailbox *m, struct Email *e, struct Buffer *cmd, enum QuadOption *err_continue);
193bool imap_has_flag(struct ListHead *flag_list, const char *flag);
194int imap_adata_find(const char *path, struct ImapAccountData **adata, struct ImapMboxData **mdata);
195
196/* auth.c */
197int imap_authenticate(struct ImapAccountData *adata);
198
199/* command.c */
200int imap_cmd_start(struct ImapAccountData *adata, const char *cmdstr);
201int imap_cmd_step(struct ImapAccountData *adata);
202void imap_cmd_finish(struct ImapAccountData *adata);
203bool imap_code(const char *s);
204const char *imap_cmd_trailer(struct ImapAccountData *adata);
205int imap_exec(struct ImapAccountData *adata, const char *cmdstr, ImapCmdFlags flags);
206int imap_cmd_idle(struct ImapAccountData *adata);
207
208/* message.c */
209int imap_read_headers(struct Mailbox *m, unsigned int msn_begin, unsigned int msn_end, bool initial_download);
210char *imap_set_flags(struct Mailbox *m, struct Email *e, char *s, bool *server_changes);
211int imap_cache_del(struct Mailbox *m, struct Email *e);
212int imap_cache_clean(struct Mailbox *m);
213int imap_append_message(struct Mailbox *m, struct Message *msg);
214
215bool imap_msg_open(struct Mailbox *m, struct Message *msg, int msgno);
216int imap_msg_close(struct Mailbox *m, struct Message *msg);
217int imap_msg_commit(struct Mailbox *m, struct Message *msg);
218int imap_msg_save_hcache(struct Mailbox *m, struct Email *e);
219
220/* util.c */
221#ifdef USE_HCACHE
222void imap_hcache_open(struct ImapAccountData *adata, struct ImapMboxData *mdata);
223void imap_hcache_close(struct ImapMboxData *mdata);
224struct Email *imap_hcache_get(struct ImapMboxData *mdata, unsigned int uid);
225int imap_hcache_put(struct ImapMboxData *mdata, struct Email *e);
226int imap_hcache_del(struct ImapMboxData *mdata, unsigned int uid);
229char *imap_hcache_get_uid_seqset(struct ImapMboxData *mdata);
230#endif
231
232enum QuadOption imap_continue(const char *msg, const char *resp);
233void imap_error(const char *where, const char *msg);
234void imap_mdata_cache_reset(struct ImapMboxData *mdata);
235char *imap_fix_path(char delim, const char *mailbox, char *path, size_t plen);
236void imap_cachepath(char delim, const char *mailbox, struct Buffer *dest);
237int imap_get_literal_count(const char *buf, unsigned int *bytes);
238char *imap_get_qualifier(char *buf);
239char *imap_next_word(char *s);
240void imap_qualify_path(char *buf, size_t buflen, struct ConnAccount *conn_account, char *path);
241void imap_quote_string(char *dest, size_t dlen, const char *src, bool quote_backtick);
242void imap_unquote_string(char *s);
243void imap_munge_mbox_name(bool unicode, char *dest, size_t dlen, const char *src);
244void imap_unmunge_mbox_name(bool unicode, char *s);
245struct SeqsetIterator *mutt_seqset_iterator_new(const char *seqset);
246int mutt_seqset_iterator_next(struct SeqsetIterator *iter, unsigned int *next);
248bool imap_account_match(const struct ConnAccount *a1, const struct ConnAccount *a2);
249void imap_get_parent(const char *mbox, char delim, char *buf, size_t buflen);
250bool mutt_account_match(const struct ConnAccount *a1, const struct ConnAccount *a2);
251
252/* utf7.c */
253void imap_utf_encode(bool unicode, char **s);
254void imap_utf_decode(bool unicode, char **s);
255void imap_allow_reopen(struct Mailbox *m);
256void imap_disallow_reopen(struct Mailbox *m);
257
258/* search.c */
259void cmd_parse_search(struct ImapAccountData *adata, const char *s);
260
261#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:2181
int imap_msg_commit(struct Mailbox *m, struct Message *msg)
Save changes to an email - Implements MxOps::msg_commit() -.
Definition: message.c:2167
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:1965
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:2189
int imap_cmd_start(struct ImapAccountData *adata, const char *cmdstr)
Given an IMAP command, send it to the server.
Definition: command.c:1062
void imap_unmunge_mbox_name(bool unicode, char *s)
Remove quoting from a mailbox name.
Definition: util.c:928
int imap_cache_clean(struct Mailbox *m)
Delete all the entries in the message cache.
Definition: message.c:1876
void imap_close_connection(struct ImapAccountData *adata)
Close an IMAP connection.
Definition: imap.c:853
void imap_qualify_path(char *buf, size_t buflen, struct ConnAccount *conn_account, char *path)
Make an absolute IMAP folder target.
Definition: util.c:820
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:1908
void imap_allow_reopen(struct Mailbox *m)
Allow re-opening a folder upon expunge.
Definition: util.c:1016
void imap_disallow_reopen(struct Mailbox *m)
Disallow re-opening a folder upon expunge.
Definition: util.c:1029
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:745
int imap_hcache_store_uid_seqset(struct ImapMboxData *mdata)
Store a UID Sequence Set in the header cache.
Definition: util.c:415
int imap_hcache_put(struct ImapMboxData *mdata, struct Email *e)
Add an entry to the header cache.
Definition: util.c:380
void imap_mdata_cache_reset(struct ImapMboxData *mdata)
Release and clear cache data of ImapMboxData structure.
Definition: util.c:106
void imap_get_parent(const char *mbox, char delim, char *buf, size_t buflen)
Get an IMAP folder's parent.
Definition: util.c:120
struct SeqsetIterator * mutt_seqset_iterator_new(const char *seqset)
Create a new Sequence Set Iterator.
Definition: util.c:1076
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:930
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:390
void imap_quote_string(char *dest, size_t dlen, const char *src, bool quote_backtick)
Quote string according to IMAP rules.
Definition: util.c:837
char * imap_hcache_get_uid_seqset(struct ImapMboxData *mdata)
Get a UID Sequence Set from the header cache.
Definition: util.c:451
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:652
void imap_unquote_string(char *s)
Equally stupid unquoting routine.
Definition: util.c:874
struct Email * imap_hcache_get(struct ImapMboxData *mdata, unsigned int uid)
Get a header cache entry by its UID.
Definition: util.c:355
const char * imap_cmd_trailer(struct ImapAccountData *adata)
Extra information after tagged command response if any.
Definition: command.c:1210
int imap_append_message(struct Mailbox *m, struct Message *msg)
Write an email back to the server.
Definition: message.c:1551
int mutt_seqset_iterator_next(struct SeqsetIterator *iter, unsigned int *next)
Get the next UID from a Sequence Set.
Definition: util.c:1097
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:1154
int imap_cmd_idle(struct ImapAccountData *adata)
Enter the IDLE state.
Definition: command.c:1379
int imap_cmd_step(struct ImapAccountData *adata)
Reads server responses from an IMAP command.
Definition: command.c:1076
char * imap_fix_path(char delim, const char *mailbox, char *path, size_t plen)
Fix up the imap path.
Definition: util.c:685
void imap_expunge_mailbox(struct Mailbox *m, bool resort)
Purge messages from the server.
Definition: imap.c:675
int imap_open_connection(struct ImapAccountData *adata)
Open an IMAP connection.
Definition: imap.c:747
#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:716
int imap_rename_mailbox(struct ImapAccountData *adata, char *oldname, const char *newname)
Rename a mailbox.
Definition: imap.c:488
int imap_create_mailbox(struct ImapAccountData *adata, const char *mailbox)
Create a new mailbox.
Definition: imap.c:447
void imap_utf_decode(bool unicode, char **s)
Decode email from UTF-8 to local charset.
Definition: utf7.c:420
void imap_error(const char *where, const char *msg)
Show an error and abort.
Definition: util.c:663
void imap_hcache_close(struct ImapMboxData *mdata)
Close the header cache.
Definition: util.c:339
int imap_cache_del(struct Mailbox *m, struct Email *e)
Delete an email from the body cache.
Definition: message.c:1857
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:398
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:1327
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:1007
bool imap_code(const char *s)
Was the command successful.
Definition: command.c:1199
int imap_hcache_clear_uid_seqset(struct ImapMboxData *mdata)
Delete a UID Sequence Set from the header cache.
Definition: util.c:437
int imap_adata_find(const char *path, struct ImapAccountData **adata, struct ImapMboxData **mdata)
Find the Account data for this path.
Definition: util.c:72
bool imap_account_match(const struct ConnAccount *a1, const struct ConnAccount *a2)
Compare two Accounts.
Definition: util.c:1044
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:911
void imap_hcache_open(struct ImapAccountData *adata, struct ImapMboxData *mdata)
Open a header cache.
Definition: util.c:297
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:598
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:878
char * imap_next_word(char *s)
Find where the next IMAP word begins.
Definition: util.c:789
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:1247
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:1848
void imap_cmd_finish(struct ImapAccountData *adata)
Attempt to perform cleanup.
Definition: command.c:1312
char * imap_get_qualifier(char *buf)
Get the qualifier from a tagged response.
Definition: util.c:772
Many unsorted constants and some structs.
MessageType
To set flags or match patterns.
Definition: mutt.h:87
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:161
int state
Command state, e.g. IMAP_RES_NEW.
Definition: private.h:163
char seq[SEQ_LEN+1]
Command tag, e.g. 'a0001'.
Definition: private.h:162
Items in an IMAP browser.
Definition: private.h:150
bool noselect
Definition: private.h:153
bool noinferiors
Definition: private.h:154
char * name
Definition: private.h:151
char delim
Definition: private.h:152
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:170
char * eostr
Definition: private.h:172
char * substr_end
Definition: private.h:178
unsigned int range_end
Definition: private.h:176
char * substr_cur
Definition: private.h:177
char * full_seqset
Definition: private.h:171
unsigned int range_cur
Definition: private.h:175