src/transport/gnunet-transport.c

   1 /*
   2      This file is part of GNUnet.
   3      (C) 2011 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 3, 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 src/transport/gnunet-transport.c
  23  * @brief Tool to help configure, measure and control the transport subsystem.
  24  * @author Christian Grothoff
  25  * @author Nathan Evans
  26  *
  27  * This utility can be used to test if a transport mechanism for
  28  * GNUnet is properly configured.
  29  */
  30
  31 #include "platform.h"
  32 #include "gnunet_util_lib.h"
  33 #include "gnunet_resolver_service.h"
  34 #include "gnunet_protocols.h"
  35 #include "gnunet_transport_service.h"
  36 #include "gnunet_nat_lib.h"
  37
  38 /**
  39  * How long do we wait for the NAT test to report success?
  40  * Should match NAT_SERVER_TIMEOUT in 'nat_test.c'.
  41  */
  42 #define TIMEOUT GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 30)
  43 #define RESOLUTION_TIMEOUT GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 10)
  44
  45 /**
  46  * Which peer should we connect to?
  47  */
  48 static char *cpid;
  49
  50 /**
  51  * Handle to transport service.
  52  */
  53 static struct GNUNET_TRANSPORT_Handle *handle;
  54
  55 /**
  56  * Option -s.
  57  */
  58 static int benchmark_send;
  59
  60 /**
  61  * Option -b.
  62  */
  63 static int benchmark_receive;
  64
  65 /**
  66  * Option -l.
  67  */
  68 static int benchmark_receive;
  69
  70 /**
  71  * Option -i.
  72  */
  73 static int iterate_connections;
  74
  75 /**
  76  * Option -t.
  77  */
  78 static int test_configuration;
  79
  80 /**
  81  * Option -m.
  82  */
  83 static int monitor_connections;
  84
  85 /**
  86  * Option -n.
  87  */
  88 static int numeric;
  89
  90 /**
  91  * Global return value (0 success).
  92  */
  93 static int ret;
  94
  95 /**
  96  * Current number of connections in monitor mode
  97  */
  98 static int monitor_connections_counter;
  99
 100 /**
 101  * Number of bytes of traffic we received so far.
 102  */
 103 static unsigned long long traffic_received;
 104
 105 /**
 106  * Number of bytes of traffic we sent so far.
 107  */
 108 static unsigned long long traffic_sent;
 109
 110 /**
 111  * Starting time of transmitting/receiving data.
 112  */
 113 static struct GNUNET_TIME_Absolute start_time;
 114
 115 /**
 116  * Handle for current transmission request.
 117  */
 118 static struct GNUNET_TRANSPORT_TransmitHandle *th;
 119
 120 /**
 121  * Identity of the peer we transmit to / connect to.
 122  * (equivalent to 'cpid' string).
 123  */
 124 static struct GNUNET_PeerIdentity pid;
 125
 126 /**
 127  * Task scheduled for cleanup / termination of the process.
 128  */
 129 static GNUNET_SCHEDULER_TaskIdentifier end;
 130
 131 static struct GNUNET_CONTAINER_MultiHashMap *peers;
 132
 133 /**
 134  * Selected level of verbosity.
 135  */
 136 static int verbosity;
 137
 138 /**
 139  * Resolver process handle.
 140  */
 141 struct GNUNET_OS_Process *resolver;
 142
 143 /**
 144  * Number of tasks running that still need the resolver.
 145  */
 146 static unsigned int resolver_users;
 147
 148
 149 /**
 150  * Context for a plugin test.
 151  */
 152 struct TestContext
 153 {
 154
 155   /**
 156    * Handle to the active NAT test.
 157    */
 158   struct GNUNET_NAT_Test *tst;
 159
 160   /**
 161    * Task identifier for the timeout.
 162    */
 163   GNUNET_SCHEDULER_TaskIdentifier tsk;
 164
 165   /**
 166    * Name of plugin under test.
 167    */
 168   const char *name;
 169
 170 };
 171
 172
 173 /**
 174  * Display the result of the test.
 175  *
 176  * @param tc test context
 177  * @param result GNUNET_YES on success
 178  */
 179 static void
 180 display_test_result (struct TestContext *tc, int result)
 181 {
 182   if (GNUNET_YES != result)
 183   {
 184     FPRINTF (stderr, "Configuration for plugin `%s' did not work!\n", tc->name);
 185   }
 186   else
 187   {
 188     FPRINTF (stderr, "Configuration for plugin `%s' is working!\n", tc->name);
 189   }
 190   if (GNUNET_SCHEDULER_NO_TASK != tc->tsk)
 191   {
 192     GNUNET_SCHEDULER_cancel (tc->tsk);
 193     tc->tsk = GNUNET_SCHEDULER_NO_TASK;
 194   }
 195   if (NULL != tc->tst)
 196   {
 197     GNUNET_NAT_test_stop (tc->tst);
 198     tc->tst = NULL;
 199   }
 200   GNUNET_free (tc);
 201   resolver_users--;
 202   if ((0 == resolver_users) && (NULL != resolver))
 203   {
 204     GNUNET_break (0 == GNUNET_OS_process_kill (resolver, SIGTERM));
 205     GNUNET_OS_process_destroy (resolver);
 206     resolver = NULL;
 207   }
 208 }
 209
 210
 211 /**
 212  * Function called by NAT on success.
 213  * Clean up and update GUI (with success).
 214  *
 215  * @param cls test context
 216  * @param success currently always GNUNET_OK
 217  */
 218 static void
 219 result_callback (void *cls, int success)
 220 {
 221   struct TestContext *tc = cls;
 222
 223   display_test_result (tc, success);
 224 }
 225
 226
 227 /**
 228  * Function called if NAT failed to confirm success.
 229  * Clean up and update GUI (with failure).
 230  *
 231  * @param cls test context
 232  * @param tc scheduler callback
 233  */
 234 static void
 235 fail_timeout (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
 236 {
 237   struct TestContext *tstc = cls;
 238
 239   tstc->tsk = GNUNET_SCHEDULER_NO_TASK;
 240   display_test_result (tstc, GNUNET_NO);
 241 }
 242
 243
 244 /**
 245  * Test our plugin's configuration (NAT traversal, etc.).
 246  *
 247  * @param cfg configuration to test
 248  */
 249 static void
 250 do_test_configuration (const struct GNUNET_CONFIGURATION_Handle *cfg)
 251 {
 252   char *plugins;
 253   char *tok;
 254   unsigned long long bnd_port;
 255   unsigned long long adv_port;
 256   struct TestContext *tc;
 257
 258   if (GNUNET_OK !=
 259       GNUNET_CONFIGURATION_get_value_string (cfg, "transport", "plugins",
 260                                              &plugins))
 261   {
 262     FPRINTF (stderr,
 263              "%s",
 264              _
 265              ("No transport plugins configured, peer will never communicate\n"));
 266     ret = 4;
 267     return;
 268   }
 269   for (tok = strtok (plugins, " "); tok != NULL; tok = strtok (NULL, " "))
 270   {
 271     char section[12 + strlen (tok)];
 272
 273     GNUNET_snprintf (section, sizeof (section), "transport-%s", tok);
 274     if (GNUNET_OK !=
 275         GNUNET_CONFIGURATION_get_value_number (cfg, section, "PORT", &bnd_port))
 276     {
 277       FPRINTF (stderr,
 278                _("No port configured for plugin `%s', cannot test it\n"), tok);
 279       continue;
 280     }
 281     if (GNUNET_OK !=
 282         GNUNET_CONFIGURATION_get_value_number (cfg, section, "ADVERTISED_PORT",
 283                                                &adv_port))
 284       adv_port = bnd_port;
 285     if (NULL == resolver)
 286       resolver =
 287           GNUNET_OS_start_process (GNUNET_YES, NULL, NULL, "gnunet-service-resolver",
 288                                    "gnunet-service-resolver", NULL);
 289     resolver_users++;
 290     GNUNET_RESOLVER_connect (cfg);
 291     tc = GNUNET_malloc (sizeof (struct TestContext));
 292     tc->name = GNUNET_strdup (tok);
 293     tc->tst =
 294         GNUNET_NAT_test_start (cfg,
 295                                (0 ==
 296                                 strcasecmp (tok,
 297                                             "udp")) ? GNUNET_NO : GNUNET_YES,
 298                                (uint16_t) bnd_port, (uint16_t) adv_port,
 299                                &result_callback, tc);
 300     if (NULL == tc->tst)
 301     {
 302       display_test_result (tc, GNUNET_SYSERR);
 303       continue;
 304     }
 305     tc->tsk = GNUNET_SCHEDULER_add_delayed (TIMEOUT, &fail_timeout, tc);
 306   }
 307   GNUNET_free (plugins);
 308 }
 309
 310
 311 /**
 312  * Shutdown, print statistics.
 313  */
 314 static void
 315 do_disconnect (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
 316 {
 317   struct GNUNET_TIME_Relative duration;
 318
 319   if (NULL != th)
 320   {
 321     GNUNET_TRANSPORT_notify_transmit_ready_cancel (th);
 322     th = NULL;
 323   }
 324   GNUNET_TRANSPORT_disconnect (handle);
 325   if (benchmark_receive)
 326   {
 327     duration = GNUNET_TIME_absolute_get_duration (start_time);
 328     FPRINTF (stdout, _("Received %llu bytes/s (%llu bytes in %llu ms)\n"),
 329              1000 * traffic_received / (1 + duration.rel_value),
 330              traffic_received, (unsigned long long) duration.rel_value);
 331   }
 332   if (benchmark_send)
 333   {
 334     duration = GNUNET_TIME_absolute_get_duration (start_time);
 335     FPRINTF (stdout, _("Transmitted %llu bytes/s (%llu bytes in %llu ms)\n"),
 336              1000 * traffic_sent / (1 + duration.rel_value), traffic_sent,
 337              (unsigned long long) duration.rel_value);
 338   }
 339 }
 340
 341
 342 /**
 343  * Function called to notify a client about the socket
 344  * begin ready to queue more data.  "buf" will be
 345  * NULL and "size" zero if the socket was closed for
 346  * writing in the meantime.
 347  *
 348  * @param cls closure
 349  * @param size number of bytes available in buf
 350  * @param buf where the callee should write the message
 351  * @return number of bytes written to buf
 352  */
 353 static size_t
 354 transmit_data (void *cls, size_t size, void *buf)
 355 {
 356   struct GNUNET_MessageHeader *m = buf;
 357
 358   if ((NULL == buf) && (0 == size))
 359     return 0;
 360
 361   GNUNET_assert (size >= sizeof (struct GNUNET_MessageHeader));
 362   GNUNET_assert (size < GNUNET_SERVER_MAX_MESSAGE_SIZE);
 363   m->size = ntohs (size);
 364   m->type = ntohs (GNUNET_MESSAGE_TYPE_DUMMY);
 365   memset (&m[1], 52, size - sizeof (struct GNUNET_MessageHeader));
 366   traffic_sent += size;
 367   th = GNUNET_TRANSPORT_notify_transmit_ready (handle, &pid, 32 * 1024, 0,
 368                                                GNUNET_TIME_UNIT_FOREVER_REL,
 369                                                &transmit_data, NULL);
 370   if (verbosity > 0)
 371     FPRINTF (stdout, _("Transmitting %u bytes to %s\n"), (unsigned int) size,
 372              GNUNET_i2s (&pid));
 373   return size;
 374 }
 375
 376
 377 /**
 378  * Function called to notify transport users that another
 379  * peer connected to us.
 380  *
 381  * @param cls closure
 382  * @param peer the peer that connected
 383  * @param ats performance data
 384  * @param ats_count number of entries in ats (excluding 0-termination)
 385  */
 386 static void
 387 notify_connect (void *cls, const struct GNUNET_PeerIdentity *peer,
 388                 const struct GNUNET_ATS_Information *ats, uint32_t ats_count)
 389 {
 390   if (verbosity > 0)
 391     FPRINTF (stdout, _("Connected to %s\n"), GNUNET_i2s (peer));
 392   if (0 != memcmp (&pid, peer, sizeof (struct GNUNET_PeerIdentity)))
 393     return;
 394   ret = 0;
 395   if (benchmark_send)
 396   {
 397     start_time = GNUNET_TIME_absolute_get ();
 398     th = GNUNET_TRANSPORT_notify_transmit_ready (handle, peer, 32 * 1024, 0,
 399                                                  GNUNET_TIME_UNIT_FOREVER_REL,
 400                                                  &transmit_data, NULL);
 401   }
 402   else
 403   {
 404     /* all done, terminate instantly */
 405     GNUNET_SCHEDULER_cancel (end);
 406     end = GNUNET_SCHEDULER_add_now (&do_disconnect, NULL);
 407   }
 408 }
 409
 410
 411 /**
 412  * Function called to notify transport users that another
 413  * peer disconnected from us.
 414  *
 415  * @param cls closure
 416  * @param peer the peer that disconnected
 417  */
 418 static void
 419 notify_disconnect (void *cls, const struct GNUNET_PeerIdentity *peer)
 420 {
 421   if (verbosity > 0)
 422     FPRINTF (stdout, _("Disconnected from %s\n"), GNUNET_i2s (peer));
 423   if (NULL != th)
 424   {
 425     GNUNET_TRANSPORT_notify_transmit_ready_cancel (th);
 426     th = NULL;
 427   }
 428
 429 }
 430
 431 /**
 432  * Function called to notify transport users that another
 433  * peer connected to us.
 434  *
 435  * @param cls closure
 436  * @param peer the peer that connected
 437  * @param ats performance data
 438  * @param ats_count number of entries in ats (excluding 0-termination)
 439  */
 440 static void
 441 monitor_notify_connect (void *cls, const struct GNUNET_PeerIdentity *peer,
 442                 const struct GNUNET_ATS_Information *ats, uint32_t ats_count)
 443 {
 444   monitor_connections_counter ++;
 445   struct GNUNET_TIME_Absolute now = GNUNET_TIME_absolute_get();
 446   char *now_str = GNUNET_STRINGS_absolute_time_to_string (now);
 447   FPRINTF (stdout, _("%24s: %-17s %4s   (%u connections in total)\n"),
 448            now_str,
 449            _("Connected to"),
 450            GNUNET_i2s (peer),
 451            monitor_connections_counter);
 452
 453   GNUNET_free (now_str);
 454 }
 455
 456
 457 /**
 458  * Function called to notify transport users that another
 459  * peer disconnected from us.
 460  *
 461  * @param cls closure
 462  * @param peer the peer that disconnected
 463  */
 464 static void
 465 monitor_notify_disconnect (void *cls, const struct GNUNET_PeerIdentity *peer)
 466 {
 467   struct GNUNET_TIME_Absolute now = GNUNET_TIME_absolute_get();
 468   char *now_str = GNUNET_STRINGS_absolute_time_to_string (now);
 469
 470   GNUNET_assert (monitor_connections_counter > 0);
 471   monitor_connections_counter --;
 472
 473   FPRINTF (stdout, _("%24s: %-17s %4s   (%u connections in total)\n"),
 474            now_str,
 475            _("Disconnected from"),
 476            GNUNET_i2s (peer),
 477            monitor_connections_counter);
 478   GNUNET_free (now_str);
 479 }
 480
 481
 482
 483 /**
 484  * Function called by the transport for each received message.
 485  *
 486  * @param cls closure
 487  * @param peer (claimed) identity of the other peer
 488  * @param message the message
 489  * @param ats performance data
 490  * @param ats_count number of entries in ats
 491  */
 492 static void
 493 notify_receive (void *cls, const struct GNUNET_PeerIdentity *peer,
 494                 const struct GNUNET_MessageHeader *message,
 495                 const struct GNUNET_ATS_Information *ats, uint32_t ats_count)
 496 {
 497   if (!benchmark_receive)
 498     return;
 499   if (GNUNET_MESSAGE_TYPE_DUMMY != ntohs (message->type))
 500     return;
 501   if (verbosity > 0)
 502     FPRINTF (stdout, _("Received %u bytes from %s\n"),
 503              (unsigned int) ntohs (message->size), GNUNET_i2s (peer));
 504   if (traffic_received == 0)
 505     start_time = GNUNET_TIME_absolute_get ();
 506   traffic_received += ntohs (message->size);
 507 }
 508
 509 struct ResolutionContext
 510 {
 511   struct GNUNET_HELLO_Address *addrcp;
 512
 513   int printed;
 514 };
 515
 516
 517 static void
 518 process_string (void *cls, const char *address)
 519 {
 520   struct ResolutionContext *rc = cls;
 521   struct GNUNET_HELLO_Address *addrcp = rc->addrcp;
 522
 523   if (address != NULL)
 524   {
 525     FPRINTF (stdout, _("Peer `%s': %s %s\n"), GNUNET_i2s (&addrcp->peer), addrcp->transport_name, address);
 526     rc->printed = GNUNET_YES;
 527   }
 528   else
 529   {
 530     /* done */
 531     if (GNUNET_NO == rc->printed)
 532       FPRINTF (stdout, _("Peer `%s': %s <unable to resolve address>\n"), GNUNET_i2s (&addrcp->peer), addrcp->transport_name);
 533     GNUNET_free (rc->addrcp);
 534     GNUNET_free (rc);
 535   }
 536 }
 537
 538 /**
 539  * Function to call with a binary address
 540  *
 541  * @param cls closure
 542  * @param peer identity of the peer
 543  * @param address binary address (NULL on disconnect)
 544  */
 545 static void
 546 process_address (void *cls, const struct GNUNET_PeerIdentity *peer,
 547                  const struct GNUNET_HELLO_Address *address)
 548 {
 549   const struct GNUNET_CONFIGURATION_Handle *cfg = cls;
 550   struct ResolutionContext *rc;
 551
 552   if (peer == NULL)
 553   {
 554     /* done */
 555     return;
 556   }
 557
 558   if (address == NULL)
 559   {
 560     FPRINTF (stdout, _("Peer `%s' disconnected\n"), GNUNET_i2s (peer));
 561     return;
 562   }
 563
 564   rc = GNUNET_malloc(sizeof (struct ResolutionContext));
 565   rc->addrcp = GNUNET_HELLO_address_copy(address);
 566   rc->printed = GNUNET_NO;
 567
 568   GNUNET_assert (NULL != rc);
 569
 570   /* Resolve address to string */
 571   GNUNET_TRANSPORT_address_to_string (cfg, address, numeric,
 572                                       RESOLUTION_TIMEOUT, &process_string,
 573                                       rc);
 574 }
 575
 576
 577 /**
 578  * Task run in monitor mode when the user presses CTRL-C to abort.
 579  * Stops monitoring activity.
 580  *
 581  * @param cls the 'struct GNUNET_TRANSPORT_PeerIterateContext *'
 582  * @param tc scheduler context
 583  */
 584 static void
 585 shutdown_task (void *cls,
 586                const struct GNUNET_SCHEDULER_TaskContext *tc)
 587 {
 588   if (NULL != handle)
 589   {
 590     GNUNET_TRANSPORT_disconnect(handle);
 591     handle = NULL;
 592   }
 593
 594   if (NULL != peers)
 595   {
 596     GNUNET_CONTAINER_multihashmap_destroy (peers);
 597     peers = NULL;
 598   }
 599 }
 600
 601
 602
 603 /**
 604  * Main function that will be run by the scheduler.
 605  *
 606  * @param cls closure
 607  * @param args remaining command-line arguments
 608  * @param cfgfile name of the configuration file used (for saving, can be NULL!)
 609  * @param cfg configuration
 610  */
 611 static void
 612 run (void *cls, char *const *args, const char *cfgfile,
 613      const struct GNUNET_CONFIGURATION_Handle *cfg)
 614 {
 615   if (test_configuration)
 616   {
 617     do_test_configuration (cfg);
 618   }
 619   if (benchmark_send && (NULL == cpid))
 620   {
 621     FPRINTF (stderr, _("Option `%s' makes no sense without option `%s'.\n"),
 622              "-s", "-C");
 623     return;
 624   }
 625   if (NULL != cpid)
 626   {
 627     ret = 1;
 628     if (GNUNET_OK != GNUNET_CRYPTO_hash_from_string (cpid, &pid.hashPubKey))
 629     {
 630       FPRINTF (stderr, _("Failed to parse peer identity `%s'\n"), cpid);
 631       return;
 632     }
 633     handle =
 634         GNUNET_TRANSPORT_connect (cfg, NULL, NULL, &notify_receive,
 635                                   &notify_connect, &notify_disconnect);
 636     GNUNET_TRANSPORT_try_connect (handle, &pid);
 637     end =
 638         GNUNET_SCHEDULER_add_delayed (benchmark_send ?
 639                                       GNUNET_TIME_UNIT_FOREVER_REL :
 640                                       GNUNET_TIME_UNIT_SECONDS, &do_disconnect,
 641                                       NULL);
 642   }
 643   else if (benchmark_receive)
 644   {
 645     handle =
 646         GNUNET_TRANSPORT_connect (cfg, NULL, NULL, &notify_receive,
 647                                   &notify_connect, &notify_disconnect);
 648     GNUNET_TRANSPORT_try_connect (handle, &pid);
 649     end =
 650         GNUNET_SCHEDULER_add_delayed (GNUNET_TIME_UNIT_FOREVER_REL,
 651                                       &do_disconnect, NULL);
 652   }
 653   if (iterate_connections)
 654   {
 655     peers = GNUNET_CONTAINER_multihashmap_create (20);
 656     GNUNET_TRANSPORT_peer_get_active_addresses (cfg, NULL, GNUNET_YES,
 657                                                 TIMEOUT,
 658                                                 &process_address, (void *) cfg);
 659   }
 660   if (monitor_connections)
 661   {
 662     monitor_connections_counter = 0;
 663     handle = GNUNET_TRANSPORT_connect (cfg, NULL, NULL, NULL,
 664                                        &monitor_notify_connect,
 665                                        &monitor_notify_disconnect);
 666     if (NULL == handle)
 667     {
 668       GNUNET_SCHEDULER_add_now (&shutdown_task, NULL);
 669     }
 670     else
 671     {
 672       GNUNET_SCHEDULER_add_delayed (GNUNET_TIME_UNIT_FOREVER_REL,
 673                                     &shutdown_task,
 674                                     NULL);
 675     }
 676   }
 677 }
 678
 679
 680 int
 681 main (int argc, char *const *argv)
 682 {
 683   int res;
 684   static const struct GNUNET_GETOPT_CommandLineOption options[] = {
 685     {'b', "benchmark", NULL,
 686      gettext_noop ("measure how fast we are receiving data (until CTRL-C)"),
 687      0, &GNUNET_GETOPT_set_one, &benchmark_receive},
 688     {'C', "connect", "PEER",
 689      gettext_noop ("try to connect to the given peer"),
 690      1, &GNUNET_GETOPT_set_string, &cpid},
 691     {'i', "information", NULL,
 692      gettext_noop ("provide information about all current connections (once)"),
 693      0, &GNUNET_GETOPT_set_one, &iterate_connections},
 694     {'m', "monitor", NULL,
 695      gettext_noop ("provide information about all current connections (continuously)"),
 696      0, &GNUNET_GETOPT_set_one, &monitor_connections},
 697     {'n', "numeric", NULL,
 698      gettext_noop ("do not resolve hostnames"),
 699      0, &GNUNET_GETOPT_set_one, &numeric},
 700     {'s', "send", NULL,
 701      gettext_noop
 702      ("send data for benchmarking to the other peer (until CTRL-C)"),
 703      0, &GNUNET_GETOPT_set_one, &benchmark_send},
 704     {'t', "test", NULL,
 705      gettext_noop ("test transport configuration (involves external server)"),
 706      0, &GNUNET_GETOPT_set_one, &test_configuration},
 707     GNUNET_GETOPT_OPTION_VERBOSE (&verbosity),
 708     GNUNET_GETOPT_OPTION_END
 709   };
 710
 711   if (GNUNET_OK != GNUNET_STRINGS_get_utf8_args (argc, argv, &argc, &argv))
 712     return 2;
 713
 714   res = GNUNET_PROGRAM_run (argc, argv, "gnunet-transport",
 715                               gettext_noop
 716                               ("Direct access to transport service."), options,
 717                               &run, NULL);
 718   GNUNET_free ((void *) argv);
 719
 720   if (GNUNET_OK == res)
 721     return ret;
 722   else
 723     return 1;
 724
 725
 726 }
 727
 728
 729 /* end of gnunet-transport.c */