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 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__ */
int mrmailbox_add_address_book(mrmailbox_t *mailbox, const char *adr_book)
Add a number of contacts.
Definition: mrmailbox.c:4006
uint32_t mrmailbox_create_group_chat(mrmailbox_t *mailbox, const char *chat_name)
Create a new group chat.
Definition: mrmailbox.c:3318
uint32_t mrmailbox_create_contact(mrmailbox_t *mailbox, const char *name, const char *addr)
Add a single contact.
Definition: mrmailbox.c:3970
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
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:3550
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 a chat object of type mrchat_t by a chat_id.
Definition: mrmailbox.c:1694
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
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:4494
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:2105
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
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
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:181
An object representing a single mailbox.
Definition: mrmailbox.h:178
void mrmailbox_delete_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt)
Delete a list of messages.
Definition: mrmailbox.c:5081
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:2637
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:3580
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
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:182
carray * mrmailbox_get_fresh_msgs(mrmailbox_t *mailbox)
Returns the message IDs of all fresh messages of any chat.
Definition: mrmailbox.c:2037
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
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:1988
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:4275
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
int mrmailbox_configure_and_connect(mrmailbox_t *mailbox)
Configure and connect a mailbox.
Definition: mrmailbox_configure.c:387
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:1774
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:2758
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:4159
int mrmailbox_set_chat_image(mrmailbox_t *mailbox, uint32_t chat_id, const char *new_image)
Set group image.
Definition: mrmailbox.c:3461
carray * mrmailbox_get_known_contacts(mrmailbox_t *mailbox, const char *query)
Returns known and unblocked contacts.
Definition: mrmailbox.c:4061
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
void * m_userdata
the same pointer as given to mrmailbox_new(), may be used by the caller for any purpose ...
Definition: mrmailbox.h:180
int mrmailbox_is_configured(mrmailbox_t *mailbox)
Check if the mailbox is already configured.
Definition: mrmailbox_configure.c:738
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
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
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
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
void mrmailbox_marknoticed_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Mark all message in a chat as noticed.
Definition: mrmailbox.c:1740
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:710
carray * mrmailbox_get_blocked_contacts(mrmailbox_t *mailbox)
Get blocked contacts.
Definition: mrmailbox.c:4125
mrcontact_t * mrmailbox_get_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Get a single contact object.
Definition: mrmailbox.c:4201
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:4249
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:3384
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:4366
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:4728
An object representing a single chat in memory.
Definition: mrchat.h:39