messenger_api_handle.c File Reference

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

#include "platform.h"
#include "messenger_api_handle.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_IdentityCallback identity_callback, void *identity_cls, 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 int	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_IDENTITY_PublicKey *pubkey)
	Sets the public key of a given handle to a specific public key. More...
const struct GNUNET_IDENTITY_PublicKey *	get_handle_key (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...

Detailed Description

messenger api: client implementation of GNUnet MESSENGER service

Author

Tobias Frisch

Definition in file messenger_api_handle.c.

Function Documentation

create_handle()

struct GNUNET_MESSENGER_Handle* create_handle	(	const struct GNUNET_CONFIGURATION_Handle *	cfg,
		GNUNET_MESSENGER_IdentityCallback	identity_callback,
		void *	identity_cls,
		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.

{
  GNUNET_assert(cfg);
 
  struct GNUNET_MESSENGER_Handle *handle = GNUNET_new(struct GNUNET_MESSENGER_Handle);
 
  handle->cfg = cfg;
  handle->mq = NULL;
 
  handle->identity_callback = identity_callback;
  handle->identity_cls = identity_cls;
 
  handle->msg_callback = msg_callback;
  handle->msg_cls = msg_cls;
 
  handle->name = 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_DNS_Handle::cfg, get_handle_contact_store(), GNUNET_assert, GNUNET_CONTAINER_multihashmap_create(), GNUNET_new, GNUNET_NO, GNUNET_TIME_relative_get_zero_(), handle, GNUNET_MESSENGER_Handle::identity_callback, GNUNET_MESSENGER_Handle::identity_cls, init_contact_store(), GNUNET_DNS_Handle::mq, GNUNET_MESSENGER_Handle::msg_callback, GNUNET_MESSENGER_Handle::msg_cls, and GNUNET_DNS_Handle::reconnect_task.

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 int iterate_destroy_room ( void *  cls, const struct GNUNET_HashCode *  key, void *  value  )

static

Definition at line 65 of file messenger_api_handle.c.

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

References destroy_room(), 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 77 of file messenger_api_handle.c.

{
  GNUNET_assert(handle);
 
  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->pubkey)
    GNUNET_free(handle->pubkey);
 
  if (handle->rooms)
  {
    GNUNET_CONTAINER_multihashmap_iterate (handle->rooms, iterate_destroy_room, NULL);
 
    GNUNET_CONTAINER_multihashmap_destroy (handle->rooms);
  }
 
  clear_contact_store(get_handle_contact_store(handle));
 
  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(), GNUNET_DNS_Handle::mq, and GNUNET_DNS_Handle::reconnect_task.

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 106 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 handle_get_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 118 of file messenger_api_handle.c.

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

References GNUNET_assert, and handle.

Referenced by GNUNET_MESSENGER_get_name(), and GNUNET_MESSENGER_update().

Here is the caller graph for this function:

set_handle_key()

void set_handle_key	(	struct GNUNET_MESSENGER_Handle *	handle,
		const struct GNUNET_IDENTITY_PublicKey *	pubkey
	)

Sets the public key of a given handle to a specific public key.

Parameters

[in,out]	handle	Handle
[in]	pubkey	Public key

Definition at line 126 of file messenger_api_handle.c.

{
  GNUNET_assert(handle);
 
  if (!handle->pubkey)
    handle->pubkey = GNUNET_new(struct GNUNET_IDENTITY_PublicKey);
 
  GNUNET_memcpy(handle->pubkey, pubkey, sizeof(*pubkey));
}

References GNUNET_assert, GNUNET_memcpy, GNUNET_new, handle, and pubkey.

Referenced by handle_get_key().

Here is the caller graph for this function:

get_handle_key()

const struct GNUNET_IDENTITY_PublicKey* get_handle_key

(

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 138 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(), and GNUNET_MESSENGER_get_key().

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 149 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(), and handle_recv_message().

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 157 of file messenger_api_handle.c.

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

References GNUNET_MESSENGER_Room::contact_id, context, get_context_from_member(), get_handle_contact_store(), get_handle_key(), get_store_contact(), GNUNET_assert, GNUNET_CONTAINER_multihashmap_get(), handle, and key.

Referenced by handle_delete_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 174 of file messenger_api_handle.c.

{
  GNUNET_assert((handle) && (key));
 
  struct GNUNET_MESSENGER_Room *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 186 of file messenger_api_handle.c.

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

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 199 of file messenger_api_handle.c.

{
  GNUNET_assert((handle) && (key));
 
  struct GNUNET_MESSENGER_Room *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: