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 11
32 #define MR_VERSION_REVISION 1
33 
34 
150 #include <pthread.h>
151 #include <libetpan/libetpan.h> /* defines uint16_t */
152 #include "mrarray.h"
153 #include "mrchatlist.h"
154 #include "mrchat.h"
155 #include "mrmsg.h"
156 #include "mrcontact.h"
157 #include "mrlot.h"
158 #include "mrparam.h"
159 #include "mrevent.h"
160 
161 typedef struct mrmailbox_t mrmailbox_t;
162 typedef struct mrimap_t mrimap_t;
163 typedef struct mrsmtp_t mrsmtp_t;
164 typedef struct mrsqlite3_t mrsqlite3_t;
165 typedef struct mrjob_t mrjob_t;
166 typedef struct mrmimeparser_t mrmimeparser_t;
167 
168 
184 typedef uintptr_t (*mrmailboxcb_t) (mrmailbox_t*, int event, uintptr_t data1, uintptr_t data2);
185 
186 
194 typedef struct mrmailbox_t
195 {
196  #define MR_MAILBOX_MAGIC 0x11a11807
197  uint32_t m_magic;
199  void* m_userdata;
202  char* m_dbfile;
203  char* m_blobdir;
205  mrsqlite3_t* m_sql;
206  mrimap_t* m_imap;
207  mrsmtp_t* m_smtp;
209  pthread_t m_job_thread;
210  pthread_cond_t m_job_cond;
211  pthread_mutex_t m_job_condmutex;
212  int m_job_condflag;
213  int m_job_do_exit;
215  mrmailboxcb_t m_cb;
217  char* m_os_name;
219  uint32_t m_cmdline_sel_chat_id;
221  int m_wake_lock;
222  pthread_mutex_t m_wake_lock_critical;
224  int m_e2ee_enabled;
226  #define MR_LOG_RINGBUF_SIZE 200
227  pthread_mutex_t m_log_ringbuf_critical;
228  char* m_log_ringbuf[MR_LOG_RINGBUF_SIZE];
230  time_t m_log_ringbuf_times[MR_LOG_RINGBUF_SIZE];
232  int m_log_ringbuf_pos;
234 } mrmailbox_t;
235 
236 
237 /* create/open/connect */
238 mrmailbox_t* mrmailbox_new (mrmailboxcb_t, void* userdata, const char* os_name);
239 void mrmailbox_unref (mrmailbox_t*);
240 
241 int mrmailbox_open (mrmailbox_t*, const char* dbfile, const char* blobdir);
242 void mrmailbox_close (mrmailbox_t*);
243 int mrmailbox_is_open (const mrmailbox_t*);
244 
245 int mrmailbox_set_config (mrmailbox_t*, const char* key, const char* value);
246 char* mrmailbox_get_config (mrmailbox_t*, const char* key, const char* def);
247 int mrmailbox_set_config_int (mrmailbox_t*, const char* key, int32_t value);
248 int32_t mrmailbox_get_config_int (mrmailbox_t*, const char* key, int32_t def);
249 char* mrmailbox_get_version_str (void);
250 
251 int mrmailbox_configure_and_connect(mrmailbox_t*);
252 void mrmailbox_stop_ongoing_process(mrmailbox_t*);
253 int mrmailbox_is_configured (mrmailbox_t*);
254 
255 void mrmailbox_connect (mrmailbox_t*);
256 void mrmailbox_disconnect (mrmailbox_t*);
257 
258 char* mrmailbox_get_info (mrmailbox_t*);
259 
260 
261 /* Handle chatlists */
262 #define MR_GCL_ARCHIVED_ONLY 0x01
263 #define MR_GCL_NO_SPECIALS 0x02
264 mrchatlist_t* mrmailbox_get_chatlist (mrmailbox_t*, int flags, const char* query);
265 
266 
267 /* Handle chats */
268 uint32_t mrmailbox_create_chat_by_contact_id (mrmailbox_t*, uint32_t contact_id);
269 uint32_t mrmailbox_get_chat_id_by_contact_id (mrmailbox_t*, uint32_t contact_id);
270 
271 uint32_t mrmailbox_send_text_msg (mrmailbox_t*, uint32_t chat_id, const char* text_to_send);
272 uint32_t mrmailbox_send_image_msg (mrmailbox_t*, uint32_t chat_id, const char* file, const char* filemime, int width, int height);
273 uint32_t mrmailbox_send_video_msg (mrmailbox_t*, uint32_t chat_id, const char* file, const char* filemime, int width, int height, int duration);
274 uint32_t mrmailbox_send_voice_msg (mrmailbox_t*, uint32_t chat_id, const char* file, const char* filemime, int duration);
275 uint32_t mrmailbox_send_audio_msg (mrmailbox_t*, uint32_t chat_id, const char* file, const char* filemime, int duration, const char* author, const char* trackname);
276 uint32_t mrmailbox_send_file_msg (mrmailbox_t*, uint32_t chat_id, const char* file, const char* filemime);
277 uint32_t mrmailbox_send_vcard_msg (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
278 void mrmailbox_set_draft (mrmailbox_t*, uint32_t chat_id, const char*);
279 
280 #define MR_GCM_ADDDAYMARKER 0x01
281 mrarray_t* mrmailbox_get_chat_msgs (mrmailbox_t*, uint32_t chat_id, uint32_t flags, uint32_t marker1before);
282 int mrmailbox_get_total_msg_count (mrmailbox_t*, uint32_t chat_id);
283 int mrmailbox_get_fresh_msg_count (mrmailbox_t*, uint32_t chat_id);
284 mrarray_t* mrmailbox_get_fresh_msgs (mrmailbox_t*);
285 void mrmailbox_marknoticed_chat (mrmailbox_t*, uint32_t chat_id);
286 mrarray_t* mrmailbox_get_chat_media (mrmailbox_t*, uint32_t chat_id, int msg_type, int or_msg_type);
287 uint32_t mrmailbox_get_next_media (mrmailbox_t*, uint32_t curr_msg_id, int dir);
288 
289 void mrmailbox_archive_chat (mrmailbox_t*, uint32_t chat_id, int archive);
290 void mrmailbox_delete_chat (mrmailbox_t*, uint32_t chat_id);
291 
292 mrarray_t* mrmailbox_get_chat_contacts (mrmailbox_t*, uint32_t chat_id);
293 mrarray_t* mrmailbox_search_msgs (mrmailbox_t*, uint32_t chat_id, const char* query);
294 
295 mrchat_t* mrmailbox_get_chat (mrmailbox_t*, uint32_t chat_id);
296 
297 
298 /* Handle group chats */
299 uint32_t mrmailbox_create_group_chat (mrmailbox_t*, const char* name);
300 int mrmailbox_is_contact_in_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
301 int mrmailbox_add_contact_to_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
302 int mrmailbox_remove_contact_from_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
303 int mrmailbox_set_chat_name (mrmailbox_t*, uint32_t chat_id, const char* name);
304 int mrmailbox_set_chat_profile_image (mrmailbox_t*, uint32_t chat_id, const char* image);
305 
306 
307 /* Handle messages */
308 char* mrmailbox_get_msg_info (mrmailbox_t*, uint32_t msg_id);
309 void mrmailbox_delete_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt);
310 void mrmailbox_forward_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt, uint32_t chat_id);
311 void mrmailbox_marknoticed_contact (mrmailbox_t*, uint32_t contact_id);
312 void mrmailbox_markseen_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt);
313 void mrmailbox_star_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt, int star);
314 mrmsg_t* mrmailbox_get_msg (mrmailbox_t*, uint32_t msg_id);
315 
316 
317 /* Handle contacts */
318 uint32_t mrmailbox_create_contact (mrmailbox_t*, const char* name, const char* addr);
319 int mrmailbox_add_address_book (mrmailbox_t*, const char*);
320 mrarray_t* mrmailbox_get_known_contacts (mrmailbox_t*, const char* query);
321 int mrmailbox_get_blocked_count (mrmailbox_t*);
323 void mrmailbox_block_contact (mrmailbox_t*, uint32_t contact_id, int block);
324 char* mrmailbox_get_contact_encrinfo (mrmailbox_t*, uint32_t contact_id);
325 int mrmailbox_delete_contact (mrmailbox_t*, uint32_t contact_id);
326 mrcontact_t* mrmailbox_get_contact (mrmailbox_t*, uint32_t contact_id);
327 
328 
329 /* Import/export and Tools */
330 #define MR_IMEX_EXPORT_SELF_KEYS 1 /* param1 is a directory where the keys are written to */
331 #define MR_IMEX_IMPORT_SELF_KEYS 2 /* param1 is a directory where the keys are searched in and read from */
332 #define MR_IMEX_EXPORT_BACKUP 11 /* param1 is a directory where the backup is written to */
333 #define MR_IMEX_IMPORT_BACKUP 12 /* param1 is the file with the backup to import */
334 #define MR_BAK_PREFIX "delta-chat"
335 #define MR_BAK_SUFFIX "bak"
336 int mrmailbox_imex (mrmailbox_t*, int what, const char* param1, const char* param2);
337 char* mrmailbox_imex_has_backup (mrmailbox_t*, const char* dir);
338 int mrmailbox_check_password (mrmailbox_t*, const char* pw);
339 char* mrmailbox_initiate_key_transfer(mrmailbox_t*);
340 int mrmailbox_continue_key_transfer(mrmailbox_t*, uint32_t msg_id, const char* setup_code);
341 void mrmailbox_heartbeat (mrmailbox_t*);
342 
343 
344 /* logging */
345 void mrmailbox_log_error (mrmailbox_t*, int code, const char* msg, ...);
346 void mrmailbox_log_error_if (int* condition, mrmailbox_t*, int code, const char* msg, ...);
347 void mrmailbox_log_warning (mrmailbox_t*, int code, const char* msg, ...);
348 void mrmailbox_log_info (mrmailbox_t*, int code, const char* msg, ...);
349 void mrmailbox_log_vprintf (mrmailbox_t*, int event, int code, const char* msg, va_list);
350 int mrmailbox_get_thread_index (void);
351 
352 
353 /* error codes */
354 #define MR_ERR_SELF_NOT_IN_GROUP 1
355 #define MR_ERR_NONETWORK 2
356 
357 
358 /* deprecated functions */
359 int mrchat_set_draft (mrchat_t*, const char* msg); /* deprecated - use mrmailbox_set_draft() instead */
360 #define mrpoortext_t mrlot_t
361 #define mrpoortext_unref mrlot_unref
362 #define mrmailbox_imex_cancel mrmailbox_stop_ongoing_process
363 #define mrmailbox_configure_cancel mrmailbox_stop_ongoing_process
364 
365 
366 /* library-internal */
367 uint32_t mrmailbox_send_msg_object (mrmailbox_t*, uint32_t chat_id, mrmsg_t*);
368 void mrmailbox_connect_to_imap (mrmailbox_t*, mrjob_t*);
369 void mrmailbox_wake_lock (mrmailbox_t*);
370 void mrmailbox_wake_unlock (mrmailbox_t*);
371 int mrmailbox_poke_eml_file (mrmailbox_t*, const char* file);
372 int mrmailbox_is_reply_to_known_message__ (mrmailbox_t*, mrmimeparser_t*);
373 int mrmailbox_is_reply_to_messenger_message__ (mrmailbox_t*, mrmimeparser_t*);
374 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);
375 void mrmailbox_add_or_lookup_contacts_by_mailbox_list__(mrmailbox_t* ths, struct mailimf_mailbox_list* mb_list, int origin, mrarray_t* ids, int* check_self);
376 void mrmailbox_add_or_lookup_contacts_by_address_list__(mrmailbox_t* ths, struct mailimf_address_list* adr_list, int origin, mrarray_t* ids, int* check_self);
377 int mrmailbox_get_archived_count__ (mrmailbox_t*);
378 int mrmailbox_reset_tables (mrmailbox_t*, int bits); /* reset tables but leaves server configuration, 1=jobs, 2=e2ee, 8=rest but server config */
379 size_t mrmailbox_get_real_contact_cnt__ (mrmailbox_t*);
380 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);
381 int mrmailbox_get_contact_origin__ (mrmailbox_t*, uint32_t id, int* ret_blocked);
382 int mrmailbox_is_contact_blocked__ (mrmailbox_t*, uint32_t id);
383 int mrmailbox_real_contact_exists__ (mrmailbox_t*, uint32_t id);
384 int mrmailbox_contact_addr_equals__ (mrmailbox_t*, uint32_t contact_id, const char* other_addr);
385 void mrmailbox_scaleup_contact_origin__ (mrmailbox_t*, uint32_t contact_id, int origin);
386 void mrmailbox_unarchive_chat__ (mrmailbox_t*, uint32_t chat_id);
387 size_t mrmailbox_get_chat_cnt__ (mrmailbox_t*);
388 uint32_t mrmailbox_create_or_lookup_nchat_by_contact_id__ (mrmailbox_t*, uint32_t contact_id);
389 uint32_t mrmailbox_lookup_real_nchat_by_contact_id__ (mrmailbox_t*, uint32_t contact_id);
390 int mrmailbox_get_total_msg_count__ (mrmailbox_t*, uint32_t chat_id);
391 int mrmailbox_get_fresh_msg_count__ (mrmailbox_t*, uint32_t chat_id);
392 uint32_t mrmailbox_get_last_deaddrop_fresh_msg__ (mrmailbox_t*);
393 void mrmailbox_send_msg_to_smtp (mrmailbox_t*, mrjob_t*);
394 void mrmailbox_send_msg_to_imap (mrmailbox_t*, mrjob_t*);
395 int mrmailbox_add_contact_to_chat__ (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
396 int mrmailbox_is_contact_in_chat__ (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
397 int mrmailbox_get_chat_contact_count__ (mrmailbox_t*, uint32_t chat_id);
398 int mrmailbox_group_explicitly_left__ (mrmailbox_t*, const char* grpid);
399 void mrmailbox_set_group_explicitly_left__ (mrmailbox_t*, const char* grpid);
400 size_t mrmailbox_get_real_msg_cnt__ (mrmailbox_t*); /* the number of messages assigned to real chat (!=deaddrop, !=trash) */
401 size_t mrmailbox_get_deaddrop_msg_cnt__ (mrmailbox_t*);
402 int mrmailbox_rfc724_mid_cnt__ (mrmailbox_t*, const char* rfc724_mid);
403 int mrmailbox_rfc724_mid_exists__ (mrmailbox_t*, const char* rfc724_mid, char** ret_server_folder, uint32_t* ret_server_uid);
404 void mrmailbox_update_server_uid__ (mrmailbox_t*, const char* rfc724_mid, const char* server_folder, uint32_t server_uid);
405 void mrmailbox_update_msg_chat_id__ (mrmailbox_t*, uint32_t msg_id, uint32_t chat_id);
406 void mrmailbox_update_msg_state__ (mrmailbox_t*, uint32_t msg_id, int state);
407 void mrmailbox_delete_msg_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
408 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 */
409 void mrmailbox_send_mdn (mrmailbox_t*, mrjob_t* job);
410 void mrmailbox_markseen_msg_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
411 void mrmailbox_markseen_mdn_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
412 
413 
414 /* library private: end-to-end-encryption */
415 #define MR_E2EE_DEFAULT_ENABLED 1
416 #define MR_MDNS_DEFAULT_ENABLED 1
417 
418 typedef struct mrmailbox_e2ee_helper_t {
419  int m_encryption_successfull;
420  void* m_cdata_to_free;
421 } mrmailbox_e2ee_helper_t;
422 
423 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*);
424 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 */
425 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! */
426 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 */
427 char* mrmailbox_create_setup_code (mrmailbox_t*);
428 int mrmailbox_render_setup_file (mrmailbox_t* mailbox, const char* passphrase, char** ret_msg);
429 
430 extern int mr_shall_stop_ongoing;
431 int mrmailbox_alloc_ongoing (mrmailbox_t*);
432 void mrmailbox_free_ongoing (mrmailbox_t*);
433 
434 
435 #ifdef __cplusplus
436 } /* /extern "C" */
437 #endif
438 #endif /* __MRMAILBOX_H__ */
int mrmailbox_add_address_book(mrmailbox_t *mailbox, const char *adr_book)
Add a number of contacts.
Definition: mrmailbox.c:4363
uint32_t mrmailbox_create_group_chat(mrmailbox_t *mailbox, const char *chat_name)
Create a new group chat.
Definition: mrmailbox.c:3645
uint32_t mrmailbox_create_contact(mrmailbox_t *mailbox, const char *name, const char *addr)
Add a single contact.
Definition: mrmailbox.c:4320
uint32_t mrmailbox_send_text_msg(mrmailbox_t *mailbox, uint32_t chat_id, const char *text_to_send)
Send a simple text message a given chat.
Definition: mrmailbox.c:3267
void mrmailbox_close(mrmailbox_t *mailbox)
Close mailbox database.
Definition: mrmailbox.c:1072
char * mrmailbox_initiate_key_transfer(mrmailbox_t *mailbox)
Initiate Autocrypt Key Transfer.
Definition: mrmailbox_imex.c:470
mrmailbox_t * mrmailbox_new(mrmailboxcb_t cb, void *userdata, const char *os_name)
Create a new mailbox object.
Definition: mrmailbox.c:888
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:3883
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:1700
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:4004
int mrmailbox_open(mrmailbox_t *mailbox, const char *dbfile, const char *blobdir)
Open mailbox database.
Definition: mrmailbox.c:1007
An object representing a single contact in memory.
Definition: mrcontact.h:38
An object containing a simple array.
Definition: mrarray.h:39
mrarray_t * 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:2122
uint32_t mrmailbox_send_file_msg(mrmailbox_t *mailbox, uint32_t chat_id, const char *file, const char *filemime)
Send a document to a chat.
Definition: mrmailbox.c:3482
int mrmailbox_delete_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Delete a contact.
Definition: mrmailbox.c:4874
An object representing a single chatlist in memory.
Definition: mrchatlist.h:43
void mrmailbox_heartbeat(mrmailbox_t *ths)
Stay alive.
Definition: mrmailbox.c:1620
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:5323
int mrmailbox_set_config(mrmailbox_t *ths, const char *key, const char *value)
Configure the mailbox.
Definition: mrmailbox.c:1173
An object representing a single mailbox.
Definition: mrmailbox.h:194
void mrmailbox_delete_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt)
Delete messages.
Definition: mrmailbox.c:5465
uint32_t mrmailbox_send_video_msg(mrmailbox_t *mailbox, uint32_t chat_id, const char *file, const char *filemime, int width, int height, int duration)
Send an video to a chat.
Definition: mrmailbox.c:3353
int mrmailbox_is_open(const mrmailbox_t *mailbox)
Check if the mailbox database is open.
Definition: mrmailbox.c:1106
void mrmailbox_archive_chat(mrmailbox_t *mailbox, uint32_t chat_id, int archive)
Archive or unarchive a chat.
Definition: mrmailbox.c:2663
char * mrmailbox_get_info(mrmailbox_t *mailbox)
Get information about the mailbox.
Definition: mrmailbox.c:1274
mrarray_t * mrmailbox_get_blocked_contacts(mrmailbox_t *mailbox)
Get blocked contacts.
Definition: mrmailbox.c:4504
mrarray_t * mrmailbox_get_known_contacts(mrmailbox_t *mailbox, const char *query)
Returns known and unblocked contacts.
Definition: mrmailbox.c:4418
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:3919
uint32_t mrmailbox_get_next_media(mrmailbox_t *mailbox, uint32_t curr_msg_id, int dir)
Get next/previous message of the same type.
Definition: mrmailbox.c:1929
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:1595
uint32_t mrmailbox_send_voice_msg(mrmailbox_t *mailbox, uint32_t chat_id, const char *file, const char *filemime, int duration)
Send a voice message to a chat.
Definition: mrmailbox.c:3397
void mrmailbox_stop_ongoing_process(mrmailbox_t *mailbox)
Signal an ongoing process to stop.
Definition: mrmailbox_configure.c:789
void mrmailbox_connect(mrmailbox_t *mailbox)
Connect to the mailbox using the configured settings.
Definition: mrmailbox.c:1568
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:2595
uint32_t mrmailbox_send_vcard_msg(mrmailbox_t *mailbox, uint32_t chat_id, uint32_t contact_id)
Send foreign contact data to a chat.
Definition: mrmailbox.c:3530
void mrmailbox_unref(mrmailbox_t *mailbox)
Free a mailbox object.
Definition: mrmailbox.c:946
void mrmailbox_block_contact(mrmailbox_t *mailbox, uint32_t contact_id, int new_blocking)
Block or unblock a contact.
Definition: mrmailbox.c:4649
int mrmailbox_continue_key_transfer(mrmailbox_t *mailbox, uint32_t msg_id, const char *setup_code)
Continue the Autocrypt Key Transfer on another device.
Definition: mrmailbox_imex.c:574
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:184
int mrmailbox_configure_and_connect(mrmailbox_t *mailbox)
Configure and connect a mailbox.
Definition: mrmailbox_configure.c:393
mrchatlist_t * mrmailbox_get_chatlist(mrmailbox_t *mailbox, int listflags, const char *query)
Get a list of chats.
Definition: mrmailbox.c:1652
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:1784
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:2623
void mrmailbox_delete_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Delete a chat.
Definition: mrmailbox.c:2784
void mrmailbox_set_draft(mrmailbox_t *mailbox, uint32_t chat_id, const char *msg)
Save a draft for a chat.
Definition: mrmailbox.c:2375
int mrmailbox_imex(mrmailbox_t *mailbox, int what, const char *param1, const char *param2)
Import/export things.
Definition: mrmailbox_imex.c:1111
int mrmailbox_get_blocked_count(mrmailbox_t *mailbox)
Get the number of blocked contacts.
Definition: mrmailbox.c:4538
mrarray_t * mrmailbox_search_msgs(mrmailbox_t *mailbox, uint32_t chat_id, const char *query)
Search messages containing the given query string.
Definition: mrmailbox.c:2226
uint32_t mrmailbox_send_image_msg(mrmailbox_t *mailbox, uint32_t chat_id, const char *file, const char *filemime, int width, int height)
Send an image to a chat.
Definition: mrmailbox.c:3308
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:5066
void * m_userdata
Use data, may be used for any purpose.
Definition: mrmailbox.h:199
int mrmailbox_is_configured(mrmailbox_t *mailbox)
Check if the mailbox is already configured.
Definition: mrmailbox_configure.c:705
int mrmailbox_set_chat_profile_image(mrmailbox_t *mailbox, uint32_t chat_id, const char *new_image)
Set group profile image.
Definition: mrmailbox.c:3794
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:1815
void mrmailbox_forward_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt, uint32_t chat_id)
Forward messages to another chat.
Definition: mrmailbox.c:5237
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:5606
mrarray_t * mrmailbox_get_chat_contacts(mrmailbox_t *mailbox, uint32_t chat_id)
Get contact IDs belonging to a chat.
Definition: mrmailbox.c:2005
void mrmailbox_marknoticed_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Mark all message in a chat as noticed.
Definition: mrmailbox.c:1750
char * mrmailbox_imex_has_backup(mrmailbox_t *mailbox, const char *dir_name)
Check if there is a backup file.
Definition: mrmailbox_imex.c:1237
mrarray_t * mrmailbox_get_fresh_msgs(mrmailbox_t *mailbox)
Returns the message IDs of all fresh messages of any chat.
Definition: mrmailbox.c:2054
mrcontact_t * mrmailbox_get_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Get a single contact object.
Definition: mrmailbox.c:4584
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:1303
void mrmailbox_marknoticed_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Mark all messages send by the given contact as noticed.
Definition: mrmailbox.c:4623
int mrmailbox_set_config_int(mrmailbox_t *ths, const char *key, int32_t value)
Configure the mailbox.
Definition: mrmailbox.c:1226
int32_t mrmailbox_get_config_int(mrmailbox_t *ths, const char *key, int32_t def)
Get a configuration option.
Definition: mrmailbox.c:1248
int mrmailbox_set_chat_name(mrmailbox_t *mailbox, uint32_t chat_id, const char *new_name)
Set group name.
Definition: mrmailbox.c:3713
char * mrmailbox_get_contact_encrinfo(mrmailbox_t *mailbox, uint32_t contact_id)
Get encryption info for a contact.
Definition: mrmailbox.c:4740
mrarray_t * 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:1895
uint32_t mrmailbox_send_audio_msg(mrmailbox_t *mailbox, uint32_t chat_id, const char *file, const char *filemime, int duration, const char *author, const char *trackname)
Send an audio file to a chat.
Definition: mrmailbox.c:3440
char * mrmailbox_get_config(mrmailbox_t *ths, const char *key, const char *def)
Get a configuration option.
Definition: mrmailbox.c:1204
char * mrmailbox_get_msg_info(mrmailbox_t *mailbox, uint32_t msg_id)
Get an informational text for a single message.
Definition: mrmailbox.c:5112
An object representing a single chat in memory.
Definition: mrchat.h:39