1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
|
#ifndef DSYNC_IBC_H
#define DSYNC_IBC_H
/* dsync inter-brain communicator */
#include "ioloop.h"
#include "guid.h"
#include "mail-error.h"
#include "dsync-brain.h"
struct dsync_mailbox;
struct dsync_mailbox_state;
struct dsync_mailbox_node;
struct dsync_mailbox_delete;
struct dsync_mailbox_attribute;
struct dsync_mail;
struct dsync_mail_change;
struct dsync_mail_request;
enum dsync_ibc_send_ret {
DSYNC_IBC_SEND_RET_OK = 1,
/* send queue is full, stop sending more */
DSYNC_IBC_SEND_RET_FULL = 0
};
enum dsync_ibc_recv_ret {
DSYNC_IBC_RECV_RET_FINISHED = -1,
/* try again / error (the error handling delayed until io callback) */
DSYNC_IBC_RECV_RET_TRYAGAIN = 0,
DSYNC_IBC_RECV_RET_OK = 1
};
enum dsync_ibc_eol_type {
DSYNC_IBC_EOL_MAILBOX_STATE,
DSYNC_IBC_EOL_MAILBOX_TREE,
DSYNC_IBC_EOL_MAILBOX_ATTRIBUTE,
DSYNC_IBC_EOL_MAILBOX,
DSYNC_IBC_EOL_MAIL_CHANGES,
DSYNC_IBC_EOL_MAIL_REQUESTS,
DSYNC_IBC_EOL_MAILS
};
struct dsync_ibc_settings {
/* Server hostname. Used for determining which server does the
locking. */
const char *hostname;
/* if non-NULL, sync only these namespaces (LF-separated) */
const char *sync_ns_prefixes;
/* if non-NULL, sync only this mailbox name */
const char *sync_box;
/* if non-NULL, use this mailbox for finding messages with GUIDs and
copying them instead of saving them again. */
const char *virtual_all_box;
/* if non-empty, sync only this mailbox GUID */
guid_128_t sync_box_guid;
/* Exclude these mailboxes from the sync. They can contain '*'
wildcards and be \special-use flags. */
const char *const *exclude_mailboxes;
/* Sync only mails with received timestamp at least this high. */
time_t sync_since_timestamp;
/* Sync only mails with received timestamp less or equal than this */
time_t sync_until_timestamp;
/* Don't sync mails larger than this. */
uoff_t sync_max_size;
/* Sync only mails with specified flags. */
const char *sync_flags;
/* Hashed headers */
const char *const *hashed_headers;
char alt_char;
enum dsync_brain_sync_type sync_type;
enum dsync_brain_flags brain_flags;
bool hdr_hash_v2;
bool hdr_hash_v3;
unsigned int lock_timeout;
unsigned int import_commit_msgs_interval;
};
void dsync_ibc_init_pipe(struct dsync_ibc **ibc1_r,
struct dsync_ibc **ibc2_r);
struct dsync_ibc *
dsync_ibc_init_stream(struct istream *input, struct ostream *output,
const char *name, const char *temp_path_prefix,
unsigned int timeout_secs);
void dsync_ibc_deinit(struct dsync_ibc **ibc);
/* I/O callback is called whenever new data is available. It's also called on
errors, so check first the error status. */
void dsync_ibc_set_io_callback(struct dsync_ibc *ibc,
io_callback_t *callback, void *context);
void dsync_ibc_send_handshake(struct dsync_ibc *ibc,
const struct dsync_ibc_settings *set);
enum dsync_ibc_recv_ret
dsync_ibc_recv_handshake(struct dsync_ibc *ibc,
const struct dsync_ibc_settings **set_r);
enum dsync_ibc_send_ret ATTR_NOWARN_UNUSED_RESULT
dsync_ibc_send_end_of_list(struct dsync_ibc *ibc, enum dsync_ibc_eol_type type);
enum dsync_ibc_send_ret ATTR_NOWARN_UNUSED_RESULT
dsync_ibc_send_mailbox_state(struct dsync_ibc *ibc,
const struct dsync_mailbox_state *state);
enum dsync_ibc_recv_ret
dsync_ibc_recv_mailbox_state(struct dsync_ibc *ibc,
struct dsync_mailbox_state *state_r);
enum dsync_ibc_send_ret ATTR_NOWARN_UNUSED_RESULT
dsync_ibc_send_mailbox_tree_node(struct dsync_ibc *ibc,
const char *const *name,
const struct dsync_mailbox_node *node);
enum dsync_ibc_recv_ret
dsync_ibc_recv_mailbox_tree_node(struct dsync_ibc *ibc,
const char *const **name_r,
const struct dsync_mailbox_node **node_r);
enum dsync_ibc_send_ret ATTR_NOWARN_UNUSED_RESULT
dsync_ibc_send_mailbox_deletes(struct dsync_ibc *ibc,
const struct dsync_mailbox_delete *deletes,
unsigned int count, char hierarchy_sep,
char escape_char);
enum dsync_ibc_recv_ret
dsync_ibc_recv_mailbox_deletes(struct dsync_ibc *ibc,
const struct dsync_mailbox_delete **deletes_r,
unsigned int *count_r, char *hierarchy_sep_r,
char *escape_char_r);
enum dsync_ibc_send_ret ATTR_NOWARN_UNUSED_RESULT
dsync_ibc_send_mailbox(struct dsync_ibc *ibc,
const struct dsync_mailbox *dsync_box);
enum dsync_ibc_recv_ret
dsync_ibc_recv_mailbox(struct dsync_ibc *ibc,
const struct dsync_mailbox **dsync_box_r);
enum dsync_ibc_send_ret ATTR_NOWARN_UNUSED_RESULT
dsync_ibc_send_mailbox_attribute(struct dsync_ibc *ibc,
const struct dsync_mailbox_attribute *attr);
enum dsync_ibc_recv_ret
dsync_ibc_recv_mailbox_attribute(struct dsync_ibc *ibc,
const struct dsync_mailbox_attribute **attr_r);
enum dsync_ibc_send_ret ATTR_NOWARN_UNUSED_RESULT
dsync_ibc_send_change(struct dsync_ibc *ibc,
const struct dsync_mail_change *change);
enum dsync_ibc_recv_ret
dsync_ibc_recv_change(struct dsync_ibc *ibc,
const struct dsync_mail_change **change_r);
enum dsync_ibc_send_ret ATTR_NOWARN_UNUSED_RESULT
dsync_ibc_send_mail_request(struct dsync_ibc *ibc,
const struct dsync_mail_request *request);
enum dsync_ibc_recv_ret
dsync_ibc_recv_mail_request(struct dsync_ibc *ibc,
const struct dsync_mail_request **request_r);
enum dsync_ibc_send_ret ATTR_NOWARN_UNUSED_RESULT
dsync_ibc_send_mail(struct dsync_ibc *ibc, const struct dsync_mail *mail);
enum dsync_ibc_recv_ret
dsync_ibc_recv_mail(struct dsync_ibc *ibc, struct dsync_mail **mail_r);
void dsync_ibc_send_finish(struct dsync_ibc *ibc, const char *error,
enum mail_error mail_error,
bool require_full_resync);
enum dsync_ibc_recv_ret
dsync_ibc_recv_finish(struct dsync_ibc *ibc, const char **error_r,
enum mail_error *mail_error_r,
bool *require_full_resync_r);
/* Close any mail input streams that are kept open. This needs to be called
before the mail is attempted to be freed (usually on error conditions). */
void dsync_ibc_close_mail_streams(struct dsync_ibc *ibc);
bool dsync_ibc_has_failed(struct dsync_ibc *ibc);
bool dsync_ibc_has_timed_out(struct dsync_ibc *ibc);
bool dsync_ibc_is_send_queue_full(struct dsync_ibc *ibc);
bool dsync_ibc_has_pending_data(struct dsync_ibc *ibc);
#endif
|
