gns_tld_api.c File Reference

library to access the GNS service, including TLD lookup More...

#include "platform.h"
#include "gnunet_common.h"
#include "gnunet_util_lib.h"
#include "gnunet_constants.h"
#include "gnunet_arm_service.h"
#include "gnunet_identity_service.h"
#include "gnunet_protocols.h"
#include "gnunet_dht_service.h"
#include "gns.h"
#include "gns_api.h"

Include dependency graph for gns_tld_api.c:

Go to the source code of this file.

Data Structures
struct	GNUNET_GNS_LookupWithTldRequest
	Handle to a lookup request. More...

Macros
#define	LOG(kind, ...)   GNUNET_log_from (kind, "gns-tld-api", __VA_ARGS__)

Functions
static const char *	get_tld (const char *name)
	Obtain the TLD of the given name. More...
static void	eat_tld (char *name, const char *tld)
	Eat the "TLD" (last bit) of the given name. More...
static void	process_lookup_result (void *cls, uint32_t rd_count, const struct GNUNET_GNSRECORD_Data *rd)
	Function called with the result of a GNS lookup. More...
static void	lookup_with_public_key (struct GNUNET_GNS_LookupWithTldRequest *ltr, const struct GNUNET_CRYPTO_PublicKey *pkey)
	Perform the actual resolution, starting with the zone identified by the given public key. More...
static void	identity_zone_cb (void *cls, const struct GNUNET_CRYPTO_PrivateKey *priv, const char *ego_name)
	Method called to with the ego we are to use for the lookup, when the ego is determined by a name. More...
enum GNUNET_GenericReturnValue	GNUNET_GNS_parse_ztld (const char *name, struct GNUNET_CRYPTO_PublicKey *ztld_key)
	Try to parse the zTLD into a public key. More...
struct GNUNET_GNS_LookupWithTldRequest *	GNUNET_GNS_lookup_with_tld (struct GNUNET_GNS_Handle *handle, const char *name, uint32_t type, enum GNUNET_GNS_LocalOptions options, GNUNET_GNS_LookupResultProcessor2 proc, void *proc_cls)
	Perform an asynchronous lookup operation on the GNS, determining the zone using the TLD of the given name and the current configuration to resolve TLDs to zones. More...
void *	GNUNET_GNS_lookup_with_tld_cancel (struct GNUNET_GNS_LookupWithTldRequest *ltr)
	Cancel pending lookup request. More...

Detailed Description

library to access the GNS service, including TLD lookup

Author

Martin Schanzenbach

Christian Grothoff

Definition in file gns_tld_api.c.

Macro Definition Documentation

LOG

#define LOG	(		kind,
			...
	)		GNUNET_log_from (kind, "gns-tld-api", __VA_ARGS__)

Definition at line 38 of file gns_tld_api.c.

Function Documentation

get_tld()

static const char * get_tld ( const char *  name )

static

Obtain the TLD of the given name.

Parameters

name

a name

Returns

the part of name after the last ".", or name if name does not contain a "."

Definition at line 107 of file gns_tld_api.c.

{
  const char *tld;
 
  tld = strrchr (name, (unsigned char) '.');
  if (NULL == tld)
    tld = name;
  else
    tld++; /* skip the '.' */
  return tld;
}

References name.

Referenced by GNUNET_GNS_lookup_with_tld(), and GNUNET_GNS_parse_ztld().

Here is the caller graph for this function:

eat_tld()

static void eat_tld ( char *  name, const char *  tld  )

static

Eat the "TLD" (last bit) of the given name.

Parameters

[in,out]	name	a name
	tld	what to eat (can be more than just the tld)

Definition at line 127 of file gns_tld_api.c.

{
  GNUNET_assert (0 < strlen (name));
  if ((NULL == tld) || (strlen (name) == strlen (tld)))
  {
    strcpy (name, GNUNET_GNS_EMPTY_LABEL_AT);
  }
  else
  {
    GNUNET_assert (strlen (tld) < strlen (name));
    name[strlen (name) - strlen (tld) - 1] = '\0';
  }
}

References GNUNET_assert, GNUNET_GNS_EMPTY_LABEL_AT, and name.

Referenced by GNUNET_GNS_lookup_with_tld().

Here is the caller graph for this function:

process_lookup_result()

static void process_lookup_result ( void *  cls, uint32_t  rd_count, const struct GNUNET_GNSRECORD_Data *  rd  )

static

Function called with the result of a GNS lookup.

Parameters

cls	a struct GNUNET_GNS_LookupWithTldRequest *
rd_count	number of records returned
rd	array of rd_count records with the results

Definition at line 150 of file gns_tld_api.c.

{
  struct GNUNET_GNS_LookupWithTldRequest *ltr = cls;
 
  ltr->lr = NULL;
  ltr->lookup_proc (ltr->lookup_proc_cls, GNUNET_YES, rd_count, rd);
  GNUNET_GNS_lookup_with_tld_cancel (ltr);
}

References GNUNET_GNS_lookup_with_tld_cancel(), GNUNET_YES, GNUNET_GNS_LookupWithTldRequest::lookup_proc, GNUNET_GNS_LookupWithTldRequest::lookup_proc_cls, GNUNET_GNS_LookupWithTldRequest::lr, rd, and rd_count.

Referenced by lookup_with_public_key().

Here is the call graph for this function:

Here is the caller graph for this function:

lookup_with_public_key()

static void lookup_with_public_key ( struct GNUNET_GNS_LookupWithTldRequest *  ltr, const struct GNUNET_CRYPTO_PublicKey *  pkey  )

static

Perform the actual resolution, starting with the zone identified by the given public key.

Parameters

pkey	public key to use for the zone, can be NULL

Definition at line 169 of file gns_tld_api.c.

{
  ltr->lr = GNUNET_GNS_lookup (ltr->gns_handle,
                               ltr->name,
                               pkey,
                               ltr->type,
                               ltr->options,
                               &process_lookup_result,
                               ltr);
}

References GNUNET_GNS_LookupWithTldRequest::gns_handle, GNUNET_GNS_lookup(), GNUNET_GNS_LookupWithTldRequest::lr, GNUNET_GNS_LookupWithTldRequest::name, GNUNET_GNS_LookupWithTldRequest::options, pkey, process_lookup_result(), and GNUNET_GNS_LookupWithTldRequest::type.

Referenced by GNUNET_GNS_lookup_with_tld(), and identity_zone_cb().

Here is the call graph for this function:

Here is the caller graph for this function:

identity_zone_cb()

static void identity_zone_cb ( void *  cls, const struct GNUNET_CRYPTO_PrivateKey *  priv, const char *  ego_name  )

static

Method called to with the ego we are to use for the lookup, when the ego is determined by a name.

Parameters

cls	a struct GNUNET_GNS_LookupWithTldRequest *
ego	ego handle, NULL at the end of the iteration
ctx	context we could store data to associate with ego
ego_name	name of the ego

Definition at line 192 of file gns_tld_api.c.

{
  struct GNUNET_GNS_LookupWithTldRequest *ltr = cls;
  struct GNUNET_CRYPTO_PublicKey pkey;
 
  ltr->id_co = NULL;
  if (NULL == priv)
  {
    /* no matching ego found */
    ltr->lookup_proc (ltr->lookup_proc_cls, GNUNET_NO, 0, NULL);
    return;
  }
  /* Final case: TLD matches one of our egos */
  if (0 == strcmp (ltr->name, ego_name))
  {
    /* name matches ego name perfectly, only "@" remains */
    strcpy (ltr->name, GNUNET_GNS_EMPTY_LABEL_AT);
  }
  else
  {
    GNUNET_assert (strlen (ego_name) < strlen (ltr->name));
    ltr->name[strlen (ltr->name) - strlen (ego_name) - 1] = '\0';
  }
  /* if the name is of the form 'label' (and not 'label.SUBDOMAIN'), never go to the DHT */
  if (NULL == strchr (ltr->name, (unsigned char) '.'))
    ltr->options = GNUNET_GNS_LO_NO_DHT;
  else
    ltr->options = GNUNET_GNS_LO_LOCAL_MASTER;
  GNUNET_CRYPTO_key_get_public (priv, &pkey);
  lookup_with_public_key (ltr, &pkey);
}

References ego_name, GNUNET_assert, GNUNET_CRYPTO_key_get_public(), GNUNET_GNS_EMPTY_LABEL_AT, GNUNET_GNS_LO_LOCAL_MASTER, GNUNET_GNS_LO_NO_DHT, GNUNET_NO, GNUNET_GNS_LookupWithTldRequest::id_co, GNUNET_GNS_LookupWithTldRequest::lookup_proc, GNUNET_GNS_LookupWithTldRequest::lookup_proc_cls, lookup_with_public_key(), GNUNET_GNS_LookupWithTldRequest::name, GNUNET_GNS_LookupWithTldRequest::options, and pkey.

Referenced by GNUNET_GNS_lookup_with_tld().

Here is the call graph for this function:

Here is the caller graph for this function: