gnunet_testing_lib.h

Go to the documentation of this file.

/*
      This file is part of GNUnet
      Copyright (C) 2008, 2009, 2012 GNUnet e.V.
 
      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
      Affero General Public License for more details.
 
      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
 */
 
#ifndef GNUNET_TESTING_LIB_H
#define GNUNET_TESTING_LIB_H
 
 
#include "gnunet_util_lib.h"
#include "gnunet_statistics_service.h"
#include "gnunet_arm_service.h"
 
#ifdef __cplusplus
extern "C"
{
#if 0                           /* keep Emacsens' auto-indent happy */
}
#endif
#endif
 
#define GNUNET_TESTING_HOSTKEYFILESIZE sizeof(struct \
                                              GNUNET_CRYPTO_EddsaPrivateKey)
 
#define GNUNET_TESTING_PREFIX "GNUNET_TESTING_PREFIX"
 
 
struct GNUNET_TESTING_System;
 
 
struct GNUNET_TESTING_Peer;
 
 
struct GNUNET_TESTING_SharedService
{
  const char *service;
 
  const struct GNUNET_CONFIGURATION_Handle *cfg;
 
  unsigned int share;
};
 
 
struct GNUNET_TESTING_System *
GNUNET_TESTING_system_create (const char *testdir,
                              const char *trusted_ip,
                              const char *hostname,
                              const struct GNUNET_TESTING_SharedService *
                              shared_services);
 
 
struct GNUNET_TESTING_System *
GNUNET_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);
 
 
void
GNUNET_TESTING_system_destroy (struct GNUNET_TESTING_System *system,
                               int remove_paths);
 
 
struct GNUNET_CRYPTO_EddsaPrivateKey *
GNUNET_TESTING_hostkey_get (const struct GNUNET_TESTING_System *system,
                            uint32_t key_number,
                            struct GNUNET_PeerIdentity *id);
 
 
uint16_t
GNUNET_TESTING_reserve_port (struct GNUNET_TESTING_System *system);
 
 
void
GNUNET_TESTING_release_port (struct GNUNET_TESTING_System *system,
                             uint16_t port);
 
 
int
GNUNET_TESTING_configuration_create (struct GNUNET_TESTING_System *system,
                                     struct GNUNET_CONFIGURATION_Handle *cfg);
 
// FIXME: add dual to 'release' ports again...
 
 
struct GNUNET_TESTING_Peer *
GNUNET_TESTING_peer_configure (struct GNUNET_TESTING_System *system,
                               struct GNUNET_CONFIGURATION_Handle *cfg,
                               uint32_t key_number,
                               struct GNUNET_PeerIdentity *id,
                               char **emsg);
 
 
void
GNUNET_TESTING_peer_get_identity (struct GNUNET_TESTING_Peer *peer,
                                  struct GNUNET_PeerIdentity *id);
 
 
int
GNUNET_TESTING_peer_start (struct GNUNET_TESTING_Peer *peer);
 
 
int
GNUNET_TESTING_peer_stop (struct GNUNET_TESTING_Peer *peer);
 
 
void
GNUNET_TESTING_peer_destroy (struct GNUNET_TESTING_Peer *peer);
 
 
int
GNUNET_TESTING_peer_kill (struct GNUNET_TESTING_Peer *peer);
 
 
int
GNUNET_TESTING_peer_wait (struct GNUNET_TESTING_Peer *peer);
 
 
typedef void
(*GNUNET_TESTING_PeerStopCallback) (void *cls,
                                    struct GNUNET_TESTING_Peer *peer,
                                    int success);
 
 
int
GNUNET_TESTING_peer_stop_async (struct GNUNET_TESTING_Peer *peer,
                                GNUNET_TESTING_PeerStopCallback cb,
                                void *cb_cls);
 
 
void
GNUNET_TESTING_peer_stop_async_cancel (struct GNUNET_TESTING_Peer *peer);
 
 
typedef void
(*GNUNET_TESTING_TestMain) (void *cls,
                            const struct GNUNET_CONFIGURATION_Handle *cfg,
                            struct GNUNET_TESTING_Peer *peer);
 
 
int
GNUNET_TESTING_peer_run (const char *testdir,
                         const char *cfgfilename,
                         GNUNET_TESTING_TestMain tm,
                         void *tm_cls);
 
 
int
GNUNET_TESTING_service_run (const char *testdir,
                            const char *service_name,
                            const char *cfgfilename,
                            GNUNET_TESTING_TestMain tm,
                            void *tm_cls);
 
 
char *
GNUNET_TESTING_get_testname_from_underscore (const char *argv0);
 
 
#if 0                           /* keep Emacsens' auto-indent happy */
{
#endif
#ifdef __cplusplus
}
#endif
 
#endif
  /* end of group */
 /* end of group addition */