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

#include "platform.h"
#include "messenger_api_contact.h"

Include dependency graph for messenger_api_contact.c:

Functions
struct GNUNET_MESSENGER_Contact *	create_contact (const struct GNUNET_IDENTITY_PublicKey *key)
	Creates and allocates a new contact with a given public key from an EGO. More...

void	destroy_contact (struct GNUNET_MESSENGER_Contact *contact)
	Destroys a contact and frees its memory fully. More...

const char *	get_contact_name (const struct GNUNET_MESSENGER_Contact *contact)
	Returns the current name of a given contact or NULL if no valid name was assigned yet. More...

void	set_contact_name (struct GNUNET_MESSENGER_Contact contact, const char name)
	Changes the current name of a given contact by copying it from the parameter name. More...

const struct GNUNET_IDENTITY_PublicKey *	get_contact_key (const struct GNUNET_MESSENGER_Contact *contact)
	Returns the public key of a given contact. More...

void	increase_contact_rc (struct GNUNET_MESSENGER_Contact *contact)
	Increases the reference counter of a given contact which is zero as default. More...

int	decrease_contact_rc (struct GNUNET_MESSENGER_Contact *contact)
	Decreases the reference counter if possible (can not underflow!) of a given contact and returns GNUNET_YES if the counter is equal to zero, otherwise GNUNET_NO. More...

void	get_context_from_member (const struct GNUNET_HashCode key, const struct GNUNET_ShortHashCode id, struct GNUNET_HashCode *context)
	Calculates the context hash of a member in a room and returns it. More...

Detailed Description

messenger api: client implementation of GNUnet MESSENGER service

Author: Tobias Frisch

Definition in file messenger_api_contact.c.

Function Documentation

◆ create_contact()

struct GNUNET_MESSENGER_Contact* create_contact ( const struct GNUNET_IDENTITY_PublicKey * key )

Creates and allocates a new contact with a given public key from an EGO.

Parameters

[in] key Public key

Returns: New contact

Definition at line 30 of file messenger_api_contact.c.

 {
   GNUNET_assert(key);
  
   struct GNUNET_MESSENGER_Contact *contact = GNUNET_new(struct GNUNET_MESSENGER_Contact);
  
   contact->name = NULL;
   contact->rc = 0;
  
   GNUNET_memcpy(&(contact->public_key), key, sizeof(contact->public_key));
  
   return contact;
 }

References GNUNET_assert, GNUNET_memcpy, GNUNET_new, key, GNUNET_MESSENGER_Contact::name, GNUNET_MESSENGER_Contact::public_key, and GNUNET_MESSENGER_Contact::rc.

Referenced by get_store_contact().

Here is the caller graph for this function:

◆ destroy_contact()

void destroy_contact ( struct GNUNET_MESSENGER_Contact * contact )

Destroys a contact and frees its memory fully.

Parameters

[in,out] contact Contact

Definition at line 45 of file messenger_api_contact.c.

 {
   GNUNET_assert(contact);
  
   if (contact->name)
     GNUNET_free(contact->name);
  
   GNUNET_free(contact);
 }

References GNUNET_assert, GNUNET_free, and GNUNET_MESSENGER_Contact::name.

Referenced by get_store_contact(), iterate_destroy_contacts(), and remove_store_contact().

Here is the caller graph for this function:

◆ get_contact_name()

const char* get_contact_name ( const struct GNUNET_MESSENGER_Contact * contact )

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

Parameters

[in] contact Contact

Returns: Name of the contact or NULL

Definition at line 56 of file messenger_api_contact.c.

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

References GNUNET_assert, and GNUNET_MESSENGER_Contact::name.

Referenced by GNUNET_MESSENGER_contact_get_name().

Here is the caller graph for this function:

◆ set_contact_name()

void set_contact_name	(	struct GNUNET_MESSENGER_Contact *	contact,
		const char *	name
	)

Changes the current name of a given contact by copying it from the parameter name.

Parameters

[in,out]	contact	Contact
[in]	name	Name

Definition at line 64 of file messenger_api_contact.c.

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

References GNUNET_assert, GNUNET_free, GNUNET_strdup, name, and GNUNET_MESSENGER_Contact::name.

Referenced by handle_message_name(), and handle_name_message().

Here is the caller graph for this function:

◆ get_contact_key()

const struct GNUNET_IDENTITY_PublicKey* get_contact_key ( const struct GNUNET_MESSENGER_Contact * contact )

Returns the public key of a given contact.

Parameters

[in] contact Contact

Returns: Public key of the contact

Definition at line 76 of file messenger_api_contact.c.

 {
   GNUNET_assert(contact);
  
   return &(contact->public_key);
 }

References GNUNET_assert, and GNUNET_MESSENGER_Contact::public_key.

Referenced by get_store_contact(), GNUNET_MESSENGER_contact_get_key(), GNUNET_MESSENGER_send_message(), handle_id_message(), notify_srv_handle_message(), remove_store_contact(), and update_store_contact().

Here is the caller graph for this function:

◆ increase_contact_rc()

void increase_contact_rc ( struct GNUNET_MESSENGER_Contact * contact )

Increases the reference counter of a given contact which is zero as default.

Parameters

[in,out] contact Contact

Definition at line 84 of file messenger_api_contact.c.

 {
   GNUNET_assert(contact);
  
   contact->rc++;
 }

References GNUNET_assert, and GNUNET_MESSENGER_Contact::rc.

Referenced by create_member_session(), handle_join_message(), reset_member_session(), and switch_member_session().

Here is the caller graph for this function:

◆ decrease_contact_rc()

int decrease_contact_rc ( struct GNUNET_MESSENGER_Contact * contact )

Decreases the reference counter if possible (can not underflow!) of a given contact and returns GNUNET_YES if the counter is equal to zero, otherwise GNUNET_NO.

Parameters

[in,out] contact Contact

Returns: GNUNET_YES or GNUNET_NO depending on the reference counter

Definition at line 92 of file messenger_api_contact.c.

 {
   GNUNET_assert(contact);
  
   if (contact->rc > 0)
     contact->rc--;
  
   return contact->rc ? GNUNET_NO : GNUNET_YES;
 }

References GNUNET_assert, GNUNET_NO, GNUNET_YES, and GNUNET_MESSENGER_Contact::rc.

Referenced by check_member_session_completion(), destroy_member_session(), and handle_leave_message().

Here is the caller graph for this function:

◆ get_context_from_member()

void get_context_from_member	(	const struct GNUNET_HashCode *	key,
		const struct GNUNET_ShortHashCode *	id,
		struct GNUNET_HashCode *	context
	)

Calculates the context hash of a member in a room and returns it.

Parameters

[in]	key	Key of room
[in]	id	Member id
[out]	context	Member context

Definition at line 103 of file messenger_api_contact.c.

 {
   GNUNET_assert((key) && (id) && (context));
  
   GNUNET_CRYPTO_hash (id, sizeof(*id), context);
   GNUNET_CRYPTO_hash_xor (key, context, context);
 }

References context, GNUNET_assert, GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_hash_xor(), and key.

Referenced by create_member_session(), get_handle_contact(), handle_id_message(), handle_join_message(), handle_key_message(), handle_leave_message(), and switch_member_session().

Here is the call graph for this function:

Here is the caller graph for this function:

Functions

Detailed Description

Function Documentation

◆ create_contact()

◆ destroy_contact()

◆ get_contact_name()

◆ set_contact_name()

◆ get_contact_key()

◆ increase_contact_rc()

◆ decrease_contact_rc()

◆ get_context_from_member()