aboutsummaryrefslogtreecommitdiff
path: root/src/messenger/gnunet-service-messenger_message_handle.h
diff options
context:
space:
mode:
Diffstat (limited to 'src/messenger/gnunet-service-messenger_message_handle.h')
-rw-r--r--src/messenger/gnunet-service-messenger_message_handle.h100
1 files changed, 57 insertions, 43 deletions
diff --git a/src/messenger/gnunet-service-messenger_message_handle.h b/src/messenger/gnunet-service-messenger_message_handle.h
index d091e1d11..844142b77 100644
--- a/src/messenger/gnunet-service-messenger_message_handle.h
+++ b/src/messenger/gnunet-service-messenger_message_handle.h
@@ -1,6 +1,6 @@
1/* 1/*
2 This file is part of GNUnet. 2 This file is part of GNUnet.
3 Copyright (C) 2020 GNUnet e.V. 3 Copyright (C) 2020--2021 GNUnet e.V.
4 4
5 GNUnet is free software: you can redistribute it and/or modify it 5 GNUnet is free software: you can redistribute it and/or modify it
6 under the terms of the GNU Affero General Public License as published 6 under the terms of the GNU Affero General Public License as published
@@ -31,6 +31,7 @@
31 31
32#include "gnunet-service-messenger_message_kind.h" 32#include "gnunet-service-messenger_message_kind.h"
33 33
34#include "gnunet-service-messenger_member_session.h"
34#include "gnunet-service-messenger_tunnel.h" 35#include "gnunet-service-messenger_tunnel.h"
35#include "messenger_api_message.h" 36#include "messenger_api_message.h"
36 37
@@ -38,91 +39,104 @@
38 * Handles a received or sent join message to make changes of current member information. 39 * Handles a received or sent join message to make changes of current member information.
39 * (add matching member and clear member info) 40 * (add matching member and clear member info)
40 * 41 *
41 * @param room Room of the message 42 * @param[in/out] room Room of the message
42 * @param tunnel Receiving/sending connection (may be NULL) 43 * @param[in/out] session Member session
43 * @param message JOIN-Message 44 * @param[in] message JOIN-Message
44 * @param hash Hash of the message 45 * @param[in] hash Hash of the message
45 */ 46 */
46void 47void
47handle_message_join (struct GNUNET_MESSENGER_SrvRoom *room, struct GNUNET_MESSENGER_SrvTunnel *tunnel, 48handle_message_join (struct GNUNET_MESSENGER_SrvRoom *room, struct GNUNET_MESSENGER_MemberSession *session,
48 struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash); 49 const struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash);
49 50
50/** 51/**
51 * Handles a received or sent leave message to make changes of current member information. 52 * Handles a received or sent leave message to make changes of current member information.
52 * (remove matching member and clear member info) 53 * (remove matching member and clear member info)
53 * 54 *
54 * @param room Room of the message 55 * @param[in/out] room Room of the message
55 * @param tunnel Receiving/sending connection (may be NULL) 56 * @param[in/out] session Member session
56 * @param message LEAVE-Message 57 * @param[in] message LEAVE-Message
57 * @param hash Hash of the message 58 * @param[in] hash Hash of the message
58 */ 59 */
59void 60void
60handle_message_leave (struct GNUNET_MESSENGER_SrvRoom *room, struct GNUNET_MESSENGER_SrvTunnel *tunnel, 61handle_message_leave (struct GNUNET_MESSENGER_SrvRoom *room, struct GNUNET_MESSENGER_MemberSession *session,
61 struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash); 62 const struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash);
62 63
63/** 64/**
64 * Handles a received or sent name message to rename a current member. 65 * Handles a received or sent name message to rename a current member.
65 * (change name of matching member) 66 * (change name of matching member)
66 * 67 *
67 * @param room Room of the message 68 * @param[in/out] room Room of the message
68 * @param tunnel Receiving/sending connection (may be NULL) 69 * @param[in/out] session Member session
69 * @param message NAME-Message 70 * @param[in] message NAME-Message
70 * @param hash Hash of the message 71 * @param[in] hash Hash of the message
71 */ 72 */
72void 73void
73handle_message_name (struct GNUNET_MESSENGER_SrvRoom *room, struct GNUNET_MESSENGER_SrvTunnel *tunnel, 74handle_message_name (struct GNUNET_MESSENGER_SrvRoom *room, struct GNUNET_MESSENGER_MemberSession *session,
74 struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash); 75 const struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash);
75 76
76/** 77/**
77 * Handles a received or sent key message to change the key of a member and rearrange the contacts accordingly. 78 * Handles a received or sent key message to change the key of a member and rearrange the contacts accordingly.
78 * (move the member in the contacts and change its key) 79 * (move the member in the contacts and change its key)
79 * 80 *
80 * @param room Room of the message 81 * @param[in/out] room Room of the message
81 * @param tunnel Receiving/sending connection (may be NULL) 82 * @param[in/out] session Member session
82 * @param message KEY-Message 83 * @param[in] message KEY-Message
83 * @param hash Hash of the message 84 * @param[in] hash Hash of the message
84 */ 85 */
85void 86void
86handle_message_key (struct GNUNET_MESSENGER_SrvRoom *room, struct GNUNET_MESSENGER_SrvTunnel *tunnel, 87handle_message_key (struct GNUNET_MESSENGER_SrvRoom *room, struct GNUNET_MESSENGER_MemberSession *session,
87 struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash); 88 const struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash);
88 89
89/** 90/**
90 * Handles a received or sent peer message to make changes of the basement in the room. 91 * Handles a received or sent peer message to make changes of the basement in the room.
91 * (add a new peer to the basement and restructure connections based on updated list of peers) 92 * (add a new peer to the basement and restructure connections based on updated list of peers)
92 * 93 *
93 * @param room Room of the message 94 * @param[in/out] room Room of the message
94 * @param tunnel Receiving/sending connection (may be NULL) 95 * @param[in/out] session Member session
95 * @param message PEER-Message 96 * @param[in] message PEER-Message
96 * @param hash Hash of the message 97 * @param[in] hash Hash of the message
97 */ 98 */
98void 99void
99handle_message_peer (struct GNUNET_MESSENGER_SrvRoom *room, struct GNUNET_MESSENGER_SrvTunnel *tunnel, 100handle_message_peer (struct GNUNET_MESSENGER_SrvRoom *room, struct GNUNET_MESSENGER_MemberSession *session,
100 struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash); 101 const struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash);
101 102
102/** 103/**
103 * Handles a received or sent id message to change a members id. 104 * Handles a received or sent id message to change a members id.
104 * (change id of matching member) 105 * (change id of matching member)
105 * 106 *
106 * @param room Room of the message 107 * @param[in/out] room Room of the message
107 * @param tunnel Receiving/sending connection (may be NULL) 108 * @param[in/out] session Member session
108 * @param message ID-Message 109 * @param[in] message ID-Message
109 * @param hash Hash of the message 110 * @param[in] hash Hash of the message
110 */ 111 */
111void 112void
112handle_message_id (struct GNUNET_MESSENGER_SrvRoom *room, struct GNUNET_MESSENGER_SrvTunnel *tunnel, 113handle_message_id (struct GNUNET_MESSENGER_SrvRoom *room, struct GNUNET_MESSENGER_MemberSession *session,
113 struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash); 114 const struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash);
114 115
115/** 116/**
116 * Handles a received or sent miss message to drop a peer from the basement in the room. 117 * Handles a received or sent miss message to drop a peer from the basement in the room.
117 * (remove a peer from the basement and restructure connections based on updated list of peers) 118 * (remove a peer from the basement and restructure connections based on updated list of peers)
118 * 119 *
119 * @param room Room of the message 120 * @param[in/out] room Room of the message
120 * @param tunnel Receiving/sending connection (may be NULL) 121 * @param[in/out] session Member session
121 * @param message MISS-Message 122 * @param[in] message MISS-Message
122 * @param hash Hash of the message 123 * @param[in] hash Hash of the message
123 */ 124 */
124void 125void
125handle_message_miss (struct GNUNET_MESSENGER_SrvRoom *room, struct GNUNET_MESSENGER_SrvTunnel *tunnel, 126handle_message_miss (struct GNUNET_MESSENGER_SrvRoom *room, struct GNUNET_MESSENGER_MemberSession *session,
126 struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash); 127 const struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash);
128
129/**
130 * Handles a received or sent delete message to delete a specific message from the store.
131 * (remove a message from the store of a room under a given delay)
132 *
133 * @param[in/out] room Room of the message
134 * @param[in/out] session Member session
135 * @param[in] message DELETE-Message
136 * @param[in] hash Hash of the message
137 */
138void
139handle_message_delete (struct GNUNET_MESSENGER_SrvRoom *room, struct GNUNET_MESSENGER_MemberSession *session,
140 const struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash);
127 141
128#endif //GNUNET_SERVICE_MESSENGER_MESSAGE_HANDLE_H 142#endif //GNUNET_SERVICE_MESSENGER_MESSAGE_HANDLE_H