Delta Chat Core C-API
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 9
33 
34 
140 #include <libetpan/libetpan.h> /* defines uint16_t and carray */
141 #include "mrchatlist.h"
142 #include "mrchat.h"
143 #include "mrmsg.h"
144 #include "mrcontact.h"
145 #include "mrpoortext.h"
146 #include "mrparam.h"
147 #include "mrevent.h"
148 
149 typedef struct mrmailbox_t mrmailbox_t;
150 typedef struct mrimap_t mrimap_t;
151 typedef struct mrsmtp_t mrsmtp_t;
152 typedef struct mrsqlite3_t mrsqlite3_t;
153 typedef struct mrjob_t mrjob_t;
154 typedef struct mrmimeparser_t mrmimeparser_t;
155 
156 
172 typedef uintptr_t (*mrmailboxcb_t) (mrmailbox_t*, int event, uintptr_t data1, uintptr_t data2);
173 
174 
182 typedef struct mrmailbox_t
183 {
184  void* m_userdata;
185  char* m_dbfile;
186  char* m_blobdir;
189  mrsqlite3_t* m_sql;
190  mrimap_t* m_imap;
191  mrsmtp_t* m_smtp;
193  pthread_t m_job_thread;
194  pthread_cond_t m_job_cond;
195  pthread_mutex_t m_job_condmutex;
196  int m_job_condflag;
197  int m_job_do_exit;
199  mrmailboxcb_t m_cb;
201  char* m_os_name;
203  uint32_t m_cmdline_sel_chat_id;
205  int m_wake_lock;
206  pthread_mutex_t m_wake_lock_critical;
208  int m_e2ee_enabled;
210  #define MR_LOG_RINGBUF_SIZE 200
211  pthread_mutex_t m_log_ringbuf_critical;
212  char* m_log_ringbuf[MR_LOG_RINGBUF_SIZE];
214  time_t m_log_ringbuf_times[MR_LOG_RINGBUF_SIZE];
216  int m_log_ringbuf_pos;
218 } mrmailbox_t;
219 
220 
221 /* create/open/connect */
222 mrmailbox_t* mrmailbox_new (mrmailboxcb_t, void* userdata, const char* os_name);
223 void mrmailbox_unref (mrmailbox_t*);
224 
225 int mrmailbox_open (mrmailbox_t*, const char* dbfile, const char* blobdir);
226 void mrmailbox_close (mrmailbox_t*);
227 int mrmailbox_is_open (const mrmailbox_t*);
228 
229 int mrmailbox_set_config (mrmailbox_t*, const char* key, const char* value);
230 char* mrmailbox_get_config (mrmailbox_t*, const char* key, const char* def);
231 int mrmailbox_set_config_int (mrmailbox_t*, const char* key, int32_t value);
232 int32_t mrmailbox_get_config_int (mrmailbox_t*, const char* key, int32_t def);
233 char* mrmailbox_get_version_str (void);
234 
235 int mrmailbox_configure_and_connect(mrmailbox_t*);
236 void mrmailbox_configure_cancel (mrmailbox_t*);
237 int mrmailbox_is_configured (mrmailbox_t*);
238 
239 void mrmailbox_connect (mrmailbox_t*);
240 void mrmailbox_disconnect (mrmailbox_t*);
241 
242 char* mrmailbox_get_info (mrmailbox_t*);
243 
244 
245 /* Handle chatlists */
246 #define MR_GCL_ARCHIVED_ONLY 0x01
247 #define MR_GCL_NO_SPECIALS 0x02
248 mrchatlist_t* mrmailbox_get_chatlist (mrmailbox_t*, int flags, const char* query);
249 
250 
251 /* Handle chats */
252 uint32_t mrmailbox_create_chat_by_contact_id (mrmailbox_t*, uint32_t contact_id);
253 uint32_t mrmailbox_get_chat_id_by_contact_id (mrmailbox_t*, uint32_t contact_id);
254 
255 uint32_t mrmailbox_send_text_msg (mrmailbox_t*, uint32_t chat_id, const char* text_to_send);
256 uint32_t mrmailbox_send_msg (mrmailbox_t*, uint32_t chat_id, mrmsg_t*);
257 void mrmailbox_set_draft (mrmailbox_t*, uint32_t chat_id, const char*);
258 
259 #define MR_GCM_ADDDAYMARKER 0x01
260 carray* mrmailbox_get_chat_msgs (mrmailbox_t*, uint32_t chat_id, uint32_t flags, uint32_t marker1before);
261 int mrmailbox_get_total_msg_count (mrmailbox_t*, uint32_t chat_id);
262 int mrmailbox_get_fresh_msg_count (mrmailbox_t*, uint32_t chat_id);
263 carray* mrmailbox_get_fresh_msgs (mrmailbox_t*);
264 void mrmailbox_marknoticed_chat (mrmailbox_t*, uint32_t chat_id);
265 carray* mrmailbox_get_chat_media (mrmailbox_t*, uint32_t chat_id, int msg_type, int or_msg_type);
266 uint32_t mrmailbox_get_next_media (mrmailbox_t*, uint32_t curr_msg_id, int dir);
267 
268 void mrmailbox_archive_chat (mrmailbox_t*, uint32_t chat_id, int archive);
269 void mrmailbox_delete_chat (mrmailbox_t*, uint32_t chat_id);
270 
271 carray* mrmailbox_get_chat_contacts (mrmailbox_t*, uint32_t chat_id);
272 carray* mrmailbox_search_msgs (mrmailbox_t*, uint32_t chat_id, const char* query);
273 
274 mrchat_t* mrmailbox_get_chat (mrmailbox_t*, uint32_t chat_id);
275 
276 
277 /* Handle group chats */
278 uint32_t mrmailbox_create_group_chat (mrmailbox_t*, const char* name);
279 int mrmailbox_is_contact_in_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
280 int mrmailbox_add_contact_to_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
281 int mrmailbox_remove_contact_from_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
282 int mrmailbox_set_chat_name (mrmailbox_t*, uint32_t chat_id, const char* name);
283 int mrmailbox_set_chat_image (mrmailbox_t*, uint32_t chat_id, const char* image);
284 
285 
286 /* Handle messages */
287 char* mrmailbox_get_msg_info (mrmailbox_t*, uint32_t msg_id);
288 void mrmailbox_delete_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt);
289 void mrmailbox_forward_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt, uint32_t chat_id);
290 void mrmailbox_marknoticed_contact (mrmailbox_t*, uint32_t contact_id);
291 void mrmailbox_markseen_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt);
292 void mrmailbox_star_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt, int star);
293 mrmsg_t* mrmailbox_get_msg (mrmailbox_t*, uint32_t msg_id);
294 
295 
296 /* Handle contacts */
297 uint32_t mrmailbox_create_contact (mrmailbox_t*, const char* name, const char* addr);
298 int mrmailbox_add_address_book (mrmailbox_t*, const char*);
299 carray* mrmailbox_get_known_contacts (mrmailbox_t*, const char* query);
300 int mrmailbox_get_blocked_count (mrmailbox_t*);
301 carray* mrmailbox_get_blocked_contacts (mrmailbox_t*);
302 void mrmailbox_block_contact (mrmailbox_t*, uint32_t contact_id, int block);
303 char* mrmailbox_get_contact_encrinfo (mrmailbox_t*, uint32_t contact_id);
304 int mrmailbox_delete_contact (mrmailbox_t*, uint32_t contact_id);
305 mrcontact_t* mrmailbox_get_contact (mrmailbox_t*, uint32_t contact_id);
306 
307 
308 /* Import/export and Tools */
309 #define MR_IMEX_CANCEL 0
310 #define MR_IMEX_EXPORT_SELF_KEYS 1 /* param1 is a directory where the keys are written to */
311 #define MR_IMEX_IMPORT_SELF_KEYS 2 /* param1 is a directory where the keys are searched in and read from */
312 #define MR_IMEX_EXPORT_BACKUP 11 /* param1 is a directory where the backup is written to */
313 #define MR_IMEX_IMPORT_BACKUP 12 /* param1 is the file with the backup to import */
314 #define MR_IMEX_EXPORT_SETUP_MESSAGE 20 /* param1 is a directory where the setup file is written to */
315 #define MR_BAK_PREFIX "delta-chat"
316 #define MR_BAK_SUFFIX "bak"
317 void mrmailbox_imex (mrmailbox_t*, int what, const char* param1, const char* setup_code);
318 char* mrmailbox_imex_has_backup (mrmailbox_t*, const char* dir);
319 int mrmailbox_check_password (mrmailbox_t*, const char* pw);
320 char* mrmailbox_create_setup_code (mrmailbox_t*);
321 void mrmailbox_heartbeat (mrmailbox_t*);
322 
323 
324 /* logging */
325 void mrmailbox_log_error (mrmailbox_t*, int code, const char* msg, ...);
326 void mrmailbox_log_error_if (int* condition, mrmailbox_t*, int code, const char* msg, ...);
327 void mrmailbox_log_warning (mrmailbox_t*, int code, const char* msg, ...);
328 void mrmailbox_log_info (mrmailbox_t*, int code, const char* msg, ...);
329 void mrmailbox_log_vprintf (mrmailbox_t*, int event, int code, const char* msg, va_list);
330 int mrmailbox_get_thread_index (void);
331 
332 
333 /* error codes */
334 #define MR_ERR_SELF_NOT_IN_GROUP 1
335 #define MR_ERR_NONETWORK 2
336 
337 
338 /* carray tools, already defined are things as
339 unsigned unt carray_count() */
340 uint32_t carray_get_uint32 (carray*, unsigned int index);
341 
342 
343 /* deprecated functions */
344 mrchat_t* mrchatlist_get_chat_by_index (mrchatlist_t*, size_t index); /* deprecated - use mrchatlist_get_chat_id_by_index() */
345 mrmsg_t* mrchatlist_get_msg_by_index (mrchatlist_t*, size_t index); /* deprecated - use mrchatlist_get_msg_id_by_index() */
346 int mrchat_set_draft (mrchat_t*, const char* msg); /* deprecated - use mrmailbox_set_draft() instead */
347 
348 
349 /* library-internal */
350 uint32_t mrmailbox_send_msg_i__ (mrmailbox_t*, mrchat_t*, const mrmsg_t*, time_t);
351 void mrmailbox_connect_to_imap (mrmailbox_t*, mrjob_t*);
352 void mrmailbox_wake_lock (mrmailbox_t*);
353 void mrmailbox_wake_unlock (mrmailbox_t*);
354 int mrmailbox_poke_eml_file (mrmailbox_t*, const char* file);
355 int mrmailbox_is_reply_to_known_message__ (mrmailbox_t*, mrmimeparser_t*);
356 int mrmailbox_is_reply_to_messenger_message__ (mrmailbox_t*, mrmimeparser_t*);
357 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);
358 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);
359 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);
360 int mrmailbox_get_archived_count__ (mrmailbox_t*);
361 int mrmailbox_reset_tables (mrmailbox_t*, int bits); /* reset tables but leaves server configuration, 1=jobs, 2=e2ee, 8=rest but server config */
362 size_t mrmailbox_get_real_contact_cnt__ (mrmailbox_t*);
363 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);
364 int mrmailbox_get_contact_origin__ (mrmailbox_t*, uint32_t id, int* ret_blocked);
365 int mrmailbox_is_contact_blocked__ (mrmailbox_t*, uint32_t id);
366 int mrmailbox_real_contact_exists__ (mrmailbox_t*, uint32_t id);
367 int mrmailbox_contact_addr_equals__ (mrmailbox_t*, uint32_t contact_id, const char* other_addr);
368 void mrmailbox_scaleup_contact_origin__ (mrmailbox_t*, uint32_t contact_id, int origin);
369 void mrmailbox_unarchive_chat__ (mrmailbox_t*, uint32_t chat_id);
370 size_t mrmailbox_get_chat_cnt__ (mrmailbox_t*);
371 uint32_t mrmailbox_create_or_lookup_nchat_by_contact_id__ (mrmailbox_t*, uint32_t contact_id);
372 uint32_t mrmailbox_lookup_real_nchat_by_contact_id__ (mrmailbox_t*, uint32_t contact_id);
373 int mrmailbox_get_total_msg_count__ (mrmailbox_t*, uint32_t chat_id);
374 int mrmailbox_get_fresh_msg_count__ (mrmailbox_t*, uint32_t chat_id);
375 uint32_t mrmailbox_get_last_deaddrop_fresh_msg__ (mrmailbox_t*);
376 void mrmailbox_send_msg_to_smtp (mrmailbox_t*, mrjob_t*);
377 void mrmailbox_send_msg_to_imap (mrmailbox_t*, mrjob_t*);
378 int mrmailbox_add_contact_to_chat__ (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
379 int mrmailbox_is_contact_in_chat__ (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
380 int mrmailbox_get_chat_contact_count__ (mrmailbox_t*, uint32_t chat_id);
381 int mrmailbox_group_explicitly_left__ (mrmailbox_t*, const char* grpid);
382 void mrmailbox_set_group_explicitly_left__ (mrmailbox_t*, const char* grpid);
383 size_t mrmailbox_get_real_msg_cnt__ (mrmailbox_t*); /* the number of messages assigned to real chat (!=deaddrop, !=trash) */
384 size_t mrmailbox_get_deaddrop_msg_cnt__ (mrmailbox_t*);
385 int mrmailbox_rfc724_mid_cnt__ (mrmailbox_t*, const char* rfc724_mid);
386 int mrmailbox_rfc724_mid_exists__ (mrmailbox_t*, const char* rfc724_mid, char** ret_server_folder, uint32_t* ret_server_uid);
387 void mrmailbox_update_server_uid__ (mrmailbox_t*, const char* rfc724_mid, const char* server_folder, uint32_t server_uid);
388 void mrmailbox_update_msg_chat_id__ (mrmailbox_t*, uint32_t msg_id, uint32_t chat_id);
389 void mrmailbox_update_msg_state__ (mrmailbox_t*, uint32_t msg_id, int state);
390 void mrmailbox_delete_msg_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
391 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 */
392 void mrmailbox_send_mdn (mrmailbox_t*, mrjob_t* job);
393 void mrmailbox_markseen_msg_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
394 void mrmailbox_markseen_mdn_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
395 
396 
397 /* library private: end-to-end-encryption */
398 #define MR_E2EE_DEFAULT_ENABLED 1
399 #define MR_MDNS_DEFAULT_ENABLED 1
400 
401 typedef struct mrmailbox_e2ee_helper_t {
402  int m_encryption_successfull;
403  void* m_cdata_to_free;
404 } mrmailbox_e2ee_helper_t;
405 
406 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*);
407 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 */
408 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! */
409 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 */
410 
411 
412 #ifdef __cplusplus
413 } /* /extern "C" */
414 #endif
415 #endif /* __MRMAILBOX_H__ */
int mrmailbox_add_address_book(mrmailbox_t *mailbox, const char *adr_book)
Add a number of contacts.
Definition: mrmailbox.c:4019
uint32_t mrmailbox_create_group_chat(mrmailbox_t *mailbox, const char *chat_name)
Create a new group chat.
Definition: mrmailbox.c:3321
uint32_t mrmailbox_create_contact(mrmailbox_t *mailbox, const char *name, const char *addr)
Add a single contact.
Definition: mrmailbox.c:3979
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:3088
void mrmailbox_close(mrmailbox_t *mailbox)
Close mailbox database.
Definition: mrmailbox.c:1076
mrmailbox_t * mrmailbox_new(mrmailboxcb_t cb, void *userdata, const char *os_name)
Create a new mailbox object.
Definition: mrmailbox.c:898
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:3553
The following constants are used as events reported to the callback given to mrmailbox_new().
mrchat_t * mrmailbox_get_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Get chat object by a chat ID.
Definition: mrmailbox.c:1692
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:3666
int mrmailbox_open(mrmailbox_t *mailbox, const char *dbfile, const char *blobdir)
Open mailbox database.
Definition: mrmailbox.c:1011
An object representing a single contact in memory.
Definition: mrcontact.h:38
int mrmailbox_delete_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Delete a contact.
Definition: mrmailbox.c:4507
An object representing a single chatlist in memory.
Definition: mrchatlist.h:42
void mrmailbox_heartbeat(mrmailbox_t *ths)
Stay alive.
Definition: mrmailbox.c:1616
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:2103
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:4952
carray * mrmailbox_search_msgs(mrmailbox_t *mailbox, uint32_t chat_id, const char *query)
Search messages containing the given query string.
Definition: mrmailbox.c:2207
int mrmailbox_set_config(mrmailbox_t *ths, const char *key, const char *value)
Configure the mailbox.
Definition: mrmailbox.c:1177
char * m_dbfile
the database file in file.
Definition: mrmailbox.h:185
An object representing a single mailbox.
Definition: mrmailbox.h:182
void mrmailbox_delete_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt)
Delete a list of messages.
Definition: mrmailbox.c:5094
int mrmailbox_is_open(const mrmailbox_t *mailbox)
Check if a given mailbox database is open.
Definition: mrmailbox.c:1110
void mrmailbox_archive_chat(mrmailbox_t *mailbox, uint32_t chat_id, int archive)
Archive or unarchive a chat.
Definition: mrmailbox.c:2639
char * mrmailbox_get_info(mrmailbox_t *mailbox)
Get information about the mailbox.
Definition: mrmailbox.c:1278
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:3583
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:1910
char * mrmailbox_get_version_str(void)
Find out the version of the Delta Chat core library.
Definition: mrmailbox.c:1476
void mrmailbox_disconnect(mrmailbox_t *mailbox)
Disonnect the mailbox from the server.
Definition: mrmailbox.c:1591
char * m_blobdir
full path of the blob directory in use.
Definition: mrmailbox.h:186
carray * mrmailbox_get_fresh_msgs(mrmailbox_t *mailbox)
Returns the message IDs of all fresh messages of any chat.
Definition: mrmailbox.c:2035
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:3129
void mrmailbox_connect(mrmailbox_t *mailbox)
Connect to the mailbox using the configured settings.
Definition: mrmailbox.c:1564
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
carray * mrmailbox_get_chat_contacts(mrmailbox_t *mailbox, uint32_t chat_id)
Get contact IDs belonging to a chat.
Definition: mrmailbox.c:1986
void mrmailbox_unref(mrmailbox_t *mailbox)
Free a mailbox object.
Definition: mrmailbox.c:955
void mrmailbox_block_contact(mrmailbox_t *mailbox, uint32_t contact_id, int new_blocking)
Block or unblock a contact.
Definition: mrmailbox.c:4288
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:172
int mrmailbox_configure_and_connect(mrmailbox_t *mailbox)
Configure and connect a mailbox.
Definition: mrmailbox_configure.c:397
mrchatlist_t * mrmailbox_get_chatlist(mrmailbox_t *mailbox, int listflags, const char *query)
Get a list of chats.
Definition: mrmailbox.c:1648
An object representing a single message in memory.
Definition: mrmsg.h:40
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:1772
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
void mrmailbox_delete_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Delete a chat:
Definition: mrmailbox.c:2760
void mrmailbox_set_draft(mrmailbox_t *mailbox, uint32_t chat_id, const char *msg)
Save a draft for a chat.
Definition: mrmailbox.c:2356
int mrmailbox_get_blocked_count(mrmailbox_t *mailbox)
Get the number of blocked contacts.
Definition: mrmailbox.c:4172
int mrmailbox_set_chat_image(mrmailbox_t *mailbox, uint32_t chat_id, const char *new_image)
Set group image.
Definition: mrmailbox.c:3464
carray * mrmailbox_get_known_contacts(mrmailbox_t *mailbox, const char *query)
Returns known and unblocked contacts.
Definition: mrmailbox.c:4074
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:4699
void * m_userdata
the same pointer as given to mrmailbox_new(), may be used by the caller for any purpose ...
Definition: mrmailbox.h:184
int mrmailbox_is_configured(mrmailbox_t *mailbox)
Check if the mailbox is already configured.
Definition: mrmailbox_configure.c:751
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:1879
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:1799
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:4866
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:5235
void mrmailbox_marknoticed_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Mark all message in a chat as noticed.
Definition: mrmailbox.c:1738
char * mrmailbox_imex_has_backup(mrmailbox_t *mailbox, const char *dir_name)
Check if there is a backup file.
Definition: mrmailbox_imex.c:697
void mrmailbox_configure_cancel(mrmailbox_t *mailbox)
Signal the configure-process to stop.
Definition: mrmailbox_configure.c:720
carray * mrmailbox_get_blocked_contacts(mrmailbox_t *mailbox)
Get blocked contacts.
Definition: mrmailbox.c:4138
mrcontact_t * mrmailbox_get_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Get a single contact object.
Definition: mrmailbox.c:4214
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
void mrmailbox_marknoticed_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Mark all messages send by the given contact as noticed.
Definition: mrmailbox.c:4262
int mrmailbox_set_config_int(mrmailbox_t *ths, const char *key, int32_t value)
Configure the mailbox.
Definition: mrmailbox.c:1230
int32_t mrmailbox_get_config_int(mrmailbox_t *ths, const char *key, int32_t def)
Get a configuration option.
Definition: mrmailbox.c:1252
int mrmailbox_set_chat_name(mrmailbox_t *mailbox, uint32_t chat_id, const char *new_name)
Set group name.
Definition: mrmailbox.c:3387
char * mrmailbox_create_setup_code(mrmailbox_t *mailbox)
Create random setup code.
Definition: mrmailbox_imex.c:1108
char * mrmailbox_get_contact_encrinfo(mrmailbox_t *mailbox, uint32_t contact_id)
Get encryption info.
Definition: mrmailbox.c:4379
void mrmailbox_imex(mrmailbox_t *mailbox, int what, const char *param1, const char *setup_code)
Import/export things.
Definition: mrmailbox_imex.c:998
char * mrmailbox_get_config(mrmailbox_t *ths, const char *key, const char *def)
Get a configuration option.
Definition: mrmailbox.c:1208
char * mrmailbox_get_msg_info(mrmailbox_t *mailbox, uint32_t msg_id)
Get an informational text for a single message.
Definition: mrmailbox.c:4741
An object representing a single chat in memory.
Definition: mrchat.h:39