This file is part of GNUnet.
Copyright (C) 2010-2013 GNUnet e.V.
- GNUnet is free software; you can redistribute it and/or modify
- it under the terms of the GNU General Public License as published
- by the Free Software Foundation; either version 3, or (at your
- option) any later version.
+ GNUnet is free software: you can redistribute it and/or modify it
+ under the terms of the GNU Affero General Public License as published
+ by the Free Software Foundation, either version 3 of the License,
+ or (at your option) any later version.
GNUnet is distributed in the hope that it will be useful, but
WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
- General Public License for more details.
+ Affero General Public License for more details.
- You should have received a copy of the GNU General Public License
- along with GNUnet; see the file COPYING. If not, write to the
- Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
- Boston, MA 02110-1301, USA.
+ You should have received a copy of the GNU Affero General Public License
+ along with this program. If not, see <http://www.gnu.org/licenses/>.
+
+ SPDX-License-Identifier: AGPL3.0-or-later
*/
/**
* @file ats-tests/ats-testing.h
#include "gnunet_testbed_service.h"
#include "gnunet_ats_service.h"
#include "gnunet_core_service.h"
+#include "gnunet_transport_core_service.h"
#define TEST_ATS_PREFERENCE_DEFAULT 1.0
*/
#define TEST_MESSAGE_SIZE 100
+
+struct TestMessage
+{
+ struct GNUNET_MessageHeader header;
+
+ uint8_t padding[TEST_MESSAGE_SIZE - sizeof (struct GNUNET_MessageHeader)];
+};
+
+
struct BenchmarkPartner;
struct BenchmarkPeer;
* @param masters array of master peers
* @param slaves array of master peers
*/
-typedef void (*GNUNET_ATS_TEST_TopologySetupDoneCallback) (void *cls,
- struct BenchmarkPeer *masters,
- struct BenchmarkPeer *slaves);
+typedef void
+(*GNUNET_ATS_TEST_TopologySetupDoneCallback) (void *cls,
+ struct BenchmarkPeer *masters,
+ struct BenchmarkPeer *slaves);
/**
* Callback called when logging is required for the data contained
struct TestbedConnectOperation *core_connect_ops;
/**
- * Core handle
+ * Core handle
*/
struct GNUNET_CORE_Handle *ch;
/**
- * Core handle
+ * Transport handle
*/
- struct GNUNET_TRANSPORT_Handle *th;
+ struct GNUNET_TRANSPORT_CoreHandle *th;
/**
* Masters only:
struct BenchmarkPeer *dest;
/**
- * Core transmit handles
+ * Message queue handle.
*/
- struct GNUNET_CORE_TransmitHandle *cth;
-
- /**
- * Transport transmit handles
- */
- struct GNUNET_TRANSPORT_TransmitHandle *tth;
-
+ struct GNUNET_MQ_Handle *mq;
/**
* Handle for traffic generator
*/
unsigned int bytes_received;
- /* Current ATS properties */
+ /**
+ * Current ATS properties
+ */
struct GNUNET_ATS_Properties props;
- /* Bandwidth assigned inbound */
+ /**
+ * Bandwidth assigned inbound
+ */
uint32_t bandwidth_in;
- /* Bandwidth assigned outbound */
+ /**
+ * Bandwidth assigned outbound
+ */
uint32_t bandwidth_out;
- /* Current preference values for bandwidth */
+ /**
+ * Current preference values for bandwidth
+ */
double pref_bandwidth;
- /* Current preference values for delay */
+ /**
+ * Current preference values for delay
+ */
double pref_delay;
-
};
+
/**
* Overall state of the performance benchmark
*/
struct GNUNET_ATS_TEST_Topology
{
- /**
- * Shutdown task
- */
- struct GNUNET_SCHEDULER_Task * shutdown_task;
-
/**
* Progress task
*/
- struct GNUNET_SCHEDULER_Task * progress_task;
+ struct GNUNET_SCHEDULER_Task *progress_task;
/**
* Test result
*/
int result;
- /**Test core (GNUNET_YES) or transport (GNUNET_NO)
+ /**
+ * Test core (#GNUNET_YES) or transport (#GNUNET_NO)
*/
int test_core;
*/
struct BenchmarkState state;
- struct GNUNET_CORE_MessageHandler *handlers;
-
- GNUNET_TRANSPORT_ReceiveCallback transport_recv_cb;
-
GNUNET_ATS_TEST_TopologySetupDoneCallback done_cb;
+
GNUNET_ATS_AddressInformationCallback ats_perf_cb;
+
void *done_cb_cls;
};
struct Experiment;
-typedef void (*GNUNET_ATS_TESTING_EpisodeDoneCallback) (
- struct Episode *e);
+typedef void
+(*GNUNET_ATS_TESTING_EpisodeDoneCallback) (struct Episode *e);
-typedef void (*GNUNET_ATS_TESTING_ExperimentDoneCallback) (struct Experiment *e,
- struct GNUNET_TIME_Relative duration,int success);
+typedef void
+(*GNUNET_ATS_TESTING_ExperimentDoneCallback) (struct Experiment *e,
+ struct GNUNET_TIME_Relative duration,
+ int success);
/**
* An operation in an experiment
GNUNET_ATS_TESTING_ExperimentDoneCallback e_done_cb;
};
-/*
- * Experiment related functions
- */
+
extern struct GNUNET_CONFIGURATION_Handle *cfg;
/**
*/
void
GNUNET_ATS_TEST_experimentation_run (struct Experiment *e,
- GNUNET_ATS_TESTING_EpisodeDoneCallback ep_done_cb,
- GNUNET_ATS_TESTING_ExperimentDoneCallback e_done_cb);
+ GNUNET_ATS_TESTING_EpisodeDoneCallback ep_done_cb,
+ GNUNET_ATS_TESTING_ExperimentDoneCallback e_done_cb);
+
/**
* Load an experiment from a file
* @return the Experiment or NULL on failure
*/
struct Experiment *
-GNUNET_ATS_TEST_experimentation_load (char *filename);
+GNUNET_ATS_TEST_experimentation_load (const char *filename);
/**
void
GNUNET_ATS_TEST_experimentation_stop (struct Experiment *e);
-/*
- * Traffic related functions
- */
void
GNUNET_ATS_TEST_traffic_handle_ping (struct BenchmarkPartner *p);
+
void
GNUNET_ATS_TEST_traffic_handle_pong (struct BenchmarkPartner *p);
void
GNUNET_ATS_TEST_generate_traffic_stop (struct TrafficGenerator *tg);
+
/**
* Stop all traffic generators
*/
void
-GNUNET_ATS_TEST_generate_traffic_stop_all ();
+GNUNET_ATS_TEST_generate_traffic_stop_all (void);
+
/**
* Generate between the source master and the partner and set preferences with a
struct GNUNET_TIME_Relative frequency,
enum GNUNET_ATS_PreferenceKind kind);
+
void
GNUNET_ATS_TEST_generate_preferences_stop (struct PreferenceGenerator *pg);
+
void
-GNUNET_ATS_TEST_generate_preferences_stop_all ();
+GNUNET_ATS_TEST_generate_preferences_stop_all (void);
-/*
- * Logging related functions
- */
/**
* Start logging
* @return the logging handle or NULL on error
*/
struct LoggingHandle *
-GNUNET_ATS_TEST_logging_start(struct GNUNET_TIME_Relative log_frequency,
- char *testname, struct BenchmarkPeer *masters, int num_masters, int num_slaves,
- int verbose);
+GNUNET_ATS_TEST_logging_start (struct GNUNET_TIME_Relative log_frequency,
+ const char *testname,
+ struct BenchmarkPeer *masters,
+ int num_masters,
+ int num_slaves,
+ int verbose);
+
/**
* Stop logging
void
GNUNET_ATS_TEST_logging_clean_up (struct LoggingHandle *l);
+
/**
* Stop logging
*
void
GNUNET_ATS_TEST_logging_stop (struct LoggingHandle *l);
+
/**
* Log all data now
*
*
* @param l logging handle to use
* @param test_name name of the current test
- * @param plots create gnuplots: GNUNET_YES or GNUNET_NO
+ * @param plots create gnuplots: #GNUNET_YES or #GNUNET_NO
*/
void
GNUNET_ATS_TEST_logging_write_to_file (struct LoggingHandle *l,
- char *test_name, int plots);
+ const char *test_name,
+ int plots);
-/*
+
+/**
* Topology related functions
*/
-
struct BenchmarkPeer *
GNUNET_ATS_TEST_get_peer (int src);
+
struct BenchmarkPartner *
GNUNET_ATS_TEST_get_partner (int src, int dest);
+
/**
* Create a topology for ats testing
*
* @param cfg_file configuration file to use for the peers
* @param num_slaves number of slaves
* @param num_masters number of masters
- * @param test_core connect to CORE service (GNUNET_YES) or transport (GNUNET_NO)
+ * @param test_core connect to CORE service (#GNUNET_YES) or transport (#GNUNET_NO)
* @param done_cb function to call when topology is setup
* @param done_cb_cls cls for callback
- * @param transport_recv_cb callback to call when data are received
* @param log_request_cb callback to call when logging is required
*/
void
-GNUNET_ATS_TEST_create_topology (char *name, char *cfg_file,
- unsigned int num_slaves,
- unsigned int num_masters,
- int test_core,
- GNUNET_ATS_TEST_TopologySetupDoneCallback done_cb,
- void *done_cb_cls,
- GNUNET_TRANSPORT_ReceiveCallback recv_cb,
- GNUNET_ATS_TEST_LogRequest ats_perf_cb);
+GNUNET_ATS_TEST_create_topology (char *name,
+ char *cfg_file,
+ unsigned int num_slaves,
+ unsigned int num_masters,
+ int test_core,
+ GNUNET_ATS_TEST_TopologySetupDoneCallback done_cb,
+ void *done_cb_cls,
+ GNUNET_ATS_TEST_LogRequest ats_perf_cb);
+
/**
* Shutdown topology
void
GNUNET_ATS_TEST_shutdown_topology (void);
+
/* end of file ats-testing.h */