#include "gnunet_util_lib.h"

Include dependency graph for messenger_api_contact_store.h:

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

Data Structures
struct	GNUNET_MESSENGER_ContactStore

Functions
void	init_contact_store (struct GNUNET_MESSENGER_ContactStore *store)
	Initializes a contact store as fully empty. More...

void	clear_contact_store (struct GNUNET_MESSENGER_ContactStore *store)
	Clears a contact store, wipes its content and deallocates its memory. More...

struct GNUNET_MESSENGER_Contact *	get_store_contact_raw (struct GNUNET_MESSENGER_ContactStore store, const struct GNUNET_HashCode context, const struct GNUNET_HashCode *key_hash)
	Returns a contact using the hash of a specific public key. More...

struct GNUNET_MESSENGER_Contact *	get_store_contact (struct GNUNET_MESSENGER_ContactStore store, const struct GNUNET_HashCode context, const struct GNUNET_CRYPTO_PublicKey *pubkey)
	Returns a contact using a specific public key. More...

void	update_store_contact (struct GNUNET_MESSENGER_ContactStore store, struct GNUNET_MESSENGER_Contact contact, const struct GNUNET_HashCode context, const struct GNUNET_HashCode next_context, const struct GNUNET_CRYPTO_PublicKey *pubkey)
	Moves a contact from the store to another location matching a given public key and member context. More...

void	remove_store_contact (struct GNUNET_MESSENGER_ContactStore store, struct GNUNET_MESSENGER_Contact contact, const struct GNUNET_HashCode *context)
	Removes a contact from the store which uses a given member context. More...

Function Documentation

◆ init_contact_store()

void init_contact_store ( struct GNUNET_MESSENGER_ContactStore * store )

Initializes a contact store as fully empty.

Parameters

[out] store Contact store

Definition at line 33 of file messenger_api_contact_store.c.

{
  GNUNET_assert (store);
 
  store->anonymous = GNUNET_CONTAINER_multihashmap_create (8, GNUNET_NO);
  store->contacts = GNUNET_CONTAINER_multihashmap_create (8, GNUNET_NO);
 
  store->counter = 0;
}

References GNUNET_MESSENGER_ContactStore::anonymous, GNUNET_MESSENGER_ContactStore::contacts, GNUNET_MESSENGER_ContactStore::counter, GNUNET_assert, GNUNET_CONTAINER_multihashmap_create(), and GNUNET_NO.

Referenced by create_handle(), and create_service().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ clear_contact_store()

void clear_contact_store ( struct GNUNET_MESSENGER_ContactStore * store )

Clears a contact store, wipes its content and deallocates its memory.

Parameters

[in,out] store Contact store

Definition at line 56 of file messenger_api_contact_store.c.

{
  GNUNET_assert ((store) && (store->contacts));
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Clear contact store\n");
 
  GNUNET_CONTAINER_multihashmap_iterate (store->anonymous,
                                         iterate_destroy_contacts, NULL);
  GNUNET_CONTAINER_multihashmap_iterate (store->contacts,
                                         iterate_destroy_contacts, NULL);
 
  GNUNET_CONTAINER_multihashmap_destroy (store->anonymous);
  GNUNET_CONTAINER_multihashmap_destroy (store->contacts);
}

References GNUNET_MESSENGER_ContactStore::anonymous, GNUNET_MESSENGER_ContactStore::contacts, GNUNET_assert, GNUNET_CONTAINER_multihashmap_destroy(), GNUNET_CONTAINER_multihashmap_iterate(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_log, and iterate_destroy_contacts().

Referenced by destroy_handle(), and destroy_service().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ get_store_contact_raw()

struct GNUNET_MESSENGER_Contact * get_store_contact_raw	(	struct GNUNET_MESSENGER_ContactStore *	store,
		const struct GNUNET_HashCode *	context,
		const struct GNUNET_HashCode *	key_hash
	)

Returns a contact using the hash of a specific public key.

In case the anonymous key gets used by the requested contact, it will use its provided member context to select the matching contact from the store.

In case there is no contact stored which uses the given key or context, NULL gets returned.

Parameters

[in,out]	store	Contact store
[in]	context	Member context
[in]	key_hash	Hash of public key

Definition at line 94 of file messenger_api_contact_store.c.

{
  GNUNET_assert ((store) && (store->contacts) && (context) && (key_hash));
 
  struct GNUNET_HashCode hash;
  GNUNET_memcpy (&hash, key_hash, sizeof(*key_hash));
 
  struct GNUNET_CONTAINER_MultiHashMap *map = select_store_contact_map (
    store, context, &hash
    );
 
  return GNUNET_CONTAINER_multihashmap_get (map, &hash);
}

References GNUNET_MESSENGER_ContactStore::contacts, context, GNUNET_assert, GNUNET_CONTAINER_multihashmap_get(), GNUNET_memcpy, map, and select_store_contact_map().

Referenced by process_message_control(), and task_message_control().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ get_store_contact()

struct GNUNET_MESSENGER_Contact * get_store_contact	(	struct GNUNET_MESSENGER_ContactStore *	store,
		const struct GNUNET_HashCode *	context,
		const struct GNUNET_CRYPTO_PublicKey *	pubkey
	)

Returns a contact using a specific public key.

In case the anonymous key gets used by the requested contact, it will use its provided member context to select the matching contact from the store.

In case there is no contact stored which uses the given key or context, a new contact will be created automatically.

The function returns NULL if an error occurs during allocation or validation of the contacts key.

Parameters

[in,out]	store	Contact store
[in]	context	Member context
[in]	pubkey	Public key

Definition at line 112 of file messenger_api_contact_store.c.

{
  GNUNET_assert ((store) && (store->contacts) && (pubkey));
 
  struct GNUNET_HashCode hash;
  GNUNET_CRYPTO_hash (pubkey, sizeof(*pubkey), &hash);
 
  struct GNUNET_CONTAINER_MultiHashMap *map = select_store_contact_map (
    store, context, &hash);
 
  struct GNUNET_MESSENGER_Contact *contact = GNUNET_CONTAINER_multihashmap_get (
    map, &hash);
 
  if (contact)
  {
    if (0 != GNUNET_memcmp (pubkey, get_contact_key (contact)))
    {
      char *str = GNUNET_CRYPTO_public_key_to_string (get_contact_key (
                                                        contact));
      GNUNET_log (GNUNET_ERROR_TYPE_INVALID,
                  "Contact in store uses wrong key: %s\n", str);
      GNUNET_free (str);
      return NULL;
    }
 
    return contact;
  }
 
  contact = create_contact (pubkey, ++(store->counter));
 
  if (GNUNET_OK == GNUNET_CONTAINER_multihashmap_put (map, &hash, contact,
                                                      GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST))
    return contact;
 
  destroy_contact (contact);
  return NULL;
}

References GNUNET_MESSENGER_ContactStore::contacts, context, GNUNET_MESSENGER_ContactStore::counter, create_contact(), destroy_contact(), get_contact_key(), GNUNET_assert, GNUNET_CONTAINER_multihashmap_get(), GNUNET_CONTAINER_multihashmap_put(), GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST, GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_public_key_to_string(), GNUNET_ERROR_TYPE_INVALID, GNUNET_free, GNUNET_log, GNUNET_memcmp, GNUNET_OK, map, pubkey, and select_store_contact_map().

Referenced by create_member_session(), get_handle_contact(), handle_join_message(), handle_transcript_message(), and reset_member_session().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ update_store_contact()

void update_store_contact	(	struct GNUNET_MESSENGER_ContactStore *	store,
		struct GNUNET_MESSENGER_Contact *	contact,
		const struct GNUNET_HashCode *	context,
		const struct GNUNET_HashCode *	next_context,
		const struct GNUNET_CRYPTO_PublicKey *	pubkey
	)

Moves a contact from the store to another location matching a given public key and member context.

This function allows changes of keys or changes of member contexts!

Parameters

[in,out]	store	Contact store
[in,out]	contact	Contact
[in]	context	Member context
[in]	next_context	Member context
[in]	pubkey	Public key

Definition at line 154 of file messenger_api_contact_store.c.

{
  GNUNET_assert ((store) && (store->contacts) && (contact) && (pubkey));
 
  const struct GNUNET_CRYPTO_PublicKey *oldkey = get_contact_key (contact);
 
  struct GNUNET_HashCode hash;
  GNUNET_CRYPTO_hash (oldkey, sizeof(*oldkey), &hash);
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Update contact store entry: %s\n",
              GNUNET_h2s (&hash));
 
  struct GNUNET_CONTAINER_MultiHashMap *map = select_store_contact_map (
    store, context, &hash
    );
 
  if (GNUNET_YES == GNUNET_CONTAINER_multihashmap_remove (map, &hash, contact))
  {
    GNUNET_memcpy (&(contact->public_key), pubkey, sizeof(*pubkey));
 
    GNUNET_CRYPTO_hash (pubkey, sizeof(*pubkey), &hash);
 
    map = select_store_contact_map (
      store, next_context, &hash
      );
 
    if (GNUNET_OK != GNUNET_CONTAINER_multihashmap_put (map, &hash, contact,
                                                        GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST))
      GNUNET_log (GNUNET_ERROR_TYPE_WARNING, "Updating a contact failed: %s\n",
                  GNUNET_h2s (&hash));
  }
}

References GNUNET_MESSENGER_ContactStore::contacts, context, get_contact_key(), GNUNET_assert, GNUNET_CONTAINER_multihashmap_put(), GNUNET_CONTAINER_multihashmap_remove(), GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST, GNUNET_CRYPTO_hash(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_ERROR_TYPE_WARNING, GNUNET_h2s(), GNUNET_log, GNUNET_memcpy, GNUNET_OK, GNUNET_YES, map, pubkey, GNUNET_MESSENGER_Contact::public_key, and select_store_contact_map().

Referenced by handle_id_message(), handle_key_message(), and switch_member_session().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ remove_store_contact()

void remove_store_contact	(	struct GNUNET_MESSENGER_ContactStore *	store,
		struct GNUNET_MESSENGER_Contact *	contact,
		const struct GNUNET_HashCode *	context
	)

Removes a contact from the store which uses a given member context.

Parameters

[in,out]	store	Contact store
[in,out]	contact	Contact
[in]	context	Member context

Definition at line 193 of file messenger_api_contact_store.c.

{
  GNUNET_assert ((store) && (store->contacts) && (contact));
 
  const struct GNUNET_CRYPTO_PublicKey *pubkey = get_contact_key (contact);
 
  struct GNUNET_HashCode hash;
  GNUNET_CRYPTO_hash (pubkey, sizeof(*pubkey), &hash);
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Remove contact store entry: %s\n",
              GNUNET_h2s (&hash));
 
  struct GNUNET_CONTAINER_MultiHashMap *map = select_store_contact_map (
    store, context, &hash
    );
 
  if (GNUNET_YES != GNUNET_CONTAINER_multihashmap_remove (map, &hash, contact))
    GNUNET_log (GNUNET_ERROR_TYPE_WARNING, "Removing a contact failed: %s\n",
                GNUNET_h2s (&hash));
 
  destroy_contact (contact);
}

References GNUNET_MESSENGER_ContactStore::contacts, context, destroy_contact(), get_contact_key(), GNUNET_assert, GNUNET_CONTAINER_multihashmap_remove(), GNUNET_CRYPTO_hash(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_ERROR_TYPE_WARNING, GNUNET_h2s(), GNUNET_log, GNUNET_YES, map, pubkey, and select_store_contact_map().

Referenced by check_member_session_completion(), and destroy_member_session().

Here is the call graph for this function:

Here is the caller graph for this function:

Data Structures

Functions

Function Documentation

◆ init_contact_store()

◆ clear_contact_store()

◆ get_store_contact_raw()

◆ get_store_contact()

◆ update_store_contact()

◆ remove_store_contact()