src/nat/nat.c

   1 /*
   2      This file is part of GNUnet.
   3      (C) 2009, 2010, 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 nat/nat.c
  23  * @brief Library handling UPnP and NAT-PMP port forwarding and
  24  *     external IP address retrieval
  25  * @author Milan Bouchet-Valat
  26  * @author Christian Grothoff
  27  */
  28 #include "platform.h"
  29 #include "gnunet_util_lib.h"
  30 #include "gnunet_resolver_service.h"
  31 #include "gnunet_nat_lib.h"
  32 #include "nat.h"
  33
  34 #define LOG(kind,...) GNUNET_log_from (kind, "nat", __VA_ARGS__)
  35
  36 /**
  37  * How often do we scan for changes in our IP address from our local
  38  * interfaces?
  39  */
  40 #define IFC_SCAN_FREQUENCY GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MINUTES, 15)
  41
  42 /**
  43  * How often do we scan for changes in how our hostname resolves?
  44  */
  45 #define HOSTNAME_DNS_FREQUENCY GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MINUTES, 20)
  46
  47
  48 /**
  49  * How often do we scan for changes in how our external (dyndns) hostname resolves?
  50  */
  51 #define DYNDNS_FREQUENCY GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MINUTES, 7)
  52
  53 /**
  54  * How long until we give up trying to resolve our own hostname?
  55  */
  56 #define HOSTNAME_RESOLVE_TIMEOUT GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 1)
  57
  58
  59 /**
  60  * Where did the given local address originate from?
  61  * To be used for debugging as well as in the future
  62  * to remove all addresses from a certain source when
  63  * we reevaluate the source.
  64  */
  65 enum LocalAddressSource
  66 {
  67   /**
  68    * Address was obtained by DNS resolution of the external hostname
  69    * given in the configuration (i.e. hole-punched DynDNS setup).
  70    */
  71   LAL_EXTERNAL_IP,
  72
  73   /**
  74    * Address was obtained by DNS resolution of the external hostname
  75    * given in the configuration (i.e. hole-punched DynDNS setup)
  76    * during the previous iteration (see #3213).
  77    */
  78   LAL_EXTERNAL_IP_OLD,
  79
  80   /**
  81    * Address was obtained by looking up our own hostname in DNS.
  82    */
  83   LAL_HOSTNAME_DNS,
  84
  85   /**
  86    * Address was obtained by scanning our hosts's network interfaces
  87    * and taking their address (no DNS involved).
  88    */
  89   LAL_INTERFACE_ADDRESS,
  90
  91   /**
  92    * Addresses we were explicitly bound to.
  93    */
  94   LAL_BINDTO_ADDRESS,
  95
  96   /**
  97    * Addresses from UPnP or PMP
  98    */
  99   LAL_UPNP,
 100
 101   /**
 102    * End of the list.
 103    */
 104   LAL_END
 105 };
 106
 107
 108 /**
 109  * List of local addresses that we currently deem valid.  Actual
 110  * struct is followed by the 'struct sockaddr'.  Note that the code
 111  * intentionally makes no attempt to ensure that a particular address
 112  * is only listed once (especially since it may come from different
 113  * sources, and the source is an "internal" construct).
 114  */
 115 struct LocalAddressList
 116 {
 117   /**
 118    * This is a linked list.
 119    */
 120   struct LocalAddressList *next;
 121
 122   /**
 123    * Previous entry.
 124    */
 125   struct LocalAddressList *prev;
 126
 127   /**
 128    * Number of bytes of address that follow.
 129    */
 130   socklen_t addrlen;
 131
 132   /**
 133    * Origin of the local address.
 134    */
 135   enum LocalAddressSource source;
 136 };
 137
 138
 139 /**
 140  * Handle for miniupnp-based NAT traversal actions.
 141  */
 142 struct MiniList
 143 {
 144
 145   /**
 146    * Doubly-linked list.
 147    */
 148   struct MiniList *next;
 149
 150   /**
 151    * Doubly-linked list.
 152    */
 153   struct MiniList *prev;
 154
 155   /**
 156    * Handle to mini-action.
 157    */
 158   struct GNUNET_NAT_MiniHandle *mini;
 159
 160   /**
 161    * Local port number that was mapped.
 162    */
 163   uint16_t port;
 164
 165 };
 166
 167
 168 /**
 169  * Handle for active NAT registrations.
 170  */
 171 struct GNUNET_NAT_Handle
 172 {
 173
 174   /**
 175    * Configuration to use.
 176    */
 177   const struct GNUNET_CONFIGURATION_Handle *cfg;
 178
 179   /**
 180    * Function to call when we learn about a new address.
 181    */
 182   GNUNET_NAT_AddressCallback address_callback;
 183
 184   /**
 185    * Function to call when we notice another peer asking for
 186    * connection reversal.
 187    */
 188   GNUNET_NAT_ReversalCallback reversal_callback;
 189
 190   /**
 191    * Closure for callbacks (@e address_callback and @e reversal_callback)
 192    */
 193   void *callback_cls;
 194
 195   /**
 196    * Handle for (DYN)DNS lookup of our external IP.
 197    */
 198   struct GNUNET_RESOLVER_RequestHandle *ext_dns;
 199
 200   /**
 201    * Handle for request of hostname resolution, non-NULL if pending.
 202    */
 203   struct GNUNET_RESOLVER_RequestHandle *hostname_dns;
 204
 205   /**
 206    * stdout pipe handle for the gnunet-helper-nat-server process
 207    */
 208   struct GNUNET_DISK_PipeHandle *server_stdout;
 209
 210   /**
 211    * stdout file handle (for reading) for the gnunet-helper-nat-server process
 212    */
 213   const struct GNUNET_DISK_FileHandle *server_stdout_handle;
 214
 215   /**
 216    * Linked list of currently valid addresses (head).
 217    */
 218   struct LocalAddressList *lal_head;
 219
 220   /**
 221    * Linked list of currently valid addresses (tail).
 222    */
 223   struct LocalAddressList *lal_tail;
 224
 225   /**
 226    * How long do we wait for restarting a crashed gnunet-helper-nat-server?
 227    */
 228   struct GNUNET_TIME_Relative server_retry_delay;
 229
 230   /**
 231    * ID of select gnunet-helper-nat-server stdout read task
 232    */
 233   GNUNET_SCHEDULER_TaskIdentifier server_read_task;
 234
 235   /**
 236    * ID of interface IP-scan task
 237    */
 238   GNUNET_SCHEDULER_TaskIdentifier ifc_task;
 239
 240   /**
 241    * ID of hostname DNS lookup task
 242    */
 243   GNUNET_SCHEDULER_TaskIdentifier hostname_task;
 244
 245   /**
 246    * ID of DynDNS lookup task
 247    */
 248   GNUNET_SCHEDULER_TaskIdentifier dns_task;
 249
 250   /**
 251    * ID of task to add addresses from bind.
 252    */
 253   GNUNET_SCHEDULER_TaskIdentifier bind_task;
 254
 255   /**
 256    * How often do we scan for changes in our IP address from our local
 257    * interfaces?
 258    */
 259   struct GNUNET_TIME_Relative ifc_scan_frequency;
 260
 261   /**
 262    * How often do we scan for changes in how our hostname resolves?
 263    */
 264   struct GNUNET_TIME_Relative hostname_dns_frequency;
 265
 266   /**
 267    * How often do we scan for changes in how our external (dyndns) hostname resolves?
 268    */
 269   struct GNUNET_TIME_Relative dyndns_frequency;
 270
 271   /**
 272    * The process id of the server process (if behind NAT)
 273    */
 274   struct GNUNET_OS_Process *server_proc;
 275
 276   /**
 277    * LAN address as passed by the caller (array).
 278    */
 279   struct sockaddr **local_addrs;
 280
 281   /**
 282    * Length of the @e local_addrs.
 283    */
 284   socklen_t *local_addrlens;
 285
 286   /**
 287    * List of handles for UPnP-traversal, one per local port (if
 288    * not IPv6-only).
 289    */
 290   struct MiniList *mini_head;
 291
 292   /**
 293    * List of handles for UPnP-traversal, one per local port (if
 294    * not IPv6-only).
 295    */
 296   struct MiniList *mini_tail;
 297
 298   /**
 299    * Number of entries in 'local_addrs' array.
 300    */
 301   unsigned int num_local_addrs;
 302
 303   /**
 304    * Our external address (according to config, UPnP may disagree...),
 305    * in dotted decimal notation, IPv4-only. Or NULL if not known.
 306    */
 307   char *external_address;
 308
 309   /**
 310    * Presumably our internal address (according to config)
 311    */
 312   char *internal_address;
 313
 314   /**
 315    * Is this transport configured to be behind a NAT?
 316    */
 317   int behind_nat;
 318
 319   /**
 320    * Has the NAT been punched? (according to config)
 321    */
 322   int nat_punched;
 323
 324   /**
 325    * Is this transport configured to allow connections to NAT'd peers?
 326    */
 327   int enable_nat_client;
 328
 329   /**
 330    * Should we run the gnunet-helper-nat-server?
 331    */
 332   int enable_nat_server;
 333
 334   /**
 335    * Are we allowed to try UPnP/PMP for NAT traversal?
 336    */
 337   int enable_upnp;
 338
 339   /**
 340    * Should we use local addresses (loopback)? (according to config)
 341    */
 342   int use_localaddresses;
 343
 344   /**
 345    * Should we return local addresses to clients
 346    */
 347   int return_localaddress;
 348
 349   /**
 350    * Should we do a DNS lookup of our hostname to find out our own IP?
 351    */
 352   int use_hostname;
 353
 354   /**
 355    * Is using IPv6 disabled?
 356    */
 357   int disable_ipv6;
 358
 359   /**
 360    * Is this TCP or UDP?
 361    */
 362   int is_tcp;
 363
 364   /**
 365    * Port we advertise to the outside.
 366    */
 367   uint16_t adv_port;
 368
 369 };
 370
 371
 372 /**
 373  * Try to start the gnunet-helper-nat-server (if it is not
 374  * already running).
 375  *
 376  * @param h handle to NAT
 377  */
 378 static void
 379 start_gnunet_nat_server (struct GNUNET_NAT_Handle *h);
 380
 381
 382 /**
 383  * Remove all addresses from the list of 'local' addresses
 384  * that originated from the given source.
 385  *
 386  * @param h handle to NAT
 387  * @param src source that identifies addresses to remove
 388  */
 389 static void
 390 remove_from_address_list_by_source (struct GNUNET_NAT_Handle *h,
 391                                     enum LocalAddressSource src)
 392 {
 393   struct LocalAddressList *pos;
 394   struct LocalAddressList *next;
 395
 396   next = h->lal_head;
 397   while (NULL != (pos = next))
 398   {
 399     next = pos->next;
 400     if (pos->source != src)
 401       continue;
 402     GNUNET_CONTAINER_DLL_remove (h->lal_head, h->lal_tail, pos);
 403     if (NULL != h->address_callback)
 404       h->address_callback (h->callback_cls, GNUNET_NO,
 405                            (const struct sockaddr *) &pos[1], pos->addrlen);
 406     GNUNET_free (pos);
 407   }
 408 }
 409
 410
 411 /**
 412  * Add the given address to the list of 'local' addresses, thereby
 413  * making it a 'legal' address for this peer to have.
 414  *
 415  * @param h handle to NAT
 416  * @param src where did the local address originate from?
 417  * @param arg the address, some `struct sockaddr`
 418  * @param arg_size number of bytes in @a arg
 419  */
 420 static void
 421 add_to_address_list_as_is (struct GNUNET_NAT_Handle *h,
 422                            enum LocalAddressSource src,
 423                            const struct sockaddr *arg, socklen_t arg_size)
 424 {
 425   struct LocalAddressList *lal;
 426
 427   lal = GNUNET_malloc (sizeof (struct LocalAddressList) + arg_size);
 428   memcpy (&lal[1], arg, arg_size);
 429   lal->addrlen = arg_size;
 430   lal->source = src;
 431   GNUNET_CONTAINER_DLL_insert (h->lal_head, h->lal_tail, lal);
 432   LOG (GNUNET_ERROR_TYPE_DEBUG,
 433        "Adding address `%s' from source %d\n",
 434        GNUNET_a2s (arg, arg_size),
 435        src);
 436   if (NULL != h->address_callback)
 437     h->address_callback (h->callback_cls, GNUNET_YES, arg, arg_size);
 438 }
 439
 440
 441 /**
 442  * Add the given address to the list of 'local' addresses, thereby
 443  * making it a 'legal' address for this peer to have.   Set the
 444  * port number in the process to the advertised port and possibly
 445  * also to zero (if we have the gnunet-helper-nat-server).
 446  *
 447  * @param h handle to NAT
 448  * @param src where did the local address originate from?
 449  * @param arg the address, some `struct sockaddr`
 450  * @param arg_size number of bytes in @a arg
 451  */
 452 static void
 453 add_to_address_list (struct GNUNET_NAT_Handle *h,
 454                      enum LocalAddressSource src,
 455                      const struct sockaddr *arg,
 456                      socklen_t arg_size)
 457 {
 458   struct sockaddr_in s4;
 459   const struct sockaddr_in *in4;
 460   struct sockaddr_in6 s6;
 461   const struct sockaddr_in6 *in6;
 462
 463   if (arg_size == sizeof (struct sockaddr_in))
 464   {
 465     in4 = (const struct sockaddr_in *) arg;
 466     s4 = *in4;
 467     s4.sin_port = htons (h->adv_port);
 468     add_to_address_list_as_is (h, src, (const struct sockaddr *) &s4,
 469                                sizeof (struct sockaddr_in));
 470     if (GNUNET_YES == h->enable_nat_server)
 471     {
 472       /* also add with PORT = 0 to indicate NAT server is enabled */
 473       s4.sin_port = htons (0);
 474       add_to_address_list_as_is (h, src, (const struct sockaddr *) &s4,
 475                                  sizeof (struct sockaddr_in));
 476     }
 477   }
 478   else if (arg_size == sizeof (struct sockaddr_in6))
 479   {
 480     if (GNUNET_YES != h->disable_ipv6)
 481     {
 482       in6 = (const struct sockaddr_in6 *) arg;
 483       s6 = *in6;
 484       s6.sin6_port = htons (h->adv_port);
 485       add_to_address_list_as_is (h, src, (const struct sockaddr *) &s6,
 486                                  sizeof (struct sockaddr_in6));
 487     }
 488   }
 489   else
 490   {
 491     GNUNET_assert (0);
 492   }
 493 }
 494
 495
 496 /**
 497  * Add the given IP address to the list of 'local' addresses, thereby
 498  * making it a 'legal' address for this peer to have.
 499  *
 500  * @param h handle to NAT
 501  * @param src where did the local address originate from?
 502  * @param addr the address, some `struct in_addr` or `struct in6_addr`
 503  * @param addrlen number of bytes in addr
 504  */
 505 static void
 506 add_ip_to_address_list (struct GNUNET_NAT_Handle *h,
 507                         enum LocalAddressSource src, const void *addr,
 508                         socklen_t addrlen)
 509 {
 510   struct sockaddr_in s4;
 511   const struct in_addr *in4;
 512   struct sockaddr_in6 s6;
 513   const struct in6_addr *in6;
 514
 515   if (addrlen == sizeof (struct in_addr))
 516   {
 517     in4 = (const struct in_addr *) addr;
 518     memset (&s4, 0, sizeof (s4));
 519     s4.sin_family = AF_INET;
 520     s4.sin_port = 0;
 521 #if HAVE_SOCKADDR_IN_SIN_LEN
 522     s4.sin_len = (u_char) sizeof (struct sockaddr_in);
 523 #endif
 524     s4.sin_addr = *in4;
 525     add_to_address_list (h, src, (const struct sockaddr *) &s4,
 526                          sizeof (struct sockaddr_in));
 527     if (GNUNET_YES == h->enable_nat_server)
 528     {
 529       /* also add with PORT = 0 to indicate NAT server is enabled */
 530       s4.sin_port = htons (0);
 531       add_to_address_list (h, src, (const struct sockaddr *) &s4,
 532                            sizeof (struct sockaddr_in));
 533
 534     }
 535   }
 536   else if (addrlen == sizeof (struct in6_addr))
 537   {
 538     if (GNUNET_YES != h->disable_ipv6)
 539     {
 540       in6 = (const struct in6_addr *) addr;
 541       memset (&s6, 0, sizeof (s6));
 542       s6.sin6_family = AF_INET6;
 543       s6.sin6_port = htons (h->adv_port);
 544 #if HAVE_SOCKADDR_IN_SIN_LEN
 545       s6.sin6_len = (u_char) sizeof (struct sockaddr_in6);
 546 #endif
 547       s6.sin6_addr = *in6;
 548       add_to_address_list (h, src, (const struct sockaddr *) &s6,
 549                            sizeof (struct sockaddr_in6));
 550     }
 551   }
 552   else
 553   {
 554     GNUNET_assert (0);
 555   }
 556 }
 557
 558
 559 /**
 560  * Task to do DNS lookup on our external hostname to
 561  * get DynDNS-IP addresses.
 562  *
 563  * @param cls the NAT handle
 564  * @param tc scheduler context
 565  */
 566 static void
 567 resolve_dns (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc);
 568
 569
 570 /**
 571  * Our (external) hostname was resolved and the configuration says that
 572  * the NAT was hole-punched.
 573  *
 574  * @param cls the `struct GNUNET_NAT_Handle`
 575  * @param addr NULL on error, otherwise result of DNS lookup
 576  * @param addrlen number of bytes in @a addr
 577  */
 578 static void
 579 process_external_ip (void *cls,
 580                      const struct sockaddr *addr,
 581                      socklen_t addrlen)
 582 {
 583   struct GNUNET_NAT_Handle *h = cls;
 584   struct in_addr dummy;
 585
 586   if (NULL == addr)
 587   {
 588     h->ext_dns = NULL;
 589     /* Current iteration is over, remove 'old' IPs now */
 590     LOG (GNUNET_ERROR_TYPE_DEBUG,
 591          "Purging old IPs for external address\n");
 592     remove_from_address_list_by_source (h, LAL_EXTERNAL_IP_OLD);
 593     if (1 == inet_pton (AF_INET,
 594                         h->external_address,
 595                         &dummy))
 596     {
 597       LOG (GNUNET_ERROR_TYPE_DEBUG,
 598            "Got numeric IP for external address, not repeating lookup\n");
 599       return;                   /* repated lookup pointless: was numeric! */
 600     }
 601     h->dns_task =
 602       GNUNET_SCHEDULER_add_delayed (h->dyndns_frequency,
 603                                     &resolve_dns, h);
 604     return;
 605   }
 606   LOG (GNUNET_ERROR_TYPE_DEBUG,
 607        "Got IP `%s' for external address `%s'\n",
 608        GNUNET_a2s (addr, addrlen),
 609        h->external_address);
 610   add_to_address_list (h, LAL_EXTERNAL_IP, addr, addrlen);
 611 }
 612
 613
 614 /**
 615  * Task to do a lookup on our hostname for IP addresses.
 616  *
 617  * @param cls the NAT handle
 618  * @param tc scheduler context
 619  */
 620 static void
 621 resolve_hostname (void *cls,
 622                   const struct GNUNET_SCHEDULER_TaskContext *tc);
 623
 624
 625 /**
 626  * Function called by the resolver for each address obtained from DNS
 627  * for our own hostname.  Add the addresses to the list of our IP
 628  * addresses.
 629  *
 630  * @param cls closure
 631  * @param addr one of the addresses of the host, NULL for the last address
 632  * @param addrlen length of the @a addr
 633  */
 634 static void
 635 process_hostname_ip (void *cls,
 636                      const struct sockaddr *addr,
 637                      socklen_t addrlen)
 638 {
 639   struct GNUNET_NAT_Handle *h = cls;
 640
 641   if (NULL == addr)
 642   {
 643     h->hostname_dns = NULL;
 644     h->hostname_task =
 645         GNUNET_SCHEDULER_add_delayed (h->hostname_dns_frequency,
 646                                       &resolve_hostname, h);
 647     return;
 648   }
 649   add_to_address_list (h, LAL_HOSTNAME_DNS, addr, addrlen);
 650 }
 651
 652
 653 /**
 654  * Add the IP of our network interface to the list of
 655  * our IP addresses.
 656  *
 657  * @param cls the `struct GNUNET_NAT_Handle`
 658  * @param name name of the interface
 659  * @param isDefault do we think this may be our default interface
 660  * @param addr address of the interface
 661  * @param broadcast_addr the broadcast address (can be NULL for unknown or unassigned)
 662  * @param netmask the network mask (can be NULL for unknown or unassigned))
 663  * @param addrlen number of bytes in @a addr and @a broadcast_addr
 664  * @return #GNUNET_OK to continue iterating
 665  */
 666 static int
 667 process_interfaces (void *cls, const char *name, int isDefault,
 668                     const struct sockaddr *addr,
 669                     const struct sockaddr *broadcast_addr,
 670                     const struct sockaddr *netmask, socklen_t addrlen)
 671 {
 672   const static struct in6_addr any6 = IN6ADDR_ANY_INIT;
 673   struct GNUNET_NAT_Handle *h = cls;
 674   const struct sockaddr_in *s4;
 675   const struct sockaddr_in6 *s6;
 676   const void *ip;
 677   char buf[INET6_ADDRSTRLEN];
 678   unsigned int i;
 679   int have_any;
 680
 681   switch (addr->sa_family)
 682   {
 683   case AF_INET:
 684     /* check if we're bound to the "ANY" IP address */
 685     have_any = GNUNET_NO;
 686     for (i=0;i<h->num_local_addrs;i++)
 687       {
 688         if (h->local_addrs[i]->sa_family != AF_INET)
 689           continue;
 690 #ifndef INADDR_ANY
 691 #define INADDR_ANY 0
 692 #endif
 693         if (INADDR_ANY == ((struct sockaddr_in*) h->local_addrs[i])->sin_addr.s_addr)
 694           {
 695             have_any = GNUNET_YES;
 696             break;
 697           }
 698       }
 699     if (GNUNET_NO == have_any)
 700       return GNUNET_OK; /* not bound to IP 0.0.0.0 but to specific IP addresses,
 701                            do not use those from interfaces */
 702     s4 = (struct sockaddr_in *) addr;
 703     ip = &s4->sin_addr;
 704
 705     /* Check if address is in 127.0.0.0/8 */
 706     uint32_t address = ntohl ((uint32_t) (s4->sin_addr.s_addr));
 707     uint32_t value = (address & 0xFF000000) ^ 0x7F000000;
 708
 709     if ((h->return_localaddress == GNUNET_NO) && (value == 0))
 710     {
 711       return GNUNET_OK;
 712     }
 713     if (GNUNET_YES == h->use_localaddresses)
 714     {
 715       add_ip_to_address_list (h, LAL_INTERFACE_ADDRESS, &s4->sin_addr,
 716                               sizeof (struct in_addr));
 717     }
 718     break;
 719   case AF_INET6:
 720     /* check if we're bound to the "ANY" IP address */
 721     have_any = GNUNET_NO;
 722     for (i=0;i<h->num_local_addrs;i++)
 723       {
 724         if (h->local_addrs[i]->sa_family != AF_INET6)
 725           continue;
 726         if (0 == memcmp (&any6,
 727                          &((struct sockaddr_in6*) h->local_addrs[i])->sin6_addr,
 728                          sizeof (struct in6_addr)))
 729           {
 730             have_any = GNUNET_YES;
 731             break;
 732           }
 733       }
 734     if (GNUNET_NO == have_any)
 735       return GNUNET_OK; /* not bound to "ANY" IP (::0) but to specific IP addresses,
 736                            do not use those from interfaces */
 737
 738     s6 = (struct sockaddr_in6 *) addr;
 739     if (IN6_IS_ADDR_LINKLOCAL (&((struct sockaddr_in6 *) addr)->sin6_addr))
 740     {
 741       /* skip link local addresses */
 742       return GNUNET_OK;
 743     }
 744     if ((h->return_localaddress == GNUNET_NO) &&
 745         (IN6_IS_ADDR_LOOPBACK (&((struct sockaddr_in6 *) addr)->sin6_addr)))
 746     {
 747       return GNUNET_OK;
 748     }
 749     ip = &s6->sin6_addr;
 750     if (GNUNET_YES == h->use_localaddresses)
 751     {
 752       add_ip_to_address_list (h, LAL_INTERFACE_ADDRESS, &s6->sin6_addr,
 753                               sizeof (struct in6_addr));
 754     }
 755     break;
 756   default:
 757     GNUNET_break (0);
 758     return GNUNET_OK;
 759   }
 760   if ((h->internal_address == NULL) && (h->server_proc == NULL) &&
 761       (h->server_read_task == GNUNET_SCHEDULER_NO_TASK) &&
 762       (GNUNET_YES == isDefault) && ((addr->sa_family == AF_INET) ||
 763                                     (addr->sa_family == AF_INET6)))
 764   {
 765     /* no internal address configured, but we found a "default"
 766      * interface, try using that as our 'internal' address */
 767     h->internal_address =
 768         GNUNET_strdup (inet_ntop (addr->sa_family, ip, buf, sizeof (buf)));
 769     start_gnunet_nat_server (h);
 770   }
 771   return GNUNET_OK;
 772 }
 773
 774
 775 /**
 776  * Task that restarts the gnunet-helper-nat-server process after a crash
 777  * after a certain delay.
 778  *
 779  * @param cls the `struct GNUNET_NAT_Handle`
 780  * @param tc scheduler context
 781  */
 782 static void
 783 restart_nat_server (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
 784 {
 785   struct GNUNET_NAT_Handle *h = cls;
 786
 787   h->server_read_task = GNUNET_SCHEDULER_NO_TASK;
 788   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
 789     return;
 790   start_gnunet_nat_server (h);
 791 }
 792
 793
 794 /**
 795  * We have been notified that gnunet-helper-nat-server has written
 796  * something to stdout.  Handle the output, then reschedule this
 797  * function to be called again once more is available.
 798  *
 799  * @param cls the NAT handle
 800  * @param tc the scheduling context
 801  */
 802 static void
 803 nat_server_read (void *cls,
 804                  const struct GNUNET_SCHEDULER_TaskContext *tc)
 805 {
 806   struct GNUNET_NAT_Handle *h = cls;
 807   char mybuf[40];
 808   ssize_t bytes;
 809   size_t i;
 810   int port;
 811   const char *port_start;
 812   struct sockaddr_in sin_addr;
 813
 814   h->server_read_task = GNUNET_SCHEDULER_NO_TASK;
 815   if ((tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN) != 0)
 816     return;
 817   memset (mybuf, 0, sizeof (mybuf));
 818   bytes =
 819     GNUNET_DISK_file_read (h->server_stdout_handle, mybuf, sizeof (mybuf));
 820   if (bytes < 1)
 821   {
 822     LOG (GNUNET_ERROR_TYPE_DEBUG,
 823          "Finished reading from server stdout with code: %d\n",
 824          bytes);
 825     if (0 != GNUNET_OS_process_kill (h->server_proc, GNUNET_TERM_SIG))
 826       GNUNET_log_from_strerror (GNUNET_ERROR_TYPE_WARNING, "nat", "kill");
 827     GNUNET_OS_process_wait (h->server_proc);
 828     GNUNET_OS_process_destroy (h->server_proc);
 829     h->server_proc = NULL;
 830     GNUNET_DISK_pipe_close (h->server_stdout);
 831     h->server_stdout = NULL;
 832     h->server_stdout_handle = NULL;
 833     /* now try to restart it */
 834     h->server_retry_delay = GNUNET_TIME_STD_BACKOFF (h->server_retry_delay);
 835     h->server_read_task =
 836         GNUNET_SCHEDULER_add_delayed (h->server_retry_delay,
 837                                       &restart_nat_server, h);
 838     return;
 839   }
 840
 841   port_start = NULL;
 842   for (i = 0; i < sizeof (mybuf); i++)
 843   {
 844     if (mybuf[i] == '\n')
 845     {
 846       mybuf[i] = '\0';
 847       break;
 848     }
 849     if ((mybuf[i] == ':') && (i + 1 < sizeof (mybuf)))
 850     {
 851       mybuf[i] = '\0';
 852       port_start = &mybuf[i + 1];
 853     }
 854   }
 855
 856   /* construct socket address of sender */
 857   memset (&sin_addr, 0, sizeof (sin_addr));
 858   sin_addr.sin_family = AF_INET;
 859 #if HAVE_SOCKADDR_IN_SIN_LEN
 860   sin_addr.sin_len = sizeof (sin_addr);
 861 #endif
 862   if ((NULL == port_start) || (1 != SSCANF (port_start, "%d", &port)) ||
 863       (-1 == inet_pton (AF_INET, mybuf, &sin_addr.sin_addr)))
 864   {
 865     /* should we restart gnunet-helper-nat-server? */
 866     LOG (GNUNET_ERROR_TYPE_WARNING, "nat",
 867          _("gnunet-helper-nat-server generated malformed address `%s'\n"),
 868          mybuf);
 869     h->server_read_task =
 870         GNUNET_SCHEDULER_add_read_file (GNUNET_TIME_UNIT_FOREVER_REL,
 871                                         h->server_stdout_handle,
 872                                         &nat_server_read, h);
 873     return;
 874   }
 875   sin_addr.sin_port = htons ((uint16_t) port);
 876   LOG (GNUNET_ERROR_TYPE_DEBUG, "gnunet-helper-nat-server read: %s:%d\n", mybuf,
 877        port);
 878   h->reversal_callback (h->callback_cls, (const struct sockaddr *) &sin_addr,
 879                         sizeof (sin_addr));
 880   h->server_read_task =
 881       GNUNET_SCHEDULER_add_read_file (GNUNET_TIME_UNIT_FOREVER_REL,
 882                                       h->server_stdout_handle, &nat_server_read,
 883                                       h);
 884 }
 885
 886
 887 /**
 888  * Try to start the gnunet-helper-nat-server (if it is not
 889  * already running).
 890  *
 891  * @param h handle to NAT
 892  */
 893 static void
 894 start_gnunet_nat_server (struct GNUNET_NAT_Handle *h)
 895 {
 896   char *binary;
 897
 898   if ((h->behind_nat == GNUNET_YES) && (h->enable_nat_server == GNUNET_YES) &&
 899       (h->internal_address != NULL) &&
 900       (NULL !=
 901        (h->server_stdout =
 902         GNUNET_DISK_pipe (GNUNET_YES, GNUNET_YES, GNUNET_NO, GNUNET_YES))))
 903   {
 904     LOG (GNUNET_ERROR_TYPE_DEBUG,
 905          "Starting `%s' at `%s'\n",
 906          "gnunet-helper-nat-server", h->internal_address);
 907     /* Start the server process */
 908     binary = GNUNET_OS_get_libexec_binary_path ("gnunet-helper-nat-server");
 909     h->server_proc =
 910         GNUNET_OS_start_process (GNUNET_NO, 0, NULL, h->server_stdout,
 911                                  binary,
 912                                  "gnunet-helper-nat-server",
 913                                  h->internal_address, NULL);
 914     GNUNET_free (binary);
 915     if (h->server_proc == NULL)
 916     {
 917       LOG (GNUNET_ERROR_TYPE_WARNING, "nat", _("Failed to start %s\n"),
 918            "gnunet-helper-nat-server");
 919       GNUNET_DISK_pipe_close (h->server_stdout);
 920       h->server_stdout = NULL;
 921     }
 922     else
 923     {
 924       /* Close the write end of the read pipe */
 925       GNUNET_DISK_pipe_close_end (h->server_stdout, GNUNET_DISK_PIPE_END_WRITE);
 926       h->server_stdout_handle =
 927           GNUNET_DISK_pipe_handle (h->server_stdout, GNUNET_DISK_PIPE_END_READ);
 928       h->server_read_task =
 929           GNUNET_SCHEDULER_add_read_file (GNUNET_TIME_UNIT_FOREVER_REL,
 930                                           h->server_stdout_handle,
 931                                           &nat_server_read, h);
 932     }
 933   }
 934 }
 935
 936
 937 /**
 938  * Task to scan the local network interfaces for IP addresses.
 939  *
 940  * @param cls the NAT handle
 941  * @param tc scheduler context
 942  */
 943 static void
 944 list_interfaces (void *cls,
 945                  const struct GNUNET_SCHEDULER_TaskContext *tc)
 946 {
 947   struct GNUNET_NAT_Handle *h = cls;
 948
 949   h->ifc_task = GNUNET_SCHEDULER_NO_TASK;
 950   remove_from_address_list_by_source (h, LAL_INTERFACE_ADDRESS);
 951   GNUNET_OS_network_interfaces_list (&process_interfaces, h);
 952   h->ifc_task =
 953     GNUNET_SCHEDULER_add_delayed (h->ifc_scan_frequency,
 954                                   &list_interfaces, h);
 955 }
 956
 957
 958 /**
 959  * Task to do a lookup on our hostname for IP addresses.
 960  *
 961  * @param cls the NAT handle
 962  * @param tc scheduler context
 963  */
 964 static void
 965 resolve_hostname (void *cls,
 966                   const struct GNUNET_SCHEDULER_TaskContext *tc)
 967 {
 968   struct GNUNET_NAT_Handle *h = cls;
 969
 970   h->hostname_task = GNUNET_SCHEDULER_NO_TASK;
 971   remove_from_address_list_by_source (h, LAL_HOSTNAME_DNS);
 972   h->hostname_dns =
 973       GNUNET_RESOLVER_hostname_resolve (AF_UNSPEC, HOSTNAME_RESOLVE_TIMEOUT,
 974                                         &process_hostname_ip, h);
 975 }
 976
 977
 978 /**
 979  * Task to do DNS lookup on our external hostname to
 980  * get DynDNS-IP addresses.
 981  *
 982  * @param cls the NAT handle
 983  * @param tc scheduler context
 984  */
 985 static void
 986 resolve_dns (void *cls,
 987              const struct GNUNET_SCHEDULER_TaskContext *tc)
 988 {
 989   struct GNUNET_NAT_Handle *h = cls;
 990   struct LocalAddressList *pos;
 991
 992   h->dns_task = GNUNET_SCHEDULER_NO_TASK;
 993   for (pos = h->lal_head; NULL != pos; pos = pos->next)
 994     if (pos->source == LAL_EXTERNAL_IP)
 995       pos->source = LAL_EXTERNAL_IP_OLD;
 996   LOG (GNUNET_ERROR_TYPE_DEBUG,
 997        "Resolving external address `%s'\n",
 998        h->external_address);
 999   h->ext_dns =
1000       GNUNET_RESOLVER_ip_get (h->external_address, AF_INET,
1001                               GNUNET_TIME_UNIT_MINUTES,
1002                               &process_external_ip, h);
1003 }
1004
1005
1006 /**
1007  * Add or remove UPnP-mapped addresses.
1008  *
1009  * @param cls the `struct GNUNET_NAT_Handle`
1010  * @param add_remove #GNUNET_YES to mean the new public IP address, #GNUNET_NO to mean
1011  *     the previous (now invalid) one
1012  * @param addr either the previous or the new public IP address
1013  * @param addrlen actual lenght of @a addr
1014  */
1015 static void
1016 upnp_add (void *cls,
1017           int add_remove,
1018           const struct sockaddr *addr,
1019           socklen_t addrlen)
1020 {
1021   struct GNUNET_NAT_Handle *h = cls;
1022   struct LocalAddressList *pos;
1023   struct LocalAddressList *next;
1024
1025   if (GNUNET_YES == add_remove)
1026   {
1027     add_to_address_list (h, LAL_UPNP, addr, addrlen);
1028     return;
1029   }
1030   /* remove address */
1031   next = h->lal_head;
1032   while (NULL != (pos = next))
1033   {
1034     next = pos->next;
1035     if ((pos->source != LAL_UPNP) || (pos->addrlen != addrlen) ||
1036         (0 != memcmp (&pos[1], addr, addrlen)))
1037       continue;
1038     GNUNET_CONTAINER_DLL_remove (h->lal_head, h->lal_tail, pos);
1039     if (NULL != h->address_callback)
1040       h->address_callback (h->callback_cls, GNUNET_NO,
1041                            (const struct sockaddr *) &pos[1], pos->addrlen);
1042     GNUNET_free (pos);
1043     return;                     /* only remove once */
1044   }
1045   /* asked to remove address that does not exist */
1046   GNUNET_break (0);
1047 }
1048
1049
1050 /**
1051  * Try to add a port mapping using UPnP.
1052  *
1053  * @param h overall NAT handle
1054  * @param port port to map with UPnP
1055  */
1056 static void
1057 add_minis (struct GNUNET_NAT_Handle *h,
1058            uint16_t port)
1059 {
1060   struct MiniList *ml;
1061
1062   ml = h->mini_head;
1063   while (NULL != ml)
1064   {
1065     if (port == ml->port)
1066       return;                   /* already got this port */
1067     ml = ml->next;
1068   }
1069   ml = GNUNET_new (struct MiniList);
1070   ml->port = port;
1071   ml->mini = GNUNET_NAT_mini_map_start (port, h->is_tcp, &upnp_add, h);
1072   GNUNET_CONTAINER_DLL_insert (h->mini_head, h->mini_tail, ml);
1073 }
1074
1075
1076 /**
1077  * Task to add addresses from original bind to set of valid addrs.
1078  *
1079  * @param cls the NAT handle
1080  * @param tc scheduler context
1081  */
1082 static void
1083 add_from_bind (void *cls,
1084                const struct GNUNET_SCHEDULER_TaskContext *tc)
1085 {
1086   static struct in6_addr any = IN6ADDR_ANY_INIT;
1087   struct GNUNET_NAT_Handle *h = cls;
1088   unsigned int i;
1089   struct sockaddr *sa;
1090   const struct sockaddr_in *v4;
1091
1092   h->bind_task = GNUNET_SCHEDULER_NO_TASK;
1093   for (i = 0; i < h->num_local_addrs; i++)
1094   {
1095     sa = h->local_addrs[i];
1096     switch (sa->sa_family)
1097     {
1098     case AF_INET:
1099       if (sizeof (struct sockaddr_in) != h->local_addrlens[i])
1100       {
1101         GNUNET_break (0);
1102         break;
1103       }
1104       v4 = (const struct sockaddr_in *) sa;
1105       if (0 != v4->sin_addr.s_addr)
1106         add_to_address_list (h, LAL_BINDTO_ADDRESS, sa,
1107                              sizeof (struct sockaddr_in));
1108       if (h->enable_upnp)
1109         add_minis (h, ntohs (v4->sin_port));
1110       break;
1111     case AF_INET6:
1112       if (sizeof (struct sockaddr_in6) != h->local_addrlens[i])
1113       {
1114         GNUNET_break (0);
1115         break;
1116       }
1117       if (0 !=
1118           memcmp (&((const struct sockaddr_in6 *) sa)->sin6_addr, &any,
1119                   sizeof (struct in6_addr)))
1120         add_to_address_list (h, LAL_BINDTO_ADDRESS, sa,
1121                              sizeof (struct sockaddr_in6));
1122       break;
1123     default:
1124       break;
1125     }
1126   }
1127 }
1128
1129
1130
1131 /**
1132  * Attempt to enable port redirection and detect public IP address contacting
1133  * UPnP or NAT-PMP routers on the local network. Use addr to specify to which
1134  * of the local host's addresses should the external port be mapped. The port
1135  * is taken from the corresponding sockaddr_in[6] field.
1136  *
1137  * @param cfg configuration to use
1138  * @param is_tcp #GNUNET_YES for TCP, #GNUNET_NO for UDP
1139  * @param adv_port advertised port (port we are either bound to or that our OS
1140  *                 locally performs redirection from to our bound port).
1141  * @param num_addrs number of addresses in 'addrs'
1142  * @param addrs the local addresses packets should be redirected to
1143  * @param addrlens actual lengths of the addresses
1144  * @param address_callback function to call everytime the public IP address changes
1145  * @param reversal_callback function to call if someone wants connection reversal from us
1146  * @param callback_cls closure for callbacks
1147  * @return NULL on error, otherwise handle that can be used to unregister
1148  */
1149 struct GNUNET_NAT_Handle *
1150 GNUNET_NAT_register (const struct GNUNET_CONFIGURATION_Handle *cfg,
1151                      int is_tcp,
1152                      uint16_t adv_port,
1153                      unsigned int num_addrs,
1154                      const struct sockaddr **addrs,
1155                      const socklen_t * addrlens,
1156                      GNUNET_NAT_AddressCallback address_callback,
1157                      GNUNET_NAT_ReversalCallback reversal_callback,
1158                      void *callback_cls)
1159 {
1160   struct GNUNET_NAT_Handle *h;
1161   struct in_addr in_addr;
1162   unsigned int i;
1163   char *binary;
1164
1165   LOG (GNUNET_ERROR_TYPE_DEBUG,
1166        "Registered with NAT service at port %u with %u IP bound local addresses\n",
1167        (unsigned int) adv_port, num_addrs);
1168   h = GNUNET_new (struct GNUNET_NAT_Handle);
1169   h->server_retry_delay = GNUNET_TIME_UNIT_SECONDS;
1170   h->cfg = cfg;
1171   h->is_tcp = is_tcp;
1172   h->address_callback = address_callback;
1173   h->reversal_callback = reversal_callback;
1174   h->callback_cls = callback_cls;
1175   h->num_local_addrs = num_addrs;
1176   h->adv_port = adv_port;
1177   if (num_addrs != 0)
1178   {
1179     h->local_addrs = GNUNET_malloc (num_addrs * sizeof (struct sockaddr *));
1180     h->local_addrlens = GNUNET_malloc (num_addrs * sizeof (socklen_t));
1181     for (i = 0; i < num_addrs; i++)
1182     {
1183       GNUNET_assert (addrlens[i] > 0);
1184       GNUNET_assert (addrs[i] != NULL);
1185       h->local_addrlens[i] = addrlens[i];
1186       h->local_addrs[i] = GNUNET_malloc (addrlens[i]);
1187       memcpy (h->local_addrs[i], addrs[i], addrlens[i]);
1188     }
1189   }
1190   h->bind_task = GNUNET_SCHEDULER_add_now (&add_from_bind, h);
1191   if (GNUNET_OK ==
1192       GNUNET_CONFIGURATION_have_value (cfg, "nat", "INTERNAL_ADDRESS"))
1193   {
1194     (void) GNUNET_CONFIGURATION_get_value_string (cfg, "nat",
1195                                                   "INTERNAL_ADDRESS",
1196                                                   &h->internal_address);
1197   }
1198   if ((h->internal_address != NULL) &&
1199       (inet_pton (AF_INET, h->internal_address, &in_addr) != 1))
1200   {
1201     GNUNET_log_config_invalid (GNUNET_ERROR_TYPE_WARNING,
1202                                "nat", "INTERNAL_ADDRESS",
1203                                _("malformed"));
1204     GNUNET_free (h->internal_address);
1205     h->internal_address = NULL;
1206   }
1207
1208   if (GNUNET_OK ==
1209       GNUNET_CONFIGURATION_have_value (cfg, "nat", "EXTERNAL_ADDRESS"))
1210   {
1211     (void) GNUNET_CONFIGURATION_get_value_string (cfg, "nat",
1212                                                   "EXTERNAL_ADDRESS",
1213                                                   &h->external_address);
1214   }
1215   h->behind_nat =
1216       GNUNET_CONFIGURATION_get_value_yesno (cfg, "nat", "BEHIND_NAT");
1217   h->nat_punched =
1218       GNUNET_CONFIGURATION_get_value_yesno (cfg, "nat", "PUNCHED_NAT");
1219   h->enable_nat_client =
1220       GNUNET_CONFIGURATION_get_value_yesno (cfg, "nat", "ENABLE_ICMP_CLIENT");
1221   h->enable_nat_server =
1222       GNUNET_CONFIGURATION_get_value_yesno (cfg, "nat", "ENABLE_ICMP_SERVER");
1223   h->enable_upnp =
1224       GNUNET_CONFIGURATION_get_value_yesno (cfg, "nat", "ENABLE_UPNP");
1225   h->use_localaddresses =
1226       GNUNET_CONFIGURATION_get_value_yesno (cfg, "nat", "USE_LOCALADDR");
1227   h->return_localaddress =
1228       GNUNET_CONFIGURATION_get_value_yesno (cfg, "nat",
1229                                             "RETURN_LOCAL_ADDRESSES");
1230
1231   h->use_hostname =
1232       GNUNET_CONFIGURATION_get_value_yesno (cfg, "nat", "USE_HOSTNAME");
1233   h->disable_ipv6 =
1234       GNUNET_CONFIGURATION_get_value_yesno (cfg, "nat", "DISABLEV6");
1235   if (GNUNET_OK !=
1236       GNUNET_CONFIGURATION_get_value_time (cfg, "nat", "DYNDNS_FREQUENCY",
1237                                            &h->dyndns_frequency))
1238     h->dyndns_frequency = DYNDNS_FREQUENCY;
1239   if (GNUNET_OK !=
1240       GNUNET_CONFIGURATION_get_value_time (cfg, "nat", "IFC_SCAN_FREQUENCY",
1241                                            &h->ifc_scan_frequency))
1242     h->ifc_scan_frequency = IFC_SCAN_FREQUENCY;
1243   if (GNUNET_OK !=
1244       GNUNET_CONFIGURATION_get_value_time (cfg, "nat", "HOSTNAME_DNS_FREQUENCY",
1245                                            &h->hostname_dns_frequency))
1246     h->hostname_dns_frequency = HOSTNAME_DNS_FREQUENCY;
1247
1248   if (NULL == reversal_callback)
1249     h->enable_nat_server = GNUNET_NO;
1250
1251   /* Check if NAT was hole-punched */
1252   if ((NULL != h->address_callback) &&
1253       (NULL != h->external_address) &&
1254       (GNUNET_YES == h->nat_punched))
1255   {
1256     h->dns_task = GNUNET_SCHEDULER_add_now (&resolve_dns, h);
1257     h->enable_nat_server = GNUNET_NO;
1258     h->enable_upnp = GNUNET_NO;
1259   }
1260   else
1261   {
1262     LOG (GNUNET_ERROR_TYPE_DEBUG,
1263          "No external IP address given to add to our list of addresses\n");
1264   }
1265
1266   /* Test for SUID binaries */
1267   binary = GNUNET_OS_get_libexec_binary_path ("gnunet-helper-nat-server");
1268   if ((h->behind_nat == GNUNET_YES) && (GNUNET_YES == h->enable_nat_server) &&
1269       (GNUNET_YES !=
1270        GNUNET_OS_check_helper_binary (binary, GNUNET_YES, "-d 127.0.0.1" ))) // use localhost as source for that one udp-port, ok for testing
1271   {
1272     h->enable_nat_server = GNUNET_NO;
1273     LOG (GNUNET_ERROR_TYPE_WARNING,
1274          _("Configuration requires `%s', but binary is not installed properly (SUID bit not set).  Option disabled.\n"),
1275          "gnunet-helper-nat-server");
1276   }
1277   GNUNET_free (binary);
1278   binary = GNUNET_OS_get_libexec_binary_path ("gnunet-helper-nat-client");
1279   if ((GNUNET_YES == h->enable_nat_client) &&
1280       (GNUNET_YES !=
1281        GNUNET_OS_check_helper_binary (binary, GNUNET_YES, "-d 127.0.0.1 127.0.0.2 42"))) // none of these parameters are actually used in privilege testing mode
1282   {
1283     h->enable_nat_client = GNUNET_NO;
1284     LOG (GNUNET_ERROR_TYPE_WARNING,
1285          _
1286          ("Configuration requires `%s', but binary is not installed properly (SUID bit not set).  Option disabled.\n"),
1287          "gnunet-helper-nat-client");
1288   }
1289   GNUNET_free (binary);
1290   start_gnunet_nat_server (h);
1291
1292   /* FIXME: add support for UPnP, etc */
1293
1294   if (NULL != h->address_callback)
1295   {
1296     h->ifc_task = GNUNET_SCHEDULER_add_now (&list_interfaces, h);
1297     if (GNUNET_YES == h->use_hostname)
1298       h->hostname_task = GNUNET_SCHEDULER_add_now (&resolve_hostname, h);
1299   }
1300
1301   return h;
1302 }
1303
1304
1305 /**
1306  * Stop port redirection and public IP address detection for the given handle.
1307  * This frees the handle, after having sent the needed commands to close open ports.
1308  *
1309  * @param h the handle to stop
1310  */
1311 void
1312 GNUNET_NAT_unregister (struct GNUNET_NAT_Handle *h)
1313 {
1314   unsigned int i;
1315   struct LocalAddressList *lal;
1316   struct MiniList *ml;
1317
1318   LOG (GNUNET_ERROR_TYPE_DEBUG,
1319        "NAT unregister called\n");
1320   while (NULL != (ml = h->mini_head))
1321   {
1322     GNUNET_CONTAINER_DLL_remove (h->mini_head, h->mini_tail, ml);
1323     if (NULL != ml->mini)
1324       GNUNET_NAT_mini_map_stop (ml->mini);
1325     GNUNET_free (ml);
1326   }
1327   if (NULL != h->ext_dns)
1328   {
1329     GNUNET_RESOLVER_request_cancel (h->ext_dns);
1330     h->ext_dns = NULL;
1331   }
1332   if (NULL != h->hostname_dns)
1333   {
1334     GNUNET_RESOLVER_request_cancel (h->hostname_dns);
1335     h->hostname_dns = NULL;
1336   }
1337   if (GNUNET_SCHEDULER_NO_TASK != h->server_read_task)
1338   {
1339     GNUNET_SCHEDULER_cancel (h->server_read_task);
1340     h->server_read_task = GNUNET_SCHEDULER_NO_TASK;
1341   }
1342   if (GNUNET_SCHEDULER_NO_TASK != h->bind_task)
1343   {
1344     GNUNET_SCHEDULER_cancel (h->bind_task);
1345     h->bind_task = GNUNET_SCHEDULER_NO_TASK;
1346   }
1347   if (GNUNET_SCHEDULER_NO_TASK != h->ifc_task)
1348   {
1349     GNUNET_SCHEDULER_cancel (h->ifc_task);
1350     h->ifc_task = GNUNET_SCHEDULER_NO_TASK;
1351   }
1352   if (GNUNET_SCHEDULER_NO_TASK != h->hostname_task)
1353   {
1354     GNUNET_SCHEDULER_cancel (h->hostname_task);
1355     h->hostname_task = GNUNET_SCHEDULER_NO_TASK;
1356   }
1357   if (GNUNET_SCHEDULER_NO_TASK != h->dns_task)
1358   {
1359     GNUNET_SCHEDULER_cancel (h->dns_task);
1360     h->dns_task = GNUNET_SCHEDULER_NO_TASK;
1361   }
1362   if (NULL != h->server_proc)
1363   {
1364     if (0 != GNUNET_OS_process_kill (h->server_proc, GNUNET_TERM_SIG))
1365       GNUNET_log_from_strerror (GNUNET_ERROR_TYPE_WARNING, "nat", "kill");
1366     GNUNET_OS_process_wait (h->server_proc);
1367     GNUNET_OS_process_destroy (h->server_proc);
1368     h->server_proc = NULL;
1369     GNUNET_DISK_pipe_close (h->server_stdout);
1370     h->server_stdout = NULL;
1371     h->server_stdout_handle = NULL;
1372   }
1373   if (NULL != h->server_stdout)
1374   {
1375     GNUNET_DISK_pipe_close (h->server_stdout);
1376     h->server_stdout = NULL;
1377     h->server_stdout_handle = NULL;
1378   }
1379   while (NULL != (lal = h->lal_head))
1380   {
1381     GNUNET_CONTAINER_DLL_remove (h->lal_head, h->lal_tail, lal);
1382     if (NULL != h->address_callback)
1383       h->address_callback (h->callback_cls, GNUNET_NO,
1384                            (const struct sockaddr *) &lal[1], lal->addrlen);
1385     GNUNET_free (lal);
1386   }
1387   for (i = 0; i < h->num_local_addrs; i++)
1388     GNUNET_free (h->local_addrs[i]);
1389   GNUNET_free_non_null (h->local_addrs);
1390   GNUNET_free_non_null (h->local_addrlens);
1391   GNUNET_free_non_null (h->external_address);
1392   GNUNET_free_non_null (h->internal_address);
1393   GNUNET_free (h);
1394 }
1395
1396
1397 /**
1398  * We learned about a peer (possibly behind NAT) so run the
1399  * gnunet-helper-nat-client to send dummy ICMP responses to cause
1400  * that peer to connect to us (connection reversal).
1401  *
1402  * @param h handle (used for configuration)
1403  * @param sa the address of the peer (IPv4-only)
1404  * @return #GNUNET_SYSERR on error, #GNUNET_NO if nat client is disabled,
1405  *         #GNUNET_OK otherwise
1406  */
1407 int
1408 GNUNET_NAT_run_client (struct GNUNET_NAT_Handle *h,
1409                        const struct sockaddr_in *sa)
1410
1411
1412 {
1413   char inet4[INET_ADDRSTRLEN];
1414   char port_as_string[6];
1415   struct GNUNET_OS_Process *proc;
1416   char *binary;
1417
1418   if (GNUNET_YES != h->enable_nat_client)
1419     return GNUNET_NO;                     /* not permitted / possible */
1420
1421   if (h->internal_address == NULL)
1422   {
1423     LOG (GNUNET_ERROR_TYPE_WARNING, "nat",
1424          _("Internal IP address not known, cannot use ICMP NAT traversal method\n"));
1425     return GNUNET_SYSERR;
1426   }
1427   GNUNET_assert (sa->sin_family == AF_INET);
1428   if (NULL == inet_ntop (AF_INET, &sa->sin_addr, inet4, INET_ADDRSTRLEN))
1429   {
1430     GNUNET_log_from_strerror (GNUNET_ERROR_TYPE_WARNING,
1431                               "nat",
1432                               "inet_ntop");
1433     return GNUNET_SYSERR;
1434   }
1435   GNUNET_snprintf (port_as_string,
1436                    sizeof (port_as_string),
1437                    "%d",
1438                    h->adv_port);
1439   LOG (GNUNET_ERROR_TYPE_DEBUG,
1440        _("Running gnunet-helper-nat-client %s %s %u\n"),
1441        h->internal_address,
1442        inet4,
1443        (unsigned int) h->adv_port);
1444   binary = GNUNET_OS_get_libexec_binary_path ("gnunet-helper-nat-client");
1445   proc =
1446       GNUNET_OS_start_process (GNUNET_NO, 0, NULL, NULL,
1447                                binary,
1448                                "gnunet-helper-nat-client",
1449                                h->internal_address,
1450                                inet4, port_as_string, NULL);
1451   GNUNET_free (binary);
1452   if (NULL == proc)
1453     return GNUNET_SYSERR;
1454   /* we know that the gnunet-helper-nat-client will terminate virtually
1455    * instantly */
1456   GNUNET_OS_process_wait (proc);
1457   GNUNET_OS_process_destroy (proc);
1458   return GNUNET_OK;
1459 }
1460
1461
1462 /**
1463  * Test if the given address is (currently) a plausible IP address for this peer.
1464  *
1465  * @param h the handle returned by register
1466  * @param addr IP address to test (IPv4 or IPv6)
1467  * @param addrlen number of bytes in @a addr
1468  * @return #GNUNET_YES if the address is plausible,
1469  *         #GNUNET_NO if the address is not plausible,
1470  *         #GNUNET_SYSERR if the address is malformed
1471  */
1472 int
1473 GNUNET_NAT_test_address (struct GNUNET_NAT_Handle *h,
1474                          const void *addr,
1475                          socklen_t addrlen)
1476 {
1477   struct LocalAddressList *pos;
1478   const struct sockaddr_in *in4;
1479   const struct sockaddr_in6 *in6;
1480
1481   if ((addrlen != sizeof (struct in_addr)) &&
1482       (addrlen != sizeof (struct in6_addr)))
1483   {
1484     GNUNET_break (0);
1485     return GNUNET_SYSERR;
1486   }
1487   for (pos = h->lal_head; NULL != pos; pos = pos->next)
1488   {
1489     if (pos->addrlen == sizeof (struct sockaddr_in))
1490     {
1491       in4 = (struct sockaddr_in *) &pos[1];
1492       if ((addrlen == sizeof (struct in_addr)) &&
1493           (0 == memcmp (&in4->sin_addr, addr, sizeof (struct in_addr))))
1494         return GNUNET_YES;
1495     }
1496     else if (pos->addrlen == sizeof (struct sockaddr_in6))
1497     {
1498       in6 = (struct sockaddr_in6 *) &pos[1];
1499       if ((addrlen == sizeof (struct in6_addr)) &&
1500           (0 == memcmp (&in6->sin6_addr, addr, sizeof (struct in6_addr))))
1501         return GNUNET_YES;
1502     }
1503     else
1504     {
1505       GNUNET_assert (0);
1506     }
1507   }
1508   LOG (GNUNET_ERROR_TYPE_WARNING,
1509        "Asked to validate one of my addresses and validation failed!\n");
1510   return GNUNET_NO;
1511 }
1512
1513
1514 /* end of nat.c */