1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
|
#ifndef GROUP_SESSION_BUILDER_H
#define GROUP_SESSION_BUILDER_H
#include "axolotl_types.h"
#ifdef __cplusplus
extern "C" {
#endif
/*
* Group session builder is responsible for setting up group sender key encrypted sessions.
*
* Once a session has been established, group_cipher can be used to
* encrypt/decrypt messages in that session.
* <p>
* The built sessions are unidirectional: they can be used either for sending
* or for receiving, but not both.
*
* Sessions are constructed per (groupId + senderId + deviceId) tuple. Remote logical users
* are identified by their senderId, and each logical recipientId can have multiple physical
* devices.
*/
/**
* Constructs a group session builder.
*
* The store and global contexts must remain valid for the lifetime of the
* session builder.
*
* When finished, free the returned instance by calling group_session_builder_free().
*
* @param builder set to a freshly allocated group session builder instance
* @param store the axolotl_store_context to store all state information in
* @param global_context the global library context
* @return 0 on success, or negative on failure
*/
int group_session_builder_create(group_session_builder **builder,
axolotl_store_context *store, axolotl_context *global_context);
/**
* Construct a group session for receiving messages from senderKeyName.
*
* @param sender_key_name the (groupId, senderId, deviceId) tuple associated
* with the sender_key_distribution_message
* @param distribution_message a received sender_key_distribution_message
* @return 0 on success, or negative on failure
*/
int group_session_builder_process_session(group_session_builder *builder,
const axolotl_sender_key_name *sender_key_name,
sender_key_distribution_message *distribution_message);
/**
* Construct a group session for sending messages.
*
* @param distribution_message a distribution message to be allocated and populated
* @param sender_key_name the (groupId, senderId, deviceId) tuple. In this
* case, the sender should be the caller
* @return 0 on success, or negative on failure
*/
int group_session_builder_create_session(group_session_builder *builder,
sender_key_distribution_message **distribution_message,
const axolotl_sender_key_name *sender_key_name);
void group_session_builder_free(group_session_builder *builder);
#ifdef __cplusplus
}
#endif
#endif /* GROUP_SESSION_BUILDER_H */
|
