transport_api_address_to_string.c File Reference

enable clients to convert addresses to human readable strings More...

#include "platform.h"
#include "gnunet_util_lib.h"
#include "gnunet_arm_service.h"
#include "gnunet_hello_lib.h"
#include "gnunet_protocols.h"
#include "gnunet_transport_service.h"
#include "transport.h"

Include dependency graph for transport_api_address_to_string.c:

Go to the source code of this file.

Data Structures
struct	GNUNET_TRANSPORT_AddressToStringContext
	Context for the address lookup. More...

Functions
static int	check_reply (void *cls, const struct AddressToStringResultMessage *atsm)
	Function called with responses from the service. More...
static void	handle_reply (void *cls, const struct AddressToStringResultMessage *atsm)
	Function called with responses from 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...
struct GNUNET_TRANSPORT_AddressToStringContext *	GNUNET_TRANSPORT_address_to_string (const struct GNUNET_CONFIGURATION_Handle *cfg, const struct GNUNET_HELLO_Address *address, int numeric, struct GNUNET_TIME_Relative timeout, GNUNET_TRANSPORT_AddressToStringCallback aluc, void *aluc_cls)
	Convert a binary address into a human readable address. More...
void	GNUNET_TRANSPORT_address_to_string_cancel (struct GNUNET_TRANSPORT_AddressToStringContext *alc)
	Cancel request for address conversion. More...

Detailed Description

enable clients to convert addresses to human readable strings

Author

Christian Grothoff

Definition in file transport_api_address_to_string.c.

Function Documentation

check_reply()

static int check_reply ( void *  cls, const struct AddressToStringResultMessage *  atsm  )

static

Function called with responses from the service.

Parameters

cls	our struct GNUNET_TRANSPORT_AddressToStringContext *
atsm	message with the human-readable address

Returns

GNUNET_OK if message is well-formed

Definition at line 63 of file transport_api_address_to_string.c.

{
  uint16_t size = ntohs (atsm->header.size) - sizeof(*atsm);
  const char *address;
  int result;
  uint32_t addr_len;
 
  result = (int) ntohl (atsm->res);
  addr_len = ntohl (atsm->addr_len);
  if (GNUNET_SYSERR == result)
    return GNUNET_OK;
  if (0 == size)
  {
    if (GNUNET_OK != result)
    {
      GNUNET_break (0);
      return GNUNET_SYSERR;
    }
    return GNUNET_OK;
  }
  address = (const char *) &atsm[1];
  if ((addr_len > size) ||
      (address[addr_len - 1] != '\0'))
  {
    /* invalid reply */
    GNUNET_break (0);
    return GNUNET_SYSERR;
  }
  return GNUNET_OK;
}

References AddressToStringResultMessage::addr_len, address, GNUNET_break, GNUNET_OK, GNUNET_SYSERR, AddressToStringResultMessage::header, consensus-simulation::int, AddressToStringResultMessage::res, result, GNUNET_MessageHeader::size, and size.

handle_reply()

static void handle_reply ( void *  cls, const struct AddressToStringResultMessage *  atsm  )

static

Function called with responses from the service.

Parameters

cls	our struct GNUNET_TRANSPORT_AddressToStringContext *
atsm	message with the human-readable address

Definition at line 103 of file transport_api_address_to_string.c.

{
  struct GNUNET_TRANSPORT_AddressToStringContext *alucb = cls;
  uint16_t size = ntohs (atsm->header.size) - sizeof(*atsm);
  const char *address;
  int result;
 
  result = (int) ntohl (atsm->res);
  if (GNUNET_SYSERR == result)
  {
    /* expect more replies; as this is not the last
       call, we must pass the empty string for the address */
    GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
                "Address resolution failed\n");
    alucb->cb (alucb->cb_cls,
               "",
               GNUNET_NO);
    return;
  }
  if (0 == size)
  {
    /* we are done (successfully, without communication errors) */
    alucb->cb (alucb->cb_cls,
               NULL,
               GNUNET_OK);
    GNUNET_TRANSPORT_address_to_string_cancel (alucb);
    return;
  }
  address = (const char *) &atsm[1];
  /* return normal reply to caller, also expect more replies */
  alucb->cb (alucb->cb_cls,
             address,
             GNUNET_OK);
}

References address, GNUNET_TRANSPORT_AddressToStringContext::cb, GNUNET_TRANSPORT_AddressToStringContext::cb_cls, GNUNET_ERROR_TYPE_DEBUG, GNUNET_log, GNUNET_NO, GNUNET_OK, GNUNET_SYSERR, GNUNET_TRANSPORT_address_to_string_cancel(), AddressToStringResultMessage::header, consensus-simulation::int, AddressToStringResultMessage::res, result, GNUNET_MessageHeader::size, and size.

Here is the call 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	the struct GNUNET_TRANSPORT_AddressToStringContext *
error	error code

Definition at line 150 of file transport_api_address_to_string.c.

{
  struct GNUNET_TRANSPORT_AddressToStringContext *alucb = cls;
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
              "Disconnected from transport, address resolution failed\n");
  alucb->cb (alucb->cb_cls,
             NULL,
             GNUNET_SYSERR);
  GNUNET_TRANSPORT_address_to_string_cancel (alucb);
}

References GNUNET_TRANSPORT_AddressToStringContext::cb, GNUNET_TRANSPORT_AddressToStringContext::cb_cls, GNUNET_ERROR_TYPE_DEBUG, GNUNET_log, GNUNET_SYSERR, and GNUNET_TRANSPORT_address_to_string_cancel().

Referenced by GNUNET_TRANSPORT_address_to_string().

Here is the call graph for this function:

Here is the caller graph for this function: