diff --git a/docs/html/mrevent_8h.html b/docs/html/mrevent_8h.html index 4a15ef3b..9f69af9a 100644 --- a/docs/html/mrevent_8h.html +++ b/docs/html/mrevent_8h.html @@ -191,10 +191,9 @@ Macros

Inform about the configuration progress started by mrmailbox_configure_and_connect().

-

As we want to get rid of the threads in the core, this event may be deleted.

Parameters
- +
data1permille
data1Permille
data20
diff --git a/docs/html/mrevent_8h_source.html b/docs/html/mrevent_8h_source.html index 88bfe171..675386eb 100644 --- a/docs/html/mrevent_8h_source.html +++ b/docs/html/mrevent_8h_source.html @@ -89,7 +89,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
mrevent.h
-Go to the documentation of this file.
1 /*******************************************************************************
2  *
3  * Delta Chat Core
4  * Contact: r10s@b44t.com, http://b44t.com
5  *
6  * This program is free software: you can redistribute it and/or modify it under
7  * the terms of the GNU General Public License as published by the Free Software
8  * Foundation, either version 3 of the License, or (at your option) any later
9  * version.
10  *
11  * This program is distributed in the hope that it will be useful, but WITHOUT
12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
13  * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
14  * details.
15  *
16  * You should have received a copy of the GNU General Public License along with
17  * this program. If not, see http://www.gnu.org/licenses/ .
18  *
19  ******************************************************************************/
20 
21 
22 #ifndef __MREVENT_H__
23 #define __MREVENT_H__
24 #ifdef __cplusplus
25 extern "C" {
26 #endif
27 
28 
49 #define MR_EVENT_INFO 100
50 
51 
63 #define MR_EVENT_WARNING 300
64 
65 
76 #define MR_EVENT_ERROR 400
77 
78 
89 #define MR_EVENT_MSGS_CHANGED 2000
90 
91 
102 #define MR_EVENT_INCOMING_MSG 2005
103 
104 
115 #define MR_EVENT_MSG_DELIVERED 2010
116 
117 
128 #define MR_EVENT_MSG_READ 2015
129 
130 
140 #define MR_EVENT_CHAT_MODIFIED 2020
141 
142 
152 #define MR_EVENT_CONTACTS_CHANGED 2030
153 
154 
165 #define MR_EVENT_CONFIGURE_PROGRESS 2041
166 
167 
178 #define MR_EVENT_IMEX_ENDED 2050
179 
180 
190 #define MR_EVENT_IMEX_PROGRESS 2051
191 
192 
207 #define MR_EVENT_IMEX_FILE_WRITTEN 2052
208 
209 
210 /*******************************************************************************
211  * The following events are functions that should be provided by the frontends
212  ******************************************************************************/
213 
214 
226 #define MR_EVENT_IS_OFFLINE 2081
227 
228 
240 #define MR_EVENT_GET_STRING 2091
241 
242 
257 #define MR_EVENT_GET_QUANTITY_STRING 2092
258 
259 
271 #define MR_EVENT_HTTP_GET 2100
272 
286 #define MR_EVENT_WAKE_LOCK 2110
287 
288 
289 #ifdef __cplusplus
290 } /* /extern "C" */
291 #endif
292 #endif /* __MREVENT_H__ */
293 
+Go to the documentation of this file.
1 /*******************************************************************************
2  *
3  * Delta Chat Core
4  * Contact: r10s@b44t.com, http://b44t.com
5  *
6  * This program is free software: you can redistribute it and/or modify it under
7  * the terms of the GNU General Public License as published by the Free Software
8  * Foundation, either version 3 of the License, or (at your option) any later
9  * version.
10  *
11  * This program is distributed in the hope that it will be useful, but WITHOUT
12  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
13  * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
14  * details.
15  *
16  * You should have received a copy of the GNU General Public License along with
17  * this program. If not, see http://www.gnu.org/licenses/ .
18  *
19  ******************************************************************************/
20 
21 
22 #ifndef __MREVENT_H__
23 #define __MREVENT_H__
24 #ifdef __cplusplus
25 extern "C" {
26 #endif
27 
28 
49 #define MR_EVENT_INFO 100
50 
51 
63 #define MR_EVENT_WARNING 300
64 
65 
76 #define MR_EVENT_ERROR 400
77 
78 
89 #define MR_EVENT_MSGS_CHANGED 2000
90 
91 
102 #define MR_EVENT_INCOMING_MSG 2005
103 
104 
115 #define MR_EVENT_MSG_DELIVERED 2010
116 
117 
128 #define MR_EVENT_MSG_READ 2015
129 
130 
140 #define MR_EVENT_CHAT_MODIFIED 2020
141 
142 
152 #define MR_EVENT_CONTACTS_CHANGED 2030
153 
154 
164 #define MR_EVENT_CONFIGURE_PROGRESS 2041
165 
166 
177 #define MR_EVENT_IMEX_ENDED 2050
178 
179 
189 #define MR_EVENT_IMEX_PROGRESS 2051
190 
191 
206 #define MR_EVENT_IMEX_FILE_WRITTEN 2052
207 
208 
209 /*******************************************************************************
210  * The following events are functions that should be provided by the frontends
211  ******************************************************************************/
212 
213 
225 #define MR_EVENT_IS_OFFLINE 2081
226 
227 
239 #define MR_EVENT_GET_STRING 2091
240 
241 
256 #define MR_EVENT_GET_QUANTITY_STRING 2092
257 
258 
270 #define MR_EVENT_HTTP_GET 2100
271 
285 #define MR_EVENT_WAKE_LOCK 2110
286 
287 
288 #ifdef __cplusplus
289 } /* /extern "C" */
290 #endif
291 #endif /* __MREVENT_H__ */
292 
Generated by   diff --git a/docs/html/mrimap_8h_source.html b/docs/html/mrimap_8h_source.html index 27651e9f..ab21bbb3 100644 --- a/docs/html/mrimap_8h_source.html +++ b/docs/html/mrimap_8h_source.html @@ -89,7 +89,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
mrimap.h
-
1 /*******************************************************************************
2  *
3  * Delta Chat Core
4  * Copyright (C) 2017 Björn Petersen
5  * Contact: r10s@b44t.com, http://b44t.com
6  *
7  * This program is free software: you can redistribute it and/or modify it under
8  * the terms of the GNU General Public License as published by the Free Software
9  * Foundation, either version 3 of the License, or (at your option) any later
10  * version.
11  *
12  * This program is distributed in the hope that it will be useful, but WITHOUT
13  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
14  * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
15  * details.
16  *
17  * You should have received a copy of the GNU General Public License along with
18  * this program. If not, see http://www.gnu.org/licenses/ .
19  *
20  ******************************************************************************/
21 
22 
23 /* Purpose: Reading from IMAP servers with no dependencies to the database.
24 mrmailbox_t is only used for logging and to get information about
25 the online state. */
26 
27 
28 #ifndef __MRIMAP_H__
29 #define __MRIMAP_H__
30 #ifdef __cplusplus
31 extern "C" {
32 #endif
33 
34 
35 typedef struct mrloginparam_t mrloginparam_t;
36 typedef struct mrimap_t mrimap_t;
37 
38 #define MR_IMAP_SEEN 0x0001L
39 
40 typedef int32_t (*mr_get_config_int_t)(mrimap_t*, const char*, int32_t);
41 typedef void (*mr_set_config_int_t)(mrimap_t*, const char*, int32_t);
42 typedef void (*mr_receive_imf_t) (mrimap_t*, const char* imf_raw_not_terminated, size_t imf_raw_bytes, const char* server_folder, uint32_t server_uid, uint32_t flags);
43 
44 
48 typedef struct mrimap_t
49 {
52  char* m_imap_server;
53  int m_imap_port;
54  char* m_imap_user;
55  char* m_imap_pw;
56  int m_server_flags;
57 
58  int m_connected; /* initally connected and watch thread installed */
59  mailimap* m_hEtpan; /* normally, if connected, m_hEtpan is also set; however, if a reconnection is required, we may lost this handle */
60  pthread_mutex_t m_hEtpanmutex;
61  int m_idle_set_up;
62  char* m_selected_folder;
63  int m_should_reconnect;
64 
65  int m_can_idle;
66  int m_has_xlist;
67  char* m_moveto_folder;/* Folder, where reveived chat messages should go to. Normally "Chats" but may be NULL to leave them in the INBOX */
68  char* m_sent_folder; /* Folder, where send messages should go to. Normally "Chats". */
69  pthread_mutex_t m_idlemutex; /* set, if idle is not possible; morover, the interrupted IDLE thread waits a second before IDLEing again; this allows several jobs to be executed */
70  pthread_mutex_t m_inwait_mutex; /* only used to wait for mailstream_wait_idle()/mailimap_idle_done() to terminate. */
71 
72  pthread_t m_watch_thread;
73  pthread_cond_t m_watch_cond;
74  pthread_mutex_t m_watch_condmutex;
75  int m_watch_condflag;
76  int m_watch_do_exit;
77 
78  time_t m_enter_watch_wait_time;
79 
80  pthread_t m_heartbeat_thread;
81  pthread_cond_t m_heartbeat_cond;
82  pthread_mutex_t m_heartbeat_condmutex;
83 
84  pthread_t m_restore_thread;
85  int m_restore_thread_created;
86  int m_restore_do_exit;
87 
88  struct mailimap_fetch_type* m_fetch_type_uid;
89  struct mailimap_fetch_type* m_fetch_type_body;
90  struct mailimap_fetch_type* m_fetch_type_flags;
91 
92  mr_get_config_int_t m_get_config_int;
93  mr_set_config_int_t m_set_config_int;
94  mr_receive_imf_t m_receive_imf;
95  void* m_userData;
96  mrmailbox_t* m_mailbox;
97 
98  int m_log_connect_errors;
99 } mrimap_t;
100 
101 
102 mrimap_t* mrimap_new (mr_get_config_int_t, mr_set_config_int_t, mr_receive_imf_t, void* userData, mrmailbox_t*);
103 void mrimap_unref (mrimap_t*);
104 
105 int mrimap_connect (mrimap_t*, const mrloginparam_t*);
106 void mrimap_disconnect (mrimap_t*);
107 int mrimap_is_connected (mrimap_t*);
108 int mrimap_fetch (mrimap_t*);
109 int mrimap_restore (mrimap_t*, time_t seconds_to_restore);
110 
111 int mrimap_append_msg (mrimap_t*, time_t timestamp, const char* data_not_terminated, size_t data_bytes, char** ret_server_folder, uint32_t* ret_server_uid);
112 
113 #define MR_MS_ALSO_MOVE 0x01
114 #define MR_MS_SET_MDNSent_FLAG 0x02
115 #define MR_MS_MDNSent_JUST_SET 0x10
116 int mrimap_markseen_msg (mrimap_t*, const char* folder, uint32_t server_uid, int ms_flags, char** ret_server_folder, uint32_t* ret_server_uid, int* ret_ms_flags); /* only returns 0 on connection problems; we should try later again in this case */
117 
118 int mrimap_delete_msg (mrimap_t*, const char* rfc724_mid, const char* folder, uint32_t server_uid); /* only returns 0 on connection problems; we should try later again in this case */
119 
120 void mrimap_heartbeat (mrimap_t*);
121 
122 #ifdef __cplusplus
123 } /* /extern "C" */
124 #endif
125 #endif /* __MRIMAP_H__ */
126 
mrmailbox_t
An object representing a single mailbox.
Definition: mrmailbox.h:178
+
1 /*******************************************************************************
2  *
3  * Delta Chat Core
4  * Copyright (C) 2017 Björn Petersen
5  * Contact: r10s@b44t.com, http://b44t.com
6  *
7  * This program is free software: you can redistribute it and/or modify it under
8  * the terms of the GNU General Public License as published by the Free Software
9  * Foundation, either version 3 of the License, or (at your option) any later
10  * version.
11  *
12  * This program is distributed in the hope that it will be useful, but WITHOUT
13  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
14  * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
15  * details.
16  *
17  * You should have received a copy of the GNU General Public License along with
18  * this program. If not, see http://www.gnu.org/licenses/ .
19  *
20  ******************************************************************************/
21 
22 
23 /* Purpose: Reading from IMAP servers with no dependencies to the database.
24 mrmailbox_t is only used for logging and to get information about
25 the online state. */
26 
27 
28 #ifndef __MRIMAP_H__
29 #define __MRIMAP_H__
30 #ifdef __cplusplus
31 extern "C" {
32 #endif
33 
34 
35 typedef struct mrloginparam_t mrloginparam_t;
36 typedef struct mrimap_t mrimap_t;
37 
38 #define MR_IMAP_SEEN 0x0001L
39 
40 typedef int32_t (*mr_get_config_int_t)(mrimap_t*, const char*, int32_t);
41 typedef void (*mr_set_config_int_t)(mrimap_t*, const char*, int32_t);
42 typedef void (*mr_receive_imf_t) (mrimap_t*, const char* imf_raw_not_terminated, size_t imf_raw_bytes, const char* server_folder, uint32_t server_uid, uint32_t flags);
43 
44 
48 typedef struct mrimap_t
49 {
52  char* m_imap_server;
53  int m_imap_port;
54  char* m_imap_user;
55  char* m_imap_pw;
56  int m_server_flags;
57 
58  int m_connected; /* initally connected and watch thread installed */
59  mailimap* m_hEtpan; /* normally, if connected, m_hEtpan is also set; however, if a reconnection is required, we may lost this handle */
60  pthread_mutex_t m_hEtpanmutex;
61  int m_idle_set_up;
62  char* m_selected_folder;
63  int m_should_reconnect;
64 
65  int m_can_idle;
66  int m_has_xlist;
67  char* m_moveto_folder;/* Folder, where reveived chat messages should go to. Normally "Chats" but may be NULL to leave them in the INBOX */
68  char* m_sent_folder; /* Folder, where send messages should go to. Normally "Chats". */
69  pthread_mutex_t m_idlemutex; /* set, if idle is not possible; morover, the interrupted IDLE thread waits a second before IDLEing again; this allows several jobs to be executed */
70  pthread_mutex_t m_inwait_mutex; /* only used to wait for mailstream_wait_idle()/mailimap_idle_done() to terminate. */
71 
72  pthread_t m_watch_thread;
73  pthread_cond_t m_watch_cond;
74  pthread_mutex_t m_watch_condmutex;
75  int m_watch_condflag;
76  int m_watch_do_exit;
77 
78  time_t m_enter_watch_wait_time;
79 
80  pthread_t m_heartbeat_thread;
81  pthread_cond_t m_heartbeat_cond;
82  pthread_mutex_t m_heartbeat_condmutex;
83 
84  struct mailimap_fetch_type* m_fetch_type_uid;
85  struct mailimap_fetch_type* m_fetch_type_body;
86  struct mailimap_fetch_type* m_fetch_type_flags;
87 
88  mr_get_config_int_t m_get_config_int;
89  mr_set_config_int_t m_set_config_int;
90  mr_receive_imf_t m_receive_imf;
91  void* m_userData;
92  mrmailbox_t* m_mailbox;
93 
94  int m_log_connect_errors;
95 } mrimap_t;
96 
97 
98 mrimap_t* mrimap_new (mr_get_config_int_t, mr_set_config_int_t, mr_receive_imf_t, void* userData, mrmailbox_t*);
99 void mrimap_unref (mrimap_t*);
100 
101 int mrimap_connect (mrimap_t*, const mrloginparam_t*);
102 void mrimap_disconnect (mrimap_t*);
103 int mrimap_is_connected (mrimap_t*);
104 int mrimap_fetch (mrimap_t*);
105 
106 int mrimap_append_msg (mrimap_t*, time_t timestamp, const char* data_not_terminated, size_t data_bytes, char** ret_server_folder, uint32_t* ret_server_uid);
107 
108 #define MR_MS_ALSO_MOVE 0x01
109 #define MR_MS_SET_MDNSent_FLAG 0x02
110 #define MR_MS_MDNSent_JUST_SET 0x10
111 int mrimap_markseen_msg (mrimap_t*, const char* folder, uint32_t server_uid, int ms_flags, char** ret_server_folder, uint32_t* ret_server_uid, int* ret_ms_flags); /* only returns 0 on connection problems; we should try later again in this case */
112 
113 int mrimap_delete_msg (mrimap_t*, const char* rfc724_mid, const char* folder, uint32_t server_uid); /* only returns 0 on connection problems; we should try later again in this case */
114 
115 void mrimap_heartbeat (mrimap_t*);
116 
117 #ifdef __cplusplus
118 } /* /extern "C" */
119 #endif
120 #endif /* __MRIMAP_H__ */
121 
mrmailbox_t
An object representing a single mailbox.
Definition: mrmailbox.h:178
diff --git a/docs/html/mrmailbox_8h_source.html b/docs/html/mrmailbox_8h_source.html index f0e7fb7b..498dda71 100644 --- a/docs/html/mrmailbox_8h_source.html +++ b/docs/html/mrmailbox_8h_source.html @@ -89,76 +89,76 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
mrmailbox.h
-
1 /*******************************************************************************
2  *
3  * Delta Chat Core
4  * Copyright (C) 2017 Björn Petersen
5  * Contact: r10s@b44t.com, http://b44t.com
6  *
7  * This program is free software: you can redistribute it and/or modify it under
8  * the terms of the GNU General Public License as published by the Free Software
9  * Foundation, either version 3 of the License, or (at your option) any later
10  * version.
11  *
12  * This program is distributed in the hope that it will be useful, but WITHOUT
13  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
14  * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
15  * details.
16  *
17  * You should have received a copy of the GNU General Public License along with
18  * this program. If not, see http://www.gnu.org/licenses/ .
19  *
20  ******************************************************************************/
21 
22 
23 #ifndef __MRMAILBOX_H__
24 #define __MRMAILBOX_H__
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28 
29 
30 #define MR_VERSION_MAJOR 0
31 #define MR_VERSION_MINOR 9
32 #define MR_VERSION_REVISION 8
33 
34 
136 #include <libetpan/libetpan.h> /* defines uint16_t and carray */
137 #include "mrchatlist.h"
138 #include "mrchat.h"
139 #include "mrmsg.h"
140 #include "mrcontact.h"
141 #include "mrpoortext.h"
142 #include "mrparam.h"
143 #include "mrevent.h"
144 
145 typedef struct mrmailbox_t mrmailbox_t;
146 typedef struct mrimap_t mrimap_t;
147 typedef struct mrsmtp_t mrsmtp_t;
148 typedef struct mrsqlite3_t mrsqlite3_t;
149 typedef struct mrjob_t mrjob_t;
150 typedef struct mrmimeparser_t mrmimeparser_t;
151 
152 
168 typedef uintptr_t (*mrmailboxcb_t) (mrmailbox_t*, int event, uintptr_t data1, uintptr_t data2);
169 
170 
178 typedef struct mrmailbox_t
179 {
180  void* m_userdata;
181  char* m_dbfile;
182  char* m_blobdir;
185  mrsqlite3_t* m_sql;
186  mrimap_t* m_imap;
187  mrsmtp_t* m_smtp;
189  pthread_t m_job_thread;
190  pthread_cond_t m_job_cond;
191  pthread_mutex_t m_job_condmutex;
192  int m_job_condflag;
193  int m_job_do_exit;
195  mrmailboxcb_t m_cb;
197  char* m_os_name;
199  uint32_t m_cmdline_sel_chat_id;
201  int m_wake_lock;
202  pthread_mutex_t m_wake_lock_critical;
204  int m_e2ee_enabled;
206  #define MR_LOG_RINGBUF_SIZE 200
207  pthread_mutex_t m_log_ringbuf_critical;
208  char* m_log_ringbuf[MR_LOG_RINGBUF_SIZE];
210  time_t m_log_ringbuf_times[MR_LOG_RINGBUF_SIZE];
212  int m_log_ringbuf_pos;
214 } mrmailbox_t;
215 
216 
217 /* create/open/connect */
218 mrmailbox_t* mrmailbox_new (mrmailboxcb_t, void* userdata, const char* os_name);
219 void mrmailbox_unref (mrmailbox_t*);
220 
221 int mrmailbox_open (mrmailbox_t*, const char* dbfile, const char* blobdir);
222 void mrmailbox_close (mrmailbox_t*);
223 int mrmailbox_is_open (const mrmailbox_t*);
224 
225 int mrmailbox_set_config (mrmailbox_t*, const char* key, const char* value);
226 char* mrmailbox_get_config (mrmailbox_t*, const char* key, const char* def);
227 int mrmailbox_set_config_int (mrmailbox_t*, const char* key, int32_t value);
228 int32_t mrmailbox_get_config_int (mrmailbox_t*, const char* key, int32_t def);
229 char* mrmailbox_get_version_str (void);
230 
231 int mrmailbox_configure_and_connect(mrmailbox_t*);
232 void mrmailbox_configure_cancel (mrmailbox_t*);
233 int mrmailbox_is_configured (mrmailbox_t*);
234 
235 void mrmailbox_connect (mrmailbox_t*);
236 void mrmailbox_disconnect (mrmailbox_t*);
237 
238 int mrmailbox_restore (mrmailbox_t*, time_t seconds_to_restore); /* not really implemented */
239 char* mrmailbox_get_info (mrmailbox_t*);
240 
241 
242 /* Handle chatlists */
243 #define MR_GCL_ARCHIVED_ONLY 0x01
244 #define MR_GCL_NO_SPECIALS 0x02
245 mrchatlist_t* mrmailbox_get_chatlist (mrmailbox_t*, int flags, const char* query);
246 
247 
248 /* Handle chats */
249 uint32_t mrmailbox_create_chat_by_contact_id (mrmailbox_t*, uint32_t contact_id);
250 uint32_t mrmailbox_get_chat_id_by_contact_id (mrmailbox_t*, uint32_t contact_id);
251 
252 uint32_t mrmailbox_send_text_msg (mrmailbox_t*, uint32_t chat_id, const char* text_to_send);
253 uint32_t mrmailbox_send_msg (mrmailbox_t*, uint32_t chat_id, mrmsg_t*);
254 void mrmailbox_set_draft (mrmailbox_t*, uint32_t chat_id, const char*);
255 
256 #define MR_GCM_ADDDAYMARKER 0x01
257 carray* mrmailbox_get_chat_msgs (mrmailbox_t*, uint32_t chat_id, uint32_t flags, uint32_t marker1before);
258 int mrmailbox_get_total_msg_count (mrmailbox_t*, uint32_t chat_id);
259 int mrmailbox_get_fresh_msg_count (mrmailbox_t*, uint32_t chat_id);
260 carray* mrmailbox_get_fresh_msgs (mrmailbox_t*);
261 void mrmailbox_marknoticed_chat (mrmailbox_t*, uint32_t chat_id);
262 carray* mrmailbox_get_chat_media (mrmailbox_t*, uint32_t chat_id, int msg_type, int or_msg_type);
263 uint32_t mrmailbox_get_next_media (mrmailbox_t*, uint32_t curr_msg_id, int dir);
264 
265 void mrmailbox_archive_chat (mrmailbox_t*, uint32_t chat_id, int archive);
266 void mrmailbox_delete_chat (mrmailbox_t*, uint32_t chat_id);
267 
268 carray* mrmailbox_get_chat_contacts (mrmailbox_t*, uint32_t chat_id);
269 carray* mrmailbox_search_msgs (mrmailbox_t*, uint32_t chat_id, const char* query);
270 
271 mrchat_t* mrmailbox_get_chat (mrmailbox_t*, uint32_t chat_id);
272 
273 
274 /* Handle group chats */
275 uint32_t mrmailbox_create_group_chat (mrmailbox_t*, const char* name);
276 int mrmailbox_is_contact_in_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
277 int mrmailbox_add_contact_to_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
278 int mrmailbox_remove_contact_from_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
279 int mrmailbox_set_chat_name (mrmailbox_t*, uint32_t chat_id, const char* name);
280 int mrmailbox_set_chat_image (mrmailbox_t*, uint32_t chat_id, const char* image);
281 
282 
283 /* Handle messages */
284 char* mrmailbox_get_msg_info (mrmailbox_t*, uint32_t msg_id);
285 void mrmailbox_delete_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt);
286 void mrmailbox_forward_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt, uint32_t chat_id);
287 void mrmailbox_marknoticed_contact (mrmailbox_t*, uint32_t contact_id);
288 void mrmailbox_markseen_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt);
289 void mrmailbox_star_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt, int star);
290 mrmsg_t* mrmailbox_get_msg (mrmailbox_t*, uint32_t msg_id);
291 
292 
293 /* Handle contacts */
294 uint32_t mrmailbox_create_contact (mrmailbox_t*, const char* name, const char* addr);
295 int mrmailbox_add_address_book (mrmailbox_t*, const char*);
296 carray* mrmailbox_get_known_contacts (mrmailbox_t*, const char* query);
297 int mrmailbox_get_blocked_count (mrmailbox_t*);
298 carray* mrmailbox_get_blocked_contacts (mrmailbox_t*);
299 void mrmailbox_block_contact (mrmailbox_t*, uint32_t contact_id, int block);
300 char* mrmailbox_get_contact_encrinfo (mrmailbox_t*, uint32_t contact_id);
301 int mrmailbox_delete_contact (mrmailbox_t*, uint32_t contact_id);
302 mrcontact_t* mrmailbox_get_contact (mrmailbox_t*, uint32_t contact_id);
303 
304 
305 /* Import/export and Tools */
306 #define MR_IMEX_CANCEL 0
307 #define MR_IMEX_EXPORT_SELF_KEYS 1 /* param1 is a directory where the keys are written to */
308 #define MR_IMEX_IMPORT_SELF_KEYS 2 /* param1 is a directory where the keys are searched in and read from */
309 #define MR_IMEX_EXPORT_BACKUP 11 /* param1 is a directory where the backup is written to */
310 #define MR_IMEX_IMPORT_BACKUP 12 /* param1 is the file with the backup to import */
311 #define MR_IMEX_EXPORT_SETUP_MESSAGE 20 /* param1 is a directory where the setup file is written to */
312 #define MR_BAK_PREFIX "delta-chat"
313 #define MR_BAK_SUFFIX "bak"
314 void mrmailbox_imex (mrmailbox_t*, int what, const char* param1, const char* setup_code);
315 char* mrmailbox_imex_has_backup (mrmailbox_t*, const char* dir);
316 int mrmailbox_check_password (mrmailbox_t*, const char* pw);
317 char* mrmailbox_create_setup_code (mrmailbox_t*);
318 void mrmailbox_heartbeat (mrmailbox_t*);
319 
320 
321 /* logging */
322 void mrmailbox_log_error (mrmailbox_t*, int code, const char* msg, ...);
323 void mrmailbox_log_error_if (int* condition, mrmailbox_t*, int code, const char* msg, ...);
324 void mrmailbox_log_warning (mrmailbox_t*, int code, const char* msg, ...);
325 void mrmailbox_log_info (mrmailbox_t*, int code, const char* msg, ...);
326 void mrmailbox_log_vprintf (mrmailbox_t*, int event, int code, const char* msg, va_list);
327 int mrmailbox_get_thread_index (void);
328 
329 
330 /* error codes */
331 #define MR_ERR_SELF_NOT_IN_GROUP 1
332 #define MR_ERR_NONETWORK 2
333 
334 
335 /* carray tools, already defined are things as
336 unsigned unt carray_count() */
337 uint32_t carray_get_uint32 (carray*, unsigned int index);
338 
339 
340 /* deprecated functions */
341 mrchat_t* mrchatlist_get_chat_by_index (mrchatlist_t*, size_t index); /* deprecated - use mrchatlist_get_chat_id_by_index() */
342 mrmsg_t* mrchatlist_get_msg_by_index (mrchatlist_t*, size_t index); /* deprecated - use mrchatlist_get_msg_id_by_index() */
343 int mrchat_set_draft (mrchat_t*, const char* msg); /* deprecated - use mrmailbox_set_draft() instead */
344 
345 
346 /* library-internal */
347 uint32_t mrmailbox_send_msg_i__ (mrmailbox_t*, mrchat_t*, const mrmsg_t*, time_t);
348 void mrmailbox_connect_to_imap (mrmailbox_t*, mrjob_t*);
349 void mrmailbox_wake_lock (mrmailbox_t*);
350 void mrmailbox_wake_unlock (mrmailbox_t*);
351 int mrmailbox_poke_eml_file (mrmailbox_t*, const char* file);
352 int mrmailbox_is_reply_to_known_message__ (mrmailbox_t*, mrmimeparser_t*);
353 int mrmailbox_is_reply_to_messenger_message__ (mrmailbox_t*, mrmimeparser_t*);
354 time_t mrmailbox_correct_bad_timestamp__ (mrmailbox_t* ths, uint32_t chat_id, uint32_t from_id, time_t desired_timestamp, int is_fresh_msg);
355 void mrmailbox_add_or_lookup_contacts_by_mailbox_list__(mrmailbox_t* ths, struct mailimf_mailbox_list* mb_list, int origin, carray* ids, int* check_self);
356 void mrmailbox_add_or_lookup_contacts_by_address_list__(mrmailbox_t* ths, struct mailimf_address_list* adr_list, int origin, carray* ids, int* check_self);
357 int mrmailbox_get_archived_count__ (mrmailbox_t*);
358 int mrmailbox_reset_tables (mrmailbox_t*, int bits); /* reset tables but leaves server configuration, 1=jobs, 2=e2ee, 8=rest but server config */
359 size_t mrmailbox_get_real_contact_cnt__ (mrmailbox_t*);
360 uint32_t mrmailbox_add_or_lookup_contact__ (mrmailbox_t*, const char* display_name /*can be NULL*/, const char* addr_spec, int origin, int* sth_modified);
361 int mrmailbox_get_contact_origin__ (mrmailbox_t*, uint32_t id, int* ret_blocked);
362 int mrmailbox_is_contact_blocked__ (mrmailbox_t*, uint32_t id);
363 int mrmailbox_real_contact_exists__ (mrmailbox_t*, uint32_t id);
364 int mrmailbox_contact_addr_equals__ (mrmailbox_t*, uint32_t contact_id, const char* other_addr);
365 void mrmailbox_scaleup_contact_origin__ (mrmailbox_t*, uint32_t contact_id, int origin);
366 void mrmailbox_unarchive_chat__ (mrmailbox_t*, uint32_t chat_id);
367 size_t mrmailbox_get_chat_cnt__ (mrmailbox_t*);
368 uint32_t mrmailbox_create_or_lookup_nchat_by_contact_id__ (mrmailbox_t*, uint32_t contact_id);
369 uint32_t mrmailbox_lookup_real_nchat_by_contact_id__ (mrmailbox_t*, uint32_t contact_id);
370 int mrmailbox_get_total_msg_count__ (mrmailbox_t*, uint32_t chat_id);
371 int mrmailbox_get_fresh_msg_count__ (mrmailbox_t*, uint32_t chat_id);
372 uint32_t mrmailbox_get_last_deaddrop_fresh_msg__ (mrmailbox_t*);
373 void mrmailbox_send_msg_to_smtp (mrmailbox_t*, mrjob_t*);
374 void mrmailbox_send_msg_to_imap (mrmailbox_t*, mrjob_t*);
375 int mrmailbox_add_contact_to_chat__ (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
376 int mrmailbox_is_contact_in_chat__ (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
377 int mrmailbox_get_chat_contact_count__ (mrmailbox_t*, uint32_t chat_id);
378 int mrmailbox_group_explicitly_left__ (mrmailbox_t*, const char* grpid);
379 void mrmailbox_set_group_explicitly_left__ (mrmailbox_t*, const char* grpid);
380 size_t mrmailbox_get_real_msg_cnt__ (mrmailbox_t*); /* the number of messages assigned to real chat (!=deaddrop, !=trash) */
381 size_t mrmailbox_get_deaddrop_msg_cnt__ (mrmailbox_t*);
382 int mrmailbox_rfc724_mid_cnt__ (mrmailbox_t*, const char* rfc724_mid);
383 int mrmailbox_rfc724_mid_exists__ (mrmailbox_t*, const char* rfc724_mid, char** ret_server_folder, uint32_t* ret_server_uid);
384 void mrmailbox_update_server_uid__ (mrmailbox_t*, const char* rfc724_mid, const char* server_folder, uint32_t server_uid);
385 void mrmailbox_update_msg_chat_id__ (mrmailbox_t*, uint32_t msg_id, uint32_t chat_id);
386 void mrmailbox_update_msg_state__ (mrmailbox_t*, uint32_t msg_id, int state);
387 void mrmailbox_delete_msg_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
388 int mrmailbox_mdn_from_ext__ (mrmailbox_t*, uint32_t from_id, const char* rfc724_mid, uint32_t* ret_chat_id, uint32_t* ret_msg_id); /* returns 1 if an event should be send */
389 void mrmailbox_send_mdn (mrmailbox_t*, mrjob_t* job);
390 void mrmailbox_markseen_msg_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
391 void mrmailbox_markseen_mdn_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
392 
393 
394 /* library private: end-to-end-encryption */
395 #define MR_E2EE_DEFAULT_ENABLED 1
396 #define MR_MDNS_DEFAULT_ENABLED 1
397 
398 typedef struct mrmailbox_e2ee_helper_t {
399  int m_encryption_successfull;
400  void* m_cdata_to_free;
401 } mrmailbox_e2ee_helper_t;
402 
403 void mrmailbox_e2ee_encrypt (mrmailbox_t*, const clist* recipients_addr, int e2ee_guaranteed, int encrypt_to_self, struct mailmime* in_out_message, mrmailbox_e2ee_helper_t*);
404 int mrmailbox_e2ee_decrypt (mrmailbox_t*, struct mailmime* in_out_message, int* ret_validation_errors); /* returns 1 if sth. was decrypted, 0 in other cases */
405 void mrmailbox_e2ee_thanks (mrmailbox_e2ee_helper_t*); /* frees data referenced by "mailmime" but not freed by mailmime_free(). After calling mre2ee_unhelp(), in_out_message cannot be used any longer! */
406 int mrmailbox_ensure_secret_key_exists (mrmailbox_t*); /* makes sure, the private key exists, needed only for exporting keys and the case no message was sent before */
407 
408 
409 #ifdef __cplusplus
410 } /* /extern "C" */
411 #endif
412 #endif /* __MRMAILBOX_H__ */
mrmailbox_t::mrmailbox_add_address_book
int mrmailbox_add_address_book(mrmailbox_t *mailbox, const char *adr_book)
Add a number of contacts.
Definition: mrmailbox.c:4017
-
mrmailbox_t::mrmailbox_create_group_chat
uint32_t mrmailbox_create_group_chat(mrmailbox_t *mailbox, const char *chat_name)
Create a new group chat.
Definition: mrmailbox.c:3329
-
mrmailbox_t::mrmailbox_create_contact
uint32_t mrmailbox_create_contact(mrmailbox_t *mailbox, const char *name, const char *addr)
Add a single contact.
Definition: mrmailbox.c:3981
-
mrmailbox_t::mrmailbox_send_text_msg
uint32_t mrmailbox_send_text_msg(mrmailbox_t *mailbox, uint32_t chat_id, const char *text_to_send)
Send a simple text message to the given chat.
Definition: mrmailbox.c:3097
+
1 /*******************************************************************************
2  *
3  * Delta Chat Core
4  * Copyright (C) 2017 Björn Petersen
5  * Contact: r10s@b44t.com, http://b44t.com
6  *
7  * This program is free software: you can redistribute it and/or modify it under
8  * the terms of the GNU General Public License as published by the Free Software
9  * Foundation, either version 3 of the License, or (at your option) any later
10  * version.
11  *
12  * This program is distributed in the hope that it will be useful, but WITHOUT
13  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
14  * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
15  * details.
16  *
17  * You should have received a copy of the GNU General Public License along with
18  * this program. If not, see http://www.gnu.org/licenses/ .
19  *
20  ******************************************************************************/
21 
22 
23 #ifndef __MRMAILBOX_H__
24 #define __MRMAILBOX_H__
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28 
29 
30 #define MR_VERSION_MAJOR 0
31 #define MR_VERSION_MINOR 9
32 #define MR_VERSION_REVISION 8
33 
34 
136 #include <libetpan/libetpan.h> /* defines uint16_t and carray */
137 #include "mrchatlist.h"
138 #include "mrchat.h"
139 #include "mrmsg.h"
140 #include "mrcontact.h"
141 #include "mrpoortext.h"
142 #include "mrparam.h"
143 #include "mrevent.h"
144 
145 typedef struct mrmailbox_t mrmailbox_t;
146 typedef struct mrimap_t mrimap_t;
147 typedef struct mrsmtp_t mrsmtp_t;
148 typedef struct mrsqlite3_t mrsqlite3_t;
149 typedef struct mrjob_t mrjob_t;
150 typedef struct mrmimeparser_t mrmimeparser_t;
151 
152 
168 typedef uintptr_t (*mrmailboxcb_t) (mrmailbox_t*, int event, uintptr_t data1, uintptr_t data2);
169 
170 
178 typedef struct mrmailbox_t
179 {
180  void* m_userdata;
181  char* m_dbfile;
182  char* m_blobdir;
185  mrsqlite3_t* m_sql;
186  mrimap_t* m_imap;
187  mrsmtp_t* m_smtp;
189  pthread_t m_job_thread;
190  pthread_cond_t m_job_cond;
191  pthread_mutex_t m_job_condmutex;
192  int m_job_condflag;
193  int m_job_do_exit;
195  mrmailboxcb_t m_cb;
197  char* m_os_name;
199  uint32_t m_cmdline_sel_chat_id;
201  int m_wake_lock;
202  pthread_mutex_t m_wake_lock_critical;
204  int m_e2ee_enabled;
206  #define MR_LOG_RINGBUF_SIZE 200
207  pthread_mutex_t m_log_ringbuf_critical;
208  char* m_log_ringbuf[MR_LOG_RINGBUF_SIZE];
210  time_t m_log_ringbuf_times[MR_LOG_RINGBUF_SIZE];
212  int m_log_ringbuf_pos;
214 } mrmailbox_t;
215 
216 
217 /* create/open/connect */
218 mrmailbox_t* mrmailbox_new (mrmailboxcb_t, void* userdata, const char* os_name);
219 void mrmailbox_unref (mrmailbox_t*);
220 
221 int mrmailbox_open (mrmailbox_t*, const char* dbfile, const char* blobdir);
222 void mrmailbox_close (mrmailbox_t*);
223 int mrmailbox_is_open (const mrmailbox_t*);
224 
225 int mrmailbox_set_config (mrmailbox_t*, const char* key, const char* value);
226 char* mrmailbox_get_config (mrmailbox_t*, const char* key, const char* def);
227 int mrmailbox_set_config_int (mrmailbox_t*, const char* key, int32_t value);
228 int32_t mrmailbox_get_config_int (mrmailbox_t*, const char* key, int32_t def);
229 char* mrmailbox_get_version_str (void);
230 
231 int mrmailbox_configure_and_connect(mrmailbox_t*);
232 void mrmailbox_configure_cancel (mrmailbox_t*);
233 int mrmailbox_is_configured (mrmailbox_t*);
234 
235 void mrmailbox_connect (mrmailbox_t*);
236 void mrmailbox_disconnect (mrmailbox_t*);
237 
238 char* mrmailbox_get_info (mrmailbox_t*);
239 
240 
241 /* Handle chatlists */
242 #define MR_GCL_ARCHIVED_ONLY 0x01
243 #define MR_GCL_NO_SPECIALS 0x02
244 mrchatlist_t* mrmailbox_get_chatlist (mrmailbox_t*, int flags, const char* query);
245 
246 
247 /* Handle chats */
248 uint32_t mrmailbox_create_chat_by_contact_id (mrmailbox_t*, uint32_t contact_id);
249 uint32_t mrmailbox_get_chat_id_by_contact_id (mrmailbox_t*, uint32_t contact_id);
250 
251 uint32_t mrmailbox_send_text_msg (mrmailbox_t*, uint32_t chat_id, const char* text_to_send);
252 uint32_t mrmailbox_send_msg (mrmailbox_t*, uint32_t chat_id, mrmsg_t*);
253 void mrmailbox_set_draft (mrmailbox_t*, uint32_t chat_id, const char*);
254 
255 #define MR_GCM_ADDDAYMARKER 0x01
256 carray* mrmailbox_get_chat_msgs (mrmailbox_t*, uint32_t chat_id, uint32_t flags, uint32_t marker1before);
257 int mrmailbox_get_total_msg_count (mrmailbox_t*, uint32_t chat_id);
258 int mrmailbox_get_fresh_msg_count (mrmailbox_t*, uint32_t chat_id);
259 carray* mrmailbox_get_fresh_msgs (mrmailbox_t*);
260 void mrmailbox_marknoticed_chat (mrmailbox_t*, uint32_t chat_id);
261 carray* mrmailbox_get_chat_media (mrmailbox_t*, uint32_t chat_id, int msg_type, int or_msg_type);
262 uint32_t mrmailbox_get_next_media (mrmailbox_t*, uint32_t curr_msg_id, int dir);
263 
264 void mrmailbox_archive_chat (mrmailbox_t*, uint32_t chat_id, int archive);
265 void mrmailbox_delete_chat (mrmailbox_t*, uint32_t chat_id);
266 
267 carray* mrmailbox_get_chat_contacts (mrmailbox_t*, uint32_t chat_id);
268 carray* mrmailbox_search_msgs (mrmailbox_t*, uint32_t chat_id, const char* query);
269 
270 mrchat_t* mrmailbox_get_chat (mrmailbox_t*, uint32_t chat_id);
271 
272 
273 /* Handle group chats */
274 uint32_t mrmailbox_create_group_chat (mrmailbox_t*, const char* name);
275 int mrmailbox_is_contact_in_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
276 int mrmailbox_add_contact_to_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
277 int mrmailbox_remove_contact_from_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
278 int mrmailbox_set_chat_name (mrmailbox_t*, uint32_t chat_id, const char* name);
279 int mrmailbox_set_chat_image (mrmailbox_t*, uint32_t chat_id, const char* image);
280 
281 
282 /* Handle messages */
283 char* mrmailbox_get_msg_info (mrmailbox_t*, uint32_t msg_id);
284 void mrmailbox_delete_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt);
285 void mrmailbox_forward_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt, uint32_t chat_id);
286 void mrmailbox_marknoticed_contact (mrmailbox_t*, uint32_t contact_id);
287 void mrmailbox_markseen_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt);
288 void mrmailbox_star_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt, int star);
289 mrmsg_t* mrmailbox_get_msg (mrmailbox_t*, uint32_t msg_id);
290 
291 
292 /* Handle contacts */
293 uint32_t mrmailbox_create_contact (mrmailbox_t*, const char* name, const char* addr);
294 int mrmailbox_add_address_book (mrmailbox_t*, const char*);
295 carray* mrmailbox_get_known_contacts (mrmailbox_t*, const char* query);
296 int mrmailbox_get_blocked_count (mrmailbox_t*);
297 carray* mrmailbox_get_blocked_contacts (mrmailbox_t*);
298 void mrmailbox_block_contact (mrmailbox_t*, uint32_t contact_id, int block);
299 char* mrmailbox_get_contact_encrinfo (mrmailbox_t*, uint32_t contact_id);
300 int mrmailbox_delete_contact (mrmailbox_t*, uint32_t contact_id);
301 mrcontact_t* mrmailbox_get_contact (mrmailbox_t*, uint32_t contact_id);
302 
303 
304 /* Import/export and Tools */
305 #define MR_IMEX_CANCEL 0
306 #define MR_IMEX_EXPORT_SELF_KEYS 1 /* param1 is a directory where the keys are written to */
307 #define MR_IMEX_IMPORT_SELF_KEYS 2 /* param1 is a directory where the keys are searched in and read from */
308 #define MR_IMEX_EXPORT_BACKUP 11 /* param1 is a directory where the backup is written to */
309 #define MR_IMEX_IMPORT_BACKUP 12 /* param1 is the file with the backup to import */
310 #define MR_IMEX_EXPORT_SETUP_MESSAGE 20 /* param1 is a directory where the setup file is written to */
311 #define MR_BAK_PREFIX "delta-chat"
312 #define MR_BAK_SUFFIX "bak"
313 void mrmailbox_imex (mrmailbox_t*, int what, const char* param1, const char* setup_code);
314 char* mrmailbox_imex_has_backup (mrmailbox_t*, const char* dir);
315 int mrmailbox_check_password (mrmailbox_t*, const char* pw);
316 char* mrmailbox_create_setup_code (mrmailbox_t*);
317 void mrmailbox_heartbeat (mrmailbox_t*);
318 
319 
320 /* logging */
321 void mrmailbox_log_error (mrmailbox_t*, int code, const char* msg, ...);
322 void mrmailbox_log_error_if (int* condition, mrmailbox_t*, int code, const char* msg, ...);
323 void mrmailbox_log_warning (mrmailbox_t*, int code, const char* msg, ...);
324 void mrmailbox_log_info (mrmailbox_t*, int code, const char* msg, ...);
325 void mrmailbox_log_vprintf (mrmailbox_t*, int event, int code, const char* msg, va_list);
326 int mrmailbox_get_thread_index (void);
327 
328 
329 /* error codes */
330 #define MR_ERR_SELF_NOT_IN_GROUP 1
331 #define MR_ERR_NONETWORK 2
332 
333 
334 /* carray tools, already defined are things as
335 unsigned unt carray_count() */
336 uint32_t carray_get_uint32 (carray*, unsigned int index);
337 
338 
339 /* deprecated functions */
340 mrchat_t* mrchatlist_get_chat_by_index (mrchatlist_t*, size_t index); /* deprecated - use mrchatlist_get_chat_id_by_index() */
341 mrmsg_t* mrchatlist_get_msg_by_index (mrchatlist_t*, size_t index); /* deprecated - use mrchatlist_get_msg_id_by_index() */
342 int mrchat_set_draft (mrchat_t*, const char* msg); /* deprecated - use mrmailbox_set_draft() instead */
343 
344 
345 /* library-internal */
346 uint32_t mrmailbox_send_msg_i__ (mrmailbox_t*, mrchat_t*, const mrmsg_t*, time_t);
347 void mrmailbox_connect_to_imap (mrmailbox_t*, mrjob_t*);
348 void mrmailbox_wake_lock (mrmailbox_t*);
349 void mrmailbox_wake_unlock (mrmailbox_t*);
350 int mrmailbox_poke_eml_file (mrmailbox_t*, const char* file);
351 int mrmailbox_is_reply_to_known_message__ (mrmailbox_t*, mrmimeparser_t*);
352 int mrmailbox_is_reply_to_messenger_message__ (mrmailbox_t*, mrmimeparser_t*);
353 time_t mrmailbox_correct_bad_timestamp__ (mrmailbox_t* ths, uint32_t chat_id, uint32_t from_id, time_t desired_timestamp, int is_fresh_msg);
354 void mrmailbox_add_or_lookup_contacts_by_mailbox_list__(mrmailbox_t* ths, struct mailimf_mailbox_list* mb_list, int origin, carray* ids, int* check_self);
355 void mrmailbox_add_or_lookup_contacts_by_address_list__(mrmailbox_t* ths, struct mailimf_address_list* adr_list, int origin, carray* ids, int* check_self);
356 int mrmailbox_get_archived_count__ (mrmailbox_t*);
357 int mrmailbox_reset_tables (mrmailbox_t*, int bits); /* reset tables but leaves server configuration, 1=jobs, 2=e2ee, 8=rest but server config */
358 size_t mrmailbox_get_real_contact_cnt__ (mrmailbox_t*);
359 uint32_t mrmailbox_add_or_lookup_contact__ (mrmailbox_t*, const char* display_name /*can be NULL*/, const char* addr_spec, int origin, int* sth_modified);
360 int mrmailbox_get_contact_origin__ (mrmailbox_t*, uint32_t id, int* ret_blocked);
361 int mrmailbox_is_contact_blocked__ (mrmailbox_t*, uint32_t id);
362 int mrmailbox_real_contact_exists__ (mrmailbox_t*, uint32_t id);
363 int mrmailbox_contact_addr_equals__ (mrmailbox_t*, uint32_t contact_id, const char* other_addr);
364 void mrmailbox_scaleup_contact_origin__ (mrmailbox_t*, uint32_t contact_id, int origin);
365 void mrmailbox_unarchive_chat__ (mrmailbox_t*, uint32_t chat_id);
366 size_t mrmailbox_get_chat_cnt__ (mrmailbox_t*);
367 uint32_t mrmailbox_create_or_lookup_nchat_by_contact_id__ (mrmailbox_t*, uint32_t contact_id);
368 uint32_t mrmailbox_lookup_real_nchat_by_contact_id__ (mrmailbox_t*, uint32_t contact_id);
369 int mrmailbox_get_total_msg_count__ (mrmailbox_t*, uint32_t chat_id);
370 int mrmailbox_get_fresh_msg_count__ (mrmailbox_t*, uint32_t chat_id);
371 uint32_t mrmailbox_get_last_deaddrop_fresh_msg__ (mrmailbox_t*);
372 void mrmailbox_send_msg_to_smtp (mrmailbox_t*, mrjob_t*);
373 void mrmailbox_send_msg_to_imap (mrmailbox_t*, mrjob_t*);
374 int mrmailbox_add_contact_to_chat__ (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
375 int mrmailbox_is_contact_in_chat__ (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
376 int mrmailbox_get_chat_contact_count__ (mrmailbox_t*, uint32_t chat_id);
377 int mrmailbox_group_explicitly_left__ (mrmailbox_t*, const char* grpid);
378 void mrmailbox_set_group_explicitly_left__ (mrmailbox_t*, const char* grpid);
379 size_t mrmailbox_get_real_msg_cnt__ (mrmailbox_t*); /* the number of messages assigned to real chat (!=deaddrop, !=trash) */
380 size_t mrmailbox_get_deaddrop_msg_cnt__ (mrmailbox_t*);
381 int mrmailbox_rfc724_mid_cnt__ (mrmailbox_t*, const char* rfc724_mid);
382 int mrmailbox_rfc724_mid_exists__ (mrmailbox_t*, const char* rfc724_mid, char** ret_server_folder, uint32_t* ret_server_uid);
383 void mrmailbox_update_server_uid__ (mrmailbox_t*, const char* rfc724_mid, const char* server_folder, uint32_t server_uid);
384 void mrmailbox_update_msg_chat_id__ (mrmailbox_t*, uint32_t msg_id, uint32_t chat_id);
385 void mrmailbox_update_msg_state__ (mrmailbox_t*, uint32_t msg_id, int state);
386 void mrmailbox_delete_msg_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
387 int mrmailbox_mdn_from_ext__ (mrmailbox_t*, uint32_t from_id, const char* rfc724_mid, uint32_t* ret_chat_id, uint32_t* ret_msg_id); /* returns 1 if an event should be send */
388 void mrmailbox_send_mdn (mrmailbox_t*, mrjob_t* job);
389 void mrmailbox_markseen_msg_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
390 void mrmailbox_markseen_mdn_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
391 
392 
393 /* library private: end-to-end-encryption */
394 #define MR_E2EE_DEFAULT_ENABLED 1
395 #define MR_MDNS_DEFAULT_ENABLED 1
396 
397 typedef struct mrmailbox_e2ee_helper_t {
398  int m_encryption_successfull;
399  void* m_cdata_to_free;
400 } mrmailbox_e2ee_helper_t;
401 
402 void mrmailbox_e2ee_encrypt (mrmailbox_t*, const clist* recipients_addr, int e2ee_guaranteed, int encrypt_to_self, struct mailmime* in_out_message, mrmailbox_e2ee_helper_t*);
403 int mrmailbox_e2ee_decrypt (mrmailbox_t*, struct mailmime* in_out_message, int* ret_validation_errors); /* returns 1 if sth. was decrypted, 0 in other cases */
404 void mrmailbox_e2ee_thanks (mrmailbox_e2ee_helper_t*); /* frees data referenced by "mailmime" but not freed by mailmime_free(). After calling mre2ee_unhelp(), in_out_message cannot be used any longer! */
405 int mrmailbox_ensure_secret_key_exists (mrmailbox_t*); /* makes sure, the private key exists, needed only for exporting keys and the case no message was sent before */
406 
407 
408 #ifdef __cplusplus
409 } /* /extern "C" */
410 #endif
411 #endif /* __MRMAILBOX_H__ */
mrmailbox_t::mrmailbox_add_address_book
int mrmailbox_add_address_book(mrmailbox_t *mailbox, const char *adr_book)
Add a number of contacts.
Definition: mrmailbox.c:4006
+
mrmailbox_t::mrmailbox_create_group_chat
uint32_t mrmailbox_create_group_chat(mrmailbox_t *mailbox, const char *chat_name)
Create a new group chat.
Definition: mrmailbox.c:3318
+
mrmailbox_t::mrmailbox_create_contact
uint32_t mrmailbox_create_contact(mrmailbox_t *mailbox, const char *name, const char *addr)
Add a single contact.
Definition: mrmailbox.c:3970
+
mrmailbox_t::mrmailbox_send_text_msg
uint32_t mrmailbox_send_text_msg(mrmailbox_t *mailbox, uint32_t chat_id, const char *text_to_send)
Send a simple text message to the given chat.
Definition: mrmailbox.c:3086
mrmailbox_t::mrmailbox_close
void mrmailbox_close(mrmailbox_t *mailbox)
Close mailbox database.
Definition: mrmailbox.c:1076
mrmailbox_t::mrmailbox_new
mrmailbox_t * mrmailbox_new(mrmailboxcb_t cb, void *userdata, const char *os_name)
Create a new mailbox object.
Definition: mrmailbox.c:898
-
mrmailbox_t::mrmailbox_is_contact_in_chat
int mrmailbox_is_contact_in_chat(mrmailbox_t *mailbox, uint32_t chat_id, uint32_t contact_id)
Check if a given contact ID is a member of a group chat.
Definition: mrmailbox.c:3561
+
mrmailbox_t::mrmailbox_is_contact_in_chat
int mrmailbox_is_contact_in_chat(mrmailbox_t *mailbox, uint32_t chat_id, uint32_t contact_id)
Check if a given contact ID is a member of a group chat.
Definition: mrmailbox.c:3550
mrevent.h
The following constants are used as events reported to the callback given to mrmailbox_new().
-
mrmailbox_t::mrmailbox_get_chat
mrchat_t * mrmailbox_get_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Get a chat object of type mrchat_t by a chat_id.
Definition: mrmailbox.c:1705
-
mrmailbox_t::mrmailbox_remove_contact_from_chat
int mrmailbox_remove_contact_from_chat(mrmailbox_t *mailbox, uint32_t chat_id, uint32_t contact_id)
Remove a member from a group.
Definition: mrmailbox.c:3674
+
mrmailbox_t::mrmailbox_get_chat
mrchat_t * mrmailbox_get_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Get a chat object of type mrchat_t by a chat_id.
Definition: mrmailbox.c:1694
+
mrmailbox_t::mrmailbox_remove_contact_from_chat
int mrmailbox_remove_contact_from_chat(mrmailbox_t *mailbox, uint32_t chat_id, uint32_t contact_id)
Remove a member from a group.
Definition: mrmailbox.c:3663
mrmailbox_t::mrmailbox_open
int mrmailbox_open(mrmailbox_t *mailbox, const char *dbfile, const char *blobdir)
Open mailbox database.
Definition: mrmailbox.c:1011
mrcontact_t
An object representing a single contact in memory.
Definition: mrcontact.h:38
-
mrmailbox_t::mrmailbox_delete_contact
int mrmailbox_delete_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Delete a contact.
Definition: mrmailbox.c:4505
+
mrmailbox_t::mrmailbox_delete_contact
int mrmailbox_delete_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Delete a contact.
Definition: mrmailbox.c:4494
mrchatlist_t
An object representing a single chatlist in memory.
Definition: mrchatlist.h:42
-
mrmailbox_t::mrmailbox_heartbeat
void mrmailbox_heartbeat(mrmailbox_t *ths)
Stay alive.
Definition: mrmailbox.c:1627
-
mrmailbox_t::mrmailbox_get_chat_msgs
carray * mrmailbox_get_chat_msgs(mrmailbox_t *mailbox, uint32_t chat_id, uint32_t flags, uint32_t marker1before)
Get all message IDs belonging to a chat.
Definition: mrmailbox.c:2116
-
mrmailbox_t::mrmailbox_star_msgs
void mrmailbox_star_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt, int star)
Star/unstar messages by setting the last parameter to 0 (unstar) or 1(star).
Definition: mrmailbox.c:4950
-
mrmailbox_t::mrmailbox_search_msgs
carray * mrmailbox_search_msgs(mrmailbox_t *mailbox, uint32_t chat_id, const char *query)
Search messages containing the given query string.
Definition: mrmailbox.c:2220
+
mrmailbox_t::mrmailbox_heartbeat
void mrmailbox_heartbeat(mrmailbox_t *ths)
Stay alive.
Definition: mrmailbox.c:1616
+
mrmailbox_t::mrmailbox_get_chat_msgs
carray * mrmailbox_get_chat_msgs(mrmailbox_t *mailbox, uint32_t chat_id, uint32_t flags, uint32_t marker1before)
Get all message IDs belonging to a chat.
Definition: mrmailbox.c:2105
+
mrmailbox_t::mrmailbox_star_msgs
void mrmailbox_star_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt, int star)
Star/unstar messages by setting the last parameter to 0 (unstar) or 1(star).
Definition: mrmailbox.c:4939
+
mrmailbox_t::mrmailbox_search_msgs
carray * mrmailbox_search_msgs(mrmailbox_t *mailbox, uint32_t chat_id, const char *query)
Search messages containing the given query string.
Definition: mrmailbox.c:2209
mrmailbox_t::mrmailbox_set_config
int mrmailbox_set_config(mrmailbox_t *ths, const char *key, const char *value)
Configure the mailbox.
Definition: mrmailbox.c:1177
mrmailbox_t::m_dbfile
char * m_dbfile
the database file in file.
Definition: mrmailbox.h:181
mrmailbox_t
An object representing a single mailbox.
Definition: mrmailbox.h:178
-
mrmailbox_t::mrmailbox_delete_msgs
void mrmailbox_delete_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt)
Delete a list of messages.
Definition: mrmailbox.c:5092
+
mrmailbox_t::mrmailbox_delete_msgs
void mrmailbox_delete_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt)
Delete a list of messages.
Definition: mrmailbox.c:5081
mrmailbox_t::mrmailbox_is_open
int mrmailbox_is_open(const mrmailbox_t *mailbox)
Check if a given mailbox database is open.
Definition: mrmailbox.c:1110
-
mrmailbox_t::mrmailbox_archive_chat
void mrmailbox_archive_chat(mrmailbox_t *mailbox, uint32_t chat_id, int archive)
Archive or unarchive a chat.
Definition: mrmailbox.c:2648
+
mrmailbox_t::mrmailbox_archive_chat
void mrmailbox_archive_chat(mrmailbox_t *mailbox, uint32_t chat_id, int archive)
Archive or unarchive a chat.
Definition: mrmailbox.c:2637
mrmailbox_t::mrmailbox_get_info
char * mrmailbox_get_info(mrmailbox_t *mailbox)
Get information about the mailbox.
Definition: mrmailbox.c:1278
-
mrmailbox_t::mrmailbox_add_contact_to_chat
int mrmailbox_add_contact_to_chat(mrmailbox_t *mailbox, uint32_t chat_id, uint32_t contact_id)
Add a member to a group.
Definition: mrmailbox.c:3591
-
mrmailbox_t::mrmailbox_get_next_media
uint32_t mrmailbox_get_next_media(mrmailbox_t *mailbox, uint32_t curr_msg_id, int dir)
Returns all message IDs of the given types in a chat.
Definition: mrmailbox.c:1923
+
mrmailbox_t::mrmailbox_add_contact_to_chat
int mrmailbox_add_contact_to_chat(mrmailbox_t *mailbox, uint32_t chat_id, uint32_t contact_id)
Add a member to a group.
Definition: mrmailbox.c:3580
+
mrmailbox_t::mrmailbox_get_next_media
uint32_t mrmailbox_get_next_media(mrmailbox_t *mailbox, uint32_t curr_msg_id, int dir)
Returns all message IDs of the given types in a chat.
Definition: mrmailbox.c:1912
mrmailbox_t::mrmailbox_get_version_str
char * mrmailbox_get_version_str(void)
Find out the version of the Delta Chat core library.
Definition: mrmailbox.c:1476
mrmailbox_t::mrmailbox_disconnect
void mrmailbox_disconnect(mrmailbox_t *mailbox)
Disonnect the mailbox from the server.
Definition: mrmailbox.c:1591
mrmailbox_t::m_blobdir
char * m_blobdir
full path of the blob directory in use.
Definition: mrmailbox.h:182
-
mrmailbox_t::mrmailbox_get_fresh_msgs
carray * mrmailbox_get_fresh_msgs(mrmailbox_t *mailbox)
Returns the message IDs of all fresh messages of any chat.
Definition: mrmailbox.c:2048
-
mrmailbox_t::mrmailbox_send_msg
uint32_t mrmailbox_send_msg(mrmailbox_t *mailbox, uint32_t chat_id, mrmsg_t *msg)
save message in database and send it, the given message object is not unref&#39;d by the function but som...
Definition: mrmailbox.c:3138
+
mrmailbox_t::mrmailbox_get_fresh_msgs
carray * mrmailbox_get_fresh_msgs(mrmailbox_t *mailbox)
Returns the message IDs of all fresh messages of any chat.
Definition: mrmailbox.c:2037
+
mrmailbox_t::mrmailbox_send_msg
uint32_t mrmailbox_send_msg(mrmailbox_t *mailbox, uint32_t chat_id, mrmsg_t *msg)
save message in database and send it, the given message object is not unref&#39;d by the function but som...
Definition: mrmailbox.c:3127
mrmailbox_t::mrmailbox_connect
void mrmailbox_connect(mrmailbox_t *mailbox)
Connect to the mailbox using the configured settings.
Definition: mrmailbox.c:1564
-
mrmailbox_t::mrmailbox_get_total_msg_count
int mrmailbox_get_total_msg_count(mrmailbox_t *mailbox, uint32_t chat_id)
Get the total number of messages in a chat.
Definition: mrmailbox.c:2584
-
mrmailbox_t::mrmailbox_get_chat_contacts
carray * mrmailbox_get_chat_contacts(mrmailbox_t *mailbox, uint32_t chat_id)
Get contact IDs belonging to a chat.
Definition: mrmailbox.c:1999
+
mrmailbox_t::mrmailbox_get_total_msg_count
int mrmailbox_get_total_msg_count(mrmailbox_t *mailbox, uint32_t chat_id)
Get the total number of messages in a chat.
Definition: mrmailbox.c:2573
+
mrmailbox_t::mrmailbox_get_chat_contacts
carray * mrmailbox_get_chat_contacts(mrmailbox_t *mailbox, uint32_t chat_id)
Get contact IDs belonging to a chat.
Definition: mrmailbox.c:1988
mrmailbox_t::mrmailbox_unref
void mrmailbox_unref(mrmailbox_t *mailbox)
Free a mailbox object.
Definition: mrmailbox.c:955
-
mrmailbox_t::mrmailbox_block_contact
void mrmailbox_block_contact(mrmailbox_t *mailbox, uint32_t contact_id, int new_blocking)
Block or unblock a contact.
Definition: mrmailbox.c:4286
+
mrmailbox_t::mrmailbox_block_contact
void mrmailbox_block_contact(mrmailbox_t *mailbox, uint32_t contact_id, int new_blocking)
Block or unblock a contact.
Definition: mrmailbox.c:4275
mrmailbox_t::mrmailboxcb_t
uintptr_t(* mrmailboxcb_t)(mrmailbox_t *, int event, uintptr_t data1, uintptr_t data2)
Callback function that should be given to mrmailbox_new().
Definition: mrmailbox.h:168
-
mrmailbox_t::mrmailbox_configure_and_connect
int mrmailbox_configure_and_connect(mrmailbox_t *mailbox)
Configure and connect a mailbox.
Definition: mrmailbox_configure.c:382
-
mrmailbox_t::mrmailbox_get_chatlist
mrchatlist_t * mrmailbox_get_chatlist(mrmailbox_t *mailbox, int listflags, const char *query)
Get a list of chats.
Definition: mrmailbox.c:1659
+
mrmailbox_t::mrmailbox_configure_and_connect
int mrmailbox_configure_and_connect(mrmailbox_t *mailbox)
Configure and connect a mailbox.
Definition: mrmailbox_configure.c:387
+
mrmailbox_t::mrmailbox_get_chatlist
mrchatlist_t * mrmailbox_get_chatlist(mrmailbox_t *mailbox, int listflags, const char *query)
Get a list of chats.
Definition: mrmailbox.c:1648
mrmsg_t
An object representing a single message in memory.
Definition: mrmsg.h:40
-
mrmailbox_t::mrmailbox_get_chat_id_by_contact_id
uint32_t mrmailbox_get_chat_id_by_contact_id(mrmailbox_t *mailbox, uint32_t contact_id)
Check, if there is a normal chat with a given contact.
Definition: mrmailbox.c:1785
-
mrmailbox_t::mrmailbox_get_fresh_msg_count
int mrmailbox_get_fresh_msg_count(mrmailbox_t *mailbox, uint32_t chat_id)
Get the number of fresh messages in a chat.
Definition: mrmailbox.c:2612
-
mrmailbox_t::mrmailbox_delete_chat
void mrmailbox_delete_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Delete a chat:
Definition: mrmailbox.c:2769
-
mrmailbox_t::mrmailbox_set_draft
void mrmailbox_set_draft(mrmailbox_t *mailbox, uint32_t chat_id, const char *msg)
Save a draft for a chat.
Definition: mrmailbox.c:2367
-
mrmailbox_t::mrmailbox_get_blocked_count
int mrmailbox_get_blocked_count(mrmailbox_t *mailbox)
Get the number of blocked contacts.
Definition: mrmailbox.c:4170
-
mrmailbox_t::mrmailbox_set_chat_image
int mrmailbox_set_chat_image(mrmailbox_t *mailbox, uint32_t chat_id, const char *new_image)
Set group image.
Definition: mrmailbox.c:3472
-
mrmailbox_t::mrmailbox_get_known_contacts
carray * mrmailbox_get_known_contacts(mrmailbox_t *mailbox, const char *query)
Returns known and unblocked contacts.
Definition: mrmailbox.c:4072
-
mrmailbox_t::mrmailbox_get_msg
mrmsg_t * mrmailbox_get_msg(mrmailbox_t *mailbox, uint32_t msg_id)
Get a single message object of the type mrmsg_t.
Definition: mrmailbox.c:4697
+
mrmailbox_t::mrmailbox_get_chat_id_by_contact_id
uint32_t mrmailbox_get_chat_id_by_contact_id(mrmailbox_t *mailbox, uint32_t contact_id)
Check, if there is a normal chat with a given contact.
Definition: mrmailbox.c:1774
+
mrmailbox_t::mrmailbox_get_fresh_msg_count
int mrmailbox_get_fresh_msg_count(mrmailbox_t *mailbox, uint32_t chat_id)
Get the number of fresh messages in a chat.
Definition: mrmailbox.c:2601
+
mrmailbox_t::mrmailbox_delete_chat
void mrmailbox_delete_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Delete a chat:
Definition: mrmailbox.c:2758
+
mrmailbox_t::mrmailbox_set_draft
void mrmailbox_set_draft(mrmailbox_t *mailbox, uint32_t chat_id, const char *msg)
Save a draft for a chat.
Definition: mrmailbox.c:2356
+
mrmailbox_t::mrmailbox_get_blocked_count
int mrmailbox_get_blocked_count(mrmailbox_t *mailbox)
Get the number of blocked contacts.
Definition: mrmailbox.c:4159
+
mrmailbox_t::mrmailbox_set_chat_image
int mrmailbox_set_chat_image(mrmailbox_t *mailbox, uint32_t chat_id, const char *new_image)
Set group image.
Definition: mrmailbox.c:3461
+
mrmailbox_t::mrmailbox_get_known_contacts
carray * mrmailbox_get_known_contacts(mrmailbox_t *mailbox, const char *query)
Returns known and unblocked contacts.
Definition: mrmailbox.c:4061
+
mrmailbox_t::mrmailbox_get_msg
mrmsg_t * mrmailbox_get_msg(mrmailbox_t *mailbox, uint32_t msg_id)
Get a single message object of the type mrmsg_t.
Definition: mrmailbox.c:4686
mrmailbox_t::m_userdata
void * m_userdata
the same pointer as given to mrmailbox_new(), may be used by the caller for any purpose ...
Definition: mrmailbox.h:180
-
mrmailbox_t::mrmailbox_is_configured
int mrmailbox_is_configured(mrmailbox_t *mailbox)
Check if the mailbox is already configured.
Definition: mrmailbox_configure.c:729
-
mrmailbox_t::mrmailbox_get_chat_media
carray * mrmailbox_get_chat_media(mrmailbox_t *mailbox, uint32_t chat_id, int msg_type, int or_msg_type)
Returns all message IDs of the given types in a chat.
Definition: mrmailbox.c:1892
-
mrmailbox_t::mrmailbox_create_chat_by_contact_id
uint32_t mrmailbox_create_chat_by_contact_id(mrmailbox_t *mailbox, uint32_t contact_id)
Create a normal chat with a single user.
Definition: mrmailbox.c:1812
-
mrmailbox_t::mrmailbox_forward_msgs
void mrmailbox_forward_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt, uint32_t chat_id)
Forward a list of messages to another chat.
Definition: mrmailbox.c:4864
-
mrmailbox_t::mrmailbox_markseen_msgs
void mrmailbox_markseen_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt)
Mark a message as seen, updates the IMAP state and sends MDNs.
Definition: mrmailbox.c:5233
-
mrmailbox_t::mrmailbox_marknoticed_chat
void mrmailbox_marknoticed_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Mark all message in a chat as noticed.
Definition: mrmailbox.c:1751
+
mrmailbox_t::mrmailbox_is_configured
int mrmailbox_is_configured(mrmailbox_t *mailbox)
Check if the mailbox is already configured.
Definition: mrmailbox_configure.c:738
+
mrmailbox_t::mrmailbox_get_chat_media
carray * mrmailbox_get_chat_media(mrmailbox_t *mailbox, uint32_t chat_id, int msg_type, int or_msg_type)
Returns all message IDs of the given types in a chat.
Definition: mrmailbox.c:1881
+
mrmailbox_t::mrmailbox_create_chat_by_contact_id
uint32_t mrmailbox_create_chat_by_contact_id(mrmailbox_t *mailbox, uint32_t contact_id)
Create a normal chat with a single user.
Definition: mrmailbox.c:1801
+
mrmailbox_t::mrmailbox_forward_msgs
void mrmailbox_forward_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt, uint32_t chat_id)
Forward a list of messages to another chat.
Definition: mrmailbox.c:4853
+
mrmailbox_t::mrmailbox_markseen_msgs
void mrmailbox_markseen_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt)
Mark a message as seen, updates the IMAP state and sends MDNs.
Definition: mrmailbox.c:5222
+
mrmailbox_t::mrmailbox_marknoticed_chat
void mrmailbox_marknoticed_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Mark all message in a chat as noticed.
Definition: mrmailbox.c:1740
mrmailbox_t::mrmailbox_imex_has_backup
char * mrmailbox_imex_has_backup(mrmailbox_t *mailbox, const char *dir_name)
Check if there is a backup file.
Definition: mrmailbox_imex.c:697
-
mrmailbox_t::mrmailbox_configure_cancel
void mrmailbox_configure_cancel(mrmailbox_t *mailbox)
Signal the configure-process to stop.
Definition: mrmailbox_configure.c:701
-
mrmailbox_t::mrmailbox_get_blocked_contacts
carray * mrmailbox_get_blocked_contacts(mrmailbox_t *mailbox)
Get blocked contacts.
Definition: mrmailbox.c:4136
-
mrmailbox_t::mrmailbox_get_contact
mrcontact_t * mrmailbox_get_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Get a single contact object.
Definition: mrmailbox.c:4212
+
mrmailbox_t::mrmailbox_configure_cancel
void mrmailbox_configure_cancel(mrmailbox_t *mailbox)
Signal the configure-process to stop.
Definition: mrmailbox_configure.c:710
+
mrmailbox_t::mrmailbox_get_blocked_contacts
carray * mrmailbox_get_blocked_contacts(mrmailbox_t *mailbox)
Get blocked contacts.
Definition: mrmailbox.c:4125
+
mrmailbox_t::mrmailbox_get_contact
mrcontact_t * mrmailbox_get_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Get a single contact object.
Definition: mrmailbox.c:4201
mrmailbox_t::mrmailbox_check_password
int mrmailbox_check_password(mrmailbox_t *mailbox, const char *test_pw)
Check if the user is authorized by the given password in some way.
Definition: mrmailbox_imex.c:1051
-
mrmailbox_t::mrmailbox_marknoticed_contact
void mrmailbox_marknoticed_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Mark all messages send by the given contact as noticed.
Definition: mrmailbox.c:4260
+
mrmailbox_t::mrmailbox_marknoticed_contact
void mrmailbox_marknoticed_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Mark all messages send by the given contact as noticed.
Definition: mrmailbox.c:4249
mrmailbox_t::mrmailbox_set_config_int
int mrmailbox_set_config_int(mrmailbox_t *ths, const char *key, int32_t value)
Configure the mailbox.
Definition: mrmailbox.c:1230
mrmailbox_t::mrmailbox_get_config_int
int32_t mrmailbox_get_config_int(mrmailbox_t *ths, const char *key, int32_t def)
Get a configuration option.
Definition: mrmailbox.c:1252
-
mrmailbox_t::mrmailbox_set_chat_name
int mrmailbox_set_chat_name(mrmailbox_t *mailbox, uint32_t chat_id, const char *new_name)
Set group name.
Definition: mrmailbox.c:3395
+
mrmailbox_t::mrmailbox_set_chat_name
int mrmailbox_set_chat_name(mrmailbox_t *mailbox, uint32_t chat_id, const char *new_name)
Set group name.
Definition: mrmailbox.c:3384
mrmailbox_t::mrmailbox_create_setup_code
char * mrmailbox_create_setup_code(mrmailbox_t *mailbox)
Create random setup code.
Definition: mrmailbox_imex.c:1108
-
mrmailbox_t::mrmailbox_get_contact_encrinfo
char * mrmailbox_get_contact_encrinfo(mrmailbox_t *mailbox, uint32_t contact_id)
Get encryption info.
Definition: mrmailbox.c:4377
+
mrmailbox_t::mrmailbox_get_contact_encrinfo
char * mrmailbox_get_contact_encrinfo(mrmailbox_t *mailbox, uint32_t contact_id)
Get encryption info.
Definition: mrmailbox.c:4366
mrmailbox_t::mrmailbox_imex
void mrmailbox_imex(mrmailbox_t *mailbox, int what, const char *param1, const char *setup_code)
Import/export things.
Definition: mrmailbox_imex.c:998
mrmailbox_t::mrmailbox_get_config
char * mrmailbox_get_config(mrmailbox_t *ths, const char *key, const char *def)
Get a configuration option.
Definition: mrmailbox.c:1208
-
mrmailbox_t::mrmailbox_get_msg_info
char * mrmailbox_get_msg_info(mrmailbox_t *mailbox, uint32_t msg_id)
Get an informational text for a single message.
Definition: mrmailbox.c:4739
+
mrmailbox_t::mrmailbox_get_msg_info
char * mrmailbox_get_msg_info(mrmailbox_t *mailbox, uint32_t msg_id)
Get an informational text for a single message.
Definition: mrmailbox.c:4728
mrchat_t
An object representing a single chat in memory.
Definition: mrchat.h:39
diff --git a/docs/html/structmrmailbox__t.html b/docs/html/structmrmailbox__t.html index c4e8d2cb..75225c30 100644 --- a/docs/html/structmrmailbox__t.html +++ b/docs/html/structmrmailbox__t.html @@ -579,7 +579,8 @@ void * mrmailbox_set_config(). -
  • mrmailbox_configure_and_connect() may take a while, so it might be a good idea to let it run in a non-GUI-thread; to cancel the configuration progress, you can then use mrmailbox_configure_cancel()
    • +
  • mrmailbox_configure_and_connect() may take a while, so it might be a good idea to let it run in a non-GUI-thread; to cancel the configuration progress, you can then use mrmailbox_configure_cancel().
    • +
  • The function sends out a number of MR_EVENT_CONFIGURE_PROGRESS events that may be used to create a progress bar or stuff like that.
  • There is no need to call this every program start, the result is saved in the database.
    • Parameters
    @@ -608,7 +609,7 @@ void * mrmailbox_configure_cancel() returns without waiting for mrmailbox_configure_and_connect() to return.

    -

    mrmailbox_configure_and_connect() will return ASAP then, however, it may still take a second. If in doubt, the caller may also decide the kill the thread after a few seconds; eg. the configuration process may hang in a function not under the control of the core (eg. MR_EVENT_HTTP_GET)

    +

    mrmailbox_configure_and_connect() will return ASAP then, however, it may still take a moment. If in doubt, the caller may also decide the kill the thread after a few seconds; eg. the configuration process may hang in a function not under the control of the core (eg. MR_EVENT_HTTP_GET). Another reason for mrmailbox_configure_cancel() not to wait is that otherwise it would be GUI-blocking and should be started in another thread then; this would make things even more complicated.

    Parameters
    mailboxThe mailbox object as created by mrmailbox_new()