src/transport/plugin_transport_udp.c

   1 /*
   2      This file is part of GNUnet
   3      (C) 2010 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/plugin_transport_udp.c
  23  * @brief Implementation of the UDP transport service
  24  * @author Christian Grothoff
  25  * @author Nathan Evans
  26  */
  27
  28 #include "platform.h"
  29 #include "gnunet_hello_lib.h"
  30 #include "gnunet_connection_lib.h"
  31 #include "gnunet_os_lib.h"
  32 #include "gnunet_peerinfo_service.h"
  33 #include "gnunet_protocols.h"
  34 #include "gnunet_resolver_service.h"
  35 #include "gnunet_server_lib.h"
  36 #include "gnunet_service_lib.h"
  37 #include "gnunet_signatures.h"
  38 #include "gnunet_statistics_service.h"
  39 #include "gnunet_transport_service.h"
  40 #include "plugin_transport.h"
  41 #include "transport.h"
  42
  43 #define DEBUG_UDP GNUNET_NO
  44
  45 /**
  46  * Transport cost to peer, always 1 for UDP (direct connection)
  47  */
  48 #define UDP_DIRECT_DISTANCE 1
  49
  50 /**
  51  * How long until we give up on transmitting the welcome message?
  52  */
  53 #define HOSTNAME_RESOLVE_TIMEOUT GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 5)
  54
  55
  56 /**
  57  * Message-Packet header.
  58  */
  59 struct UDPMessage
  60 {
  61   /**
  62    * size of the message, in bytes, including this header.
  63    */
  64   struct GNUNET_MessageHeader header;
  65
  66   /**
  67    * What is the identity of the sender (GNUNET_hash of public key)
  68    */
  69   struct GNUNET_PeerIdentity sender;
  70
  71 };
  72
  73
  74 /**
  75  * Network format for IPv4 addresses.
  76  */
  77 struct IPv4UdpAddress
  78 {
  79   /**
  80    * IPv4 address, in network byte order.
  81    */
  82   uint32_t ipv4_addr;
  83
  84   /**
  85    * Port number, in network byte order.
  86    */
  87   uint16_t u_port;
  88
  89 };
  90
  91
  92 /**
  93  * Network format for IPv6 addresses.
  94  */
  95 struct IPv6UdpAddress
  96 {
  97   /**
  98    * IPv6 address.
  99    */
 100   unsigned char ipv6_addr[16];
 101
 102   /**
 103    * Port number, in network byte order.
 104    */
 105   uint16_t u6_port;
 106
 107 };
 108
 109
 110 /**
 111  *
 112  */
 113 struct PrettyPrinterContext
 114 {
 115   /**
 116    *
 117    */
 118   GNUNET_TRANSPORT_AddressStringCallback asc;
 119
 120   /**
 121    * Closure for 'asc'.
 122    */
 123   void *asc_cls;
 124
 125   /**
 126    *
 127    */
 128   uint16_t port;
 129 };
 130
 131
 132 /**
 133  * Encapsulation of all of the state of the plugin.
 134  */
 135 struct Plugin
 136 {
 137   /**
 138    * Our environment.
 139    */
 140   struct GNUNET_TRANSPORT_PluginEnvironment *env;
 141
 142   /**
 143    * Handle to the network service.
 144    */
 145   struct GNUNET_SERVICE_Context *service;
 146
 147   /**
 148    * Handle for request of hostname resolution, non-NULL if pending.
 149    */
 150   struct GNUNET_RESOLVER_RequestHandle *hostname_dns;
 151
 152   /**
 153    * FD Read set
 154    */
 155   struct GNUNET_NETWORK_FDSet *rs;
 156
 157   /**
 158    * ID of task used to update our addresses when one expires.
 159    */
 160   GNUNET_SCHEDULER_TaskIdentifier address_update_task;
 161
 162   /**
 163    * ID of select task
 164    */
 165   GNUNET_SCHEDULER_TaskIdentifier select_task;
 166
 167   /**
 168    * Port that we are actually listening on.
 169    */
 170   uint16_t open_port;
 171
 172   /**
 173    * Port that the user said we would have visible to the
 174    * rest of the world.
 175    */
 176   uint16_t adv_port;
 177
 178 };
 179
 180 /* *********** globals ************* */
 181
 182 /**
 183  * The socket that we transmit all data with
 184  */
 185 static struct GNUNET_NETWORK_Handle *udp_sock;
 186
 187 /**
 188  * Disconnect from a remote node.
 189  *
 190  * @param cls closure ('struct Plugin'), unused
 191  * @param target peer do disconnect
 192  * @return GNUNET_OK on success, GNUNET_SYSERR if the operation failed
 193  */
 194 void
 195 udp_disconnect (void *cls,
 196                 const struct GNUNET_PeerIdentity *target)
 197 {
 198   /* nothing to do, UDP is stateless */
 199 }
 200
 201 /**
 202  * Shutdown the server process (stop receiving inbound traffic). Maybe
 203  * restarted later!
 204  *
 205  * @param cls closure, the 'struct Plugin*'
 206  */
 207 static int
 208 udp_transport_server_stop (void *cls)
 209 {
 210   struct Plugin *plugin = cls;
 211   int ret;
 212
 213   GNUNET_assert (udp_sock != NULL);
 214   if (plugin->select_task != GNUNET_SCHEDULER_NO_TASK)
 215     {
 216       GNUNET_SCHEDULER_cancel (plugin->env->sched, plugin->select_task);
 217       plugin->select_task = GNUNET_SCHEDULER_NO_TASK;
 218     }
 219
 220   ret = GNUNET_NETWORK_socket_close (udp_sock);
 221   if (ret != GNUNET_SYSERR)
 222     udp_sock = NULL;
 223   return ret;
 224 }
 225
 226 /**
 227  * Function that can be used by the transport service to transmit
 228  * a message using the plugin.
 229  *
 230  * @param cls closure, the 'struct Plugin*'
 231  * @param target who should receive this message (ignored by UDP)
 232  * @param msgbuf one or more GNUNET_MessageHeader(s) strung together
 233  * @param msgbuf_size the size of the msgbuf to send
 234  * @param priority how important is the message (ignored by UDP)
 235  * @param timeout when should we time out (give up) if we can not transmit?
 236  * @param session which session must be used (always NULL for UDP)
 237  * @param addr the addr to send the message to, needs to be a sockaddr for us
 238  * @param addrlen the len of addr
 239  * @param force_address GNUNET_YES if the plugin MUST use the given address,
 240  *                GNUNET_NO means the plugin may use any other address and
 241  *                GNUNET_SYSERR means that only reliable existing
 242  *                bi-directional connections should be used (regardless
 243  *                of address)
 244  * @param cont continuation to call once the message has
 245  *        been transmitted (or if the transport is ready
 246  *        for the next transmission call; or if the
 247  *        peer disconnected...)
 248  * @param cont_cls closure for cont
 249  *
 250  * @return the number of bytes written, -1 on error (in this case, cont is not called)
 251  */
 252 static ssize_t
 253 udp_plugin_send (void *cls,
 254                  const struct GNUNET_PeerIdentity *target,
 255                  const char *msgbuf,
 256                  size_t msgbuf_size,
 257                  unsigned int priority,
 258                  struct GNUNET_TIME_Relative timeout,
 259                  struct Session *session,
 260                  const void *addr,
 261                  size_t addrlen,
 262                  int force_address,
 263                  GNUNET_TRANSPORT_TransmitContinuation cont, void *cont_cls)
 264 {
 265   struct Plugin *plugin = cls;
 266   struct UDPMessage *message;
 267   int ssize;
 268   ssize_t sent;
 269   const void *sb;
 270   size_t sbs;
 271   struct sockaddr_in a4;
 272   struct sockaddr_in6 a6;
 273   const struct IPv4UdpAddress *t4;
 274   const struct IPv6UdpAddress *t6;
 275
 276   GNUNET_assert (NULL == session);
 277   GNUNET_assert(udp_sock != NULL);
 278   if ( (addr == NULL) || (addrlen == 0) )
 279     {
 280 #if DEBUG_UDP
 281   GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
 282                    ("udp_plugin_send called without address, returning!\n"));
 283 #endif
 284       return -1; /* Can never send if we don't have an address!! */
 285     }
 286   if (force_address == GNUNET_SYSERR)
 287     return -1; /* never reliable */
 288
 289   if (addrlen == sizeof (struct IPv6UdpAddress))
 290     {
 291       t6 = addr;
 292       memset (&a6, 0, sizeof (a6));
 293 #if HAVE_SOCKADDR_IN_SIN_LEN
 294       a6.sin6_len = sizeof (a6);
 295 #endif
 296       a6.sin6_family = AF_INET6;
 297       a6.sin6_port = t6->u6_port;
 298       memcpy (a6.sin6_addr.s6_addr,
 299               t6->ipv6_addr,
 300               16);
 301       sb = &a6;
 302       sbs = sizeof (a6);
 303     }
 304   else if (addrlen == sizeof (struct IPv4UdpAddress))
 305     {
 306       t4 = addr;
 307       memset (&a4, 0, sizeof (a4));
 308 #if HAVE_SOCKADDR_IN_SIN_LEN
 309       a4.sin_len = sizeof (a4);
 310 #endif
 311       a4.sin_family = AF_INET;
 312       a4.sin_port = t4->u_port;
 313       a4.sin_addr.s_addr = t4->ipv4_addr;
 314       sb = &a4;
 315       sbs = sizeof (a4);
 316     }
 317   else
 318     {
 319       GNUNET_break_op (0);
 320       return -1;
 321     }
 322
 323   /* Build the message to be sent */
 324   message = GNUNET_malloc (sizeof (struct UDPMessage) + msgbuf_size);
 325   ssize = sizeof (struct UDPMessage) + msgbuf_size;
 326
 327 #if DEBUG_UDP
 328   GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp",
 329                    "In udp_send, ssize is %d, sending message to `%s'\n",
 330                    ssize,
 331                    GNUNET_a2s(sb, sbs));
 332 #endif
 333   message->header.size = htons (ssize);
 334   message->header.type = htons (0);
 335   memcpy (&message->sender, plugin->env->my_identity,
 336           sizeof (struct GNUNET_PeerIdentity));
 337   memcpy (&message[1], msgbuf, msgbuf_size);
 338   sent =
 339     GNUNET_NETWORK_socket_sendto (udp_sock, message, ssize,
 340                                   sb, sbs);
 341   if ( (cont != NULL) &&
 342        (sent != -1) )
 343     cont (cont_cls, target, GNUNET_OK);
 344   GNUNET_free (message);
 345   return sent;
 346 }
 347
 348
 349 /**
 350  * Add the IP of our network interface to the list of
 351  * our external IP addresses.
 352  *
 353  * @param cls closure (the 'struct Plugin*')
 354  * @param name name of the interface (can be NULL for unknown)
 355  * @param isDefault is this presumably the default interface
 356  * @param addr address of this interface (can be NULL for unknown or unassigned)
 357  * @param addrlen length of the address
 358  * @return GNUNET_OK to continue iterating
 359  */
 360 static int
 361 process_interfaces (void *cls,
 362                     const char *name,
 363                     int isDefault,
 364                     const struct sockaddr *addr, socklen_t addrlen)
 365 {
 366   struct Plugin *plugin = cls;
 367   int af;
 368   struct IPv4UdpAddress t4;
 369   struct IPv6UdpAddress t6;
 370   void *arg;
 371   uint16_t args;
 372
 373   af = addr->sa_family;
 374   if (af == AF_INET)
 375     {
 376       t4.ipv4_addr = ((struct sockaddr_in *) addr)->sin_addr.s_addr;
 377       t4.u_port = htons (plugin->adv_port);
 378       arg = &t4;
 379       args = sizeof (t4);
 380     }
 381   else if (af == AF_INET6)
 382     {
 383       memcpy (t6.ipv6_addr,
 384               ((struct sockaddr_in6 *) addr)->sin6_addr.s6_addr,
 385               16);
 386       t6.u6_port = htons (plugin->adv_port);
 387       arg = &t6;
 388       args = sizeof (t6);
 389     }
 390   else
 391     {
 392       GNUNET_break (0);
 393       return GNUNET_OK;
 394     }
 395   GNUNET_log_from (GNUNET_ERROR_TYPE_INFO |
 396                    GNUNET_ERROR_TYPE_BULK,
 397                    "udp",
 398                    _("Found address `%s' (%s)\n"),
 399                    GNUNET_a2s (addr, addrlen),
 400                    name);
 401   plugin->env->notify_address (plugin->env->cls,
 402                                "udp",
 403                                arg, args, GNUNET_TIME_UNIT_FOREVER_REL);
 404   return GNUNET_OK;
 405 }
 406
 407
 408 /**
 409  * Function called by the resolver for each address obtained from DNS
 410  * for our own hostname.  Add the addresses to the list of our
 411  * external IP addresses.
 412  *
 413  * @param cls closure
 414  * @param addr one of the addresses of the host, NULL for the last address
 415  * @param addrlen length of the address
 416  */
 417 static void
 418 process_hostname_ips (void *cls,
 419                       const struct sockaddr *addr, socklen_t addrlen)
 420 {
 421   struct Plugin *plugin = cls;
 422
 423   if (addr == NULL)
 424     {
 425       plugin->hostname_dns = NULL;
 426       return;
 427     }
 428   process_interfaces (plugin, "<hostname>", GNUNET_YES, addr, addrlen);
 429 }
 430
 431
 432 /*
 433  * @param cls the plugin handle
 434  * @param tc the scheduling context (for rescheduling this function again)
 435  *
 436  * We have been notified that our writeset has something to read.  Presumably
 437  * select has been called already, so we can go ahead and start reading from
 438  * the socket immediately.  Then we check if there is more to be read by
 439  * calling select ourselves while there is stuff on the wire.  Then reschedule
 440  * this function to be called again once more is available.
 441  *
 442  */
 443 static void
 444 udp_plugin_select (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
 445 {
 446   struct Plugin *plugin = cls;
 447   char *buf;
 448   struct UDPMessage *msg;
 449   struct GNUNET_PeerIdentity *sender;
 450   unsigned int buflen;
 451   socklen_t fromlen;
 452   struct sockaddr_storage addr;
 453   ssize_t ret;
 454   int offset;
 455   int count;
 456   int tsize;
 457   char *msgbuf;
 458   const struct GNUNET_MessageHeader *currhdr;
 459   struct IPv4UdpAddress t4;
 460   struct IPv6UdpAddress t6;
 461   const struct sockaddr_in *s4;
 462   const struct sockaddr_in6 *s6;
 463   const void *ca;
 464   size_t calen;
 465
 466 #if DEBUG_UDP
 467       GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
 468                        ("entered select...\n"));
 469 #endif
 470
 471       buflen = GNUNET_NETWORK_socket_recvfrom_amount (udp_sock);
 472
 473 #if DEBUG_UDP
 474       GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
 475                        ("we expect to read %u bytes\n"), buflen);
 476 #endif
 477
 478     if (buflen == GNUNET_NO)
 479       return;
 480
 481     buf = GNUNET_malloc (buflen);
 482     fromlen = sizeof (addr);
 483
 484     memset (&addr, 0, fromlen);
 485     ret =
 486       GNUNET_NETWORK_socket_recvfrom (udp_sock, buf, buflen,
 487                                       (struct sockaddr *) &addr, &fromlen);
 488
 489 #if DEBUG_UDP
 490     GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
 491                      ("socket_recv returned %u, src_addr_len is %u\n"), ret,
 492                      fromlen);
 493 #endif
 494
 495     if (ret <= 0)
 496       {
 497         GNUNET_free (buf);
 498         return;
 499       }
 500     msg = (struct UDPMessage *) buf;
 501
 502 #if DEBUG_UDP
 503     GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
 504                      ("header reports message size of %d\n"),
 505                      ntohs (msg->header.size));
 506
 507     GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
 508                      ("header reports message type of %d\n"),
 509                      ntohs (msg->header.type));
 510 #endif
 511     if (ntohs (msg->header.size) < sizeof (struct UDPMessage))
 512       {
 513         GNUNET_free (buf);
 514         GNUNET_NETWORK_fdset_zero (plugin->rs);
 515         GNUNET_NETWORK_fdset_set (plugin->rs, udp_sock);
 516         return;
 517       }
 518     msgbuf = (char *)&msg[1];
 519     sender = GNUNET_malloc (sizeof (struct GNUNET_PeerIdentity));
 520     memcpy (sender, &msg->sender, sizeof (struct GNUNET_PeerIdentity));
 521
 522     offset = 0;
 523     count = 0;
 524     tsize = ntohs (msg->header.size) - sizeof(struct UDPMessage);
 525 #if DEBUG_UDP
 526     GNUNET_log_from (GNUNET_ERROR_TYPE_DEBUG, "UDP", _
 527                      ("offset is %d, tsize is %d (UDPMessage size is %d)\n"),
 528                      offset, tsize, sizeof(struct UDPMessage));
 529 #endif
 530
 531     if (fromlen == sizeof (struct sockaddr_in))
 532       {
 533         s4 = (const struct sockaddr_in*) &addr;
 534         t4.u_port = s4->sin_port;
 535         t4.ipv4_addr = s4->sin_addr.s_addr;
 536         ca = &t4;
 537         calen = sizeof (struct IPv4UdpAddress);
 538       }
 539     else if (fromlen == sizeof (struct sockaddr_in6))
 540       {
 541         s6 = (const struct sockaddr_in6*) &addr;
 542         t6.u6_port = s6->sin6_port;
 543         memcpy (t6.ipv6_addr,
 544                 s6->sin6_addr.s6_addr,
 545                 16);
 546         ca = &t6;
 547         calen = sizeof (struct IPv6UdpAddress);
 548       }
 549     else
 550       {
 551         GNUNET_break (0);
 552         ca = NULL;
 553         calen = 0;
 554       }
 555     while (offset < tsize)
 556       {
 557         currhdr = (struct GNUNET_MessageHeader *)&msgbuf[offset];
 558 #if DEBUG_UDP
 559     GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
 560                      ("processing msg %d: type %d, size %d at offset %d\n"),
 561                      count, ntohs(currhdr->type), ntohs(currhdr->size), offset);
 562 #endif
 563         plugin->env->receive (plugin->env->cls,
 564                               sender, currhdr, UDP_DIRECT_DISTANCE,
 565                               NULL, ca, calen);
 566         offset += ntohs(currhdr->size);
 567 #if DEBUG_UDP
 568     GNUNET_log_from (GNUNET_ERROR_TYPE_INFO, "udp", _
 569                      ("offset now %d, tsize %d\n"),
 570                      offset, tsize);
 571 #endif
 572         count++;
 573       }
 574
 575     GNUNET_free (sender);
 576     GNUNET_free (buf);
 577
 578   plugin->select_task =
 579     GNUNET_SCHEDULER_add_select (plugin->env->sched,
 580                                  GNUNET_SCHEDULER_PRIORITY_DEFAULT,
 581                                  GNUNET_SCHEDULER_NO_TASK,
 582                                  GNUNET_TIME_UNIT_FOREVER_REL, plugin->rs,
 583                                  NULL, &udp_plugin_select, plugin);
 584
 585 }
 586
 587 /**
 588  * Create a UDP socket.  If possible, use IPv6, otherwise
 589  * try IPv4.
 590  * @param cls closure, the 'struct Plugin*'
 591  */
 592 static struct GNUNET_NETWORK_Handle *
 593 udp_transport_server_start (void *cls)
 594 {
 595   struct Plugin *plugin = cls;
 596   struct GNUNET_NETWORK_Handle *desc;
 597   struct sockaddr_in serverAddrv4;
 598   struct sockaddr_in6 serverAddrv6;
 599   struct sockaddr *serverAddr;
 600   socklen_t addrlen;
 601
 602   desc = NULL;
 603   if (GNUNET_YES !=
 604       GNUNET_CONFIGURATION_get_value_yesno (plugin->env->cfg, "GNUNETD",
 605                                             "DISABLE-IPV6"))
 606     {
 607       desc = GNUNET_NETWORK_socket_create (PF_INET6, SOCK_DGRAM, 17);
 608       if (desc != NULL)
 609         {
 610           memset (&serverAddrv6, 0, sizeof (serverAddrv6));
 611 #if HAVE_SOCKADDR_IN_SIN_LEN
 612           serverAddrv6.sin6_len = sizeof (serverAddrv6);
 613 #endif
 614           serverAddrv6.sin6_family = AF_INET6;
 615           serverAddrv6.sin6_addr = in6addr_any;
 616           serverAddrv6.sin6_port = htons (plugin->open_port);
 617           addrlen = sizeof (serverAddrv6);
 618           serverAddr = (struct sockaddr *) &serverAddrv6;
 619         }
 620     }
 621   if (NULL == desc)
 622     {
 623       desc = GNUNET_NETWORK_socket_create (PF_INET, SOCK_DGRAM, 17);
 624       if (NULL == desc)
 625         {
 626           GNUNET_log_from (GNUNET_ERROR_TYPE_DEBUG, "udp", "socket");
 627           return NULL;
 628         }
 629       else
 630         {
 631           memset (&serverAddrv4, 0, sizeof (serverAddrv4));
 632 #if HAVE_SOCKADDR_IN_SIN_LEN
 633           serverAddrv4.sin_len = sizeof (serverAddrv4);
 634 #endif
 635           serverAddrv4.sin_family = AF_INET;
 636           serverAddrv4.sin_addr.s_addr = INADDR_ANY;
 637           serverAddrv4.sin_port = htons (plugin->open_port);
 638           addrlen = sizeof (serverAddrv4);
 639           serverAddr = (struct sockaddr *) &serverAddrv4;
 640         }
 641     }
 642
 643   if (desc != NULL)
 644     {
 645       GNUNET_assert (GNUNET_NETWORK_socket_bind (desc, serverAddr, addrlen) ==
 646                      GNUNET_OK);
 647     }
 648
 649   plugin->rs = GNUNET_NETWORK_fdset_create ();
 650
 651   GNUNET_NETWORK_fdset_zero (plugin->rs);
 652   GNUNET_NETWORK_fdset_set (plugin->rs, desc);
 653
 654   plugin->select_task =
 655     GNUNET_SCHEDULER_add_select (plugin->env->sched,
 656                                  GNUNET_SCHEDULER_PRIORITY_DEFAULT,
 657                                  GNUNET_SCHEDULER_NO_TASK,
 658                                  GNUNET_TIME_UNIT_FOREVER_REL, plugin->rs,
 659                                  NULL, &udp_plugin_select, plugin);
 660
 661   return desc;
 662 }
 663
 664
 665 /**
 666  * Check if the given port is plausible (must be either
 667  * our listen port or our advertised port).  If it is
 668  * neither, we return one of these two ports at random.
 669  *
 670  * @return either in_port or a more plausible port
 671  */
 672 static uint16_t
 673 check_port (struct Plugin *plugin, uint16_t in_port)
 674 {
 675   if ((in_port == plugin->adv_port) || (in_port == plugin->open_port))
 676     return in_port;
 677   return (GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_WEAK,
 678                                     2) == 0)
 679     ? plugin->open_port : plugin->adv_port;
 680 }
 681
 682
 683 /**
 684  * Another peer has suggested an address for this peer and transport
 685  * plugin.  Check that this could be a valid address.  This function
 686  * is not expected to 'validate' the address in the sense of trying to
 687  * connect to it but simply to see if the binary format is technically
 688  * legal for establishing a connection.
 689  *
 690  * @param cls handle to Plugin
 691  * @param addr address to check
 692  * @param addrlen length of addr
 693  * @return GNUNET_OK if this is a plausible address for this peer
 694  *         and transport, GNUNET_SYSERR if not
 695  */
 696 static int
 697 udp_check_address (void *cls, void *addr, size_t addrlen)
 698 {
 699   struct Plugin *plugin = cls;
 700   struct IPv4UdpAddress *v4;
 701   struct IPv6UdpAddress *v6;
 702
 703   if ((addrlen != sizeof (struct IPv4UdpAddress)) &&
 704       (addrlen != sizeof (struct IPv6UdpAddress)))
 705     {
 706       GNUNET_break_op (0);
 707       return GNUNET_SYSERR;
 708     }
 709   if (addrlen == sizeof (struct IPv4UdpAddress))
 710     {
 711       v4 = (struct IPv4UdpAddress *) addr;
 712       v4->u_port = htons (check_port (plugin, ntohs (v4->u_port)));
 713     }
 714   else
 715     {
 716       v6 = (struct IPv6UdpAddress *) addr;
 717       v6->u6_port = htons (check_port (plugin, ntohs (v6->u6_port)));
 718     }
 719   return GNUNET_OK;
 720 }
 721
 722
 723 /**
 724  * Append our port and forward the result.
 725  */
 726 static void
 727 append_port (void *cls, const char *hostname)
 728 {
 729   struct PrettyPrinterContext *ppc = cls;
 730   char *ret;
 731
 732   if (hostname == NULL)
 733     {
 734       ppc->asc (ppc->asc_cls, NULL);
 735       GNUNET_free (ppc);
 736       return;
 737     }
 738   GNUNET_asprintf (&ret, "%s:%d", hostname, ppc->port);
 739   ppc->asc (ppc->asc_cls, ret);
 740   GNUNET_free (ret);
 741 }
 742
 743
 744 /**
 745  * Convert the transports address to a nice, human-readable
 746  * format.
 747  *
 748  * @param cls closure
 749  * @param type name of the transport that generated the address
 750  * @param addr one of the addresses of the host, NULL for the last address
 751  *        the specific address format depends on the transport
 752  * @param addrlen length of the address
 753  * @param numeric should (IP) addresses be displayed in numeric form?
 754  * @param timeout after how long should we give up?
 755  * @param asc function to call on each string
 756  * @param asc_cls closure for asc
 757  */
 758 static void
 759 udp_plugin_address_pretty_printer (void *cls,
 760                                    const char *type,
 761                                    const void *addr,
 762                                    size_t addrlen,
 763                                    int numeric,
 764                                    struct GNUNET_TIME_Relative timeout,
 765                                    GNUNET_TRANSPORT_AddressStringCallback asc,
 766                                    void *asc_cls)
 767 {
 768   struct Plugin *plugin = cls;
 769   struct PrettyPrinterContext *ppc;
 770   const void *sb;
 771   struct sockaddr_in a4;
 772   struct sockaddr_in6 a6;
 773   const struct IPv4UdpAddress *t4;
 774   const struct IPv6UdpAddress *t6;
 775   size_t sbs;
 776   uint16_t port;
 777
 778   if (addrlen == sizeof (struct IPv6UdpAddress))
 779     {
 780       t6 = addr;
 781       memset (&a6, 0, sizeof (a6));
 782       a6.sin6_family = AF_INET6;
 783       a6.sin6_port = t6->u6_port;
 784       port = ntohs (t6->u6_port);
 785       memcpy (a6.sin6_addr.s6_addr,
 786               t6->ipv6_addr,
 787               16);
 788       sb = &a6;
 789       sbs = sizeof (a6);
 790     }
 791   else if (addrlen == sizeof (struct IPv4UdpAddress))
 792     {
 793       t4 = addr;
 794       memset (&a4, 0, sizeof (a4));
 795       a4.sin_family = AF_INET;
 796       a4.sin_port = t4->u_port;
 797       a4.sin_addr.s_addr = t4->ipv4_addr;
 798       port = ntohs (t4->u_port);
 799       sb = &a4;
 800       sbs = sizeof (a4);
 801     }
 802   else
 803     {
 804       /* invalid address */
 805       GNUNET_break_op (0);
 806       asc (asc_cls, NULL);
 807       return;
 808     }
 809   ppc = GNUNET_malloc (sizeof (struct PrettyPrinterContext));
 810   ppc->asc = asc;
 811   ppc->asc_cls = asc_cls;
 812   ppc->port = port;
 813   GNUNET_RESOLVER_hostname_get (plugin->env->sched,
 814                                 plugin->env->cfg,
 815                                 sb,
 816                                 sbs,
 817                                 !numeric, timeout, &append_port, ppc);
 818 }
 819
 820
 821
 822 /**
 823  * Function called for a quick conversion of the binary address to
 824  * a numeric address.  Note that the caller must not free the
 825  * address and that the next call to this function is allowed
 826  * to override the address again.
 827  *
 828  * @param cls closure
 829  * @param addr binary address
 830  * @param addrlen length of the address
 831  * @return string representing the same address
 832  */
 833 static const char*
 834 udp_address_to_string (void *cls,
 835                        const void *addr,
 836                        size_t addrlen)
 837 {
 838   static char rbuf[INET6_ADDRSTRLEN + 10];
 839   char buf[INET6_ADDRSTRLEN];
 840   const void *sb;
 841   struct in_addr a4;
 842   struct in6_addr a6;
 843   const struct IPv4UdpAddress *t4;
 844   const struct IPv6UdpAddress *t6;
 845   int af;
 846   uint16_t port;
 847
 848   if (addrlen == sizeof (struct IPv6UdpAddress))
 849     {
 850       t6 = addr;
 851       af = AF_INET6;
 852       port = ntohs (t6->u6_port);
 853       memcpy (&a6, t6->ipv6_addr, sizeof (a6));
 854       sb = &a6;
 855     }
 856   else if (addrlen == sizeof (struct IPv4UdpAddress))
 857     {
 858       t4 = addr;
 859       af = AF_INET;
 860       port = ntohs (t4->u_port);
 861       memcpy (&a4, &t4->ipv4_addr, sizeof (a4));
 862       sb = &a4;
 863     }
 864   else
 865     return NULL;
 866   inet_ntop (af, sb, buf, INET6_ADDRSTRLEN);
 867   GNUNET_snprintf (rbuf,
 868                    sizeof (rbuf),
 869                    "%s:%u",
 870                    buf,
 871                    port);
 872   return rbuf;
 873 }
 874
 875
 876 /**
 877  * The exported method. Makes the core api available via a global and
 878  * returns the udp transport API.
 879  *
 880  * @param cls closure, the 'struct GNUNET_TRANSPORT_PluginEnvironment*'
 881  * @return the 'struct GNUNET_TRANSPORT_PluginFunctions*' or NULL on error
 882  */
 883 void *
 884 libgnunet_plugin_transport_udp_init (void *cls)
 885 {
 886   struct GNUNET_TRANSPORT_PluginEnvironment *env = cls;
 887   struct GNUNET_TRANSPORT_PluginFunctions *api;
 888   struct Plugin *plugin;
 889   struct GNUNET_SERVICE_Context *service;
 890   unsigned long long aport;
 891   unsigned long long bport;
 892   unsigned long long mtu;
 893
 894   service = GNUNET_SERVICE_start ("transport-udp", env->sched, env->cfg);
 895   if (service == NULL)
 896     {
 897       GNUNET_log_from (GNUNET_ERROR_TYPE_WARNING, "udp", _
 898                        ("Failed to start service for `%s' transport plugin.\n"),
 899                        "udp");
 900       return NULL;
 901     }
 902   aport = 0;
 903   if ((GNUNET_OK !=
 904        GNUNET_CONFIGURATION_get_value_number (env->cfg,
 905                                               "transport-udp",
 906                                               "PORT",
 907                                               &bport)) ||
 908       (bport > 65535) ||
 909       ((GNUNET_OK ==
 910         GNUNET_CONFIGURATION_get_value_number (env->cfg,
 911                                                "transport-udp",
 912                                                "ADVERTISED-PORT",
 913                                                &aport)) && (aport > 65535)))
 914     {
 915       GNUNET_log_from (GNUNET_ERROR_TYPE_ERROR,
 916                        "udp",
 917                        _
 918                        ("Require valid port number for service `%s' in configuration!\n"),
 919                        "transport-udp");
 920       GNUNET_SERVICE_stop (service);
 921       return NULL;
 922     }
 923   if (aport == 0)
 924     aport = bport;
 925
 926   mtu = 1240;
 927   if (mtu < 1200)
 928     GNUNET_log_from (GNUNET_ERROR_TYPE_INFO,
 929                      "udp",
 930                      _("MTU %llu for `%s' is probably too low!\n"), mtu,
 931                      "UDP");
 932
 933   plugin = GNUNET_malloc (sizeof (struct Plugin));
 934   plugin->open_port = bport;
 935   plugin->adv_port = aport;
 936   plugin->env = env;
 937   api = GNUNET_malloc (sizeof (struct GNUNET_TRANSPORT_PluginFunctions));
 938   api->cls = plugin;
 939
 940   api->send = &udp_plugin_send;
 941   api->disconnect = &udp_disconnect;
 942   api->address_pretty_printer = &udp_plugin_address_pretty_printer;
 943   api->check_address = &udp_check_address;
 944   api->address_to_string = &udp_address_to_string;
 945   plugin->service = service;
 946
 947   /* FIXME: do the two calls below periodically again and
 948      not just once (since the info we get might change...) */
 949   GNUNET_OS_network_interfaces_list (&process_interfaces, plugin);
 950   plugin->hostname_dns = GNUNET_RESOLVER_hostname_resolve (env->sched,
 951                                                            env->cfg,
 952                                                            AF_UNSPEC,
 953                                                            HOSTNAME_RESOLVE_TIMEOUT,
 954                                                            &process_hostname_ips,
 955                                                            plugin);
 956
 957   udp_sock = udp_transport_server_start (plugin);
 958
 959   GNUNET_assert (udp_sock != NULL);
 960
 961   return api;
 962 }
 963
 964 void *
 965 libgnunet_plugin_transport_udp_done (void *cls)
 966 {
 967   struct GNUNET_TRANSPORT_PluginFunctions *api = cls;
 968   struct Plugin *plugin = api->cls;
 969
 970   udp_transport_server_stop (plugin);
 971   if (NULL != plugin->hostname_dns)
 972     {
 973       GNUNET_RESOLVER_request_cancel (plugin->hostname_dns);
 974       plugin->hostname_dns = NULL;
 975     }
 976   GNUNET_SERVICE_stop (plugin->service);
 977
 978   GNUNET_NETWORK_fdset_destroy (plugin->rs);
 979   GNUNET_free (plugin);
 980   GNUNET_free (api);
 981   return NULL;
 982 }
 983
 984 /* end of plugin_transport_udp.c */