GNUnet  0.11.x
Data Structures | Macros | Functions
testing.c File Reference

convenience API for writing testcases for GNUnet Many testcases need to start and stop a peer/service and this library is supposed to make that easier for TESTCASES. More...

#include "platform.h"
#include "gnunet_util_lib.h"
#include "gnunet_arm_service.h"
#include "gnunet_testing_lib.h"
Include dependency graph for testing.c:

Go to the source code of this file.

Data Structures

struct  SharedServiceInstance
 
struct  SharedService
 The structure for identifying a shared service. More...
 
struct  GNUNET_TESTING_System
 Handle for a system on which GNUnet peers are executed; a system is used for reserving unique paths and ports. More...
 
struct  GNUNET_TESTING_Peer
 Handle for a GNUnet peer controlled by testing. More...
 
struct  UpdateContext
 Closure for update_rel_sum() and update_abs_sum(). More...
 
struct  ServiceContext
 Structure for holding service data. More...
 

Macros

#define LOG(kind, ...)   GNUNET_log_from (kind, "testing-api", __VA_ARGS__)
 
#define PIPE_CONTROL   GNUNET_NO
 We need pipe control only on WINDOWS. More...
 
#define LOW_PORT   12000
 Lowest port used for GNUnet testing. More...
 
#define HIGH_PORT   56000
 Highest port used for GNUnet testing. More...
 

Functions

static int hostkeys_load (struct GNUNET_TESTING_System *system)
 Testing includes a number of pre-created hostkeys for faster peer startup. More...
 
static void hostkeys_unload (struct GNUNET_TESTING_System *system)
 Function to remove the loaded hostkeys. More...
 
static void cfg_copy_iterator (void *cls, const char *section, const char *option, const char *value)
 Function to iterate over options. More...
 
struct GNUNET_TESTING_SystemGNUNET_TESTING_system_create_with_portrange (const char *testdir, const char *trusted_ip, const char *hostname, const struct GNUNET_TESTING_SharedService *shared_services, uint16_t lowport, uint16_t highport)
 Create a system handle. More...
 
struct GNUNET_TESTING_SystemGNUNET_TESTING_system_create (const char *testdir, const char *trusted_ip, const char *hostname, const struct GNUNET_TESTING_SharedService *shared_services)
 Create a system handle. More...
 
static void cleanup_shared_service_instance (struct SharedServiceInstance *i)
 
static int start_shared_service_instance (struct SharedServiceInstance *i)
 
static void stop_shared_service_instance (struct SharedServiceInstance *i)
 
void GNUNET_TESTING_system_destroy (struct GNUNET_TESTING_System *system, int remove_paths)
 Free system resources. More...
 
uint16_t GNUNET_TESTING_reserve_port (struct GNUNET_TESTING_System *system)
 Reserve a TCP or UDP port for a peer. More...
 
void GNUNET_TESTING_release_port (struct GNUNET_TESTING_System *system, uint16_t port)
 Release reservation of a TCP or UDP port for a peer (used during GNUNET_TESTING_peer_destroy()). More...
 
struct GNUNET_CRYPTO_EddsaPrivateKeyGNUNET_TESTING_hostkey_get (const struct GNUNET_TESTING_System *system, uint32_t key_number, struct GNUNET_PeerIdentity *id)
 Testing includes a number of pre-created hostkeys for faster peer startup. More...
 
static void update_config (void *cls, const char *section, const char *option, const char *value)
 Function to iterate over options. More...
 
static void update_config_sections (void *cls, const char *section)
 Section iterator to set ACCEPT_FROM/ACCEPT_FROM6 to include the address of 'trusted_hosts' in all sections. More...
 
static struct SharedServiceInstanceassociate_shared_service (struct GNUNET_TESTING_System *system, struct SharedService *ss, struct GNUNET_CONFIGURATION_Handle *cfg)
 
static int GNUNET_TESTING_configuration_create_ (struct GNUNET_TESTING_System *system, struct GNUNET_CONFIGURATION_Handle *cfg, uint16_t **ports, unsigned int *nports)
 Create a new configuration using the given configuration as a template; ports and paths will be modified to select available ports on the local system. More...
 
int GNUNET_TESTING_configuration_create (struct GNUNET_TESTING_System *system, struct GNUNET_CONFIGURATION_Handle *cfg)
 Create a new configuration using the given configuration as a template; ports and paths will be modified to select available ports on the local system. More...
 
struct GNUNET_TESTING_PeerGNUNET_TESTING_peer_configure (struct GNUNET_TESTING_System *system, struct GNUNET_CONFIGURATION_Handle *cfg, uint32_t key_number, struct GNUNET_PeerIdentity *id, char **emsg)
 Configure a GNUnet peer. More...
 
void GNUNET_TESTING_peer_get_identity (struct GNUNET_TESTING_Peer *peer, struct GNUNET_PeerIdentity *id)
 Obtain the peer identity from a peer handle. More...
 
int GNUNET_TESTING_peer_start (struct GNUNET_TESTING_Peer *peer)
 Start the peer. More...
 
int GNUNET_TESTING_peer_kill (struct GNUNET_TESTING_Peer *peer)
 Sends SIGTERM to the peer's main process. More...
 
int GNUNET_TESTING_peer_wait (struct GNUNET_TESTING_Peer *peer)
 Waits for a peer to terminate. More...
 
int GNUNET_TESTING_peer_stop (struct GNUNET_TESTING_Peer *peer)
 Stop the peer. More...
 
static void disconn_status (void *cls, int connected)
 Function called whenever we connect to or disconnect from ARM. More...
 
int GNUNET_TESTING_peer_stop_async (struct GNUNET_TESTING_Peer *peer, GNUNET_TESTING_PeerStopCallback cb, void *cb_cls)
 Stop a peer asynchronously using ARM API. More...
 
void GNUNET_TESTING_peer_stop_async_cancel (struct GNUNET_TESTING_Peer *peer)
 Cancel a previous asynchronous peer stop request. More...
 
void GNUNET_TESTING_peer_destroy (struct GNUNET_TESTING_Peer *peer)
 Destroy the peer. More...
 
int GNUNET_TESTING_peer_run (const char *testdir, const char *cfgfilename, GNUNET_TESTING_TestMain tm, void *tm_cls)
 Start a single peer and run a test using the testing library. More...
 
static void service_run_main (void *cls)
 Callback to be called when SCHEDULER has been started. More...
 
int GNUNET_TESTING_service_run (const char *testdir, const char *service_name, const char *cfgfilename, GNUNET_TESTING_TestMain tm, void *tm_cls)
 Start a single service (no ARM, except of course if the given service name is 'arm') and run a test using the testing library. More...
 
char * GNUNET_TESTING_get_testname_from_underscore (const char *argv0)
 Sometimes we use the binary name to determine which specific test to run. More...
 

Detailed Description

convenience API for writing testcases for GNUnet Many testcases need to start and stop a peer/service and this library is supposed to make that easier for TESTCASES.

Normal programs should always use functions from gnunet_{util,arm}_lib.h. This API is ONLY for writing testcases (or internal use of the testbed).

Author
Christian Grothoff

Definition in file testing.c.

Macro Definition Documentation

◆ LOG

#define LOG (   kind,
  ... 
)    GNUNET_log_from (kind, "testing-api", __VA_ARGS__)

◆ PIPE_CONTROL

#define PIPE_CONTROL   GNUNET_NO

We need pipe control only on WINDOWS.

Definition at line 43 of file testing.c.

Referenced by GNUNET_TESTING_peer_start(), and start_shared_service_instance().

◆ LOW_PORT

#define LOW_PORT   12000

Lowest port used for GNUnet testing.

Should be high enough to not conflict with other applications running on the hosts but be low enough to not conflict with client-ports (typically starting around 32k).

Definition at line 52 of file testing.c.

Referenced by GNUNET_TESTING_system_create().

◆ HIGH_PORT

#define HIGH_PORT   56000

Highest port used for GNUnet testing.

Should be low enough to not conflict with the port range for "local" ports (client apps; see /proc/sys/net/ipv4/ip_local_port_range on Linux for example).

Definition at line 59 of file testing.c.

Referenced by GNUNET_TESTING_system_create().

Function Documentation

◆ hostkeys_load()

static int hostkeys_load ( struct GNUNET_TESTING_System system)
static

Testing includes a number of pre-created hostkeys for faster peer startup.

This function loads such keys into memory from a file.

Parameters
systemthe testing system handle
Returns
GNUNET_OK on success; GNUNET_SYSERR on error

Definition at line 252 of file testing.c.

References _, GNUNET_DISK_FileHandle::fd, filename, fs, GNUNET_asprintf(), GNUNET_assert, GNUNET_DISK_file_close(), GNUNET_DISK_file_map(), GNUNET_DISK_file_open(), GNUNET_DISK_file_size(), GNUNET_DISK_file_test(), GNUNET_DISK_MAP_TYPE_READ, GNUNET_DISK_OPEN_READ, GNUNET_DISK_PERM_NONE, GNUNET_ERROR_TYPE_ERROR, GNUNET_free, GNUNET_log_strerror_file, GNUNET_OK, GNUNET_OS_installation_get_path(), GNUNET_OS_IPK_DATADIR, GNUNET_SYSERR, GNUNET_TESTING_HOSTKEYFILESIZE, GNUNET_YES, GNUNET_TESTING_System::hostkeys_data, LOG, GNUNET_TESTING_System::map, and GNUNET_TESTING_System::total_hostkeys.

Referenced by GNUNET_TESTING_system_create_with_portrange().

253 {
254  uint64_t fs;
255  char *data_dir;
256  char *filename;
257  struct GNUNET_DISK_FileHandle *fd;
258 
259  GNUNET_assert (NULL == system->hostkeys_data);
261  GNUNET_asprintf (&filename, "%s/testing_hostkeys.ecc", data_dir);
262  GNUNET_free (data_dir);
263 
264  if (GNUNET_YES != GNUNET_DISK_file_test (filename))
265  {
267  _ ("Hostkeys file not found: %s\n"),
268  filename);
269  GNUNET_free (filename);
270  return GNUNET_SYSERR;
271  }
272  /* Check hostkey file size, read entire thing into memory */
273  if (GNUNET_OK !=
274  GNUNET_DISK_file_size (filename, &fs, GNUNET_YES, GNUNET_YES))
275  fs = 0;
276  if (0 == fs)
277  {
278  GNUNET_free (filename);
279  return GNUNET_SYSERR; /* File is empty */
280  }
281  if (0 != (fs % GNUNET_TESTING_HOSTKEYFILESIZE))
282  {
284  _ ("Incorrect hostkey file format: %s\n"),
285  filename);
286  GNUNET_free (filename);
287  return GNUNET_SYSERR;
288  }
289  fd = GNUNET_DISK_file_open (filename,
292  if (NULL == fd)
293  {
295  GNUNET_free (filename);
296  return GNUNET_SYSERR;
297  }
298  GNUNET_free (filename);
299  system->hostkeys_data =
302  if (NULL == system->hostkeys_data)
303  return GNUNET_SYSERR;
305  return GNUNET_OK;
306 }
int GNUNET_DISK_file_test(const char *fil)
Check that fil corresponds to a filename (of a file that exists and that is not a directory)...
Definition: disk.c:544
Open the file for reading.
int GNUNET_DISK_file_close(struct GNUNET_DISK_FileHandle *h)
Close an open file.
Definition: disk.c:1345
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
#define LOG(kind,...)
Definition: testing.c:37
void * GNUNET_DISK_file_map(const struct GNUNET_DISK_FileHandle *h, struct GNUNET_DISK_MapHandle **m, enum GNUNET_DISK_MapType access, size_t len)
Map a file into memory.
Definition: disk.c:1440
Nobody is allowed to do anything to the file.
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
#define GNUNET_TESTING_HOSTKEYFILESIZE
Size of each hostkey in the hostkey file (in BYTES).
uint32_t total_hostkeys
The number of hostkeys.
Definition: testing.c:153
#define _(String)
GNU gettext support macro.
Definition: platform.h:181
int GNUNET_asprintf(char **buf, const char *format,...)
Like asprintf, just portable.
#define GNUNET_log_strerror_file(level, cmd, filename)
Log an error message at log-level 'level' that indicates a failure of the command 'cmd' with the mess...
char * GNUNET_OS_installation_get_path(enum GNUNET_OS_InstallationPathKind dirkind)
Get the path to a specific GNUnet installation directory or, with GNUNET_OS_IPK_SELF_PREFIX, the current running apps installation directory.
Read-only memory map.
static char * filename
#define GNUNET_SYSERR
Definition: gnunet_common.h:76
static struct GNUNET_FS_Handle * fs
Handle to FS service.
Definition: gnunet-fs.c:36
int GNUNET_DISK_file_size(const char *filename, uint64_t *size, int include_symbolic_links, int single_file_mode)
Get the size of the file (or directory) of the given file (in bytes).
Definition: disk.c:257
struct GNUNET_DISK_MapHandle * map
memory map for hostkeys_data.
Definition: testing.c:124
char * hostkeys_data
Hostkeys data, contains "GNUNET_TESTING_HOSTKEYFILESIZE * total_hostkeys" bytes.
Definition: testing.c:119
#define GNUNET_YES
Definition: gnunet_common.h:77
int fd
File handle on Unix-like systems.
struct GNUNET_DISK_FileHandle * GNUNET_DISK_file_open(const char *fn, enum GNUNET_DISK_OpenFlags flags, enum GNUNET_DISK_AccessPermissions perm)
Open a file.
Definition: disk.c:1268
Handle used to access files (and pipes).
Return the directory where data is installed (share/gnunet/)
#define GNUNET_free(ptr)
Wrapper around free.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ hostkeys_unload()

static void hostkeys_unload ( struct GNUNET_TESTING_System system)
static

Function to remove the loaded hostkeys.

Parameters
systemthe testing system handle

Definition at line 315 of file testing.c.

References GNUNET_break, GNUNET_DISK_file_unmap(), GNUNET_TESTING_System::hostkeys_data, GNUNET_TESTING_System::map, and GNUNET_TESTING_System::total_hostkeys.

Referenced by GNUNET_TESTING_service_run(), and GNUNET_TESTING_system_destroy().

316 {
317  GNUNET_break (NULL != system->hostkeys_data);
318  system->hostkeys_data = NULL;
319  GNUNET_DISK_file_unmap (system->map);
320  system->map = NULL;
321  system->hostkeys_data = NULL;
322  system->total_hostkeys = 0;
323 }
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
uint32_t total_hostkeys
The number of hostkeys.
Definition: testing.c:153
int GNUNET_DISK_file_unmap(struct GNUNET_DISK_MapHandle *h)
Unmap a file.
Definition: disk.c:1477
struct GNUNET_DISK_MapHandle * map
memory map for hostkeys_data.
Definition: testing.c:124
char * hostkeys_data
Hostkeys data, contains "GNUNET_TESTING_HOSTKEYFILESIZE * total_hostkeys" bytes.
Definition: testing.c:119
Here is the call graph for this function:
Here is the caller graph for this function:

◆ cfg_copy_iterator()

static void cfg_copy_iterator ( void *  cls,
const char *  section,
const char *  option,
const char *  value 
)
static

Function to iterate over options.

Parameters
clsclosure
sectionname of the section
optionname of the option
valuevalue of the option

Definition at line 335 of file testing.c.

References GNUNET_CONFIGURATION_set_value_string().

Referenced by associate_shared_service(), and GNUNET_TESTING_system_create_with_portrange().

339 {
340  struct GNUNET_CONFIGURATION_Handle *cfg2 = cls;
341 
343 }
static char * section
Name of the section.
Definition: gnunet-config.c:33
static char * value
Value of the record to add/remove.
static char * option
Name of the option.
Definition: gnunet-config.c:38
void GNUNET_CONFIGURATION_set_value_string(struct GNUNET_CONFIGURATION_Handle *cfg, const char *section, const char *option, const char *value)
Set a configuration value that should be a string.
configuration data
Definition: configuration.c:85
Here is the call graph for this function:
Here is the caller graph for this function:

◆ cleanup_shared_service_instance()

static void cleanup_shared_service_instance ( struct SharedServiceInstance i)
static

Definition at line 469 of file testing.c.

References SharedServiceInstance::cfg_fn, GNUNET_break, GNUNET_free, GNUNET_free_non_null, SharedServiceInstance::n_refs, SharedServiceInstance::port_str, SharedServiceInstance::proc, and SharedServiceInstance::unix_sock.

Referenced by associate_shared_service(), and GNUNET_TESTING_system_destroy().

470 {
471  if (NULL != i->cfg_fn)
472  {
473  (void) unlink (i->cfg_fn);
474  GNUNET_free (i->cfg_fn);
475  }
478  GNUNET_break (NULL == i->proc);
479  GNUNET_break (0 == i->n_refs);
480  GNUNET_free (i);
481 }
struct GNUNET_OS_Process * proc
Definition: testing.c:68
#define GNUNET_free_non_null(ptr)
Free the memory pointed to by ptr if ptr is not NULL.
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
unsigned int n_refs
Definition: testing.c:74
#define GNUNET_free(ptr)
Wrapper around free.
Here is the caller graph for this function:

◆ start_shared_service_instance()

static int start_shared_service_instance ( struct SharedServiceInstance i)
static

Definition at line 485 of file testing.c.

References SharedServiceInstance::cfg_fn, GNUNET_asprintf(), GNUNET_assert, GNUNET_free, GNUNET_OK, GNUNET_OS_get_libexec_binary_path(), GNUNET_OS_INHERIT_STD_OUT_AND_ERR, GNUNET_OS_start_process(), GNUNET_SYSERR, PIPE_CONTROL, SharedServiceInstance::proc, SharedService::sname, and SharedServiceInstance::ss.

Referenced by GNUNET_TESTING_peer_start().

486 {
487  char *binary;
488  char *libexec_binary;
489 
490  GNUNET_assert (NULL == i->proc);
491  GNUNET_assert (NULL != i->cfg_fn);
492  (void) GNUNET_asprintf (&binary, "gnunet-service-%s", i->ss->sname);
493  libexec_binary = GNUNET_OS_get_libexec_binary_path (binary);
494  GNUNET_free (binary);
497  NULL,
498  NULL,
499  NULL,
500  libexec_binary,
501  libexec_binary,
502  "-c",
503  i->cfg_fn,
504  NULL);
505  GNUNET_free (libexec_binary);
506  if (NULL == i->proc)
507  return GNUNET_SYSERR;
508  return GNUNET_OK;
509 }
#define PIPE_CONTROL
We need pipe control only on WINDOWS.
Definition: testing.c:43
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
struct GNUNET_OS_Process * GNUNET_OS_start_process(int pipe_control, enum GNUNET_OS_InheritStdioFlags std_inheritance, struct GNUNET_DISK_PipeHandle *pipe_stdin, struct GNUNET_DISK_PipeHandle *pipe_stdout, struct GNUNET_DISK_PipeHandle *pipe_stderr, const char *filename,...)
Start a process.
Definition: os_priority.c:687
struct GNUNET_OS_Process * proc
Definition: testing.c:68
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
int GNUNET_asprintf(char **buf, const char *format,...)
Like asprintf, just portable.
char * sname
Definition: testing.c:79
When these flags are set, the child process will inherit stdout and stderr of the parent...
Definition: gnunet_os_lib.h:97
#define GNUNET_SYSERR
Definition: gnunet_common.h:76
struct SharedService * ss
Definition: testing.c:64
char * GNUNET_OS_get_libexec_binary_path(const char *progname)
Given the name of a gnunet-helper, gnunet-service or gnunet-daemon binary, try to prefix it with the ...
#define GNUNET_free(ptr)
Wrapper around free.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ stop_shared_service_instance()

static void stop_shared_service_instance ( struct SharedServiceInstance i)
static

Definition at line 513 of file testing.c.

References GNUNET_break, GNUNET_ERROR_TYPE_WARNING, GNUNET_OS_process_destroy(), GNUNET_OS_process_kill(), GNUNET_OS_process_wait(), GNUNET_TERM_SIG, LOG, SharedServiceInstance::n_refs, SharedServiceInstance::proc, SharedService::sname, and SharedServiceInstance::ss.

Referenced by GNUNET_TESTING_peer_kill(), and GNUNET_TESTING_system_destroy().

514 {
515  GNUNET_break (0 == i->n_refs);
518  "Killing shared service instance (%s) failed\n",
519  i->ss->sname);
520  (void) GNUNET_OS_process_wait (i->proc);
522  i->proc = NULL;
523 }
void GNUNET_OS_process_destroy(struct GNUNET_OS_Process *proc)
Cleans up process structure contents (OS-dependent) and deallocates it.
Definition: os_priority.c:287
#define LOG(kind,...)
Definition: testing.c:37
struct GNUNET_OS_Process * proc
Definition: testing.c:68
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
char * sname
Definition: testing.c:79
unsigned int n_refs
Definition: testing.c:74
struct SharedService * ss
Definition: testing.c:64
int GNUNET_OS_process_wait(struct GNUNET_OS_Process *proc)
Wait for a process to terminate.
Definition: os_priority.c:1000
#define GNUNET_TERM_SIG
The termination signal.
Definition: platform.h:242
int GNUNET_OS_process_kill(struct GNUNET_OS_Process *proc, int sig)
Sends a signal to the process.
Definition: os_priority.c:225
Here is the call graph for this function:
Here is the caller graph for this function:

◆ update_config()

static void update_config ( void *  cls,
const char *  section,
const char *  option,
const char *  value 
)
static

Function to iterate over options.

Copies the options to the target configuration, updating PORT values as needed.

Parameters
clsthe UpdateContext
sectionname of the section
optionname of the option
valuevalue of the option

Definition at line 786 of file testing.c.

References UpdateContext::cfg, GNUNET_array_append, GNUNET_asprintf(), GNUNET_break, GNUNET_CONFIGURATION_get_value_number(), GNUNET_CONFIGURATION_get_value_yesno(), GNUNET_CONFIGURATION_set_value_string(), GNUNET_free, UpdateContext::gnunet_home, GNUNET_OK, GNUNET_snprintf(), GNUNET_SYSERR, GNUNET_TESTING_reserve_port(), GNUNET_YES, GNUNET_TESTING_System::hostname, UpdateContext::nports, PATH_MAX, UpdateContext::ports, UpdateContext::status, UpdateContext::system, and uc.

Referenced by GNUNET_TESTING_configuration_create_().

790 {
791  struct UpdateContext *uc = cls;
792  unsigned int ival;
793  char cval[12];
794  char uval[PATH_MAX];
795  char *single_variable;
796  char *per_host_variable;
797  unsigned long long num_per_host;
798  uint16_t new_port;
799 
800  if (GNUNET_OK != uc->status)
801  return;
802  if (! ((0 == strcmp (option, "PORT")) || (0 == strcmp (option, "UNIXPATH")) ||
803  (0 == strcmp (option, "HOSTNAME"))))
804  return;
805  GNUNET_asprintf (&single_variable, "single_%s_per_host", section);
806  GNUNET_asprintf (&per_host_variable, "num_%s_per_host", section);
807  if ((0 == strcmp (option, "PORT")) && (1 == sscanf (value, "%u", &ival)))
808  {
809  if ((ival != 0) &&
811  "testing",
812  single_variable)))
813  {
814  new_port = GNUNET_TESTING_reserve_port (uc->system);
815  if (0 == new_port)
816  {
817  uc->status = GNUNET_SYSERR;
818  GNUNET_free (single_variable);
819  GNUNET_free (per_host_variable);
820  return;
821  }
822  GNUNET_snprintf (cval, sizeof(cval), "%u", new_port);
823  value = cval;
824  GNUNET_array_append (uc->ports, uc->nports, new_port);
825  }
826  else if ((ival != 0) &&
827  (GNUNET_YES ==
829  "testing",
830  single_variable)) &&
832  "testing",
833  per_host_variable,
834  &num_per_host))
835  {
836  /* GNUNET_snprintf (cval, sizeof (cval), "%u", */
837  /* ival + ctx->fdnum % num_per_host); */
838  /* value = cval; */
839  GNUNET_break (0); /* FIXME */
840  }
841  }
842  if (0 == strcmp (option, "UNIXPATH"))
843  {
845  "testing",
846  single_variable))
847  {
848  GNUNET_snprintf (uval,
849  sizeof(uval),
850  "%s/%s.sock",
851  uc->gnunet_home,
852  section);
853  value = uval;
854  }
855  else if ((GNUNET_YES ==
857  "testing",
858  per_host_variable,
859  &num_per_host)) &&
860  (num_per_host > 0))
861  {
862  GNUNET_break (0); /* FIXME */
863  }
864  }
865  if (0 == strcmp (option, "HOSTNAME"))
866  {
867  value = (NULL == uc->system->hostname) ? "localhost" : uc->system->hostname;
868  }
869  GNUNET_free (single_variable);
870  GNUNET_free (per_host_variable);
872 }
struct GNUNET_CONFIGURATION_Handle * cfg
The configuration we are building.
Definition: testing.c:749
Closure for update_rel_sum() and update_abs_sum().
int GNUNET_CONFIGURATION_get_value_number(const struct GNUNET_CONFIGURATION_Handle *cfg, const char *section, const char *option, unsigned long long *number)
Get a configuration value that should be a number.
char * gnunet_home
The customized service home path for this peer.
Definition: testing.c:754
int GNUNET_snprintf(char *buf, size_t size, const char *format,...)
Like snprintf, just aborts if the buffer is of insufficient size.
uint16_t * ports
Array of ports currently allocated to this peer.
Definition: testing.c:761
static struct GNUNET_FS_UnindexContext * uc
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
static char * section
Name of the section.
Definition: gnunet-config.c:33
int GNUNET_asprintf(char **buf, const char *format,...)
Like asprintf, just portable.
static char * value
Value of the record to add/remove.
static char * option
Name of the option.
Definition: gnunet-config.c:38
#define PATH_MAX
Assumed maximum path length.
Definition: platform.h:249
void GNUNET_CONFIGURATION_set_value_string(struct GNUNET_CONFIGURATION_Handle *cfg, const char *section, const char *option, const char *value)
Set a configuration value that should be a string.
unsigned int nports
The number of ports in the above array.
Definition: testing.c:766
#define GNUNET_SYSERR
Definition: gnunet_common.h:76
#define GNUNET_array_append(arr, size, element)
Append an element to a list (growing the list by one).
uint16_t GNUNET_TESTING_reserve_port(struct GNUNET_TESTING_System *system)
Reserve a TCP or UDP port for a peer.
Definition: testing.c:576
char * hostname
our hostname
Definition: testing.c:114
#define GNUNET_YES
Definition: gnunet_common.h:77
struct GNUNET_TESTING_System * system
The system for which we are building configurations.
Definition: testing.c:744
int status
build status - to signal error while building a configuration
Definition: testing.c:771
int GNUNET_CONFIGURATION_get_value_yesno(const struct GNUNET_CONFIGURATION_Handle *cfg, const char *section, const char *option)
Get a configuration value that should be in a set of "YES" or "NO".
#define GNUNET_free(ptr)
Wrapper around free.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ update_config_sections()

static void update_config_sections ( void *  cls,
const char *  section 
)
static

Section iterator to set ACCEPT_FROM/ACCEPT_FROM6 to include the address of 'trusted_hosts' in all sections.

Parameters
clsthe UpdateContext
sectionname of the section

Definition at line 883 of file testing.c.

References UpdateContext::cfg, GNUNET_asprintf(), GNUNET_assert, GNUNET_break, GNUNET_CONFIGURATION_get_value_string(), GNUNET_CONFIGURATION_have_value(), GNUNET_CONFIGURATION_set_value_string(), GNUNET_free, GNUNET_free_non_null, GNUNET_malloc, GNUNET_OK, GNUNET_strdup, GNUNET_YES, key, UpdateContext::system, GNUNET_TESTING_System::trusted_ip, and uc.

Referenced by GNUNET_TESTING_configuration_create_().

884 {
885  struct UpdateContext *uc = cls;
886  char **ikeys;
887  char *val;
888  char *ptr;
889  char *orig_allowed_hosts;
890  char *allowed_hosts;
891  char *ACCEPT_FROM_key;
892  uint16_t ikeys_cnt;
893  uint16_t key;
894 
895  ikeys_cnt = 0;
896  val = NULL;
897  /* Ignore certain options from sections. See
898  https://gnunet.org/bugs/view.php?id=2476 */
899  if (GNUNET_YES ==
900  GNUNET_CONFIGURATION_have_value (uc->cfg, section, "TESTING_IGNORE_KEYS"))
901  {
904  section,
905  "TESTING_IGNORE_KEYS",
906  &val));
907  ptr = val;
908  for (ikeys_cnt = 0; NULL != (ptr = strstr (ptr, ";")); ikeys_cnt++)
909  ptr++;
910  if (0 == ikeys_cnt)
911  GNUNET_break (0);
912  else
913  {
914  ikeys = GNUNET_malloc ((sizeof(char *)) * ikeys_cnt);
915  ptr = val;
916  for (key = 0; key < ikeys_cnt; key++)
917  {
918  ikeys[key] = ptr;
919  ptr = strstr (ptr, ";");
920  GNUNET_assert (NULL != ptr); /* worked just before... */
921  *ptr = '\0';
922  ptr++;
923  }
924  }
925  }
926  if (0 != ikeys_cnt)
927  {
928  for (key = 0; key < ikeys_cnt; key++)
929  {
930  if (NULL != strstr (ikeys[key], "ADVERTISED_PORT"))
931  break;
932  }
933  if ((key == ikeys_cnt) &&
934  (GNUNET_YES ==
935  GNUNET_CONFIGURATION_have_value (uc->cfg, section, "ADVERTISED_PORT")))
936  {
938  section,
939  "PORT",
940  &ptr))
941  {
943  section,
944  "ADVERTISED_PORT",
945  ptr);
946  GNUNET_free (ptr);
947  }
948  }
949  for (key = 0; key < ikeys_cnt; key++)
950  {
951  if (NULL != strstr (ikeys[key], "ACCEPT_FROM"))
952  {
953  GNUNET_free (ikeys);
954  GNUNET_free (val);
955  return;
956  }
957  }
958  GNUNET_free (ikeys);
959  }
960  GNUNET_free_non_null (val);
961  ACCEPT_FROM_key = "ACCEPT_FROM";
962  if ((NULL != uc->system->trusted_ip) &&
963  (NULL != strstr (uc->system->trusted_ip, ":"))) /* IPv6 in use */
964  ACCEPT_FROM_key = "ACCEPT_FROM6";
966  section,
967  ACCEPT_FROM_key,
968  &orig_allowed_hosts))
969  {
970  orig_allowed_hosts = GNUNET_strdup ("127.0.0.1;");
971  }
972  if (NULL == uc->system->trusted_ip)
973  allowed_hosts = GNUNET_strdup (orig_allowed_hosts);
974  else
975  GNUNET_asprintf (&allowed_hosts,
976  "%s%s;",
977  orig_allowed_hosts,
978  uc->system->trusted_ip);
979  GNUNET_free (orig_allowed_hosts);
981  section,
982  ACCEPT_FROM_key,
983  allowed_hosts);
984  GNUNET_free (allowed_hosts);
985 }
struct GNUNET_CONFIGURATION_Handle * cfg
The configuration we are building.
Definition: testing.c:749
Closure for update_rel_sum() and update_abs_sum().
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
static struct GNUNET_FS_UnindexContext * uc
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
#define GNUNET_free_non_null(ptr)
Free the memory pointed to by ptr if ptr is not NULL.
#define GNUNET_strdup(a)
Wrapper around GNUNET_xstrdup_.
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
static char * section
Name of the section.
Definition: gnunet-config.c:33
int GNUNET_asprintf(char **buf, const char *format,...)
Like asprintf, just portable.
int GNUNET_CONFIGURATION_have_value(const struct GNUNET_CONFIGURATION_Handle *cfg, const char *section, const char *option)
Test if we have a value for a particular option.
void GNUNET_CONFIGURATION_set_value_string(struct GNUNET_CONFIGURATION_Handle *cfg, const char *section, const char *option, const char *value)
Set a configuration value that should be a string.
int GNUNET_CONFIGURATION_get_value_string(const struct GNUNET_CONFIGURATION_Handle *cfg, const char *section, const char *option, char **value)
Get a configuration value that should be a string.
struct GNUNET_HashCode key
The key used in the DHT.
#define GNUNET_YES
Definition: gnunet_common.h:77
struct GNUNET_TESTING_System * system
The system for which we are building configurations.
Definition: testing.c:744
#define GNUNET_malloc(size)
Wrapper around malloc.
#define GNUNET_free(ptr)
Wrapper around free.
char * trusted_ip
The trusted ip.
Definition: testing.c:109
Here is the call graph for this function:
Here is the caller graph for this function:

◆ associate_shared_service()

static struct SharedServiceInstance* associate_shared_service ( struct GNUNET_TESTING_System system,
struct SharedService ss,
struct GNUNET_CONFIGURATION_Handle cfg 
)
static

Definition at line 989 of file testing.c.

References SharedService::cfg, cfg_copy_iterator(), SharedServiceInstance::cfg_fn, cleanup_shared_service_instance(), GNUNET_array_append, GNUNET_asprintf(), GNUNET_assert, GNUNET_CONFIGURATION_destroy(), GNUNET_CONFIGURATION_dup(), GNUNET_CONFIGURATION_iterate_section_values(), GNUNET_CONFIGURATION_set_value_string(), GNUNET_CONFIGURATION_write(), GNUNET_free, GNUNET_new, GNUNET_SYSERR, GNUNET_TESTING_reserve_port(), SharedService::instances, SharedService::n_instances, SharedService::n_peers, port, SharedServiceInstance::port_str, SharedService::share, SharedService::sname, SharedServiceInstance::ss, GNUNET_TESTING_System::tmppath, and SharedServiceInstance::unix_sock.

Referenced by GNUNET_TESTING_peer_configure().

992 {
993  struct SharedServiceInstance *i;
994  struct GNUNET_CONFIGURATION_Handle *temp;
995  char *gnunet_home;
996  uint32_t port;
997 
998  ss->n_peers++;
999  if (((0 == ss->share) && (NULL == ss->instances)) ||
1000  ((0 != ss->share) &&
1001  (ss->n_instances < ((ss->n_peers + ss->share - 1) / ss->share))))
1002  {
1003  i = GNUNET_new (struct SharedServiceInstance);
1004  i->ss = ss;
1005  (void) GNUNET_asprintf (&gnunet_home,
1006  "%s/shared/%s/%u",
1007  system->tmppath,
1008  ss->sname,
1009  ss->n_instances);
1010  (void) GNUNET_asprintf (&i->unix_sock, "%s/sock", gnunet_home);
1011  port = GNUNET_TESTING_reserve_port (system);
1012  if (0 == port)
1013  {
1014  GNUNET_free (gnunet_home);
1016  return NULL;
1017  }
1019  temp = GNUNET_CONFIGURATION_dup (ss->cfg);
1020  (void) GNUNET_asprintf (&i->port_str, "%u", port);
1021  (void) GNUNET_asprintf (&i->cfg_fn, "%s/config", gnunet_home);
1023  "PATHS",
1024  "GNUNET_HOME",
1025  gnunet_home);
1026  GNUNET_free (gnunet_home);
1028  ss->sname,
1029  "UNIXPATH",
1030  i->unix_sock);
1032  ss->sname,
1033  "PORT",
1034  i->port_str);
1036  {
1039  return NULL;
1040  }
1042  }
1043  else
1044  {
1045  GNUNET_assert (NULL != ss->instances);
1046  GNUNET_assert (0 < ss->n_instances);
1047  i = ss->instances[ss->n_instances - 1];
1048  }
1050  ss->sname,
1052  cfg);
1054  ss->sname,
1055  "UNIXPATH",
1056  i->unix_sock);
1057  GNUNET_CONFIGURATION_set_value_string (cfg, ss->sname, "PORT", i->port_str);
1058  return i;
1059 }
struct GNUNET_CONFIGURATION_Handle * cfg
Definition: testing.c:83
void GNUNET_CONFIGURATION_iterate_section_values(const struct GNUNET_CONFIGURATION_Handle *cfg, const char *section, GNUNET_CONFIGURATION_Iterator iter, void *iter_cls)
Iterate over values of a section in the configuration.
static void cleanup_shared_service_instance(struct SharedServiceInstance *i)
Definition: testing.c:469
int GNUNET_CONFIGURATION_write(struct GNUNET_CONFIGURATION_Handle *cfg, const char *filename)
Write configuration file.
unsigned int n_instances
Definition: testing.c:89
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
unsigned int share
Definition: testing.c:87
#define GNUNET_new(type)
Allocate a struct or union of the given type.
int GNUNET_asprintf(char **buf, const char *format,...)
Like asprintf, just portable.
unsigned int n_peers
Definition: testing.c:85
void GNUNET_CONFIGURATION_destroy(struct GNUNET_CONFIGURATION_Handle *cfg)
Destroy configuration object.
void GNUNET_CONFIGURATION_set_value_string(struct GNUNET_CONFIGURATION_Handle *cfg, const char *section, const char *option, const char *value)
Set a configuration value that should be a string.
char * sname
Definition: testing.c:79
#define GNUNET_SYSERR
Definition: gnunet_common.h:76
struct SharedService * ss
Definition: testing.c:64
struct GNUNET_CONFIGURATION_Handle * GNUNET_CONFIGURATION_dup(const struct GNUNET_CONFIGURATION_Handle *cfg)
Duplicate an existing configuration object.
#define GNUNET_array_append(arr, size, element)
Append an element to a list (growing the list by one).
static void cfg_copy_iterator(void *cls, const char *section, const char *option, const char *value)
Function to iterate over options.
Definition: testing.c:335
static uint16_t port
Port number.
Definition: gnunet-bcd.c:81
configuration data
Definition: configuration.c:85
struct SharedServiceInstance ** instances
Definition: testing.c:81
uint16_t GNUNET_TESTING_reserve_port(struct GNUNET_TESTING_System *system)
Reserve a TCP or UDP port for a peer.
Definition: testing.c:576
char * tmppath
Prefix (i.e.
Definition: testing.c:103
#define GNUNET_free(ptr)
Wrapper around free.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ GNUNET_TESTING_configuration_create_()

static int GNUNET_TESTING_configuration_create_ ( struct GNUNET_TESTING_System system,
struct GNUNET_CONFIGURATION_Handle cfg,
uint16_t **  ports,
unsigned int *  nports 
)
static

Create a new configuration using the given configuration as a template; ports and paths will be modified to select available ports on the local system.

The default configuration will be available in PATHS section under the option DEFAULTCONFIG after the call. GNUNET_HOME is also set in PATHS section to the temporary directory specific to this configuration. If we run out of "*port" numbers, return GNUNET_SYSERR.

This is primarily a helper function used internally by 'GNUNET_TESTING_peer_configure'.

Parameters
systemsystem to use to coordinate resource usage
cfgtemplate configuration to update
portsarray with port numbers used in the created configuration. Will be updated upon successful return. Can be NULL
nportsthe size of the `ports' array. Will be updated.
Returns
GNUNET_OK on success, GNUNET_SYSERR on error - the configuration will be incomplete and should not be used there upon

Definition at line 1082 of file testing.c.

References cfg, UpdateContext::cfg, GNUNET_asprintf(), GNUNET_CONFIGURATION_iterate(), GNUNET_CONFIGURATION_iterate_sections(), GNUNET_CONFIGURATION_set_value_string(), GNUNET_free, GNUNET_free_non_null, UpdateContext::gnunet_home, GNUNET_OK, UpdateContext::nports, GNUNET_TESTING_System::path_counter, UpdateContext::ports, UpdateContext::status, UpdateContext::system, GNUNET_TESTING_System::tmppath, update_config(), and update_config_sections().

Referenced by GNUNET_TESTING_configuration_create(), and GNUNET_TESTING_peer_configure().

1086 {
1087  struct UpdateContext uc;
1088  char *default_config;
1089 
1090  uc.system = system;
1091  uc.cfg = cfg;
1092  uc.status = GNUNET_OK;
1093  uc.ports = NULL;
1094  uc.nports = 0;
1095  GNUNET_asprintf (&uc.gnunet_home,
1096  "%s/%u",
1097  system->tmppath,
1098  system->path_counter++);
1099  GNUNET_asprintf (&default_config, "%s/config", uc.gnunet_home);
1101  "PATHS",
1102  "DEFAULTCONFIG",
1103  default_config);
1104  GNUNET_CONFIGURATION_set_value_string (cfg, "arm", "CONFIG", default_config);
1105  GNUNET_free (default_config);
1107  "PATHS",
1108  "GNUNET_HOME",
1109  uc.gnunet_home);
1110  /* make PORTs and UNIXPATHs unique */
1112  /* allow connections to services from system trusted_ip host */
1114  /* enable loopback-based connections between peers */
1115  GNUNET_CONFIGURATION_set_value_string (cfg, "nat", "USE_LOCALADDR", "YES");
1116  GNUNET_free (uc.gnunet_home);
1117  if ((NULL != ports) && (NULL != nports))
1118  {
1119  *ports = uc.ports;
1120  *nports = uc.nports;
1121  }
1122  else
1123  GNUNET_free_non_null (uc.ports);
1124  return uc.status;
1125 }
static void update_config(void *cls, const char *section, const char *option, const char *value)
Function to iterate over options.
Definition: testing.c:786
Closure for update_rel_sum() and update_abs_sum().
static const struct GNUNET_CONFIGURATION_Handle * cfg
Configuration we are using.
Definition: gnunet-abd.c:36
void GNUNET_CONFIGURATION_iterate(const struct GNUNET_CONFIGURATION_Handle *cfg, GNUNET_CONFIGURATION_Iterator iter, void *iter_cls)
Iterate over all options in the configuration.
uint16_t * ports
Array of ports currently allocated to this peer.
Definition: testing.c:761
static struct GNUNET_FS_UnindexContext * uc
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
#define GNUNET_free_non_null(ptr)
Free the memory pointed to by ptr if ptr is not NULL.
uint32_t path_counter
Counter we use to make service home paths unique on this system; the full path consists of the tmppat...
Definition: testing.c:148
int GNUNET_asprintf(char **buf, const char *format,...)
Like asprintf, just portable.
void GNUNET_CONFIGURATION_set_value_string(struct GNUNET_CONFIGURATION_Handle *cfg, const char *section, const char *option, const char *value)
Set a configuration value that should be a string.
unsigned int nports
The number of ports in the above array.
Definition: testing.c:766
static void update_config_sections(void *cls, const char *section)
Section iterator to set ACCEPT_FROM/ACCEPT_FROM6 to include the address of &#39;trusted_hosts&#39; in all sec...
Definition: testing.c:883
void GNUNET_CONFIGURATION_iterate_sections(const struct GNUNET_CONFIGURATION_Handle *cfg, GNUNET_CONFIGURATION_Section_Iterator iter, void *iter_cls)
Iterate over all sections in the configuration.
struct GNUNET_TESTING_System * system
The system for which we are building configurations.
Definition: testing.c:744
char * tmppath
Prefix (i.e.
Definition: testing.c:103
#define GNUNET_free(ptr)
Wrapper around free.
Here is the call graph for this function:
Here is the caller graph for this function:

◆ disconn_status()

static void disconn_status ( void *  cls,
int  connected 
)
static

Function called whenever we connect to or disconnect from ARM.

Parameters
clsclosure
connectedGNUNET_YES if connected, GNUNET_NO if disconnected, GNUNET_SYSERR on error.

Definition at line 1482 of file testing.c.

References GNUNET_TESTING_Peer::ah, GNUNET_TESTING_Peer::cb, GNUNET_TESTING_Peer::cb_cls, GNUNET_ARM_disconnect(), GNUNET_break, GNUNET_OK, GNUNET_SYSERR, GNUNET_TESTING_peer_kill(), GNUNET_TESTING_peer_wait(), GNUNET_YES, and peer.

Referenced by GNUNET_TESTING_peer_stop_async().

1483 {
1484  struct GNUNET_TESTING_Peer *peer = cls;
1485 
1486  if (GNUNET_SYSERR == connected)
1487  {
1488  peer->cb (peer->cb_cls, peer, connected);
1489  return;
1490  }
1491  if (GNUNET_YES == connected)
1492  {
1494  return;
1495  }
1497  GNUNET_ARM_disconnect (peer->ah);
1498  peer->ah = NULL;
1499  peer->cb (peer->cb_cls, peer, GNUNET_YES);
1500 }
Handle for a GNUnet peer controlled by testing.
Definition: testing.c:170
struct GNUNET_ARM_Handle * ah
The handle to the peer&#39;s ARM service.
Definition: testing.c:200
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
void GNUNET_ARM_disconnect(struct GNUNET_ARM_Handle *h)
Disconnect from the ARM service (if connected) and destroy the context.
Definition: arm_api.c:604
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur...
int GNUNET_TESTING_peer_kill(struct GNUNET_TESTING_Peer *peer)
Sends SIGTERM to the peer&#39;s main process.
Definition: testing.c:1409
void * cb_cls
The closure for the above callback.
Definition: testing.c:215
struct GNUNET_TESTBED_Peer * peer
The peer associated with this model.
#define GNUNET_SYSERR
Definition: gnunet_common.h:76
#define GNUNET_YES
Definition: gnunet_common.h:77
GNUNET_TESTING_PeerStopCallback cb
The callback to call asynchronously when a peer is stopped.
Definition: testing.c:210
int GNUNET_TESTING_peer_wait(struct GNUNET_TESTING_Peer *peer)
Waits for a peer to terminate.
Definition: testing.c:1441
Here is the call graph for this function:
Here is the caller graph for this function:

◆ service_run_main()

static void service_run_main ( void *  cls)
static

Callback to be called when SCHEDULER has been started.

Parameters
clsthe ServiceContext

Definition at line 1640 of file testing.c.

References ServiceContext::cfg, ServiceContext::peer, sc, ServiceContext::tm, and ServiceContext::tm_cls.

Referenced by GNUNET_TESTING_service_run().

1641 {
1642  struct ServiceContext *sc = cls;
1643 
1644  sc->tm (sc->tm_cls, sc->cfg, sc->peer);
1645 }
const struct GNUNET_CONFIGURATION_Handle * cfg
The configuration of the peer in which the service is run.
Definition: testing.c:1615
void * tm_cls
Closure for the above callback.
Definition: testing.c:1630
Structure for holding service data.
Definition: testing.c:1610
GNUNET_TESTING_TestMain tm
Callback to signal service startup.
Definition: testing.c:1620
static struct GNUNET_FS_SearchContext * sc
Definition: gnunet-search.c:37
struct GNUNET_TESTING_Peer * peer
The peer in which the service is run.
Definition: testing.c:1625
Here is the caller graph for this function: