resolver_api.c File Reference

resolver for writing a tool More...

#include "platform.h"
#include "gnunet_util_lib.h"
#include "gnunet_protocols.h"
#include "gnunet_resolver_service.h"
#include "resolver.h"

Include dependency graph for resolver_api.c:

Go to the source code of this file.

Data Structures
struct	GNUNET_RESOLVER_RequestHandle
	Handle to a request given to the resolver. More...

Macros
#define	LOG(kind, ...)   GNUNET_log_from (kind, "util-resolver-api", __VA_ARGS__)
#define	LOG_STRERROR(kind, syscall)
#define	MAX_HOSTNAME   1024
	Maximum supported length for a hostname. More...

Functions
static int	check_config ()
	Check that the resolver service runs on localhost (or equivalent). More...
void	GNUNET_RESOLVER_connect (const struct GNUNET_CONFIGURATION_Handle *cfg)
	Create the connection to the resolver service. More...
void	GNUNET_RESOLVER_disconnect ()
	Destroy the connection to the resolver service. More...
static void	shutdown_task (void *cls)
	Task executed on system shutdown. More...
static void	check_disconnect ()
	Consider disconnecting if we have no further requests pending. More...
static char *	no_resolve (int af, const void *ip, socklen_t ip_len)
	Convert IP address to string without DNS resolution. More...
static void	reconnect (void)
	Adjust exponential back-off and reconnect to the service. More...
static void	mq_error_handler (void *cls, enum GNUNET_MQ_Error error)
	Generic error handler, called with the appropriate error code and the same closure specified at the creation of the message queue. More...
static void	process_requests ()
	Process pending requests to the resolver. More...
static int	check_response (void *cls, const struct GNUNET_RESOLVER_ResponseMessage *msg)
	Check validity of response with a hostname for a DNS lookup. More...
static void	handle_response (void *cls, const struct GNUNET_RESOLVER_ResponseMessage *msg)
	Check validity of response with a hostname for a DNS lookup. More...
static void	numeric_resolution (void *cls)
	We've been asked to lookup the address for a hostname and were given a valid numeric string. More...
static void	loopback_resolution (void *cls)
	We've been asked to lookup the address for a hostname and were given a variant of "loopback". More...
static void	reconnect_task (void *cls)
	Now try to reconnect to the resolver service. More...
static void	handle_lookup_timeout (void *cls)
	A DNS resolution timed out. More...
struct GNUNET_RESOLVER_RequestHandle *	GNUNET_RESOLVER_ip_get (const char *hostname, int af, struct GNUNET_TIME_Relative timeout, GNUNET_RESOLVER_AddressCallback callback, void *callback_cls)
	Convert a string to one or more IP addresses. More...
static void	numeric_reverse (void *cls)
	We've been asked to convert an address to a string without a reverse lookup, either because the client asked for it or because the DNS lookup hit a timeout. More...
struct GNUNET_RESOLVER_RequestHandle *	GNUNET_RESOLVER_hostname_get (const struct sockaddr *sa, socklen_t salen, int do_resolve, struct GNUNET_TIME_Relative timeout, GNUNET_RESOLVER_HostnameCallback callback, void *cls)
	Get an IP address as a string. More...
char *	GNUNET_RESOLVER_local_fqdn_get ()
	Get local fully qualified af name. More...
struct GNUNET_RESOLVER_RequestHandle *	GNUNET_RESOLVER_hostname_resolve (int af, struct GNUNET_TIME_Relative timeout, GNUNET_RESOLVER_AddressCallback callback, void *cls)
	Looking our own hostname. More...
void	GNUNET_RESOLVER_request_cancel (struct GNUNET_RESOLVER_RequestHandle *rh)
	Cancel a request that is still pending with the resolver. More...

Variables
static const char *	loopback []
	Possible hostnames for "loopback". More...
static const struct GNUNET_CONFIGURATION_Handle *	resolver_cfg
	Configuration. More...
static struct GNUNET_MQ_Handle *	mq
	Our connection to the resolver service, created on-demand, but then persists until error or shutdown. More...
static struct GNUNET_RESOLVER_RequestHandle *	req_head
	Head of DLL of requests. More...
static struct GNUNET_RESOLVER_RequestHandle *	req_tail
	Tail of DLL of requests. More...
static uint32_t	last_request_id
	ID of the last request we sent to the service. More...
static struct GNUNET_TIME_Relative	backoff
	How long should we wait to reconnect? More...
static struct GNUNET_SCHEDULER_Task *	r_task
	Task for reconnecting. More...
static struct GNUNET_SCHEDULER_Task *	s_task
	Task ID of shutdown task; only present while we have a connection to the resolver service. More...

Detailed Description

resolver for writing a tool

Author

Christian Grothoff

Definition in file resolver_api.c.

Macro Definition Documentation

LOG

#define LOG	(		kind,
			...
	)		GNUNET_log_from (kind, "util-resolver-api", __VA_ARGS__)

Definition at line 32 of file resolver_api.c.

Referenced by check_config(), GNUNET_RESOLVER_disconnect(), GNUNET_RESOLVER_hostname_get(), GNUNET_RESOLVER_hostname_resolve(), GNUNET_RESOLVER_ip_get(), GNUNET_RESOLVER_local_fqdn_get(), GNUNET_RESOLVER_request_cancel(), handle_lookup_timeout(), handle_response(), loopback_resolution(), mq_error_handler(), numeric_reverse(), process_requests(), reconnect(), and reconnect_task().

LOG_STRERROR

#define LOG_STRERROR	(		kind,
			syscall
	)

Value:

GNUNET_log_from_strerror (kind, \
                                                              "util-resolver-api", \
                                                              syscall)

Definition at line 34 of file resolver_api.c.

Referenced by GNUNET_RESOLVER_hostname_resolve(), GNUNET_RESOLVER_local_fqdn_get(), and no_resolve().

MAX_HOSTNAME

#define MAX_HOSTNAME   1024

Maximum supported length for a hostname.

Definition at line 41 of file resolver_api.c.

Function Documentation

check_config()

static int check_config ( )

static

Check that the resolver service runs on localhost (or equivalent).

Returns

GNUNET_OK if the resolver is properly configured, GNUNET_SYSERR otherwise.

Definition at line 190 of file resolver_api.c.

References _, GNUNET_CONFIGURATION_get_value_string(), GNUNET_CONFIGURATION_have_value(), GNUNET_ERROR_TYPE_INFO, GNUNET_free, GNUNET_OK, GNUNET_SYSERR, hostname, LOG, and loopback.

Referenced by GNUNET_RESOLVER_hostname_get(), and GNUNET_RESOLVER_ip_get().

{
  char *hostname;
  struct sockaddr_in v4;
  struct sockaddr_in6 v6;

  if (GNUNET_OK ==
      GNUNET_CONFIGURATION_have_value (resolver_cfg,
                                       "resolver",
                                       "UNIXPATH"))
    return GNUNET_OK;
  memset (&v4, 0, sizeof(v4));
  v4.sin_addr.s_addr = htonl (INADDR_LOOPBACK);
  v4.sin_family = AF_INET;
#if HAVE_SOCKADDR_IN_SIN_LEN
  v4.sin_len = sizeof(v4);
#endif
  memset (&v6, 0, sizeof(v6));
  v6.sin6_family = AF_INET6;
#if HAVE_SOCKADDR_IN_SIN_LEN
  v6.sin6_len = sizeof(v6);
#endif
  if (GNUNET_OK !=
      GNUNET_CONFIGURATION_get_value_string (resolver_cfg,
                                             "resolver",
                                             "HOSTNAME",
                                             &hostname))
  {
    LOG (GNUNET_ERROR_TYPE_INFO,
         _ (
           "Missing `%s' for `%s' in configuration, DNS resolution will be unavailable.\n"),
         "HOSTNAME",
         "resolver");
    return GNUNET_SYSERR;
  }
  if ((1 == inet_pton (AF_INET, hostname, &v4)) ||
      (1 == inet_pton (AF_INET6, hostname, &v6)))
  {
    GNUNET_free (hostname);
    return GNUNET_OK;
  }
  for (unsigned int i = 0;
       NULL != loopback[i];
       i++)
    if (0 == strcasecmp (loopback[i],
                         hostname))
    {
      GNUNET_free (hostname);
      return GNUNET_OK;
    }
  LOG (GNUNET_ERROR_TYPE_INFO,
       _ (
         "Missing `%s' or numeric IP address for `%s' of `%s' in configuration, DNS resolution will be unavailable.\n"),
       "localhost",
       "HOSTNAME",
       "resolver");
  GNUNET_free (hostname);
  return GNUNET_SYSERR;
}

Here is the call graph for this function:

Here is the caller graph for this function:

shutdown_task()

static void shutdown_task ( void *  cls )

static

Task executed on system shutdown.

Definition at line 305 of file resolver_api.c.

References backoff, GNUNET_RESOLVER_disconnect(), and GNUNET_TIME_UNIT_MILLISECONDS.

Referenced by check_disconnect(), and process_requests().

{
  (void) cls;
  s_task = NULL;
  GNUNET_RESOLVER_disconnect ();
  backoff = GNUNET_TIME_UNIT_MILLISECONDS;
}

Here is the call graph for this function:

Here is the caller graph for this function:

check_disconnect()

static void check_disconnect ( )

static

Consider disconnecting if we have no further requests pending.

Definition at line 318 of file resolver_api.c.

References GNUNET_SCHEDULER_add_delayed(), GNUNET_SCHEDULER_cancel(), GNUNET_SYSERR, GNUNET_TIME_UNIT_MILLISECONDS, GNUNET_RESOLVER_RequestHandle::next, and shutdown_task().

Referenced by GNUNET_RESOLVER_request_cancel(), and reconnect().

{
  for (struct GNUNET_RESOLVER_RequestHandle *rh = req_head;
       NULL != rh;
       rh = rh->next)
    if (GNUNET_SYSERR != rh->was_transmitted)
      return;
  if (NULL != r_task)
  {
    GNUNET_SCHEDULER_cancel (r_task);
    r_task = NULL;
  }
  if (NULL != s_task)
    return;
  s_task = GNUNET_SCHEDULER_add_delayed (GNUNET_TIME_UNIT_MILLISECONDS,
                                         &shutdown_task,
                                         NULL);
}

Here is the call graph for this function:

Here is the caller graph for this function:

no_resolve()

static char* no_resolve ( int  af, const void *  ip, socklen_t  ip_len  )

static

Convert IP address to string without DNS resolution.

Parameters

af	address family
ip	the address
ip_len	number of bytes in ip

Returns

address as a string, NULL on error

Definition at line 347 of file resolver_api.c.

References buf, GNUNET_break, GNUNET_ERROR_TYPE_WARNING, GNUNET_strdup, LOG_STRERROR, and reconnect().

Referenced by handle_lookup_timeout(), handle_response(), and numeric_reverse().

{
  char buf[INET6_ADDRSTRLEN];

  switch (af)
  {
  case AF_INET:
    if (ip_len != sizeof(struct in_addr))
      return NULL;
    if (NULL ==
        inet_ntop (AF_INET,
                   ip,
                   buf,
                   sizeof(buf)))
    {
      LOG_STRERROR (GNUNET_ERROR_TYPE_WARNING,
                    "inet_ntop");
      return NULL;
    }
    break;

  case AF_INET6:
    if (ip_len != sizeof(struct in6_addr))
      return NULL;
    if (NULL ==
        inet_ntop (AF_INET6,
                   ip,
                   buf,
                   sizeof(buf)))
    {
      LOG_STRERROR (GNUNET_ERROR_TYPE_WARNING,
                    "inet_ntop");
      return NULL;
    }
    break;

  default:
    GNUNET_break (0);
    return NULL;
  }
  return GNUNET_strdup (buf);
}

Here is the call graph for this function:

Here is the caller graph for this function:

reconnect()

static void reconnect ( void  )

static

Adjust exponential back-off and reconnect to the service.

Definition at line 827 of file resolver_api.c.

References backoff, check_disconnect(), GNUNET_assert, GNUNET_CONTAINER_DLL_remove, GNUNET_ERROR_TYPE_DEBUG, GNUNET_free, GNUNET_NO, GNUNET_SCHEDULER_add_delayed(), GNUNET_STRINGS_relative_time_to_string(), GNUNET_SYSERR, GNUNET_TIME_STD_BACKOFF, GNUNET_YES, LOG, reconnect_task(), and GNUNET_RESOLVER_RequestHandle::was_transmitted.

Referenced by handle_response(), mq_error_handler(), no_resolve(), process_requests(), and reconnect_task().

{
  struct GNUNET_RESOLVER_RequestHandle *rh;

  if (NULL != r_task)
    return;
  GNUNET_assert (NULL == mq);
  if (NULL != (rh = req_head))
  {
    switch (rh->was_transmitted)
    {
    case GNUNET_NO:
      /* nothing more to do */
      break;

    case GNUNET_YES:
      /* disconnected, transmit again! */
      rh->was_transmitted = GNUNET_NO;
      break;

    case GNUNET_SYSERR:
      /* request was cancelled, remove entirely */
      GNUNET_CONTAINER_DLL_remove (req_head,
                                   req_tail,
                                   rh);
      GNUNET_free (rh);
      check_disconnect ();
      break;

    default:
      GNUNET_assert (0);
      break;
    }
  }
  LOG (GNUNET_ERROR_TYPE_DEBUG,
       "Will try to connect to DNS service in %s\n",
       GNUNET_STRINGS_relative_time_to_string (backoff,
                                               GNUNET_YES));
  GNUNET_assert (NULL != resolver_cfg);
  r_task = GNUNET_SCHEDULER_add_delayed (backoff,
                                         &reconnect_task,
                                         NULL);
  backoff = GNUNET_TIME_STD_BACKOFF (backoff);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mq_error_handler()

static void mq_error_handler ( void *  cls, enum GNUNET_MQ_Error  error  )

static

Generic error handler, called with the appropriate error code and the same closure specified at the creation of the message queue.

Not every message queue implementation supports an error handler.

Parameters

cls	NULL
error	error code

Definition at line 409 of file resolver_api.c.

References GNUNET_ERROR_TYPE_DEBUG, GNUNET_MQ_destroy(), LOG, and reconnect().

Referenced by reconnect_task().

{
  (void) cls;
  GNUNET_MQ_destroy (mq);
  mq = NULL;
  LOG (GNUNET_ERROR_TYPE_DEBUG,
       "MQ error %d, reconnecting\n",
       error);
  reconnect ();
}

Here is the call graph for this function:

Here is the caller graph for this function:

process_requests()

static void process_requests ( )

static

Process pending requests to the resolver.

Definition at line 426 of file resolver_api.c.

References GNUNET_RESOLVER_GetMessage::af, GNUNET_RESOLVER_RequestHandle::af, GNUNET_RESOLVER_GetMessage::client_id, GNUNET_RESOLVER_RequestHandle::data_len, GNUNET_RESOLVER_GetMessage::direction, GNUNET_RESOLVER_RequestHandle::direction, env, GNUNET_ERROR_TYPE_DEBUG, GNUNET_memcpy, GNUNET_MESSAGE_TYPE_RESOLVER_REQUEST, GNUNET_MQ_msg_extra, GNUNET_MQ_send(), GNUNET_NO, GNUNET_SCHEDULER_add_delayed(), GNUNET_TIME_UNIT_MILLISECONDS, GNUNET_YES, GNUNET_RESOLVER_RequestHandle::id, LOG, msg, reconnect(), req_head, shutdown_task(), and GNUNET_RESOLVER_RequestHandle::was_transmitted.

Referenced by GNUNET_RESOLVER_hostname_get(), GNUNET_RESOLVER_ip_get(), handle_lookup_timeout(), handle_response(), and reconnect_task().

{
  struct GNUNET_RESOLVER_GetMessage *msg;
  struct GNUNET_MQ_Envelope *env;
  struct GNUNET_RESOLVER_RequestHandle *rh = req_head;

  if (NULL == mq)
  {
    reconnect ();
    return;
  }
  if (NULL == rh)
  {
    /* nothing to do, release socket really soon if there is nothing
     * else happening... */
    if (NULL == s_task)
      s_task =
        GNUNET_SCHEDULER_add_delayed (GNUNET_TIME_UNIT_MILLISECONDS,
                                      &shutdown_task,
                                      NULL);
    return;
  }
  if (GNUNET_NO != rh->was_transmitted)
    return;                     /* waiting for reply */
  env = GNUNET_MQ_msg_extra (msg,
                             rh->data_len,
                             GNUNET_MESSAGE_TYPE_RESOLVER_REQUEST);
  msg->direction = htonl (rh->direction);
  msg->af = htonl (rh->af);
  msg->client_id = rh->id;
  GNUNET_memcpy (&msg[1],
                 &rh[1],
                 rh->data_len);
  LOG (GNUNET_ERROR_TYPE_DEBUG,
       "Transmitting DNS resolution request (ID %u) to DNS service\n",
       rh->id);
  GNUNET_MQ_send (mq,
                  env);
  rh->was_transmitted = GNUNET_YES;
}

Here is the call graph for this function:

Here is the caller graph for this function:

check_response()

static int check_response ( void *  cls, const struct GNUNET_RESOLVER_ResponseMessage *  msg  )

static

Check validity of response with a hostname for a DNS lookup.

Parameters

cls	NULL
msg	message with the hostname

Definition at line 475 of file resolver_api.c.

References GNUNET_OK.

{
  (void) cls;
  (void) msg;

  /* implemented in #handle_response() for now */
  return GNUNET_OK;
}

handle_response()

static void handle_response ( void *  cls, const struct GNUNET_RESOLVER_ResponseMessage *  msg  )

static

Check validity of response with a hostname for a DNS lookup.

NOTE: right now rather messy, might want to use different message types for different response formats in the future.

Parameters

cls	NULL
msg	message with the response

Definition at line 495 of file resolver_api.c.

References GNUNET_RESOLVER_RequestHandle::addr_callback, GNUNET_RESOLVER_RequestHandle::af, GNUNET_RESOLVER_ResponseMessage::client_id, GNUNET_RESOLVER_RequestHandle::cls, GNUNET_RESOLVER_RequestHandle::data_len, GNUNET_a2s(), GNUNET_break, GNUNET_ERROR_TYPE_DEBUG, GNUNET_free, GNUNET_MQ_destroy(), GNUNET_NO, GNUNET_RESOLVER_request_cancel(), GNUNET_SYSERR, GNUNET_YES, GNUNET_RESOLVER_ResponseMessage::header, hostname, GNUNET_RESOLVER_RequestHandle::id, LOG, GNUNET_RESOLVER_RequestHandle::name_callback, GNUNET_RESOLVER_RequestHandle::next, no_resolve(), process_requests(), GNUNET_RESOLVER_RequestHandle::received_response, reconnect(), req_head, size, GNUNET_MessageHeader::size, and GNUNET_RESOLVER_RequestHandle::was_transmitted.

{
  struct GNUNET_RESOLVER_RequestHandle *rh = req_head;
  uint16_t size;
  char *nret;
  uint32_t client_request_id = msg->client_id;

  for (; rh != NULL; rh = rh->next)
  {
    if (rh->id == client_request_id)
      break;
  }

  (void) cls;
  if (NULL == rh)
  {
    /* Resolver service sent extra replies to query (after terminator)? Bad! */
    GNUNET_break (0);
    GNUNET_MQ_destroy (mq);
    mq = NULL;
    reconnect ();
    return;
  }
  size = ntohs (msg->header.size);
  if (size == sizeof(struct GNUNET_RESOLVER_ResponseMessage))
  {
    LOG (GNUNET_ERROR_TYPE_DEBUG,
         "Received empty response from DNS service\n");
    /* message contains not data, just header; end of replies */
    /* check if request was canceled */
    if (GNUNET_SYSERR != rh->was_transmitted)
    {
      /* no reverse lookup was successful, return IP as string */
      if (NULL != rh->name_callback)
      {
        if (GNUNET_NO == rh->received_response)
        {
          nret = no_resolve (rh->af,
                             &rh[1],
                             rh->data_len);
          rh->name_callback (rh->cls, nret);
          GNUNET_free (nret);
        }
        /* finally, make termination call */
        if (GNUNET_SYSERR != rh->was_transmitted)
          rh->name_callback (rh->cls,
                             NULL);
      }
      if ((NULL != rh->addr_callback) &&
          (GNUNET_SYSERR != rh->was_transmitted))
        rh->addr_callback (rh->cls,
                           NULL,
                           0);
    }
    rh->was_transmitted = GNUNET_NO;
    GNUNET_RESOLVER_request_cancel (rh);
    process_requests ();
    return;
  }
  /* return reverse lookup results to caller */
  if (NULL != rh->name_callback)
  {
    const char *hostname;

    hostname = (const char *) &msg[1];
    if (hostname[size - sizeof(struct GNUNET_RESOLVER_ResponseMessage) - 1] !=
        '\0')
    {
      GNUNET_break (0);
      if (GNUNET_SYSERR != rh->was_transmitted)
        rh->name_callback (rh->cls,
                           NULL);
      rh->was_transmitted = GNUNET_NO;
      GNUNET_RESOLVER_request_cancel (rh);
      GNUNET_MQ_destroy (mq);
      mq = NULL;
      reconnect ();
      return;
    }
    LOG (GNUNET_ERROR_TYPE_DEBUG,
         "Resolver returns `%s' for IP `%s'.\n",
         hostname,
         GNUNET_a2s ((const void *) &rh[1],
                     rh->data_len));
    if (rh->was_transmitted != GNUNET_SYSERR)
      rh->name_callback (rh->cls,
                         hostname);
    rh->received_response = GNUNET_YES;
  }
  /* return lookup results to caller */
  if (NULL != rh->addr_callback)
  {
    struct sockaddr_in v4;
    struct sockaddr_in6 v6;
    const struct sockaddr *sa;
    socklen_t salen;
    const void *ip;
    size_t ip_len;

    ip = &msg[1];
    ip_len = size - sizeof(struct GNUNET_RESOLVER_ResponseMessage);
    if (ip_len == sizeof(struct in_addr))
    {
      memset (&v4, 0, sizeof(v4));
      v4.sin_family = AF_INET;
      v4.sin_addr = *(struct in_addr*) ip;
#if HAVE_SOCKADDR_IN_SIN_LEN
      v4.sin_len = sizeof(v4);
#endif
      salen = sizeof(v4);
      sa = (const struct sockaddr *) &v4;
    }
    else if (ip_len == sizeof(struct in6_addr))
    {
      memset (&v6, 0, sizeof(v6));
      v6.sin6_family = AF_INET6;
      v6.sin6_addr = *(struct in6_addr*) ip;
#if HAVE_SOCKADDR_IN_SIN_LEN
      v6.sin6_len = sizeof(v6);
#endif
      salen = sizeof(v6);
      sa = (const struct sockaddr *) &v6;
    }
    else
    {
      GNUNET_break (0);
      if (GNUNET_SYSERR != rh->was_transmitted)
        rh->addr_callback (rh->cls,
                           NULL,
                           0);
      rh->was_transmitted = GNUNET_NO;
      GNUNET_RESOLVER_request_cancel (rh);
      GNUNET_MQ_destroy (mq);
      mq = NULL;
      reconnect ();
      return;
    }
    LOG (GNUNET_ERROR_TYPE_DEBUG,
         "Received IP from DNS service\n");
    if (GNUNET_SYSERR != rh->was_transmitted)
      rh->addr_callback (rh->cls,
                         sa,
                         salen);
  }
}

Here is the call graph for this function:

numeric_resolution()

static void numeric_resolution ( void *  cls )

static

We've been asked to lookup the address for a hostname and were given a valid numeric string.

Perform the callbacks for the numeric addresses.

Parameters

cls	struct GNUNET_RESOLVER_RequestHandle for the request

Definition at line 651 of file resolver_api.c.

References GNUNET_RESOLVER_RequestHandle::addr_callback, GNUNET_RESOLVER_RequestHandle::af, GNUNET_RESOLVER_RequestHandle::cls, GNUNET_assert, GNUNET_free, GNUNET_SYSERR, hostname, GNUNET_RESOLVER_RequestHandle::task, and GNUNET_RESOLVER_RequestHandle::was_transmitted.

Referenced by GNUNET_RESOLVER_ip_get().

{
  struct GNUNET_RESOLVER_RequestHandle *rh = cls;
  struct sockaddr_in v4;
  struct sockaddr_in6 v6;
  const char *hostname;

  rh->task = NULL;
  memset (&v4, 0, sizeof(v4));
  v4.sin_family = AF_INET;
#if HAVE_SOCKADDR_IN_SIN_LEN
  v4.sin_len = sizeof(v4);
#endif
  memset (&v6, 0, sizeof(v6));
  v6.sin6_family = AF_INET6;
#if HAVE_SOCKADDR_IN_SIN_LEN
  v6.sin6_len = sizeof(v6);
#endif
  hostname = (const char *) &rh[1];
  if (((rh->af == AF_UNSPEC) ||
       (rh->af == AF_INET)) &&
      (1 == inet_pton (AF_INET,
                       hostname,
                       &v4.sin_addr)))
  {
    rh->addr_callback (rh->cls,
                       (const struct sockaddr *) &v4,
                       sizeof(v4));
    if ((rh->af == AF_UNSPEC) &&
        (GNUNET_SYSERR != rh->was_transmitted) &&
        (1 == inet_pton (AF_INET6,
                         hostname,
                         &v6.sin6_addr)))
    {
      /* this can happen on some systems IF "hostname" is "localhost" */
      rh->addr_callback (rh->cls,
                         (const struct sockaddr *) &v6,
                         sizeof(v6));
    }
    if (GNUNET_SYSERR != rh->was_transmitted)
      rh->addr_callback (rh->cls,
                         NULL,
                         0);
    GNUNET_free (rh);
    return;
  }
  if (((rh->af == AF_UNSPEC) ||
       (rh->af == AF_INET6)) &&
      (1 == inet_pton (AF_INET6,
                       hostname,
                       &v6.sin6_addr)))
  {
    rh->addr_callback (rh->cls,
                       (const struct sockaddr *) &v6,
                       sizeof(v6));
    if (GNUNET_SYSERR != rh->was_transmitted)
      rh->addr_callback (rh->cls,
                         NULL,
                         0);
    GNUNET_free (rh);
    return;
  }
  /* why are we here? this task should not have been scheduled! */
  GNUNET_assert (0);
  GNUNET_free (rh);
}

Here is the caller graph for this function:

loopback_resolution()

static void loopback_resolution ( void *  cls )

static

We've been asked to lookup the address for a hostname and were given a variant of "loopback".

Perform the callbacks for the respective loopback numeric addresses.

Parameters

cls	struct GNUNET_RESOLVER_RequestHandle for the request

Definition at line 727 of file resolver_api.c.

References GNUNET_RESOLVER_RequestHandle::addr_callback, GNUNET_RESOLVER_RequestHandle::af, GNUNET_RESOLVER_RequestHandle::cls, GNUNET_break, GNUNET_ERROR_TYPE_DEBUG, GNUNET_free, GNUNET_SYSERR, LOG, GNUNET_RESOLVER_RequestHandle::task, and GNUNET_RESOLVER_RequestHandle::was_transmitted.

Referenced by GNUNET_RESOLVER_ip_get().

{
  struct GNUNET_RESOLVER_RequestHandle *rh = cls;
  struct sockaddr_in v4;
  struct sockaddr_in6 v6;

  rh->task = NULL;
  memset (&v4, 0, sizeof(v4));
  v4.sin_addr.s_addr = htonl (INADDR_LOOPBACK);
  v4.sin_family = AF_INET;
#if HAVE_SOCKADDR_IN_SIN_LEN
  v4.sin_len = sizeof(v4);
#endif
  memset (&v6, 0, sizeof(v6));
  v6.sin6_family = AF_INET6;
#if HAVE_SOCKADDR_IN_SIN_LEN
  v6.sin6_len = sizeof(v6);
#endif
  v6.sin6_addr = in6addr_loopback;
  switch (rh->af)
  {
  case AF_INET:
    rh->addr_callback (rh->cls,
                       (const struct sockaddr *) &v4,
                       sizeof(v4));
    break;

  case AF_INET6:
    rh->addr_callback (rh->cls,
                       (const struct sockaddr *) &v6,
                       sizeof(v6));
    break;

  case AF_UNSPEC:
    rh->addr_callback (rh->cls,
                       (const struct sockaddr *) &v6,
                       sizeof(v6));
    rh->addr_callback (rh->cls,
                       (const struct sockaddr *) &v4,
                       sizeof(v4));

    break;

  default:
    GNUNET_break (0);
    break;
  }
  if (GNUNET_SYSERR != rh->was_transmitted)
    rh->addr_callback (rh->cls,
                       NULL,
                       0);
  LOG (GNUNET_ERROR_TYPE_DEBUG,
       "Finished resolving hostname `%s'.\n",
       (const char *) &rh[1]);
  GNUNET_free (rh);
}

Here is the caller graph for this function:

reconnect_task()

static void reconnect_task ( void *  cls )

static

Now try to reconnect to the resolver service.

Parameters

cls

NULL

Definition at line 791 of file resolver_api.c.

References GNUNET_CLIENT_connect(), GNUNET_ERROR_TYPE_DEBUG, GNUNET_MESSAGE_TYPE_RESOLVER_RESPONSE, GNUNET_MQ_handler_end, GNUNET_MQ_hd_var_size, LOG, mq_error_handler(), process_requests(), reconnect(), and response.

Referenced by reconnect().

{
  struct GNUNET_MQ_MessageHandler handlers[] = {
    GNUNET_MQ_hd_var_size (response,
                           GNUNET_MESSAGE_TYPE_RESOLVER_RESPONSE,
                           struct GNUNET_RESOLVER_ResponseMessage,
                           NULL),
    GNUNET_MQ_handler_end ()
  };

  (void) cls;
  r_task = NULL;
  if (NULL == req_head)
    return;                     /* no work pending */
  LOG (GNUNET_ERROR_TYPE_DEBUG,
       "Trying to connect to DNS service\n");
  mq = GNUNET_CLIENT_connect (resolver_cfg,
                              "resolver",
                              handlers,
                              &mq_error_handler,
                              NULL);
  if (NULL == mq)
  {
    LOG (GNUNET_ERROR_TYPE_DEBUG,
         "Failed to connect, will try again later\n");
    reconnect ();
    return;
  }
  process_requests ();
}

Here is the call graph for this function:

Here is the caller graph for this function:

handle_lookup_timeout()

static void handle_lookup_timeout ( void *  cls )

static

A DNS resolution timed out.

Notify the application.

Parameters

cls	the struct GNUNET_RESOLVER_RequestHandle *

Definition at line 879 of file resolver_api.c.

References _, GNUNET_RESOLVER_RequestHandle::af, buf, GNUNET_RESOLVER_RequestHandle::cls, GNUNET_RESOLVER_RequestHandle::direction, GNUNET_ERROR_TYPE_INFO, GNUNET_free, GNUNET_NO, GNUNET_RESOLVER_request_cancel(), LOG, no_resolve(), process_requests(), GNUNET_RESOLVER_RequestHandle::task, and GNUNET_RESOLVER_RequestHandle::was_transmitted.

Referenced by GNUNET_RESOLVER_hostname_get(), and GNUNET_RESOLVER_ip_get().

{
  struct GNUNET_RESOLVER_RequestHandle *rh = cls;

  rh->task = NULL;
  if (GNUNET_NO == rh->direction)
  {
    LOG (GNUNET_ERROR_TYPE_INFO,
         _ ("Timeout trying to resolve hostname `%s'.\n"),
         (const char *) &rh[1]);
    if (NULL != rh->addr_callback)
      rh->addr_callback (rh->cls,
                         NULL,
                         0);
  }
  else
  {
#if ! defined(GNUNET_CULL_LOGGING)
    char buf[INET6_ADDRSTRLEN];

    LOG (GNUNET_ERROR_TYPE_INFO,
         _ ("Timeout trying to resolve IP address `%s'.\n"),
         inet_ntop (rh->af,
                    (const void *) &rh[1],
                    buf,
                    sizeof(buf)));
#endif
    if (GNUNET_NO == rh->received_response)
    {
      char *nret;

      nret = no_resolve (rh->af,
                         &rh[1],
                         rh->data_len);
      if (NULL != rh->name_callback)
        rh->name_callback (rh->cls, nret);
      GNUNET_free (nret);
    }
    /* finally, make termination call */
    if (NULL != rh->name_callback)
      rh->name_callback (rh->cls,
                         NULL);
  }
  rh->was_transmitted = GNUNET_NO;
  GNUNET_RESOLVER_request_cancel (rh);
  process_requests ();
}

Here is the call graph for this function:

Here is the caller graph for this function:

numeric_reverse()

static void numeric_reverse ( void *  cls )

static

We've been asked to convert an address to a string without a reverse lookup, either because the client asked for it or because the DNS lookup hit a timeout.

Do the numeric conversion and invoke the callback.

Parameters

cls	struct GNUNET_RESOLVER_RequestHandle for the request

Definition at line 1029 of file resolver_api.c.

References GNUNET_RESOLVER_RequestHandle::af, GNUNET_RESOLVER_RequestHandle::cls, GNUNET_RESOLVER_RequestHandle::data_len, GNUNET_ERROR_TYPE_DEBUG, GNUNET_free, GNUNET_SCHEDULER_cancel(), LOG, GNUNET_RESOLVER_RequestHandle::name_callback, no_resolve(), result, and GNUNET_RESOLVER_RequestHandle::task.

Referenced by GNUNET_RESOLVER_hostname_get().

{
  struct GNUNET_RESOLVER_RequestHandle *rh = cls;
  char *result;

  rh->task = NULL;
  result = no_resolve (rh->af,
                       &rh[1],
                       rh->data_len);
  LOG (GNUNET_ERROR_TYPE_DEBUG,
       "Resolver returns `%s'.\n",
       result);
  if (NULL != result)
  {
    rh->name_callback (rh->cls,
                       result);
    GNUNET_free (result);
  }
  rh->name_callback (rh->cls,
                     NULL);
  if (NULL != rh->task)
  {
    GNUNET_SCHEDULER_cancel (rh->task);
    rh->task = NULL;
  }
  GNUNET_free (rh);
}

Here is the call graph for this function:

Here is the caller graph for this function:

Variable Documentation

loopback

const char* loopback[]

static

Initial value:

= {
  "localhost",
  "ip6-localnet",
  NULL
}

Possible hostnames for "loopback".

Definition at line 47 of file resolver_api.c.

Referenced by check_config(), and GNUNET_RESOLVER_ip_get().

resolver_cfg

const struct GNUNET_CONFIGURATION_Handle* resolver_cfg

static

Configuration.

Definition at line 57 of file resolver_api.c.

mq

struct GNUNET_MQ_Handle* mq

static

Our connection to the resolver service, created on-demand, but then persists until error or shutdown.

Definition at line 63 of file resolver_api.c.

req_head

struct GNUNET_RESOLVER_RequestHandle* req_head

static

Head of DLL of requests.

Definition at line 68 of file resolver_api.c.

Referenced by handle_response(), and process_requests().

req_tail

struct GNUNET_RESOLVER_RequestHandle* req_tail

static

Tail of DLL of requests.

Definition at line 73 of file resolver_api.c.

last_request_id

uint32_t last_request_id

static

ID of the last request we sent to the service.

Definition at line 78 of file resolver_api.c.

Referenced by GNUNET_RESOLVER_hostname_get(), and GNUNET_RESOLVER_ip_get().

backoff

struct GNUNET_TIME_Relative backoff

static

How long should we wait to reconnect?

Definition at line 83 of file resolver_api.c.

Referenced by GNUNET_RESOLVER_connect(), reconnect(), and shutdown_task().

r_task

struct GNUNET_SCHEDULER_Task* r_task

static

Task for reconnecting.

Definition at line 88 of file resolver_api.c.

s_task

struct GNUNET_SCHEDULER_Task* s_task

static

Task ID of shutdown task; only present while we have a connection to the resolver service.

Definition at line 94 of file resolver_api.c.