cadet_api_get_path.c File Reference

cadet api: client implementation of cadet service More...

#include "platform.h"
#include "gnunet_util_lib.h"
#include "gnunet_constants.h"
#include "gnunet_cadet_service.h"
#include "cadet.h"
#include "cadet_protocol.h"

Include dependency graph for cadet_api_get_path.c:

Go to the source code of this file.

Data Structures
struct	GNUNET_CADET_GetPath
	Operation handle. More...

Functions
static int	check_get_path (void *cls, const struct GNUNET_CADET_LocalInfoPath *message)
	Check that message received from CADET service is well-formed. More...
static void	handle_get_path (void *cls, const struct GNUNET_CADET_LocalInfoPath *message)
	Process a local peer info reply, pass info to the user. More...
static void	handle_get_path_end (void *cls, const struct GNUNET_MessageHeader *message)
	Process a local peer info reply, pass info to the user. More...
static void	reconnect (void *cls)
	Reconnect to the service and try again. More...
static void	error_handler (void *cls, enum GNUNET_MQ_Error error)
	Function called on connection trouble. More...
struct GNUNET_CADET_GetPath *	GNUNET_CADET_get_path (const struct GNUNET_CONFIGURATION_Handle *cfg, const struct GNUNET_PeerIdentity *id, GNUNET_CADET_PathCB callback, void *callback_cls)
	Request information about a peer known to the running cadet peer. More...
void *	GNUNET_CADET_get_path_cancel (struct GNUNET_CADET_GetPath *gp)
	Cancel gp operation. More...

Detailed Description

cadet api: client implementation of cadet service

Author

Bartlomiej Polot

Christian Grothoff

Definition in file cadet_api_get_path.c.

Function Documentation

check_get_path()

static int check_get_path ( void *  cls, const struct GNUNET_CADET_LocalInfoPath *  message  )

static

Check that message received from CADET service is well-formed.

Parameters

cls	unused
message	the message we got

Returns

GNUNET_OK if the message is well-formed, GNUNET_SYSERR otherwise

Definition at line 85 of file cadet_api_get_path.c.

{
  size_t msize = sizeof(struct GNUNET_CADET_LocalInfoPath);
  size_t esize;
 
  (void) cls;
  esize = ntohs (message->header.size);
  if (esize < msize)
  {
    GNUNET_break (0);
    return GNUNET_SYSERR;
  }
  if (0 != ((esize - msize) % sizeof(struct GNUNET_PeerIdentity)))
  {
    GNUNET_break (0);
    return GNUNET_SYSERR;
  }
  return GNUNET_OK;
}

References GNUNET_break, GNUNET_OK, GNUNET_SYSERR, GNUNET_CADET_LocalInfoPath::header, and GNUNET_MessageHeader::size.

handle_get_path()

static void handle_get_path ( void *  cls, const struct GNUNET_CADET_LocalInfoPath *  message  )

static

Process a local peer info reply, pass info to the user.

Parameters

cls	Closure
message	Message itself.

Definition at line 114 of file cadet_api_get_path.c.

{
  struct GNUNET_CADET_GetPath *gp = cls;
  struct GNUNET_CADET_PeerPathDetail ppd;
 
  ppd.peer = gp->id;
  ppd.path = (const struct GNUNET_PeerIdentity *) &message[1];
  ppd.target_offset = ntohl (message->off);
  ppd.path_length = (ntohs (message->header.size) - sizeof(*message))
                    / sizeof(struct GNUNET_PeerIdentity);
  gp->path_cb (gp->path_cb_cls,
               &ppd);
}

References GNUNET_CADET_LocalInfoPath::header, GNUNET_CADET_GetPath::id, GNUNET_CADET_LocalInfoPath::off, GNUNET_CADET_PeerPathDetail::path, GNUNET_CADET_GetPath::path_cb, GNUNET_CADET_GetPath::path_cb_cls, GNUNET_CADET_PeerPathDetail::path_length, GNUNET_CADET_PeerPathDetail::peer, GNUNET_MessageHeader::size, and GNUNET_CADET_PeerPathDetail::target_offset.

handle_get_path_end()

static void handle_get_path_end ( void *  cls, const struct GNUNET_MessageHeader *  message  )

static

Process a local peer info reply, pass info to the user.

Parameters

cls	Closure
message	Message itself.

Definition at line 137 of file cadet_api_get_path.c.

{
  struct GNUNET_CADET_GetPath *gp = cls;
 
  (void) message;
  gp->path_cb (gp->path_cb_cls,
               NULL);
  GNUNET_CADET_get_path_cancel (gp);
}

References GNUNET_CADET_get_path_cancel(), GNUNET_CADET_GetPath::path_cb, and GNUNET_CADET_GetPath::path_cb_cls.

Here is the call graph for this function:

reconnect()

static void reconnect ( void *  cls )

static

Reconnect to the service and try again.

Parameters

cls	a struct GNUNET_CADET_GetPath operation

Definition at line 186 of file cadet_api_get_path.c.

{
  struct GNUNET_CADET_GetPath *gp = cls;
  struct GNUNET_MQ_MessageHandler handlers[] = {
    GNUNET_MQ_hd_var_size (get_path,
                           GNUNET_MESSAGE_TYPE_CADET_LOCAL_INFO_PATH,
                           struct GNUNET_CADET_LocalInfoPath,
                           gp),
    GNUNET_MQ_hd_fixed_size (get_path_end,
                             GNUNET_MESSAGE_TYPE_CADET_LOCAL_INFO_PATH_END,
                             struct GNUNET_MessageHeader,
                             gp),
    GNUNET_MQ_handler_end ()
  };
  struct GNUNET_CADET_RequestPathInfoMessage *msg;
  struct GNUNET_MQ_Envelope *env;
 
  gp->reconnect_task = NULL;
  gp->mq = GNUNET_CLIENT_connect (gp->cfg,
                                  "cadet",
                                  handlers,
                                  &error_handler,
                                  gp);
  if (NULL == gp->mq)
    return;
  env = GNUNET_MQ_msg (msg,
                       GNUNET_MESSAGE_TYPE_CADET_LOCAL_REQUEST_INFO_PATH);
  msg->peer = gp->id;
  GNUNET_MQ_send (gp->mq,
                  env);
}

References GNUNET_CADET_GetPath::cfg, env, error_handler(), GNUNET_CLIENT_connect(), GNUNET_MESSAGE_TYPE_CADET_LOCAL_INFO_PATH, GNUNET_MESSAGE_TYPE_CADET_LOCAL_INFO_PATH_END, GNUNET_MESSAGE_TYPE_CADET_LOCAL_REQUEST_INFO_PATH, GNUNET_MQ_handler_end, GNUNET_MQ_hd_fixed_size, GNUNET_MQ_hd_var_size, GNUNET_MQ_msg, GNUNET_MQ_send(), handlers, GNUNET_CADET_GetPath::id, GNUNET_CADET_GetPath::mq, msg, and GNUNET_CADET_GetPath::reconnect_task.

Referenced by error_handler(), and GNUNET_CADET_get_path().

Here is the call graph for this function:

Here is the caller graph for this function:

error_handler()

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

static

Function called on connection trouble.

Reconnects.

Parameters

cls	a struct GNUNET_CADET_GetPath
error	error code from MQ

Definition at line 165 of file cadet_api_get_path.c.

{
  struct GNUNET_CADET_GetPath *gp = cls;
 
  GNUNET_MQ_destroy (gp->mq);
  gp->mq = NULL;
  gp->backoff = GNUNET_TIME_randomized_backoff (gp->backoff,
                                                GNUNET_TIME_UNIT_MINUTES);
  gp->reconnect_task = GNUNET_SCHEDULER_add_delayed (gp->backoff,
                                                     &reconnect,
                                                     gp);
}

References GNUNET_CADET_GetPath::backoff, GNUNET_MQ_destroy(), GNUNET_SCHEDULER_add_delayed(), GNUNET_TIME_randomized_backoff(), GNUNET_TIME_UNIT_MINUTES, GNUNET_CADET_GetPath::mq, reconnect(), and GNUNET_CADET_GetPath::reconnect_task.

Referenced by reconnect().

Here is the call graph for this function:

Here is the caller graph for this function: