2 This file is part of GNUnet.
3 Copyright (C) 2006, 2009, 2015 Christian Grothoff (and other contributing authors)
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.
22 * @file transport-testing.h
23 * @brief testing lib for transport service
25 * @author Matthias Wachs
28 #include "gnunet_util_lib.h"
29 #include "gnunet_hello_lib.h"
30 #include "gnunet_transport_service.h"
31 #include "gnunet_testing_lib.h"
34 struct GNUNET_TRANSPORT_TESTING_ConnectRequest;
38 * Context for a single peer
43 * Callback when two peers are connected and both have called the connect callback
44 * to notify clients about a new peer
47 (*GNUNET_TRANSPORT_TESTING_start_cb) (struct PeerContext *p,
51 * Callback when two peers are connected and both have called the connect callback
52 * to notify clients about a new peer
55 (*GNUNET_TRANSPORT_TESTING_connect_cb) (struct PeerContext *p1,
56 struct PeerContext *p2,
61 * Definition for a transport testing handle
63 struct GNUNET_TRANSPORT_TESTING_handle;
66 * Context for a single peer
71 * Next element in the DLL
73 struct PeerContext *next;
76 * Previous element in the DLL
78 struct PeerContext *prev;
81 * Transport testing handle this peer belongs to
83 struct GNUNET_TRANSPORT_TESTING_handle *tth;
86 * Peer's configuration
88 struct GNUNET_CONFIGURATION_Handle *cfg;
91 * Peer's transport service handle
93 struct GNUNET_TRANSPORT_Handle *th;
96 * Peer's transport get hello handle to retrieve peer's HELLO message
98 struct GNUNET_TRANSPORT_GetHelloHandle *ghh;
101 * Peer's testing handle
103 struct GNUNET_TESTING_Peer *peer;
108 struct GNUNET_PeerIdentity id;
111 * Handle for the peer's ARM process
113 struct GNUNET_OS_Process *arm_proc;
118 GNUNET_TRANSPORT_ReceiveCallback rec;
121 * Notify connect callback
123 GNUNET_TRANSPORT_NotifyConnect nc;
126 * Notify disconnect callback
128 GNUNET_TRANSPORT_NotifyDisconnect nd;
131 * Startup completed callback
133 GNUNET_TRANSPORT_TESTING_start_cb start_cb;
136 * Peers HELLO Message
138 struct GNUNET_HELLO_Message *hello;
141 * Closure for the callbacks
146 * An unique number to identify the peer
152 struct GNUNET_TRANSPORT_TESTING_ConnectRequest
154 struct GNUNET_TRANSPORT_TESTING_ConnectRequest *next;
155 struct GNUNET_TRANSPORT_TESTING_ConnectRequest *prev;
156 struct PeerContext *p1;
157 struct PeerContext *p2;
158 struct GNUNET_SCHEDULER_Task *tct;
159 GNUNET_TRANSPORT_TESTING_connect_cb cb;
161 struct GNUNET_TRANSPORT_Handle *th_p1;
162 struct GNUNET_TRANSPORT_Handle *th_p2;
167 struct GNUNET_TRANSPORT_TESTING_handle
170 * Testing library system handle
172 struct GNUNET_TESTING_System *tl_system;
175 * head DLL of connect contexts
177 struct GNUNET_TRANSPORT_TESTING_ConnectRequest *cc_head;
180 * head DLL of connect contexts
182 struct GNUNET_TRANSPORT_TESTING_ConnectRequest *cc_tail;
187 struct PeerContext *p_head;
192 struct PeerContext *p_tail;
197 * Start a peer with the given configuration
199 * @param tth the testing handle
200 * @param cfgname configuration file
201 * @param peer_id the peer_id
202 * @param rec receive callback
203 * @param nc connect callback
204 * @param nd disconnect callback
205 * @param start_cb start callback
206 * @param cb_cls closure for callback
207 * @return the peer context
210 GNUNET_TRANSPORT_TESTING_start_peer (struct GNUNET_TRANSPORT_TESTING_handle *tth,
213 GNUNET_TRANSPORT_ReceiveCallback rec,
214 GNUNET_TRANSPORT_NotifyConnect nc,
215 GNUNET_TRANSPORT_NotifyDisconnect nd,
216 GNUNET_TRANSPORT_TESTING_start_cb start_cb,
221 * shutdown the given peer
223 * @param tth the testing handle
227 GNUNET_TRANSPORT_TESTING_stop_peer (struct GNUNET_TRANSPORT_TESTING_handle *tth,
228 struct PeerContext *pc);
232 * Restart the given peer
234 * @param tth testing handle
236 * @param cfgname the cfg file used to restart
237 * @param restart_cb restart callback
238 * @param cb_cls callback closure
239 * @return #GNUNET_OK in success otherwise #GNUNET_SYSERR
242 GNUNET_TRANSPORT_TESTING_restart_peer (struct GNUNET_TRANSPORT_TESTING_handle *tth,
243 struct PeerContext *p,
245 GNUNET_TRANSPORT_TESTING_start_cb restart_cb,
250 * Connect the given peers and call the callback when both peers report the
251 * inbound connection. Remarks: start_peer's notify_connect callback can be called
254 * @param tth transport testing handle
257 * @param cb the callback to call when both peers notified that they are connected
258 * @param cls callback cls
259 * @return a connect request handle
261 struct GNUNET_TRANSPORT_TESTING_ConnectRequest *
262 GNUNET_TRANSPORT_TESTING_connect_peers (struct GNUNET_TRANSPORT_TESTING_handle *tth,
263 struct PeerContext *p1,
264 struct PeerContext *p2,
265 GNUNET_TRANSPORT_TESTING_connect_cb cb,
270 * Cancel the request to connect two peers
271 * Tou MUST cancel the request if you stop the peers before the peers connected succesfully
273 * @param cc a connect request handle
276 GNUNET_TRANSPORT_TESTING_connect_peers_cancel (struct GNUNET_TRANSPORT_TESTING_handle *tth,
277 struct GNUNET_TRANSPORT_TESTING_ConnectRequest *cc);
280 * Clean up the transport testing
281 * @param tth transport testing handle
284 GNUNET_TRANSPORT_TESTING_done (struct GNUNET_TRANSPORT_TESTING_handle *tth);
287 * Initialize the transport testing
288 * @return transport testing handle
290 struct GNUNET_TRANSPORT_TESTING_handle *
291 GNUNET_TRANSPORT_TESTING_init (void);
294 * Some utility functions
298 * Extracts the test filename from an absolute file name and removes the extension
299 * @param file absolute file name
300 * @param dest where to store result
303 GNUNET_TRANSPORT_TESTING_get_test_name (const char *file,
307 * This function takes the filename (e.g. argv[0), removes a "lt-"-prefix and
308 * if existing ".exe"-prefix and adds the peer-number
310 * @param file filename of the test, e.g. argv[0]
311 * @param dest where to write the filename
312 * @param count peer number
315 GNUNET_TRANSPORT_TESTING_get_config_name (const char *file,
321 * Extracts the plugin anme from an absolute file name and the test name
322 * @param file absolute file name
323 * @param test test name
324 * @param dest where to store result
327 GNUNET_TRANSPORT_TESTING_get_test_plugin_name (const char *executable,
328 const char *testname,
333 * Extracts the filename from an absolute file name and removes the extenstion
334 * @param file absolute file name
335 * @param dest where to store result
338 GNUNET_TRANSPORT_TESTING_get_test_source_name (const char *file,
341 /* end of transport_testing.h */