gnunet-service-messenger_list_messages.h File Reference

#include "gnunet_common.h"

Include dependency graph for gnunet-service-messenger_list_messages.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	GNUNET_MESSENGER_ListMessage
struct	GNUNET_MESSENGER_ListMessages

Functions
void	init_list_messages (struct GNUNET_MESSENGER_ListMessages *messages)
	Initializes list of message hashes as empty list. More...
void	clear_list_messages (struct GNUNET_MESSENGER_ListMessages *messages)
	Clears the list of message hashes. More...
void	add_to_list_messages (struct GNUNET_MESSENGER_ListMessages *messages, const struct GNUNET_HashCode *hash)
	Adds a specific hash from a message to the end of the list. More...
void	copy_list_messages (struct GNUNET_MESSENGER_ListMessages *messages, const struct GNUNET_MESSENGER_ListMessages *origin)
	Copies all message hashes from an origin to another list. More...
void	remove_from_list_messages (struct GNUNET_MESSENGER_ListMessages *messages, const struct GNUNET_HashCode *hash)
	Removes the first entry with a matching hash from the list. More...
void	load_list_messages (struct GNUNET_MESSENGER_ListMessages *messages, const char *path)
	Loads the list of message hashes from a file under a given path. More...
void	save_list_messages (const struct GNUNET_MESSENGER_ListMessages *messages, const char *path)
	Saves the list of message hashes to a file under a given path. More...

Function Documentation

init_list_messages()

void init_list_messages

(

struct GNUNET_MESSENGER_ListMessages *

messages

)

Initializes list of message hashes as empty list.

Parameters

[out]

messages

List of hashes

Definition at line 31 of file gnunet-service-messenger_list_messages.c.

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

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

Referenced by check_member_session_completion(), create_member_session(), create_srv_room(), init_message_state(), and switch_member_session().

Here is the caller graph for this function:

clear_list_messages()

void clear_list_messages

(

struct GNUNET_MESSENGER_ListMessages *

messages

)

Clears the list of message hashes.

Parameters

[in,out]

messages

List of hashes

Definition at line 41 of file gnunet-service-messenger_list_messages.c.

{
  GNUNET_assert (messages);
 
  while (messages->head)
  {
    struct GNUNET_MESSENGER_ListMessage *element = messages->head;
 
    GNUNET_CONTAINER_DLL_remove (messages->head, messages->tail, element);
    GNUNET_free (element);
  }
 
  messages->head = NULL;
  messages->tail = NULL;
}

References GNUNET_assert, GNUNET_CONTAINER_DLL_remove, GNUNET_free, GNUNET_MESSENGER_ListMessages::head, and GNUNET_MESSENGER_ListMessages::tail.

Referenced by check_member_session_completion(), clear_message_state(), destroy_member_session(), and reset_member_session().

Here is the caller graph for this function:

add_to_list_messages()

void add_to_list_messages	(	struct GNUNET_MESSENGER_ListMessages *	messages,
		const struct GNUNET_HashCode *	hash
	)

Adds a specific hash from a message to the end of the list.

Parameters

[in,out]	messages	List of hashes
[in]	hash	Hash of message

Definition at line 59 of file gnunet-service-messenger_list_messages.c.

{
  GNUNET_assert ((messages) && (hash));
 
  struct GNUNET_MESSENGER_ListMessage *element = GNUNET_new (struct
                                                             GNUNET_MESSENGER_ListMessage);
 
  GNUNET_memcpy (&(element->hash), hash, sizeof(struct GNUNET_HashCode));
 
  GNUNET_CONTAINER_DLL_insert_tail (messages->head, messages->tail, element);
}

References GNUNET_assert, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_memcpy, GNUNET_new, GNUNET_MESSENGER_ListMessage::hash, GNUNET_MESSENGER_ListMessages::head, and GNUNET_MESSENGER_ListMessages::tail.

Referenced by callback_room_handle_message(), check_member_session_completion(), copy_list_messages(), load_list_messages(), reset_member_session(), update_member_session_history(), and update_message_state().

Here is the caller graph for this function:

copy_list_messages()

void copy_list_messages	(	struct GNUNET_MESSENGER_ListMessages *	messages,
		const struct GNUNET_MESSENGER_ListMessages *	origin
	)

Copies all message hashes from an origin to another list.

Parameters

[in,out]	messages	Destination list of hashes
[in]	origin	Source list of hashes

Definition at line 74 of file gnunet-service-messenger_list_messages.c.

{
  GNUNET_assert ((messages) && (origin));
 
  struct GNUNET_MESSENGER_ListMessage *element;
 
  for (element = origin->head; element; element = element->next)
    add_to_list_messages (messages, &(element->hash));
}

References add_to_list_messages(), GNUNET_assert, GNUNET_MESSENGER_ListMessage::hash, GNUNET_MESSENGER_ListMessage::next, and origin.

Referenced by check_member_session_completion(), and switch_member_session().

Here is the call graph for this function:

Here is the caller graph for this function:

remove_from_list_messages()

void remove_from_list_messages	(	struct GNUNET_MESSENGER_ListMessages *	messages,
		const struct GNUNET_HashCode *	hash
	)

Removes the first entry with a matching hash from the list.

Parameters

[in,out]	messages	List of hashes
[in]	hash	Hash of message

Definition at line 87 of file gnunet-service-messenger_list_messages.c.

{
  GNUNET_assert ((messages) && (hash));
 
  struct GNUNET_MESSENGER_ListMessage *element;
 
  for (element = messages->head; element; element = element->next)
    if (0 == GNUNET_CRYPTO_hash_cmp (&(element->hash), hash))
    {
      GNUNET_CONTAINER_DLL_remove (messages->head, messages->tail, element);
      GNUNET_free (element);
      break;
    }
}

References GNUNET_assert, GNUNET_CONTAINER_DLL_remove, GNUNET_CRYPTO_hash_cmp(), GNUNET_free, GNUNET_MESSENGER_ListMessage::hash, GNUNET_MESSENGER_ListMessages::head, GNUNET_MESSENGER_ListMessage::next, and GNUNET_MESSENGER_ListMessages::tail.

Referenced by update_message_state().

Here is the call graph for this function:

Here is the caller graph for this function:

load_list_messages()

void load_list_messages	(	struct GNUNET_MESSENGER_ListMessages *	messages,
		const char *	path
	)

Loads the list of message hashes from a file under a given path.

Parameters

[out]	messages	List of hashes
[in]	path	Path of file

Definition at line 105 of file gnunet-service-messenger_list_messages.c.

{
  GNUNET_assert ((messages) && (path));
 
  if (GNUNET_YES != GNUNET_DISK_file_test (path))
    return;
 
  enum GNUNET_DISK_AccessPermissions permission = (GNUNET_DISK_PERM_USER_READ
                                                   | GNUNET_DISK_PERM_USER_WRITE);
 
  struct GNUNET_DISK_FileHandle *handle = GNUNET_DISK_file_open (
    path, GNUNET_DISK_OPEN_READ, permission
    );
 
  if (! handle)
    return;
 
  GNUNET_DISK_file_seek (handle, 0, GNUNET_DISK_SEEK_SET);
 
  struct GNUNET_HashCode hash;
  ssize_t len;
 
  do {
    len = GNUNET_DISK_file_read (handle, &hash, sizeof(hash));
 
    if (len != sizeof(hash))
      break;
 
    add_to_list_messages (messages, &hash);
  } while (len == sizeof(hash));
 
  GNUNET_DISK_file_close (handle);
}

References add_to_list_messages(), GNUNET_assert, GNUNET_DISK_file_close(), GNUNET_DISK_file_open(), GNUNET_DISK_file_read(), GNUNET_DISK_file_seek(), GNUNET_DISK_file_test(), GNUNET_DISK_OPEN_READ, GNUNET_DISK_PERM_USER_READ, GNUNET_DISK_PERM_USER_WRITE, GNUNET_DISK_SEEK_SET, GNUNET_YES, and handle.

Referenced by load_member_session(), and load_message_state().

Here is the call graph for this function:

Here is the caller graph for this function:

save_list_messages()

void save_list_messages	(	const struct GNUNET_MESSENGER_ListMessages *	messages,
		const char *	path
	)

Saves the list of message hashes to a file under a given path.

Parameters

[in]	messages	List of hashes
[in]	path	Path of file

Definition at line 142 of file gnunet-service-messenger_list_messages.c.

{
  GNUNET_assert ((messages) && (path));
 
  enum GNUNET_DISK_AccessPermissions permission = (GNUNET_DISK_PERM_USER_READ
                                                   | GNUNET_DISK_PERM_USER_WRITE);
 
  struct GNUNET_DISK_FileHandle *handle = GNUNET_DISK_file_open (
    path, GNUNET_DISK_OPEN_CREATE | GNUNET_DISK_OPEN_WRITE, permission
    );
 
  if (! handle)
    return;
 
  GNUNET_DISK_file_seek (handle, 0, GNUNET_DISK_SEEK_SET);
 
  struct GNUNET_MESSENGER_ListMessage *element;
 
  for (element = messages->head; element; element = element->next)
    GNUNET_DISK_file_write (handle, &(element->hash), sizeof(element->hash));
 
  GNUNET_DISK_file_sync (handle);
  GNUNET_DISK_file_close (handle);
}

References GNUNET_assert, GNUNET_DISK_file_close(), GNUNET_DISK_file_open(), GNUNET_DISK_file_seek(), GNUNET_DISK_file_sync(), GNUNET_DISK_file_write(), GNUNET_DISK_OPEN_CREATE, GNUNET_DISK_OPEN_WRITE, GNUNET_DISK_PERM_USER_READ, GNUNET_DISK_PERM_USER_WRITE, GNUNET_DISK_SEEK_SET, handle, GNUNET_MESSENGER_ListMessage::hash, GNUNET_MESSENGER_ListMessages::head, and GNUNET_MESSENGER_ListMessage::next.

Referenced by save_member_session(), and save_message_state().

Here is the call graph for this function:

Here is the caller graph for this function: