summaryrefslogtreecommitdiff
path: root/src/transport/transport-testing.h
diff options
context:
space:
mode:
Diffstat (limited to 'src/transport/transport-testing.h')
-rw-r--r--src/transport/transport-testing.h81
1 files changed, 37 insertions, 44 deletions
diff --git a/src/transport/transport-testing.h b/src/transport/transport-testing.h
index 83bbf277b..fc39646b2 100644
--- a/src/transport/transport-testing.h
+++ b/src/transport/transport-testing.h
@@ -16,7 +16,7 @@
16 along with this program. If not, see <http://www.gnu.org/licenses/>. 16 along with this program. If not, see <http://www.gnu.org/licenses/>.
17 17
18 SPDX-License-Identifier: AGPL3.0-or-later 18 SPDX-License-Identifier: AGPL3.0-or-later
19*/ 19 */
20 20
21/** 21/**
22 * @file transport-testing.h 22 * @file transport-testing.h
@@ -51,8 +51,7 @@ struct GNUNET_TRANSPORT_TESTING_Handle;
51/** 51/**
52 * Context for a single peer 52 * Context for a single peer
53 */ 53 */
54struct GNUNET_TRANSPORT_TESTING_PeerContext 54struct GNUNET_TRANSPORT_TESTING_PeerContext {
55{
56 /** 55 /**
57 * Next element in the DLL 56 * Next element in the DLL
58 */ 57 */
@@ -153,8 +152,7 @@ struct GNUNET_TRANSPORT_TESTING_PeerContext
153/** 152/**
154 * Handle for a request to connect two peers. 153 * Handle for a request to connect two peers.
155 */ 154 */
156struct GNUNET_TRANSPORT_TESTING_ConnectRequest 155struct GNUNET_TRANSPORT_TESTING_ConnectRequest {
157{
158 /** 156 /**
159 * Kept in a DLL. 157 * Kept in a DLL.
160 */ 158 */
@@ -226,8 +224,7 @@ struct GNUNET_TRANSPORT_TESTING_ConnectRequest
226/** 224/**
227 * Handle for a test run. 225 * Handle for a test run.
228 */ 226 */
229struct GNUNET_TRANSPORT_TESTING_Handle 227struct GNUNET_TRANSPORT_TESTING_Handle {
230{
231 /** 228 /**
232 * Testing library system handle 229 * Testing library system handle
233 */ 230 */
@@ -261,7 +258,7 @@ struct GNUNET_TRANSPORT_TESTING_Handle
261 * @return transport testing handle 258 * @return transport testing handle
262 */ 259 */
263struct GNUNET_TRANSPORT_TESTING_Handle * 260struct GNUNET_TRANSPORT_TESTING_Handle *
264GNUNET_TRANSPORT_TESTING_init (void); 261GNUNET_TRANSPORT_TESTING_init(void);
265 262
266 263
267/** 264/**
@@ -270,7 +267,7 @@ GNUNET_TRANSPORT_TESTING_init (void);
270 * @param tth transport testing handle 267 * @param tth transport testing handle
271 */ 268 */
272void 269void
273GNUNET_TRANSPORT_TESTING_done (struct GNUNET_TRANSPORT_TESTING_Handle *tth); 270GNUNET_TRANSPORT_TESTING_done(struct GNUNET_TRANSPORT_TESTING_Handle *tth);
274 271
275 272
276/** 273/**
@@ -288,7 +285,7 @@ GNUNET_TRANSPORT_TESTING_done (struct GNUNET_TRANSPORT_TESTING_Handle *tth);
288 * @return the peer context 285 * @return the peer context
289 */ 286 */
290struct GNUNET_TRANSPORT_TESTING_PeerContext * 287struct GNUNET_TRANSPORT_TESTING_PeerContext *
291GNUNET_TRANSPORT_TESTING_start_peer ( 288GNUNET_TRANSPORT_TESTING_start_peer(
292 struct GNUNET_TRANSPORT_TESTING_Handle *tth, 289 struct GNUNET_TRANSPORT_TESTING_Handle *tth,
293 const char *cfgname, 290 const char *cfgname,
294 int peer_id, 291 int peer_id,
@@ -306,7 +303,7 @@ GNUNET_TRANSPORT_TESTING_start_peer (
306 * @param p the peer 303 * @param p the peer
307 */ 304 */
308void 305void
309GNUNET_TRANSPORT_TESTING_stop_peer ( 306GNUNET_TRANSPORT_TESTING_stop_peer(
310 struct GNUNET_TRANSPORT_TESTING_PeerContext *pc); 307 struct GNUNET_TRANSPORT_TESTING_PeerContext *pc);
311 308
312 309
@@ -319,7 +316,7 @@ GNUNET_TRANSPORT_TESTING_stop_peer (
319 * @return #GNUNET_OK in success otherwise #GNUNET_SYSERR 316 * @return #GNUNET_OK in success otherwise #GNUNET_SYSERR
320 */ 317 */
321int 318int
322GNUNET_TRANSPORT_TESTING_restart_peer ( 319GNUNET_TRANSPORT_TESTING_restart_peer(
323 struct GNUNET_TRANSPORT_TESTING_PeerContext *p, 320 struct GNUNET_TRANSPORT_TESTING_PeerContext *p,
324 GNUNET_SCHEDULER_TaskCallback restart_cb, 321 GNUNET_SCHEDULER_TaskCallback restart_cb,
325 void *restart_cb_cls); 322 void *restart_cb_cls);
@@ -338,7 +335,7 @@ GNUNET_TRANSPORT_TESTING_restart_peer (
338 * @return a connect request handle 335 * @return a connect request handle
339 */ 336 */
340struct GNUNET_TRANSPORT_TESTING_ConnectRequest * 337struct GNUNET_TRANSPORT_TESTING_ConnectRequest *
341GNUNET_TRANSPORT_TESTING_connect_peers ( 338GNUNET_TRANSPORT_TESTING_connect_peers(
342 struct GNUNET_TRANSPORT_TESTING_PeerContext *p1, 339 struct GNUNET_TRANSPORT_TESTING_PeerContext *p1,
343 struct GNUNET_TRANSPORT_TESTING_PeerContext *p2, 340 struct GNUNET_TRANSPORT_TESTING_PeerContext *p2,
344 GNUNET_SCHEDULER_TaskCallback cb, 341 GNUNET_SCHEDULER_TaskCallback cb,
@@ -353,7 +350,7 @@ GNUNET_TRANSPORT_TESTING_connect_peers (
353 * @param cc a connect request handle 350 * @param cc a connect request handle
354 */ 351 */
355void 352void
356GNUNET_TRANSPORT_TESTING_connect_peers_cancel ( 353GNUNET_TRANSPORT_TESTING_connect_peers_cancel(
357 struct GNUNET_TRANSPORT_TESTING_ConnectRequest *cc); 354 struct GNUNET_TRANSPORT_TESTING_ConnectRequest *cc);
358 355
359 356
@@ -377,7 +374,7 @@ typedef void (*GNUNET_TRANSPORT_TESTING_ConnectContextCallback) (
377 * @param cb_cls closure for @a cb 374 * @param cb_cls closure for @a cb
378 */ 375 */
379void 376void
380GNUNET_TRANSPORT_TESTING_find_connecting_context ( 377GNUNET_TRANSPORT_TESTING_find_connecting_context(
381 struct GNUNET_TRANSPORT_TESTING_PeerContext *p1, 378 struct GNUNET_TRANSPORT_TESTING_PeerContext *p1,
382 struct GNUNET_TRANSPORT_TESTING_PeerContext *p2, 379 struct GNUNET_TRANSPORT_TESTING_PeerContext *p2,
383 GNUNET_TRANSPORT_TESTING_ConnectContextCallback cb, 380 GNUNET_TRANSPORT_TESTING_ConnectContextCallback cb,
@@ -413,8 +410,7 @@ struct GNUNET_TRANSPORT_TESTING_InternalPeerContext;
413 410
414 411
415GNUNET_NETWORK_STRUCT_BEGIN 412GNUNET_NETWORK_STRUCT_BEGIN
416struct GNUNET_TRANSPORT_TESTING_TestMessage 413struct GNUNET_TRANSPORT_TESTING_TestMessage {
417{
418 /** 414 /**
419 * Type is (usually) #GNUNET_TRANSPORT_TESTING_SIMPLE_MTYPE. 415 * Type is (usually) #GNUNET_TRANSPORT_TESTING_SIMPLE_MTYPE.
420 */ 416 */
@@ -475,9 +471,7 @@ typedef void (*GNUNET_TRANSPORT_TESTING_NotifyDisconnect) (
475 * Closure that must be passed to 471 * Closure that must be passed to
476 * #GNUNET_TRANSPORT_TESTING_connect_check. 472 * #GNUNET_TRANSPORT_TESTING_connect_check.
477 */ 473 */
478struct GNUNET_TRANSPORT_TESTING_ConnectCheckContext 474struct GNUNET_TRANSPORT_TESTING_ConnectCheckContext {
479{
480
481 /** 475 /**
482 * How should we continue after the connect? 476 * How should we continue after the connect?
483 */ 477 */
@@ -640,7 +634,7 @@ struct GNUNET_TRANSPORT_TESTING_ConnectCheckContext
640 * @return NULL if @a peer was not found 634 * @return NULL if @a peer was not found
641 */ 635 */
642struct GNUNET_TRANSPORT_TESTING_PeerContext * 636struct GNUNET_TRANSPORT_TESTING_PeerContext *
643GNUNET_TRANSPORT_TESTING_find_peer ( 637GNUNET_TRANSPORT_TESTING_find_peer(
644 struct GNUNET_TRANSPORT_TESTING_ConnectCheckContext *ccc, 638 struct GNUNET_TRANSPORT_TESTING_ConnectCheckContext *ccc,
645 const struct GNUNET_PeerIdentity *peer); 639 const struct GNUNET_PeerIdentity *peer);
646 640
@@ -662,7 +656,7 @@ GNUNET_TRANSPORT_TESTING_find_peer (
662 * @return #GNUNET_SYSERR on error 656 * @return #GNUNET_SYSERR on error
663 */ 657 */
664int 658int
665GNUNET_TRANSPORT_TESTING_connect_check ( 659GNUNET_TRANSPORT_TESTING_connect_check(
666 void *cls, 660 void *cls,
667 struct GNUNET_TRANSPORT_TESTING_Handle *tth_, 661 struct GNUNET_TRANSPORT_TESTING_Handle *tth_,
668 const char *test_plugin_, 662 const char *test_plugin_,
@@ -703,11 +697,11 @@ typedef int (*GNUNET_TRANSPORT_TESTING_CheckCallback) (
703 * @return #GNUNET_OK on success 697 * @return #GNUNET_OK on success
704 */ 698 */
705int 699int
706GNUNET_TRANSPORT_TESTING_main_ (const char *argv0, 700GNUNET_TRANSPORT_TESTING_main_(const char *argv0,
707 const char *filename, 701 const char *filename,
708 unsigned int num_peers, 702 unsigned int num_peers,
709 GNUNET_TRANSPORT_TESTING_CheckCallback check, 703 GNUNET_TRANSPORT_TESTING_CheckCallback check,
710 void *check_cls); 704 void *check_cls);
711 705
712 706
713/** 707/**
@@ -719,11 +713,11 @@ GNUNET_TRANSPORT_TESTING_main_ (const char *argv0,
719 * @return #GNUNET_OK on success 713 * @return #GNUNET_OK on success
720 */ 714 */
721#define GNUNET_TRANSPORT_TESTING_main(num_peers, check, check_cls) \ 715#define GNUNET_TRANSPORT_TESTING_main(num_peers, check, check_cls) \
722 GNUNET_TRANSPORT_TESTING_main_ (argv[0], \ 716 GNUNET_TRANSPORT_TESTING_main_(argv[0], \
723 __FILE__, \ 717 __FILE__, \
724 num_peers, \ 718 num_peers, \
725 check, \ 719 check, \
726 check_cls) 720 check_cls)
727 721
728/* ***************** Convenience functions for sending ********* */ 722/* ***************** Convenience functions for sending ********* */
729 723
@@ -745,7 +739,7 @@ GNUNET_TRANSPORT_TESTING_main_ (const char *argv0,
745 * #GNUNET_SYSERR if @a msize is illegal 739 * #GNUNET_SYSERR if @a msize is illegal
746 */ 740 */
747int 741int
748GNUNET_TRANSPORT_TESTING_send ( 742GNUNET_TRANSPORT_TESTING_send(
749 struct GNUNET_TRANSPORT_TESTING_PeerContext *sender, 743 struct GNUNET_TRANSPORT_TESTING_PeerContext *sender,
750 struct GNUNET_TRANSPORT_TESTING_PeerContext *receiver, 744 struct GNUNET_TRANSPORT_TESTING_PeerContext *receiver,
751 uint16_t mtype, 745 uint16_t mtype,
@@ -771,8 +765,7 @@ GNUNET_TRANSPORT_TESTING_send (
771 * #GNUNET_TRANSPORT_TESTING_simple_send() and 765 * #GNUNET_TRANSPORT_TESTING_simple_send() and
772 * #GNUNET_TRANSPORT_TESTING_large_send(). 766 * #GNUNET_TRANSPORT_TESTING_large_send().
773 */ 767 */
774struct GNUNET_TRANSPORT_TESTING_SendClosure 768struct GNUNET_TRANSPORT_TESTING_SendClosure {
775{
776 /** 769 /**
777 * Context for the transmission. 770 * Context for the transmission.
778 */ 771 */
@@ -812,7 +805,7 @@ struct GNUNET_TRANSPORT_TESTING_SendClosure
812 * of which should be currently connected 805 * of which should be currently connected
813 */ 806 */
814void 807void
815GNUNET_TRANSPORT_TESTING_simple_send (void *cls); 808GNUNET_TRANSPORT_TESTING_simple_send(void *cls);
816 809
817/** 810/**
818 * Size of a message sent with 811 * Size of a message sent with
@@ -830,7 +823,7 @@ GNUNET_TRANSPORT_TESTING_simple_send (void *cls);
830 * of which should be currently connected 823 * of which should be currently connected
831 */ 824 */
832void 825void
833GNUNET_TRANSPORT_TESTING_large_send (void *cls); 826GNUNET_TRANSPORT_TESTING_large_send(void *cls);
834 827
835 828
836/* ********************** log-only convenience functions ************* */ 829/* ********************** log-only convenience functions ************* */
@@ -844,7 +837,7 @@ GNUNET_TRANSPORT_TESTING_large_send (void *cls);
844 * @param other peer that connected. 837 * @param other peer that connected.
845 */ 838 */
846void 839void
847GNUNET_TRANSPORT_TESTING_log_connect ( 840GNUNET_TRANSPORT_TESTING_log_connect(
848 void *cls, 841 void *cls,
849 struct GNUNET_TRANSPORT_TESTING_PeerContext *me, 842 struct GNUNET_TRANSPORT_TESTING_PeerContext *me,
850 const struct GNUNET_PeerIdentity *other); 843 const struct GNUNET_PeerIdentity *other);
@@ -858,7 +851,7 @@ GNUNET_TRANSPORT_TESTING_log_connect (
858 * @param other peer that disconnected. 851 * @param other peer that disconnected.
859 */ 852 */
860void 853void
861GNUNET_TRANSPORT_TESTING_log_disconnect ( 854GNUNET_TRANSPORT_TESTING_log_disconnect(
862 void *cls, 855 void *cls,
863 struct GNUNET_TRANSPORT_TESTING_PeerContext *me, 856 struct GNUNET_TRANSPORT_TESTING_PeerContext *me,
864 const struct GNUNET_PeerIdentity *other); 857 const struct GNUNET_PeerIdentity *other);
@@ -875,7 +868,7 @@ GNUNET_TRANSPORT_TESTING_log_disconnect (
875 * @return resulting test name 868 * @return resulting test name
876 */ 869 */
877char * 870char *
878GNUNET_TRANSPORT_TESTING_get_test_name (const char *file); 871GNUNET_TRANSPORT_TESTING_get_test_name(const char *file);
879 872
880 873
881/** 874/**
@@ -887,7 +880,7 @@ GNUNET_TRANSPORT_TESTING_get_test_name (const char *file);
887 * @return configuration name to use 880 * @return configuration name to use
888 */ 881 */
889char * 882char *
890GNUNET_TRANSPORT_TESTING_get_config_name (const char *file, int count); 883GNUNET_TRANSPORT_TESTING_get_config_name(const char *file, int count);
891 884
892 885
893/** 886/**
@@ -897,8 +890,8 @@ GNUNET_TRANSPORT_TESTING_get_config_name (const char *file, int count);
897 * @return the plugin name 890 * @return the plugin name
898 */ 891 */
899char * 892char *
900GNUNET_TRANSPORT_TESTING_get_test_plugin_name (const char *executable, 893GNUNET_TRANSPORT_TESTING_get_test_plugin_name(const char *executable,
901 const char *testname); 894 const char *testname);
902 895
903 896
904/** 897/**
@@ -909,7 +902,7 @@ GNUNET_TRANSPORT_TESTING_get_test_plugin_name (const char *executable,
909 * @return the source name 902 * @return the source name
910 */ 903 */
911char * 904char *
912GNUNET_TRANSPORT_TESTING_get_test_source_name (const char *file); 905GNUNET_TRANSPORT_TESTING_get_test_source_name(const char *file);
913 906
914#endif 907#endif
915/* end of transport_testing.h */ 908/* end of transport_testing.h */