messenger_api_util.h File Reference

#include "gnunet_cadet_service.h"
#include "gnunet_util_lib.h"

Include dependency graph for messenger_api_util.h:

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

Go to the source code of this file.

Functions
void	delayed_disconnect_channel (struct GNUNET_CADET_Channel *channel)
	Starts an urgent task to close a CADET channel asynchronously. More...
enum GNUNET_GenericReturnValue	generate_free_member_id (struct GNUNET_ShortHashCode *id, const struct GNUNET_CONTAINER_MultiShortmap *members)
	Tries to generate an unused member id and store it into the id parameter. More...
const struct GNUNET_CRYPTO_PrivateKey *	get_anonymous_private_key ()
	Returns the private identity key of GNUNET_IDENTITY_ego_get_anonymous() without recalculating it every time. More...
const struct GNUNET_CRYPTO_PublicKey *	get_anonymous_public_key ()
	Returns the public identity key of GNUNET_IDENTITY_ego_get_anonymous() without recalculating it every time. More...
void	convert_messenger_key_to_port (const struct GNUNET_HashCode *key, struct GNUNET_HashCode *port)
	Converts a Messenger service key of a room to the specific port which gets used for the CADET channels. More...
void	convert_peer_identity_to_id (const struct GNUNET_PeerIdentity *identity, struct GNUNET_ShortHashCode *id)
	Converts a peers identity to a short hash code which can be used as id to refer to a peer via sender id as attached in messages. More...

Function Documentation

delayed_disconnect_channel()

void delayed_disconnect_channel

(

struct GNUNET_CADET_Channel *

channel

)

Starts an urgent task to close a CADET channel asynchronously.

Parameters

[in,out]

channel

Channel

Definition at line 42 of file messenger_api_util.c.

{
  GNUNET_assert (channel);
 
  GNUNET_SCHEDULER_add_delayed_with_priority (GNUNET_TIME_relative_get_zero_ (),
                                              GNUNET_SCHEDULER_PRIORITY_URGENT,
                                              callback_close_channel, channel);
}

References callback_close_channel(), GNUNET_assert, GNUNET_SCHEDULER_add_delayed_with_priority(), GNUNET_SCHEDULER_PRIORITY_URGENT, and GNUNET_TIME_relative_get_zero_().

Referenced by bind_tunnel(), callback_room_connect(), and disconnect_tunnel().

Here is the call graph for this function:

Here is the caller graph for this function:

generate_free_member_id()

enum GNUNET_GenericReturnValue generate_free_member_id	(	struct GNUNET_ShortHashCode *	id,
		const struct GNUNET_CONTAINER_MultiShortmap *	members
	)

Tries to generate an unused member id and store it into the id parameter.

A map containing all currently used member ids is used to check against.

Parameters

[out]	id	New member id
[in]	members	Map of member ids

Returns

GNUNET_YES on success, GNUNET_NO on failure

Definition at line 53 of file messenger_api_util.c.

{
  GNUNET_assert (id);
 
  size_t counter = 1 + (members ? GNUNET_CONTAINER_multishortmap_size (
                          members) : 0);
 
  do
  {
    GNUNET_CRYPTO_random_block (GNUNET_CRYPTO_QUALITY_STRONG, id, sizeof(struct
                                                                         GNUNET_ShortHashCode));
 
    if ((members) && (GNUNET_YES == GNUNET_CONTAINER_multishortmap_contains (
                        members, id)))
      counter--;
    else
      break;
  }
  while (counter > 0);
 
  if (counter)
    return GNUNET_YES;
 
  return GNUNET_NO;
}

References GNUNET_assert, GNUNET_CONTAINER_multishortmap_contains(), GNUNET_CONTAINER_multishortmap_size(), GNUNET_CRYPTO_QUALITY_STRONG, GNUNET_CRYPTO_random_block(), GNUNET_NO, and GNUNET_YES.

Referenced by create_handle_member_id(), create_member(), and solve_srv_room_member_collisions().

Here is the call graph for this function:

Here is the caller graph for this function:

get_anonymous_private_key()

const struct GNUNET_CRYPTO_PrivateKey * get_anonymous_private_key

(

)

Returns the private identity key of GNUNET_IDENTITY_ego_get_anonymous() without recalculating it every time.

Returns

anonymous private key

Definition at line 82 of file messenger_api_util.c.

{
  const struct GNUNET_IDENTITY_Ego *ego = GNUNET_IDENTITY_ego_get_anonymous ();
  return GNUNET_IDENTITY_ego_get_private_key (ego);
}

References GNUNET_IDENTITY_ego_get_anonymous(), and GNUNET_IDENTITY_ego_get_private_key().

Referenced by get_handle_key().

Here is the call graph for this function:

Here is the caller graph for this function:

get_anonymous_public_key()

const struct GNUNET_CRYPTO_PublicKey * get_anonymous_public_key

(

)

Returns the public identity key of GNUNET_IDENTITY_ego_get_anonymous() without recalculating it every time.

Returns

anonymous public key

Definition at line 90 of file messenger_api_util.c.

{
  static struct GNUNET_CRYPTO_PublicKey public_key;
  static struct GNUNET_IDENTITY_Ego *ego = NULL;
 
  if (! ego)
  {
    ego = GNUNET_IDENTITY_ego_get_anonymous ();
    GNUNET_IDENTITY_ego_get_public_key (ego, &public_key);
  }
 
  return &public_key;
}

References GNUNET_IDENTITY_ego_get_anonymous(), and GNUNET_IDENTITY_ego_get_public_key().

Referenced by get_handle_pubkey(), get_non_anonymous_key(), initialize_service_handle(), and select_store_contact_map().

Here is the call graph for this function:

Here is the caller graph for this function:

convert_messenger_key_to_port()

void convert_messenger_key_to_port	(	const struct GNUNET_HashCode *	key,
		struct GNUNET_HashCode *	port
	)

Converts a Messenger service key of a room to the specific port which gets used for the CADET channels.

The port includes upper bits of the GNUNET_MESSENGER_VERSION to reduce the chance of incompatible connections.

Parameters

[in]	key	Messenger service room key
[out]	port	CADET service port

Definition at line 106 of file messenger_api_util.c.

{
  static uint32_t version_value = 0;
  static struct GNUNET_HashCode version;
 
  if (! version_value)
  {
    version_value = (uint32_t) (GNUNET_MESSENGER_VERSION);
    version_value = ((version_value >> 16) & 0xFFFF);
    version_value = GNUNET_htole32 (version_value);
    GNUNET_CRYPTO_hash (&version_value, sizeof(version_value), &version);
  }
 
  GNUNET_CRYPTO_hash_sum (key, &version, port);
}

References GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_hash_sum(), GNUNET_htole32, GNUNET_MESSENGER_VERSION, key, and port.

Referenced by connect_tunnel(), and open_srv_room().

Here is the call graph for this function:

Here is the caller graph for this function:

convert_peer_identity_to_id()

void convert_peer_identity_to_id	(	const struct GNUNET_PeerIdentity *	identity,
		struct GNUNET_ShortHashCode *	id
	)

Converts a peers identity to a short hash code which can be used as id to refer to a peer via sender id as attached in messages.

Parameters

[in]	identity	Peer identity
[out]	id	Short peer id

Definition at line 125 of file messenger_api_util.c.

{
  GNUNET_memcpy (id, identity, sizeof(struct GNUNET_ShortHashCode));
}

References GNUNET_memcpy, and identity.

Referenced by get_store_peer_of(), load_peer_store(), pack_srv_room_message(), and update_store_peer().

Here is the caller graph for this function: