GNUnet 0.26.2-14-ga82e62fdc
 
Loading...
Searching...
No Matches
messenger_api_queue_messages.c File Reference
Include dependency graph for messenger_api_queue_messages.c:

Go to the source code of this file.

Functions

void init_queue_messages (struct GNUNET_MESSENGER_QueueMessages *messages)
 Initializes queue of messages as empty queue.
 
void clear_queue_messages (struct GNUNET_MESSENGER_QueueMessages *messages)
 Clears the queue of messages.
 
void enqueue_to_messages (struct GNUNET_MESSENGER_QueueMessages *messages, const struct GNUNET_CRYPTO_BlindablePrivateKey *sender, const struct GNUNET_CRYPTO_HpkePublicKey *transcript_key, const struct GNUNET_HashCode *epoch, struct GNUNET_MESSENGER_Message *message, struct GNUNET_MESSENGER_Message *transcript)
 Adds a specific message to the end or the beginning of the queue.
 
struct GNUNET_MESSENGER_Messagedequeue_from_messages (struct GNUNET_MESSENGER_QueueMessages *messages, struct GNUNET_CRYPTO_BlindablePrivateKey *sender, struct GNUNET_CRYPTO_HpkePublicKey *transcript_key, struct GNUNET_HashCode *epoch, struct GNUNET_MESSENGER_Message **transcript)
 Remove the message from the front of the queue and returns it.
 

Function Documentation

◆ init_queue_messages()

void init_queue_messages ( struct GNUNET_MESSENGER_QueueMessages messages)

Initializes queue of messages as empty queue.

Parameters
[out]messagesQueue of messages

Definition at line 33 of file messenger_api_queue_messages.c.

34{
35 GNUNET_assert (messages);
36
37 messages->head = NULL;
38 messages->tail = NULL;
39}
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
struct GNUNET_MESSENGER_QueueMessage * tail
struct GNUNET_MESSENGER_QueueMessage * head

References GNUNET_assert, GNUNET_MESSENGER_QueueMessages::head, and GNUNET_MESSENGER_QueueMessages::tail.

Referenced by create_room().

Here is the caller graph for this function:

◆ clear_queue_messages()

void clear_queue_messages ( struct GNUNET_MESSENGER_QueueMessages messages)

Clears the queue of messages.

Parameters
[in,out]messagesQueue of messages

Definition at line 43 of file messenger_api_queue_messages.c.

44{
45 GNUNET_assert (messages);
46
47 while (messages->head)
48 {
49 struct GNUNET_MESSENGER_QueueMessage *element;
50 element = messages->head;
51
52 GNUNET_CONTAINER_DLL_remove (messages->head, messages->tail, element);
53
54 if (element->message)
55 destroy_message (element->message);
56
57 if (element->transcript)
58 destroy_message (element->transcript);
59
60 GNUNET_free (element);
61 }
62
63 messages->head = NULL;
64 messages->tail = NULL;
65}
#define GNUNET_CONTAINER_DLL_remove(head, tail, element)
Remove an element from a DLL.
#define GNUNET_free(ptr)
Wrapper around free.
void destroy_message(struct GNUNET_MESSENGER_Message *message)
Destroys a message and frees its memory fully.
struct GNUNET_MESSENGER_Message * message
struct GNUNET_MESSENGER_Message * transcript

References destroy_message(), GNUNET_assert, GNUNET_CONTAINER_DLL_remove, GNUNET_free, GNUNET_MESSENGER_QueueMessages::head, GNUNET_MESSENGER_QueueMessage::message, GNUNET_MESSENGER_QueueMessages::tail, and GNUNET_MESSENGER_QueueMessage::transcript.

Referenced by destroy_room().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ enqueue_to_messages()

void enqueue_to_messages ( struct GNUNET_MESSENGER_QueueMessages messages,
const struct GNUNET_CRYPTO_BlindablePrivateKey sender,
const struct GNUNET_CRYPTO_HpkePublicKey transcript_key,
const struct GNUNET_HashCode epoch,
struct GNUNET_MESSENGER_Message message,
struct GNUNET_MESSENGER_Message transcript 
)

Adds a specific message to the end or the beginning of the queue.

Parameters
[in,out]messagesQueue of messages
[in]senderPrivate sender key
[in]transcript_keyPublic key to encrypt transcripts
[in]epochEpoch hash
[in]messageMessage
[in]transcriptMessage transcript

Definition at line 69 of file messenger_api_queue_messages.c.

75{
76 struct GNUNET_MESSENGER_QueueMessage *element;
78
79 GNUNET_assert ((messages) && (sender) && (transcript_key) && (message));
80
82 if (! element)
83 return;
84
85 kind = message->header.kind;
86
87 element->message = message;
88 element->transcript = transcript;
89
90 GNUNET_memcpy (&(element->sender), sender, sizeof (element->sender));
92 sizeof (element->transcript_key));
93 GNUNET_memcpy (&(element->epoch), epoch, sizeof (element->epoch));
94
95 if (! element->message)
96 {
97 if (element->transcript)
98 destroy_message (element->transcript);
99
100 GNUNET_free (element);
101 return;
102 }
103
104 if (GNUNET_MESSENGER_KIND_JOIN == kind)
105 GNUNET_CONTAINER_DLL_insert (messages->head, messages->tail, element);
106 else if (GNUNET_MESSENGER_KIND_SUBSCRIBTION == kind)
107 {
108 struct GNUNET_MESSENGER_QueueMessage *other;
109
110 other = messages->head;
111 while (other)
112 {
114 break;
115
116 other = other->next;
117 }
118
119 GNUNET_CONTAINER_DLL_insert_before (messages->head, messages->tail, other,
120 element);
121 }
122 else
123 GNUNET_CONTAINER_DLL_insert_tail (messages->head, messages->tail, element);
124}
#define GNUNET_CONTAINER_DLL_insert_before(head, tail, other, element)
Insert an element into a DLL before the given other element.
#define GNUNET_CONTAINER_DLL_insert_tail(head, tail, element)
Insert an element at the tail of a DLL.
#define GNUNET_CONTAINER_DLL_insert(head, tail, element)
Insert an element at the head of a DLL.
#define GNUNET_memcpy(dst, src, n)
Call memcpy() but check for n being 0 first.
#define GNUNET_new(type)
Allocate a struct or union of the given type.
GNUNET_MESSENGER_MessageKind
Enum for the different supported kinds of messages.
@ GNUNET_MESSENGER_KIND_TALK
The talk kind.
@ GNUNET_MESSENGER_KIND_JOIN
The join kind.
@ GNUNET_MESSENGER_KIND_SUBSCRIBTION
The subscription kind.
enum GNUNET_MESSENGER_MessageKind kind
The kind of the message.
struct GNUNET_MESSENGER_MessageHeader header
Header.
struct GNUNET_CRYPTO_HpkePublicKey transcript_key
struct GNUNET_CRYPTO_BlindablePrivateKey sender
struct GNUNET_MESSENGER_QueueMessage * next

References destroy_message(), GNUNET_MESSENGER_QueueMessage::epoch, GNUNET_assert, GNUNET_CONTAINER_DLL_insert, GNUNET_CONTAINER_DLL_insert_before, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_free, GNUNET_memcpy, GNUNET_MESSENGER_KIND_JOIN, GNUNET_MESSENGER_KIND_SUBSCRIBTION, GNUNET_MESSENGER_KIND_TALK, GNUNET_new, GNUNET_MESSENGER_QueueMessages::head, GNUNET_MESSENGER_Message::header, GNUNET_MESSENGER_MessageHeader::kind, GNUNET_MESSENGER_QueueMessage::message, GNUNET_MESSENGER_QueueMessage::next, GNUNET_MESSENGER_QueueMessage::sender, GNUNET_MESSENGER_QueueMessages::tail, GNUNET_MESSENGER_QueueMessage::transcript, and GNUNET_MESSENGER_QueueMessage::transcript_key.

Referenced by enqueue_message_to_room().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ dequeue_from_messages()

struct GNUNET_MESSENGER_Message * dequeue_from_messages ( struct GNUNET_MESSENGER_QueueMessages messages,
struct GNUNET_CRYPTO_BlindablePrivateKey sender,
struct GNUNET_CRYPTO_HpkePublicKey transcript_key,
struct GNUNET_HashCode epoch,
struct GNUNET_MESSENGER_Message **  transcript 
)

Remove the message from the front of the queue and returns it.

Parameters
[in,out]messagesQueue of messages
[out]senderPrivate sender key
[out]transcript_keyPublic key to encrypt transcripts
[out]epochEpoch hash
[out]transcriptMessage transcript
Returns
Message from front or NULL

Definition at line 128 of file messenger_api_queue_messages.c.

133{
134 struct GNUNET_MESSENGER_QueueMessage *element;
135 struct GNUNET_MESSENGER_Message *message;
136
137 GNUNET_assert (messages);
138
139 element = messages->head;
140 if (! element)
141 {
142 if (transcript)
143 *transcript = NULL;
144
145 return NULL;
146 }
147
148 message = element->message;
149
150 if (transcript)
151 *transcript = element->transcript;
152 else if (element->transcript)
153 destroy_message (element->transcript);
154
155 GNUNET_CONTAINER_DLL_remove (messages->head, messages->tail, element);
156
157 if (sender)
158 GNUNET_memcpy (sender, &(element->sender), sizeof (*sender));
159
160 if (transcript_key)
161 GNUNET_memcpy (transcript_key, &(element->transcript_key),
162 sizeof (*transcript_key));
163
164 if (epoch)
165 GNUNET_memcpy (epoch, &(element->epoch), sizeof (*epoch));
166
167 GNUNET_free (element);
168 return message;
169}

References destroy_message(), GNUNET_MESSENGER_QueueMessage::epoch, GNUNET_assert, GNUNET_CONTAINER_DLL_remove, GNUNET_free, GNUNET_memcpy, GNUNET_MESSENGER_QueueMessages::head, GNUNET_MESSENGER_QueueMessage::message, GNUNET_MESSENGER_QueueMessage::sender, GNUNET_MESSENGER_QueueMessages::tail, GNUNET_MESSENGER_QueueMessage::transcript, and GNUNET_MESSENGER_QueueMessage::transcript_key.

Referenced by dequeue_message_from_room().

Here is the call graph for this function:
Here is the caller graph for this function: