src/transport/test_plugin_transport.c

   1 /*
   2      This file is part of GNUnet.
   3      (C) 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  * @file transport/test_transport_api.c
  22  * @brief testcase for transport_api.c
  23  * @author Sailor Siraj
  24  * @author Christian Grothoff
  25  */
  26
  27 #include "platform.h"
  28 #include "gnunet_constants.h"
  29 #include "gnunet_getopt_lib.h"
  30 #include "gnunet_hello_lib.h"
  31 #include "gnunet_os_lib.h"
  32 #include "gnunet_peerinfo_service.h"
  33 #include "gnunet_plugin_lib.h"
  34 #include "gnunet_protocols.h"
  35 #include "gnunet_program_lib.h"
  36 #include "gnunet_signatures.h"
  37 #include "plugin_transport.h"
  38 #include "transport.h"
  39
  40 #define VERBOSE GNUNET_YES
  41
  42 /**
  43  * How long until we give up on transmitting the message?
  44  */
  45 #define TIMEOUT GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 30)
  46
  47 /**
  48  * Our public key.
  49  */
  50 static struct GNUNET_CRYPTO_RsaPublicKeyBinaryEncoded my_public_key;
  51
  52 /**
  53  * Our identity.
  54  */
  55 static struct GNUNET_PeerIdentity my_identity;
  56
  57 /**
  58  * Our private key.
  59  */
  60 static struct GNUNET_CRYPTO_RsaPrivateKey *my_private_key;
  61
  62 /**
  63  * Our scheduler.
  64  */
  65 struct GNUNET_SCHEDULER_Handle *sched;
  66
  67 /**
  68  * Our configuration.
  69  */
  70 const struct GNUNET_CONFIGURATION_Handle *cfg;
  71
  72 /**
  73  * Number of neighbours we'd like to have.
  74  */
  75 static uint32_t max_connect_per_transport;
  76
  77 /**
  78  * Environment for this plugin.
  79  */
  80 struct GNUNET_TRANSPORT_PluginEnvironment env;
  81
  82 /**
  83  *handle for the api provided by this plugin
  84  */
  85 struct GNUNET_TRANSPORT_PluginFunctions *api;
  86
  87 /**
  88  * Did the test pass or fail?
  89  */
  90 static int ok;
  91
  92 /**
  93  * Initialize Environment for this plugin
  94  */
  95 struct ReadyList *
  96 receive(void *cls,void *plugin_context,
  97         struct ReadyList *
  98         service_context,
  99         struct GNUNET_TIME_Relative
 100         latency,
 101         const struct GNUNET_PeerIdentity
 102         * peer,
 103         const struct GNUNET_MessageHeader
 104         * message)
 105 {
 106   return NULL;
 107 }
 108
 109 void notify_address(void *cls,
 110                     const char *name,
 111                     const void *addr,
 112                     size_t addrlen,
 113                     struct
 114                     GNUNET_TIME_Relative
 115                     expires)
 116 {
 117 }
 118
 119 void lookup (void *cls,
 120              struct GNUNET_TIME_Relative
 121              timeout,
 122              const struct
 123              GNUNET_PeerIdentity * target,
 124              GNUNET_TRANSPORT_AddressCallback
 125              iter, void *iter_cls)
 126 {
 127 }
 128
 129
 130 /**
 131  * Function called when the service shuts
 132  * down.  Unloads our plugins.
 133  *
 134  * @param cls closure
 135  * @param cfg configuration to use
 136  */
 137 static void
 138 unload_plugins (void *cls,
 139                 const struct GNUNET_CONFIGURATION_Handle *cfg)
 140 {
 141   GNUNET_assert (NULL == GNUNET_PLUGIN_unload ("libgnunet_plugin_transport_tcp",api));
 142   if (my_private_key != NULL)
 143     GNUNET_CRYPTO_rsa_key_free (my_private_key);
 144
 145 }
 146
 147
 148 static GNUNET_SCHEDULER_TaskIdentifier validation_timeout_task;
 149
 150
 151 static void
 152 validation_notification (void *cls,
 153                          const char *name,
 154                          const struct GNUNET_PeerIdentity *peer,
 155                          uint32_t challenge,
 156                          const char *sender_addr)
 157 {
 158   /* Sailor: 'test_validation' should get here
 159      if the validation worked; so we cancel the
 160      "delayed" task that will cause failure */
 161   if (validation_timeout_task != GNUNET_SCHEDULER_NO_TASK)
 162     {
 163       GNUNET_SCHEDULER_cancel (sched, validation_timeout_task);
 164       validation_timeout_task = GNUNET_SCHEDULER_NO_TASK;
 165     }
 166
 167   GNUNET_assert (challenge == 42);
 168
 169   /* Sailor: if this is the last test, calling this function
 170      here will end the process. */
 171   ok = 0; /* if the last test succeeded, report success */
 172   unload_plugins (NULL, cfg);
 173 }
 174
 175
 176 static void
 177 validation_failed (void *cls,
 178                    const struct GNUNET_SCHEDULER_TaskContext *tc)
 179 {
 180   validation_timeout_task = GNUNET_SCHEDULER_NO_TASK;
 181   GNUNET_break (0); /* output error */
 182   /* the "validation_notification" was not called
 183      in a timely fashion; we should set an error
 184      code for main and shut down */
 185   unload_plugins (NULL, cfg);
 186 }
 187
 188
 189 /**
 190  * Simple example test that invokes
 191  * the "validate" function of the plugin
 192  * and tries to see if the plugin would
 193  * succeed to validate its own address.
 194  * (This test is not well-written since
 195  *  we hand-compile the address which
 196  *  kind-of works for TCP but would not
 197  *  work for other plugins; we should ask
 198  *  the plugin about its address instead...).
 199  */
 200 static void
 201 test_validation ()
 202 {
 203   struct sockaddr_in soaddr;
 204
 205   memset (&soaddr, 0, sizeof(soaddr));
 206   soaddr.sin_family = AF_INET;
 207   /* Sailor: set this port to 2367 to see the
 208      testcase fail after 30s (because validation
 209      fails); obviously the test should be
 210      modified to test both successful and
 211      unsuccessful validation in the end... */
 212   soaddr.sin_port = htons(2368 /* FIXME: get from config! */);
 213   soaddr.sin_addr.s_addr = htonl (INADDR_LOOPBACK);
 214   api->validate (api->cls,
 215                  &my_identity,
 216                  42,
 217                  TIMEOUT,
 218                  &soaddr,
 219                  sizeof(soaddr));
 220   /* add job to catch failure (timeout) */
 221   validation_timeout_task =
 222     GNUNET_SCHEDULER_add_delayed (sched,
 223                                   GNUNET_NO,
 224                                   GNUNET_SCHEDULER_PRIORITY_KEEP,
 225                                   GNUNET_SCHEDULER_NO_TASK,
 226                                   TIMEOUT,
 227                                   &validation_failed,
 228                                   NULL);
 229 }
 230
 231
 232 static void setup_plugin_environment()
 233 {
 234   env.cfg  = cfg;
 235   env.sched = sched;
 236   env.my_public_key = &my_public_key;
 237   env.my_private_key = my_private_key;
 238   env.my_identity = &my_identity;
 239   env.cls=&env;
 240   env.receive=&receive;
 241   env.lookup=&lookup;
 242   env.notify_address=&notify_address;
 243   env.notify_validation = &validation_notification;
 244   env.max_connections = max_connect_per_transport;
 245 }
 246
 247
 248 /**
 249  * Runs the test.
 250  *
 251  * @param cls closure
 252  * @param s scheduler to use
 253  * @param c configuration to use
 254  */
 255 static void
 256 run (void *cls,
 257      struct GNUNET_SCHEDULER_Handle *s,
 258      char *const *args,
 259      const char *cfgfile,
 260      const struct GNUNET_CONFIGURATION_Handle *c)
 261 {
 262   unsigned long long tneigh;
 263   char *keyfile;
 264   char *libname;
 265
 266   sched = s;
 267   cfg = c;
 268   /* parse configuration */
 269   if ((GNUNET_OK !=
 270        GNUNET_CONFIGURATION_get_value_number (c,
 271                                               "TRANSPORT",
 272                                               "NEIGHBOUR_LIMIT",
 273                                               &tneigh)) ||
 274       (GNUNET_OK !=
 275        GNUNET_CONFIGURATION_get_value_filename (c,
 276                                                 "GNUNETD",
 277                                                 "HOSTKEY", &keyfile)))
 278     {
 279       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
 280                   _("Transport service is lacking key configuration settings.  Exiting.\n"));
 281       GNUNET_SCHEDULER_shutdown (s);
 282       return;
 283     }
 284   max_connect_per_transport = (uint32_t) tneigh;
 285   my_private_key = GNUNET_CRYPTO_rsa_key_create_from_file (keyfile);
 286   GNUNET_free (keyfile);
 287   if (my_private_key == NULL)
 288     {
 289       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
 290                   _("Transport service could not access hostkey.  Exiting.\n"));
 291       GNUNET_SCHEDULER_shutdown (s);
 292       return;
 293     }
 294   GNUNET_CRYPTO_rsa_key_get_public (my_private_key,
 295                                     &my_public_key);
 296   GNUNET_CRYPTO_hash (&my_public_key,
 297                       sizeof (my_public_key),
 298                       &my_identity.hashPubKey);
 299
 300
 301
 302   /* load plugins... */
 303   setup_plugin_environment();
 304   GNUNET_log (GNUNET_ERROR_TYPE_INFO,
 305               _("Loading tcp transport plugin\n"));
 306   GNUNET_asprintf (&libname, "libgnunet_plugin_transport_tcp");
 307
 308   api = GNUNET_PLUGIN_load(libname, &env);
 309   if (api == NULL)
 310     {
 311       GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
 312                   _("Failed to load transport plugin for tcp\n"));
 313       /* FIXME: set some error code for main */
 314       return;
 315     }
 316   /* Sailor: if we had no real tests, we
 317      could call this function
 318      here to end the process; instead, I'll
 319      show how one could run a single test below.
 320      Note that the test is not particularly well-written,
 321      it just serves to illustrate (also,
 322      the "validation_notification" function above is
 323      part of the test.*/
 324   if (0)
 325     unload_plugins (NULL, cfg);
 326   else
 327     test_validation ();
 328 }
 329
 330
 331 /**
 332  * The main function for the transport service.
 333  *
 334  * @param argc number of arguments from the command line
 335  * @param argv command line arguments
 336  * @return 0 ok, 1 on error
 337  */
 338 int
 339 main (int argc, char *const *argv)
 340 {
 341   static struct GNUNET_GETOPT_CommandLineOption options[] = {
 342     GNUNET_GETOPT_OPTION_END
 343   };
 344   char *const argv_prog[] = {
 345     "test_plugin_transport",
 346     "-c",
 347     "test_plugin_transport_data.conf",
 348     "-L",
 349 #if VERBOSE
 350     "DEBUG",
 351 #else
 352     "WARNING",
 353 #endif
 354     NULL
 355   };
 356   GNUNET_log_setup ("test-plugin-transport",
 357 #if VERBOSE
 358                     "DEBUG",
 359 #else
 360                     "WARNING",
 361 #endif
 362                     NULL);
 363   ok = 1; /* set to fail */
 364   return (GNUNET_OK ==
 365           GNUNET_PROGRAM_run (5,
 366                               argv_prog,
 367                               "test-plugin-transport",
 368                               "testcase",
 369                               options,
 370                               &run, NULL)) ? ok : 1;
 371 }
 372
 373 /* end of test_plugin_transport.c */