GNUnet  0.10.x
Typedefs | Functions
dht_test_lib.h File Reference

library for writing DHT tests More...

#include "gnunet_testbed_service.h"
#include "gnunet_dht_service.h"
Include dependency graph for dht_test_lib.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Typedefs

typedef void(* GNUNET_DHT_TEST_AppMain) (void *cls, struct GNUNET_DHT_TEST_Context *ctx, unsigned int num_peers, struct GNUNET_TESTBED_Peer **peers, struct GNUNET_DHT_Handle **dhts)
 Main function of a DHT test. More...
 

Functions

void GNUNET_DHT_TEST_run (const char *testname, const char *cfgname, unsigned int num_peers, GNUNET_DHT_TEST_AppMain tmain, void *tmain_cls)
 Run a test using the given name, configuration file and number of peers. More...
 
void GNUNET_DHT_TEST_cleanup (struct GNUNET_DHT_TEST_Context *ctx)
 Clean up the testbed. More...
 

Detailed Description

library for writing DHT tests

Author
Christian Grothoff

Definition in file dht_test_lib.h.

Typedef Documentation

◆ GNUNET_DHT_TEST_AppMain

typedef void(* GNUNET_DHT_TEST_AppMain) (void *cls, struct GNUNET_DHT_TEST_Context *ctx, unsigned int num_peers, struct GNUNET_TESTBED_Peer **peers, struct GNUNET_DHT_Handle **dhts)

Main function of a DHT test.

Parameters
clsclosure
ctxargument to give to GNUNET_DHT_TEST_cleanup on test end
num_peersnumber of peers that are running
peersarray of peers
dhtshandle to each of the DHTs of the peers

Definition at line 54 of file dht_test_lib.h.

Function Documentation

◆ GNUNET_DHT_TEST_run()

void GNUNET_DHT_TEST_run ( const char *  testname,
const char *  cfgname,
unsigned int  num_peers,
GNUNET_DHT_TEST_AppMain  tmain,
void *  tmain_cls 
)

Run a test using the given name, configuration file and number of peers.

Parameters
testnamename of the test (for logging)
cfgnamename of the configuration file
num_peersnumber of peers to start
tmainmain function to run once the testbed is ready
tmain_clsclosure for 'tmain'

Definition at line 192 of file dht_test_lib.c.

References GNUNET_DHT_TEST_Context::app_main, GNUNET_DHT_TEST_Context::app_main_cls, ctx, dht_test_run(), GNUNET_DHT_TEST_Context::dhts, GNUNET_new, GNUNET_new_array, GNUNET_TESTBED_test_run(), GNUNET_DHT_TEST_Context::num_peers, GNUNET_DHT_TEST_Context::ops, and tmain().

197 {
199 
200  ctx = GNUNET_new(struct GNUNET_DHT_TEST_Context);
201  ctx->num_peers = num_peers;
203  struct GNUNET_TESTBED_Operation *);
205  struct GNUNET_DHT_Handle *);
206  ctx->app_main = tmain;
207  ctx->app_main_cls = tmain_cls;
208  (void)GNUNET_TESTBED_test_run(testname,
209  cfgname,
210  num_peers,
211  0LL, NULL, NULL,
212  &dht_test_run, ctx);
213 }
static void dht_test_run(void *cls, struct GNUNET_TESTBED_RunHandle *h, unsigned int num_peers, struct GNUNET_TESTBED_Peer **peers, unsigned int links_succeeded, unsigned int links_failed)
Definition: dht_test_lib.c:158
int GNUNET_TESTBED_test_run(const char *testname, const char *cfg_filename, unsigned int num_peers, uint64_t event_mask, GNUNET_TESTBED_ControllerCallback cc, void *cc_cls, GNUNET_TESTBED_TestMaster test_master, void *test_master_cls)
Convenience method for running a "simple" test on the local system with a single call from 'main'...
unsigned int num_peers
Number of peers running, size of the arrays above.
Definition: dht_test_lib.c:60
#define GNUNET_new(type)
Allocate a struct or union of the given type.
Test context for a DHT Test.
Definition: dht_test_lib.c:31
static struct GNUNET_DNSSTUB_Context * ctx
Context for DNS resolution.
Connection to the DHT service.
Definition: dht_api.c:198
Opaque handle to an abstract operation to be executed by the testing framework.
static void tmain(void *cls, struct GNUNET_CADET_TEST_Context *ctx, unsigned int num_peers, struct GNUNET_TESTBED_Peer **testbed_peers, struct GNUNET_CADET_Handle **cadetes)
test main: start test when all peers are connected
#define GNUNET_new_array(n, type)
Allocate a size n array with structs or unions of the given type.
static unsigned int num_peers
struct GNUNET_DHT_Handle ** dhts
Array of handles to the DHT for each peer.
Definition: dht_test_lib.c:40
void * app_main_cls
Closure for 'app_main'.
Definition: dht_test_lib.c:55
struct GNUNET_TESTBED_Operation ** ops
Operation associated with the connection to the DHT.
Definition: dht_test_lib.c:45
GNUNET_DHT_TEST_AppMain app_main
Main function of the test to run once all DHTs are available.
Definition: dht_test_lib.c:50
Here is the call graph for this function:

◆ GNUNET_DHT_TEST_cleanup()

void GNUNET_DHT_TEST_cleanup ( struct GNUNET_DHT_TEST_Context ctx)

Clean up the testbed.

Parameters
ctxhandle for the testbed

Definition at line 146 of file dht_test_lib.c.

References GNUNET_DHT_TEST_Context::dhts, GNUNET_free, GNUNET_SCHEDULER_shutdown(), GNUNET_TESTBED_operation_done(), GNUNET_DHT_TEST_Context::num_peers, and GNUNET_DHT_TEST_Context::ops.

147 {
148  for (unsigned int i = 0; i < ctx->num_peers; i++)
150  GNUNET_free(ctx->ops);
151  GNUNET_free(ctx->dhts);
152  GNUNET_free(ctx);
154 }
unsigned int num_peers
Number of peers running, size of the arrays above.
Definition: dht_test_lib.c:60
void GNUNET_SCHEDULER_shutdown(void)
Request the shutdown of a scheduler.
Definition: scheduler.c:517
void GNUNET_TESTBED_operation_done(struct GNUNET_TESTBED_Operation *operation)
This function is used to signal that the event information (struct GNUNET_TESTBED_EventInformation) f...
Definition: testbed_api.c:2037
struct GNUNET_DHT_Handle ** dhts
Array of handles to the DHT for each peer.
Definition: dht_test_lib.c:40
struct GNUNET_TESTBED_Operation ** ops
Operation associated with the connection to the DHT.
Definition: dht_test_lib.c:45
#define GNUNET_free(ptr)
Wrapper around free.
Here is the call graph for this function: