messenger_api_queue_messages.c File Reference

#include "messenger_api_queue_messages.h"
#include "gnunet_messenger_service.h"
#include "messenger_api_message.h"

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. More...
void	clear_queue_messages (struct GNUNET_MESSENGER_QueueMessages *messages)
	Clears the queue of messages. More...
void	enqueue_to_messages (struct GNUNET_MESSENGER_QueueMessages *messages, const struct GNUNET_CRYPTO_PrivateKey *sender, struct GNUNET_MESSENGER_Message *message, struct GNUNET_MESSENGER_Message *transcript, enum GNUNET_GenericReturnValue priority)
	Adds a specific message to the end or the beginning of the queue depending on its priority. More...
struct GNUNET_MESSENGER_Message *	dequeue_from_messages (struct GNUNET_MESSENGER_QueueMessages *messages, struct GNUNET_CRYPTO_PrivateKey *sender, struct GNUNET_MESSENGER_Message **transcript)
	Remove the message from the front of the queue and returns it. More...

Function Documentation

init_queue_messages()

void init_queue_messages

(

struct GNUNET_MESSENGER_QueueMessages *

messages

)

Initializes queue of messages as empty queue.

Parameters

[out]

messages

Queue of messages

Definition at line 32 of file messenger_api_queue_messages.c.

{
  GNUNET_assert (messages);
 
  messages->head = NULL;
  messages->tail = NULL;
}

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]

messages

Queue of messages

Definition at line 42 of file messenger_api_queue_messages.c.

{
  GNUNET_assert (messages);
 
  while (messages->head)
  {
    struct GNUNET_MESSENGER_QueueMessage *element = messages->head;
 
    GNUNET_CONTAINER_DLL_remove (messages->head, messages->tail, element);
 
    if (element->message)
      destroy_message (element->message);
 
    if (element->transcript)
      destroy_message (element->transcript);
 
    GNUNET_free (element);
  }
 
  messages->head = NULL;
  messages->tail = NULL;
}

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_PrivateKey *	sender,
		struct GNUNET_MESSENGER_Message *	message,
		struct GNUNET_MESSENGER_Message *	transcript,
		enum GNUNET_GenericReturnValue	priority
	)

Adds a specific message to the end or the beginning of the queue depending on its priority.

Parameters

[in,out]	messages	Queue of messages
[in]	sender	Private sender key
[in]	message	Message
[in]	transcript	Message transcript
[in]	priority	Whether the message has priority

Definition at line 67 of file messenger_api_queue_messages.c.

{
  GNUNET_assert ((messages) && (sender) && (message));
 
  struct GNUNET_MESSENGER_QueueMessage *element = GNUNET_new (struct
                                                              GNUNET_MESSENGER_QueueMessage);
 
  if (! element)
    return;
 
  element->message = message;
  element->transcript = transcript;
 
  GNUNET_memcpy (&(element->sender), sender, sizeof (element->sender));
 
  if (! element->message)
  {
    if (element->transcript)
      destroy_message(element->transcript);
 
    GNUNET_free (element);
    return;
  }
 
  if (GNUNET_YES == priority)
    GNUNET_CONTAINER_DLL_insert (messages->head, messages->tail, element);
  else
    GNUNET_CONTAINER_DLL_insert_tail (messages->head, messages->tail, element);
}

References destroy_message(), GNUNET_assert, GNUNET_CONTAINER_DLL_insert, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_free, GNUNET_memcpy, GNUNET_new, GNUNET_YES, GNUNET_MESSENGER_QueueMessages::head, GNUNET_MESSENGER_QueueMessage::message, GNUNET_MESSENGER_QueueMessage::sender, GNUNET_MESSENGER_QueueMessages::tail, and GNUNET_MESSENGER_QueueMessage::transcript.

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_PrivateKey *	sender,
		struct GNUNET_MESSENGER_Message **	transcript
	)

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

Parameters

[in,out]	messages	Queue of messages
[out]	sender	Private sender key
[out]	transcript	Message transcript

Returns

Message from front or NULL

Definition at line 103 of file messenger_api_queue_messages.c.

{
  GNUNET_assert (messages);
 
  struct GNUNET_MESSENGER_QueueMessage *element = messages->head;
 
  if (! element)
  {
    if (transcript)
      *transcript = NULL;
 
    return NULL;
  }
 
  struct GNUNET_MESSENGER_Message *message = element->message;
 
  if (transcript)
    *transcript = element->transcript;
  else if (element->transcript)
    destroy_message(element->transcript);
 
  GNUNET_CONTAINER_DLL_remove (messages->head, messages->tail, element);
 
  if (sender)
    GNUNET_memcpy (sender, &(element->sender), sizeof (*sender));
 
  GNUNET_free (element);
  return message;
}

References destroy_message(), 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, and GNUNET_MESSENGER_QueueMessage::transcript.

Referenced by dequeue_messages_from_room().

Here is the call graph for this function:

Here is the caller graph for this function: