diff --git a/docs/html/index.html b/docs/html/index.html index b89f5173..d29b4141 100644 --- a/docs/html/index.html +++ b/docs/html/index.html @@ -83,7 +83,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');

Let's start.

First of all, you have to define a function that is called by the library on specific events (eg. when the configuration is done or when fresh messages arrive). Your function should look like the following:

#include <mrmailbox.h>
uintptr_t my_delta_handler(mrmailbox_t* nb, int event, uintptr_t data1, uintptr_t data2)
{
return 0; // for unhandled events, it is always safe to return 0
}

After that, you can create and configure a mrmailbox_t object easily as follows:

-
mrmailbox_t* mb = mrmailbox_new(my_delta_handler, NULL, NULL);
mrmailbox_set_config(mb, "addr", "alice@delta.chat"); // use some real test credentials here
mrmailbox_set_config(mb, "mail_pw", "***");
mrmailbox_configure_and_connect(mb);

If this works, you'll receive the event MR_EVENT_CONFIGURE_ENDED with data1 set to 1 - and you can start sending your first message:

+
mrmailbox_t* mb = mrmailbox_new(my_delta_handler, NULL, NULL);
mrmailbox_set_config(mb, "addr", "alice@delta.chat"); // use some real test credentials here
mrmailbox_set_config(mb, "mail_pw", "***");
mrmailbox_configure_and_connect(mb);

If this works, you'll receive the event MR_EVENT_CONFIGURE_ENDED with data1 set to 1 - and you can start sending your first message:

uint32_t contact_id = mrmailbox_create_contact(mb, "bob@delta.chat"); // use a real testing address here
uint32_t chat_id = mrmailbox_create_chat_by_contact_id(mb, contact_id);
mrmailbox_send_text_msg(mb, chat_id, "Hi, here is my first message!");

Now, go to the testing address (bob) and you should have received a normal email. Answer this email in any email program with "Got it!" and you will get the message from delta as follows:

carray* msglist = mrmailbox_get_chat_msgs(mb, chat_id, 0, 0);
for( size_t i = 0; i < carray_count(msglist); i++ )
{
uint32_t msg_id = carray_get_uint32(msglist, i);
mrmsg_t* msg = mrmailbox_get_msg(mb, msg_id);
printf("message %i: %s\n", i+1, msg->m_text);
}

This will output the following two lines:

Message 1: Hi, here is my first message!
Message 2: Got it!

I think, you got the idea. For further reading, please dive into the mrmailbox_t class.

diff --git a/docs/html/mrevent_8h.html b/docs/html/mrevent_8h.html index 25b3336e..e86565fa 100644 --- a/docs/html/mrevent_8h.html +++ b/docs/html/mrevent_8h.html @@ -120,29 +120,23 @@ Macros #define MR_EVENT_MSG_READ   2015  A single message is read by the receiver (state changed from MR_STATE_OUT_DELIVERED to MR_STATE_OUT_MDN_RCVD, see mrmsg_t::m_state). More...
  - -#define MR_EVENT_CHAT_MODIFIED   2020 - group name/image changed or members added/removed
+#define MR_EVENT_CHAT_MODIFIED   2020 + Group name/image changed or members added/removed. More...
  - -#define MR_EVENT_CONTACTS_CHANGED   2030 - contact(s) created, renamed, blocked or deleted
+#define MR_EVENT_CONTACTS_CHANGED   2030 + Contact(s) created, renamed, blocked or deleted. More...
  - -#define MR_EVENT_CONFIGURE_ENDED   2040 - connection state changed, data1=0:failed-not-connected, 1:configured-and-connected
+#define MR_EVENT_CONFIGURE_ENDED   2040 + Configurartion enden. More...
  - -#define MR_EVENT_CONFIGURE_PROGRESS   2041 - data1=percent
+#define MR_EVENT_CONFIGURE_PROGRESS   2041 + Inform about the configuration progress. More...
  - -#define MR_EVENT_IMEX_ENDED   2050 - mrmailbox_imex() done: data1=0:failed, 1=success
+#define MR_EVENT_IMEX_ENDED   2050 + Import/export done. More...
  - -#define MR_EVENT_IMEX_PROGRESS   2051 - data1=permille
+#define MR_EVENT_IMEX_PROGRESS   2051 + Inform about the import/export progress. More...
  #define MR_EVENT_IMEX_FILE_WRITTEN   2052  file written, event may be needed to make the file public to some system services. More...
@@ -171,6 +165,94 @@ Macros

Detailed Description

The following constants are used as events reported to the callback given to mrmailbox_new().

Macro Definition Documentation

+ +
+
+ + + + +
#define MR_EVENT_CHAT_MODIFIED   2020
+
+ +

Group name/image changed or members added/removed.

+
Parameters
+ + + +
data1chat_id
data20
+
+
+
Returns
0
+ +
+
+ +
+
+ + + + +
#define MR_EVENT_CONFIGURE_ENDED   2040
+
+ +

Configurartion enden.

+

You'll get this event from a call to mrmailbox_configure_and_connect()

Parameters
+ + + +
data10=failed-not-connected, 1=configured-and-connected
data20
+
+
+
Returns
0
+ +
+
+ +
+
+ + + + +
#define MR_EVENT_CONFIGURE_PROGRESS   2041
+
+ +

Inform about the configuration progress.

+

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

Parameters
+ + + +
data1permille
data20
+
+
+
Returns
0
+ +
+
+ +
+
+ + + + +
#define MR_EVENT_CONTACTS_CHANGED   2030
+
+ +

Contact(s) created, renamed, blocked or deleted.

+
Parameters
+ + + +
data10
data20
+
+
+
Returns
0
+ +
+
@@ -191,6 +273,28 @@ Macros
Returns
0
+
+
+ +
+
+ + + + +
#define MR_EVENT_IMEX_ENDED   2050
+
+ +

Import/export done.

+

You'll get this event from a call to mrmailbox_imex(). As we want to get rid of the threads in the core, this event may be deleted.

Parameters
+ + + +
data10:failed, 1=success
data20
+
+
+
Returns
0
+
@@ -206,6 +310,28 @@ Macros

file written, event may be needed to make the file public to some system services.

data1=file name, data2=mime type

+ + + +
+
+ + + + +
#define MR_EVENT_IMEX_PROGRESS   2051
+
+ +

Inform about the import/export progress.

+
Parameters
+ + + +
data1permille
data20
+
+
+
Returns
0
+
diff --git a/docs/html/mrevent_8h_source.html b/docs/html/mrevent_8h_source.html index 65ce5472..be90241b 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 
44 #define MR_EVENT_INFO 100
45 
46 
55 #define MR_EVENT_WARNING 300
56 
57 
65 #define MR_EVENT_ERROR 400
66 
67 
76 #define MR_EVENT_MSGS_CHANGED 2000
77 
78 
86 #define MR_EVENT_INCOMING_MSG 2005
87 
88 
96 #define MR_EVENT_MSG_DELIVERED 2010
97 
98 
106 #define MR_EVENT_MSG_READ 2015
107 
108 
110 #define MR_EVENT_CHAT_MODIFIED 2020
111 
112 
114 #define MR_EVENT_CONTACTS_CHANGED 2030
115 
116 
119 #define MR_EVENT_CONFIGURE_ENDED 2040
120 
121 
123 #define MR_EVENT_CONFIGURE_PROGRESS 2041
124 
125 
128 #define MR_EVENT_IMEX_ENDED 2050
129 
130 
132 #define MR_EVENT_IMEX_PROGRESS 2051
133 
134 
137 #define MR_EVENT_IMEX_FILE_WRITTEN 2052
138 
139 
140 /* The following events are functions that should be provided by the frontends */
141 
142 
145 #define MR_EVENT_IS_ONLINE 2080
146 
147 
150 #define MR_EVENT_GET_STRING 2091
151 
152 
155 #define MR_EVENT_GET_QUANTITY_STRING 2092
156 
157 
160 #define MR_EVENT_HTTP_GET 2100
161 
164 #define MR_EVENT_WAKE_LOCK 2110
165 
166 
167 #ifdef __cplusplus
168 } /* /extern "C" */
169 #endif
170 #endif /* __MREVENT_H__ */
171 
+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 
44 #define MR_EVENT_INFO 100
45 
46 
55 #define MR_EVENT_WARNING 300
56 
57 
65 #define MR_EVENT_ERROR 400
66 
67 
76 #define MR_EVENT_MSGS_CHANGED 2000
77 
78 
86 #define MR_EVENT_INCOMING_MSG 2005
87 
88 
96 #define MR_EVENT_MSG_DELIVERED 2010
97 
98 
106 #define MR_EVENT_MSG_READ 2015
107 
108 
115 #define MR_EVENT_CHAT_MODIFIED 2020
116 
117 
124 #define MR_EVENT_CONTACTS_CHANGED 2030
125 
126 
134 #define MR_EVENT_CONFIGURE_ENDED 2040
135 
136 
144 #define MR_EVENT_CONFIGURE_PROGRESS 2041
145 
146 
154 #define MR_EVENT_IMEX_ENDED 2050
155 
156 
163 #define MR_EVENT_IMEX_PROGRESS 2051
164 
165 
168 #define MR_EVENT_IMEX_FILE_WRITTEN 2052
169 
170 
171 /* The following events are functions that should be provided by the frontends */
172 
173 
176 #define MR_EVENT_IS_ONLINE 2080
177 
178 
181 #define MR_EVENT_GET_STRING 2091
182 
183 
186 #define MR_EVENT_GET_QUANTITY_STRING 2092
187 
188 
191 #define MR_EVENT_HTTP_GET 2100
192 
195 #define MR_EVENT_WAKE_LOCK 2110
196 
197 
198 #ifdef __cplusplus
199 } /* /extern "C" */
200 #endif
201 #endif /* __MREVENT_H__ */
202 
Generated by   diff --git a/docs/html/mrmailbox_8h_source.html b/docs/html/mrmailbox_8h_source.html index fe3b3836..6274525e 100644 --- a/docs/html/mrmailbox_8h_source.html +++ b/docs/html/mrmailbox_8h_source.html @@ -89,7 +89,7 @@ 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 7
33 
34 
137 #include <libetpan/libetpan.h> /* defines uint16_t and carray */
138 #include "mrchatlist.h"
139 #include "mrchat.h"
140 #include "mrmsg.h"
141 #include "mrcontact.h"
142 #include "mrpoortext.h"
143 #include "mrparam.h"
144 #include "mrevent.h"
145 
146 typedef struct mrmailbox_t mrmailbox_t;
147 typedef struct mrimap_t mrimap_t;
148 typedef struct mrsmtp_t mrsmtp_t;
149 typedef struct mrsqlite3_t mrsqlite3_t;
150 typedef struct mrjob_t mrjob_t;
151 typedef struct mrmimeparser_t mrmimeparser_t;
152 
153 
169 typedef uintptr_t (*mrmailboxcb_t) (mrmailbox_t*, int event, uintptr_t data1, uintptr_t data2);
170 
171 
179 typedef struct mrmailbox_t
180 {
181  void* m_userdata;
182  char* m_dbfile;
183  char* m_blobdir;
186  mrsqlite3_t* m_sql;
187  mrimap_t* m_imap;
188  mrsmtp_t* m_smtp;
190  pthread_t m_job_thread;
191  pthread_cond_t m_job_cond;
192  pthread_mutex_t m_job_condmutex;
193  int m_job_condflag;
194  int m_job_do_exit;
196  mrmailboxcb_t m_cb;
198  char* m_os_name;
200  uint32_t m_cmdline_sel_chat_id;
202  int m_wake_lock;
203  pthread_mutex_t m_wake_lock_critical;
205  int m_e2ee_enabled;
207  #define MR_LOG_RINGBUF_SIZE 200
208  pthread_mutex_t m_log_ringbuf_critical;
209  char* m_log_ringbuf[MR_LOG_RINGBUF_SIZE];
211  time_t m_log_ringbuf_times[MR_LOG_RINGBUF_SIZE];
213  int m_log_ringbuf_pos;
215 } mrmailbox_t;
216 
217 
218 /* create/open/connect */
219 mrmailbox_t* mrmailbox_new (mrmailboxcb_t, void* userdata, const char* os_name);
220 void mrmailbox_unref (mrmailbox_t*);
221 
222 int mrmailbox_open (mrmailbox_t*, const char* dbfile, const char* blobdir);
223 void mrmailbox_close (mrmailbox_t*);
224 int mrmailbox_is_open (const mrmailbox_t*);
225 
226 int mrmailbox_set_config (mrmailbox_t*, const char* key, const char* value);
227 char* mrmailbox_get_config (mrmailbox_t*, const char* key, const char* def);
228 int mrmailbox_set_config_int (mrmailbox_t*, const char* key, int32_t value);
229 int32_t mrmailbox_get_config_int (mrmailbox_t*, const char* key, int32_t def);
230 char* mrmailbox_get_blobdir (mrmailbox_t*);
231 char* mrmailbox_get_version_str (void);
232 
233 void mrmailbox_configure_and_connect(mrmailbox_t*);
234 void mrmailbox_configure_cancel (mrmailbox_t*);
235 int mrmailbox_is_configured (mrmailbox_t*);
236 
237 void mrmailbox_connect (mrmailbox_t*);
238 void mrmailbox_disconnect (mrmailbox_t*);
239 
240 int mrmailbox_restore (mrmailbox_t*, time_t seconds_to_restore); /* not really implemented */
241 char* mrmailbox_get_info (mrmailbox_t*);
242 
243 
244 /* Handle chatlists */
245 #define MR_GCL_ARCHIVED_ONLY 0x01
246 #define MR_GCL_NO_SPECIALS 0x02
247 mrchatlist_t* mrmailbox_get_chatlist (mrmailbox_t*, int flags, const char* query);
248 
249 
250 /* Handle chats */
251 uint32_t mrmailbox_create_chat_by_contact_id (mrmailbox_t*, uint32_t contact_id);
252 uint32_t mrmailbox_get_chat_id_by_contact_id (mrmailbox_t*, uint32_t contact_id);
253 
254 uint32_t mrmailbox_send_text_msg (mrmailbox_t*, uint32_t chat_id, const char* text_to_send);
255 uint32_t mrmailbox_send_msg (mrmailbox_t*, uint32_t chat_id, mrmsg_t*);
256 void mrmailbox_set_draft (mrmailbox_t*, uint32_t chat_id, const char*);
257 
258 #define MR_GCM_ADDDAYMARKER 0x01
259 carray* mrmailbox_get_chat_msgs (mrmailbox_t*, uint32_t chat_id, uint32_t flags, uint32_t marker1before);
260 int mrmailbox_get_total_msg_count (mrmailbox_t*, uint32_t chat_id);
261 int mrmailbox_get_fresh_msg_count (mrmailbox_t*, uint32_t chat_id);
262 carray* mrmailbox_get_fresh_msgs (mrmailbox_t*);
263 void mrmailbox_marknoticed_chat (mrmailbox_t*, uint32_t chat_id);
264 carray* mrmailbox_get_chat_media (mrmailbox_t*, uint32_t chat_id, int msg_type, int or_msg_type);
265 uint32_t mrmailbox_get_next_media (mrmailbox_t*, uint32_t curr_msg_id, int dir);
266 
267 void mrmailbox_archive_chat (mrmailbox_t*, uint32_t chat_id, int archive);
268 void mrmailbox_delete_chat (mrmailbox_t*, uint32_t chat_id);
269 
270 carray* mrmailbox_get_chat_contacts (mrmailbox_t*, uint32_t chat_id);
271 carray* mrmailbox_search_msgs (mrmailbox_t*, uint32_t chat_id, const char* query);
272 
273 mrchat_t* mrmailbox_get_chat (mrmailbox_t*, uint32_t chat_id);
274 
275 
276 /* Handle group chats */
277 uint32_t mrmailbox_create_group_chat (mrmailbox_t*, const char* name);
278 int mrmailbox_is_contact_in_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
279 int mrmailbox_add_contact_to_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
280 int mrmailbox_remove_contact_from_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
281 int mrmailbox_set_chat_name (mrmailbox_t*, uint32_t chat_id, const char* name);
282 int mrmailbox_set_chat_image (mrmailbox_t*, uint32_t chat_id, const char* image);
283 
284 
285 /* Handle messages */
286 char* mrmailbox_get_msg_info (mrmailbox_t*, uint32_t msg_id);
287 void mrmailbox_delete_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt);
288 void mrmailbox_forward_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt, uint32_t chat_id);
289 void mrmailbox_marknoticed_contact (mrmailbox_t*, uint32_t contact_id);
290 void mrmailbox_markseen_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt);
291 void mrmailbox_star_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt, int star);
292 mrmsg_t* mrmailbox_get_msg (mrmailbox_t*, uint32_t msg_id);
293 
294 
295 /* Handle contacts */
296 uint32_t mrmailbox_create_contact (mrmailbox_t*, const char* name, const char* addr);
297 int mrmailbox_add_address_book (mrmailbox_t*, const char*);
298 carray* mrmailbox_get_known_contacts (mrmailbox_t*, const char* query);
299 int mrmailbox_get_blocked_count (mrmailbox_t*);
300 carray* mrmailbox_get_blocked_contacts (mrmailbox_t*);
301 void mrmailbox_block_contact (mrmailbox_t*, uint32_t contact_id, int block);
302 char* mrmailbox_get_contact_encrinfo (mrmailbox_t*, uint32_t contact_id);
303 int mrmailbox_delete_contact (mrmailbox_t*, uint32_t contact_id);
304 mrcontact_t* mrmailbox_get_contact (mrmailbox_t*, uint32_t contact_id);
305 
306 
307 /* Import/export and Tools */
308 #define MR_IMEX_CANCEL 0
309 #define MR_IMEX_EXPORT_SELF_KEYS 1 /* param1 is a directory where the keys are written to */
310 #define MR_IMEX_IMPORT_SELF_KEYS 2 /* param1 is a directory where the keys are searched in and read from */
311 #define MR_IMEX_EXPORT_BACKUP 11 /* param1 is a directory where the backup is written to */
312 #define MR_IMEX_IMPORT_BACKUP 12 /* param1 is the file with the backup to import */
313 #define MR_IMEX_EXPORT_SETUP_MESSAGE 20 /* param1 is a directory where the setup file is written to */
314 #define MR_BAK_PREFIX "delta-chat"
315 #define MR_BAK_SUFFIX "bak"
316 void mrmailbox_imex (mrmailbox_t*, int what, const char* param1, const char* setup_code);
317 char* mrmailbox_imex_has_backup (mrmailbox_t*, const char* dir);
318 int mrmailbox_check_password (mrmailbox_t*, const char* pw);
319 char* mrmailbox_create_setup_code (mrmailbox_t*);
320 void mrmailbox_heartbeat (mrmailbox_t*);
321 
322 
323 /* logging */
324 void mrmailbox_log_error (mrmailbox_t*, int code, const char* msg, ...);
325 void mrmailbox_log_error_if (int* condition, mrmailbox_t*, int code, const char* msg, ...);
326 void mrmailbox_log_warning (mrmailbox_t*, int code, const char* msg, ...);
327 void mrmailbox_log_info (mrmailbox_t*, int code, const char* msg, ...);
328 void mrmailbox_log_vprintf (mrmailbox_t*, int event, int code, const char* msg, va_list);
329 int mrmailbox_get_thread_index (void);
330 
331 
332 /* error codes */
333 #define MR_ERR_SELF_NOT_IN_GROUP 1
334 #define MR_ERR_NONETWORK 2
335 
336 
337 /* carray tools, already defined are things as
338 unsigned unt carray_count() */
339 uint32_t carray_get_uint32 (carray*, unsigned int index);
340 
341 
342 /* deprecated functions */
343 mrchat_t* mrchatlist_get_chat_by_index (mrchatlist_t*, size_t index); /* deprecated - use mrchatlist_get_chat_id_by_index() */
344 mrmsg_t* mrchatlist_get_msg_by_index (mrchatlist_t*, size_t index); /* deprecated - use mrchatlist_get_msg_id_by_index() */
345 int mrchat_set_draft (mrchat_t*, const char* msg); /* deprecated - use mrmailbox_set_draft() instead */
346 
347 
348 /* library-internal */
349 uint32_t mrmailbox_send_msg_i__ (mrmailbox_t*, mrchat_t*, const mrmsg_t*, time_t);
350 void mrmailbox_connect_to_imap (mrmailbox_t*, mrjob_t*);
351 void mrmailbox_wake_lock (mrmailbox_t*);
352 void mrmailbox_wake_unlock (mrmailbox_t*);
353 int mrmailbox_poke_eml_file (mrmailbox_t*, const char* file);
354 int mrmailbox_is_reply_to_known_message__ (mrmailbox_t*, mrmimeparser_t*);
355 int mrmailbox_is_reply_to_messenger_message__ (mrmailbox_t*, mrmimeparser_t*);
356 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);
357 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);
358 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);
359 int mrmailbox_get_archived_count__ (mrmailbox_t*);
360 int mrmailbox_reset_tables (mrmailbox_t*, int bits); /* reset tables but leaves server configuration, 1=jobs, 2=e2ee, 8=rest but server config */
361 size_t mrmailbox_get_real_contact_cnt__ (mrmailbox_t*);
362 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);
363 int mrmailbox_get_contact_origin__ (mrmailbox_t*, uint32_t id, int* ret_blocked);
364 int mrmailbox_is_contact_blocked__ (mrmailbox_t*, uint32_t id);
365 int mrmailbox_real_contact_exists__ (mrmailbox_t*, uint32_t id);
366 int mrmailbox_contact_addr_equals__ (mrmailbox_t*, uint32_t contact_id, const char* other_addr);
367 void mrmailbox_scaleup_contact_origin__ (mrmailbox_t*, uint32_t contact_id, int origin);
368 void mrmailbox_unarchive_chat__ (mrmailbox_t*, uint32_t chat_id);
369 size_t mrmailbox_get_chat_cnt__ (mrmailbox_t*);
370 uint32_t mrmailbox_create_or_lookup_nchat_by_contact_id__ (mrmailbox_t*, uint32_t contact_id);
371 uint32_t mrmailbox_lookup_real_nchat_by_contact_id__ (mrmailbox_t*, uint32_t contact_id);
372 int mrmailbox_get_total_msg_count__ (mrmailbox_t*, uint32_t chat_id);
373 int mrmailbox_get_fresh_msg_count__ (mrmailbox_t*, uint32_t chat_id);
374 uint32_t mrmailbox_get_last_deaddrop_fresh_msg__ (mrmailbox_t*);
375 void mrmailbox_send_msg_to_smtp (mrmailbox_t*, mrjob_t*);
376 void mrmailbox_send_msg_to_imap (mrmailbox_t*, mrjob_t*);
377 int mrmailbox_add_contact_to_chat__ (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
378 int mrmailbox_is_contact_in_chat__ (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
379 int mrmailbox_get_chat_contact_count__ (mrmailbox_t*, uint32_t chat_id);
380 int mrmailbox_group_explicitly_left__ (mrmailbox_t*, const char* grpid);
381 void mrmailbox_set_group_explicitly_left__ (mrmailbox_t*, const char* grpid);
382 size_t mrmailbox_get_real_msg_cnt__ (mrmailbox_t*); /* the number of messages assigned to real chat (!=deaddrop, !=trash) */
383 size_t mrmailbox_get_deaddrop_msg_cnt__ (mrmailbox_t*);
384 int mrmailbox_rfc724_mid_cnt__ (mrmailbox_t*, const char* rfc724_mid);
385 int mrmailbox_rfc724_mid_exists__ (mrmailbox_t*, const char* rfc724_mid, char** ret_server_folder, uint32_t* ret_server_uid);
386 void mrmailbox_update_server_uid__ (mrmailbox_t*, const char* rfc724_mid, const char* server_folder, uint32_t server_uid);
387 void mrmailbox_update_msg_chat_id__ (mrmailbox_t*, uint32_t msg_id, uint32_t chat_id);
388 void mrmailbox_update_msg_state__ (mrmailbox_t*, uint32_t msg_id, int state);
389 void mrmailbox_delete_msg_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
390 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 */
391 void mrmailbox_send_mdn (mrmailbox_t*, mrjob_t* job);
392 void mrmailbox_markseen_msg_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
393 void mrmailbox_markseen_mdn_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
394 
395 
396 /* library private: end-to-end-encryption */
397 #define MR_E2EE_DEFAULT_ENABLED 1
398 #define MR_MDNS_DEFAULT_ENABLED 1
399 
400 typedef struct mrmailbox_e2ee_helper_t {
401  int m_encryption_successfull;
402  void* m_cdata_to_free;
403 } mrmailbox_e2ee_helper_t;
404 
405 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*);
406 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 */
407 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! */
408 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 */
409 
410 
411 #ifdef __cplusplus
412 } /* /extern "C" */
413 #endif
414 #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:4032
+
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 
137 #include <libetpan/libetpan.h> /* defines uint16_t and carray */
138 #include "mrchatlist.h"
139 #include "mrchat.h"
140 #include "mrmsg.h"
141 #include "mrcontact.h"
142 #include "mrpoortext.h"
143 #include "mrparam.h"
144 #include "mrevent.h"
145 
146 typedef struct mrmailbox_t mrmailbox_t;
147 typedef struct mrimap_t mrimap_t;
148 typedef struct mrsmtp_t mrsmtp_t;
149 typedef struct mrsqlite3_t mrsqlite3_t;
150 typedef struct mrjob_t mrjob_t;
151 typedef struct mrmimeparser_t mrmimeparser_t;
152 
153 
169 typedef uintptr_t (*mrmailboxcb_t) (mrmailbox_t*, int event, uintptr_t data1, uintptr_t data2);
170 
171 
179 typedef struct mrmailbox_t
180 {
181  void* m_userdata;
182  char* m_dbfile;
183  char* m_blobdir;
186  mrsqlite3_t* m_sql;
187  mrimap_t* m_imap;
188  mrsmtp_t* m_smtp;
190  pthread_t m_job_thread;
191  pthread_cond_t m_job_cond;
192  pthread_mutex_t m_job_condmutex;
193  int m_job_condflag;
194  int m_job_do_exit;
196  mrmailboxcb_t m_cb;
198  char* m_os_name;
200  uint32_t m_cmdline_sel_chat_id;
202  int m_wake_lock;
203  pthread_mutex_t m_wake_lock_critical;
205  int m_e2ee_enabled;
207  #define MR_LOG_RINGBUF_SIZE 200
208  pthread_mutex_t m_log_ringbuf_critical;
209  char* m_log_ringbuf[MR_LOG_RINGBUF_SIZE];
211  time_t m_log_ringbuf_times[MR_LOG_RINGBUF_SIZE];
213  int m_log_ringbuf_pos;
215 } mrmailbox_t;
216 
217 
218 /* create/open/connect */
219 mrmailbox_t* mrmailbox_new (mrmailboxcb_t, void* userdata, const char* os_name);
220 void mrmailbox_unref (mrmailbox_t*);
221 
222 int mrmailbox_open (mrmailbox_t*, const char* dbfile, const char* blobdir);
223 void mrmailbox_close (mrmailbox_t*);
224 int mrmailbox_is_open (const mrmailbox_t*);
225 
226 int mrmailbox_set_config (mrmailbox_t*, const char* key, const char* value);
227 char* mrmailbox_get_config (mrmailbox_t*, const char* key, const char* def);
228 int mrmailbox_set_config_int (mrmailbox_t*, const char* key, int32_t value);
229 int32_t mrmailbox_get_config_int (mrmailbox_t*, const char* key, int32_t def);
230 char* mrmailbox_get_blobdir (mrmailbox_t*);
231 char* mrmailbox_get_version_str (void);
232 
233 void mrmailbox_configure_and_connect(mrmailbox_t*);
234 void mrmailbox_configure_cancel (mrmailbox_t*);
235 int mrmailbox_is_configured (mrmailbox_t*);
236 
237 void mrmailbox_connect (mrmailbox_t*);
238 void mrmailbox_disconnect (mrmailbox_t*);
239 
240 int mrmailbox_restore (mrmailbox_t*, time_t seconds_to_restore); /* not really implemented */
241 char* mrmailbox_get_info (mrmailbox_t*);
242 
243 
244 /* Handle chatlists */
245 #define MR_GCL_ARCHIVED_ONLY 0x01
246 #define MR_GCL_NO_SPECIALS 0x02
247 mrchatlist_t* mrmailbox_get_chatlist (mrmailbox_t*, int flags, const char* query);
248 
249 
250 /* Handle chats */
251 uint32_t mrmailbox_create_chat_by_contact_id (mrmailbox_t*, uint32_t contact_id);
252 uint32_t mrmailbox_get_chat_id_by_contact_id (mrmailbox_t*, uint32_t contact_id);
253 
254 uint32_t mrmailbox_send_text_msg (mrmailbox_t*, uint32_t chat_id, const char* text_to_send);
255 uint32_t mrmailbox_send_msg (mrmailbox_t*, uint32_t chat_id, mrmsg_t*);
256 void mrmailbox_set_draft (mrmailbox_t*, uint32_t chat_id, const char*);
257 
258 #define MR_GCM_ADDDAYMARKER 0x01
259 carray* mrmailbox_get_chat_msgs (mrmailbox_t*, uint32_t chat_id, uint32_t flags, uint32_t marker1before);
260 int mrmailbox_get_total_msg_count (mrmailbox_t*, uint32_t chat_id);
261 int mrmailbox_get_fresh_msg_count (mrmailbox_t*, uint32_t chat_id);
262 carray* mrmailbox_get_fresh_msgs (mrmailbox_t*);
263 void mrmailbox_marknoticed_chat (mrmailbox_t*, uint32_t chat_id);
264 carray* mrmailbox_get_chat_media (mrmailbox_t*, uint32_t chat_id, int msg_type, int or_msg_type);
265 uint32_t mrmailbox_get_next_media (mrmailbox_t*, uint32_t curr_msg_id, int dir);
266 
267 void mrmailbox_archive_chat (mrmailbox_t*, uint32_t chat_id, int archive);
268 void mrmailbox_delete_chat (mrmailbox_t*, uint32_t chat_id);
269 
270 carray* mrmailbox_get_chat_contacts (mrmailbox_t*, uint32_t chat_id);
271 carray* mrmailbox_search_msgs (mrmailbox_t*, uint32_t chat_id, const char* query);
272 
273 mrchat_t* mrmailbox_get_chat (mrmailbox_t*, uint32_t chat_id);
274 
275 
276 /* Handle group chats */
277 uint32_t mrmailbox_create_group_chat (mrmailbox_t*, const char* name);
278 int mrmailbox_is_contact_in_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
279 int mrmailbox_add_contact_to_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
280 int mrmailbox_remove_contact_from_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
281 int mrmailbox_set_chat_name (mrmailbox_t*, uint32_t chat_id, const char* name);
282 int mrmailbox_set_chat_image (mrmailbox_t*, uint32_t chat_id, const char* image);
283 
284 
285 /* Handle messages */
286 char* mrmailbox_get_msg_info (mrmailbox_t*, uint32_t msg_id);
287 void mrmailbox_delete_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt);
288 void mrmailbox_forward_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt, uint32_t chat_id);
289 void mrmailbox_marknoticed_contact (mrmailbox_t*, uint32_t contact_id);
290 void mrmailbox_markseen_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt);
291 void mrmailbox_star_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt, int star);
292 mrmsg_t* mrmailbox_get_msg (mrmailbox_t*, uint32_t msg_id);
293 
294 
295 /* Handle contacts */
296 uint32_t mrmailbox_create_contact (mrmailbox_t*, const char* name, const char* addr);
297 int mrmailbox_add_address_book (mrmailbox_t*, const char*);
298 carray* mrmailbox_get_known_contacts (mrmailbox_t*, const char* query);
299 int mrmailbox_get_blocked_count (mrmailbox_t*);
300 carray* mrmailbox_get_blocked_contacts (mrmailbox_t*);
301 void mrmailbox_block_contact (mrmailbox_t*, uint32_t contact_id, int block);
302 char* mrmailbox_get_contact_encrinfo (mrmailbox_t*, uint32_t contact_id);
303 int mrmailbox_delete_contact (mrmailbox_t*, uint32_t contact_id);
304 mrcontact_t* mrmailbox_get_contact (mrmailbox_t*, uint32_t contact_id);
305 
306 
307 /* Import/export and Tools */
308 #define MR_IMEX_CANCEL 0
309 #define MR_IMEX_EXPORT_SELF_KEYS 1 /* param1 is a directory where the keys are written to */
310 #define MR_IMEX_IMPORT_SELF_KEYS 2 /* param1 is a directory where the keys are searched in and read from */
311 #define MR_IMEX_EXPORT_BACKUP 11 /* param1 is a directory where the backup is written to */
312 #define MR_IMEX_IMPORT_BACKUP 12 /* param1 is the file with the backup to import */
313 #define MR_IMEX_EXPORT_SETUP_MESSAGE 20 /* param1 is a directory where the setup file is written to */
314 #define MR_BAK_PREFIX "delta-chat"
315 #define MR_BAK_SUFFIX "bak"
316 void mrmailbox_imex (mrmailbox_t*, int what, const char* param1, const char* setup_code);
317 char* mrmailbox_imex_has_backup (mrmailbox_t*, const char* dir);
318 int mrmailbox_check_password (mrmailbox_t*, const char* pw);
319 char* mrmailbox_create_setup_code (mrmailbox_t*);
320 void mrmailbox_heartbeat (mrmailbox_t*);
321 
322 
323 /* logging */
324 void mrmailbox_log_error (mrmailbox_t*, int code, const char* msg, ...);
325 void mrmailbox_log_error_if (int* condition, mrmailbox_t*, int code, const char* msg, ...);
326 void mrmailbox_log_warning (mrmailbox_t*, int code, const char* msg, ...);
327 void mrmailbox_log_info (mrmailbox_t*, int code, const char* msg, ...);
328 void mrmailbox_log_vprintf (mrmailbox_t*, int event, int code, const char* msg, va_list);
329 int mrmailbox_get_thread_index (void);
330 
331 
332 /* error codes */
333 #define MR_ERR_SELF_NOT_IN_GROUP 1
334 #define MR_ERR_NONETWORK 2
335 
336 
337 /* carray tools, already defined are things as
338 unsigned unt carray_count() */
339 uint32_t carray_get_uint32 (carray*, unsigned int index);
340 
341 
342 /* deprecated functions */
343 mrchat_t* mrchatlist_get_chat_by_index (mrchatlist_t*, size_t index); /* deprecated - use mrchatlist_get_chat_id_by_index() */
344 mrmsg_t* mrchatlist_get_msg_by_index (mrchatlist_t*, size_t index); /* deprecated - use mrchatlist_get_msg_id_by_index() */
345 int mrchat_set_draft (mrchat_t*, const char* msg); /* deprecated - use mrmailbox_set_draft() instead */
346 
347 
348 /* library-internal */
349 uint32_t mrmailbox_send_msg_i__ (mrmailbox_t*, mrchat_t*, const mrmsg_t*, time_t);
350 void mrmailbox_connect_to_imap (mrmailbox_t*, mrjob_t*);
351 void mrmailbox_wake_lock (mrmailbox_t*);
352 void mrmailbox_wake_unlock (mrmailbox_t*);
353 int mrmailbox_poke_eml_file (mrmailbox_t*, const char* file);
354 int mrmailbox_is_reply_to_known_message__ (mrmailbox_t*, mrmimeparser_t*);
355 int mrmailbox_is_reply_to_messenger_message__ (mrmailbox_t*, mrmimeparser_t*);
356 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);
357 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);
358 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);
359 int mrmailbox_get_archived_count__ (mrmailbox_t*);
360 int mrmailbox_reset_tables (mrmailbox_t*, int bits); /* reset tables but leaves server configuration, 1=jobs, 2=e2ee, 8=rest but server config */
361 size_t mrmailbox_get_real_contact_cnt__ (mrmailbox_t*);
362 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);
363 int mrmailbox_get_contact_origin__ (mrmailbox_t*, uint32_t id, int* ret_blocked);
364 int mrmailbox_is_contact_blocked__ (mrmailbox_t*, uint32_t id);
365 int mrmailbox_real_contact_exists__ (mrmailbox_t*, uint32_t id);
366 int mrmailbox_contact_addr_equals__ (mrmailbox_t*, uint32_t contact_id, const char* other_addr);
367 void mrmailbox_scaleup_contact_origin__ (mrmailbox_t*, uint32_t contact_id, int origin);
368 void mrmailbox_unarchive_chat__ (mrmailbox_t*, uint32_t chat_id);
369 size_t mrmailbox_get_chat_cnt__ (mrmailbox_t*);
370 uint32_t mrmailbox_create_or_lookup_nchat_by_contact_id__ (mrmailbox_t*, uint32_t contact_id);
371 uint32_t mrmailbox_lookup_real_nchat_by_contact_id__ (mrmailbox_t*, uint32_t contact_id);
372 int mrmailbox_get_total_msg_count__ (mrmailbox_t*, uint32_t chat_id);
373 int mrmailbox_get_fresh_msg_count__ (mrmailbox_t*, uint32_t chat_id);
374 uint32_t mrmailbox_get_last_deaddrop_fresh_msg__ (mrmailbox_t*);
375 void mrmailbox_send_msg_to_smtp (mrmailbox_t*, mrjob_t*);
376 void mrmailbox_send_msg_to_imap (mrmailbox_t*, mrjob_t*);
377 int mrmailbox_add_contact_to_chat__ (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
378 int mrmailbox_is_contact_in_chat__ (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
379 int mrmailbox_get_chat_contact_count__ (mrmailbox_t*, uint32_t chat_id);
380 int mrmailbox_group_explicitly_left__ (mrmailbox_t*, const char* grpid);
381 void mrmailbox_set_group_explicitly_left__ (mrmailbox_t*, const char* grpid);
382 size_t mrmailbox_get_real_msg_cnt__ (mrmailbox_t*); /* the number of messages assigned to real chat (!=deaddrop, !=trash) */
383 size_t mrmailbox_get_deaddrop_msg_cnt__ (mrmailbox_t*);
384 int mrmailbox_rfc724_mid_cnt__ (mrmailbox_t*, const char* rfc724_mid);
385 int mrmailbox_rfc724_mid_exists__ (mrmailbox_t*, const char* rfc724_mid, char** ret_server_folder, uint32_t* ret_server_uid);
386 void mrmailbox_update_server_uid__ (mrmailbox_t*, const char* rfc724_mid, const char* server_folder, uint32_t server_uid);
387 void mrmailbox_update_msg_chat_id__ (mrmailbox_t*, uint32_t msg_id, uint32_t chat_id);
388 void mrmailbox_update_msg_state__ (mrmailbox_t*, uint32_t msg_id, int state);
389 void mrmailbox_delete_msg_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
390 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 */
391 void mrmailbox_send_mdn (mrmailbox_t*, mrjob_t* job);
392 void mrmailbox_markseen_msg_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
393 void mrmailbox_markseen_mdn_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
394 
395 
396 /* library private: end-to-end-encryption */
397 #define MR_E2EE_DEFAULT_ENABLED 1
398 #define MR_MDNS_DEFAULT_ENABLED 1
399 
400 typedef struct mrmailbox_e2ee_helper_t {
401  int m_encryption_successfull;
402  void* m_cdata_to_free;
403 } mrmailbox_e2ee_helper_t;
404 
405 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*);
406 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 */
407 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! */
408 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 */
409 
410 
411 #ifdef __cplusplus
412 } /* /extern "C" */
413 #endif
414 #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:4032
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:3344
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:3996
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:3112
diff --git a/docs/html/structmrmailbox__t.html b/docs/html/structmrmailbox__t.html index 23153eb7..632d5a98 100644 --- a/docs/html/structmrmailbox__t.html +++ b/docs/html/structmrmailbox__t.html @@ -322,7 +322,7 @@ void * 
Parameters
- +
mailboxthe mailbox object as returned by mrmailbox_new().
eventone of the MR_EVENT_* constants
eventone of the MR_EVENT_* constants as defined in mrevent.h
data1depends on the event parameter
data2depends on the event parameter