GNUnet  0.11.x
Functions
messenger_api_util.h File Reference

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

#include "platform.h"
#include "gnunet_cadet_service.h"
#include "gnunet_container_lib.h"
#include "gnunet_crypto_lib.h"
#include "gnunet_disk_lib.h"
#include "gnunet_identity_service.h"
#include "gnunet_messenger_service.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...
 
int 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_IDENTITY_PublicKeyget_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...
 

Detailed Description

messenger api: client implementation of GNUnet MESSENGER service

Author
Tobias Frisch

Definition in file messenger_api_util.h.

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 38 of file messenger_api_util.c.

39 {
40  GNUNET_assert(channel);
41 
44  callback_close_channel, channel);
45 }
@ GNUNET_SCHEDULER_PRIORITY_URGENT
Run with priority for urgent tasks.
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_delayed_with_priority(struct GNUNET_TIME_Relative delay, enum GNUNET_SCHEDULER_Priority priority, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay.
Definition: scheduler.c:1199
struct GNUNET_TIME_Relative GNUNET_TIME_relative_get_zero_(void)
Return relative time of 0ms.
Definition: time.c:100
static void callback_close_channel(void *cls)

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()

int 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]idNew member id
[in]membersMap of member ids
Returns
GNUNET_YES on success, GNUNET_NO on failure

Definition at line 48 of file messenger_api_util.c.

50 {
51  GNUNET_assert(id);
52 
53  size_t counter = 1 + (members ? GNUNET_CONTAINER_multishortmap_size (members) : 0);
54 
55  do
56  {
58 
59  if ((members) && (GNUNET_YES == GNUNET_CONTAINER_multishortmap_contains (members, id)))
60  counter--;
61  else
62  break;
63  }
64  while (counter > 0);
65 
66  if (counter)
67  return GNUNET_YES;
68 
69  return GNUNET_NO;
70 }
@ GNUNET_YES
Definition: gnunet_common.h:97
@ GNUNET_NO
Definition: gnunet_common.h:94
void GNUNET_CRYPTO_random_block(enum GNUNET_CRYPTO_Quality mode, void *buffer, size_t length)
Fill block with a random values.
@ GNUNET_CRYPTO_QUALITY_STRONG
High-quality operations are desired.
unsigned int GNUNET_CONTAINER_multishortmap_size(const struct GNUNET_CONTAINER_MultiShortmap *map)
Get the number of key-value pairs in the map.
int GNUNET_CONTAINER_multishortmap_contains(const struct GNUNET_CONTAINER_MultiShortmap *map, const struct GNUNET_ShortHashCode *key)
Check if the map contains any value under the given key (including values that are NULL).
A 256-bit hashcode.

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_room_member_collisions().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ 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 time.

Returns
anonymous public key

Definition at line 73 of file messenger_api_util.c.

74 {
75  static struct GNUNET_IDENTITY_PublicKey public_key;
76  static struct GNUNET_IDENTITY_Ego* ego = NULL;
77 
78  if (!ego)
79  {
81  GNUNET_IDENTITY_ego_get_public_key(ego, &public_key);
82  }
83 
84  return &public_key;
85 }
void GNUNET_IDENTITY_ego_get_public_key(struct GNUNET_IDENTITY_Ego *ego, struct GNUNET_IDENTITY_PublicKey *pk)
Get the identifier (public key) of an ego.
Definition: identity_api.c:652
struct GNUNET_IDENTITY_Ego * GNUNET_IDENTITY_ego_get_anonymous()
Obtain the ego representing 'anonymous' users.
Definition: identity_api.c:156
Handle for an ego.
Definition: identity.h:37
An identity key as per LSD0001.

References GNUNET_IDENTITY_ego_get_anonymous(), and GNUNET_IDENTITY_ego_get_public_key().

Referenced by get_handle_key(), get_non_anonymous_key(), 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]keyMessenger service room key
[out]portCADET service port

Definition at line 88 of file messenger_api_util.c.

90 {
91  static uint32_t version_value = 0;
92  static struct GNUNET_HashCode version;
93 
94  if (!version_value) {
95  version_value = (uint32_t) (GNUNET_MESSENGER_VERSION);
96  version_value = ((version_value >> 16) & 0xFFFF);
97  version_value = GNUNET_htole32(version_value);
98  GNUNET_CRYPTO_hash(&version_value, sizeof(version_value), &version);
99  }
100 
101  GNUNET_CRYPTO_hash_sum(key, &version, port);
102 }
static uint16_t port
Port number.
Definition: gnunet-bcd.c:83
struct GNUNET_HashCode key
The key used in the DHT.
#define GNUNET_htole32(x)
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
void GNUNET_CRYPTO_hash_sum(const struct GNUNET_HashCode *a, const struct GNUNET_HashCode *delta, struct GNUNET_HashCode *result)
compute result = a + delta
Definition: crypto_hash.c:122
#define GNUNET_MESSENGER_VERSION
Version number of GNUnet Messenger API.
A 512-bit hashcode.

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

Referenced by connect_tunnel(), and open_room().

Here is the call graph for this function:
Here is the caller graph for this function: