transport-testing-cmds.h File Reference

#include "gnunet_testing_ng_lib.h"
#include "gnunet_testing_plugin.h"

Include dependency graph for transport-testing-cmds.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	ConnectPeersState
	Struct to store information needed in callbacks. More...
struct	StartPeerState
struct	TestState

Macros
#define	GNUNET_TRANSPORT_MAKE_DECL_SIMPLE_TRAIT(name, type)
	Create headers for a trait with name name for statically allocated data of type type. More...
#define	GNUNET_TRANSPORT_MAKE_IMPL_SIMPLE_TRAIT(name, type)
	Create C implementation for a trait with name name for statically allocated data of type type. More...
#define	GNUNET_TRANSPORT_SIMPLE_TRAITS(op)
	Call op on all simple traits. More...

Typedefs
typedef void *(*	GNUNET_TRANSPORT_notify_connect_cb) (struct GNUNET_TESTING_Interpreter *is, const struct GNUNET_PeerIdentity *peer)

Functions
struct GNUNET_TESTING_Command	GNUNET_TRANSPORT_cmd_start_peer (const char *label, const char *system_label, uint32_t no, const char *node_ip, struct GNUNET_MQ_MessageHandler *handlers, const char *cfgname, GNUNET_TRANSPORT_notify_connect_cb notify_connect, unsigned int broadcast)
	Create command. More...
struct GNUNET_TESTING_Command	GNUNET_TRANSPORT_cmd_stop_peer (const char *label, const char *start_label)
	Create command. More...
struct GNUNET_TESTING_Command	GNUNET_TRANSPORT_cmd_connect_peers (const char *label, const char *start_peer_label, const char *create_label, uint32_t num, struct GNUNET_TESTING_NetjailTopology *topology, unsigned int additional_connects)
	Create command. More...
struct GNUNET_TESTING_Command	GNUNET_TRANSPORT_cmd_send_simple (const char *label, const char *start_peer_label, const char *create_label, uint32_t num, struct GNUNET_TESTING_NetjailTopology *topology)
	Create command. More...
struct GNUNET_TESTING_Command	GNUNET_TRANSPORT_cmd_send_simple_performance (const char *label, const char *start_peer_label, const char *create_label, uint32_t num, int size, int max_send, struct GNUNET_TESTING_NetjailTopology *topology)
struct GNUNET_TESTING_Command	GNUNET_TRANSPORT_cmd_backchannel_check (const char *label, const char *start_peer_label, const char *create_label, uint32_t num, unsigned int node_n, unsigned int namespace_n, struct GNUNET_TESTING_NetjailTopology *topology)
	Create command. More...
enum GNUNET_GenericReturnValue	GNUNET_TRANSPORT_get_trait_peer_id (const struct GNUNET_TESTING_Command *cmd, const struct GNUNET_PeerIdentity **ret)
struct GNUNET_TESTING_Trait	GNUNET_TRANSPORT_make_trait_peer_id (const struct GNUNET_PeerIdentity *value)
enum GNUNET_GenericReturnValue	GNUNET_TRANSPORT_get_trait_connected_peers_map (const struct GNUNET_TESTING_Command *cmd, const struct GNUNET_CONTAINER_MultiShortmap **ret)
struct GNUNET_TESTING_Trait	GNUNET_TRANSPORT_make_trait_connected_peers_map (const struct GNUNET_CONTAINER_MultiShortmap *value)
enum GNUNET_GenericReturnValue	GNUNET_TRANSPORT_get_trait_hello_size (const struct GNUNET_TESTING_Command *cmd, const size_t **ret)
struct GNUNET_TESTING_Trait	GNUNET_TRANSPORT_make_trait_hello_size (const size_t *value)
enum GNUNET_GenericReturnValue	GNUNET_TRANSPORT_get_trait_hello (const struct GNUNET_TESTING_Command *cmd, const char **ret)
struct GNUNET_TESTING_Trait	GNUNET_TRANSPORT_make_trait_hello (const char *value)
enum GNUNET_GenericReturnValue	GNUNET_TRANSPORT_get_trait_application_handle (const struct GNUNET_TESTING_Command *cmd, const struct GNUNET_TRANSPORT_ApplicationHandle **ret)
struct GNUNET_TESTING_Trait	GNUNET_TRANSPORT_make_trait_application_handle (const struct GNUNET_TRANSPORT_ApplicationHandle *value)
enum GNUNET_GenericReturnValue	GNUNET_TRANSPORT_get_trait_connect_peer_state (const struct GNUNET_TESTING_Command *cmd, const struct ConnectPeersState **ret)
struct GNUNET_TESTING_Trait	GNUNET_TRANSPORT_make_trait_connect_peer_state (const struct ConnectPeersState *value)
enum GNUNET_GenericReturnValue	GNUNET_TRANSPORT_get_trait_state (const struct GNUNET_TESTING_Command *cmd, const struct StartPeerState **ret)
struct GNUNET_TESTING_Trait	GNUNET_TRANSPORT_make_trait_state (const struct StartPeerState *value)
enum GNUNET_GenericReturnValue	GNUNET_TRANSPORT_get_trait_broadcast (const struct GNUNET_TESTING_Command *cmd, const enum GNUNET_GenericReturnValue **ret)
struct GNUNET_TESTING_Trait	GNUNET_TRANSPORT_make_trait_broadcast (const enum GNUNET_GenericReturnValue *value)

Macro Definition Documentation

GNUNET_TRANSPORT_MAKE_DECL_SIMPLE_TRAIT

#define GNUNET_TRANSPORT_MAKE_DECL_SIMPLE_TRAIT	(		name,
			type
	)

Value:

  enum GNUNET_GenericReturnValue                          \
    GNUNET_TRANSPORT_get_trait_ ## name (                    \
    const struct GNUNET_TESTING_Command *cmd,              \
    type **ret);                                          \
  struct GNUNET_TESTING_Trait                              \
    GNUNET_TRANSPORT_make_trait_ ## name (                   \
    type * value);

Create headers for a trait with name name for statically allocated data of type type.

Definition at line 357 of file transport-testing-cmds.h.

GNUNET_TRANSPORT_MAKE_IMPL_SIMPLE_TRAIT

#define GNUNET_TRANSPORT_MAKE_IMPL_SIMPLE_TRAIT	(		name,
			type
	)

Value:

  enum GNUNET_GenericReturnValue                         \
    GNUNET_TRANSPORT_get_trait_ ## name (                   \
    const struct GNUNET_TESTING_Command *cmd,             \
    type **ret)                                          \
  {                                                      \
    if (NULL == cmd->traits) return GNUNET_SYSERR;       \
    return cmd->traits (cmd->cls,                        \
                        (const void **) ret,             \
                        GNUNET_S (name),                  \
                        0);                              \
  }                                                      \
  struct GNUNET_TESTING_Trait                             \
    GNUNET_TRANSPORT_make_trait_ ## name (                  \
    type * value)                                        \
  {                                                      \
    struct GNUNET_TESTING_Trait ret = {                   \
      .trait_name = GNUNET_S (name),                      \
      .ptr = (const void *) value                        \
    };                                                   \
    return ret;                                          \
  }

Create C implementation for a trait with name name for statically allocated data of type type.

Definition at line 371 of file transport-testing-cmds.h.

GNUNET_TRANSPORT_SIMPLE_TRAITS

#define GNUNET_TRANSPORT_SIMPLE_TRAITS

(

op

)

Value:

  op (peer_id, const struct GNUNET_PeerIdentity) \
  op (connected_peers_map, const struct GNUNET_CONTAINER_MultiShortmap) \
  op (hello_size, const size_t) \
  op (hello, const char) \
  op (application_handle, const struct GNUNET_TRANSPORT_ApplicationHandle) \
  op (connect_peer_state, const struct ConnectPeersState) \
  op (state, const struct StartPeerState) \
  op (broadcast, const enum GNUNET_GenericReturnValue)

Call op on all simple traits.

Definition at line 398 of file transport-testing-cmds.h.

Typedef Documentation

GNUNET_TRANSPORT_notify_connect_cb

typedef void*(* GNUNET_TRANSPORT_notify_connect_cb) (struct GNUNET_TESTING_Interpreter *is, const struct GNUNET_PeerIdentity *peer)

Definition at line 32 of file transport-testing-cmds.h.

Function Documentation

GNUNET_TRANSPORT_cmd_start_peer()

struct GNUNET_TESTING_Command GNUNET_TRANSPORT_cmd_start_peer	(	const char *	label,
		const char *	system_label,
		uint32_t	no,
		const char *	node_ip,
		struct GNUNET_MQ_MessageHandler *	handlers,
		const char *	cfgname,
		GNUNET_TRANSPORT_notify_connect_cb	notify_connect,
		unsigned int	broadcast
	)

Create command.

Parameters

label	name for command.
system_label	Label of the cmd to setup a test environment.
no	Decimal number representing the last byte of the IP address of this peer.
node_ip	The IP address of this node.
handlers	Handler for messages received by this peer.
cfgname	Configuration file name for this peer.
notify_connect	Method which will be called, when a peer connects.
broadcast	Flag indicating, if broadcast should be switched on.

Returns

command.

Definition at line 408 of file transport_api_cmd_start_peer.c.

{
  struct StartPeerState *sps;
  struct GNUNET_CONTAINER_MultiShortmap *connected_peers_map =
    GNUNET_CONTAINER_multishortmap_create (1,GNUNET_NO);
  unsigned int i;
 
  sps = GNUNET_new (struct StartPeerState);
  sps->no = no;
  sps->system_label = GNUNET_strdup (system_label);
  sps->connected_peers_map = connected_peers_map;
  sps->cfgname = GNUNET_strdup (cfgname);
  sps->node_ip = GNUNET_strdup (node_ip);
  sps->notify_connect = notify_connect;
  sps->broadcast = broadcast;
 
  if (NULL != handlers)
  {
    for (i = 0; NULL != handlers[i].cb; i++)
      ;
    sps->handlers = GNUNET_new_array (i + 1,
                                      struct GNUNET_MQ_MessageHandler);
    GNUNET_memcpy (sps->handlers,
                   handlers,
                   i * sizeof(struct GNUNET_MQ_MessageHandler));
  }
  return GNUNET_TESTING_command_new (sps,
                                     label,
                                     &start_peer_run,
                                     &start_peer_cleanup,
                                     &start_peer_traits,
                                     &sps->ac);
}

GNUNET_TRANSPORT_cmd_stop_peer()

struct GNUNET_TESTING_Command GNUNET_TRANSPORT_cmd_stop_peer	(	const char *	label,
		const char *	start_label
	)

Create command.

Parameters

label	name for command.
start_label	Label of the cmd to start the peer.

Returns

command.

Definition at line 124 of file transport_api_cmd_stop_peer.c.

{
  struct StopPeerState *sps;
 
  sps = GNUNET_new (struct StopPeerState);
  sps->start_label = start_label;
  return GNUNET_TESTING_command_new (sps,
                                     label,
                                     &stop_peer_run,
                                     &stop_peer_cleanup,
                                     &stop_peer_traits,
                                     NULL);
}

GNUNET_TRANSPORT_cmd_connect_peers()

struct GNUNET_TESTING_Command GNUNET_TRANSPORT_cmd_connect_peers	(	const char *	label,
		const char *	start_peer_label,
		const char *	create_label,
		uint32_t	num,
		struct GNUNET_TESTING_NetjailTopology *	topology,
		unsigned int	additional_connects
	)

Create command.

Parameters

label	name for command
start_peer_label	Label of the cmd to start a peer.
create_label	Label of the cmd which started the test system.
num	Number globally identifying the node.
topology	The topology for the test setup.
additional_connects	Number of additional connects this cmd will wait for not triggered by this cmd.

Returns

command.

Definition at line 218 of file transport_api_cmd_connecting_peers.c.

{
  struct ConnectPeersState *cps;
  unsigned int node_additional_connects;
 
  node_additional_connects = GNUNET_TESTING_get_additional_connects (num,
                                                                     topology);
 
  LOG (GNUNET_ERROR_TYPE_DEBUG,
       "global: %u and local: %u additional_connects\n",
       additional_connects,
       node_additional_connects);
 
  if (0 != node_additional_connects)
    additional_connects = node_additional_connects;
 
  cps = GNUNET_new (struct ConnectPeersState);
  cps->start_peer_label = start_peer_label;
  cps->num = num;
  cps->create_label = create_label;
  cps->topology = topology;
  cps->notify_connect = notify_connect;
  cps->additional_connects = additional_connects;
 
  return GNUNET_TESTING_command_new (cps,
                                     label,
                                     &connect_peers_run,
                                     &connect_peers_cleanup,
                                     &connect_peers_traits,
                                     &cps->ac);
}

GNUNET_TRANSPORT_cmd_send_simple()

struct GNUNET_TESTING_Command GNUNET_TRANSPORT_cmd_send_simple	(	const char *	label,
		const char *	start_peer_label,
		const char *	create_label,
		uint32_t	num,
		struct GNUNET_TESTING_NetjailTopology *	topology
	)

Create command.

Parameters

label	name for command.
start_peer_label	Label of the cmd to start a peer.
create_label	Label of the cmd which started the test system.
num	Number globally identifying the node.
topology	The topology for the test setup.

Returns

command.

Definition at line 114 of file transport_api_cmd_send_simple.c.

{
  struct SendSimpleState *sss;
 
  sss = GNUNET_new (struct SendSimpleState);
  sss->num = num;
  sss->start_peer_label = start_peer_label;
  sss->create_label = create_label;
  sss->topology = topology;
 
  return GNUNET_TESTING_command_new (sss,
                                     label,
                                     &send_simple_run,
                                     &send_simple_cleanup,
                                     NULL,
                                     NULL);
}

GNUNET_TRANSPORT_cmd_send_simple_performance()

struct GNUNET_TESTING_Command GNUNET_TRANSPORT_cmd_send_simple_performance	(	const char *	label,
		const char *	start_peer_label,
		const char *	create_label,
		uint32_t	num,
		int	size,
		int	max_send,
		struct GNUNET_TESTING_NetjailTopology *	topology
	)

Parameters

label	name for command.
start_peer_label	Label of the cmd to start a peer.
create_label	Label of the cmd which started the test system.
num	Number globally identifying the node.
size	The size of the test message to send.
max_send	The number of messages to send.
topology	The topology for the test setup.

Returns

command.

Definition at line 164 of file transport_api_cmd_send_simple_performance.c.

{
  struct SendSimplePerfState *sss;
  struct GNUNET_TESTING_Command cmd;
 
  sss = GNUNET_new (struct SendSimplePerfState);
  sss->start_peer_label = start_peer_label;
  sss->create_label = create_label;
  sss->topology = topology;
  sss->size = size;
  sss->max_send = max_send;
 
  cmd = GNUNET_TESTING_command_new (sss,
                                    label,
                                    &send_simple_run,
                                    &send_simple_cleanup,
                                    NULL,
                                    &sss->ac);
  cmd.asynchronous_finish = GNUNET_YES;
  return cmd;
}

GNUNET_TRANSPORT_cmd_backchannel_check()

struct GNUNET_TESTING_Command GNUNET_TRANSPORT_cmd_backchannel_check	(	const char *	label,
		const char *	start_peer_label,
		const char *	create_label,
		uint32_t	num,
		unsigned int	node_n,
		unsigned int	namespace_n,
		struct GNUNET_TESTING_NetjailTopology *	topology
	)

Create command.

Parameters

label	name for command.
start_peer_label	Label of the cmd to start a peer.
create_label	Label of the cmd to create the testing system.
num	Number globally identifying the node.
node_n	The number of the node in a network namespace.
namespace_n	The number of the network namespace.
topology	The topology for the test setup.

Returns

command.

Definition at line 520 of file transport_api_cmd_backchannel_check.c.

{
  struct CheckState *cs;
 
  cs = GNUNET_new (struct CheckState);
  cs->start_peer_label = start_peer_label;
  cs->num = num;
  cs->create_label = create_label;
  cs->topology = topology;
  cs->node_n = node_n;
  cs->namespace_n = namespace_n;
 
  return GNUNET_TESTING_command_new (cs,
                                     label,
                                     &backchannel_check_run,
                                     &backchannel_check_cleanup,
                                     &backchannel_check_traits,
                                     &cs->ac);
}

GNUNET_TRANSPORT_get_trait_peer_id()

enum GNUNET_GenericReturnValue GNUNET_TRANSPORT_get_trait_peer_id	(	const struct GNUNET_TESTING_Command *	cmd,
		const struct GNUNET_PeerIdentity **	ret
	)

Definition at line 1 of file transport_api_traits.c.

GNUNET_TRANSPORT_make_trait_peer_id()

struct GNUNET_TESTING_Trait GNUNET_TRANSPORT_make_trait_peer_id

(

const struct GNUNET_PeerIdentity *

value

)

Definition at line 1 of file transport_api_traits.c.

Referenced by start_peer_traits().

Here is the caller graph for this function:

GNUNET_TRANSPORT_get_trait_connected_peers_map()

enum GNUNET_GenericReturnValue GNUNET_TRANSPORT_get_trait_connected_peers_map	(	const struct GNUNET_TESTING_Command *	cmd,
		const struct GNUNET_CONTAINER_MultiShortmap **	ret
	)

Definition at line 1 of file transport_api_traits.c.

Referenced by send_simple_run().

Here is the caller graph for this function:

GNUNET_TRANSPORT_make_trait_connected_peers_map()

struct GNUNET_TESTING_Trait GNUNET_TRANSPORT_make_trait_connected_peers_map

(

const struct GNUNET_CONTAINER_MultiShortmap *

value

)

Definition at line 1 of file transport_api_traits.c.

Referenced by start_peer_traits().

Here is the caller graph for this function:

GNUNET_TRANSPORT_get_trait_hello_size()

enum GNUNET_GenericReturnValue GNUNET_TRANSPORT_get_trait_hello_size	(	const struct GNUNET_TESTING_Command *	cmd,
		const size_t **	ret
	)

Definition at line 1 of file transport_api_traits.c.

GNUNET_TRANSPORT_make_trait_hello_size()

struct GNUNET_TESTING_Trait GNUNET_TRANSPORT_make_trait_hello_size

(

const size_t *

value

)

Definition at line 1 of file transport_api_traits.c.

Referenced by start_peer_traits().

Here is the caller graph for this function:

GNUNET_TRANSPORT_get_trait_hello()

enum GNUNET_GenericReturnValue GNUNET_TRANSPORT_get_trait_hello	(	const struct GNUNET_TESTING_Command *	cmd,
		const char **	ret
	)

Definition at line 1 of file transport_api_traits.c.

GNUNET_TRANSPORT_make_trait_hello()

struct GNUNET_TESTING_Trait GNUNET_TRANSPORT_make_trait_hello

(

const char *

value

)

Definition at line 1 of file transport_api_traits.c.

Referenced by start_peer_traits().

Here is the caller graph for this function:

GNUNET_TRANSPORT_get_trait_application_handle()

enum GNUNET_GenericReturnValue GNUNET_TRANSPORT_get_trait_application_handle	(	const struct GNUNET_TESTING_Command *	cmd,
		const struct GNUNET_TRANSPORT_ApplicationHandle **	ret
	)

Definition at line 1 of file transport_api_traits.c.

Referenced by backchannel_check_run(), and connect_peers_run().

Here is the caller graph for this function:

GNUNET_TRANSPORT_make_trait_application_handle()

struct GNUNET_TESTING_Trait GNUNET_TRANSPORT_make_trait_application_handle

(

const struct GNUNET_TRANSPORT_ApplicationHandle *

value

)

Definition at line 1 of file transport_api_traits.c.

Referenced by start_peer_traits().

Here is the caller graph for this function:

GNUNET_TRANSPORT_get_trait_connect_peer_state()

enum GNUNET_GenericReturnValue GNUNET_TRANSPORT_get_trait_connect_peer_state	(	const struct GNUNET_TESTING_Command *	cmd,
		const struct ConnectPeersState **	ret
	)

Definition at line 1 of file transport_api_traits.c.

GNUNET_TRANSPORT_make_trait_connect_peer_state()

struct GNUNET_TESTING_Trait GNUNET_TRANSPORT_make_trait_connect_peer_state

(

const struct ConnectPeersState *

value

)

Definition at line 1 of file transport_api_traits.c.

GNUNET_TRANSPORT_get_trait_state()

enum GNUNET_GenericReturnValue GNUNET_TRANSPORT_get_trait_state	(	const struct GNUNET_TESTING_Command *	cmd,
		const struct StartPeerState **	ret
	)

Definition at line 1 of file transport_api_traits.c.

Referenced by stop_peer_run().

Here is the caller graph for this function:

GNUNET_TRANSPORT_make_trait_state()

struct GNUNET_TESTING_Trait GNUNET_TRANSPORT_make_trait_state

(

const struct StartPeerState *

value

)

Definition at line 1 of file transport_api_traits.c.

Referenced by start_peer_traits().

Here is the caller graph for this function:

GNUNET_TRANSPORT_get_trait_broadcast()

enum GNUNET_GenericReturnValue GNUNET_TRANSPORT_get_trait_broadcast	(	const struct GNUNET_TESTING_Command *	cmd,
		const enum GNUNET_GenericReturnValue **	ret
	)

Definition at line 1 of file transport_api_traits.c.

Referenced by connect_peers_run().

Here is the caller graph for this function:

GNUNET_TRANSPORT_make_trait_broadcast()

struct GNUNET_TESTING_Trait GNUNET_TRANSPORT_make_trait_broadcast

(

const enum GNUNET_GenericReturnValue *

value

)

Definition at line 1 of file transport_api_traits.c.

Referenced by start_peer_traits().

Here is the caller graph for this function: