diff options
-rw-r--r-- | src/include/gnunet_testbed_service.h | 8 | ||||
-rw-r--r-- | src/testbed/testbed_api.c | 24 | ||||
-rw-r--r-- | src/testbed/testbed_api_barriers.c | 11 | ||||
-rw-r--r-- | src/testbed/testbed_api_hosts.c | 11 | ||||
-rw-r--r-- | src/testbed/testbed_api_peers.c | 55 | ||||
-rw-r--r-- | src/testbed/testbed_api_topology.c | 42 |
6 files changed, 4 insertions, 147 deletions
diff --git a/src/include/gnunet_testbed_service.h b/src/include/gnunet_testbed_service.h index 29515b7af..ef67ab8ca 100644 --- a/src/include/gnunet_testbed_service.h +++ b/src/include/gnunet_testbed_service.h | |||
@@ -1030,8 +1030,8 @@ enum GNUNET_TESTBED_TopologyOption | |||
1030 | * Configure overall network topology to have a particular shape. | 1030 | * Configure overall network topology to have a particular shape. |
1031 | * | 1031 | * |
1032 | * @param op_cls closure argument to give with the operation event | 1032 | * @param op_cls closure argument to give with the operation event |
1033 | * @param num_peers number of peers in 'peers' | 1033 | * @param num_peers number of peers in @a peers |
1034 | * @param peers array of 'num_peers' with the peers to configure | 1034 | * @param peers array of @a num_peers with the peers to configure |
1035 | * @param topo desired underlay topology to use | 1035 | * @param topo desired underlay topology to use |
1036 | * @param ap topology-specific options | 1036 | * @param ap topology-specific options |
1037 | * @return handle to the operation, NULL if configuring the topology | 1037 | * @return handle to the operation, NULL if configuring the topology |
@@ -1052,8 +1052,8 @@ GNUNET_TESTBED_underlay_configure_topology_va (void *op_cls, | |||
1052 | * Configure overall network topology to have a particular shape. | 1052 | * Configure overall network topology to have a particular shape. |
1053 | * | 1053 | * |
1054 | * @param op_cls closure argument to give with the operation event | 1054 | * @param op_cls closure argument to give with the operation event |
1055 | * @param num_peers number of peers in 'peers' | 1055 | * @param num_peers number of peers in @a peers |
1056 | * @param peers array of 'num_peers' with the peers to configure | 1056 | * @param peers array of @a num_peers with the peers to configure |
1057 | * @param topo desired underlay topology to use | 1057 | * @param topo desired underlay topology to use |
1058 | * @param ... topology-specific options | 1058 | * @param ... topology-specific options |
1059 | * @return handle to the operation, NULL if configuring the topology | 1059 | * @return handle to the operation, NULL if configuring the topology |
diff --git a/src/testbed/testbed_api.c b/src/testbed/testbed_api.c index 18bb0c3f6..b95586975 100644 --- a/src/testbed/testbed_api.c +++ b/src/testbed/testbed_api.c | |||
@@ -1917,21 +1917,6 @@ GNUNET_TESTBED_get_slave_config_ (void *op_cls, | |||
1917 | } | 1917 | } |
1918 | 1918 | ||
1919 | 1919 | ||
1920 | /** | ||
1921 | * Function to acquire the configuration of a running slave controller. The | ||
1922 | * completion of the operation is signalled through the controller_cb from | ||
1923 | * GNUNET_TESTBED_controller_connect(). If the operation is successful the | ||
1924 | * handle to the configuration is available in the generic pointer of | ||
1925 | * operation_finished field of struct GNUNET_TESTBED_EventInformation. | ||
1926 | * | ||
1927 | * @param op_cls the closure for the operation | ||
1928 | * @param master the handle to master controller | ||
1929 | * @param slave_host the host where the slave controller is running; the handle | ||
1930 | * to the slave_host should remain valid until this operation is | ||
1931 | * cancelled or marked as finished | ||
1932 | * @return the operation handle; NULL if the slave_host is not registered at | ||
1933 | * master | ||
1934 | */ | ||
1935 | struct GNUNET_TESTBED_Operation * | 1920 | struct GNUNET_TESTBED_Operation * |
1936 | GNUNET_TESTBED_get_slave_config (void *op_cls, | 1921 | GNUNET_TESTBED_get_slave_config (void *op_cls, |
1937 | struct GNUNET_TESTBED_Controller *master, | 1922 | struct GNUNET_TESTBED_Controller *master, |
@@ -1946,15 +1931,6 @@ GNUNET_TESTBED_get_slave_config (void *op_cls, | |||
1946 | } | 1931 | } |
1947 | 1932 | ||
1948 | 1933 | ||
1949 | /** | ||
1950 | * Ask the testbed controller to write the current overlay topology to | ||
1951 | * a file. Naturally, the file will only contain a snapshot as the | ||
1952 | * topology may evolve all the time. | ||
1953 | * | ||
1954 | * @param controller overlay controller to inspect | ||
1955 | * @param filename name of the file the topology should | ||
1956 | * be written to. | ||
1957 | */ | ||
1958 | void | 1934 | void |
1959 | GNUNET_TESTBED_overlay_write_topology_to_file ( | 1935 | GNUNET_TESTBED_overlay_write_topology_to_file ( |
1960 | struct GNUNET_TESTBED_Controller *controller, | 1936 | struct GNUNET_TESTBED_Controller *controller, |
diff --git a/src/testbed/testbed_api_barriers.c b/src/testbed/testbed_api_barriers.c index 61578c1e6..6074beb12 100644 --- a/src/testbed/testbed_api_barriers.c +++ b/src/testbed/testbed_api_barriers.c | |||
@@ -160,17 +160,6 @@ mq_error_handler (void *cls, | |||
160 | } | 160 | } |
161 | 161 | ||
162 | 162 | ||
163 | /** | ||
164 | * Wait for a barrier to be crossed. This function should be called by the | ||
165 | * peers which have been started by the testbed. If the peer is not started by | ||
166 | * testbed this function may return error | ||
167 | * | ||
168 | * @param name the name of the barrier | ||
169 | * @param cb the barrier wait callback | ||
170 | * @param cb_cls the closure for @a cb | ||
171 | * @return barrier wait handle which can be used to cancel the waiting at | ||
172 | * anytime before the callback is called. NULL upon error. | ||
173 | */ | ||
174 | struct GNUNET_TESTBED_BarrierWaitHandle * | 163 | struct GNUNET_TESTBED_BarrierWaitHandle * |
175 | GNUNET_TESTBED_barrier_wait (const char *name, | 164 | GNUNET_TESTBED_barrier_wait (const char *name, |
176 | GNUNET_TESTBED_barrier_wait_cb cb, | 165 | GNUNET_TESTBED_barrier_wait_cb cb, |
diff --git a/src/testbed/testbed_api_hosts.c b/src/testbed/testbed_api_hosts.c index 8dd0a4893..4cbfd8d29 100644 --- a/src/testbed/testbed_api_hosts.c +++ b/src/testbed/testbed_api_hosts.c | |||
@@ -393,17 +393,6 @@ GNUNET_TESTBED_host_create (const char *hostname, | |||
393 | } | 393 | } |
394 | 394 | ||
395 | 395 | ||
396 | /** | ||
397 | * Load a set of hosts from a configuration file. | ||
398 | * | ||
399 | * @param filename file with the host specification | ||
400 | * @param cfg the configuration to use as a template while starting a controller | ||
401 | * on any of the loaded hosts. Operation queue sizes specific to a host | ||
402 | * are also read from this configuration handle | ||
403 | * @param hosts set to the hosts found in the file; caller must free this if | ||
404 | * number of hosts returned is greater than 0 | ||
405 | * @return number of hosts returned in 'hosts', 0 on error | ||
406 | */ | ||
407 | unsigned int | 396 | unsigned int |
408 | GNUNET_TESTBED_hosts_load_from_file ( | 397 | GNUNET_TESTBED_hosts_load_from_file ( |
409 | const char *filename, | 398 | const char *filename, |
diff --git a/src/testbed/testbed_api_peers.c b/src/testbed/testbed_api_peers.c index 99d30e85b..b8e428441 100644 --- a/src/testbed/testbed_api_peers.c +++ b/src/testbed/testbed_api_peers.c | |||
@@ -661,18 +661,6 @@ GNUNET_TESTBED_peer_start (void *op_cls, struct GNUNET_TESTBED_Peer *peer, | |||
661 | } | 661 | } |
662 | 662 | ||
663 | 663 | ||
664 | /** | ||
665 | * Stop the given peer. The handle remains valid (use | ||
666 | * "GNUNET_TESTBED_peer_destroy" to fully clean up the | ||
667 | * state of the peer). | ||
668 | * | ||
669 | * @param op_cls the closure for this operation; will be set in the event | ||
670 | * information | ||
671 | * @param peer peer to stop | ||
672 | * @param pcc function to call upon completion | ||
673 | * @param pcc_cls closure for 'pcc' | ||
674 | * @return handle to the operation | ||
675 | */ | ||
676 | struct GNUNET_TESTBED_Operation * | 664 | struct GNUNET_TESTBED_Operation * |
677 | GNUNET_TESTBED_peer_stop (void *op_cls, | 665 | GNUNET_TESTBED_peer_stop (void *op_cls, |
678 | struct GNUNET_TESTBED_Peer *peer, | 666 | struct GNUNET_TESTBED_Peer *peer, |
@@ -701,20 +689,6 @@ GNUNET_TESTBED_peer_stop (void *op_cls, | |||
701 | } | 689 | } |
702 | 690 | ||
703 | 691 | ||
704 | /** | ||
705 | * Request information about a peer. The controller callback will not be called | ||
706 | * with event type GNUNET_TESTBED_ET_OPERATION_FINISHED when result for this | ||
707 | * operation is available. Instead, the GNUNET_TESTBED_PeerInfoCallback() will | ||
708 | * be called. | ||
709 | * The peer information in the callback is valid until the operation is canceled. | ||
710 | * | ||
711 | * @param peer peer to request information about | ||
712 | * @param pit desired information | ||
713 | * @param cb the convenience callback to be called when results for this | ||
714 | * operation are available | ||
715 | * @param cb_cls the closure for the above callback | ||
716 | * @return handle to the operation | ||
717 | */ | ||
718 | struct GNUNET_TESTBED_Operation * | 692 | struct GNUNET_TESTBED_Operation * |
719 | GNUNET_TESTBED_peer_get_information (struct GNUNET_TESTBED_Peer *peer, | 693 | GNUNET_TESTBED_peer_get_information (struct GNUNET_TESTBED_Peer *peer, |
720 | enum GNUNET_TESTBED_PeerInformationType | 694 | enum GNUNET_TESTBED_PeerInformationType |
@@ -847,20 +821,6 @@ GNUNET_TESTBED_underlay_configure_link (void *op_cls, | |||
847 | } | 821 | } |
848 | 822 | ||
849 | 823 | ||
850 | /** | ||
851 | * Both peers must have been started before calling this function. | ||
852 | * This function then obtains a HELLO from 'p1', gives it to 'p2' | ||
853 | * and asks 'p2' to connect to 'p1'. | ||
854 | * | ||
855 | * @param op_cls closure argument to give with the operation event | ||
856 | * @param cb the callback to call when this operation has finished | ||
857 | * @param cb_cls the closure for the above callback | ||
858 | * @param p1 first peer | ||
859 | * @param p2 second peer | ||
860 | * @return handle to the operation, NULL if connecting these two | ||
861 | * peers is fundamentally not possible at this time (peers | ||
862 | * not running or underlay disallows) | ||
863 | */ | ||
864 | struct GNUNET_TESTBED_Operation * | 824 | struct GNUNET_TESTBED_Operation * |
865 | GNUNET_TESTBED_overlay_connect (void *op_cls, | 825 | GNUNET_TESTBED_overlay_connect (void *op_cls, |
866 | GNUNET_TESTBED_OperationCompletionCallback cb, | 826 | GNUNET_TESTBED_OperationCompletionCallback cb, |
@@ -957,21 +917,6 @@ oprelease_manage_service (void *cls) | |||
957 | } | 917 | } |
958 | 918 | ||
959 | 919 | ||
960 | /** | ||
961 | * Start or stop given service at a peer. This should not be called to | ||
962 | * start/stop the peer's ARM service. Use GNUNET_TESTBED_peer_start(), | ||
963 | * GNUNET_TESTBED_peer_stop() for starting/stopping peer's ARM service. Success | ||
964 | * or failure of the generated operation is signalled through the controller | ||
965 | * event callback and/or operation completion callback. | ||
966 | * | ||
967 | * @param op_cls the closure for the operation | ||
968 | * @param peer the peer whose service is to be started/stopped | ||
969 | * @param service_name the name of the service | ||
970 | * @param cb the operation completion callback | ||
971 | * @param cb_cls the closure for the operation completion callback | ||
972 | * @param start 1 to start the service; 0 to stop the service | ||
973 | * @return an operation handle; NULL upon error (peer not running) | ||
974 | */ | ||
975 | struct GNUNET_TESTBED_Operation * | 920 | struct GNUNET_TESTBED_Operation * |
976 | GNUNET_TESTBED_peer_manage_service (void *op_cls, | 921 | GNUNET_TESTBED_peer_manage_service (void *op_cls, |
977 | struct GNUNET_TESTBED_Peer *peer, | 922 | struct GNUNET_TESTBED_Peer *peer, |
diff --git a/src/testbed/testbed_api_topology.c b/src/testbed/testbed_api_topology.c index e68e449ad..46f7efc76 100644 --- a/src/testbed/testbed_api_topology.c +++ b/src/testbed/testbed_api_topology.c | |||
@@ -1250,17 +1250,6 @@ gen_topo_clique (struct TopologyContext *tc) | |||
1250 | } | 1250 | } |
1251 | 1251 | ||
1252 | 1252 | ||
1253 | /** | ||
1254 | * Configure overall network topology to have a particular shape. | ||
1255 | * | ||
1256 | * @param op_cls closure argument to give with the operation event | ||
1257 | * @param num_peers number of peers in @a peers | ||
1258 | * @param peers array of @a num_peers with the peers to configure | ||
1259 | * @param topo desired underlay topology to use | ||
1260 | * @param ap topology-specific options | ||
1261 | * @return handle to the operation, NULL if configuring the topology | ||
1262 | * is not allowed at this time | ||
1263 | */ | ||
1264 | struct GNUNET_TESTBED_Operation * | 1253 | struct GNUNET_TESTBED_Operation * |
1265 | GNUNET_TESTBED_underlay_configure_topology_va (void *op_cls, | 1254 | GNUNET_TESTBED_underlay_configure_topology_va (void *op_cls, |
1266 | unsigned int num_peers, | 1255 | unsigned int num_peers, |
@@ -1275,17 +1264,6 @@ GNUNET_TESTBED_underlay_configure_topology_va (void *op_cls, | |||
1275 | } | 1264 | } |
1276 | 1265 | ||
1277 | 1266 | ||
1278 | /** | ||
1279 | * Configure overall network topology to have a particular shape. | ||
1280 | * | ||
1281 | * @param op_cls closure argument to give with the operation event | ||
1282 | * @param num_peers number of peers in @a peers | ||
1283 | * @param peers array of @a num_peers with the peers to configure | ||
1284 | * @param topo desired underlay topology to use | ||
1285 | * @param ... topology-specific options | ||
1286 | * @return handle to the operation, NULL if configuring the topology | ||
1287 | * is not allowed at this time | ||
1288 | */ | ||
1289 | struct GNUNET_TESTBED_Operation * | 1267 | struct GNUNET_TESTBED_Operation * |
1290 | GNUNET_TESTBED_underlay_configure_topology (void *op_cls, | 1268 | GNUNET_TESTBED_underlay_configure_topology (void *op_cls, |
1291 | unsigned int num_peers, | 1269 | unsigned int num_peers, |
@@ -1298,26 +1276,6 @@ GNUNET_TESTBED_underlay_configure_topology (void *op_cls, | |||
1298 | } | 1276 | } |
1299 | 1277 | ||
1300 | 1278 | ||
1301 | /** | ||
1302 | * All peers must have been started before calling this function. | ||
1303 | * This function then connects the given peers in the P2P overlay | ||
1304 | * using the given topology. | ||
1305 | * | ||
1306 | * @param op_cls closure argument to give with the peer connect operation events | ||
1307 | * generated through this function | ||
1308 | * @param num_peers number of peers in @a peers | ||
1309 | * @param peers array of @a num_peers with the peers to configure | ||
1310 | * @param max_connections the maximums number of overlay connections that will | ||
1311 | * be made to achieve the given topology | ||
1312 | * @param comp_cb the completion callback to call when the topology generation | ||
1313 | * is completed | ||
1314 | * @param comp_cb_cls closure for the above completion callback | ||
1315 | * @param topo desired underlay topology to use | ||
1316 | * @param va topology-specific options | ||
1317 | * @return handle to the operation, NULL if connecting these | ||
1318 | * peers is fundamentally not possible at this time (peers | ||
1319 | * not running or underlay disallows) or if num_peers is less than 2 | ||
1320 | */ | ||
1321 | struct GNUNET_TESTBED_Operation * | 1279 | struct GNUNET_TESTBED_Operation * |
1322 | GNUNET_TESTBED_overlay_configure_topology_va (void *op_cls, | 1280 | GNUNET_TESTBED_overlay_configure_topology_va (void *op_cls, |
1323 | unsigned int num_peers, | 1281 | unsigned int num_peers, |