diff options
Diffstat (limited to 'src/include/gnunet_testbed_service.h')
-rw-r--r-- | src/include/gnunet_testbed_service.h | 30 |
1 files changed, 28 insertions, 2 deletions
diff --git a/src/include/gnunet_testbed_service.h b/src/include/gnunet_testbed_service.h index e6997db1f..46be98b79 100644 --- a/src/include/gnunet_testbed_service.h +++ b/src/include/gnunet_testbed_service.h | |||
@@ -402,13 +402,39 @@ struct GNUNET_TESTBED_ControllerProc; | |||
402 | 402 | ||
403 | 403 | ||
404 | /** | 404 | /** |
405 | * Function called on errors with the controller. | ||
406 | * | ||
407 | * @param cls closure | ||
408 | * @param emsg error message if available; can be NULL, which does NOT mean | ||
409 | * that there was no error | ||
410 | */ | ||
411 | typedef void (*GNUNET_TESTBED_ControllerErrorCallback)(void *cls, | ||
412 | const char *emsg); | ||
413 | |||
414 | |||
415 | /** | ||
405 | * Starts a controller process at the host | 416 | * Starts a controller process at the host |
406 | * | 417 | * |
418 | * @param system used for reserving ports if host is NULL and to determine | ||
419 | * which 'host' to set as TRUSTED ('controller') when starting testbed remotely | ||
407 | * @param host the host where the controller has to be started; NULL for localhost | 420 | * @param host the host where the controller has to be started; NULL for localhost |
408 | * @return the controller process handle | 421 | * @param cfg template configuration to use for the remote controller; will |
422 | * be modified to contain the actual host/port/unixpath used for | ||
423 | * the testbed service | ||
424 | * @param cec function called if the contoller dies unexpectedly; will not be | ||
425 | * invoked after GNUNET_TESTBED_controller_stop, if 'cec' was called, | ||
426 | * GNUNET_TESTBED_controller_stop must no longer be called; will | ||
427 | * never be called in the same task as 'GNUNET_TESTBED_controller_start' | ||
428 | * (synchronous errors will be signalled by returning NULL) | ||
429 | * @param cec_cls closure for 'cec' | ||
430 | * @return the controller process handle, NULL on errors | ||
409 | */ | 431 | */ |
410 | struct GNUNET_TESTBED_ControllerProc * | 432 | struct GNUNET_TESTBED_ControllerProc * |
411 | GNUNET_TESTBED_controller_start (struct GNUNET_TESTBED_Host *host); | 433 | GNUNET_TESTBED_controller_start (struct GNUNET_TESTING_System *system, |
434 | struct GNUNET_TESTBED_Host *host, | ||
435 | struct GNUNET_CONFIGURATION_Handle *cfg, | ||
436 | GNUNET_TESTBED_ControllerErrorCallback cec, | ||
437 | void *cec_cls); | ||
412 | 438 | ||
413 | 439 | ||
414 | /** | 440 | /** |