messenger_api_handle.c File Reference

#include "messenger_api_handle.h"
#include "messenger_api_room.h"
#include "messenger_api_util.h"

Include dependency graph for messenger_api_handle.c:

Go to the source code of this file.

Functions
struct GNUNET_MESSENGER_Handle *	create_handle (const struct GNUNET_CONFIGURATION_Handle *cfg, GNUNET_MESSENGER_MessageCallback msg_callback, void *msg_cls)
	Creates and allocates a new handle using a given configuration and a custom message callback with a given closure for the client API. More...
static enum GNUNET_GenericReturnValue	iterate_destroy_room (void *cls, const struct GNUNET_HashCode *key, void *value)
void	destroy_handle (struct GNUNET_MESSENGER_Handle *handle)
	Destroys a handle and frees its memory fully from the client API. More...
void	set_handle_name (struct GNUNET_MESSENGER_Handle *handle, const char *name)
	Sets the name of a handle to a specific name. More...
const char *	get_handle_name (const struct GNUNET_MESSENGER_Handle *handle)
	Returns the current name of a given handle or NULL if no valid name was assigned yet. More...
void	set_handle_key (struct GNUNET_MESSENGER_Handle *handle, const struct GNUNET_CRYPTO_PrivateKey *key)
	Sets the keypair of a given handle to the keypair of a specific private key. More...
const struct GNUNET_CRYPTO_PrivateKey *	get_handle_key (const struct GNUNET_MESSENGER_Handle *handle)
	Returns the private key of a given handle. More...
const struct GNUNET_CRYPTO_PublicKey *	get_handle_pubkey (const struct GNUNET_MESSENGER_Handle *handle)
	Returns the public key of a given handle. More...
struct GNUNET_MESSENGER_ContactStore *	get_handle_contact_store (struct GNUNET_MESSENGER_Handle *handle)
	Returns the used contact store of a given handle. More...
struct GNUNET_MESSENGER_Contact *	get_handle_contact (struct GNUNET_MESSENGER_Handle *handle, const struct GNUNET_HashCode *key)
	Returns the contact of a given handle in a room identified by a given key. More...
void	open_handle_room (struct GNUNET_MESSENGER_Handle *handle, const struct GNUNET_HashCode *key)
	Marks a room known to a handle identified by a given key as open. More...
void	entry_handle_room_at (struct GNUNET_MESSENGER_Handle *handle, const struct GNUNET_PeerIdentity *door, const struct GNUNET_HashCode *key)
	Adds a tunnel for a room known to a handle identified by a given key to a list of opened connections. More...
void	close_handle_room (struct GNUNET_MESSENGER_Handle *handle, const struct GNUNET_HashCode *key)
	Destroys and so implicitly closes a room known to a handle identified by a given key. More...
struct GNUNET_MESSENGER_Room *	get_handle_room (struct GNUNET_MESSENGER_Handle *handle, const struct GNUNET_HashCode *key)
	Returns the room known to a handle identified by a given key. More...

Function Documentation

create_handle()

struct GNUNET_MESSENGER_Handle * create_handle	(	const struct GNUNET_CONFIGURATION_Handle *	cfg,
		GNUNET_MESSENGER_MessageCallback	msg_callback,
		void *	msg_cls
	)

Creates and allocates a new handle using a given configuration and a custom message callback with a given closure for the client API.

Parameters

[in]	cfg	Configuration
[in]	msg_callback	Message callback
[in,out]	msg_cls	Closure

Returns

New handle

Definition at line 32 of file messenger_api_handle.c.

{
  struct GNUNET_MESSENGER_Handle *handle;
 
  GNUNET_assert (cfg);
 
  handle = GNUNET_new (struct GNUNET_MESSENGER_Handle);
 
  handle->cfg = cfg;
  handle->mq = NULL;
 
  handle->msg_callback = msg_callback;
  handle->msg_cls = msg_cls;
 
  handle->name = NULL;
  handle->key = NULL;
  handle->pubkey = NULL;
 
  handle->reconnect_time = GNUNET_TIME_relative_get_zero_ ();
  handle->reconnect_task = NULL;
 
  handle->rooms = GNUNET_CONTAINER_multihashmap_create (8, GNUNET_NO);
 
  init_contact_store (get_handle_contact_store (handle));
 
  return handle;
}

References cfg, GNUNET_VPN_Handle::cfg, get_handle_contact_store(), GNUNET_assert, GNUNET_CONTAINER_multihashmap_create(), GNUNET_new, GNUNET_NO, GNUNET_TIME_relative_get_zero_(), handle, init_contact_store(), GNUNET_VPN_Handle::mq, GNUNET_MESSENGER_Handle::msg_callback, and GNUNET_MESSENGER_Handle::msg_cls.

Referenced by GNUNET_MESSENGER_connect().

Here is the call graph for this function:

Here is the caller graph for this function:

iterate_destroy_room()

static enum GNUNET_GenericReturnValue iterate_destroy_room ( void *  cls, const struct GNUNET_HashCode *  key, void *  value  )

static

Definition at line 64 of file messenger_api_handle.c.

{
  struct GNUNET_MESSENGER_Room *room;
 
  GNUNET_assert (value);
  
  room = value;
 
  destroy_room (room);
  return GNUNET_YES;
}

References destroy_room(), GNUNET_assert, GNUNET_YES, and value.

Referenced by destroy_handle().

Here is the call graph for this function:

Here is the caller graph for this function:

destroy_handle()

void destroy_handle

(

struct GNUNET_MESSENGER_Handle *

handle

)

Destroys a handle and frees its memory fully from the client API.

Parameters

[in,out]

handle

Handle

Definition at line 80 of file messenger_api_handle.c.

{
  GNUNET_assert (handle);
 
  clear_contact_store (get_handle_contact_store (handle));
 
  if (handle->rooms)
  {
    GNUNET_CONTAINER_multihashmap_iterate (handle->rooms, iterate_destroy_room,
                                           NULL);
 
    GNUNET_CONTAINER_multihashmap_destroy (handle->rooms);
  }
 
  if (handle->reconnect_task)
    GNUNET_SCHEDULER_cancel (handle->reconnect_task);
 
  if (handle->mq)
    GNUNET_MQ_destroy (handle->mq);
 
  if (handle->name)
    GNUNET_free (handle->name);
 
  if (handle->key)
    GNUNET_free (handle->key);
 
  if (handle->pubkey)
    GNUNET_free (handle->pubkey);
 
  GNUNET_free (handle);
}

References clear_contact_store(), get_handle_contact_store(), GNUNET_assert, GNUNET_CONTAINER_multihashmap_destroy(), GNUNET_CONTAINER_multihashmap_iterate(), GNUNET_free, GNUNET_MQ_destroy(), GNUNET_SCHEDULER_cancel(), handle, iterate_destroy_room(), and GNUNET_VPN_Handle::mq.

Referenced by GNUNET_MESSENGER_connect(), and GNUNET_MESSENGER_disconnect().

Here is the call graph for this function:

Here is the caller graph for this function:

set_handle_name()

void set_handle_name	(	struct GNUNET_MESSENGER_Handle *	handle,
		const char *	name
	)

Sets the name of a handle to a specific name.

Parameters

[in,out]	handle	Handle
[in]	name	New name

Definition at line 114 of file messenger_api_handle.c.

{
  GNUNET_assert (handle);
 
  if (handle->name)
    GNUNET_free (handle->name);
 
  handle->name = name ? GNUNET_strdup (name) : NULL;
}

References GNUNET_assert, GNUNET_free, GNUNET_strdup, handle, and name.

Referenced by GNUNET_MESSENGER_connect(), and GNUNET_MESSENGER_set_name().

Here is the caller graph for this function:

get_handle_name()

const char * get_handle_name

(

const struct GNUNET_MESSENGER_Handle *

handle

)

Returns the current name of a given handle or NULL if no valid name was assigned yet.

Parameters

[in]

handle

Handle

Returns

Name of the handle or NULL

Definition at line 127 of file messenger_api_handle.c.

{
  GNUNET_assert (handle);
 
  return handle->name;
}

References GNUNET_assert, and handle.

Referenced by GNUNET_MESSENGER_get_name(), handle_name_message(), iterate_send_name_to_room(), and send_message_to_room_with_key().

Here is the caller graph for this function:

set_handle_key()

void set_handle_key	(	struct GNUNET_MESSENGER_Handle *	handle,
		const struct GNUNET_CRYPTO_PrivateKey *	key
	)

Sets the keypair of a given handle to the keypair of a specific private key.

Parameters

[in,out]	handle	Handle
[in]	key	Private key or NULL

Definition at line 136 of file messenger_api_handle.c.

{
  GNUNET_assert (handle);
 
  if (! key)
  {
    if (handle->key)
      GNUNET_free (handle->key);
 
    if (handle->pubkey)
      GNUNET_free (handle->pubkey);
 
    handle->key = NULL;
    handle->pubkey = NULL;
    return;
  }
 
  if (! handle->key)
    handle->key = GNUNET_new (struct GNUNET_CRYPTO_PrivateKey);
 
  if (! handle->pubkey)
    handle->pubkey = GNUNET_new (struct GNUNET_CRYPTO_PublicKey);
 
  GNUNET_memcpy (handle->key, key, sizeof(*key));
  GNUNET_CRYPTO_key_get_public (key, handle->pubkey);
}

References GNUNET_assert, GNUNET_CRYPTO_key_get_public(), GNUNET_free, GNUNET_memcpy, GNUNET_new, handle, and key.

Referenced by GNUNET_MESSENGER_connect(), and GNUNET_MESSENGER_set_key().

Here is the call graph for this function:

Here is the caller graph for this function:

get_handle_key()

const struct GNUNET_CRYPTO_PrivateKey * get_handle_key

(

const struct GNUNET_MESSENGER_Handle *

handle

)

Returns the private key of a given handle.

Parameters

[in]

handle

Handle

Returns

Private key of the handle

Definition at line 166 of file messenger_api_handle.c.

{
  GNUNET_assert (handle);
 
  if (handle->key)
    return handle->key;
 
  return get_anonymous_private_key ();
}

References get_anonymous_private_key(), GNUNET_assert, and handle.

Referenced by enqueue_message_to_room(), handle_member_id(), and handle_private_message().

Here is the call graph for this function:

Here is the caller graph for this function:

get_handle_pubkey()

const struct GNUNET_CRYPTO_PublicKey * get_handle_pubkey

(

const struct GNUNET_MESSENGER_Handle *

handle

)

Returns the public key of a given handle.

Parameters

[in]

handle

Handle

Returns

Public key of the handle

Definition at line 178 of file messenger_api_handle.c.

{
  GNUNET_assert (handle);
 
  if (handle->pubkey)
    return handle->pubkey;
 
  return get_anonymous_public_key ();
}

References get_anonymous_public_key(), GNUNET_assert, and handle.

Referenced by get_handle_contact(), GNUNET_MESSENGER_get_key(), send_enter_room(), send_message_to_room_with_key(), and send_open_room().

Here is the call graph for this function:

Here is the caller graph for this function:

get_handle_contact_store()

struct GNUNET_MESSENGER_ContactStore * get_handle_contact_store

(

struct GNUNET_MESSENGER_Handle *

handle

)

Returns the used contact store of a given handle.

Parameters

[in,out]

handle

Handle

Returns

Contact store

Definition at line 190 of file messenger_api_handle.c.

{
  GNUNET_assert (handle);
 
  return &(handle->contact_store);
}

References GNUNET_assert, and handle.

Referenced by create_handle(), destroy_handle(), get_handle_contact(), handle_id_message(), handle_join_message(), handle_key_message(), handle_transcript_message(), process_message_control(), and task_message_control().

Here is the caller graph for this function:

get_handle_contact()

struct GNUNET_MESSENGER_Contact * get_handle_contact	(	struct GNUNET_MESSENGER_Handle *	handle,
		const struct GNUNET_HashCode *	key
	)

Returns the contact of a given handle in a room identified by a given key.

Parameters

[in,out]	handle	Handle
[in]	key	Key of room

Returns

Contact

Definition at line 199 of file messenger_api_handle.c.

{
  struct GNUNET_MESSENGER_Room *room;
  const struct GNUNET_ShortHashCode *contact_id;
 
  GNUNET_assert ((handle) && (key));
 
  room = GNUNET_CONTAINER_multihashmap_get (handle->rooms, key);
 
  if (! room)
    return NULL;
 
  contact_id = get_room_sender_id (room);
 
  if (! contact_id)
    return NULL;
 
  {
    struct GNUNET_HashCode context;
    get_context_from_member (key, contact_id, &context);
 
    return get_store_contact (get_handle_contact_store (handle),
                              &context,
                              get_handle_pubkey (handle));
  }
}

References context, get_context_from_member(), get_handle_contact_store(), get_handle_pubkey(), get_room_sender_id(), get_store_contact(), GNUNET_assert, GNUNET_CONTAINER_multihashmap_get(), handle, and key.

Referenced by handle_delete_message(), handle_private_message(), and handle_transcript_message().

Here is the call graph for this function:

Here is the caller graph for this function:

open_handle_room()

void open_handle_room	(	struct GNUNET_MESSENGER_Handle *	handle,
		const struct GNUNET_HashCode *	key
	)

Marks a room known to a handle identified by a given key as open.

Parameters

[in,out]	handle	Handle
[in]	key	Key of room

Definition at line 229 of file messenger_api_handle.c.

{
  struct GNUNET_MESSENGER_Room *room;
 
  GNUNET_assert ((handle) && (key));
 
  room = GNUNET_CONTAINER_multihashmap_get (handle->rooms, key);
 
  if (room)
    room->opened = GNUNET_YES;
}

References GNUNET_assert, GNUNET_CONTAINER_multihashmap_get(), GNUNET_YES, handle, key, and GNUNET_MESSENGER_Room::opened.

Referenced by handle_room_open().

Here is the call graph for this function:

Here is the caller graph for this function:

entry_handle_room_at()

void entry_handle_room_at	(	struct GNUNET_MESSENGER_Handle *	handle,
		const struct GNUNET_PeerIdentity *	door,
		const struct GNUNET_HashCode *	key
	)

Adds a tunnel for a room known to a handle identified by a given key to a list of opened connections.

Parameters

[in,out]	handle	Handle
[in]	door	Peer identity
[in]	key	Key of room

Definition at line 244 of file messenger_api_handle.c.

{
  struct GNUNET_MESSENGER_Room *room;
 
  GNUNET_assert ((handle) && (door) && (key));
 
  room = GNUNET_CONTAINER_multihashmap_get (handle->rooms, key);
 
  if (room)
    add_to_list_tunnels (&(room->entries), door, NULL);
}

References add_to_list_tunnels(), GNUNET_MESSENGER_Room::entries, GNUNET_assert, GNUNET_CONTAINER_multihashmap_get(), handle, and key.

Referenced by handle_room_entry().

Here is the call graph for this function:

Here is the caller graph for this function:

close_handle_room()

void close_handle_room	(	struct GNUNET_MESSENGER_Handle *	handle,
		const struct GNUNET_HashCode *	key
	)

Destroys and so implicitly closes a room known to a handle identified by a given key.

Parameters

[in,out]	handle	Handle
[in]	key	Key of room

Definition at line 260 of file messenger_api_handle.c.

{
  struct GNUNET_MESSENGER_Room *room;
 
  GNUNET_assert ((handle) && (key));
 
  room = GNUNET_CONTAINER_multihashmap_get (handle->rooms, key);
 
  if ((room) && (GNUNET_YES == GNUNET_CONTAINER_multihashmap_remove (
                   handle->rooms, key, room)))
    destroy_room (room);
}

References destroy_room(), GNUNET_assert, GNUNET_CONTAINER_multihashmap_get(), GNUNET_CONTAINER_multihashmap_remove(), GNUNET_YES, handle, and key.

Referenced by handle_room_close().

Here is the call graph for this function:

Here is the caller graph for this function:

get_handle_room()

struct GNUNET_MESSENGER_Room * get_handle_room	(	struct GNUNET_MESSENGER_Handle *	handle,
		const struct GNUNET_HashCode *	key
	)

Returns the room known to a handle identified by a given key.

Parameters

[in,out]	handle	handle Handle
[in]	key	Key of room

Returns

Room or NULL

Definition at line 276 of file messenger_api_handle.c.

{
  GNUNET_assert ((handle) && (key));
 
  return GNUNET_CONTAINER_multihashmap_get (handle->rooms, key);
}

References GNUNET_assert, GNUNET_CONTAINER_multihashmap_get(), handle, and key.

Referenced by handle_member_id(), handle_miss_message(), handle_recv_message(), handle_room_close(), handle_room_entry(), handle_room_open(), and handle_room_sync().

Here is the call graph for this function:

Here is the caller graph for this function: