messenger_api_list_tunnels.c File Reference

messenger api: client and service implementation of GNUnet MESSENGER service More...

#include "messenger_api_list_tunnels.h"

Include dependency graph for messenger_api_list_tunnels.c:

Go to the source code of this file.

Functions
void	init_list_tunnels (struct GNUNET_MESSENGER_ListTunnels *tunnels)
	Initializes list of tunnels peer identities as empty list. More...
void	clear_list_tunnels (struct GNUNET_MESSENGER_ListTunnels *tunnels)
	Clears the list of tunnels peer identities. More...
static int	compare_list_tunnels (void *cls, struct GNUNET_MESSENGER_ListTunnel *element0, struct GNUNET_MESSENGER_ListTunnel *element1)
void	add_to_list_tunnels (struct GNUNET_MESSENGER_ListTunnels *tunnels, const struct GNUNET_PeerIdentity *peer)
	Adds a specific peer from a tunnel to the end of the list. More...
struct GNUNET_MESSENGER_ListTunnel *	find_list_tunnels (struct GNUNET_MESSENGER_ListTunnels *tunnels, const struct GNUNET_PeerIdentity *peer, size_t *index)
	Searches linearly through the list of tunnels peer identities for matching a specific peer identity and returns the matching element of the list. More...
int	contains_list_tunnels (struct GNUNET_MESSENGER_ListTunnels *tunnels, const struct GNUNET_PeerIdentity *peer)
	Tests linearly if the list of tunnels peer identities contains a specific peer identity and returns GNUNET_YES on success, otherwise GNUNET_NO. More...
struct GNUNET_MESSENGER_ListTunnel *	remove_from_list_tunnels (struct GNUNET_MESSENGER_ListTunnels *tunnels, struct GNUNET_MESSENGER_ListTunnel *element)
	Removes a specific element from the list of tunnels peer identities and returns the next element in the list. More...
void	load_list_tunnels (struct GNUNET_MESSENGER_ListTunnels *tunnels, const char *path)
	Loads the list of tunnels peer identities from a file under a given path. More...
void	save_list_tunnels (struct GNUNET_MESSENGER_ListTunnels *tunnels, const char *path)
	Saves the list of tunnels peer identities to a file under a given path. More...

Detailed Description

messenger api: client and service implementation of GNUnet MESSENGER service

Author

Tobias Frisch

Definition in file messenger_api_list_tunnels.c.

Function Documentation

init_list_tunnels()

void init_list_tunnels

(

struct GNUNET_MESSENGER_ListTunnels *

tunnels

)

Initializes list of tunnels peer identities as empty list.

Parameters

[out]

tunnels

List of peer identities

Definition at line 29 of file messenger_api_list_tunnels.c.

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

Referenced by create_room().

{
  GNUNET_assert(tunnels);

  tunnels->head = NULL;
  tunnels->tail = NULL;
}

Here is the caller graph for this function:

clear_list_tunnels()

void clear_list_tunnels

(

struct GNUNET_MESSENGER_ListTunnels *

tunnels

)

Clears the list of tunnels peer identities.

Parameters

Definition at line 38 of file messenger_api_list_tunnels.c.

References GNUNET_assert, GNUNET_CONTAINER_DLL_remove, GNUNET_free, GNUNET_PEER_change_rc(), GNUNET_MESSENGER_ListTunnels::head, GNUNET_MESSENGER_ListTunnel::peer, and GNUNET_MESSENGER_ListTunnels::tail.

Referenced by destroy_room().

{
  GNUNET_assert(tunnels);

  struct GNUNET_MESSENGER_ListTunnel *element;

  for (element = tunnels->head; element; element = tunnels->head)
  {
    GNUNET_CONTAINER_DLL_remove(tunnels->head, tunnels->tail, element);
    GNUNET_PEER_change_rc (element->peer, -1);
    GNUNET_free(element);
  }

  tunnels->head = NULL;
  tunnels->tail = NULL;
}

Here is the call graph for this function:

Here is the caller graph for this function:

compare_list_tunnels()

static int compare_list_tunnels ( void *  cls, struct GNUNET_MESSENGER_ListTunnel *  element0, struct GNUNET_MESSENGER_ListTunnel *  element1  )

static

Definition at line 56 of file messenger_api_list_tunnels.c.

References consensus-simulation::int, and GNUNET_MESSENGER_ListTunnel::peer.

Referenced by add_to_list_tunnels().

{
  return ((int) element0->peer) - ((int) element1->peer);
}

Here is the caller graph for this function:

add_to_list_tunnels()

void add_to_list_tunnels	(	struct GNUNET_MESSENGER_ListTunnels *	tunnels,
		const struct GNUNET_PeerIdentity *	peer
	)

Adds a specific peer from a tunnel to the end of the list.

Parameters

Definition at line 63 of file messenger_api_list_tunnels.c.

References compare_list_tunnels(), GNUNET_assert, GNUNET_CONTAINER_DLL_insert_sorted, GNUNET_new, GNUNET_PEER_intern(), GNUNET_MESSENGER_ListTunnels::head, GNUNET_MESSENGER_ListTunnel::peer, and GNUNET_MESSENGER_ListTunnels::tail.

Referenced by entry_handle_room_at(), handle_message_peer(), and load_list_tunnels().

{
  GNUNET_assert((tunnels) && (peer));

  struct GNUNET_MESSENGER_ListTunnel *element = GNUNET_new(struct GNUNET_MESSENGER_ListTunnel);

  element->peer = GNUNET_PEER_intern (peer);

  GNUNET_CONTAINER_DLL_insert_sorted(struct GNUNET_MESSENGER_ListTunnel, compare_list_tunnels, NULL, tunnels->head,
                                     tunnels->tail, element);
}

Here is the call graph for this function:

Here is the caller graph for this function:

find_list_tunnels()

struct GNUNET_MESSENGER_ListTunnel* find_list_tunnels	(	struct GNUNET_MESSENGER_ListTunnels *	tunnels,
		const struct GNUNET_PeerIdentity *	peer,
		size_t *	index
	)

Searches linearly through the list of tunnels peer identities for matching a specific peer identity and returns the matching element of the list.

If no matching element is found, NULL gets returned.

If index is not NULL, index will be overridden with the numeric index of the found element in the list. If no matching element is found, index will contain the total amount of elements in the list.

Parameters

Definition at line 76 of file messenger_api_list_tunnels.c.

References GNUNET_assert, GNUNET_memcmp, GNUNET_PEER_resolve(), GNUNET_MESSENGER_ListTunnels::head, GNUNET_MESSENGER_ListTunnel::next, and GNUNET_MESSENGER_ListTunnel::peer.

Referenced by contains_list_tunnels(), handle_message_miss(), handle_miss_message(), and rebuild_room_basement_structure().

{
  GNUNET_assert((tunnels) && (peer));

  struct GNUNET_MESSENGER_ListTunnel *element;
  struct GNUNET_PeerIdentity pid;

  if (index)
    *index = 0;

  for (element = tunnels->head; element; element = element->next)
  {
    GNUNET_PEER_resolve (element->peer, &pid);

    if (0 == GNUNET_memcmp(&pid, peer))
      return element;

    if (index)
      (*index) = (*index) + 1;
  }

  return NULL;
}

Here is the call graph for this function:

Here is the caller graph for this function:

contains_list_tunnels()

int contains_list_tunnels	(	struct GNUNET_MESSENGER_ListTunnels *	tunnels,
		const struct GNUNET_PeerIdentity *	peer
	)

Tests linearly if the list of tunnels peer identities contains a specific peer identity and returns GNUNET_YES on success, otherwise GNUNET_NO.

Parameters

Definition at line 101 of file messenger_api_list_tunnels.c.

References find_list_tunnels(), GNUNET_assert, GNUNET_NO, and GNUNET_YES.

Referenced by callback_room_disconnect(), handle_message_peer(), and recv_message_info().

{
  GNUNET_assert((tunnels) && (peer));

  return find_list_tunnels (tunnels, peer, NULL) != NULL ? GNUNET_YES : GNUNET_NO;
}

Here is the call graph for this function:

Here is the caller graph for this function:

remove_from_list_tunnels()

struct GNUNET_MESSENGER_ListTunnel* remove_from_list_tunnels	(	struct GNUNET_MESSENGER_ListTunnels *	tunnels,
		struct GNUNET_MESSENGER_ListTunnel *	element
	)

Removes a specific element from the list of tunnels peer identities and returns the next element in the list.

Parameters

Definition at line 109 of file messenger_api_list_tunnels.c.

References GNUNET_assert, GNUNET_CONTAINER_DLL_remove, GNUNET_free, GNUNET_PEER_change_rc(), GNUNET_MESSENGER_ListTunnels::head, GNUNET_MESSENGER_ListTunnel::next, GNUNET_MESSENGER_ListTunnel::peer, and GNUNET_MESSENGER_ListTunnels::tail.

Referenced by handle_message_miss(), handle_miss_message(), and rebuild_room_basement_structure().

{
  GNUNET_assert((tunnels) && (element));

  struct GNUNET_MESSENGER_ListTunnel *next = element->next;

  GNUNET_CONTAINER_DLL_remove(tunnels->head, tunnels->tail, element);
  GNUNET_PEER_change_rc (element->peer, -1);
  GNUNET_free(element);

  return next;
}

Here is the call graph for this function:

Here is the caller graph for this function:

load_list_tunnels()

void load_list_tunnels	(	struct GNUNET_MESSENGER_ListTunnels *	tunnels,
		const char *	path
	)

Loads the list of tunnels peer identities from a file under a given path.

Parameters

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

Definition at line 123 of file messenger_api_list_tunnels.c.

References add_to_list_tunnels(), 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, handle, and len.

Referenced by load_room().

{
  GNUNET_assert((tunnels) && (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_PeerIdentity peer;
  ssize_t len;

  do {
    len = GNUNET_DISK_file_read(handle, &peer, sizeof(peer));

    if (len != sizeof(peer))
      break;

    add_to_list_tunnels(tunnels, &peer);
  } while (len == sizeof(peer));

  GNUNET_DISK_file_close(handle);
}

Here is the call graph for this function:

Here is the caller graph for this function:

save_list_tunnels()

void save_list_tunnels	(	struct GNUNET_MESSENGER_ListTunnels *	tunnels,
		const char *	path
	)

Saves the list of tunnels peer identities to a file under a given path.

Parameters

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

Definition at line 157 of file messenger_api_list_tunnels.c.

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, GNUNET_PEER_resolve(), handle, GNUNET_MESSENGER_ListTunnels::head, GNUNET_MESSENGER_ListTunnel::next, and GNUNET_MESSENGER_ListTunnel::peer.

Referenced by save_room().

{
  GNUNET_assert((tunnels) && (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_ListTunnel *element;
  struct GNUNET_PeerIdentity pid;

  for (element = tunnels->head; element; element = element->next)
  {
    GNUNET_PEER_resolve (element->peer, &pid);

    GNUNET_DISK_file_write(handle, &pid, sizeof(pid));
  }

  GNUNET_DISK_file_sync(handle);
  GNUNET_DISK_file_close(handle);
}

Here is the call graph for this function:

Here is the caller graph for this function: