2 This file is part of GNUnet.
3 Copyright (C) 2012, 2017 GNUnet e.V.
5 GNUnet is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published
7 by the Free Software Foundation; either version 3, or (at your
8 option) any later version.
10 GNUnet is distributed in the hope that it will be useful, but
11 WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with GNUnet; see the file COPYING. If not, write to the
17 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
18 Boston, MA 02110-1301, USA.
21 * @file cadet/cadet_test_lib.c
22 * @author Bartlomiej Polot
23 * @brief library for writing CADET tests
26 #include "gnunet_util_lib.h"
27 #include "cadet_test_lib.h"
28 #include "gnunet_cadet_service.h"
32 * Test context for a CADET Test.
34 struct GNUNET_CADET_TEST_Context
37 * Array of running peers.
39 struct GNUNET_TESTBED_Peer **peers;
42 * Array of handles to the CADET for each peer.
44 struct GNUNET_CADET_Handle **cadets;
47 * Operation associated with the connection to the CADET.
49 struct GNUNET_TESTBED_Operation **ops;
52 * Number of peers running, size of the arrays above.
54 unsigned int num_peers;
57 * Main function of the test to run once all CADETs are available.
59 GNUNET_CADET_TEST_AppMain app_main;
62 * Closure for 'app_main'.
67 * Handler for incoming tunnels.
69 GNUNET_CADET_ConnectEventHandler connects;
72 * Function called when the transmit window size changes.
74 GNUNET_CADET_WindowSizeEventHandler window_changes;
77 * Cleaner for destroyed incoming tunnels.
79 GNUNET_CADET_DisconnectEventHandler disconnects;
84 struct GNUNET_MQ_MessageHandler *handlers;
89 const struct GNUNET_HashCode **ports;
92 * Number of ports in #ports.
94 unsigned int port_count;
100 * Context for a cadet adapter callback.
102 struct GNUNET_CADET_TEST_AdapterContext
105 * Peer number for the particular peer.
110 * Port handlers for open ports.
112 struct GNUNET_CADET_Port **ports;
117 struct GNUNET_CADET_TEST_Context *ctx;
122 * Adapter function called to establish a connection to
126 * @param cfg configuration of the peer to connect to; will be available until
127 * GNUNET_TESTBED_operation_done() is called on the operation returned
128 * from GNUNET_TESTBED_service_connect()
129 * @return service handle to return in 'op_result', NULL on error
132 cadet_connect_adapter (void *cls,
133 const struct GNUNET_CONFIGURATION_Handle *cfg)
135 struct GNUNET_CADET_TEST_AdapterContext *actx = cls;
136 struct GNUNET_CADET_TEST_Context *ctx = actx->ctx;
137 struct GNUNET_CADET_Handle *h;
140 h = GNUNET_CADET_connect (cfg);
141 if (NULL == ctx->ports)
144 actx->ports = GNUNET_new_array (ctx->port_count, struct GNUNET_CADET_Port *);
145 for (i = 0; i < ctx->port_count; i++)
147 actx->ports[i] = GNUNET_CADET_open_port (h,
150 (void *) (long) actx->peer,
160 * Adapter function called to destroy a connection to
164 * @param op_result service handle returned from the connect adapter
167 cadet_disconnect_adapter (void *cls,
170 struct GNUNET_CADET_Handle *cadet = op_result;
171 struct GNUNET_CADET_TEST_AdapterContext *actx = cls;
173 if (NULL != actx->ports)
175 for (int i = 0; i < actx->ctx->port_count; i++)
177 GNUNET_CADET_close_port (actx->ports[i]);
178 actx->ports[i] = NULL;
180 GNUNET_free (actx->ports);
183 GNUNET_CADET_disconnect (cadet);
188 * Callback to be called when a service connect operation is completed.
190 * @param cls The callback closure from functions generating an operation.
191 * @param op The operation that has been finished.
192 * @param ca_result The service handle returned from
193 * GNUNET_TESTBED_ConnectAdapter() (cadet handle).
194 * @param emsg Error message in case the operation has failed.
195 * NULL if operation has executed successfully.
198 cadet_connect_cb (void *cls,
199 struct GNUNET_TESTBED_Operation *op,
203 struct GNUNET_CADET_TEST_Context *ctx = cls;
208 fprintf (stderr, "Failed to connect to CADET service: %s\n",
210 GNUNET_SCHEDULER_shutdown ();
213 for (i = 0; i < ctx->num_peers; i++)
214 if (op == ctx->ops[i])
216 ctx->cadets[i] = ca_result;
217 GNUNET_log (GNUNET_ERROR_TYPE_INFO, "...cadet %u connected\n", i);
219 for (i = 0; i < ctx->num_peers; i++)
220 if (NULL == ctx->cadets[i])
221 return; /* still some CADET connections missing */
222 /* all CADET connections ready! */
223 ctx->app_main (ctx->app_main_cls,
232 GNUNET_CADET_TEST_cleanup (struct GNUNET_CADET_TEST_Context *ctx)
236 for (i = 0; i < ctx->num_peers; i++)
238 GNUNET_assert (NULL != ctx->ops[i]);
239 GNUNET_TESTBED_operation_done (ctx->ops[i]);
242 GNUNET_free (ctx->ops);
243 GNUNET_free (ctx->cadets);
245 GNUNET_SCHEDULER_shutdown ();
250 * Callback run when the testbed is ready (peers running and connected to
253 * @param cls Closure (context).
254 * @param h the run handle
255 * @param num_peers Number of peers that are running.
256 * @param peers Handles to each one of the @c num_peers peers.
257 * @param links_succeeded the number of overlay link connection attempts that
259 * @param links_failed the number of overlay link connection attempts that
263 cadet_test_run (void *cls,
264 struct GNUNET_TESTBED_RunHandle *h,
265 unsigned int num_peers,
266 struct GNUNET_TESTBED_Peer **peers,
267 unsigned int links_succeeded,
268 unsigned int links_failed)
270 struct GNUNET_CADET_TEST_Context *ctx = cls;
273 if (0 != links_failed)
275 GNUNET_log (GNUNET_ERROR_TYPE_ERROR, "Some links failed (%u), ending\n",
280 if (num_peers != ctx->num_peers)
282 GNUNET_log (GNUNET_ERROR_TYPE_ERROR, "Peers started %u/%u, ending\n",
283 num_peers, ctx->num_peers);
287 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
288 "Testbed up, %u peers and %u links\n",
289 num_peers, links_succeeded);
291 for (i = 0; i < num_peers; i++)
293 struct GNUNET_CADET_TEST_AdapterContext *newctx;
294 newctx = GNUNET_new (struct GNUNET_CADET_TEST_AdapterContext);
297 GNUNET_log (GNUNET_ERROR_TYPE_INFO, "Connecting to cadet %u\n", i);
298 ctx->ops[i] = GNUNET_TESTBED_service_connect (ctx,
303 &cadet_connect_adapter,
304 &cadet_disconnect_adapter,
306 GNUNET_log (GNUNET_ERROR_TYPE_INFO, "op handle %p\n", ctx->ops[i]);
312 * Run a test using the given name, configuration file and number of peers.
313 * All cadet callbacks will receive the peer number (long) as the closure.
315 * @param testname Name of the test (for logging).
316 * @param cfgfile Name of the configuration file.
317 * @param num_peers Number of peers to start.
318 * @param tmain Main function to run once the testbed is ready.
319 * @param tmain_cls Closure for @a tmain.
320 * @param connects Handler for incoming channels.
321 * @param window_changes Handler for the window size change notification.
322 * @param disconnects Cleaner for destroyed incoming channels.
323 * @param handlers Message handlers.
324 * @param ports Ports the peers offer, NULL-terminated.
327 GNUNET_CADET_TEST_ruN (const char *testname,
329 unsigned int num_peers,
330 GNUNET_CADET_TEST_AppMain tmain,
332 GNUNET_CADET_ConnectEventHandler connects,
333 GNUNET_CADET_WindowSizeEventHandler window_changes,
334 GNUNET_CADET_DisconnectEventHandler disconnects,
335 struct GNUNET_MQ_MessageHandler *handlers,
336 const struct GNUNET_HashCode **ports)
338 struct GNUNET_CADET_TEST_Context *ctx;
340 ctx = GNUNET_new (struct GNUNET_CADET_TEST_Context);
341 ctx->num_peers = num_peers;
342 ctx->ops = GNUNET_new_array (num_peers, struct GNUNET_TESTBED_Operation *);
343 ctx->cadets = GNUNET_new_array (num_peers, struct GNUNET_CADET_Handle *);
344 ctx->app_main = tmain;
345 ctx->app_main_cls = tmain_cls;
346 ctx->connects = connects;
347 ctx->window_changes = window_changes;
348 ctx->disconnects = disconnects;
349 ctx->handlers = GNUNET_MQ_copy_handlers (handlers);
352 while (NULL != ctx->ports[ctx->port_count])
355 GNUNET_TESTBED_test_run (testname,
359 &cadet_test_run, ctx);
362 /* end of cadet_test_lib.c */