aboutsummaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorWillow Liquorice <willow@howhill.com>2022-09-07 21:20:48 +0100
committerWillow Liquorice <willow@howhill.com>2022-10-03 12:51:57 +0100
commit42cda6099b5957ab28f19a7b793a5428c96faeb8 (patch)
tree68c59da6d2fd3e38f2fbbcb8766973db52d59bf5 /src
parentfaaa236b9f3c8870e8ab2764efbe91f73064dbe7 (diff)
downloadgnunet-42cda6099b5957ab28f19a7b793a5428c96faeb8.tar.gz
gnunet-42cda6099b5957ab28f19a7b793a5428c96faeb8.zip
-DOC: Documentation cleanup pass through TESTBED subsystem
Diffstat (limited to 'src')
-rw-r--r--src/testbed/gnunet-service-testbed.c4
-rw-r--r--src/testbed/gnunet-service-testbed.h2
-rw-r--r--src/testbed/gnunet-service-testbed_barriers.c4
-rw-r--r--src/testbed/testbed_api.c28
-rw-r--r--src/testbed/testbed_api_hosts.c1
5 files changed, 19 insertions, 20 deletions
diff --git a/src/testbed/gnunet-service-testbed.c b/src/testbed/gnunet-service-testbed.c
index 91aa5dd88..b2f04d5d8 100644
--- a/src/testbed/gnunet-service-testbed.c
+++ b/src/testbed/gnunet-service-testbed.c
@@ -379,7 +379,7 @@ parse_shared_services (char *ss_str,
379 * Check #GNUNET_MESSAGE_TYPE_TESTBED_INIT messages 379 * Check #GNUNET_MESSAGE_TYPE_TESTBED_INIT messages
380 * 380 *
381 * @param cls identification of the client 381 * @param cls identification of the client
382 * @param message the actual message 382 * @param msg the actual message
383 * @return #GNUNET_OK if @a message is well-formed 383 * @return #GNUNET_OK if @a message is well-formed
384 */ 384 */
385static int 385static int
@@ -404,7 +404,7 @@ check_init (void *cls,
404 * Message handler for #GNUNET_MESSAGE_TYPE_TESTBED_INIT messages 404 * Message handler for #GNUNET_MESSAGE_TYPE_TESTBED_INIT messages
405 * 405 *
406 * @param cls identification of the client 406 * @param cls identification of the client
407 * @param message the actual message 407 * @param msg the actual message
408 */ 408 */
409static void 409static void
410handle_init (void *cls, 410handle_init (void *cls,
diff --git a/src/testbed/gnunet-service-testbed.h b/src/testbed/gnunet-service-testbed.h
index 920e22f05..67dfbf253 100644
--- a/src/testbed/gnunet-service-testbed.h
+++ b/src/testbed/gnunet-service-testbed.h
@@ -701,7 +701,7 @@ handle_peer_start (void *cls,
701 * Message handler for #GNUNET_MESSAGE_TYPE_TESTBED_DESTROYPEER messages 701 * Message handler for #GNUNET_MESSAGE_TYPE_TESTBED_DESTROYPEER messages
702 * 702 *
703 * @param cls identification of the client 703 * @param cls identification of the client
704 * @param message the actual message 704 * @param msg the actual message
705 */ 705 */
706void 706void
707handle_peer_stop (void *cls, 707handle_peer_stop (void *cls,
diff --git a/src/testbed/gnunet-service-testbed_barriers.c b/src/testbed/gnunet-service-testbed_barriers.c
index be33bd131..bc6148087 100644
--- a/src/testbed/gnunet-service-testbed_barriers.c
+++ b/src/testbed/gnunet-service-testbed_barriers.c
@@ -328,7 +328,7 @@ send_barrier_status_msg (struct Barrier *barrier,
328 * Check #GNUNET_MESSAGE_TYPE_TESTBED_BARRIER_WAIT messages. 328 * Check #GNUNET_MESSAGE_TYPE_TESTBED_BARRIER_WAIT messages.
329 * 329 *
330 * @param cls identification of the client 330 * @param cls identification of the client
331 * @param message the actual message 331 * @param msg the actual message
332 */ 332 */
333static int 333static int
334check_barrier_wait (void *cls, 334check_barrier_wait (void *cls,
@@ -347,7 +347,7 @@ check_barrier_wait (void *cls,
347 * either from the testbed driver or from a high level controller 347 * either from the testbed driver or from a high level controller
348 * 348 *
349 * @param cls identification of the client 349 * @param cls identification of the client
350 * @param message the actual message 350 * @param msg the actual message
351 */ 351 */
352static void 352static void
353handle_barrier_wait (void *cls, 353handle_barrier_wait (void *cls,
diff --git a/src/testbed/testbed_api.c b/src/testbed/testbed_api.c
index 46b8ab901..2ae0a1703 100644
--- a/src/testbed/testbed_api.c
+++ b/src/testbed/testbed_api.c
@@ -407,7 +407,7 @@ handle_add_host_confirm (void *cls,
407/** 407/**
408 * Handler for forwarded operations 408 * Handler for forwarded operations
409 * 409 *
410 * @param c the controller handle 410 * @param cls the controller handle
411 * @param opc the operation context 411 * @param opc the operation context
412 * @param msg the message 412 * @param msg the message
413 */ 413 */
@@ -432,7 +432,7 @@ handle_forwarded_operation_msg (void *cls,
432 * Handler for #GNUNET_MESSAGE_TYPE_TESTBED_ADD_HOST_SUCCESS message from 432 * Handler for #GNUNET_MESSAGE_TYPE_TESTBED_ADD_HOST_SUCCESS message from
433 * controller (testbed service) 433 * controller (testbed service)
434 * 434 *
435 * @param c the controller handler 435 * @param cls the controller handler
436 * @param msg message received 436 * @param msg message received
437 */ 437 */
438static void 438static void
@@ -536,7 +536,7 @@ handle_opsuccess (
536 * Handler for #GNUNET_MESSAGE_TYPE_TESTBED_CREATE_PEER_SUCCESS message from 536 * Handler for #GNUNET_MESSAGE_TYPE_TESTBED_CREATE_PEER_SUCCESS message from
537 * controller (testbed service) 537 * controller (testbed service)
538 * 538 *
539 * @param c the controller handle 539 * @param cls the controller handle
540 * @param msg message received 540 * @param msg message received
541 */ 541 */
542static void 542static void
@@ -594,7 +594,7 @@ handle_peer_create_success (
594 * Handler for #GNUNET_MESSAGE_TYPE_TESTBED_PEER_EVENT message from 594 * Handler for #GNUNET_MESSAGE_TYPE_TESTBED_PEER_EVENT message from
595 * controller (testbed service) 595 * controller (testbed service)
596 * 596 *
597 * @param c the controller handler 597 * @param cls the controller handler
598 * @param msg message received 598 * @param msg message received
599 */ 599 */
600static void 600static void
@@ -675,7 +675,7 @@ handle_peer_event (void *cls, const struct GNUNET_TESTBED_PeerEventMessage *msg)
675 * Handler for #GNUNET_MESSAGE_TYPE_TESTBED_PEER_CONNECT_EVENT message from 675 * Handler for #GNUNET_MESSAGE_TYPE_TESTBED_PEER_CONNECT_EVENT message from
676 * controller (testbed service) 676 * controller (testbed service)
677 * 677 *
678 * @param c the controller handler 678 * @param cls the controller handler
679 * @param msg message received 679 * @param msg message received
680 */ 680 */
681static void 681static void
@@ -751,7 +751,7 @@ handle_peer_conevent (void *cls,
751 * Validate #GNUNET_MESSAGE_TYPE_TESTBED_PEER_INFORMATION message from 751 * Validate #GNUNET_MESSAGE_TYPE_TESTBED_PEER_INFORMATION message from
752 * controller (testbed service) 752 * controller (testbed service)
753 * 753 *
754 * @param c the controller handler 754 * @param cls the controller handler
755 * @param msg message received 755 * @param msg message received
756 */ 756 */
757static int 757static int
@@ -768,7 +768,7 @@ check_peer_config (
768 * Handler for #GNUNET_MESSAGE_TYPE_TESTBED_PEER_INFORMATION message from 768 * Handler for #GNUNET_MESSAGE_TYPE_TESTBED_PEER_INFORMATION message from
769 * controller (testbed service) 769 * controller (testbed service)
770 * 770 *
771 * @param c the controller handler 771 * @param cls the controller handler
772 * @param msg message received 772 * @param msg message received
773 */ 773 */
774static void 774static void
@@ -840,7 +840,7 @@ handle_peer_config (
840 * Validate #GNUNET_MESSAGE_TYPE_TESTBED_OPERATION_FAIL_EVENT message from 840 * Validate #GNUNET_MESSAGE_TYPE_TESTBED_OPERATION_FAIL_EVENT message from
841 * controller (testbed service) 841 * controller (testbed service)
842 * 842 *
843 * @param c the controller handler 843 * @param cls the controller handler
844 * @param msg message received 844 * @param msg message received
845 * @return #GNUNET_OK if message is well-formed 845 * @return #GNUNET_OK if message is well-formed
846 */ 846 */
@@ -858,7 +858,7 @@ check_op_fail_event (
858 * Handler for #GNUNET_MESSAGE_TYPE_TESTBED_OPERATION_FAIL_EVENT message from 858 * Handler for #GNUNET_MESSAGE_TYPE_TESTBED_OPERATION_FAIL_EVENT message from
859 * controller (testbed service) 859 * controller (testbed service)
860 * 860 *
861 * @param c the controller handler 861 * @param cls the controller handler
862 * @param msg message received 862 * @param msg message received
863 */ 863 */
864static void 864static void
@@ -1037,7 +1037,7 @@ check_slave_config (void *cls,
1037 * Handler for #GNUNET_MESSAGE_TYPE_TESTBED_SLAVE_CONFIGURATION message from controller 1037 * Handler for #GNUNET_MESSAGE_TYPE_TESTBED_SLAVE_CONFIGURATION message from controller
1038 * (testbed service) 1038 * (testbed service)
1039 * 1039 *
1040 * @param c the controller handler 1040 * @param cls the controller handler
1041 * @param msg message received 1041 * @param msg message received
1042 */ 1042 */
1043static void 1043static void
@@ -1099,7 +1099,7 @@ check_link_controllers_result (
1099 * Handler for #GNUNET_MESSAGE_TYPE_TESTBED_LINK_CONTROLLERS_RESULT message from controller 1099 * Handler for #GNUNET_MESSAGE_TYPE_TESTBED_LINK_CONTROLLERS_RESULT message from controller
1100 * (testbed service) 1100 * (testbed service)
1101 * 1101 *
1102 * @param c the controller handler 1102 * @param cls the controller handler
1103 * @param msg message received 1103 * @param msg message received
1104 */ 1104 */
1105static void 1105static void
@@ -2384,7 +2384,7 @@ GNUNET_TESTBED_barrier_init_ (struct GNUNET_TESTBED_Controller *controller,
2384 * GNUNET_TESTBED_barrier_reached(). 2384 * GNUNET_TESTBED_barrier_reached().
2385 * @param cb the callback to call when the barrier is reached or upon error. 2385 * @param cb the callback to call when the barrier is reached or upon error.
2386 * Cannot be NULL. 2386 * Cannot be NULL.
2387 * @param cls closure for the above callback 2387 * @param cb_cls closure for the above callback
2388 * @return barrier handle; NULL upon error 2388 * @return barrier handle; NULL upon error
2389 */ 2389 */
2390struct GNUNET_TESTBED_Barrier * 2390struct GNUNET_TESTBED_Barrier *
@@ -2392,13 +2392,13 @@ GNUNET_TESTBED_barrier_init (struct GNUNET_TESTBED_Controller *controller,
2392 const char *name, 2392 const char *name,
2393 unsigned int quorum, 2393 unsigned int quorum,
2394 GNUNET_TESTBED_barrier_status_cb cb, 2394 GNUNET_TESTBED_barrier_status_cb cb,
2395 void *cls) 2395 void *cb_cls)
2396{ 2396{
2397 return GNUNET_TESTBED_barrier_init_ (controller, 2397 return GNUNET_TESTBED_barrier_init_ (controller,
2398 name, 2398 name,
2399 quorum, 2399 quorum,
2400 cb, 2400 cb,
2401 cls, 2401 cb_cls,
2402 GNUNET_YES); 2402 GNUNET_YES);
2403} 2403}
2404 2404
diff --git a/src/testbed/testbed_api_hosts.c b/src/testbed/testbed_api_hosts.c
index e0c48f709..824bd0187 100644
--- a/src/testbed/testbed_api_hosts.c
+++ b/src/testbed/testbed_api_hosts.c
@@ -918,7 +918,6 @@ gen_rsh_suffix_args (const char *const *append_args)
918 * Do not call GNUNET_SERVER_mst_destroy in callback 918 * Do not call GNUNET_SERVER_mst_destroy in callback
919 * 919 *
920 * @param cls closure 920 * @param cls closure
921 * @param client identification of the client
922 * @param message the actual message 921 * @param message the actual message
923 * 922 *
924 * @return #GNUNET_OK on success, #GNUNET_SYSERR to stop further processing 923 * @return #GNUNET_OK on success, #GNUNET_SYSERR to stop further processing