cadet_api_get_channel.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_channel.c:

Go to the source code of this file.

Data Structures
struct	GNUNET_CADET_ChannelMonitor
	Operation handle. More...

Functions
static int	check_channel_info (void *cls, const struct GNUNET_CADET_ChannelInfoMessage *message)
	Check that message received from CADET service is well-formed. More...
static void	handle_channel_info (void *cls, const struct GNUNET_CADET_ChannelInfoMessage *message)
	Process a local peer info reply, pass info to the user. More...
static void	handle_channel_info_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_ChannelMonitor *	GNUNET_CADET_get_channel (const struct GNUNET_CONFIGURATION_Handle *cfg, struct GNUNET_PeerIdentity *peer, GNUNET_CADET_ChannelCB callback, void *callback_cls)
	Request information about a specific channel of the running cadet peer. More...
void *	GNUNET_CADET_get_channel_cancel (struct GNUNET_CADET_ChannelMonitor *cm)
	Cancel a channel monitor request. More...

Detailed Description

cadet api: client implementation of cadet service

Author

Bartlomiej Polot

Christian Grothoff

Definition in file cadet_api_get_channel.c.

Function Documentation

check_channel_info()

static int check_channel_info ( void *  cls, const struct GNUNET_CADET_ChannelInfoMessage *  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_channel.c.

{
  (void) cls;
 
  return GNUNET_OK;
}

References GNUNET_OK.

handle_channel_info()

static void handle_channel_info ( void *  cls, const struct GNUNET_CADET_ChannelInfoMessage *  message  )

static

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

Parameters

cls	Closure
message	Message itself.

Definition at line 101 of file cadet_api_get_channel.c.

{
  struct GNUNET_CADET_ChannelMonitor *cm = cls;
  struct GNUNET_CADET_ChannelInternals ci;
 
  ci.root = message->root;
  ci.dest = message->dest;
  cm->channel_cb (cm->channel_cb_cls,
                  &ci);
  GNUNET_CADET_get_channel_cancel (cm);
}

References GNUNET_CADET_ChannelMonitor::channel_cb, GNUNET_CADET_ChannelMonitor::channel_cb_cls, GNUNET_CADET_ChannelInternals::dest, GNUNET_CADET_ChannelInfoMessage::dest, GNUNET_CADET_get_channel_cancel(), GNUNET_CADET_ChannelInternals::root, and GNUNET_CADET_ChannelInfoMessage::root.

Here is the call graph for this function:

handle_channel_info_end()

static void handle_channel_info_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 122 of file cadet_api_get_channel.c.

{
  struct GNUNET_CADET_ChannelMonitor *cm = cls;
 
  cm->channel_cb (cm->channel_cb_cls,
                  NULL);
  GNUNET_CADET_get_channel_cancel (cm);
}

References GNUNET_CADET_ChannelMonitor::channel_cb, GNUNET_CADET_ChannelMonitor::channel_cb_cls, and GNUNET_CADET_get_channel_cancel().

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_ChannelMonitor operation

Definition at line 170 of file cadet_api_get_channel.c.

{
  struct GNUNET_CADET_ChannelMonitor *cm = cls;
  struct GNUNET_MQ_MessageHandler handlers[] = {
    GNUNET_MQ_hd_fixed_size (channel_info_end,
                             GNUNET_MESSAGE_TYPE_CADET_LOCAL_INFO_CHANNEL_END,
                             struct GNUNET_MessageHeader,
                             cm),
    GNUNET_MQ_hd_var_size (channel_info,
                           GNUNET_MESSAGE_TYPE_CADET_LOCAL_INFO_CHANNEL,
                           struct GNUNET_CADET_ChannelInfoMessage,
                           cm),
    GNUNET_MQ_handler_end ()
  };
  struct GNUNET_CADET_RequestChannelInfoMessage *msg;
  struct GNUNET_MQ_Envelope *env;
 
  cm->reconnect_task = NULL;
  cm->mq = GNUNET_CLIENT_connect (cm->cfg,
                                  "cadet",
                                  handlers,
                                  &error_handler,
                                  cm);
  if (NULL == cm->mq)
    return;
  env = GNUNET_MQ_msg (msg,
                       GNUNET_MESSAGE_TYPE_CADET_LOCAL_REQUEST_INFO_CHANNEL);
  msg->target = cm->peer;
  GNUNET_MQ_send (cm->mq,
                  env);
}

References GNUNET_CADET_ChannelMonitor::cfg, env, error_handler(), GNUNET_CLIENT_connect(), GNUNET_MESSAGE_TYPE_CADET_LOCAL_INFO_CHANNEL, GNUNET_MESSAGE_TYPE_CADET_LOCAL_INFO_CHANNEL_END, GNUNET_MESSAGE_TYPE_CADET_LOCAL_REQUEST_INFO_CHANNEL, GNUNET_MQ_handler_end, GNUNET_MQ_hd_fixed_size, GNUNET_MQ_hd_var_size, GNUNET_MQ_msg, GNUNET_MQ_send(), handlers, GNUNET_CADET_ChannelMonitor::mq, msg, GNUNET_CADET_ChannelMonitor::peer, and GNUNET_CADET_ChannelMonitor::reconnect_task.

Referenced by error_handler(), and GNUNET_CADET_get_channel().

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_ChannelMonitor`
error	error code from MQ

Definition at line 149 of file cadet_api_get_channel.c.

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

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

Referenced by GNUNET_CLIENT_connect(), GNUNET_MQ_queue_for_callbacks(), and reconnect().

Here is the call graph for this function:

Here is the caller graph for this function: