src/transport/transport-testing.h

   1 /*
   2      This file is part of GNUnet.
   3      (C) 2006, 2009 Christian Grothoff (and other contributing authors)
   4
   5      GNUnet is free software; you can redistribute it and/or modify
   6      it under the terms of the GNU General Public License as published
   7      by the Free Software Foundation; either version 2, or (at your
   8      option) any later version.
   9
  10      GNUnet is distributed in the hope that it will be useful, but
  11      WITHOUT ANY WARRANTY; without even the implied warranty of
  12      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13      General Public License for more details.
  14
  15      You should have received a copy of the GNU General Public License
  16      along with GNUnet; see the file COPYING.  If not, write to the
  17      Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18      Boston, MA 02111-1307, USA.
  19 */
  20
  21 /**
  22  * @file transport_testing.h
  23  * @brief testing lib for transport service
  24  *
  25  * @author Matthias Wachs
  26  */
  27
  28 #include "platform.h"
  29 #include "gnunet_common.h"
  30 #include "gnunet_getopt_lib.h"
  31 #include "gnunet_hello_lib.h"
  32 #include "gnunet_os_lib.h"
  33 #include "gnunet_program_lib.h"
  34 #include "gnunet_transport_service.h"
  35
  36
  37 /**
  38  * Context for a single peer
  39  */
  40 struct PeerContext
  41 {
  42   struct GNUNET_CONFIGURATION_Handle *cfg;
  43
  44   struct GNUNET_TRANSPORT_Handle *th;
  45
  46   struct GNUNET_PeerIdentity id;
  47
  48   struct GNUNET_OS_Process *arm_proc;
  49
  50   GNUNET_TRANSPORT_ReceiveCallback rec;
  51
  52   GNUNET_TRANSPORT_NotifyConnect nc;
  53
  54   GNUNET_TRANSPORT_NotifyDisconnect nd;
  55
  56   void * cb_cls;
  57
  58   char * servicehome;
  59 };
  60
  61 /**
  62  * Callback when two peers are connected and both have called the connect callback
  63  * to notify clients about a new peer
  64  */
  65 typedef void (*GNUNET_TRANSPORT_TESTING_connect_cb) (struct PeerContext * p1, struct PeerContext * p2, void *cls);
  66
  67
  68 /**
  69  * Start a peer with the given configuration
  70  * @param rec receive callback
  71  * @param nc connect callback
  72  * @param nd disconnect callback
  73  * @param cb_cls closure for callback
  74  *   if NULL passed the PeerContext * will be used!
  75  * @return the peer context
  76  */
  77 struct PeerContext *
  78 GNUNET_TRANSPORT_TESTING_start_peer (const char * cfgname,
  79     GNUNET_TRANSPORT_ReceiveCallback rec,
  80     GNUNET_TRANSPORT_NotifyConnect nc,
  81     GNUNET_TRANSPORT_NotifyDisconnect nd,
  82     void * cb_cls);
  83
  84
  85 /**
  86  * shutdown the given peer
  87  * @param p the peer
  88  */
  89
  90 void
  91 GNUNET_TRANSPORT_TESTING_stop_peer (struct PeerContext * pc);
  92
  93
  94 /**
  95  * Connect the given peers and call the callback when both peers report the
  96  * inbound connection. Remarks: start_peer's notify_connect callback can be called
  97  * before.
  98  * @param p1 peer 1
  99  * @param p2 peer 2
 100  * @param cb the callback to call
 101  * @param cb_cls callback cls
 102  */
 103 void
 104 GNUNET_TRANSPORT_TESTING_connect_peers (struct PeerContext * p1,
 105     struct PeerContext * p2,
 106     GNUNET_TRANSPORT_TESTING_connect_cb cb,
 107     void * cls);
 108
 109 /* end of transport_testing.h */