Hello_Uri library

Helper library for handling HELLO URIs. More...

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

Typedefs
typedef void(*	GNUNET_HELLO_UriCallback) (void *cls, 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...
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_MQ_Envelope *	GNUNET_HELLO_builder_to_env (const struct GNUNET_HELLO_Builder *builder, const struct GNUNET_CRYPTO_EddsaPrivateKey *priv)
	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)
	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)
	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...
void	GNUNET_HELLO_builder_iterate (const struct GNUNET_HELLO_Builder *builder, struct GNUNET_PeerIdentity *pid, 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...

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 54 of file gnunet_hello_uri_lib.h.

Typedef Documentation

GNUNET_HELLO_UriCallback

typedef void(* GNUNET_HELLO_UriCallback) (void *cls, const char *uri)

Callback function used to extract URIs from a builder.

Parameters

cls	closure
uri	one of the URIs

Definition at line 196 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 301 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 GNUNET_HELLO_builder_from_block(), GNUNET_HELLO_builder_from_url(), and run().

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 312 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 GDS_NEIGHBOURS_handle_get(), GNUNET_HELLO_builder_from_block(), GNUNET_HELLO_builder_from_url(), handle_dht_local_hello_offer(), 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 330 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.

Here is the call 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 353 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 bh, end, 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(), ret, and verify_hello().

Referenced by GDS_NEIGHBOURS_handle_get(), and GNUNET_HELLO_builder_from_msg().

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 409 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(), len, 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_to_env()

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

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 547 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));
  env = GNUNET_MQ_msg_extra (msg,
                             blen,
                             GNUNET_MESSAGE_TYPE_HELLO_URI);
  msg->url_counter = htonl ((uint16_t) builder->a_length);
  GNUNET_assert (GNUNET_OK ==
                 GNUNET_HELLO_builder_to_block (builder,
                                                priv,
                                                &msg[1],
                                                &blen));
  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.

Here is the call 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
	)

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 579 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));
  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));
    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 = htonl ((uint16_t) builder->a_length);
  return &msg->header;
}

References buf, builder, BlockHeader::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().

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 627 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 (eou,
                              a->uri_len - 4 - pfx_len,
                              &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;
}

Referenced by check_dht_local_hello_offer().

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
	)

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 627 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;
  et = GNUNET_TIME_relative_to_timestamp (GNUNET_HELLO_ADDRESS_EXPIRATION);
  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;
}

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

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 627 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 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 GNUNET_HELLO_builder_from_block(), GNUNET_HELLO_builder_from_url(), and u_address_add().

Here is the call graph for this function:

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 627 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;
}

Referenced by u_address_del().

Here is the caller graph for this function:

GNUNET_HELLO_builder_iterate()

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

Iterate over URIs in a builder.

Parameters

	builder	builder to iterate over
[out]	pid	set to the peer the builder is for
	uc	callback invoked for each URI, can be NULL
	uc_cls	closure for addrgen

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

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

Referenced by GDS_NEIGHBOURS_handle_get(), and handle_dht_local_hello_offer().

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 815 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;
}

Referenced by handle_dht_p2p_hello().

Here is the caller graph for this function: