Hello_Uri library

Helper library for handling HELLO URIs. More...

Collaboration diagram for Hello_Uri library:

Macros
#define	GNUNET_HELLO_ADDRESS_EXPIRATION
	For how long are HELLO signatures valid? More...

Typedefs
typedef void(*	GNUNET_HELLO_UriCallback) (void *cls, const struct GNUNET_PeerIdentity *pid, const char *uri)
	Callback function used to extract URIs from a builder. More...

Functions
struct GNUNET_HELLO_Builder *	GNUNET_HELLO_builder_new (const struct GNUNET_PeerIdentity *pid)
	Allocate builder. More...
const struct GNUNET_PeerIdentity *	GNUNET_HELLO_builder_get_id (const struct GNUNET_HELLO_Builder *builder)
	Get the PeerIdentity for this builder. More...
void	GNUNET_HELLO_builder_free (struct GNUNET_HELLO_Builder *builder)
	Release resources of a builder. More...
struct GNUNET_HELLO_Builder *	GNUNET_HELLO_builder_from_msg (const struct GNUNET_MessageHeader *msg)
	Parse msg into builder. More...
struct GNUNET_HELLO_Builder *	GNUNET_HELLO_builder_from_block (const void *block, size_t block_size)
	Parse block into builder. More...
struct GNUNET_HELLO_Builder *	GNUNET_HELLO_builder_from_url (const char *url)
	Parse GNUnet HELLO url into builder. More...
struct GNUNET_TIME_Absolute	GNUNET_HELLO_builder_get_expiration_time (const struct GNUNET_MessageHeader *msg)
	Get the expiration time for this HELLO. More...
struct GNUNET_MQ_Envelope *	GNUNET_HELLO_builder_to_env (const struct GNUNET_HELLO_Builder *builder, const struct GNUNET_CRYPTO_EddsaPrivateKey *priv, struct GNUNET_TIME_Relative expiration_time)
	Generate envelope with GNUnet HELLO message (including peer ID) from a builder. More...
struct GNUNET_MessageHeader *	GNUNET_HELLO_builder_to_dht_hello_msg (const struct GNUNET_HELLO_Builder *builder, const struct GNUNET_CRYPTO_EddsaPrivateKey *priv, struct GNUNET_TIME_Relative expiration_time)
	Generate DHT HELLO message (without peer ID) from a builder. More...
char *	GNUNET_HELLO_builder_to_url (const struct GNUNET_HELLO_Builder *builder, const struct GNUNET_CRYPTO_EddsaPrivateKey *priv)
	Generate GNUnet HELLO URI from a builder. More...
enum GNUNET_GenericReturnValue	GNUNET_HELLO_builder_to_block (const struct GNUNET_HELLO_Builder *builder, const struct GNUNET_CRYPTO_EddsaPrivateKey *priv, void *block, size_t *block_size, struct GNUNET_TIME_Relative expiration_time)
	Generate DHT block from a builder. More...
enum GNUNET_GenericReturnValue	GNUNET_HELLO_builder_add_address (struct GNUNET_HELLO_Builder *builder, const char *address)
	Add individual address to the builder. More...
enum GNUNET_GenericReturnValue	GNUNET_HELLO_builder_del_address (struct GNUNET_HELLO_Builder *builder, const char *address)
	Remove individual address from the builder. More...
const struct GNUNET_PeerIdentity *	GNUNET_HELLO_builder_iterate (const struct GNUNET_HELLO_Builder *builder, GNUNET_HELLO_UriCallback uc, void *uc_cls)
	Iterate over URIs in a builder. More...
enum GNUNET_GenericReturnValue	GNUNET_HELLO_dht_msg_to_block (const struct GNUNET_MessageHeader *hello, const struct GNUNET_PeerIdentity *pid, void **block, size_t *block_size, struct GNUNET_TIME_Absolute *block_expiration)
	Convert a DHT hello message to a HELLO block. More...
char *	GNUNET_HELLO_address_to_prefix (const char *address)
	Given an address as a string, extract the prefix that identifies the communicator offering transmissions to that address. More...
void	GNUNET_HELLO_sign_address (const char *address, enum GNUNET_NetworkType nt, struct GNUNET_TIME_Absolute mono_time, const struct GNUNET_CRYPTO_EddsaPrivateKey *private_key, void **result, size_t *result_size)
	Build address record by signing raw information with private key. More...

Detailed Description

Helper library for handling HELLO URIs.

Macro Definition Documentation

GNUNET_HELLO_ADDRESS_EXPIRATION

#define GNUNET_HELLO_ADDRESS_EXPIRATION

Value:

    GNUNET_TIME_relative_multiply ( \
    GNUNET_TIME_UNIT_DAYS, 2)

For how long are HELLO signatures valid?

Definition at line 58 of file gnunet_hello_uri_lib.h.

Typedef Documentation

GNUNET_HELLO_UriCallback

typedef void(* GNUNET_HELLO_UriCallback) (void *cls, const struct GNUNET_PeerIdentity *pid, const char *uri)

Callback function used to extract URIs from a builder.

Parameters

cls	closure
uri	one of the URIs

Definition at line 221 of file gnunet_hello_uri_lib.h.

Function Documentation

GNUNET_HELLO_builder_new()

struct GNUNET_HELLO_Builder * GNUNET_HELLO_builder_new

(

const struct GNUNET_PeerIdentity *

pid

)

Allocate builder.

Parameters

pid	peer the builder is for

Returns

new builder

Definition at line 355 of file hello-uri.c.

{
  struct GNUNET_HELLO_Builder *builder;
 
  builder = GNUNET_new (struct GNUNET_HELLO_Builder);
  builder->pid = *pid;
  return builder;
}

References builder, GNUNET_new, and pid.

Referenced by GCH_get_mine(), GNUNET_HELLO_builder_from_block(), GNUNET_HELLO_builder_from_url(), and run().

Here is the caller graph for this function:

GNUNET_HELLO_builder_get_id()

const struct GNUNET_PeerIdentity * GNUNET_HELLO_builder_get_id

(

const struct GNUNET_HELLO_Builder *

builder

)

Get the PeerIdentity for this builder.

Definition at line 366 of file hello-uri.c.

{
  return &builder->pid;
}

References builder.

Referenced by check_hello(), GNUNET_PEERSTORE_hello_add(), and hosts_directory_scan_callback().

Here is the caller graph for this function:

GNUNET_HELLO_builder_free()

void GNUNET_HELLO_builder_free

(

struct GNUNET_HELLO_Builder *

builder

)

Release resources of a builder.

Parameters

[in]

builder

to free

Definition at line 373 of file hello-uri.c.

{
  struct Address *a;
 
  while (NULL != (a = builder->a_head))
  {
    GNUNET_CONTAINER_DLL_remove (builder->a_head,
                                 builder->a_tail,
                                 a);
    builder->a_length--;
    GNUNET_free (a);
  }
  GNUNET_assert (0 == builder->a_length);
  GNUNET_free (builder);
}

References builder, GNUNET_assert, GNUNET_CONTAINER_DLL_remove, and GNUNET_free.

Referenced by block_plugin_dht_check_block(), block_plugin_dht_check_reply(), block_plugin_dht_get_key(), check_for_global_natted(), consider_for_advertising(), dht_get_id_handler(), do_shutdown(), GCH_get_mine(), GNUNET_HELLO_builder_from_block(), GNUNET_HELLO_builder_from_url(), GNUNET_HELLO_dht_msg_to_block(), GNUNET_PEERSTORE_hello_add(), got_hello(), handle_dht_local_hello_offer(), handle_hello(), handle_hello_for_client(), handle_hello_for_incoming(), hello_check(), hosts_directory_scan_callback(), peerinfo_cb(), run(), and shutdown_task().

Here is the caller graph for this function:

GNUNET_HELLO_builder_from_msg()

struct GNUNET_HELLO_Builder * GNUNET_HELLO_builder_from_msg

(

const struct GNUNET_MessageHeader *

msg

)

Parse msg into builder.

Parameters

msg	message to parse

Returns

builder, NULL on failure

Definition at line 391 of file hello-uri.c.

{
  const struct HelloUriMessage *h;
  uint16_t size = ntohs (msg->size);
 
  if (GNUNET_MESSAGE_TYPE_HELLO_URI != ntohs (msg->type))
  {
    GNUNET_break (0);
    return NULL;
  }
  if (sizeof (struct HelloUriMessage) > size)
  {
    GNUNET_break_op (0);
    return NULL;
  }
  h = (const struct HelloUriMessage *) msg;
  size -= sizeof (*h);
  return GNUNET_HELLO_builder_from_block (&h[1],
                                          size);
}

References GNUNET_break, GNUNET_break_op, GNUNET_HELLO_builder_from_block(), GNUNET_MESSAGE_TYPE_HELLO_URI, h, msg, GNUNET_MessageHeader::size, size, and GNUNET_MessageHeader::type.

Referenced by check_for_global_natted(), check_hello(), consider_for_advertising(), dht_get_id_handler(), GNUNET_PEERSTORE_hello_add(), got_hello(), handle_hello(), handle_hello_for_client(), handle_hello_for_incoming(), hosts_directory_scan_callback(), and peerinfo_cb().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_HELLO_builder_from_block()

struct GNUNET_HELLO_Builder * GNUNET_HELLO_builder_from_block	(	const void *	block,
		size_t	block_size
	)

Parse block into builder.

Parameters

block	DHT block to parse
block_size	number of bytes in block

Returns

builder, NULL on failure

Definition at line 414 of file hello-uri.c.

{
  const struct BlockHeader *bh = block;
  struct GNUNET_HELLO_Builder *b;
 
  if (block_size < sizeof (*bh))
  {
    GNUNET_break_op (0);
    return NULL;
  }
  b = GNUNET_HELLO_builder_new (&bh->pid);
  block += sizeof (*bh);
  block_size -= sizeof (*bh);
  while (block_size > 0)
  {
    const void *end = memchr (block,
                              '\0',
                              block_size);
 
    if (NULL == end)
    {
      GNUNET_break_op (0);
      GNUNET_HELLO_builder_free (b);
      return NULL;
    }
    if (GNUNET_OK !=
        GNUNET_HELLO_builder_add_address (b,
                                          block))
    {
      GNUNET_break_op (0);
      GNUNET_HELLO_builder_free (b);
      return NULL;
    }
    end++;
    block_size -= (end - block);
    block = end;
  }
  {
    enum GNUNET_GenericReturnValue ret;
 
    ret = verify_hello (b,
                        GNUNET_TIME_absolute_ntoh (bh->expiration_time),
                        &bh->sig);
    GNUNET_break (GNUNET_SYSERR != ret);
    if (GNUNET_OK != ret)
    {
      GNUNET_HELLO_builder_free (b);
      return NULL;
    }
  }
  return b;
}

References end, BlockHeader::expiration_time, GNUNET_break, GNUNET_break_op, GNUNET_HELLO_builder_add_address(), GNUNET_HELLO_builder_free(), GNUNET_HELLO_builder_new(), GNUNET_OK, GNUNET_SYSERR, GNUNET_TIME_absolute_ntoh(), BlockHeader::pid, ret, BlockHeader::sig, and verify_hello().

Referenced by block_plugin_dht_check_block(), block_plugin_dht_check_reply(), block_plugin_dht_get_key(), GNUNET_HELLO_builder_from_msg(), GNUNET_HELLO_dht_msg_to_block(), and hello_check().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_HELLO_builder_from_url()

struct GNUNET_HELLO_Builder * GNUNET_HELLO_builder_from_url

(

const char *

url

)

Parse GNUnet HELLO url into builder.

Parameters

url	URL to parse

Returns

builder, NULL on failure

Definition at line 493 of file hello-uri.c.

{
  const char *q;
  const char *s1;
  const char *s2;
  struct GNUNET_PeerIdentity pid;
  struct GNUNET_CRYPTO_EddsaSignature sig;
  struct GNUNET_TIME_Absolute et;
  size_t len;
  struct GNUNET_HELLO_Builder *b;
 
  if (0 != strncasecmp (url,
                        "gnunet://hello/",
                        strlen ("gnunet://hello/")))
    return NULL;
  url += strlen ("gnunet://hello/");
  s1 = strchr (url, '/');
  if (NULL == s1)
  {
    GNUNET_break_op (0);
    return NULL;
  }
  s2 = strchr (s1 + 1, '/');
  if (NULL == s1)
  {
    GNUNET_break_op (0);
    return NULL;
  }
  q = strchr (url, '?');
  if (NULL == q)
    q = url + strlen (url);
  if (GNUNET_OK !=
      GNUNET_STRINGS_string_to_data (url,
                                     s1 - url,
                                     &pid,
                                     sizeof(pid)))
  {
    GNUNET_break_op (0);
    return NULL;
  }
  if (GNUNET_OK !=
      GNUNET_STRINGS_string_to_data (s1 + 1,
                                     s2 - (s1 + 1),
                                     &sig,
                                     sizeof(sig)))
  {
    GNUNET_break_op (0);
    return NULL;
  }
  {
    unsigned long long sec;
    char dummy = '?';
 
    if ( (0 == sscanf (s2 + 1,
                       "%llu%c",
                       &sec,
                       &dummy)) ||
         ('?' != dummy) )
    {
      GNUNET_break_op (0);
      return NULL;
    }
    et = GNUNET_TIME_absolute_from_s (sec);
  }
 
  b = GNUNET_HELLO_builder_new (&pid);
  len = strlen (q);
  while (len > 0)
  {
    const char *eq;
    const char *amp;
    char *addr = NULL;
    char *uri;
 
    /* skip ?/& separator */
    len--;
    q++;
    eq = strchr (q, '=');
    if ( (eq == q) ||
         (NULL == eq) )
    {
      GNUNET_break_op (0);
      GNUNET_HELLO_builder_free (b);
      return NULL;
    }
    amp = strchr (eq, '&');
    if (NULL == amp)
      amp = &q[len];
    GNUNET_STRINGS_urldecode (eq + 1,
                              amp - (eq + 1),
                              &addr);
    if ( (NULL == addr) ||
         (0 == strlen (addr)) )
    {
      GNUNET_free (addr);
      GNUNET_break_op (0);
      GNUNET_HELLO_builder_free (b);
      return NULL;
    }
    GNUNET_asprintf (&uri,
                     "%.*s://%s",
                     (int) (eq - q),
                     q,
                     addr);
    GNUNET_free (addr);
    if (GNUNET_OK !=
        GNUNET_HELLO_builder_add_address (b,
                                          uri))
    {
      GNUNET_break_op (0);
      GNUNET_free (uri);
      GNUNET_HELLO_builder_free (b);
      return NULL;
    }
    GNUNET_free (uri);
    /* move to next URL */
    len -= (amp - q);
    q = amp;
  }
 
  {
    enum GNUNET_GenericReturnValue ret;
 
    ret = verify_hello (b,
                        et,
                        &sig);
    GNUNET_break (GNUNET_SYSERR != ret);
    if (GNUNET_OK != ret)
    {
      GNUNET_HELLO_builder_free (b);
      return NULL;
    }
  }
  return b;
}

References dummy, GNUNET_asprintf(), GNUNET_break, GNUNET_break_op, GNUNET_free, GNUNET_HELLO_builder_add_address(), GNUNET_HELLO_builder_free(), GNUNET_HELLO_builder_new(), GNUNET_OK, GNUNET_STRINGS_string_to_data(), GNUNET_STRINGS_urldecode(), GNUNET_SYSERR, GNUNET_TIME_absolute_from_s(), pid, q, ret, uri, and verify_hello().

Referenced by handle_dht_local_hello_offer().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_HELLO_builder_get_expiration_time()

struct GNUNET_TIME_Absolute GNUNET_HELLO_builder_get_expiration_time

(

const struct GNUNET_MessageHeader *

msg

)

Get the expiration time for this HELLO.

Parameters

msg	The hello msg.

Returns

The expiration time.

Definition at line 470 of file hello-uri.c.

{
  if (GNUNET_MESSAGE_TYPE_HELLO_URI == ntohs (msg->type))
  {
    const struct HelloUriMessage *h = (struct HelloUriMessage *) msg;
    const struct BlockHeader *bh = (const struct BlockHeader *) &h[1];
 
    return GNUNET_TIME_absolute_ntoh (bh->expiration_time);
  }
  else if (GNUNET_MESSAGE_TYPE_DHT_P2P_HELLO == ntohs (msg->type))
  {
    const struct DhtHelloMessage *dht_hello = (struct DhtHelloMessage *) msg;
 
    return GNUNET_TIME_absolute_ntoh (dht_hello->expiration_time);
  }
  else
    GNUNET_break (0);
  return GNUNET_TIME_UNIT_ZERO_ABS;
}

References BlockHeader::expiration_time, DhtHelloMessage::expiration_time, GNUNET_break, GNUNET_MESSAGE_TYPE_DHT_P2P_HELLO, GNUNET_MESSAGE_TYPE_HELLO_URI, GNUNET_TIME_absolute_ntoh(), GNUNET_TIME_UNIT_ZERO_ABS, h, msg, and GNUNET_MessageHeader::type.

Referenced by announce_id(), consider_for_advertising(), consider_peer_destroy(), GCP_set_hello(), GNUNET_PEERSTORE_hello_add(), got_hello(), and hello_add_iter().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_HELLO_builder_to_env()

struct GNUNET_MQ_Envelope * GNUNET_HELLO_builder_to_env	(	const struct GNUNET_HELLO_Builder *	builder,
		const struct GNUNET_CRYPTO_EddsaPrivateKey *	priv,
		struct GNUNET_TIME_Relative	expiration_time
	)

Generate envelope with GNUnet HELLO message (including peer ID) from a builder.

Parameters

builder	builder to serialize
priv	private key to use to sign the result

Returns

HELLO message matching builder

Definition at line 631 of file hello-uri.c.

{
  struct GNUNET_MQ_Envelope *env;
  struct HelloUriMessage *msg;
  size_t blen;
 
  if (builder->a_length > UINT16_MAX)
  {
    GNUNET_break (0);
    return NULL;
  }
  blen = 0;
  GNUNET_assert (GNUNET_NO ==
                 GNUNET_HELLO_builder_to_block (builder,
                                                priv,
                                                NULL,
                                                &blen,
                                                expiration_time));
  env = GNUNET_MQ_msg_extra (msg,
                             blen,
                             GNUNET_MESSAGE_TYPE_HELLO_URI);
  msg->url_counter = htons ((uint16_t) builder->a_length);
  GNUNET_assert (GNUNET_OK ==
                 GNUNET_HELLO_builder_to_block (builder,
                                                priv,
                                                &msg[1],
                                                &blen,
                                                expiration_time));
  return env;
}

References builder, env, GNUNET_assert, GNUNET_break, GNUNET_HELLO_builder_to_block(), GNUNET_MESSAGE_TYPE_HELLO_URI, GNUNET_MQ_msg_extra, GNUNET_NO, GNUNET_OK, and msg.

Referenced by run(), and store_pi().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_HELLO_builder_to_dht_hello_msg()

struct GNUNET_MessageHeader * GNUNET_HELLO_builder_to_dht_hello_msg	(	const struct GNUNET_HELLO_Builder *	builder,
		const struct GNUNET_CRYPTO_EddsaPrivateKey *	priv,
		struct GNUNET_TIME_Relative	expiration_time
	)

Generate DHT HELLO message (without peer ID) from a builder.

Parameters

builder	builder to serialize
priv	private key to use to sign the result

Returns

HELLO message matching builder

Definition at line 666 of file hello-uri.c.

{
  struct DhtHelloMessage *msg;
  size_t blen;
 
  if (builder->a_length > UINT16_MAX)
  {
    GNUNET_break (0);
    return NULL;
  }
  blen = 0;
  GNUNET_assert (GNUNET_NO ==
                 GNUNET_HELLO_builder_to_block (builder,
                                                priv,
                                                NULL,
                                                &blen,
                                                expiration_time));
  GNUNET_assert (blen < UINT16_MAX);
  GNUNET_assert (blen >= sizeof (struct BlockHeader));
  {
    char buf[blen] GNUNET_ALIGN;
    const struct BlockHeader *block = (const struct BlockHeader *) buf;
 
    GNUNET_assert (GNUNET_OK ==
                   GNUNET_HELLO_builder_to_block (builder,
                                                  priv,
                                                  buf,
                                                  &blen,
                                                  expiration_time));
    msg = GNUNET_malloc (sizeof (*msg)
                         + blen
                         - sizeof (*block));
    msg->header.type = htons (GNUNET_MESSAGE_TYPE_DHT_P2P_HELLO);
    msg->header.size = htons (sizeof (*msg)
                              + blen
                              - sizeof (*block));
    memcpy (&msg[1],
            &block[1],
            blen - sizeof (*block));
    msg->sig = block->sig;
    msg->expiration_time = block->expiration_time;
  }
  msg->url_counter = htons ((uint16_t) builder->a_length);
  return &msg->header;
}

References builder, BlockHeader::expiration_time, DhtHelloMessage::expiration_time, GNUNET_ALIGN, GNUNET_assert, GNUNET_break, GNUNET_HELLO_builder_to_block(), GNUNET_malloc, GNUNET_MESSAGE_TYPE_DHT_P2P_HELLO, GNUNET_NO, GNUNET_OK, msg, BlockHeader::sig, GNUNET_MessageHeader::size, and GNUNET_MessageHeader::type.

Referenced by broadcast_hello(), GCH_get_mine(), and got_hello().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_HELLO_builder_to_url()

char * GNUNET_HELLO_builder_to_url	(	const struct GNUNET_HELLO_Builder *	builder,
		const struct GNUNET_CRYPTO_EddsaPrivateKey *	priv
	)

Generate GNUnet HELLO URI from a builder.

Parameters

builder	builder to serialize
priv	private key to use to sign the result

Returns

hello URI

Definition at line 717 of file hello-uri.c.

{
  struct GNUNET_CRYPTO_EddsaSignature sig;
  struct GNUNET_TIME_Timestamp et;
  char *result;
  char *pids;
  char *sigs;
  const char *sep = "?";
 
  et = GNUNET_TIME_relative_to_timestamp (GNUNET_HELLO_ADDRESS_EXPIRATION);
  sign_hello (builder,
              et,
              priv,
              &sig);
  pids = GNUNET_STRINGS_data_to_string_alloc (&builder->pid,
                                              sizeof (builder->pid));
  sigs = GNUNET_STRINGS_data_to_string_alloc (&sig,
                                              sizeof (sig));
  GNUNET_asprintf (&result,
                   "gnunet://hello/%s/%s/%llu",
                   pids,
                   sigs,
                   (unsigned long long) GNUNET_TIME_timestamp_to_s (et));
  GNUNET_free (sigs);
  GNUNET_free (pids);
  for (struct Address *a = builder->a_head;
       NULL != a;
       a = a->next)
  {
    char *ue;
    char *tmp;
    int pfx_len;
    const char *eou;
 
    eou = strstr (a->uri,
                  "://");
    if (NULL == eou)
    {
      GNUNET_break (0);
      GNUNET_free (result);
      return NULL;
    }
    pfx_len = eou - a->uri;
    eou += 3;
    GNUNET_STRINGS_urlencode (a->uri_len - 4 - pfx_len,
                              eou,
                              &ue);
    GNUNET_asprintf (&tmp,
                     "%s%s%.*s=%s",
                     result,
                     sep,
                     pfx_len,
                     a->uri,
                     ue);
    GNUNET_free (ue);
    GNUNET_free (result);
    result = tmp;
    sep = "&";
  }
  return result;
}

References builder, GNUNET_asprintf(), GNUNET_break, GNUNET_free, GNUNET_HELLO_ADDRESS_EXPIRATION, GNUNET_STRINGS_data_to_string_alloc(), GNUNET_STRINGS_urlencode(), GNUNET_TIME_relative_to_timestamp(), GNUNET_TIME_timestamp_to_s(), result, and sign_hello().

Referenced by handle_dht_local_hello_get(), and run().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_HELLO_builder_to_block()

enum GNUNET_GenericReturnValue GNUNET_HELLO_builder_to_block	(	const struct GNUNET_HELLO_Builder *	builder,
		const struct GNUNET_CRYPTO_EddsaPrivateKey *	priv,
		void *	block,
		size_t *	block_size,
		struct GNUNET_TIME_Relative	expiration_time
	)

Generate DHT block from a builder.

Parameters

	builder	the builder to serialize
	priv	private key to use to sign the result
[out]	block	where to write the block, NULL to only calculate block_size
[in,out]	block_size	input is number of bytes available in block, output is number of bytes needed in block

Returns

GNUNET_OK on success, GNUNET_NO if block_size was too small or if block was NULL

Definition at line 782 of file hello-uri.c.

{
  struct BlockHeader bh;
  size_t needed = sizeof (bh);
  char *pos;
  struct GNUNET_TIME_Timestamp et;
 
  for (struct Address *a = builder->a_head;
       NULL != a;
       a = a->next)
  {
    GNUNET_assert (needed + a->uri_len > needed);
    needed += a->uri_len;
  }
  if ( (NULL == block) ||
       (needed < *block_size) )
  {
    *block_size = needed;
    return GNUNET_NO;
  }
  bh.pid = builder->pid;
  if (GNUNET_TIME_UNIT_ZERO.rel_value_us == expiration_time.rel_value_us)
    et = GNUNET_TIME_relative_to_timestamp (GNUNET_HELLO_ADDRESS_EXPIRATION);
  else
    et = GNUNET_TIME_relative_to_timestamp (expiration_time);
  bh.expiration_time = GNUNET_TIME_absolute_hton (et.abs_time);
  sign_hello (builder,
              et,
              priv,
              &bh.sig);
  memcpy (block,
          &bh,
          sizeof (bh));
  pos = block + sizeof (bh);
  for (struct Address *a = builder->a_head;
       NULL != a;
       a = a->next)
  {
    memcpy (pos,
            a->uri,
            a->uri_len);
    pos += a->uri_len;
  }
  *block_size = needed;
  return GNUNET_OK;
}

References GNUNET_TIME_Timestamp::abs_time, builder, BlockHeader::expiration_time, GNUNET_assert, GNUNET_HELLO_ADDRESS_EXPIRATION, GNUNET_NO, GNUNET_OK, GNUNET_TIME_absolute_hton(), GNUNET_TIME_relative_to_timestamp(), GNUNET_TIME_UNIT_ZERO, BlockHeader::pid, GNUNET_TIME_Relative::rel_value_us, BlockHeader::sig, and sign_hello().

Referenced by GNUNET_HELLO_builder_to_dht_hello_msg(), GNUNET_HELLO_builder_to_env(), and handle_find_my_hello().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_HELLO_builder_add_address()

enum GNUNET_GenericReturnValue GNUNET_HELLO_builder_add_address	(	struct GNUNET_HELLO_Builder *	builder,
		const char *	address
	)

Add individual address to the builder.

Parameters

[in,out]	builder	to update
	address	address URI to add

Returns

GNUNET_OK on success, GNUNET_NO if address was already in builder

Definition at line 835 of file hello-uri.c.

{
  size_t alen = strlen (address) + 1;
  struct Address *a;
  const char *e;
 
  if (NULL == (e = strstr (address,
                           "://")))
  {
    GNUNET_break_op (0);
    GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
                "Invalid address `%s'\n",
                address);
    return GNUNET_SYSERR;
  }
  if (e == address)
  {
    GNUNET_break_op (0);
    return GNUNET_SYSERR;
  }
  for (const char *p = address; p != e; p++)
    if ( (! isalpha ((unsigned char) *p)) &&
         ('+' != *p) )
    {
      GNUNET_break_op (0);
      return GNUNET_SYSERR;
    }
  /* check for duplicates */
  for (a = builder->a_head;
       NULL != a;
       a = a->next)
    if (0 == strcmp (address,
                     a->uri))
      return GNUNET_NO;
  a = GNUNET_malloc (sizeof (struct Address) + alen);
  a->uri_len = alen;
  memcpy (&a[1],
          address,
          alen);
  a->uri = (const char *) &a[1];
  GNUNET_CONTAINER_DLL_insert_tail (builder->a_head,
                                    builder->a_tail,
                                    a);
  builder->a_length++;
  return GNUNET_OK;
}

References address, builder, GNUNET_break_op, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_ERROR_TYPE_ERROR, GNUNET_log, GNUNET_malloc, GNUNET_NO, GNUNET_OK, GNUNET_SYSERR, Address::next, p, Address::uri, and Address::uri_len.

Referenced by add_to_builder(), GNUNET_HELLO_builder_from_block(), GNUNET_HELLO_builder_from_url(), store_pi(), and u_address_add().

Here is the caller graph for this function:

GNUNET_HELLO_builder_del_address()

enum GNUNET_GenericReturnValue GNUNET_HELLO_builder_del_address	(	struct GNUNET_HELLO_Builder *	builder,
		const char *	address
	)

Remove individual address from the builder.

Parameters

[in,out]	builder	to update
	address	address URI to remove

Returns

GNUNET_OK on success, GNUNET_NO if address was not in builder

Definition at line 885 of file hello-uri.c.

{
  struct Address *a;
 
  /* check for duplicates */
  for (a = builder->a_head;
       NULL != a;
       a = a->next)
    if (0 == strcmp (address,
                     a->uri))
      break;
  if (NULL == a)
    return GNUNET_NO;
  GNUNET_CONTAINER_DLL_remove (builder->a_head,
                               builder->a_tail,
                               a);
  builder->a_length--;
  GNUNET_free (a);
  return GNUNET_OK;
}

References address, builder, GNUNET_CONTAINER_DLL_remove, GNUNET_free, GNUNET_NO, GNUNET_OK, Address::next, and Address::uri.

Referenced by u_address_del().

Here is the caller graph for this function:

GNUNET_HELLO_builder_iterate()

const struct GNUNET_PeerIdentity * GNUNET_HELLO_builder_iterate	(	const struct GNUNET_HELLO_Builder *	builder,
		GNUNET_HELLO_UriCallback	uc,
		void *	uc_cls
	)

Iterate over URIs in a builder.

Parameters

builder	builder to iterate over
uc	callback invoked for each URI, can be NULL
uc_cls	closure for addrgen

Returns

pid of the peer the builder is for, can be NULL

Definition at line 909 of file hello-uri.c.

{
  struct Address *nxt;
 
  if (NULL == uc)
    return &builder->pid;
  for (struct Address *a = builder->a_head;
       NULL != a;
       a = nxt)
  {
    nxt = a->next;
    uc (uc_cls,
        &builder->pid,
        a->uri);
  }
  return &builder->pid;
}

References builder, Address::next, and uc.

Referenced by block_plugin_dht_check_block(), block_plugin_dht_check_reply(), block_plugin_dht_get_key(), check_for_global_natted(), consider_for_advertising(), handle_dht_local_hello_offer(), handle_hello_for_client(), handle_hello_for_incoming(), hello_check(), and peerinfo_cb().

Here is the caller graph for this function:

GNUNET_HELLO_dht_msg_to_block()

enum GNUNET_GenericReturnValue GNUNET_HELLO_dht_msg_to_block	(	const struct GNUNET_MessageHeader *	hello,
		const struct GNUNET_PeerIdentity *	pid,
		void **	block,
		size_t *	block_size,
		struct GNUNET_TIME_Absolute *	block_expiration
	)

Convert a DHT hello message to a HELLO block.

Parameters

	hello	the HELLO message
	pid	peer that created the hello
[out]	block	set to the HELLO block
[out]	block_size	set to number of bytes in block
[out]	block_expiration	set to expiration time of block

Returns

GNUNET_OK on success, GNUNET_NO if the hello is expired (block is set!) GNUNET_SYSERR if hello is invalid (block will be set to NULL)

Definition at line 931 of file hello-uri.c.

{
  const struct DhtHelloMessage *msg
    = (const struct DhtHelloMessage *) hello;
  uint16_t len = ntohs (hello->size);
  struct BlockHeader *bh;
  struct GNUNET_HELLO_Builder *b;
  enum GNUNET_GenericReturnValue ret;
 
  if (GNUNET_MESSAGE_TYPE_DHT_P2P_HELLO != ntohs (hello->type))
  {
    GNUNET_break (0);
    return GNUNET_SYSERR;
  }
  if (len < sizeof (*msg))
  {
    GNUNET_break_op (0);
    return GNUNET_SYSERR;
  }
  len -= sizeof (*msg);
  *block_size = len + sizeof (*bh);
  *block = GNUNET_malloc (*block_size);
  bh = *block;
  bh->pid = *pid;
  bh->sig = msg->sig;
  bh->expiration_time = msg->expiration_time;
  *block_expiration = GNUNET_TIME_absolute_ntoh (msg->expiration_time);
  memcpy (&bh[1],
          &msg[1],
          len);
  b = GNUNET_HELLO_builder_from_block (*block,
                                       *block_size);
  if (NULL == b)
  {
    GNUNET_break_op (0);
    GNUNET_free (*block);
    *block_size = 0;
    return GNUNET_SYSERR;
  }
  ret = verify_hello (b,
                      *block_expiration,
                      &msg->sig);
  GNUNET_HELLO_builder_free (b);
  if (GNUNET_SYSERR == ret)
  {
    GNUNET_free (*block);
    *block_size = 0;
    return GNUNET_SYSERR;
  }
  return ret;
}

References BlockHeader::expiration_time, GNUNET_break, GNUNET_break_op, GNUNET_free, GNUNET_HELLO_builder_free(), GNUNET_HELLO_builder_from_block(), GNUNET_malloc, GNUNET_MESSAGE_TYPE_DHT_P2P_HELLO, GNUNET_SYSERR, GNUNET_TIME_absolute_ntoh(), msg, BlockHeader::pid, pid, ret, BlockHeader::sig, GNUNET_MessageHeader::size, GNUNET_MessageHeader::type, and verify_hello().

Referenced by announce_id(), check_dht_p2p_hello(), and handle_dht_p2p_hello().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_HELLO_address_to_prefix()

char * GNUNET_HELLO_address_to_prefix

(

const char *

address

)

Given an address as a string, extract the prefix that identifies the communicator offering transmissions to that address.

Parameters

address

a peer's address

Returns

NULL if the address is mal-formed, otherwise the prefix

Definition at line 190 of file hello-ng.c.

{
  const char *dash;
 
  dash = strchr (address, '-');
  if (NULL == dash)
    return NULL;
  return GNUNET_strndup (address, dash - address);
}

References address, and GNUNET_strndup.

Referenced by GNUNET_TRANSPORT_TESTING_transport_communicator_open_queue(), store_pi(), and suggest_to_connect().

Here is the caller graph for this function:

GNUNET_HELLO_sign_address()

void GNUNET_HELLO_sign_address	(	const char *	address,
		enum GNUNET_NetworkType	nt,
		struct GNUNET_TIME_Absolute	mono_time,
		const struct GNUNET_CRYPTO_EddsaPrivateKey *	private_key,
		void **	result,
		size_t *	result_size
	)

Build address record by signing raw information with private key.

Parameters

	address	text address to sign
	nt	network type of address
	mono_time	when was address valid
	private_key	signing key to use
[out]	result	where to write address record (allocated)
[out]	result_size	set to size of result
	address	text address at communicator to sign
	nt	network type of address
	mono_time	monotonic time at which address was valid
	private_key	signing key to use
[out]	result	where to write address record (allocated)
[out]	result_size	set to size of result

Definition at line 66 of file hello-ng.c.

{
  struct SignedAddress sa;
  struct GNUNET_CRYPTO_EddsaSignature sig;
  char *sig_str;
 
  sa.purpose.purpose = htonl (GNUNET_SIGNATURE_PURPOSE_TRANSPORT_ADDRESS);
  sa.purpose.size = htonl (sizeof(sa));
  sa.mono_time = GNUNET_TIME_absolute_hton (mono_time);
  GNUNET_CRYPTO_hash (address, strlen (address), &sa.addr_hash);
  GNUNET_CRYPTO_eddsa_sign (private_key, &sa, &sig);
  sig_str = NULL;
  (void) GNUNET_STRINGS_base64_encode (&sig, sizeof(sig), &sig_str);
  *result_size =
    1 + GNUNET_asprintf ((char **) result,
                         "%s;%llu;%u;%s",
                         sig_str,
                         (unsigned long long) mono_time.abs_value_us,
                         (unsigned int) nt,
                         address);
  GNUNET_free (sig_str);
}

References GNUNET_TIME_Absolute::abs_value_us, SignedAddress::addr_hash, address, GNUNET_asprintf(), GNUNET_CRYPTO_eddsa_sign, GNUNET_CRYPTO_hash(), GNUNET_free, GNUNET_SIGNATURE_PURPOSE_TRANSPORT_ADDRESS, GNUNET_STRINGS_base64_encode(), GNUNET_TIME_absolute_hton(), SignedAddress::mono_time, nt, GNUNET_CRYPTO_EccSignaturePurpose::purpose, SignedAddress::purpose, result, and GNUNET_CRYPTO_EccSignaturePurpose::size.

Referenced by store_pi().

Here is the call graph for this function:

Here is the caller graph for this function: