GNUnet  0.19.3
Functions
messenger_api_contact_store.c File Reference

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

#include "platform.h"
#include "messenger_api_contact_store.h"
#include "messenger_api_contact.h"
#include "messenger_api_util.h"
Include dependency graph for messenger_api_contact_store.c:

Go to the source code of this file.

Functions

void init_contact_store (struct GNUNET_MESSENGER_ContactStore *store)
 Initializes a contact store as fully empty. More...
 
static int iterate_destroy_contacts (void *cls, const struct GNUNET_HashCode *key, void *value)
 
void clear_contact_store (struct GNUNET_MESSENGER_ContactStore *store)
 Clears a contact store, wipes its content and deallocates its memory. More...
 
static struct GNUNET_CONTAINER_MultiHashMap * select_store_contact_map (struct GNUNET_MESSENGER_ContactStore *store, const struct GNUNET_HashCode *context, struct GNUNET_HashCode *hash)
 
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_IDENTITY_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_IDENTITY_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...
 

Detailed Description

messenger api: client implementation of GNUnet MESSENGER service

Author
Tobias Frisch

Definition in file messenger_api_contact_store.c.

Function Documentation

◆ init_contact_store()

void init_contact_store ( struct GNUNET_MESSENGER_ContactStore *  store)

Initializes a contact store as fully empty.

Parameters
[out]storeContact store

Definition at line 33 of file messenger_api_contact_store.c.

34 {
35  GNUNET_assert (store);
36 
37  store->anonymous = GNUNET_CONTAINER_multihashmap_create (8, GNUNET_NO);
38  store->contacts = GNUNET_CONTAINER_multihashmap_create (8, GNUNET_NO);
39 }
GNUNET_CONTAINER_multihashmap_create
struct GNUNET_CONTAINER_MultiHashMap * GNUNET_CONTAINER_multihashmap_create(unsigned int len, int do_not_copy_keys)
Create a multi hash map.
Definition: container_multihashmap.c:180
GNUNET_NO
@ GNUNET_NO
Definition: gnunet_common.h:108
GNUNET_assert
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
Definition: gnunet_common.h:943
GNUNET_MESSENGER_ContactStore::contacts
struct GNUNET_CONTAINER_MultiHashMap * contacts
Definition: messenger_api_contact_store.h:38
GNUNET_MESSENGER_ContactStore::anonymous
struct GNUNET_CONTAINER_MultiHashMap * anonymous
Definition: messenger_api_contact_store.h:37

References GNUNET_MESSENGER_ContactStore::anonymous, GNUNET_MESSENGER_ContactStore::contacts, 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:

◆ iterate_destroy_contacts()

static int iterate_destroy_contacts ( void *  cls,
const struct GNUNET_HashCode *  key,
void *  value 
)
static

Definition at line 42 of file messenger_api_contact_store.c.

45 {
46  struct GNUNET_MESSENGER_Contact *contact = value;
47  destroy_contact (contact);
48  return GNUNET_YES;
49 }
value
static char * value
Value of the record to add/remove.
Definition: gnunet-namestore.c:265
GNUNET_YES
@ GNUNET_YES
Definition: gnunet_common.h:111
destroy_contact
void destroy_contact(struct GNUNET_MESSENGER_Contact *contact)
Destroys a contact and frees its memory fully.
Definition: messenger_api_contact.c:45
GNUNET_MESSENGER_Contact
Definition: messenger_api_contact.h:34

References destroy_contact(), GNUNET_YES, and value.

Referenced by clear_contact_store().

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]storeContact store

Definition at line 52 of file messenger_api_contact_store.c.

53 {
54  GNUNET_assert ((store) && (store->contacts));
55 
56  GNUNET_CONTAINER_multihashmap_iterate (store->anonymous, iterate_destroy_contacts, NULL);
57  GNUNET_CONTAINER_multihashmap_iterate (store->contacts, iterate_destroy_contacts, NULL);
58 
59  GNUNET_CONTAINER_multihashmap_destroy (store->anonymous);
60  GNUNET_CONTAINER_multihashmap_destroy (store->contacts);
61 }
GNUNET_CONTAINER_multihashmap_iterate
int GNUNET_CONTAINER_multihashmap_iterate(struct GNUNET_CONTAINER_MultiHashMap *map, GNUNET_CONTAINER_MultiHashMapIteratorCallback it, void *it_cls)
Iterate over all entries in the map.
Definition: container_multihashmap.c:309
GNUNET_CONTAINER_multihashmap_destroy
void GNUNET_CONTAINER_multihashmap_destroy(struct GNUNET_CONTAINER_MultiHashMap *map)
Destroy a hash map.
Definition: container_multihashmap.c:215
iterate_destroy_contacts
static int iterate_destroy_contacts(void *cls, const struct GNUNET_HashCode *key, void *value)
Definition: messenger_api_contact_store.c:42

References GNUNET_MESSENGER_ContactStore::anonymous, GNUNET_MESSENGER_ContactStore::contacts, GNUNET_assert, GNUNET_CONTAINER_multihashmap_destroy(), GNUNET_CONTAINER_multihashmap_iterate(), 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:

◆ select_store_contact_map()

static struct GNUNET_CONTAINER_MultiHashMap* select_store_contact_map ( struct GNUNET_MESSENGER_ContactStore *  store,
const struct GNUNET_HashCode *  context,
struct GNUNET_HashCode *  hash 
)
static

Definition at line 64 of file messenger_api_contact_store.c.

67 {
68  const struct GNUNET_IDENTITY_PublicKey *anonymous = get_anonymous_public_key ();
69 
70  struct GNUNET_HashCode anonHash;
71  GNUNET_CRYPTO_hash (anonymous, sizeof(*anonymous), &anonHash);
72 
73  if ((context) && (0 == GNUNET_CRYPTO_hash_cmp(hash, &anonHash)))
74  {
75  GNUNET_memcpy(hash, context, sizeof(*context));
76  return store->anonymous;
77  }
78  else
79  return store->contacts;
80 }
context
static pa_context * context
Pulseaudio context.
Definition: gnunet-helper-audio-playback.c:81
GNUNET_CRYPTO_hash
void GNUNET_CRYPTO_hash(const void *block, size_t size, struct GNUNET_HashCode *ret)
Compute hash of a given block.
Definition: crypto_hash.c:41
GNUNET_CRYPTO_hash_cmp
int GNUNET_CRYPTO_hash_cmp(const struct GNUNET_HashCode *h1, const struct GNUNET_HashCode *h2)
Compare function for HashCodes, producing a total ordering of all hashcodes.
Definition: crypto_hash.c:220
GNUNET_memcpy
#define GNUNET_memcpy(dst, src, n)
Call memcpy() but check for n being 0 first.
Definition: gnunet_common.h:1294
get_anonymous_public_key
const struct GNUNET_IDENTITY_PublicKey * get_anonymous_public_key()
Returns the public identity key of GNUNET_IDENTITY_ego_get_anonymous() without recalculating it every...
Definition: messenger_api_util.c:74
GNUNET_HashCode
A 512-bit hashcode.
Definition: gnunet_common.h:284
GNUNET_IDENTITY_PublicKey
An identity key as per LSD0001.
Definition: gnunet_identity_service.h:122

References GNUNET_MESSENGER_ContactStore::anonymous, GNUNET_MESSENGER_ContactStore::contacts, context, get_anonymous_public_key(), GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_hash_cmp(), and GNUNET_memcpy.

Referenced by get_store_contact(), get_store_contact_raw(), remove_store_contact(), and update_store_contact().

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]storeContact store
[in]contextMember context
[in]key_hashHash of public key

Definition at line 83 of file messenger_api_contact_store.c.

86 {
87  GNUNET_assert ((store) && (store->contacts) && (context) && (key_hash));
88 
89  struct GNUNET_HashCode hash;
90  GNUNET_memcpy(&hash, key_hash, sizeof(*key_hash));
91 
92  struct GNUNET_CONTAINER_MultiHashMap *map = select_store_contact_map (
93  store, context, &hash
94  );
95 
96  return GNUNET_CONTAINER_multihashmap_get (map, &hash);
97 }
map
static struct GNUNET_CONTAINER_MultiPeerMap * map
Handle to the map used to store old latency values for peers.
Definition: gnunet-daemon-latency-logger.c:82
GNUNET_CONTAINER_multihashmap_get
void * GNUNET_CONTAINER_multihashmap_get(const struct GNUNET_CONTAINER_MultiHashMap *map, const struct GNUNET_HashCode *key)
Given a key find a value in the map matching the key.
Definition: container_multihashmap.c:281
select_store_contact_map
static struct GNUNET_CONTAINER_MultiHashMap * select_store_contact_map(struct GNUNET_MESSENGER_ContactStore *store, const struct GNUNET_HashCode *context, struct GNUNET_HashCode *hash)
Definition: messenger_api_contact_store.c:64
GNUNET_CONTAINER_MultiHashMap
Internal representation of the hash map.
Definition: container_multihashmap.c:107

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

Referenced by handle_recv_message().

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_IDENTITY_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]storeContact store
[in]contextMember context
[in]pubkeyPublic key of EGO

Definition at line 100 of file messenger_api_contact_store.c.

103 {
104  GNUNET_assert ((store) && (store->contacts) && (context) && (pubkey));
105 
106  struct GNUNET_HashCode hash;
107  GNUNET_CRYPTO_hash (pubkey, sizeof(*pubkey), &hash);
108 
109  struct GNUNET_CONTAINER_MultiHashMap *map = select_store_contact_map (
110  store, context, &hash
111  );
112 
113  struct GNUNET_MESSENGER_Contact *contact = GNUNET_CONTAINER_multihashmap_get (map, &hash);
114 
115  if (contact)
116  {
117  if (0 != GNUNET_memcmp(pubkey, get_contact_key(contact)))
118  {
119  char* str = GNUNET_IDENTITY_public_key_to_string (get_contact_key(contact));
120  GNUNET_log (GNUNET_ERROR_TYPE_INVALID, "Contact in store uses wrong key: %s\n", str);
121  GNUNET_free (str);
122  return NULL;
123  }
124 
125  return contact;
126  }
127 
128  contact = create_contact (pubkey);
129 
130  if (GNUNET_OK == GNUNET_CONTAINER_multihashmap_put (map, &hash, contact,
131  GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST))
132  return contact;
133 
134  destroy_contact (contact);
135  return NULL;
136 }
pubkey
static struct GNUNET_IDENTITY_PublicKey pubkey
Public key of the zone to look in.
Definition: gnunet-namecache.c:53
GNUNET_CONTAINER_multihashmap_put
enum GNUNET_GenericReturnValue GNUNET_CONTAINER_multihashmap_put(struct GNUNET_CONTAINER_MultiHashMap *map, const struct GNUNET_HashCode *key, void *value, enum GNUNET_CONTAINER_MultiHashMapOption opt)
Store a key-value pair in the map.
Definition: container_multihashmap.c:710
GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST
@ GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST
, ' bother checking if a value already exists (faster than GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE...
Definition: gnunet_container_lib.h:388
GNUNET_IDENTITY_public_key_to_string
char * GNUNET_IDENTITY_public_key_to_string(const struct GNUNET_IDENTITY_PublicKey *key)
Creates a (Base32) string representation of the public key.
Definition: identity_api.c:1213
GNUNET_log
#define GNUNET_log(kind,...)
Definition: gnunet_common.h:568
GNUNET_memcmp
#define GNUNET_memcmp(a, b)
Compare memory in a and b, where both must be of the same pointer type.
Definition: gnunet_common.h:1224
GNUNET_OK
@ GNUNET_OK
Definition: gnunet_common.h:109
GNUNET_ERROR_TYPE_INVALID
@ GNUNET_ERROR_TYPE_INVALID
Definition: gnunet_common.h:445
GNUNET_free
#define GNUNET_free(ptr)
Wrapper around free.
Definition: gnunet_common.h:1412
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.
Definition: messenger_api_contact.c:30
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.
Definition: messenger_api_contact.c:76

References GNUNET_MESSENGER_ContactStore::contacts, context, 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_ERROR_TYPE_INVALID, GNUNET_free, GNUNET_IDENTITY_public_key_to_string(), GNUNET_log, GNUNET_memcmp, GNUNET_OK, map, pubkey, and select_store_contact_map().

Referenced by create_member_session(), get_handle_contact(), handle_join_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_IDENTITY_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]storeContact store
[in,out]contactContact
[in]contextMember context
[in]next_contextMember context
[in]pubkeyPublic key of EGO

Definition at line 139 of file messenger_api_contact_store.c.

144 {
145  GNUNET_assert ((store) && (store->contacts) && (contact) && (pubkey));
146 
147  const struct GNUNET_IDENTITY_PublicKey* oldkey = get_contact_key (contact);
148 
149  struct GNUNET_HashCode hash;
150  GNUNET_CRYPTO_hash (oldkey, sizeof(*oldkey), &hash);
151 
152  struct GNUNET_CONTAINER_MultiHashMap *map = select_store_contact_map (
153  store, context, &hash
154  );
155 
156  if (GNUNET_YES == GNUNET_CONTAINER_multihashmap_remove (map, &hash, contact))
157  {
158  GNUNET_memcpy(&(contact->public_key), pubkey, sizeof(*pubkey));
159 
160  GNUNET_CRYPTO_hash (pubkey, sizeof(*pubkey), &hash);
161 
162  map = select_store_contact_map (
163  store, next_context, &hash
164  );
165 
166  if (GNUNET_OK != GNUNET_CONTAINER_multihashmap_put (map, &hash, contact,
167  GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST))
168  GNUNET_log(GNUNET_ERROR_TYPE_WARNING, "Updating a contact failed: %s\n",
169  GNUNET_h2s(&hash));
170  }
171 }
GNUNET_CONTAINER_multihashmap_remove
enum GNUNET_GenericReturnValue GNUNET_CONTAINER_multihashmap_remove(struct GNUNET_CONTAINER_MultiHashMap *map, const struct GNUNET_HashCode *key, const void *value)
Remove the given key-value pair from the map.
Definition: container_multihashmap.c:406
GNUNET_h2s
const char * GNUNET_h2s(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
Definition: common_logging.c:1125
GNUNET_ERROR_TYPE_WARNING
@ GNUNET_ERROR_TYPE_WARNING
Definition: gnunet_common.h:438
GNUNET_MESSENGER_Contact::public_key
struct GNUNET_IDENTITY_PublicKey public_key
Definition: messenger_api_contact.h:38

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_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]storeContact store
[in,out]contactContact
[in]contextMember context

Definition at line 174 of file messenger_api_contact_store.c.

177 {
178  GNUNET_assert ((store) && (store->contacts) && (contact));
179 
180  const struct GNUNET_IDENTITY_PublicKey* pubkey = get_contact_key(contact);
181 
182  struct GNUNET_HashCode hash;
183  GNUNET_CRYPTO_hash (pubkey, sizeof(*pubkey), &hash);
184 
185  struct GNUNET_CONTAINER_MultiHashMap *map = select_store_contact_map (
186  store, context, &hash
187  );
188 
189  if (GNUNET_YES != GNUNET_CONTAINER_multihashmap_remove (map, &hash, contact))
190  GNUNET_log(GNUNET_ERROR_TYPE_WARNING, "Removing a contact failed: %s\n",
191  GNUNET_h2s(&hash));
192 
193  destroy_contact (contact);
194 }

References GNUNET_MESSENGER_ContactStore::contacts, context, destroy_contact(), get_contact_key(), GNUNET_assert, GNUNET_CONTAINER_multihashmap_remove(), GNUNET_CRYPTO_hash(), 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: