diff --git a/docs/html/classmrchat__t.html b/docs/html/classmrchat__t.html index 10ca580b..893918e7 100644 --- a/docs/html/classmrchat__t.html +++ b/docs/html/classmrchat__t.html @@ -208,7 +208,7 @@ Public Member Functions

Get chat type.

Currently, there are two chat types:

Parameters
diff --git a/docs/html/classmrmailbox__t.html b/docs/html/classmrmailbox__t.html index 62408ba9..ee19f1f7 100644 --- a/docs/html/classmrmailbox__t.html +++ b/docs/html/classmrmailbox__t.html @@ -158,7 +158,7 @@ Public Member Functions  Get chat object by a chat ID. More...
  void mrmailbox_marknoticed_chat (mrmailbox_t *mailbox, uint32_t chat_id) - Mark all message in a chat as noticed. More...
+ Mark all messages in a chat as noticed. More...
  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. More...
@@ -206,7 +206,7 @@ Public Member Functions  Send an image to a chat. More...
  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. More...
+ Send a video to a chat. More...
  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. More...
@@ -257,7 +257,7 @@ Public Member Functions  Get a single contact object. More...
  void mrmailbox_marknoticed_contact (mrmailbox_t *mailbox, uint32_t contact_id) - Mark all messages send by the given contact as noticed. More...
+ Mark all messages sent by the given contact as noticed. More...
  void mrmailbox_block_contact (mrmailbox_t *mailbox, uint32_t contact_id, int new_blocking)  Block or unblock a contact. More...
@@ -278,7 +278,7 @@ Public Member Functions  Forward messages to another chat. More...
  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). More...
+ Star/unstar messages by setting the last parameter to 0 (unstar) or 1 (star). More...
  void mrmailbox_delete_msgs (mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt)  Delete messages. More...
@@ -955,8 +955,8 @@ Public Member Functions
-

Mark all message in a chat as noticed.

-

Noticed messages are no longer fresh and do not count as being unseen. IMAP/MDNs is not done for noticed messages. See also mrmailbox_marknoticed_contact() and mrmailbox_markseen_msgs()

+

Mark all messages in a chat as noticed.

+

Noticed messages are no longer fresh and do not count as being unseen. IMAP/MDNs is not done for noticed messages. See also mrmailbox_marknoticed_contact() and mrmailbox_markseen_msgs()

Parameters
@@ -1670,7 +1670,7 @@ Public Member Functions
mailboxThe mailbox object as returned from mrmailbox_new().
-

Send an video to a chat.

+

Send a video to a chat.

Sends the event MR_EVENT_MSGS_CHANGED on succcess. However, this does not imply, the message really reached the recipient - sending may be delayed eg. due to network problems. However, from your view, you're done with the message. Sooner or later it will find its way.

See also mrmailbox_send_image_msg().

Parameters
@@ -1907,7 +1907,6 @@ Public Member Functions

Sends the name and the email address of another contact to a chat. The contact this may or may not be a member of the chat.

Typically used to share a contact to another member or to a group of members.

Internally, the function just creates an appropriate text message and sends it using mrmailbox_send_text_msg().

-

Future implementations may also send the key of the user though gossip; currently, this is not done.

NB: The "vcard" in the function name is just an abbreviation of "visiting card" and is not related to the VCARD data format.

Parameters
@@ -1946,7 +1945,7 @@ Public Member Functions

Create a new group chat.

-

After creation, the group has one member with the ID MR_CONTACT_ID_SELF and is in unpromoted state. This means, you can add or remove members, change the name, the group image and so on without messages being send to all group members.

+

After creation, the group has one member with the ID MR_CONTACT_ID_SELF and is in unpromoted state. This means, you can add or remove members, change the name, the group image and so on without messages being sent to all group members.

This changes as soon as the first message is sent to the group members and the group becomes promoted. After that, all changes are synced with all group members by sending status message.

To check, if a chat is still unpromoted, you mrchat_is_unpromoted()

Parameters
@@ -2417,8 +2416,8 @@ Public Member Functions
-

Mark all messages send by the given contact as noticed.

-

See also mrmailbox_marknoticed_chat() and mrmailbox_markseen_msgs()

+

Mark all messages sent by the given contact as noticed.

+

See also mrmailbox_marknoticed_chat() and mrmailbox_markseen_msgs()

Parameters
@@ -2536,7 +2535,7 @@ Public Member Functions

Delete a contact.

-

The contact is deleted from the local device. It may happen that this is not possible as the contact is in used. In this case, the contact can be blocked.

+

The contact is deleted from the local device. It may happen that this is not possible as the contact is in use. In this case, the contact can be blocked.

May result in a MR_EVENT_CONTACTS_CHANGED event.

Parameters
mailboxThe mailbox object as created by mrmmailbox_new()
@@ -2709,7 +2708,7 @@ Public Member Functions
-

Star/unstar messages by setting the last parameter to 0 (unstar) or 1(star).

+

Star/unstar messages by setting the last parameter to 0 (unstar) or 1 (star).

Starred messages are collected in a virtual chat that can be shown using mrmailbox_get_chat_msgs() using the chat_id MR_CHAT_ID_STARRED.

Parameters
@@ -2799,7 +2798,7 @@ Public Member Functions

Mark a message as seen, updates the IMAP state and sends MDNs.

-

if the message is not in a real chat (eg. a contact request), the message is only marked as NOTICED and no IMAP/MDNs is done. See also mrmailbox_marknoticed_chat() and mrmailbox_marknoticed_contact()

+

if the message is not in a real chat (eg. a contact request), the message is only marked as NOTICED and no IMAP/MDNs is done. See also mrmailbox_marknoticed_chat() and mrmailbox_marknoticed_contact()

Parameters
diff --git a/docs/html/classmrmsg__t.html b/docs/html/classmrmsg__t.html index 4e96c176..a3638e40 100644 --- a/docs/html/classmrmsg__t.html +++ b/docs/html/classmrmsg__t.html @@ -327,7 +327,7 @@ Public Member Functions

Get the state of a message.

Incoming message states:

  • MR_STATE_IN_FRESH (10) - Incoming fresh message. Fresh messages are not noticed nor seen and are typically shown in notifications. Use mrmailbox_get_fresh_msgs() to get all fresh messages.
    • -
  • MR_STATE_IN_NOTICED (13) - Incoming noticed message. Eg. chat opened but message not yet read - noticed messages are not counted as unread but did not marked as read nor resulted in MDNs. Use mrmailbox_marknoticed_chat() or mrmailbox_marknoticed_contact() to mark messages as being noticed.
    • +
  • MR_STATE_IN_NOTICED (13) - Incoming noticed message. Eg. chat opened but message not yet read - noticed messages are not counted as unread but did not marked as read nor resulted in MDNs. Use mrmailbox_marknoticed_chat() or mrmailbox_marknoticed_contact() to mark messages as being noticed.
  • MR_STATE_IN_SEEN (16) - Incoming message, really seen by the user. Marked as read on IMAP and MDN may be send. Use mrmailbox_markseen_msgs() to mark messages as being seen.

Outgoing message states:

    @@ -337,7 +337,7 @@ Public Member Functions
  • MR_STATE_OUT_MDN_RCVD (28) - Outgoing message read by the recipient (two checkmarks; this requires goodwill on the receiver's side) If a sent message changes to this state, you'll receive the event MR_EVENT_MSG_READ.

If you just want to check if a message is sent or not, please use mrmsg_is_sent() which regards all states accordingly.

-

The state of just created message objects is MR_STATE_UNDEFINED (0). The state is always set by the core-library, users of the library cannot set the state directly, but it is changed implicitly eg. when calling mrmailbox_marknoticed_chat() or mrmailbox_markseen_msgs().

+

The state of just created message objects is MR_STATE_UNDEFINED (0). The state is always set by the core-library, users of the library cannot set the state directly, but it is changed implicitly eg. when calling mrmailbox_marknoticed_chat() or mrmailbox_markseen_msgs().

Parameters
mailboxThe mailbox object.
@@ -768,7 +768,7 @@ Public Member Functions

Check if a message is starred.

Starred messages are "favorites" marked by the user with a "star" or something like that. Starred messages can typically be shown easily and are not deleted automatically.

-

To star one or more messages, use mrmailbox_star_msgs(), to get a list of starred messages, use mrmailbox_get_chat_msgs() using MR_CHAT_ID_STARRED as the chat_id.

+

To star one or more messages, use mrmailbox_star_msgs(), to get a list of starred messages, use mrmailbox_get_chat_msgs() using MR_CHAT_ID_STARRED as the chat_id.

Parameters
msgThe message object.
diff --git a/docs/html/mrapeerstate_8h_source.html b/docs/html/mrapeerstate_8h_source.html index c967a9a3..a7007474 100644 --- a/docs/html/mrapeerstate_8h_source.html +++ b/docs/html/mrapeerstate_8h_source.html @@ -89,7 +89,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
mrapeerstate.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 __MRAPEERSTATE_H__
24 #define __MRAPEERSTATE_H__
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28 
29 
30 #include "mrkey.h"
31 
32 
33 typedef struct mraheader_t mraheader_t;
34 
35 
36 #define MRA_PE_NOPREFERENCE 0 /* prefer-encrypt states */
37 #define MRA_PE_MUTUAL 1
38 #define MRA_PE_GOSSIP 2
39 #define MRA_PE_RESET 20
40 
41 
45 typedef struct mrapeerstate_t
46 {
48  char* m_addr;
49  time_t m_last_seen;
50  time_t m_last_seen_autocrypt;
51  mrkey_t* m_public_key;
52  int m_prefer_encrypt;
53 
54  #define MRA_SAVE_LAST_SEEN 0x01
55  #define MRA_SAVE_ALL 0x02
56  int m_to_save;
57 } mrapeerstate_t;
58 
59 
60 mrapeerstate_t* mrapeerstate_new (); /* the returned pointer is ref'd and must be unref'd after usage */
61 void mrapeerstate_unref (mrapeerstate_t*);
62 
63 int mrapeerstate_init_from_header (mrapeerstate_t*, const mraheader_t*, time_t message_time);
64 int mrapeerstate_degrade_encryption(mrapeerstate_t*, time_t message_time);
65 int mrapeerstate_apply_header (mrapeerstate_t*, const mraheader_t*, time_t message_time); /*returns 1 on changes*/
66 
67 char* mrapeerstate_render_gossip_header(mrapeerstate_t*);
68 
69 int mrapeerstate_load_from_db__ (mrapeerstate_t*, mrsqlite3_t*, const char* addr);
70 int mrapeerstate_save_to_db__ (const mrapeerstate_t*, mrsqlite3_t*, int create);
71 
72 
73 #ifdef __cplusplus
74 } /* /extern "C" */
75 #endif
76 #endif /* __MRAPEERSTATE_H__ */
77 
+
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 __MRAPEERSTATE_H__
24 #define __MRAPEERSTATE_H__
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28 
29 
30 #include "mrkey.h"
31 
32 
33 typedef struct mraheader_t mraheader_t;
34 
35 
36 #define MRA_PE_NOPREFERENCE 0 /* prefer-encrypt states */
37 #define MRA_PE_MUTUAL 1
38 #define MRA_PE_RESET 20
39 
40 
44 typedef struct mrapeerstate_t
45 {
47  char* m_addr;
48  time_t m_last_seen; /* may be 0 if the peer was created by gossipping */
49 
50  time_t m_last_seen_autocrypt;
51  mrkey_t* m_public_key; /* may be NULL, however, in the database, either public_key or gossip_key is set */
52  int m_prefer_encrypt;
53 
54  time_t m_gossip_timestamp;
55  mrkey_t* m_gossip_key; /* may be NULL */
56 
57  #define MRA_SAVE_TIMESTAMPS 0x01
58  #define MRA_SAVE_ALL 0x02
59  int m_to_save;
60 } mrapeerstate_t;
61 
62 
63 mrapeerstate_t* mrapeerstate_new (); /* the returned pointer is ref'd and must be unref'd after usage */
64 void mrapeerstate_unref (mrapeerstate_t*);
65 
66 int mrapeerstate_init_from_header (mrapeerstate_t*, const mraheader_t*, time_t message_time);
67 int mrapeerstate_init_from_gossip (mrapeerstate_t*, const mraheader_t*, time_t message_time);
68 
69 int mrapeerstate_degrade_encryption(mrapeerstate_t*, time_t message_time);
70 
71 void mrapeerstate_apply_header (mrapeerstate_t*, const mraheader_t*, time_t message_time);
72 void mrapeerstate_apply_gossip (mrapeerstate_t*, const mraheader_t*, time_t message_time);
73 
74 char* mrapeerstate_render_gossip_header(mrapeerstate_t*);
75 
76 mrkey_t* mrapeerstate_peek_key (mrapeerstate_t*);
77 
78 int mrapeerstate_load_from_db__ (mrapeerstate_t*, mrsqlite3_t*, const char* addr);
79 int mrapeerstate_save_to_db__ (const mrapeerstate_t*, mrsqlite3_t*, int create);
80 
81 
82 #ifdef __cplusplus
83 } /* /extern "C" */
84 #endif
85 #endif /* __MRAPEERSTATE_H__ */
86 
Generated by   diff --git a/docs/html/mrchat_8h_source.html b/docs/html/mrchat_8h_source.html index a6709bd2..b4104357 100644 --- a/docs/html/mrchat_8h_source.html +++ b/docs/html/mrchat_8h_source.html @@ -89,19 +89,19 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
mrchat.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 __MRCHAT_H__
24 #define __MRCHAT_H__
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28 
29 
30 typedef struct _mrmailbox mrmailbox_t;
31 
32 
33 #define MR_CHAT_ID_DEADDROP 1
34 #define MR_CHAT_ID_TO_DEADDROP 2 /* messages sent from us to unknown/unwanted users (this may happen when deleting chats or when using CC: in the email-program) */
35 #define MR_CHAT_ID_TRASH 3 /* messages that should be deleted get this chat_id; the messages are deleted from the working thread later then. This is also needed as rfc724_mid should be preset as long as the message is not deleted on the server (otherwise it is downloaded again) */
36 #define MR_CHAT_ID_MSGS_IN_CREATION 4 /* a message is just in creation but not yet assigned to a chat (eg. we may need the message ID to set up blobs; this avoids unready message to be sent and shown) */
37 #define MR_CHAT_ID_STARRED 5
38 #define MR_CHAT_ID_ARCHIVED_LINK 6
39 #define MR_CHAT_ID_LAST_SPECIAL 9 /* larger chat IDs are "real" chats, their messages are "real" messages. */
40 #define MR_CHAT_TYPE_UNDEFINED 0
41 #define MR_CHAT_TYPE_NORMAL 100
42 #define MR_CHAT_TYPE_GROUP 120
43 
44 
52 typedef struct _mrchat mrchat_t;
53 
54 
55 mrchat_t* mrchat_new (mrmailbox_t*);
56 void mrchat_empty (mrchat_t*);
57 void mrchat_unref (mrchat_t*);
58 
59 uint32_t mrchat_get_id (mrchat_t*);
60 int mrchat_get_type (mrchat_t*);
61 char* mrchat_get_name (mrchat_t*);
62 char* mrchat_get_subtitle (mrchat_t*);
63 char* mrchat_get_profile_image (mrchat_t*);
64 char* mrchat_get_draft (mrchat_t*);
65 time_t mrchat_get_draft_timestamp (mrchat_t*);
66 int mrchat_get_archived (mrchat_t*);
67 int mrchat_is_unpromoted (mrchat_t*);
68 int mrchat_is_self_talk (mrchat_t*);
69 
70 
71 #ifdef __cplusplus
72 } /* /extern "C" */
73 #endif
74 #endif /* __MRCHAT_H__ */
mrchat_t::mrchat_is_unpromoted
int mrchat_is_unpromoted(mrchat_t *chat)
Check if a chat is still unpromoted.
Definition: mrchat.c:374
-
mrchat_t::mrchat_is_self_talk
int mrchat_is_self_talk(mrchat_t *chat)
Check if a chat is a self talk.
Definition: mrchat.c:393
-
mrchat_t::mrchat_get_draft
char * mrchat_get_draft(mrchat_t *chat)
Get draft for the chat, if any.
Definition: mrchat.c:303
-
mrchat_t::mrchat_get_name
char * mrchat_get_name(mrchat_t *chat)
Get name of a chat.
Definition: mrchat.c:182
-
mrchat_t::mrchat_get_draft_timestamp
time_t mrchat_get_draft_timestamp(mrchat_t *chat)
Get timestamp of the draft.
Definition: mrchat.c:324
-
mrchat_t::mrchat_get_archived
int mrchat_get_archived(mrchat_t *chat)
Get archived state.
Definition: mrchat.c:350
+
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 __MRCHAT_H__
24 #define __MRCHAT_H__
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28 
29 
30 typedef struct _mrmailbox mrmailbox_t;
31 
32 
33 #define MR_CHAT_ID_DEADDROP 1
34 #define MR_CHAT_ID_TO_DEADDROP 2 /* messages sent from us to unknown/unwanted users (this may happen when deleting chats or when using CC: in the email-program) */
35 #define MR_CHAT_ID_TRASH 3 /* messages that should be deleted get this chat_id; the messages are deleted from the working thread later then. This is also needed as rfc724_mid should be preset as long as the message is not deleted on the server (otherwise it is downloaded again) */
36 #define MR_CHAT_ID_MSGS_IN_CREATION 4 /* a message is just in creation but not yet assigned to a chat (eg. we may need the message ID to set up blobs; this avoids unready message to be sent and shown) */
37 #define MR_CHAT_ID_STARRED 5
38 #define MR_CHAT_ID_ARCHIVED_LINK 6
39 #define MR_CHAT_ID_LAST_SPECIAL 9 /* larger chat IDs are "real" chats, their messages are "real" messages. */
40 #define MR_CHAT_TYPE_UNDEFINED 0
41 #define MR_CHAT_TYPE_NORMAL 100
42 #define MR_CHAT_TYPE_GROUP 120
43 
44 
52 typedef struct _mrchat mrchat_t;
53 
54 
55 mrchat_t* mrchat_new (mrmailbox_t*);
56 void mrchat_empty (mrchat_t*);
57 void mrchat_unref (mrchat_t*);
58 
59 uint32_t mrchat_get_id (mrchat_t*);
60 int mrchat_get_type (mrchat_t*);
61 char* mrchat_get_name (mrchat_t*);
62 char* mrchat_get_subtitle (mrchat_t*);
63 char* mrchat_get_profile_image (mrchat_t*);
64 char* mrchat_get_draft (mrchat_t*);
65 time_t mrchat_get_draft_timestamp (mrchat_t*);
66 int mrchat_get_archived (mrchat_t*);
67 int mrchat_is_unpromoted (mrchat_t*);
68 int mrchat_is_self_talk (mrchat_t*);
69 
70 
71 #ifdef __cplusplus
72 } /* /extern "C" */
73 #endif
74 #endif /* __MRCHAT_H__ */
mrchat_t::mrchat_is_unpromoted
int mrchat_is_unpromoted(mrchat_t *chat)
Check if a chat is still unpromoted.
Definition: mrchat.c:379
+
mrchat_t::mrchat_is_self_talk
int mrchat_is_self_talk(mrchat_t *chat)
Check if a chat is a self talk.
Definition: mrchat.c:398
+
mrchat_t::mrchat_get_draft
char * mrchat_get_draft(mrchat_t *chat)
Get draft for the chat, if any.
Definition: mrchat.c:308
+
mrchat_t::mrchat_get_name
char * mrchat_get_name(mrchat_t *chat)
Get name of a chat.
Definition: mrchat.c:187
+
mrchat_t::mrchat_get_draft_timestamp
time_t mrchat_get_draft_timestamp(mrchat_t *chat)
Get timestamp of the draft.
Definition: mrchat.c:329
+
mrchat_t::mrchat_get_archived
int mrchat_get_archived(mrchat_t *chat)
Get archived state.
Definition: mrchat.c:355
mrmailbox_t
An object representing a single mailbox.
mrchat_t::mrchat_get_id
uint32_t mrchat_get_id(mrchat_t *chat)
Get chat ID.
Definition: mrchat.c:134
mrchat_t::mrchat_unref
void mrchat_unref(mrchat_t *chat)
Free a chat object.
Definition: mrchat.c:68
-
mrchat_t::mrchat_get_profile_image
char * mrchat_get_profile_image(mrchat_t *chat)
Get the chat's profile image.
Definition: mrchat.c:280
-
mrchat_t::mrchat_get_type
int mrchat_get_type(mrchat_t *chat)
Get chat type.
Definition: mrchat.c:158
+
mrchat_t::mrchat_get_profile_image
char * mrchat_get_profile_image(mrchat_t *chat)
Get the chat's profile image.
Definition: mrchat.c:285
+
mrchat_t::mrchat_get_type
int mrchat_get_type(mrchat_t *chat)
Get chat type.
Definition: mrchat.c:163
mrchat_t
An object representing a single chat in memory.
-
mrchat_t::mrchat_get_subtitle
char * mrchat_get_subtitle(mrchat_t *chat)
Get a subtitle for a chat.
Definition: mrchat.c:204
+
mrchat_t::mrchat_get_subtitle
char * mrchat_get_subtitle(mrchat_t *chat)
Get a subtitle for a chat.
Definition: mrchat.c:209
diff --git a/docs/html/mrimap_8h_source.html b/docs/html/mrimap_8h_source.html index 21828171..972ee266 100644 --- a/docs/html/mrimap_8h_source.html +++ b/docs/html/mrimap_8h_source.html @@ -89,7 +89,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
mrimap.h
-
1 /*******************************************************************************
2  *
3  * Delta Chat Core
4  * Copyright (C) 2017 Björn Petersen
5  * Contact: r10s@b44t.com, http://b44t.com
6  *
7  * This program is free software: you can redistribute it and/or modify it under
8  * the terms of the GNU General Public License as published by the Free Software
9  * Foundation, either version 3 of the License, or (at your option) any later
10  * version.
11  *
12  * This program is distributed in the hope that it will be useful, but WITHOUT
13  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
14  * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
15  * details.
16  *
17  * You should have received a copy of the GNU General Public License along with
18  * this program. If not, see http://www.gnu.org/licenses/ .
19  *
20  ******************************************************************************/
21 
22 
23 /* Purpose: Reading from IMAP servers with no dependencies to the database.
24 mrmailbox_t is only used for logging and to get information about
25 the online state. */
26 
27 
28 #ifndef __MRIMAP_H__
29 #define __MRIMAP_H__
30 #ifdef __cplusplus
31 extern "C" {
32 #endif
33 
34 
35 typedef struct mrloginparam_t mrloginparam_t;
36 typedef struct mrimap_t mrimap_t;
37 
38 #define MR_IMAP_SEEN 0x0001L
39 
40 typedef int32_t (*mr_get_config_int_t)(mrimap_t*, const char*, int32_t);
41 typedef void (*mr_set_config_int_t)(mrimap_t*, const char*, int32_t);
42 typedef void (*mr_receive_imf_t) (mrimap_t*, const char* imf_raw_not_terminated, size_t imf_raw_bytes, const char* server_folder, uint32_t server_uid, uint32_t flags);
43 
44 
48 typedef struct mrimap_t
49 {
52  char* m_imap_server;
53  int m_imap_port;
54  char* m_imap_user;
55  char* m_imap_pw;
56  int m_server_flags;
57 
58  int m_connected; /* initally connected and watch thread installed */
59  mailimap* m_hEtpan; /* normally, if connected, m_hEtpan is also set; however, if a reconnection is required, we may lost this handle */
60  pthread_mutex_t m_hEtpanmutex;
61  int m_idle_set_up;
62  char* m_selected_folder;
63  int m_should_reconnect;
64 
65  int m_can_idle;
66  int m_has_xlist;
67  char* m_moveto_folder;/* Folder, where reveived chat messages should go to. Normally "Chats" but may be NULL to leave them in the INBOX */
68  char* m_sent_folder; /* Folder, where send messages should go to. Normally "Chats". */
69  pthread_mutex_t m_idlemutex; /* set, if idle is not possible; morover, the interrupted IDLE thread waits a second before IDLEing again; this allows several jobs to be executed */
70  pthread_mutex_t m_inwait_mutex; /* only used to wait for mailstream_wait_idle()/mailimap_idle_done() to terminate. */
71 
72  pthread_t m_watch_thread;
73  pthread_cond_t m_watch_cond;
74  pthread_mutex_t m_watch_condmutex;
75  int m_watch_condflag;
76  int m_watch_do_exit;
77 
78  time_t m_enter_watch_wait_time;
79 
80  pthread_t m_heartbeat_thread;
81  pthread_cond_t m_heartbeat_cond;
82  pthread_mutex_t m_heartbeat_condmutex;
83 
84  struct mailimap_fetch_type* m_fetch_type_uid;
85  struct mailimap_fetch_type* m_fetch_type_body;
86  struct mailimap_fetch_type* m_fetch_type_flags;
87 
88  mr_get_config_int_t m_get_config_int;
89  mr_set_config_int_t m_set_config_int;
90  mr_receive_imf_t m_receive_imf;
91  void* m_userData;
92  mrmailbox_t* m_mailbox;
93 
94  int m_log_connect_errors;
95 } mrimap_t;
96 
97 
98 mrimap_t* mrimap_new (mr_get_config_int_t, mr_set_config_int_t, mr_receive_imf_t, void* userData, mrmailbox_t*);
99 void mrimap_unref (mrimap_t*);
100 
101 int mrimap_connect (mrimap_t*, const mrloginparam_t*);
102 void mrimap_disconnect (mrimap_t*);
103 int mrimap_is_connected (mrimap_t*);
104 int mrimap_fetch (mrimap_t*);
105 
106 int mrimap_append_msg (mrimap_t*, time_t timestamp, const char* data_not_terminated, size_t data_bytes, char** ret_server_folder, uint32_t* ret_server_uid);
107 
108 #define MR_MS_ALSO_MOVE 0x01
109 #define MR_MS_SET_MDNSent_FLAG 0x02
110 #define MR_MS_MDNSent_JUST_SET 0x10
111 int mrimap_markseen_msg (mrimap_t*, const char* folder, uint32_t server_uid, int ms_flags, char** ret_server_folder, uint32_t* ret_server_uid, int* ret_ms_flags); /* only returns 0 on connection problems; we should try later again in this case */
112 
113 int mrimap_delete_msg (mrimap_t*, const char* rfc724_mid, const char* folder, uint32_t server_uid); /* only returns 0 on connection problems; we should try later again in this case */
114 
115 void mrimap_heartbeat (mrimap_t*);
116 
117 #ifdef __cplusplus
118 } /* /extern "C" */
119 #endif
120 #endif /* __MRIMAP_H__ */
121 
mrmailbox_t
An object representing a single mailbox.
+
1 /*******************************************************************************
2  *
3  * Delta Chat Core
4  * Copyright (C) 2017 Björn Petersen
5  * Contact: r10s@b44t.com, http://b44t.com
6  *
7  * This program is free software: you can redistribute it and/or modify it under
8  * the terms of the GNU General Public License as published by the Free Software
9  * Foundation, either version 3 of the License, or (at your option) any later
10  * version.
11  *
12  * This program is distributed in the hope that it will be useful, but WITHOUT
13  * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
14  * FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
15  * details.
16  *
17  * You should have received a copy of the GNU General Public License along with
18  * this program. If not, see http://www.gnu.org/licenses/ .
19  *
20  ******************************************************************************/
21 
22 
23 /* Purpose: Reading from IMAP servers with no dependencies to the database.
24 mrmailbox_t is only used for logging and to get information about
25 the online state. */
26 
27 
28 #ifndef __MRIMAP_H__
29 #define __MRIMAP_H__
30 #ifdef __cplusplus
31 extern "C" {
32 #endif
33 
34 
35 typedef struct mrloginparam_t mrloginparam_t;
36 typedef struct mrimap_t mrimap_t;
37 
38 #define MR_IMAP_SEEN 0x0001L
39 
40 typedef char* (*mr_get_config_t) (mrimap_t*, const char*, const char*);
41 typedef void (*mr_set_config_t) (mrimap_t*, const char*, const char*);
42 typedef void (*mr_receive_imf_t) (mrimap_t*, const char* imf_raw_not_terminated, size_t imf_raw_bytes, const char* server_folder, uint32_t server_uid, uint32_t flags);
43 
44 
48 typedef struct mrimap_t
49 {
52  char* m_imap_server;
53  int m_imap_port;
54  char* m_imap_user;
55  char* m_imap_pw;
56  int m_server_flags;
57 
58  int m_connected; /* initally connected and watch thread installed */
59  mailimap* m_hEtpan; /* normally, if connected, m_hEtpan is also set; however, if a reconnection is required, we may lost this handle */
60  pthread_mutex_t m_hEtpanmutex;
61  int m_idle_set_up;
62  char* m_selected_folder;
63  int m_should_reconnect;
64 
65  int m_can_idle;
66  int m_has_xlist;
67  char* m_moveto_folder;/* Folder, where reveived chat messages should go to. Normally "Chats" but may be NULL to leave them in the INBOX */
68  char* m_sent_folder; /* Folder, where send messages should go to. Normally "Chats". */
69  pthread_mutex_t m_idlemutex; /* set, if idle is not possible; morover, the interrupted IDLE thread waits a second before IDLEing again; this allows several jobs to be executed */
70  pthread_mutex_t m_inwait_mutex; /* only used to wait for mailstream_wait_idle()/mailimap_idle_done() to terminate. */
71 
72  pthread_t m_watch_thread;
73  pthread_cond_t m_watch_cond;
74  pthread_mutex_t m_watch_condmutex;
75  int m_watch_condflag;
76  int m_watch_do_exit;
77 
78  time_t m_enter_watch_wait_time;
79 
80  pthread_t m_heartbeat_thread;
81  pthread_cond_t m_heartbeat_cond;
82  pthread_mutex_t m_heartbeat_condmutex;
83 
84  struct mailimap_fetch_type* m_fetch_type_uid;
85  struct mailimap_fetch_type* m_fetch_type_body;
86  struct mailimap_fetch_type* m_fetch_type_flags;
87 
88  mr_get_config_t m_get_config;
89  mr_set_config_t m_set_config;
90  mr_receive_imf_t m_receive_imf;
91  void* m_userData;
92  mrmailbox_t* m_mailbox;
93 
94  int m_log_connect_errors;
95 } mrimap_t;
96 
97 
98 mrimap_t* mrimap_new (mr_get_config_t, mr_set_config_t, mr_receive_imf_t, void* userData, mrmailbox_t*);
99 void mrimap_unref (mrimap_t*);
100 
101 int mrimap_connect (mrimap_t*, const mrloginparam_t*);
102 void mrimap_disconnect (mrimap_t*);
103 int mrimap_is_connected (mrimap_t*);
104 int mrimap_fetch (mrimap_t*);
105 
106 int mrimap_append_msg (mrimap_t*, time_t timestamp, const char* data_not_terminated, size_t data_bytes, char** ret_server_folder, uint32_t* ret_server_uid);
107 
108 #define MR_MS_ALSO_MOVE 0x01
109 #define MR_MS_SET_MDNSent_FLAG 0x02
110 #define MR_MS_MDNSent_JUST_SET 0x10
111 int mrimap_markseen_msg (mrimap_t*, const char* folder, uint32_t server_uid, int ms_flags, char** ret_server_folder, uint32_t* ret_server_uid, int* ret_ms_flags); /* only returns 0 on connection problems; we should try later again in this case */
112 
113 int mrimap_delete_msg (mrimap_t*, const char* rfc724_mid, const char* folder, uint32_t server_uid); /* only returns 0 on connection problems; we should try later again in this case */
114 
115 void mrimap_heartbeat (mrimap_t*);
116 
117 #ifdef __cplusplus
118 } /* /extern "C" */
119 #endif
120 #endif /* __MRIMAP_H__ */
121 
mrmailbox_t
An object representing a single mailbox.
diff --git a/docs/html/mrmailbox-private_8h_source.html b/docs/html/mrmailbox-private_8h_source.html index c48b7154..a4a66e27 100644 --- a/docs/html/mrmailbox-private_8h_source.html +++ b/docs/html/mrmailbox-private_8h_source.html @@ -89,7 +89,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
mrmailbox-private.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_PRIVATE_H__
24 #define __MRMAILBOX_PRIVATE_H__
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28 
29 
30 typedef struct mrimap_t mrimap_t;
31 typedef struct mrsmtp_t mrsmtp_t;
32 typedef struct mrsqlite3_t mrsqlite3_t;
33 typedef struct mrjob_t mrjob_t;
34 typedef struct mrmimeparser_t mrmimeparser_t;
35 
36 
38 struct _mrmailbox
39 {
41  #define MR_MAILBOX_MAGIC 0x11a11807
42  uint32_t m_magic;
44  void* m_userdata;
46  char* m_dbfile;
47  char* m_blobdir;
49  mrsqlite3_t* m_sql;
50  mrimap_t* m_imap;
51  mrsmtp_t* m_smtp;
53  pthread_t m_job_thread;
54  pthread_cond_t m_job_cond;
55  pthread_mutex_t m_job_condmutex;
56  int m_job_condflag;
57  int m_job_do_exit;
59  mrmailboxcb_t m_cb;
61  char* m_os_name;
63  uint32_t m_cmdline_sel_chat_id;
65  int m_wake_lock;
66  pthread_mutex_t m_wake_lock_critical;
68  int m_e2ee_enabled;
70  #define MR_LOG_RINGBUF_SIZE 200
71  pthread_mutex_t m_log_ringbuf_critical;
72  char* m_log_ringbuf[MR_LOG_RINGBUF_SIZE];
74  time_t m_log_ringbuf_times[MR_LOG_RINGBUF_SIZE];
76  int m_log_ringbuf_pos;
78 };
79 
80 
81 uint32_t mrmailbox_send_msg_object (mrmailbox_t*, uint32_t chat_id, mrmsg_t*);
82 void mrmailbox_connect_to_imap (mrmailbox_t*, mrjob_t*);
83 void mrmailbox_wake_lock (mrmailbox_t*);
84 void mrmailbox_wake_unlock (mrmailbox_t*);
85 int mrmailbox_poke_eml_file (mrmailbox_t*, const char* file);
86 int mrmailbox_is_reply_to_known_message__ (mrmailbox_t*, mrmimeparser_t*);
87 int mrmailbox_is_reply_to_messenger_message__ (mrmailbox_t*, mrmimeparser_t*);
88 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);
89 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);
90 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);
91 int mrmailbox_get_archived_count__ (mrmailbox_t*);
92 int mrmailbox_reset_tables (mrmailbox_t*, int bits); /* reset tables but leaves server configuration, 1=jobs, 2=e2ee, 8=rest but server config */
93 size_t mrmailbox_get_real_contact_cnt__ (mrmailbox_t*);
94 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);
95 int mrmailbox_get_contact_origin__ (mrmailbox_t*, uint32_t id, int* ret_blocked);
96 int mrmailbox_is_contact_blocked__ (mrmailbox_t*, uint32_t id);
97 int mrmailbox_real_contact_exists__ (mrmailbox_t*, uint32_t id);
98 int mrmailbox_contact_addr_equals__ (mrmailbox_t*, uint32_t contact_id, const char* other_addr);
99 void mrmailbox_scaleup_contact_origin__ (mrmailbox_t*, uint32_t contact_id, int origin);
100 void mrmailbox_unarchive_chat__ (mrmailbox_t*, uint32_t chat_id);
101 size_t mrmailbox_get_chat_cnt__ (mrmailbox_t*);
102 uint32_t mrmailbox_create_or_lookup_nchat_by_contact_id__ (mrmailbox_t*, uint32_t contact_id);
103 uint32_t mrmailbox_lookup_real_nchat_by_contact_id__ (mrmailbox_t*, uint32_t contact_id);
104 int mrmailbox_get_total_msg_count__ (mrmailbox_t*, uint32_t chat_id);
105 int mrmailbox_get_fresh_msg_count__ (mrmailbox_t*, uint32_t chat_id);
106 uint32_t mrmailbox_get_last_deaddrop_fresh_msg__ (mrmailbox_t*);
107 void mrmailbox_send_msg_to_smtp (mrmailbox_t*, mrjob_t*);
108 void mrmailbox_send_msg_to_imap (mrmailbox_t*, mrjob_t*);
109 int mrmailbox_add_contact_to_chat__ (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
110 int mrmailbox_is_contact_in_chat__ (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
111 int mrmailbox_get_chat_contact_count__ (mrmailbox_t*, uint32_t chat_id);
112 int mrmailbox_group_explicitly_left__ (mrmailbox_t*, const char* grpid);
113 void mrmailbox_set_group_explicitly_left__ (mrmailbox_t*, const char* grpid);
114 size_t mrmailbox_get_real_msg_cnt__ (mrmailbox_t*); /* the number of messages assigned to real chat (!=deaddrop, !=trash) */
115 size_t mrmailbox_get_deaddrop_msg_cnt__ (mrmailbox_t*);
116 int mrmailbox_rfc724_mid_cnt__ (mrmailbox_t*, const char* rfc724_mid);
117 int mrmailbox_rfc724_mid_exists__ (mrmailbox_t*, const char* rfc724_mid, char** ret_server_folder, uint32_t* ret_server_uid);
118 void mrmailbox_update_server_uid__ (mrmailbox_t*, const char* rfc724_mid, const char* server_folder, uint32_t server_uid);
119 void mrmailbox_update_msg_chat_id__ (mrmailbox_t*, uint32_t msg_id, uint32_t chat_id);
120 void mrmailbox_update_msg_state__ (mrmailbox_t*, uint32_t msg_id, int state);
121 void mrmailbox_delete_msg_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
122 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 */
123 void mrmailbox_send_mdn (mrmailbox_t*, mrjob_t* job);
124 void mrmailbox_markseen_msg_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
125 void mrmailbox_markseen_mdn_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
126 int mrmailbox_get_thread_index (void);
127 
128 
129 /* library private: end-to-end-encryption */
130 #define MR_E2EE_DEFAULT_ENABLED 1
131 #define MR_MDNS_DEFAULT_ENABLED 1
132 
133 typedef struct mrmailbox_e2ee_helper_t {
134  int m_encryption_successfull;
135  void* m_cdata_to_free;
136 } mrmailbox_e2ee_helper_t;
137 
138 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*);
139 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 */
140 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! */
141 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 */
142 char* mrmailbox_create_setup_code (mrmailbox_t*);
143 int mrmailbox_render_setup_file (mrmailbox_t* mailbox, const char* passphrase, char** ret_msg);
144 
145 extern int mr_shall_stop_ongoing;
146 int mrmailbox_alloc_ongoing (mrmailbox_t*);
147 void mrmailbox_free_ongoing (mrmailbox_t*);
148 
149 
150 #ifdef __cplusplus
151 } /* /extern "C" */
152 #endif
153 #endif /* __MRMAILBOX_PRIVATE_H__ */
mrarray_t
An object containing a simple array.
+
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_PRIVATE_H__
24 #define __MRMAILBOX_PRIVATE_H__
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28 
29 
30 typedef struct mrimap_t mrimap_t;
31 typedef struct mrsmtp_t mrsmtp_t;
32 typedef struct mrsqlite3_t mrsqlite3_t;
33 typedef struct mrjob_t mrjob_t;
34 typedef struct mrmimeparser_t mrmimeparser_t;
35 
36 
38 struct _mrmailbox
39 {
41  #define MR_MAILBOX_MAGIC 0x11a11807
42  uint32_t m_magic;
44  void* m_userdata;
46  char* m_dbfile;
47  char* m_blobdir;
49  mrsqlite3_t* m_sql;
50  mrimap_t* m_imap;
51  mrsmtp_t* m_smtp;
53  pthread_t m_job_thread;
54  pthread_cond_t m_job_cond;
55  pthread_mutex_t m_job_condmutex;
56  int m_job_condflag;
57  int m_job_do_exit;
59  mrmailboxcb_t m_cb;
61  char* m_os_name;
63  uint32_t m_cmdline_sel_chat_id;
65  int m_wake_lock;
66  pthread_mutex_t m_wake_lock_critical;
68  int m_e2ee_enabled;
70  #define MR_LOG_RINGBUF_SIZE 200
71  pthread_mutex_t m_log_ringbuf_critical;
72  char* m_log_ringbuf[MR_LOG_RINGBUF_SIZE];
74  time_t m_log_ringbuf_times[MR_LOG_RINGBUF_SIZE];
76  int m_log_ringbuf_pos;
78 };
79 
80 
81 uint32_t mrmailbox_send_msg_object (mrmailbox_t*, uint32_t chat_id, mrmsg_t*);
82 void mrmailbox_connect_to_imap (mrmailbox_t*, mrjob_t*);
83 void mrmailbox_wake_lock (mrmailbox_t*);
84 void mrmailbox_wake_unlock (mrmailbox_t*);
85 int mrmailbox_poke_eml_file (mrmailbox_t*, const char* file);
86 int mrmailbox_is_reply_to_known_message__ (mrmailbox_t*, mrmimeparser_t*);
87 int mrmailbox_is_reply_to_messenger_message__ (mrmailbox_t*, mrmimeparser_t*);
88 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);
89 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);
90 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);
91 int mrmailbox_get_archived_count__ (mrmailbox_t*);
92 int mrmailbox_reset_tables (mrmailbox_t*, int bits); /* reset tables but leaves server configuration, 1=jobs, 2=e2ee, 8=rest but server config */
93 int mrmailbox_cleanup_contacts (mrmailbox_t* ths); /* remove all contacts that are not used (e.g. in a chat, or blocked */
94 size_t mrmailbox_get_real_contact_cnt__ (mrmailbox_t*);
95 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);
96 int mrmailbox_get_contact_origin__ (mrmailbox_t*, uint32_t id, int* ret_blocked);
97 int mrmailbox_is_contact_blocked__ (mrmailbox_t*, uint32_t id);
98 int mrmailbox_real_contact_exists__ (mrmailbox_t*, uint32_t id);
99 int mrmailbox_contact_addr_equals__ (mrmailbox_t*, uint32_t contact_id, const char* other_addr);
100 void mrmailbox_scaleup_contact_origin__ (mrmailbox_t*, uint32_t contact_id, int origin);
101 void mrmailbox_unarchive_chat__ (mrmailbox_t*, uint32_t chat_id);
102 size_t mrmailbox_get_chat_cnt__ (mrmailbox_t*);
103 uint32_t mrmailbox_create_or_lookup_nchat_by_contact_id__ (mrmailbox_t*, uint32_t contact_id);
104 uint32_t mrmailbox_lookup_real_nchat_by_contact_id__ (mrmailbox_t*, uint32_t contact_id);
105 int mrmailbox_get_total_msg_count__ (mrmailbox_t*, uint32_t chat_id);
106 int mrmailbox_get_fresh_msg_count__ (mrmailbox_t*, uint32_t chat_id);
107 uint32_t mrmailbox_get_last_deaddrop_fresh_msg__ (mrmailbox_t*);
108 void mrmailbox_send_msg_to_smtp (mrmailbox_t*, mrjob_t*);
109 void mrmailbox_send_msg_to_imap (mrmailbox_t*, mrjob_t*);
110 int mrmailbox_add_contact_to_chat__ (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
111 int mrmailbox_is_contact_in_chat__ (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
112 int mrmailbox_get_chat_contact_count__ (mrmailbox_t*, uint32_t chat_id);
113 int mrmailbox_group_explicitly_left__ (mrmailbox_t*, const char* grpid);
114 void mrmailbox_set_group_explicitly_left__ (mrmailbox_t*, const char* grpid);
115 size_t mrmailbox_get_real_msg_cnt__ (mrmailbox_t*); /* the number of messages assigned to real chat (!=deaddrop, !=trash) */
116 size_t mrmailbox_get_deaddrop_msg_cnt__ (mrmailbox_t*);
117 int mrmailbox_rfc724_mid_cnt__ (mrmailbox_t*, const char* rfc724_mid);
118 int mrmailbox_rfc724_mid_exists__ (mrmailbox_t*, const char* rfc724_mid, char** ret_server_folder, uint32_t* ret_server_uid);
119 void mrmailbox_update_server_uid__ (mrmailbox_t*, const char* rfc724_mid, const char* server_folder, uint32_t server_uid);
120 void mrmailbox_update_msg_chat_id__ (mrmailbox_t*, uint32_t msg_id, uint32_t chat_id);
121 void mrmailbox_update_msg_state__ (mrmailbox_t*, uint32_t msg_id, int state);
122 void mrmailbox_delete_msg_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
123 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 */
124 void mrmailbox_send_mdn (mrmailbox_t*, mrjob_t* job);
125 void mrmailbox_markseen_msg_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
126 void mrmailbox_markseen_mdn_on_imap (mrmailbox_t* mailbox, mrjob_t* job);
127 int mrmailbox_get_thread_index (void);
128 
129 
130 /* library private: end-to-end-encryption */
131 #define MR_E2EE_DEFAULT_ENABLED 1
132 #define MR_MDNS_DEFAULT_ENABLED 1
133 
134 typedef struct mrmailbox_e2ee_helper_t {
135  int m_encryption_successfull;
136  void* m_cdata_to_free;
137 } mrmailbox_e2ee_helper_t;
138 
139 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*);
140 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 */
141 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! */
142 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 */
143 char* mrmailbox_create_setup_code (mrmailbox_t*);
144 int mrmailbox_render_setup_file (mrmailbox_t* mailbox, const char* passphrase, char** ret_msg);
145 
146 extern int mr_shall_stop_ongoing;
147 int mrmailbox_alloc_ongoing (mrmailbox_t*);
148 void mrmailbox_free_ongoing (mrmailbox_t*);
149 
150 
151 #ifdef __cplusplus
152 } /* /extern "C" */
153 #endif
154 #endif /* __MRMAILBOX_PRIVATE_H__ */
mrarray_t
An object containing a simple array.
mrmsg_t
An object representing a single message in memory.
mrmailbox_t
An object representing a single mailbox.
diff --git a/docs/html/mrmailbox_8h_source.html b/docs/html/mrmailbox_8h_source.html index cd035edf..bc4908b7 100644 --- a/docs/html/mrmailbox_8h_source.html +++ b/docs/html/mrmailbox_8h_source.html @@ -89,82 +89,82 @@ 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 12
32 #define MR_VERSION_REVISION 0
33 
34 
150 #ifndef PY_CFFI
151 #include <pthread.h>
152 #include <libetpan/libetpan.h> /* defines uint16_t */
153 #endif
154 
155 #include "mrarray.h"
156 #include "mrchatlist.h"
157 #include "mrchat.h"
158 #include "mrmsg.h"
159 #include "mrcontact.h"
160 #include "mrlot.h"
161 #include "mrevent.h"
162 
163 
173 typedef struct _mrmailbox mrmailbox_t;
174 
175 
191 typedef uintptr_t (*mrmailboxcb_t) (mrmailbox_t*, int event, uintptr_t data1, uintptr_t data2);
192 
193 
194 
195 
196 /* create/open/connect */
197 mrmailbox_t* mrmailbox_new (mrmailboxcb_t, void* userdata, const char* os_name);
198 void mrmailbox_unref (mrmailbox_t*);
199 void* mrmailbox_get_userdata (mrmailbox_t*);
200 
201 int mrmailbox_open (mrmailbox_t*, const char* dbfile, const char* blobdir);
202 void mrmailbox_close (mrmailbox_t*);
203 int mrmailbox_is_open (const mrmailbox_t*);
204 char* mrmailbox_get_blobdir (mrmailbox_t*);
205 
206 int mrmailbox_set_config (mrmailbox_t*, const char* key, const char* value);
207 char* mrmailbox_get_config (mrmailbox_t*, const char* key, const char* def);
208 int mrmailbox_set_config_int (mrmailbox_t*, const char* key, int32_t value);
209 int32_t mrmailbox_get_config_int (mrmailbox_t*, const char* key, int32_t def);
210 char* mrmailbox_get_version_str (void);
211 
212 int mrmailbox_configure_and_connect(mrmailbox_t*);
213 void mrmailbox_stop_ongoing_process(mrmailbox_t*);
214 int mrmailbox_is_configured (mrmailbox_t*);
215 
216 void mrmailbox_connect (mrmailbox_t*);
217 void mrmailbox_disconnect (mrmailbox_t*);
218 
219 char* mrmailbox_get_info (mrmailbox_t*);
220 
221 
222 /* Handle chatlists */
223 #define MR_GCL_ARCHIVED_ONLY 0x01
224 #define MR_GCL_NO_SPECIALS 0x02
225 mrchatlist_t* mrmailbox_get_chatlist (mrmailbox_t*, int flags, const char* query);
226 
227 
228 /* Handle chats */
229 uint32_t mrmailbox_create_chat_by_contact_id (mrmailbox_t*, uint32_t contact_id);
230 uint32_t mrmailbox_get_chat_id_by_contact_id (mrmailbox_t*, uint32_t contact_id);
231 
232 uint32_t mrmailbox_send_text_msg (mrmailbox_t*, uint32_t chat_id, const char* text_to_send);
233 uint32_t mrmailbox_send_image_msg (mrmailbox_t*, uint32_t chat_id, const char* file, const char* filemime, int width, int height);
234 uint32_t mrmailbox_send_video_msg (mrmailbox_t*, uint32_t chat_id, const char* file, const char* filemime, int width, int height, int duration);
235 uint32_t mrmailbox_send_voice_msg (mrmailbox_t*, uint32_t chat_id, const char* file, const char* filemime, int duration);
236 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);
237 uint32_t mrmailbox_send_file_msg (mrmailbox_t*, uint32_t chat_id, const char* file, const char* filemime);
238 uint32_t mrmailbox_send_vcard_msg (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
239 void mrmailbox_set_draft (mrmailbox_t*, uint32_t chat_id, const char*);
240 
241 #define MR_GCM_ADDDAYMARKER 0x01
242 mrarray_t* mrmailbox_get_chat_msgs (mrmailbox_t*, uint32_t chat_id, uint32_t flags, uint32_t marker1before);
243 int mrmailbox_get_total_msg_count (mrmailbox_t*, uint32_t chat_id);
244 int mrmailbox_get_fresh_msg_count (mrmailbox_t*, uint32_t chat_id);
245 mrarray_t* mrmailbox_get_fresh_msgs (mrmailbox_t*);
246 void mrmailbox_marknoticed_chat (mrmailbox_t*, uint32_t chat_id);
247 mrarray_t* mrmailbox_get_chat_media (mrmailbox_t*, uint32_t chat_id, int msg_type, int or_msg_type);
248 uint32_t mrmailbox_get_next_media (mrmailbox_t*, uint32_t curr_msg_id, int dir);
249 
250 void mrmailbox_archive_chat (mrmailbox_t*, uint32_t chat_id, int archive);
251 void mrmailbox_delete_chat (mrmailbox_t*, uint32_t chat_id);
252 
253 mrarray_t* mrmailbox_get_chat_contacts (mrmailbox_t*, uint32_t chat_id);
254 mrarray_t* mrmailbox_search_msgs (mrmailbox_t*, uint32_t chat_id, const char* query);
255 
256 mrchat_t* mrmailbox_get_chat (mrmailbox_t*, uint32_t chat_id);
257 
258 
259 /* Handle group chats */
260 uint32_t mrmailbox_create_group_chat (mrmailbox_t*, const char* name);
261 int mrmailbox_is_contact_in_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
262 int mrmailbox_add_contact_to_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
263 int mrmailbox_remove_contact_from_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
264 int mrmailbox_set_chat_name (mrmailbox_t*, uint32_t chat_id, const char* name);
265 int mrmailbox_set_chat_profile_image (mrmailbox_t*, uint32_t chat_id, const char* image);
266 
267 
268 /* Handle messages */
269 char* mrmailbox_get_msg_info (mrmailbox_t*, uint32_t msg_id);
270 void mrmailbox_delete_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt);
271 void mrmailbox_forward_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt, uint32_t chat_id);
272 void mrmailbox_marknoticed_contact (mrmailbox_t*, uint32_t contact_id);
273 void mrmailbox_markseen_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt);
274 void mrmailbox_star_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt, int star);
275 mrmsg_t* mrmailbox_get_msg (mrmailbox_t*, uint32_t msg_id);
276 
277 
278 /* Handle contacts */
279 uint32_t mrmailbox_create_contact (mrmailbox_t*, const char* name, const char* addr);
280 int mrmailbox_add_address_book (mrmailbox_t*, const char*);
281 mrarray_t* mrmailbox_get_known_contacts (mrmailbox_t*, const char* query);
282 int mrmailbox_get_blocked_count (mrmailbox_t*);
283 mrarray_t* mrmailbox_get_blocked_contacts (mrmailbox_t*);
284 void mrmailbox_block_contact (mrmailbox_t*, uint32_t contact_id, int block);
285 char* mrmailbox_get_contact_encrinfo (mrmailbox_t*, uint32_t contact_id);
286 int mrmailbox_delete_contact (mrmailbox_t*, uint32_t contact_id);
287 mrcontact_t* mrmailbox_get_contact (mrmailbox_t*, uint32_t contact_id);
288 
289 
290 /* Import/export and Tools */
291 #define MR_IMEX_EXPORT_SELF_KEYS 1 /* param1 is a directory where the keys are written to */
292 #define MR_IMEX_IMPORT_SELF_KEYS 2 /* param1 is a directory where the keys are searched in and read from */
293 #define MR_IMEX_EXPORT_BACKUP 11 /* param1 is a directory where the backup is written to */
294 #define MR_IMEX_IMPORT_BACKUP 12 /* param1 is the file with the backup to import */
295 #define MR_BAK_PREFIX "delta-chat"
296 #define MR_BAK_SUFFIX "bak"
297 int mrmailbox_imex (mrmailbox_t*, int what, const char* param1, const char* param2);
298 char* mrmailbox_imex_has_backup (mrmailbox_t*, const char* dir);
299 int mrmailbox_check_password (mrmailbox_t*, const char* pw);
300 char* mrmailbox_initiate_key_transfer(mrmailbox_t*);
301 int mrmailbox_continue_key_transfer(mrmailbox_t*, uint32_t msg_id, const char* setup_code);
302 void mrmailbox_heartbeat (mrmailbox_t*);
303 
304 
305 /* logging */
306 void mrmailbox_log_error (mrmailbox_t*, int code, const char* msg, ...);
307 void mrmailbox_log_error_if (int* condition, mrmailbox_t*, int code, const char* msg, ...);
308 void mrmailbox_log_warning (mrmailbox_t*, int code, const char* msg, ...);
309 void mrmailbox_log_info (mrmailbox_t*, int code, const char* msg, ...);
310 
311 
312 /* error codes */
313 #define MR_ERR_SELF_NOT_IN_GROUP 1
314 #define MR_ERR_NONETWORK 2
315 
316 
317 /* deprecated functions */
318 int mrchat_set_draft (mrchat_t*, const char* msg); /* deprecated - use mrmailbox_set_draft() instead */
319 #define mrpoortext_t mrlot_t
320 #define mrpoortext_unref mrlot_unref
321 #define mrmailbox_imex_cancel mrmailbox_stop_ongoing_process
322 #define mrmailbox_configure_cancel mrmailbox_stop_ongoing_process
323 
324 
325 #ifdef __cplusplus
326 } /* /extern "C" */
327 #endif
328 #endif /* __MRMAILBOX_H__ */
mrarray_t
An object containing a simple array.
+
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 13
32 #define MR_VERSION_REVISION 0
33 
34 
150 #ifndef PY_CFFI
151 #include <pthread.h>
152 #include <libetpan/libetpan.h> /* defines uint16_t */
153 #endif
154 
155 #include "mrarray.h"
156 #include "mrchatlist.h"
157 #include "mrchat.h"
158 #include "mrmsg.h"
159 #include "mrcontact.h"
160 #include "mrlot.h"
161 #include "mrevent.h"
162 
163 
173 typedef struct _mrmailbox mrmailbox_t;
174 
175 
191 typedef uintptr_t (*mrmailboxcb_t) (mrmailbox_t*, int event, uintptr_t data1, uintptr_t data2);
192 
193 
194 
195 
196 /* create/open/connect */
197 mrmailbox_t* mrmailbox_new (mrmailboxcb_t, void* userdata, const char* os_name);
198 void mrmailbox_unref (mrmailbox_t*);
199 void* mrmailbox_get_userdata (mrmailbox_t*);
200 
201 int mrmailbox_open (mrmailbox_t*, const char* dbfile, const char* blobdir);
202 void mrmailbox_close (mrmailbox_t*);
203 int mrmailbox_is_open (const mrmailbox_t*);
204 char* mrmailbox_get_blobdir (mrmailbox_t*);
205 
206 int mrmailbox_set_config (mrmailbox_t*, const char* key, const char* value);
207 char* mrmailbox_get_config (mrmailbox_t*, const char* key, const char* def);
208 int mrmailbox_set_config_int (mrmailbox_t*, const char* key, int32_t value);
209 int32_t mrmailbox_get_config_int (mrmailbox_t*, const char* key, int32_t def);
210 char* mrmailbox_get_version_str (void);
211 
212 int mrmailbox_configure_and_connect(mrmailbox_t*);
213 void mrmailbox_stop_ongoing_process(mrmailbox_t*);
214 int mrmailbox_is_configured (mrmailbox_t*);
215 
216 void mrmailbox_connect (mrmailbox_t*);
217 void mrmailbox_disconnect (mrmailbox_t*);
218 
219 char* mrmailbox_get_info (mrmailbox_t*);
220 
221 
222 /* Handle chatlists */
223 #define MR_GCL_ARCHIVED_ONLY 0x01
224 #define MR_GCL_NO_SPECIALS 0x02
225 mrchatlist_t* mrmailbox_get_chatlist (mrmailbox_t*, int flags, const char* query);
226 
227 
228 /* Handle chats */
229 uint32_t mrmailbox_create_chat_by_contact_id (mrmailbox_t*, uint32_t contact_id);
230 uint32_t mrmailbox_get_chat_id_by_contact_id (mrmailbox_t*, uint32_t contact_id);
231 
232 uint32_t mrmailbox_send_text_msg (mrmailbox_t*, uint32_t chat_id, const char* text_to_send);
233 uint32_t mrmailbox_send_image_msg (mrmailbox_t*, uint32_t chat_id, const char* file, const char* filemime, int width, int height);
234 uint32_t mrmailbox_send_video_msg (mrmailbox_t*, uint32_t chat_id, const char* file, const char* filemime, int width, int height, int duration);
235 uint32_t mrmailbox_send_voice_msg (mrmailbox_t*, uint32_t chat_id, const char* file, const char* filemime, int duration);
236 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);
237 uint32_t mrmailbox_send_file_msg (mrmailbox_t*, uint32_t chat_id, const char* file, const char* filemime);
238 uint32_t mrmailbox_send_vcard_msg (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
239 void mrmailbox_set_draft (mrmailbox_t*, uint32_t chat_id, const char*);
240 
241 #define MR_GCM_ADDDAYMARKER 0x01
242 mrarray_t* mrmailbox_get_chat_msgs (mrmailbox_t*, uint32_t chat_id, uint32_t flags, uint32_t marker1before);
243 int mrmailbox_get_total_msg_count (mrmailbox_t*, uint32_t chat_id);
244 int mrmailbox_get_fresh_msg_count (mrmailbox_t*, uint32_t chat_id);
245 mrarray_t* mrmailbox_get_fresh_msgs (mrmailbox_t*);
246 void mrmailbox_marknoticed_chat (mrmailbox_t*, uint32_t chat_id);
247 mrarray_t* mrmailbox_get_chat_media (mrmailbox_t*, uint32_t chat_id, int msg_type, int or_msg_type);
248 uint32_t mrmailbox_get_next_media (mrmailbox_t*, uint32_t curr_msg_id, int dir);
249 
250 void mrmailbox_archive_chat (mrmailbox_t*, uint32_t chat_id, int archive);
251 void mrmailbox_delete_chat (mrmailbox_t*, uint32_t chat_id);
252 
253 mrarray_t* mrmailbox_get_chat_contacts (mrmailbox_t*, uint32_t chat_id);
254 mrarray_t* mrmailbox_search_msgs (mrmailbox_t*, uint32_t chat_id, const char* query);
255 
256 mrchat_t* mrmailbox_get_chat (mrmailbox_t*, uint32_t chat_id);
257 
258 
259 /* Handle group chats */
260 uint32_t mrmailbox_create_group_chat (mrmailbox_t*, const char* name);
261 int mrmailbox_is_contact_in_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
262 int mrmailbox_add_contact_to_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
263 int mrmailbox_remove_contact_from_chat (mrmailbox_t*, uint32_t chat_id, uint32_t contact_id);
264 int mrmailbox_set_chat_name (mrmailbox_t*, uint32_t chat_id, const char* name);
265 int mrmailbox_set_chat_profile_image (mrmailbox_t*, uint32_t chat_id, const char* image);
266 
267 
268 /* Handle messages */
269 char* mrmailbox_get_msg_info (mrmailbox_t*, uint32_t msg_id);
270 void mrmailbox_delete_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt);
271 void mrmailbox_forward_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt, uint32_t chat_id);
272 void mrmailbox_marknoticed_contact (mrmailbox_t*, uint32_t contact_id);
273 void mrmailbox_markseen_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt);
274 void mrmailbox_star_msgs (mrmailbox_t*, const uint32_t* msg_ids, int msg_cnt, int star);
275 mrmsg_t* mrmailbox_get_msg (mrmailbox_t*, uint32_t msg_id);
276 
277 
278 /* Handle contacts */
279 uint32_t mrmailbox_create_contact (mrmailbox_t*, const char* name, const char* addr);
280 int mrmailbox_add_address_book (mrmailbox_t*, const char*);
281 mrarray_t* mrmailbox_get_known_contacts (mrmailbox_t*, const char* query);
282 int mrmailbox_get_blocked_count (mrmailbox_t*);
283 mrarray_t* mrmailbox_get_blocked_contacts (mrmailbox_t*);
284 void mrmailbox_block_contact (mrmailbox_t*, uint32_t contact_id, int block);
285 char* mrmailbox_get_contact_encrinfo (mrmailbox_t*, uint32_t contact_id);
286 int mrmailbox_delete_contact (mrmailbox_t*, uint32_t contact_id);
287 mrcontact_t* mrmailbox_get_contact (mrmailbox_t*, uint32_t contact_id);
288 
289 
290 /* Import/export and Tools */
291 #define MR_IMEX_EXPORT_SELF_KEYS 1 /* param1 is a directory where the keys are written to */
292 #define MR_IMEX_IMPORT_SELF_KEYS 2 /* param1 is a directory where the keys are searched in and read from */
293 #define MR_IMEX_EXPORT_BACKUP 11 /* param1 is a directory where the backup is written to */
294 #define MR_IMEX_IMPORT_BACKUP 12 /* param1 is the file with the backup to import */
295 #define MR_BAK_PREFIX "delta-chat"
296 #define MR_BAK_SUFFIX "bak"
297 int mrmailbox_imex (mrmailbox_t*, int what, const char* param1, const char* param2);
298 char* mrmailbox_imex_has_backup (mrmailbox_t*, const char* dir);
299 int mrmailbox_check_password (mrmailbox_t*, const char* pw);
300 char* mrmailbox_initiate_key_transfer(mrmailbox_t*);
301 int mrmailbox_continue_key_transfer(mrmailbox_t*, uint32_t msg_id, const char* setup_code);
302 void mrmailbox_heartbeat (mrmailbox_t*);
303 
304 
305 /* logging */
306 void mrmailbox_log_error (mrmailbox_t*, int code, const char* msg, ...);
307 void mrmailbox_log_error_if (int* condition, mrmailbox_t*, int code, const char* msg, ...);
308 void mrmailbox_log_warning (mrmailbox_t*, int code, const char* msg, ...);
309 void mrmailbox_log_info (mrmailbox_t*, int code, const char* msg, ...);
310 
311 
312 /* error codes */
313 #define MR_ERR_SELF_NOT_IN_GROUP 1
314 #define MR_ERR_NONETWORK 2
315 
316 
317 /* deprecated functions */
318 int mrchat_set_draft (mrchat_t*, const char* msg); /* deprecated - use mrmailbox_set_draft() instead */
319 #define mrpoortext_t mrlot_t
320 #define mrpoortext_unref mrlot_unref
321 #define mrmailbox_imex_cancel mrmailbox_stop_ongoing_process
322 #define mrmailbox_configure_cancel mrmailbox_stop_ongoing_process
323 
324 
325 #ifdef __cplusplus
326 } /* /extern "C" */
327 #endif
328 #endif /* __MRMAILBOX_H__ */
mrarray_t
An object containing a simple array.
mrmailbox_t::mrmailbox_set_config
int mrmailbox_set_config(mrmailbox_t *ths, const char *key, const char *value)
Configure the mailbox.
Definition: mrmailbox.c:1210
-
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:4403
-
mrmailbox_t::mrmailbox_get_contact
mrcontact_t * mrmailbox_get_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Get a single contact object.
Definition: mrmailbox.c:4624
-
mrmailbox_t::mrmailbox_forward_msgs
void mrmailbox_forward_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt, uint32_t chat_id)
Forward messages to another chat.
Definition: mrmailbox.c:5277
+
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:4474
+
mrmailbox_t::mrmailbox_get_contact
mrcontact_t * mrmailbox_get_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Get a single contact object.
Definition: mrmailbox.c:4695
+
mrmailbox_t::mrmailbox_forward_msgs
void mrmailbox_forward_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt, uint32_t chat_id)
Forward messages to another chat.
Definition: mrmailbox.c:5345
mrevent.h
The following constants are used as events reported to the callback given to mrmailbox_new().
mrmailbox_t::mrmailbox_get_config_int
int32_t mrmailbox_get_config_int(mrmailbox_t *ths, const char *key, int32_t def)
Get a configuration option.
Definition: mrmailbox.c:1285
-
mrmailbox_t::mrmailbox_get_msg_info
char * mrmailbox_get_msg_info(mrmailbox_t *mailbox, uint32_t msg_id)
Get an informational text for a single message.
Definition: mrmailbox.c:5152
-
mrmailbox_t::mrmailbox_get_total_msg_count
int mrmailbox_get_total_msg_count(mrmailbox_t *mailbox, uint32_t chat_id)
Get the total number of messages in a chat.
Definition: mrmailbox.c:2635
+
mrmailbox_t::mrmailbox_get_msg_info
char * mrmailbox_get_msg_info(mrmailbox_t *mailbox, uint32_t msg_id)
Get an informational text for a single message.
Definition: mrmailbox.c:5223
+
mrmailbox_t::mrmailbox_get_total_msg_count
int mrmailbox_get_total_msg_count(mrmailbox_t *mailbox, uint32_t chat_id)
Get the total number of messages in a chat.
Definition: mrmailbox.c:2670
mrmailbox_t::mrmailbox_set_config_int
int mrmailbox_set_config_int(mrmailbox_t *ths, const char *key, int32_t value)
Configure the mailbox.
Definition: mrmailbox.c:1263
-
mrmailbox_t::mrmailbox_get_next_media
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:1969
+
mrmailbox_t::mrmailbox_get_next_media
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:2004
mrmailbox_t::mrmailbox_get_info
char * mrmailbox_get_info(mrmailbox_t *mailbox)
Get information about the mailbox.
Definition: mrmailbox.c:1311
mrmailbox_t::mrmailbox_is_open
int mrmailbox_is_open(const mrmailbox_t *mailbox)
Check if the mailbox database is open.
Definition: mrmailbox.c:1124
-
mrmailbox_t::mrmailbox_markseen_msgs
void mrmailbox_markseen_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt)
Mark a message as seen, updates the IMAP state and sends MDNs.
Definition: mrmailbox.c:5646
-
mrmailbox_t::mrmailbox_is_contact_in_chat
int mrmailbox_is_contact_in_chat(mrmailbox_t *mailbox, uint32_t chat_id, uint32_t contact_id)
Check if a given contact ID is a member of a group chat.
Definition: mrmailbox.c:3923
+
mrmailbox_t::mrmailbox_markseen_msgs
void mrmailbox_markseen_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt)
Mark a message as seen, updates the IMAP state and sends MDNs.
Definition: mrmailbox.c:5714
+
mrmailbox_t::mrmailbox_is_contact_in_chat
int mrmailbox_is_contact_in_chat(mrmailbox_t *mailbox, uint32_t chat_id, uint32_t contact_id)
Check if a given contact ID is a member of a group chat.
Definition: mrmailbox.c:3994
mrmailbox_t::mrmailbox_open
int mrmailbox_open(mrmailbox_t *mailbox, const char *dbfile, const char *blobdir)
Open mailbox database.
Definition: mrmailbox.c:1025
-
mrmailbox_t::mrmailbox_get_fresh_msgs
mrarray_t * mrmailbox_get_fresh_msgs(mrmailbox_t *mailbox)
Returns the message IDs of all fresh messages of any chat.
Definition: mrmailbox.c:2094
+
mrmailbox_t::mrmailbox_get_fresh_msgs
mrarray_t * mrmailbox_get_fresh_msgs(mrmailbox_t *mailbox)
Returns the message IDs of all fresh messages of any chat.
Definition: mrmailbox.c:2129
mrmailbox_t::mrmailboxcb_t
uintptr_t(* mrmailboxcb_t)(mrmailbox_t *, int event, uintptr_t data1, uintptr_t data2)
Callback function that should be given to mrmailbox_new().
Definition: mrmailbox.h:191
-
mrmailbox_t::mrmailbox_archive_chat
void mrmailbox_archive_chat(mrmailbox_t *mailbox, uint32_t chat_id, int archive)
Archive or unarchive a chat.
Definition: mrmailbox.c:2703
-
mrmailbox_t::mrmailbox_add_contact_to_chat
int mrmailbox_add_contact_to_chat(mrmailbox_t *mailbox, uint32_t chat_id, uint32_t contact_id)
Add a member to a group.
Definition: mrmailbox.c:3959
-
mrmailbox_t::mrmailbox_marknoticed_chat
void mrmailbox_marknoticed_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Mark all message in a chat as noticed.
Definition: mrmailbox.c:1790
-
mrmailbox_t::mrmailbox_send_file_msg
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:3522
-
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 a given chat.
Definition: mrmailbox.c:3307
-
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:4360
-
mrmailbox_t::mrmailbox_star_msgs
void mrmailbox_star_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt, int star)
Star/unstar messages by setting the last parameter to 0 (unstar) or 1(star).
Definition: mrmailbox.c:5363
+
mrmailbox_t::mrmailbox_archive_chat
void mrmailbox_archive_chat(mrmailbox_t *mailbox, uint32_t chat_id, int archive)
Archive or unarchive a chat.
Definition: mrmailbox.c:2738
+
mrmailbox_t::mrmailbox_add_contact_to_chat
int mrmailbox_add_contact_to_chat(mrmailbox_t *mailbox, uint32_t chat_id, uint32_t contact_id)
Add a member to a group.
Definition: mrmailbox.c:4030
+
mrmailbox_t::mrmailbox_marknoticed_chat
void mrmailbox_marknoticed_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Mark all messages in a chat as noticed.
Definition: mrmailbox.c:1825
+
mrmailbox_t::mrmailbox_send_file_msg
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:3596
+
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 a given chat.
Definition: mrmailbox.c:3381
+
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:4431
+
mrmailbox_t::mrmailbox_star_msgs
void mrmailbox_star_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt, int star)
Star/unstar messages by setting the last parameter to 0 (unstar) or 1 (star).
Definition: mrmailbox.c:5431
mrmailbox_t::mrmailbox_configure_and_connect
int mrmailbox_configure_and_connect(mrmailbox_t *mailbox)
Configure and connect a mailbox.
Definition: mrmailbox_configure.c:393
mrchatlist_t
An object representing a single chatlist in memory.
-
mrmailbox_t::mrmailbox_marknoticed_contact
void mrmailbox_marknoticed_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Mark all messages send by the given contact as noticed.
Definition: mrmailbox.c:4663
+
mrmailbox_t::mrmailbox_marknoticed_contact
void mrmailbox_marknoticed_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Mark all messages sent by the given contact as noticed.
Definition: mrmailbox.c:4734
mrmailbox_t::mrmailbox_continue_key_transfer
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
mrmailbox_t::mrmailbox_stop_ongoing_process
void mrmailbox_stop_ongoing_process(mrmailbox_t *mailbox)
Signal an ongoing process to stop.
Definition: mrmailbox_configure.c:789
mrmailbox_t::mrmailbox_get_blobdir
char * mrmailbox_get_blobdir(mrmailbox_t *mailbox)
Get the blob directory.
Definition: mrmailbox.c:1144
mrmailbox_t::mrmailbox_imex
int mrmailbox_imex(mrmailbox_t *mailbox, int what, const char *param1, const char *param2)
Import/export things.
Definition: mrmailbox_imex.c:1111
-
mrmailbox_t::mrmailbox_send_video_msg
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:3393
-
mrmailbox_t::mrmailbox_get_fresh_msg_count
int mrmailbox_get_fresh_msg_count(mrmailbox_t *mailbox, uint32_t chat_id)
Get the number of fresh messages in a chat.
Definition: mrmailbox.c:2663
-
mrmailbox_t::mrmailbox_search_msgs
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:2266
+
mrmailbox_t::mrmailbox_send_video_msg
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 a video to a chat.
Definition: mrmailbox.c:3467
+
mrmailbox_t::mrmailbox_get_fresh_msg_count
int mrmailbox_get_fresh_msg_count(mrmailbox_t *mailbox, uint32_t chat_id)
Get the number of fresh messages in a chat.
Definition: mrmailbox.c:2698
+
mrmailbox_t::mrmailbox_search_msgs
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:2301
mrmailbox_t::mrmailbox_initiate_key_transfer
char * mrmailbox_initiate_key_transfer(mrmailbox_t *mailbox)
Initiate Autocrypt Key Transfer.
Definition: mrmailbox_imex.c:470
-
mrmailbox_t::mrmailbox_send_vcard_msg
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:3570
-
mrmailbox_t::mrmailbox_get_chatlist
mrchatlist_t * mrmailbox_get_chatlist(mrmailbox_t *mailbox, int listflags, const char *query)
Get a list of chats.
Definition: mrmailbox.c:1692
+
mrmailbox_t::mrmailbox_send_vcard_msg
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:3641
+
mrmailbox_t::mrmailbox_get_chatlist
mrchatlist_t * mrmailbox_get_chatlist(mrmailbox_t *mailbox, int listflags, const char *query)
Get a list of chats.
Definition: mrmailbox.c:1727
mrmailbox_t::mrmailbox_close
void mrmailbox_close(mrmailbox_t *mailbox)
Close mailbox database.
Definition: mrmailbox.c:1090
-
mrmailbox_t::mrmailbox_set_chat_profile_image
int mrmailbox_set_chat_profile_image(mrmailbox_t *mailbox, uint32_t chat_id, const char *new_image)
Set group profile image.
Definition: mrmailbox.c:3834
-
mrmailbox_t::mrmailbox_get_blocked_contacts
mrarray_t * mrmailbox_get_blocked_contacts(mrmailbox_t *mailbox)
Get blocked contacts.
Definition: mrmailbox.c:4544
+
mrmailbox_t::mrmailbox_set_chat_profile_image
int mrmailbox_set_chat_profile_image(mrmailbox_t *mailbox, uint32_t chat_id, const char *new_image)
Set group profile image.
Definition: mrmailbox.c:3905
+
mrmailbox_t::mrmailbox_get_blocked_contacts
mrarray_t * mrmailbox_get_blocked_contacts(mrmailbox_t *mailbox)
Get blocked contacts.
Definition: mrmailbox.c:4615
mrmsg_t
An object representing a single message in memory.
mrmailbox_t
An object representing a single mailbox.
-
mrmailbox_t::mrmailbox_get_chat_msgs
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:2162
-
mrmailbox_t::mrmailbox_get_blocked_count
int mrmailbox_get_blocked_count(mrmailbox_t *mailbox)
Get the number of blocked contacts.
Definition: mrmailbox.c:4578
-
mrmailbox_t::mrmailbox_send_voice_msg
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:3437
-
mrmailbox_t::mrmailbox_set_draft
void mrmailbox_set_draft(mrmailbox_t *mailbox, uint32_t chat_id, const char *msg)
Save a draft for a chat.
Definition: mrmailbox.c:2415
-
mrmailbox_t::mrmailbox_get_chat_media
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:1935
-
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:3685
+
mrmailbox_t::mrmailbox_get_chat_msgs
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:2197
+
mrmailbox_t::mrmailbox_get_blocked_count
int mrmailbox_get_blocked_count(mrmailbox_t *mailbox)
Get the number of blocked contacts.
Definition: mrmailbox.c:4649
+
mrmailbox_t::mrmailbox_send_voice_msg
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:3511
+
mrmailbox_t::mrmailbox_set_draft
void mrmailbox_set_draft(mrmailbox_t *mailbox, uint32_t chat_id, const char *msg)
Save a draft for a chat.
Definition: mrmailbox.c:2450
+
mrmailbox_t::mrmailbox_get_chat_media
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:1970
+
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:3756
mrmailbox_t::mrmailbox_imex_has_backup
char * mrmailbox_imex_has_backup(mrmailbox_t *mailbox, const char *dir_name)
Check if there is a backup file.
Definition: mrmailbox_imex.c:1237
-
mrmailbox_t::mrmailbox_get_chat_id_by_contact_id
uint32_t mrmailbox_get_chat_id_by_contact_id(mrmailbox_t *mailbox, uint32_t contact_id)
Check, if there is a normal chat with a given contact.
Definition: mrmailbox.c:1824
-
mrmailbox_t::mrmailbox_send_image_msg
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:3348
-
mrmailbox_t::mrmailbox_remove_contact_from_chat
int mrmailbox_remove_contact_from_chat(mrmailbox_t *mailbox, uint32_t chat_id, uint32_t contact_id)
Remove a member from a group.
Definition: mrmailbox.c:4044
+
mrmailbox_t::mrmailbox_get_chat_id_by_contact_id
uint32_t mrmailbox_get_chat_id_by_contact_id(mrmailbox_t *mailbox, uint32_t contact_id)
Check, if there is a normal chat with a given contact.
Definition: mrmailbox.c:1859
+
mrmailbox_t::mrmailbox_send_image_msg
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:3422
+
mrmailbox_t::mrmailbox_remove_contact_from_chat
int mrmailbox_remove_contact_from_chat(mrmailbox_t *mailbox, uint32_t chat_id, uint32_t contact_id)
Remove a member from a group.
Definition: mrmailbox.c:4115
mrmailbox_t::mrmailbox_check_password
int mrmailbox_check_password(mrmailbox_t *mailbox, const char *test_pw)
Check if the user is authorized by the given password in some way.
Definition: mrmailbox_imex.c:1303
-
mrmailbox_t::mrmailbox_delete_contact
int mrmailbox_delete_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Delete a contact.
Definition: mrmailbox.c:4914
-
mrmailbox_t::mrmailbox_get_chat
mrchat_t * mrmailbox_get_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Get chat object by a chat ID.
Definition: mrmailbox.c:1740
+
mrmailbox_t::mrmailbox_delete_contact
int mrmailbox_delete_contact(mrmailbox_t *mailbox, uint32_t contact_id)
Delete a contact.
Definition: mrmailbox.c:4985
+
mrmailbox_t::mrmailbox_get_chat
mrchat_t * mrmailbox_get_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Get chat object by a chat ID.
Definition: mrmailbox.c:1775
mrmailbox_t::mrmailbox_unref
void mrmailbox_unref(mrmailbox_t *mailbox)
Free a mailbox object.
Definition: mrmailbox.c:946
-
mrmailbox_t::mrmailbox_get_contact_encrinfo
char * mrmailbox_get_contact_encrinfo(mrmailbox_t *mailbox, uint32_t contact_id)
Get encryption info for a contact.
Definition: mrmailbox.c:4780
-
mrmailbox_t::mrmailbox_delete_msgs
void mrmailbox_delete_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt)
Delete messages.
Definition: mrmailbox.c:5505
-
mrmailbox_t::mrmailbox_get_known_contacts
mrarray_t * mrmailbox_get_known_contacts(mrmailbox_t *mailbox, const char *query)
Returns known and unblocked contacts.
Definition: mrmailbox.c:4458
-
mrmailbox_t::mrmailbox_delete_chat
void mrmailbox_delete_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Delete a chat.
Definition: mrmailbox.c:2824
-
mrmailbox_t::mrmailbox_block_contact
void mrmailbox_block_contact(mrmailbox_t *mailbox, uint32_t contact_id, int new_blocking)
Block or unblock a contact.
Definition: mrmailbox.c:4689
-
mrmailbox_t::mrmailbox_get_chat_contacts
mrarray_t * mrmailbox_get_chat_contacts(mrmailbox_t *mailbox, uint32_t chat_id)
Get contact IDs belonging to a chat.
Definition: mrmailbox.c:2045
-
mrmailbox_t::mrmailbox_heartbeat
void mrmailbox_heartbeat(mrmailbox_t *ths)
Stay alive.
Definition: mrmailbox.c:1660
-
mrmailbox_t::mrmailbox_get_msg
mrmsg_t * mrmailbox_get_msg(mrmailbox_t *mailbox, uint32_t msg_id)
Get a single message object of the type mrmsg_t.
Definition: mrmailbox.c:5106
-
mrmailbox_t::mrmailbox_disconnect
void mrmailbox_disconnect(mrmailbox_t *mailbox)
Disonnect the mailbox from the server.
Definition: mrmailbox.c:1635
+
mrmailbox_t::mrmailbox_get_contact_encrinfo
char * mrmailbox_get_contact_encrinfo(mrmailbox_t *mailbox, uint32_t contact_id)
Get encryption info for a contact.
Definition: mrmailbox.c:4851
+
mrmailbox_t::mrmailbox_delete_msgs
void mrmailbox_delete_msgs(mrmailbox_t *mailbox, const uint32_t *msg_ids, int msg_cnt)
Delete messages.
Definition: mrmailbox.c:5573
+
mrmailbox_t::mrmailbox_get_known_contacts
mrarray_t * mrmailbox_get_known_contacts(mrmailbox_t *mailbox, const char *query)
Returns known and unblocked contacts.
Definition: mrmailbox.c:4529
+
mrmailbox_t::mrmailbox_delete_chat
void mrmailbox_delete_chat(mrmailbox_t *mailbox, uint32_t chat_id)
Delete a chat.
Definition: mrmailbox.c:2859
+
mrmailbox_t::mrmailbox_block_contact
void mrmailbox_block_contact(mrmailbox_t *mailbox, uint32_t contact_id, int new_blocking)
Block or unblock a contact.
Definition: mrmailbox.c:4760
+
mrmailbox_t::mrmailbox_get_chat_contacts
mrarray_t * mrmailbox_get_chat_contacts(mrmailbox_t *mailbox, uint32_t chat_id)
Get contact IDs belonging to a chat.
Definition: mrmailbox.c:2080
+
mrmailbox_t::mrmailbox_heartbeat
void mrmailbox_heartbeat(mrmailbox_t *ths)
Stay alive.
Definition: mrmailbox.c:1695
+
mrmailbox_t::mrmailbox_get_msg
mrmsg_t * mrmailbox_get_msg(mrmailbox_t *mailbox, uint32_t msg_id)
Get a single message object of the type mrmsg_t.
Definition: mrmailbox.c:5177
+
mrmailbox_t::mrmailbox_disconnect
void mrmailbox_disconnect(mrmailbox_t *mailbox)
Disonnect the mailbox from the server.
Definition: mrmailbox.c:1670
mrchat_t
An object representing a single chat in memory.
mrmailbox_t::mrmailbox_is_configured
int mrmailbox_is_configured(mrmailbox_t *mailbox)
Check if the mailbox is already configured.
Definition: mrmailbox_configure.c:705
-
mrmailbox_t::mrmailbox_create_chat_by_contact_id
uint32_t mrmailbox_create_chat_by_contact_id(mrmailbox_t *mailbox, uint32_t contact_id)
Create a normal chat with a single user.
Definition: mrmailbox.c:1855
+
mrmailbox_t::mrmailbox_create_chat_by_contact_id
uint32_t mrmailbox_create_chat_by_contact_id(mrmailbox_t *mailbox, uint32_t contact_id)
Create a normal chat with a single user.
Definition: mrmailbox.c:1890
mrmailbox_t::mrmailbox_get_userdata
void * mrmailbox_get_userdata(mrmailbox_t *mailbox)
Get user data associated with a mailbox object.
Definition: mrmailbox.c:988
-
mrmailbox_t::mrmailbox_get_version_str
char * mrmailbox_get_version_str(void)
Find out the version of the Delta Chat core library.
Definition: mrmailbox.c:1513
-
mrmailbox_t::mrmailbox_connect
void mrmailbox_connect(mrmailbox_t *mailbox)
Connect to the mailbox using the configured settings.
Definition: mrmailbox.c:1608
+
mrmailbox_t::mrmailbox_get_version_str
char * mrmailbox_get_version_str(void)
Find out the version of the Delta Chat core library.
Definition: mrmailbox.c:1548
+
mrmailbox_t::mrmailbox_connect
void mrmailbox_connect(mrmailbox_t *mailbox)
Connect to the mailbox using the configured settings.
Definition: mrmailbox.c:1643
mrmailbox_t::mrmailbox_get_config
char * mrmailbox_get_config(mrmailbox_t *ths, const char *key, const char *def)
Get a configuration option.
Definition: mrmailbox.c:1241
mrmailbox_t::mrmailbox_new
mrmailbox_t * mrmailbox_new(mrmailboxcb_t cb, void *userdata, const char *os_name)
Create a new mailbox object.
Definition: mrmailbox.c:888
-
mrmailbox_t::mrmailbox_send_audio_msg
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:3480
-
mrmailbox_t::mrmailbox_set_chat_name
int mrmailbox_set_chat_name(mrmailbox_t *mailbox, uint32_t chat_id, const char *new_name)
Set group name.
Definition: mrmailbox.c:3753
+
mrmailbox_t::mrmailbox_send_audio_msg
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:3554
+
mrmailbox_t::mrmailbox_set_chat_name
int mrmailbox_set_chat_name(mrmailbox_t *mailbox, uint32_t chat_id, const char *new_name)
Set group name.
Definition: mrmailbox.c:3824
mrcontact_t
An object representing a single contact in memory.
diff --git a/docs/html/mrmimeparser_8h_source.html b/docs/html/mrmimeparser_8h_source.html index 697a859e..ddb4e9c9 100644 --- a/docs/html/mrmimeparser_8h_source.html +++ b/docs/html/mrmimeparser_8h_source.html @@ -89,7 +89,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
mrmimeparser.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 /* Parse MIME body; this is the text part of an IMF, see https://tools.ietf.org/html/rfc5322
24 mrmimeparser_t has no deep dependencies to mrmailbox_t or to the database
25 (mrmailbox_t is used for logging only). */
26 
27 
28 #ifndef __MRMIMEPARSER_H__
29 #define __MRMIMEPARSER_H__
30 #ifdef __cplusplus
31 extern "C" {
32 #endif
33 
34 
35 #include "mrhash.h"
36 #include "mrparam.h"
37 
38 
39 typedef struct mrmimepart_t
40 {
42  int m_type; /*one of MR_MSG_* */
43  int m_is_meta; /*meta parts contain eg. profile or group images and are only present if there is at least one "normal" part*/
44  char* m_msg;
45  char* m_msg_raw;
46  int m_bytes;
47  mrparam_t* m_param;
48 } mrmimepart_t;
49 
50 
51 typedef struct mrmimeparser_t
52 {
55  /* data, read-only, must not be free()'d (it is free()'d when the mrmimeparser_t object gets destructed) */
56  carray* m_parts; /* array of mrmimepart_t objects */
57  struct mailmime* m_mimeroot;
58 
59  mrhash_t m_header; /* memoryhole-compliant header */
60  struct mailimf_fields* m_header_root; /* must NOT be freed, do not use for query, merged into m_header, a pointer somewhere to the MIME data*/
61  struct mailimf_fields* m_header_protected; /* MUST be freed, do not use for query, merged into m_header */
62 
63  char* m_subject;
64  int m_is_send_by_messenger;
65  int m_decrypted_and_validated;
66  int m_decrypted_with_validation_errors;
67  int m_decrypting_failed; /* set, if there are multipart/encrypted parts left after decryption */
68  const char* m_blobdir;
69 
70  int m_is_forwarded;
71 
72  mrmailbox_t* m_mailbox;
73 
74  carray* m_reports; /* array of mailmime objects */
75 
76  int m_is_system_message;
77 
78 } mrmimeparser_t;
79 
80 
81 mrmimeparser_t* mrmimeparser_new (const char* blobdir, mrmailbox_t*);
82 void mrmimeparser_unref (mrmimeparser_t*);
83 void mrmimeparser_empty (mrmimeparser_t*);
84 
85 void mrmimeparser_parse (mrmimeparser_t*, const char* body_not_terminated, size_t body_bytes);
86 
87 
88 /* the following functions can be used only after a call to mrmimeparser_parse() */
89 struct mailimf_field* mrmimeparser_lookup_field (mrmimeparser_t*, const char* field_name);
90 struct mailimf_optional_field* mrmimeparser_lookup_optional_field (mrmimeparser_t*, const char* field_name);
91 struct mailimf_optional_field* mrmimeparser_lookup_optional_field2 (mrmimeparser_t*, const char* field_name, const char* or_field_name);
92 mrmimepart_t* mrmimeparser_get_last_nonmeta (mrmimeparser_t*);
93 #define mrmimeparser_has_nonmeta(a) (mrmimeparser_get_last_nonmeta((a))!=NULL)
94 int mrmimeparser_is_mailinglist_message (mrmimeparser_t*);
95 
96 
97 
98 /* low-level-tools for working with mailmime structures directly */
99 #ifdef MR_USE_MIME_DEBUG
100 void mailmime_print (struct mailmime*);
101 #endif
102 struct mailmime_parameter* mailmime_find_ct_parameter (struct mailmime*, const char* name);
103 int mailmime_transfer_decode (struct mailmime*, const char** ret_decoded_data, size_t* ret_decoded_data_bytes, char** ret_to_mmap_string_unref);
104 struct mailimf_fields* mailmime_find_mailimf_fields (struct mailmime*); /*the result is a pointer to mime, must not be freed*/
105 char* mailimf_find_first_addr (const struct mailimf_mailbox_list*); /*the result must be freed*/
106 struct mailimf_field* mailimf_find_field (struct mailimf_fields*, int wanted_fld_type); /*the result is a pointer to mime, must not be freed*/
107 struct mailimf_optional_field* mailimf_find_optional_field (struct mailimf_fields*, const char* wanted_fld_name);
108 
109 
110 #ifdef __cplusplus
111 } /* /extern "C" */
112 #endif
113 #endif /* __MRMIMEPARSER_H__ */
114 
mrmailbox_t
An object representing a single mailbox.
+
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 /* Parse MIME body; this is the text part of an IMF, see https://tools.ietf.org/html/rfc5322
24 mrmimeparser_t has no deep dependencies to mrmailbox_t or to the database
25 (mrmailbox_t is used for logging only). */
26 
27 
28 #ifndef __MRMIMEPARSER_H__
29 #define __MRMIMEPARSER_H__
30 #ifdef __cplusplus
31 extern "C" {
32 #endif
33 
34 
35 #include "mrhash.h"
36 #include "mrparam.h"
37 
38 
39 typedef struct mrmimepart_t
40 {
42  int m_type; /*one of MR_MSG_* */
43  int m_is_meta; /*meta parts contain eg. profile or group images and are only present if there is at least one "normal" part*/
44  char* m_msg;
45  char* m_msg_raw;
46  int m_bytes;
47  mrparam_t* m_param;
48 } mrmimepart_t;
49 
50 
51 typedef struct mrmimeparser_t
52 {
55  /* data, read-only, must not be free()'d (it is free()'d when the mrmimeparser_t object gets destructed) */
56  carray* m_parts; /* array of mrmimepart_t objects */
57  struct mailmime* m_mimeroot;
58 
59  mrhash_t m_header; /* memoryhole-compliant header */
60  struct mailimf_fields* m_header_root; /* must NOT be freed, do not use for query, merged into m_header, a pointer somewhere to the MIME data*/
61  struct mailimf_fields* m_header_protected; /* MUST be freed, do not use for query, merged into m_header */
62 
63  char* m_subject;
64  int m_is_send_by_messenger;
65  int m_decrypted_and_validated;
66  int m_decrypted_with_validation_errors;
67  int m_decrypting_failed; /* set, if there are multipart/encrypted parts left after decryption */
68  const char* m_blobdir;
69 
70  int m_is_forwarded;
71 
72  mrmailbox_t* m_mailbox;
73 
74  carray* m_reports; /* array of mailmime objects */
75 
76  int m_is_system_message;
77 
78 } mrmimeparser_t;
79 
80 
81 mrmimeparser_t* mrmimeparser_new (const char* blobdir, mrmailbox_t*);
82 void mrmimeparser_unref (mrmimeparser_t*);
83 void mrmimeparser_empty (mrmimeparser_t*);
84 
85 void mrmimeparser_parse (mrmimeparser_t*, const char* body_not_terminated, size_t body_bytes);
86 
87 
88 /* the following functions can be used only after a call to mrmimeparser_parse() */
89 struct mailimf_field* mrmimeparser_lookup_field (mrmimeparser_t*, const char* field_name);
90 struct mailimf_optional_field* mrmimeparser_lookup_optional_field (mrmimeparser_t*, const char* field_name);
91 struct mailimf_optional_field* mrmimeparser_lookup_optional_field2 (mrmimeparser_t*, const char* field_name, const char* or_field_name);
92 mrmimepart_t* mrmimeparser_get_last_nonmeta (mrmimeparser_t*);
93 #define mrmimeparser_has_nonmeta(a) (mrmimeparser_get_last_nonmeta((a))!=NULL)
94 int mrmimeparser_is_mailinglist_message (mrmimeparser_t*);
95 
96 
97 
98 /* low-level-tools for working with mailmime structures directly */
99 #ifdef MR_USE_MIME_DEBUG
100 void mailmime_print (struct mailmime*);
101 #endif
102 struct mailmime_parameter* mailmime_find_ct_parameter (struct mailmime*, const char* name);
103 int mailmime_transfer_decode (struct mailmime*, const char** ret_decoded_data, size_t* ret_decoded_data_bytes, char** ret_to_mmap_string_unref);
104 struct mailimf_fields* mailmime_find_mailimf_fields (struct mailmime*); /*the result is a pointer to mime, must not be freed*/
105 char* mailimf_find_first_addr (const struct mailimf_mailbox_list*); /*the result must be freed*/
106 struct mailimf_field* mailimf_find_field (struct mailimf_fields*, int wanted_fld_type); /*the result is a pointer to mime, must not be freed*/
107 struct mailimf_optional_field* mailimf_find_optional_field (struct mailimf_fields*, const char* wanted_fld_name);
108 mrhash_t* mailimf_get_recipients (struct mailimf_fields*);
109 
110 
111 #ifdef __cplusplus
112 } /* /extern "C" */
113 #endif
114 #endif /* __MRMIMEPARSER_H__ */
115 
mrmailbox_t
An object representing a single mailbox.
diff --git a/docs/html/mrpgp_8h_source.html b/docs/html/mrpgp_8h_source.html index 0b689f9d..097bb21e 100644 --- a/docs/html/mrpgp_8h_source.html +++ b/docs/html/mrpgp_8h_source.html @@ -89,7 +89,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
mrpgp.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 __MRPGP_H__
24 #define __MRPGP_H__
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28 
29 
30 /*** library-private **********************************************************/
31 
32 typedef struct mrkey_t mrkey_t;
33 typedef struct mrkeyring_t mrkeyring_t;
34 
35 
36 /* validation errors */
37 #define MR_VALIDATE_NO_SIGNATURE 0x01
38 #define MR_VALIDATE_UNKNOWN_SIGNATURE 0x02
39 #define MR_VALIDATE_BAD_SIGNATURE 0x04
40 #define MR_VALIDATE_NOT_MUTUAL 0x08
41 
42 /* misc. */
43 void mrpgp_init (mrmailbox_t*);
44 void mrpgp_exit (mrmailbox_t*);
45 void mrpgp_rand_seed (mrmailbox_t*, const void* buf, size_t bytes);
46 
47 
48 /* public key encryption */
49 int mrpgp_create_keypair (mrmailbox_t*, const char* addr, mrkey_t* public_key, mrkey_t* private_key);
50 int mrpgp_is_valid_key (mrmailbox_t*, const mrkey_t*);
51 int mrpgp_calc_fingerprint (mrmailbox_t*, const mrkey_t*, uint8_t** fingerprint, size_t* fingerprint_bytes);
52 int mrpgp_split_key (mrmailbox_t*, const mrkey_t* private_in, mrkey_t* public_out);
53 
54 int mrpgp_pk_encrypt (mrmailbox_t*, const void* plain, size_t plain_bytes, const mrkeyring_t*, const mrkey_t* sign_key, int use_armor, void** ret_ctext, size_t* ret_ctext_bytes);
55 int mrpgp_pk_decrypt (mrmailbox_t*, const void* ctext, size_t ctext_bytes, const mrkeyring_t*, const mrkey_t* validate_key, int use_armor, void** plain, size_t* plain_bytes, int* ret_validation_errors);
56 
57 
58 #ifdef __cplusplus
59 } /* /extern "C" */
60 #endif
61 #endif /* __MRPGP_H__ */
mrmailbox_t
An object representing a single mailbox.
+
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 __MRPGP_H__
24 #define __MRPGP_H__
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28 
29 
30 /*** library-private **********************************************************/
31 
32 typedef struct mrkey_t mrkey_t;
33 typedef struct mrkeyring_t mrkeyring_t;
34 
35 
36 /* validation errors */
37 #define MR_VALIDATE_NO_SIGNATURE 0x01
38 #define MR_VALIDATE_UNKNOWN_SIGNATURE 0x02
39 #define MR_VALIDATE_BAD_SIGNATURE 0x04
40 
41 /* misc. */
42 void mrpgp_init (mrmailbox_t*);
43 void mrpgp_exit (mrmailbox_t*);
44 void mrpgp_rand_seed (mrmailbox_t*, const void* buf, size_t bytes);
45 
46 
47 /* public key encryption */
48 int mrpgp_create_keypair (mrmailbox_t*, const char* addr, mrkey_t* public_key, mrkey_t* private_key);
49 int mrpgp_is_valid_key (mrmailbox_t*, const mrkey_t*);
50 int mrpgp_calc_fingerprint (mrmailbox_t*, const mrkey_t*, uint8_t** fingerprint, size_t* fingerprint_bytes);
51 int mrpgp_split_key (mrmailbox_t*, const mrkey_t* private_in, mrkey_t* public_out);
52 
53 int mrpgp_pk_encrypt (mrmailbox_t*, const void* plain, size_t plain_bytes, const mrkeyring_t*, const mrkey_t* sign_key, int use_armor, void** ret_ctext, size_t* ret_ctext_bytes);
54 int mrpgp_pk_decrypt (mrmailbox_t*, const void* ctext, size_t ctext_bytes, const mrkeyring_t*, const mrkey_t* validate_key, int use_armor, void** plain, size_t* plain_bytes, int* ret_validation_errors);
55 
56 
57 #ifdef __cplusplus
58 } /* /extern "C" */
59 #endif
60 #endif /* __MRPGP_H__ */
mrmailbox_t
An object representing a single mailbox.
diff --git a/docs/html/mrsqlite3_8h_source.html b/docs/html/mrsqlite3_8h_source.html index adba3190..6edb7538 100644 --- a/docs/html/mrsqlite3_8h_source.html +++ b/docs/html/mrsqlite3_8h_source.html @@ -89,7 +89,7 @@ var searchBox = new SearchBox("searchBox", "search",false,'Search');
mrsqlite3.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 __MRSQLITE3_H__
24 #define __MRSQLITE3_H__
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28 
29 
30 /*** library-private **********************************************************/
31 
32 #include <sqlite3.h>
33 #include <libetpan/libetpan.h>
34 #include <pthread.h>
35 typedef struct _mrmailbox mrmailbox_t;
36 
37 
38 /* predefined statements */
39 enum
40 {
41  BEGIN_transaction = 0 /* must be first */
42  ,ROLLBACK_transaction
43  ,COMMIT_transaction
44 
45  ,SELECT_v_FROM_config_k
46  ,INSERT_INTO_config_kv
47  ,UPDATE_config_vk
48  ,DELETE_FROM_config_k
49 
50  ,SELECT_COUNT_FROM_contacts
51  ,SELECT_naob_FROM_contacts_i
52  ,SELECT_inao_FROM_contacts_a
53  ,SELECT_id_FROM_contacts_WHERE_id
54  ,SELECT_na_FROM_chats_contacs_JOIN_contacts_WHERE_cc
55  ,SELECT_p_FROM_chats_contacs_JOIN_contacts_peerstates_WHERE_cc
56  ,SELECT_id_FROM_contacts_WHERE_chat_id
57  ,SELECT_id_FROM_contacts_ORDER_BY
58  ,SELECT_id_FROM_contacts_WHERE_query_ORDER_BY
59  ,SELECT_COUNT_FROM_contacts_WHERE_blocked
60  ,SELECT_id_FROM_contacts_WHERE_blocked
61  ,INSERT_INTO_contacts_neo
62  ,UPDATE_contacts_nao_WHERE_i
63  ,UPDATE_contacts_SET_origin_WHERE_id
64  ,UPDATE_contacts_SET_b_WHERE_i
65  ,DELETE_FROM_contacts_WHERE_id
66 
67  ,SELECT_COUNT_FROM_chats
68  ,SELECT_COUNT_FROM_chats_WHERE_archived
69  ,SELECT_ii_FROM_chats_LEFT_JOIN_msgs_WHERE_archived
70  ,SELECT_ii_FROM_chats_LEFT_JOIN_msgs_WHERE_unarchived
71  ,SELECT_ii_FROM_chats_LEFT_JOIN_msgs_WHERE_query
72  ,SELECT_itndd_FROM_chats_WHERE_i
73  ,SELECT_id_FROM_chats_WHERE_id
74  ,SELECT_id_FROM_chats_WHERE_contact_id
75  ,SELECT_id_FROM_CHATS_WHERE_grpid
76  ,SELECT_timestamp_FROM_msgs_WHERE_timestamp
77  ,SELECT_it_FROM_msgs_JOIN_chats_WHERE_rfc724
78  ,SELECT_MAX_timestamp_FROM_msgs
79  ,SELECT_rfc724_FROM_msgs_ORDER_BY_timestamp_LIMIT_1
80  ,UPDATE_chats_SET_draft_WHERE_id
81  ,UPDATE_chats_SET_n_WHERE_c
82  ,UPDATE_chats_SET_blocked
83  ,UPDATE_chats_SET_unarchived
84 
85  ,SELECT_a_FROM_chats_contacts_WHERE_i
86  ,SELECT_COUNT_FROM_chats_contacts_WHERE_chat_id
87  ,SELECT_COUNT_FROM_chats_contacts_WHERE_contact_id
88  ,SELECT_c_FROM_chats_contacts_WHERE_c
89  ,SELECT_c_FROM_chats_contacts_WHERE_c_ORDER_BY
90  ,SELECT_void_FROM_chats_contacts_WHERE_chat_id_AND_contact_id
91  ,INSERT_INTO_chats_contacts
92 
93  ,SELECT_COUNT_FROM_msgs_WHERE_assigned
94  ,SELECT_COUNT_FROM_msgs_WHERE_unassigned
95  ,SELECT_COUNT_FROM_msgs_WHERE_state_AND_chat_id
96  ,SELECT_COUNT_FROM_msgs_WHERE_chat_id
97  ,SELECT_COUNT_FROM_msgs_WHERE_rfc724_mid
98  ,SELECT_COUNT_FROM_msgs_WHERE_ft
99  ,SELECT_COUNT_DISTINCT_f_FROM_msgs_WHERE_c
100  ,SELECT_i_FROM_msgs_WHERE_ctt
101  ,SELECT_id_FROM_msgs_WHERE_cm
102  ,SELECT_id_FROM_msgs_WHERE_mcm
103  ,SELECT_id_FROM_msgs_WHERE_fresh_AND_deaddrop
104  ,SELECT_txt_raw_FROM_msgs_WHERE_id
105  ,SELECT_ircftttstpb_FROM_msg_WHERE_i
106  ,SELECT_ss_FROM_msgs_WHERE_m
107  ,SELECT_i_FROM_msgs_LEFT_JOIN_contacts_WHERE_c
108  ,SELECT_i_FROM_msgs_LEFT_JOIN_contacts_WHERE_starred
109  ,SELECT_i_FROM_msgs_LEFT_JOIN_contacts_WHERE_fresh
110  ,SELECT_i_FROM_msgs_WHERE_query
111  ,SELECT_i_FROM_msgs_WHERE_chat_id_AND_query
112  ,INSERT_INTO_msgs_msscftttsmttpb
113  ,INSERT_INTO_msgs_mcftttstpb
114  ,UPDATE_msgs_SET_chat_id_WHERE_id
115  ,UPDATE_msgs_SET_state_WHERE_id
116  ,UPDATE_msgs_SET_seen_WHERE_id_AND_chat_id_AND_freshORnoticed
117  ,UPDATE_msgs_SET_noticed_WHERE_id_AND_fresh
118  ,UPDATE_msgs_SET_state_WHERE_chat_id_AND_state
119  ,UPDATE_msgs_SET_state_WHERE_from_id_AND_state
120  ,UPDATE_msgs_SET_ss_WHERE_rfc724_mid
121  ,UPDATE_msgs_SET_param_WHERE_id
122  ,UPDATE_msgs_SET_starred_WHERE_id
123  ,DELETE_FROM_msgs_WHERE_id
124  ,DELETE_FROM_msgs_WHERE_rfc724_mid
125 
126  ,SELECT_c_FROM_msgs_mdns_WHERE_mc
127  ,INSERT_INTO_msgs_mdns
128  ,SELECT_COUNT_FROM_msgs_mdns_WHERE_m
129  ,DELETE_FROM_msgs_mdns_WHERE_m
130 
131  ,INSERT_INTO_jobs_aafp
132  ,SELECT_MIN_d_FROM_jobs
133  ,SELECT_iafp_FROM_jobs
134  ,DELETE_FROM_jobs_WHERE_id
135  ,DELETE_FROM_jobs_WHERE_action
136  ,UPDATE_jobs_SET_dp_WHERE_id
137 
138  ,SELECT_FROM_leftgrps_WHERE_grpid
139 
140  ,INSERT_INTO_acpeerstates_a
141  ,SELECT_aclpp_FROM_acpeerstates_WHERE_a
142  ,UPDATE_acpeerstates_SET_l_WHERE_a
143  ,UPDATE_acpeerstates_SET_lcpp_WHERE_a
144 
145  ,INSERT_INTO_keypairs_aippc
146  ,SELECT_private_key_FROM_keypairs_WHERE_default
147  ,SELECT_private_key_FROM_keypairs_ORDER_BY_default
148  ,SELECT_public_key_FROM_keypairs_WHERE_default
149 
150  ,PREDEFINED_CNT /* must be last */
151 };
152 
153 
162 typedef struct mrsqlite3_t
163 {
165  sqlite3_stmt* m_pd[PREDEFINED_CNT];
166  sqlite3* m_cobj;
167  int m_transactionCount;
168  mrmailbox_t* m_mailbox;
169  pthread_mutex_t m_critical_;
171 } mrsqlite3_t;
172 
173 
174 mrsqlite3_t* mrsqlite3_new (mrmailbox_t*);
175 void mrsqlite3_unref (mrsqlite3_t*);
176 
177 #define MR_OPEN_READONLY 0x01
178 int mrsqlite3_open__ (mrsqlite3_t*, const char* dbfile, int flags);
179 
180 void mrsqlite3_close__ (mrsqlite3_t*);
181 int mrsqlite3_is_open (const mrsqlite3_t*);
182 
183 /* handle configurations, private */
184 int mrsqlite3_set_config__ (mrsqlite3_t*, const char* key, const char* value);
185 int mrsqlite3_set_config_int__ (mrsqlite3_t*, const char* key, int32_t value);
186 char* mrsqlite3_get_config__ (mrsqlite3_t*, const char* key, const char* def); /* the returned string must be free()'d, returns NULL on errors */
187 int32_t mrsqlite3_get_config_int__ (mrsqlite3_t*, const char* key, int32_t def);
188 
189 /* tools, these functions are compatible to the corresponding sqlite3_* functions */
190 sqlite3_stmt* mrsqlite3_predefine__ (mrsqlite3_t*, size_t idx, const char* sql); /*the result is resetted as needed and must not be freed. CAVE: you must not call this function with different strings for the same index!*/
191 sqlite3_stmt* mrsqlite3_prepare_v2_ (mrsqlite3_t*, const char* sql); /* the result mus be freed using sqlite3_finalize() */
192 int mrsqlite3_execute__ (mrsqlite3_t*, const char* sql);
193 int mrsqlite3_table_exists__ (mrsqlite3_t*, const char* name);
194 void mrsqlite3_log_error (mrsqlite3_t*, const char* msg, ...);
195 
196 /* reset all predefined statements, this is needed only in very rare cases, eg. when dropping a table and there are pending statements */
197 void mrsqlite3_reset_all_predefinitions(mrsqlite3_t*);
198 
199 /* tools for locking, may be called nested, see also m_critical_ above.
200 the user of MrSqlite3 must make sure that the MrSqlite3-object is only used by one thread at the same time.
201 In general, we will lock the hightest level as possible - this avoids deadlocks and massive on/off lockings.
202 Low-level-functions, eg. the MrSqlite3-methods, do not lock. */
203 void mrsqlite3_lock (mrsqlite3_t*); /* lock or wait; these calls must not be nested in a single thread */
204 void mrsqlite3_unlock (mrsqlite3_t*);
205 
206 /* nestable transactions, only the outest is really used */
207 void mrsqlite3_begin_transaction__(mrsqlite3_t*);
208 void mrsqlite3_commit__ (mrsqlite3_t*);
209 void mrsqlite3_rollback__ (mrsqlite3_t*);
210 
211 #ifdef __cplusplus
212 } /* /extern "C" */
213 #endif
214 #endif /* __MRSQLITE3_H__ */
215 
mrmailbox_t
An object representing a single mailbox.
+
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 __MRSQLITE3_H__
24 #define __MRSQLITE3_H__
25 #ifdef __cplusplus
26 extern "C" {
27 #endif
28 
29 
30 /*** library-private **********************************************************/
31 
32 #include <sqlite3.h>
33 #include <libetpan/libetpan.h>
34 #include <pthread.h>
35 typedef struct _mrmailbox mrmailbox_t;
36 
37 
38 /* predefined statements */
39 enum
40 {
41  BEGIN_transaction = 0 /* must be first */
42  ,ROLLBACK_transaction
43  ,COMMIT_transaction
44 
45  ,SELECT_v_FROM_config_k
46  ,INSERT_INTO_config_kv
47  ,UPDATE_config_vk
48  ,DELETE_FROM_config_k
49 
50  ,SELECT_COUNT_FROM_contacts
51  ,SELECT_naob_FROM_contacts_i
52  ,SELECT_inao_FROM_contacts_a
53  ,SELECT_id_FROM_contacts_WHERE_id
54  ,SELECT_na_FROM_chats_contacs_JOIN_contacts_WHERE_cc
55  ,SELECT_p_FROM_chats_contacs_JOIN_contacts_peerstates_WHERE_cc
56  ,SELECT_id_FROM_contacts_WHERE_chat_id
57  ,SELECT_id_FROM_contacts_ORDER_BY
58  ,SELECT_id_FROM_contacts_WHERE_query_ORDER_BY
59  ,SELECT_COUNT_FROM_contacts_WHERE_blocked
60  ,SELECT_id_FROM_contacts_WHERE_blocked
61  ,INSERT_INTO_contacts_neo
62  ,UPDATE_contacts_nao_WHERE_i
63  ,UPDATE_contacts_SET_origin_WHERE_id
64  ,UPDATE_contacts_SET_b_WHERE_i
65  ,DELETE_FROM_contacts_WHERE_id
66 
67  ,SELECT_COUNT_FROM_chats
68  ,SELECT_COUNT_FROM_chats_WHERE_archived
69  ,SELECT_ii_FROM_chats_LEFT_JOIN_msgs_WHERE_archived
70  ,SELECT_ii_FROM_chats_LEFT_JOIN_msgs_WHERE_unarchived
71  ,SELECT_ii_FROM_chats_LEFT_JOIN_msgs_WHERE_query
72  ,SELECT_itndd_FROM_chats_WHERE_i
73  ,SELECT_id_FROM_chats_WHERE_id
74  ,SELECT_id_FROM_chats_WHERE_contact_id
75  ,SELECT_id_FROM_CHATS_WHERE_grpid
76  ,SELECT_timestamp_FROM_msgs_WHERE_timestamp
77  ,SELECT_param_FROM_msgs
78  ,SELECT_it_FROM_msgs_JOIN_chats_WHERE_rfc724
79  ,SELECT_MAX_timestamp_FROM_msgs
80  ,SELECT_rfc724_FROM_msgs_ORDER_BY_timestamp_LIMIT_1
81  ,UPDATE_chats_SET_draft_WHERE_id
82  ,UPDATE_chats_SET_n_WHERE_c
83  ,UPDATE_chats_SET_blocked
84  ,UPDATE_chats_SET_unarchived
85 
86  ,SELECT_a_FROM_chats_contacts_WHERE_i
87  ,SELECT_COUNT_FROM_chats_contacts_WHERE_chat_id
88  ,SELECT_COUNT_FROM_chats_contacts_WHERE_contact_id
89  ,SELECT_c_FROM_chats_contacts_WHERE_c
90  ,SELECT_c_FROM_chats_contacts_WHERE_c_ORDER_BY
91  ,SELECT_void_FROM_chats_contacts_WHERE_chat_id_AND_contact_id
92  ,INSERT_INTO_chats_contacts
93 
94  ,SELECT_COUNT_FROM_msgs_WHERE_assigned
95  ,SELECT_COUNT_FROM_msgs_WHERE_unassigned
96  ,SELECT_COUNT_FROM_msgs_WHERE_state_AND_chat_id
97  ,SELECT_COUNT_FROM_msgs_WHERE_chat_id
98  ,SELECT_COUNT_FROM_msgs_WHERE_rfc724_mid
99  ,SELECT_COUNT_FROM_msgs_WHERE_ft
100  ,SELECT_COUNT_DISTINCT_f_FROM_msgs_WHERE_c
101  ,SELECT_i_FROM_msgs_WHERE_ctt
102  ,SELECT_id_FROM_msgs_WHERE_cm
103  ,SELECT_id_FROM_msgs_WHERE_mcm
104  ,SELECT_id_FROM_msgs_WHERE_fresh_AND_deaddrop
105  ,SELECT_txt_raw_FROM_msgs_WHERE_id
106  ,SELECT_ircftttstpb_FROM_msg_WHERE_i
107  ,SELECT_ss_FROM_msgs_WHERE_m
108  ,SELECT_i_FROM_msgs_LEFT_JOIN_contacts_WHERE_c
109  ,SELECT_i_FROM_msgs_LEFT_JOIN_contacts_WHERE_starred
110  ,SELECT_i_FROM_msgs_LEFT_JOIN_contacts_WHERE_fresh
111  ,SELECT_i_FROM_msgs_WHERE_query
112  ,SELECT_i_FROM_msgs_WHERE_chat_id_AND_query
113  ,INSERT_INTO_msgs_msscftttsmttpb
114  ,INSERT_INTO_msgs_mcftttstpb
115  ,UPDATE_msgs_SET_chat_id_WHERE_id
116  ,UPDATE_msgs_SET_state_WHERE_id
117  ,UPDATE_msgs_SET_seen_WHERE_id_AND_chat_id_AND_freshORnoticed
118  ,UPDATE_msgs_SET_noticed_WHERE_id_AND_fresh
119  ,UPDATE_msgs_SET_state_WHERE_chat_id_AND_state
120  ,UPDATE_msgs_SET_state_WHERE_from_id_AND_state
121  ,UPDATE_msgs_SET_ss_WHERE_rfc724_mid
122  ,UPDATE_msgs_SET_param_WHERE_id
123  ,UPDATE_msgs_SET_starred_WHERE_id
124  ,DELETE_FROM_msgs_WHERE_id
125  ,DELETE_FROM_msgs_WHERE_rfc724_mid
126 
127  ,SELECT_c_FROM_msgs_mdns_WHERE_mc
128  ,INSERT_INTO_msgs_mdns
129  ,SELECT_COUNT_FROM_msgs_mdns_WHERE_m
130  ,DELETE_FROM_msgs_mdns_WHERE_m
131 
132  ,INSERT_INTO_jobs_aafp
133  ,SELECT_MIN_d_FROM_jobs
134  ,SELECT_iafp_FROM_jobs
135  ,DELETE_FROM_jobs_WHERE_id
136  ,DELETE_FROM_jobs_WHERE_action
137  ,UPDATE_jobs_SET_dp_WHERE_id
138 
139  ,SELECT_FROM_leftgrps_WHERE_grpid
140 
141  ,INSERT_INTO_acpeerstates_a
142  ,SELECT_aclpp_FROM_acpeerstates_WHERE_a
143  ,UPDATE_acpeerstates_SET_l_WHERE_a
144  ,UPDATE_acpeerstates_SET_lcpp_WHERE_a
145 
146  ,INSERT_INTO_keypairs_aippc
147  ,SELECT_private_key_FROM_keypairs_WHERE_default
148  ,SELECT_private_key_FROM_keypairs_ORDER_BY_default
149  ,SELECT_public_key_FROM_keypairs_WHERE_default
150 
151  ,PREDEFINED_CNT /* must be last */
152 };
153 
154 
163 typedef struct mrsqlite3_t
164 {
166  sqlite3_stmt* m_pd[PREDEFINED_CNT];
167  sqlite3* m_cobj;
168  int m_transactionCount;
169  mrmailbox_t* m_mailbox;
170  pthread_mutex_t m_critical_;
172 } mrsqlite3_t;
173 
174 
175 mrsqlite3_t* mrsqlite3_new (mrmailbox_t*);
176 void mrsqlite3_unref (mrsqlite3_t*);
177 
178 #define MR_OPEN_READONLY 0x01
179 int mrsqlite3_open__ (mrsqlite3_t*, const char* dbfile, int flags);
180 
181 void mrsqlite3_close__ (mrsqlite3_t*);
182 int mrsqlite3_is_open (const mrsqlite3_t*);
183 
184 /* handle configurations, private */
185 int mrsqlite3_set_config__ (mrsqlite3_t*, const char* key, const char* value);
186 int mrsqlite3_set_config_int__ (mrsqlite3_t*, const char* key, int32_t value);
187 char* mrsqlite3_get_config__ (mrsqlite3_t*, const char* key, const char* def); /* the returned string must be free()'d, returns NULL on errors */
188 int32_t mrsqlite3_get_config_int__ (mrsqlite3_t*, const char* key, int32_t def);
189 
190 /* tools, these functions are compatible to the corresponding sqlite3_* functions */
191 sqlite3_stmt* mrsqlite3_predefine__ (mrsqlite3_t*, size_t idx, const char* sql); /*the result is resetted as needed and must not be freed. CAVE: you must not call this function with different strings for the same index!*/
192 sqlite3_stmt* mrsqlite3_prepare_v2_ (mrsqlite3_t*, const char* sql); /* the result mus be freed using sqlite3_finalize() */
193 int mrsqlite3_execute__ (mrsqlite3_t*, const char* sql);
194 int mrsqlite3_table_exists__ (mrsqlite3_t*, const char* name);
195 void mrsqlite3_log_error (mrsqlite3_t*, const char* msg, ...);
196 
197 /* reset all predefined statements, this is needed only in very rare cases, eg. when dropping a table and there are pending statements */
198 void mrsqlite3_reset_all_predefinitions(mrsqlite3_t*);
199 
200 /* tools for locking, may be called nested, see also m_critical_ above.
201 the user of MrSqlite3 must make sure that the MrSqlite3-object is only used by one thread at the same time.
202 In general, we will lock the hightest level as possible - this avoids deadlocks and massive on/off lockings.
203 Low-level-functions, eg. the MrSqlite3-methods, do not lock. */
204 void mrsqlite3_lock (mrsqlite3_t*); /* lock or wait; these calls must not be nested in a single thread */
205 void mrsqlite3_unlock (mrsqlite3_t*);
206 
207 /* nestable transactions, only the outest is really used */
208 void mrsqlite3_begin_transaction__(mrsqlite3_t*);
209 void mrsqlite3_commit__ (mrsqlite3_t*);
210 void mrsqlite3_rollback__ (mrsqlite3_t*);
211 
212 #ifdef __cplusplus
213 } /* /extern "C" */
214 #endif
215 #endif /* __MRSQLITE3_H__ */
216 
mrmailbox_t
An object representing a single mailbox.
msgThe message object.