GNUnet  0.20.0
messenger_api_util.c File Reference

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

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

Go to the source code of this file.

Functions

static void callback_close_channel (void *cls)
 
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.c.

Function Documentation

◆ callback_close_channel()

static void callback_close_channel ( void *  cls)
static

Definition at line 30 of file messenger_api_util.c.

31 {
32  struct GNUNET_CADET_Channel *channel = cls;
33 
34  if (channel)
36 }
void GNUNET_CADET_channel_destroy(struct GNUNET_CADET_Channel *channel)
Destroy an existing channel.
Definition: cadet_api.c:830
Opaque handle to a channel.
Definition: cadet.h:116

References GNUNET_CADET_channel_destroy().

Referenced by delayed_disconnect_channel().

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

◆ 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]channelChannel

Definition at line 39 of file messenger_api_util.c.

40 {
41  GNUNET_assert(channel);
42 
45  callback_close_channel, channel);
46 }
@ 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:1202
struct GNUNET_TIME_Relative GNUNET_TIME_relative_get_zero_(void)
Return relative time of 0ms.
Definition: time.c:133
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 49 of file messenger_api_util.c.

51 {
52  GNUNET_assert(id);
53 
54  size_t counter = 1 + (members ? GNUNET_CONTAINER_multishortmap_size (members) : 0);
55 
56  do
57  {
59 
60  if ((members) && (GNUNET_YES == GNUNET_CONTAINER_multishortmap_contains (members, id)))
61  counter--;
62  else
63  break;
64  }
65  while (counter > 0);
66 
67  if (counter)
68  return GNUNET_YES;
69 
70  return GNUNET_NO;
71 }
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).
@ GNUNET_YES
@ GNUNET_NO
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_srv_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 74 of file messenger_api_util.c.

75 {
76  static struct GNUNET_IDENTITY_PublicKey public_key;
77  static struct GNUNET_IDENTITY_Ego* ego = NULL;
78 
79  if (!ego)
80  {
82  GNUNET_IDENTITY_ego_get_public_key(ego, &public_key);
83  }
84 
85  return &public_key;
86 }
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:573
struct GNUNET_IDENTITY_Ego * GNUNET_IDENTITY_ego_get_anonymous()
Obtain the ego representing 'anonymous' users.
Definition: identity_api.c:157
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 89 of file messenger_api_util.c.

91 {
92  static uint32_t version_value = 0;
93  static struct GNUNET_HashCode version;
94 
95  if (!version_value) {
96  version_value = (uint32_t) (GNUNET_MESSENGER_VERSION);
97  version_value = ((version_value >> 16) & 0xFFFF);
98  version_value = GNUNET_htole32(version_value);
99  GNUNET_CRYPTO_hash(&version_value, sizeof(version_value), &version);
100  }
101 
102  GNUNET_CRYPTO_hash_sum(key, &version, port);
103 }
static uint16_t port
Port number.
Definition: gnunet-bcd.c:147
struct GNUNET_HashCode key
The key used in the DHT.
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:123
#define GNUNET_htole32(x)
#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_srv_room().

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