src/cadet/gnunet-service-cadet_tunnel.c

   1 /*
   2      This file is part of GNUnet.
   3      (C) 2013 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 #include "platform.h"
  22 #include "gnunet_util_lib.h"
  23
  24 #include "gnunet_signatures.h"
  25 #include "gnunet_statistics_service.h"
  26
  27 #include "cadet_protocol.h"
  28 #include "cadet_path.h"
  29
  30 #include "gnunet-service-cadet_tunnel.h"
  31 #include "gnunet-service-cadet_connection.h"
  32 #include "gnunet-service-cadet_channel.h"
  33 #include "gnunet-service-cadet_peer.h"
  34
  35 #define LOG(level, ...) GNUNET_log_from(level,"cadet-tun",__VA_ARGS__)
  36 #define LOG2(level, ...) GNUNET_log_from_nocheck(level,"cadet-tun",__VA_ARGS__)
  37
  38 #define REKEY_WAIT GNUNET_TIME_relative_multiply(GNUNET_TIME_UNIT_SECONDS, 5)
  39
  40 #if !defined(GNUNET_CULL_LOGGING)
  41 #define DUMP_KEYS_TO_STDERR GNUNET_YES
  42 #else
  43 #define DUMP_KEYS_TO_STDERR GNUNET_NO
  44 #endif
  45
  46 /******************************************************************************/
  47 /********************************   STRUCTS  **********************************/
  48 /******************************************************************************/
  49
  50 struct CadetTChannel
  51 {
  52   struct CadetTChannel *next;
  53   struct CadetTChannel *prev;
  54   struct CadetChannel *ch;
  55 };
  56
  57
  58 /**
  59  * Connection list and metadata.
  60  */
  61 struct CadetTConnection
  62 {
  63   /**
  64    * Next in DLL.
  65    */
  66   struct CadetTConnection *next;
  67
  68   /**
  69    * Prev in DLL.
  70    */
  71   struct CadetTConnection *prev;
  72
  73   /**
  74    * Connection handle.
  75    */
  76   struct CadetConnection *c;
  77
  78   /**
  79    * Creation time, to keep oldest connection alive.
  80    */
  81   struct GNUNET_TIME_Absolute created;
  82
  83   /**
  84    * Connection throughput, to keep fastest connection alive.
  85    */
  86   uint32_t throughput;
  87 };
  88
  89 /**
  90  * Structure used during a Key eXchange.
  91  */
  92 struct CadetTunnelKXCtx
  93 {
  94   /**
  95    * Encryption ("our") old "confirmed" key, for encrypting traffic sent by us
  96    * end before the key exchange is finished or times out.
  97    */
  98   struct GNUNET_CRYPTO_SymmetricSessionKey e_key_old;
  99
 100   /**
 101    * Decryption ("their") old "confirmed" key, for decrypting traffic sent by
 102    * the other end before the key exchange started.
 103    */
 104   struct GNUNET_CRYPTO_SymmetricSessionKey d_key_old;
 105
 106   /**
 107    * Challenge to send in a ping and expect in the pong.
 108    */
 109   uint32_t challenge;
 110
 111   /**
 112    * When the rekey started. One minute after this the new key will be used.
 113    */
 114   struct GNUNET_TIME_Absolute rekey_start_time;
 115
 116   /**
 117    * Task for delayed destruction of the Key eXchange context, to allow delayed
 118    * messages with the old key to be decrypted successfully.
 119    */
 120   GNUNET_SCHEDULER_TaskIdentifier finish_task;
 121 };
 122
 123 /**
 124  * Struct containing all information regarding a tunnel to a peer.
 125  */
 126 struct CadetTunnel
 127 {
 128     /**
 129      * Endpoint of the tunnel.
 130      */
 131   struct CadetPeer *peer;
 132
 133     /**
 134      * State of the tunnel connectivity.
 135      */
 136   enum CadetTunnelCState cstate;
 137
 138   /**
 139    * State of the tunnel encryption.
 140    */
 141   enum CadetTunnelEState estate;
 142
 143   /**
 144    * Key eXchange context.
 145    */
 146   struct CadetTunnelKXCtx *kx_ctx;
 147
 148   /**
 149    * Peer's ephemeral key, to recreate @c e_key and @c d_key when own ephemeral
 150    * key changes.
 151    */
 152   struct GNUNET_CRYPTO_EcdhePublicKey peers_ephemeral_key;
 153
 154   /**
 155    * Encryption ("our") key. It is only "confirmed" if kx_ctx is NULL.
 156    */
 157   struct GNUNET_CRYPTO_SymmetricSessionKey e_key;
 158
 159   /**
 160    * Decryption ("their") key. It is only "confirmed" if kx_ctx is NULL.
 161    */
 162   struct GNUNET_CRYPTO_SymmetricSessionKey d_key;
 163
 164   /**
 165    * Task to start the rekey process.
 166    */
 167   GNUNET_SCHEDULER_TaskIdentifier rekey_task;
 168
 169   /**
 170    * Paths that are actively used to reach the destination peer.
 171    */
 172   struct CadetTConnection *connection_head;
 173   struct CadetTConnection *connection_tail;
 174
 175   /**
 176    * Next connection number.
 177    */
 178   uint32_t next_cid;
 179
 180   /**
 181    * Channels inside this tunnel.
 182    */
 183   struct CadetTChannel *channel_head;
 184   struct CadetTChannel *channel_tail;
 185
 186   /**
 187    * Channel ID for the next created channel.
 188    */
 189   CADET_ChannelNumber next_chid;
 190
 191   /**
 192    * Destroy flag: if true, destroy on last message.
 193    */
 194   GNUNET_SCHEDULER_TaskIdentifier destroy_task;
 195
 196   /**
 197    * Queued messages, to transmit once tunnel gets connected.
 198    */
 199   struct CadetTunnelDelayed *tq_head;
 200   struct CadetTunnelDelayed *tq_tail;
 201
 202   /**
 203    * Task to trim connections if too many are present.
 204    */
 205   GNUNET_SCHEDULER_TaskIdentifier trim_connections_task;
 206
 207   /**
 208    * Ephemeral message in the queue (to avoid queueing more than one).
 209    */
 210   struct CadetConnectionQueue *ephm_h;
 211
 212   /**
 213    * Pong message in the queue.
 214    */
 215   struct CadetConnectionQueue *pong_h;
 216 };
 217
 218
 219 /**
 220  * Struct used to save messages in a non-ready tunnel to send once connected.
 221  */
 222 struct CadetTunnelDelayed
 223 {
 224   /**
 225    * DLL
 226    */
 227   struct CadetTunnelDelayed *next;
 228   struct CadetTunnelDelayed *prev;
 229
 230   /**
 231    * Tunnel.
 232    */
 233   struct CadetTunnel *t;
 234
 235   /**
 236    * Tunnel queue given to the channel to cancel request. Update on send_queued.
 237    */
 238   struct CadetTunnelQueue *tq;
 239
 240   /**
 241    * Message to send.
 242    */
 243   /* struct GNUNET_MessageHeader *msg; */
 244 };
 245
 246
 247 /**
 248  * Handle for messages queued but not yet sent.
 249  */
 250 struct CadetTunnelQueue
 251 {
 252   /**
 253    * Connection queue handle, to cancel if necessary.
 254    */
 255   struct CadetConnectionQueue *cq;
 256
 257   /**
 258    * Handle in case message hasn't been given to a connection yet.
 259    */
 260   struct CadetTunnelDelayed *tqd;
 261
 262   /**
 263    * Continuation to call once sent.
 264    */
 265   GCT_sent cont;
 266
 267   /**
 268    * Closure for @c cont.
 269    */
 270   void *cont_cls;
 271 };
 272
 273
 274 /******************************************************************************/
 275 /*******************************   GLOBALS  ***********************************/
 276 /******************************************************************************/
 277
 278 /**
 279  * Global handle to the statistics service.
 280  */
 281 extern struct GNUNET_STATISTICS_Handle *stats;
 282
 283 /**
 284  * Local peer own ID (memory efficient handle).
 285  */
 286 extern GNUNET_PEER_Id myid;
 287
 288 /**
 289  * Local peer own ID (full value).
 290  */
 291 extern struct GNUNET_PeerIdentity my_full_id;
 292
 293
 294 /**
 295  * Don't try to recover tunnels if shutting down.
 296  */
 297 extern int shutting_down;
 298
 299
 300 /**
 301  * Set of all tunnels, in order to trigger a new exchange on rekey.
 302  * Indexed by peer's ID.
 303  */
 304 static struct GNUNET_CONTAINER_MultiPeerMap *tunnels;
 305
 306 /**
 307  * Default TTL for payload packets.
 308  */
 309 static unsigned long long default_ttl;
 310
 311 /**
 312  * Own private key.
 313  */
 314 const static struct GNUNET_CRYPTO_EddsaPrivateKey *my_private_key;
 315
 316 /**
 317  * Own ephemeral private key.
 318  */
 319 static struct GNUNET_CRYPTO_EcdhePrivateKey *my_ephemeral_key;
 320
 321 /**
 322  * Cached message used to perform a key exchange.
 323  */
 324 static struct GNUNET_CADET_KX_Ephemeral kx_msg;
 325
 326 /**
 327  * Task to generate a new ephemeral key.
 328  */
 329 static GNUNET_SCHEDULER_TaskIdentifier rekey_task;
 330
 331 /**
 332  * Rekey period.
 333  */
 334 static struct GNUNET_TIME_Relative rekey_period;
 335
 336 /******************************************************************************/
 337 /********************************   STATIC  ***********************************/
 338 /******************************************************************************/
 339
 340 /**
 341  * Get string description for tunnel connectivity state.
 342  *
 343  * @param cs Tunnel state.
 344  *
 345  * @return String representation.
 346  */
 347 static const char *
 348 cstate2s (enum CadetTunnelCState cs)
 349 {
 350   static char buf[32];
 351
 352   switch (cs)
 353   {
 354     case CADET_TUNNEL_NEW:
 355       return "CADET_TUNNEL_NEW";
 356     case CADET_TUNNEL_SEARCHING:
 357       return "CADET_TUNNEL_SEARCHING";
 358     case CADET_TUNNEL_WAITING:
 359       return "CADET_TUNNEL_WAITING";
 360     case CADET_TUNNEL_READY:
 361       return "CADET_TUNNEL_READY";
 362     case CADET_TUNNEL_SHUTDOWN:
 363       return "CADET_TUNNEL_SHUTDOWN";
 364     default:
 365       SPRINTF (buf, "%u (UNKNOWN STATE)", cs);
 366       return buf;
 367   }
 368   return "";
 369 }
 370
 371
 372 /**
 373  * Get string description for tunnel encryption state.
 374  *
 375  * @param es Tunnel state.
 376  *
 377  * @return String representation.
 378  */
 379 static const char *
 380 estate2s (enum CadetTunnelEState es)
 381 {
 382   static char buf[32];
 383
 384   switch (es)
 385   {
 386     case CADET_TUNNEL_KEY_UNINITIALIZED:
 387       return "CADET_TUNNEL_KEY_UNINITIALIZED";
 388     case CADET_TUNNEL_KEY_SENT:
 389       return "CADET_TUNNEL_KEY_SENT";
 390     case CADET_TUNNEL_KEY_PING:
 391       return "CADET_TUNNEL_KEY_PING";
 392     case CADET_TUNNEL_KEY_OK:
 393       return "CADET_TUNNEL_KEY_OK";
 394     case CADET_TUNNEL_KEY_REKEY:
 395       return "CADET_TUNNEL_KEY_REKEY";
 396     default:
 397       SPRINTF (buf, "%u (UNKNOWN STATE)", es);
 398       return buf;
 399   }
 400   return "";
 401 }
 402
 403
 404 /**
 405  * @brief Check if tunnel is ready to send traffic.
 406  *
 407  * Tunnel must be connected and with encryption correctly set up.
 408  *
 409  * @param t Tunnel to check.
 410  *
 411  * @return #GNUNET_YES if ready, #GNUNET_NO otherwise
 412  */
 413 static int
 414 is_ready (struct CadetTunnel *t)
 415 {
 416   int ready;
 417
 418   GCT_debug (t, GNUNET_ERROR_TYPE_DEBUG);
 419   ready = CADET_TUNNEL_READY == t->cstate
 420           && (CADET_TUNNEL_KEY_OK == t->estate
 421               || CADET_TUNNEL_KEY_REKEY == t->estate);
 422   ready = ready || GCT_is_loopback (t);
 423   return ready;
 424 }
 425
 426
 427 /**
 428  * Check if a key is invalid (NULL pointer or all 0)
 429  *
 430  * @param key Key to check.
 431  *
 432  * @return #GNUNET_YES if key is null, #GNUNET_NO if exists and is not 0.
 433  */
 434 static int
 435 is_key_null (struct GNUNET_CRYPTO_SymmetricSessionKey *key)
 436 {
 437   struct GNUNET_CRYPTO_SymmetricSessionKey null_key;
 438
 439   if (NULL == key)
 440     return GNUNET_YES;
 441
 442   memset (&null_key, 0, sizeof (null_key));
 443   if (0 == memcmp (key, &null_key, sizeof (null_key)))
 444     return GNUNET_YES;
 445   return GNUNET_NO;
 446 }
 447
 448
 449 /**
 450  * Ephemeral key message purpose size.
 451  *
 452  * @return Size of the part of the ephemeral key message that must be signed.
 453  */
 454 size_t
 455 ephemeral_purpose_size (void)
 456 {
 457   return sizeof (struct GNUNET_CRYPTO_EccSignaturePurpose) +
 458          sizeof (struct GNUNET_TIME_AbsoluteNBO) +
 459          sizeof (struct GNUNET_TIME_AbsoluteNBO) +
 460          sizeof (struct GNUNET_CRYPTO_EcdhePublicKey) +
 461          sizeof (struct GNUNET_PeerIdentity);
 462 }
 463
 464
 465 /**
 466  * Size of the encrypted part of a ping message.
 467  *
 468  * @return Size of the encrypted part of a ping message.
 469  */
 470 size_t
 471 ping_encryption_size (void)
 472 {
 473   return sizeof (uint32_t);
 474 }
 475
 476
 477 /**
 478  * Get the channel's buffer. ONLY FOR NON-LOOPBACK CHANNELS!!
 479  *
 480  * @param tch Tunnel's channel handle.
 481  *
 482  * @return Amount of messages the channel can still buffer towards the client.
 483  */
 484 static unsigned int
 485 get_channel_buffer (const struct CadetTChannel *tch)
 486 {
 487   int fwd;
 488
 489   /* If channel is incoming, is terminal in the FWD direction and fwd is YES */
 490   fwd = GCCH_is_terminal (tch->ch, GNUNET_YES);
 491
 492   return GCCH_get_buffer (tch->ch, fwd);
 493 }
 494
 495
 496 /**
 497  * Get the channel's allowance status.
 498  *
 499  * @param tch Tunnel's channel handle.
 500  *
 501  * @return #GNUNET_YES if we allowed the client to send data to us.
 502  */
 503 static int
 504 get_channel_allowed (const struct CadetTChannel *tch)
 505 {
 506   int fwd;
 507
 508   /* If channel is outgoing, is origin in the FWD direction and fwd is YES */
 509   fwd = GCCH_is_origin (tch->ch, GNUNET_YES);
 510
 511   return GCCH_get_allowed (tch->ch, fwd);
 512 }
 513
 514
 515 /**
 516  * Get the connection's buffer.
 517  *
 518  * @param tc Tunnel's connection handle.
 519  *
 520  * @return Amount of messages the connection can still buffer.
 521  */
 522 static unsigned int
 523 get_connection_buffer (const struct CadetTConnection *tc)
 524 {
 525   int fwd;
 526
 527   /* If connection is outgoing, is origin in the FWD direction and fwd is YES */
 528   fwd = GCC_is_origin (tc->c, GNUNET_YES);
 529
 530   return GCC_get_buffer (tc->c, fwd);
 531 }
 532
 533
 534 /**
 535  * Get the connection's allowance.
 536  *
 537  * @param tc Tunnel's connection handle.
 538  *
 539  * @return Amount of messages we have allowed the next peer to send us.
 540  */
 541 static unsigned int
 542 get_connection_allowed (const struct CadetTConnection *tc)
 543 {
 544   int fwd;
 545
 546   /* If connection is outgoing, is origin in the FWD direction and fwd is YES */
 547   fwd = GCC_is_origin (tc->c, GNUNET_YES);
 548
 549   return GCC_get_allowed (tc->c, fwd);
 550 }
 551
 552
 553 /**
 554  * Check that a ephemeral key message s well formed and correctly signed.
 555  *
 556  * @param t Tunnel on which the message came.
 557  * @param msg The ephemeral key message.
 558  *
 559  * @return GNUNET_OK if message is fine, GNUNET_SYSERR otherwise.
 560  */
 561 int
 562 check_ephemeral (struct CadetTunnel *t,
 563                  const struct GNUNET_CADET_KX_Ephemeral *msg)
 564 {
 565   /* Check message size */
 566   if (ntohs (msg->header.size) != sizeof (struct GNUNET_CADET_KX_Ephemeral))
 567     return GNUNET_SYSERR;
 568
 569   /* Check signature size */
 570   if (ntohl (msg->purpose.size) != ephemeral_purpose_size ())
 571     return GNUNET_SYSERR;
 572
 573   /* Check origin */
 574   if (0 != memcmp (&msg->origin_identity,
 575                    GCP_get_id (t->peer),
 576                    sizeof (struct GNUNET_PeerIdentity)))
 577     return GNUNET_SYSERR;
 578
 579   /* Check signature */
 580   if (GNUNET_OK !=
 581       GNUNET_CRYPTO_eddsa_verify (GNUNET_SIGNATURE_PURPOSE_CADET_KX,
 582                                   &msg->purpose,
 583                                   &msg->signature,
 584                                   &msg->origin_identity.public_key))
 585     return GNUNET_SYSERR;
 586
 587   return GNUNET_OK;
 588 }
 589
 590
 591 /**
 592  * Select the best key to use for encryption (send), based on KX status.
 593  *
 594  * Normally, return the current key. If there is a KX in progress and the old
 595  * key is fresh enough, return the old key.
 596  *
 597  * @param t Tunnel to choose the key from.
 598  *
 599  * @return The optimal key to encrypt/hmac outgoing traffic.
 600  */
 601 static const struct GNUNET_CRYPTO_SymmetricSessionKey *
 602 select_key (const struct CadetTunnel *t)
 603 {
 604   const struct GNUNET_CRYPTO_SymmetricSessionKey *key;
 605
 606   if (NULL != t->kx_ctx
 607       && GNUNET_SCHEDULER_NO_TASK == t->kx_ctx->finish_task)
 608   {
 609     struct GNUNET_TIME_Relative age;
 610
 611     age = GNUNET_TIME_absolute_get_duration (t->kx_ctx->rekey_start_time);
 612     LOG (GNUNET_ERROR_TYPE_DEBUG,
 613          "  key exchange in progress, started %s ago\n",
 614          GNUNET_STRINGS_relative_time_to_string (age, GNUNET_YES));
 615     // FIXME make duration of old keys configurable
 616     if (age.rel_value_us < GNUNET_TIME_UNIT_MINUTES.rel_value_us)
 617     {
 618       LOG (GNUNET_ERROR_TYPE_DEBUG, "  using old key\n");
 619       key = &t->kx_ctx->e_key_old;
 620     }
 621     else
 622     {
 623       LOG (GNUNET_ERROR_TYPE_DEBUG, "  using new key (old key too old)\n");
 624       key = &t->e_key;
 625     }
 626   }
 627   else
 628   {
 629     LOG (GNUNET_ERROR_TYPE_DEBUG, "  no KX: using current key\n");
 630     key = &t->e_key;
 631   }
 632   return key;
 633 }
 634
 635
 636 /**
 637  * Calculate HMAC.
 638  *
 639  * @param plaintext Content to HMAC.
 640  * @param size Size of @c plaintext.
 641  * @param iv Initialization vector for the message.
 642  * @param key Key to use.
 643  * @param hmac[out] Destination to store the HMAC.
 644  */
 645 static void
 646 t_hmac (const void *plaintext, size_t size,
 647         uint32_t iv, const struct GNUNET_CRYPTO_SymmetricSessionKey *key,
 648         struct GNUNET_CADET_Hash *hmac)
 649 {
 650   static const char ctx[] = "cadet authentication key";
 651   struct GNUNET_CRYPTO_AuthKey auth_key;
 652   struct GNUNET_HashCode hash;
 653
 654 #if DUMP_KEYS_TO_STDERR
 655   LOG (GNUNET_ERROR_TYPE_INFO, "  HMAC with key %s\n",
 656        GNUNET_h2s ((struct GNUNET_HashCode *) key));
 657 #endif
 658   GNUNET_CRYPTO_hmac_derive_key (&auth_key, key,
 659                                  &iv, sizeof (iv),
 660                                  key, sizeof (*key),
 661                                  ctx, sizeof (ctx),
 662                                  NULL);
 663   /* Two step: CADET_Hash is only 256 bits, HashCode is 512. */
 664   GNUNET_CRYPTO_hmac (&auth_key, plaintext, size, &hash);
 665   memcpy (hmac, &hash, sizeof (*hmac));
 666 }
 667
 668
 669 /**
 670  * Encrypt daforce_newest_keyta with the tunnel key.
 671  *
 672  * @param t Tunnel whose key to use.
 673  * @param dst Destination for the encrypted data.
 674  * @param src Source of the plaintext. Can overlap with @c dst.
 675  * @param size Size of the plaintext.
 676  * @param iv Initialization Vector to use.
 677  * @param force_newest_key Force the use of the newest key, otherwise
 678  *                         CADET will use the old key when allowed.
 679  *                         This can happen in the case when a KX is going on
 680  *                         and the old one hasn't expired.
 681  */
 682 static int
 683 t_encrypt (struct CadetTunnel *t, void *dst, const void *src,
 684            size_t size, uint32_t iv, int force_newest_key)
 685 {
 686   struct GNUNET_CRYPTO_SymmetricInitializationVector siv;
 687   const struct GNUNET_CRYPTO_SymmetricSessionKey *key;
 688   size_t out_size;
 689
 690   LOG (GNUNET_ERROR_TYPE_DEBUG, "  t_encrypt start\n");
 691
 692   key = GNUNET_YES == force_newest_key ? &t->e_key : select_key (t);
 693   #if DUMP_KEYS_TO_STDERR
 694   LOG (GNUNET_ERROR_TYPE_INFO, "  ENC with key %s\n",
 695        GNUNET_h2s ((struct GNUNET_HashCode *) key));
 696   #endif
 697   GNUNET_CRYPTO_symmetric_derive_iv (&siv, key, &iv, sizeof (iv), NULL);
 698   LOG (GNUNET_ERROR_TYPE_DEBUG, "  t_encrypt IV derived\n");
 699   out_size = GNUNET_CRYPTO_symmetric_encrypt (src, size, key, &siv, dst);
 700   LOG (GNUNET_ERROR_TYPE_DEBUG, "  t_encrypt end\n");
 701
 702   return out_size;
 703 }
 704
 705
 706 /**
 707  * Decrypt and verify data with the appropriate tunnel key.
 708  *
 709  * @param key Key to use.
 710  * @param dst Destination for the plaintext.
 711  * @param src Source of the encrypted data. Can overlap with @c dst.
 712  * @param size Size of the encrypted data.
 713  * @param iv Initialization Vector to use.
 714  *
 715  * @return Size of the decrypted data, -1 if an error was encountered.
 716  */
 717 static int
 718 decrypt (const struct GNUNET_CRYPTO_SymmetricSessionKey *key,
 719          void *dst, const void *src, size_t size, uint32_t iv)
 720 {
 721   struct GNUNET_CRYPTO_SymmetricInitializationVector siv;
 722   size_t out_size;
 723
 724   LOG (GNUNET_ERROR_TYPE_DEBUG, "  decrypt start\n");
 725   LOG (GNUNET_ERROR_TYPE_DEBUG, "  decrypt iv\n");
 726   GNUNET_CRYPTO_symmetric_derive_iv (&siv, key, &iv, sizeof (iv), NULL);
 727   LOG (GNUNET_ERROR_TYPE_DEBUG, "  decrypt iv done\n");
 728   out_size = GNUNET_CRYPTO_symmetric_decrypt (src, size, key, &siv, dst);
 729   LOG (GNUNET_ERROR_TYPE_DEBUG, "  decrypt end\n");
 730
 731   return out_size;
 732 }
 733
 734
 735 /**
 736  * Decrypt and verify data with the most recent tunnel key.
 737  *
 738  * @param t Tunnel whose key to use.
 739  * @param dst Destination for the plaintext.
 740  * @param src Source of the encrypted data. Can overlap with @c dst.
 741  * @param size Size of the encrypted data.
 742  * @param iv Initialization Vector to use.
 743  *
 744  * @return Size of the decrypted data, -1 if an error was encountered.
 745  */
 746 static int
 747 t_decrypt (struct CadetTunnel *t, void *dst, const void *src,
 748            size_t size, uint32_t iv)
 749 {
 750   size_t out_size;
 751
 752 #if DUMP_KEYS_TO_STDERR
 753   LOG (GNUNET_ERROR_TYPE_DEBUG, "  t_decrypt with %s\n",
 754        GNUNET_h2s ((struct GNUNET_HashCode *) &t->d_key));
 755 #endif
 756   if (CADET_TUNNEL_KEY_UNINITIALIZED == t->estate)
 757   {
 758     GNUNET_STATISTICS_update (stats, "# non decryptable data", 1, GNUNET_NO);
 759     LOG (GNUNET_ERROR_TYPE_WARNING,
 760          "got data on %s without a valid key\n",
 761          GCT_2s (t));
 762     GCT_debug (t, GNUNET_ERROR_TYPE_WARNING);
 763     return -1;
 764   }
 765
 766   out_size = decrypt (&t->d_key, dst, src, size, iv);
 767
 768   return out_size;
 769 }
 770
 771
 772 /**
 773  * Decrypt and verify data with the appropriate tunnel key and verify that the
 774  * data has not been altered since it was sent by the remote peer.
 775  *
 776  * @param t Tunnel whose key to use.
 777  * @param dst Destination for the plaintext.
 778  * @param src Source of the encrypted data. Can overlap with @c dst.
 779  * @param size Size of the encrypted data.
 780  * @param iv Initialization Vector to use.
 781  * @param msg_hmac HMAC of the message, cannot be NULL.
 782  *
 783  * @return Size of the decrypted data, -1 if an error was encountered.
 784  */
 785 static int
 786 t_decrypt_and_validate (struct CadetTunnel *t,
 787                         void *dst, const void *src,
 788                         size_t size, uint32_t iv,
 789                         const struct GNUNET_CADET_Hash *msg_hmac)
 790 {
 791   struct GNUNET_CRYPTO_SymmetricSessionKey *key;
 792   struct GNUNET_CADET_Hash hmac;
 793   int decrypted_size;
 794
 795   /* Try primary (newest) key */
 796   key = &t->d_key;
 797   decrypted_size = decrypt (key, dst, src, size, iv);
 798   t_hmac (src, size, iv, key, &hmac);
 799   if (0 == memcmp (msg_hmac, &hmac, sizeof (hmac)))
 800     return decrypted_size;
 801
 802   /* If no key exchange is going on, we just failed */
 803   if (NULL == t->kx_ctx)
 804   {
 805     GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
 806                 "Failed checksum validation on tunnel %s with no KX\n",
 807                 GCT_2s (t));
 808     GNUNET_STATISTICS_update (stats, "# wrong HMAC", 1, GNUNET_NO);
 809     return -1;
 810   }
 811
 812   /* Try secondary (from previous KX period) key */
 813   key = &t->kx_ctx->d_key_old;
 814   decrypted_size = decrypt (key, dst, src, size, iv);
 815   t_hmac (src, size, iv, key, &hmac);
 816   if (0 == memcmp (msg_hmac, &hmac, sizeof (hmac)))
 817     return decrypted_size;
 818
 819   GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
 820               "Failed checksum validation on tunnel %s with KX\n",
 821               GCT_2s (t));
 822   GNUNET_STATISTICS_update (stats, "# wrong HMAC", 1, GNUNET_NO);
 823   return -1;
 824 }
 825
 826
 827 /**
 828  * Create key material by doing ECDH on the local and remote ephemeral keys.
 829  *
 830  * @param key_material Where to store the key material.
 831  * @param ephemeral_key Peer's public ephemeral key.
 832  */
 833 void
 834 derive_key_material (struct GNUNET_HashCode *key_material,
 835                      const struct GNUNET_CRYPTO_EcdhePublicKey *ephemeral_key)
 836 {
 837   if (GNUNET_OK !=
 838       GNUNET_CRYPTO_ecc_ecdh (my_ephemeral_key,
 839                               ephemeral_key,
 840                               key_material))
 841   {
 842     GNUNET_break (0);
 843   }
 844 }
 845
 846
 847 /**
 848  * Create a symmetic key from the identities of both ends and the key material
 849  * from ECDH.
 850  *
 851  * @param key Destination for the generated key.
 852  * @param sender ID of the peer that will encrypt with @c key.
 853  * @param receiver ID of the peer that will decrypt with @c key.
 854  * @param key_material Hash created with ECDH with the ephemeral keys.
 855  */
 856 void
 857 derive_symmertic (struct GNUNET_CRYPTO_SymmetricSessionKey *key,
 858                   const struct GNUNET_PeerIdentity *sender,
 859                   const struct GNUNET_PeerIdentity *receiver,
 860                   const struct GNUNET_HashCode *key_material)
 861 {
 862   const char salt[] = "CADET kx salt";
 863
 864   GNUNET_CRYPTO_kdf (key, sizeof (struct GNUNET_CRYPTO_SymmetricSessionKey),
 865                      salt, sizeof (salt),
 866                      key_material, sizeof (struct GNUNET_HashCode),
 867                      sender, sizeof (struct GNUNET_PeerIdentity),
 868                      receiver, sizeof (struct GNUNET_PeerIdentity),
 869                      NULL);
 870 }
 871
 872
 873 /**
 874  * Derive the tunnel's keys using our own and the peer's ephemeral keys.
 875  *
 876  * @param t Tunnel for which to create the keys.
 877  */
 878 static void
 879 create_keys (struct CadetTunnel *t)
 880 {
 881   struct GNUNET_HashCode km;
 882
 883   derive_key_material (&km, &t->peers_ephemeral_key);
 884   derive_symmertic (&t->e_key, &my_full_id, GCP_get_id (t->peer), &km);
 885   derive_symmertic (&t->d_key, GCP_get_id (t->peer), &my_full_id, &km);
 886   #if DUMP_KEYS_TO_STDERR
 887   LOG (GNUNET_ERROR_TYPE_INFO, "ME: %s\n",
 888        GNUNET_h2s ((struct GNUNET_HashCode *) &kx_msg.ephemeral_key));
 889   LOG (GNUNET_ERROR_TYPE_INFO, "PE: %s\n",
 890        GNUNET_h2s ((struct GNUNET_HashCode *) &t->peers_ephemeral_key));
 891   LOG (GNUNET_ERROR_TYPE_INFO, "KM: %s\n", GNUNET_h2s (&km));
 892   LOG (GNUNET_ERROR_TYPE_INFO, "EK: %s\n",
 893        GNUNET_h2s ((struct GNUNET_HashCode *) &t->e_key));
 894   LOG (GNUNET_ERROR_TYPE_INFO, "DK: %s\n",
 895        GNUNET_h2s ((struct GNUNET_HashCode *) &t->d_key));
 896   #endif
 897 }
 898
 899
 900 /**
 901  * Create a new Key eXchange context for the tunnel.
 902  *
 903  * If the old keys were verified, keep them for old traffic. Create a new KX
 904  * timestamp and a new nonce.
 905  *
 906  * @param t Tunnel for which to create the KX ctx.
 907  */
 908 static void
 909 create_kx_ctx (struct CadetTunnel *t)
 910 {
 911   LOG (GNUNET_ERROR_TYPE_INFO, "  new kx ctx for %s\n", GCT_2s (t));
 912
 913   if (NULL != t->kx_ctx)
 914   {
 915     if (GNUNET_SCHEDULER_NO_TASK != t->kx_ctx->finish_task)
 916     {
 917       LOG (GNUNET_ERROR_TYPE_INFO, "  resetting exisiting finish task\n");
 918       GNUNET_SCHEDULER_cancel (t->kx_ctx->finish_task);
 919       t->kx_ctx->finish_task = GNUNET_SCHEDULER_NO_TASK;
 920     }
 921   }
 922   else
 923   {
 924     t->kx_ctx = GNUNET_new (struct CadetTunnelKXCtx);
 925     t->kx_ctx->challenge = GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_NONCE,
 926                                                      UINT32_MAX);
 927   }
 928
 929   if (CADET_TUNNEL_KEY_OK == t->estate)
 930   {
 931     LOG (GNUNET_ERROR_TYPE_INFO, "  backing up keys\n");
 932     t->kx_ctx->d_key_old = t->d_key;
 933     t->kx_ctx->e_key_old = t->e_key;
 934   }
 935   else
 936     LOG (GNUNET_ERROR_TYPE_INFO, "  old keys not valid, not saving\n");
 937   t->kx_ctx->rekey_start_time = GNUNET_TIME_absolute_get ();
 938   create_keys (t);
 939 }
 940
 941
 942 /**
 943  * @brief Finish the Key eXchange and destroy the old keys.
 944  *
 945  * @param cls Closure (Tunnel for which to finish the KX).
 946  * @param tc Task context.
 947  */
 948 static void
 949 finish_kx (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
 950 {
 951   struct CadetTunnel *t = cls;
 952
 953   LOG (GNUNET_ERROR_TYPE_INFO, "finish KX for %s\n", GCT_2s (t));
 954
 955   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
 956   {
 957     LOG (GNUNET_ERROR_TYPE_INFO, "  shutdown\n");
 958     return;
 959   }
 960
 961   GNUNET_free (t->kx_ctx);
 962   t->kx_ctx = NULL;
 963 }
 964
 965
 966 /**
 967  * Destroy a Key eXchange context for the tunnel. This function only schedules
 968  * the destruction, the freeing of the memory (and clearing of old key material)
 969  * happens after a delay!
 970  *
 971  * @param t Tunnel whose KX ctx to destroy.
 972  */
 973 static void
 974 destroy_kx_ctx (struct CadetTunnel *t)
 975 {
 976   struct GNUNET_TIME_Relative delay;
 977
 978   if (NULL == t->kx_ctx || GNUNET_SCHEDULER_NO_TASK != t->kx_ctx->finish_task)
 979     return;
 980
 981   if (is_key_null (&t->kx_ctx->e_key_old))
 982   {
 983     t->kx_ctx->finish_task = GNUNET_SCHEDULER_add_now (finish_kx, t);
 984     return;
 985   }
 986
 987   delay = GNUNET_TIME_relative_divide (rekey_period, 4);
 988   delay = GNUNET_TIME_relative_min (delay, GNUNET_TIME_UNIT_MINUTES);
 989
 990   t->kx_ctx->finish_task = GNUNET_SCHEDULER_add_delayed (delay, finish_kx, t);
 991 }
 992
 993
 994
 995 /**
 996  * Pick a connection on which send the next data message.
 997  *
 998  * @param t Tunnel on which to send the message.
 999  *
1000  * @return The connection on which to send the next message.
1001  */
1002 static struct CadetConnection *
1003 tunnel_get_connection (struct CadetTunnel *t)
1004 {
1005   struct CadetTConnection *iter;
1006   struct CadetConnection *best;
1007   unsigned int qn;
1008   unsigned int lowest_q;
1009
1010   LOG (GNUNET_ERROR_TYPE_DEBUG, "tunnel_get_connection %s\n", GCT_2s (t));
1011   best = NULL;
1012   lowest_q = UINT_MAX;
1013   for (iter = t->connection_head; NULL != iter; iter = iter->next)
1014   {
1015     LOG (GNUNET_ERROR_TYPE_DEBUG, "  connection %s: %u\n",
1016          GCC_2s (iter->c), GCC_get_state (iter->c));
1017     if (CADET_CONNECTION_READY == GCC_get_state (iter->c))
1018     {
1019       qn = GCC_get_qn (iter->c, GCC_is_origin (iter->c, GNUNET_YES));
1020       LOG (GNUNET_ERROR_TYPE_DEBUG, "    q_n %u, \n", qn);
1021       if (qn < lowest_q)
1022       {
1023         best = iter->c;
1024         lowest_q = qn;
1025       }
1026     }
1027   }
1028   LOG (GNUNET_ERROR_TYPE_DEBUG, " selected: connection %s\n", GCC_2s (best));
1029   return best;
1030 }
1031
1032
1033 /**
1034  * Callback called when a queued message is sent.
1035  *
1036  * Calculates the average time and connection packet tracking.
1037  *
1038  * @param cls Closure (TunnelQueue handle).
1039  * @param c Connection this message was on.
1040  * @param q Connection queue handle (unused).
1041  * @param type Type of message sent.
1042  * @param fwd Was this a FWD going message?
1043  * @param size Size of the message.
1044  */
1045 static void
1046 tun_message_sent (void *cls,
1047               struct CadetConnection *c,
1048               struct CadetConnectionQueue *q,
1049               uint16_t type, int fwd, size_t size)
1050 {
1051   struct CadetTunnelQueue *qt = cls;
1052   struct CadetTunnel *t;
1053
1054   LOG (GNUNET_ERROR_TYPE_DEBUG, "tun_message_sent\n");
1055
1056   GNUNET_assert (NULL != qt->cont);
1057   t = NULL == c ? NULL : GCC_get_tunnel (c);
1058   qt->cont (qt->cont_cls, t, qt, type, size);
1059   GNUNET_free (qt);
1060 }
1061
1062
1063 static unsigned int
1064 count_queued_data (const struct CadetTunnel *t)
1065 {
1066   struct CadetTunnelDelayed *iter;
1067   unsigned int count;
1068
1069   for (count = 0, iter = t->tq_head; iter != NULL; iter = iter->next)
1070     count++;
1071
1072   return count;
1073 }
1074
1075 /**
1076  * Delete a queued message: either was sent or the channel was destroyed
1077  * before the tunnel's key exchange had a chance to finish.
1078  *
1079  * @param tqd Delayed queue handle.
1080  */
1081 static void
1082 unqueue_data (struct CadetTunnelDelayed *tqd)
1083 {
1084   GNUNET_CONTAINER_DLL_remove (tqd->t->tq_head, tqd->t->tq_tail, tqd);
1085   GNUNET_free (tqd);
1086 }
1087
1088
1089 /**
1090  * Cache a message to be sent once tunnel is online.
1091  *
1092  * @param t Tunnel to hold the message.
1093  * @param msg Message itself (copy will be made).
1094  */
1095 static struct CadetTunnelDelayed *
1096 queue_data (struct CadetTunnel *t, const struct GNUNET_MessageHeader *msg)
1097 {
1098   struct CadetTunnelDelayed *tqd;
1099   uint16_t size = ntohs (msg->size);
1100
1101   LOG (GNUNET_ERROR_TYPE_DEBUG, "queue data on Tunnel %s\n", GCT_2s (t));
1102
1103   if (GNUNET_YES == is_ready (t))
1104   {
1105     GNUNET_break (0);
1106     return NULL;
1107   }
1108
1109   tqd = GNUNET_malloc (sizeof (struct CadetTunnelDelayed) + size);
1110
1111   tqd->t = t;
1112   memcpy (&tqd[1], msg, size);
1113   GNUNET_CONTAINER_DLL_insert_tail (t->tq_head, t->tq_tail, tqd);
1114   return tqd;
1115 }
1116
1117
1118 /**
1119  * Sends an already built message on a tunnel, encrypting it and
1120  * choosing the best connection.
1121  *
1122  * @param message Message to send. Function modifies it.
1123  * @param t Tunnel on which this message is transmitted.
1124  * @param c Connection to use (autoselect if NULL).
1125  * @param force Force the tunnel to take the message (buffer overfill).
1126  * @param cont Continuation to call once message is really sent.
1127  * @param cont_cls Closure for @c cont.
1128  * @param existing_q In case this a transmission of previously queued data,
1129  *                   this should be TunnelQueue given to the client.
1130  *                   Otherwise, NULL.
1131  *
1132  * @return Handle to cancel message.
1133  *         NULL if @c cont is NULL or an error happens and message is dropped.
1134  */
1135 static struct CadetTunnelQueue *
1136 send_prebuilt_message (const struct GNUNET_MessageHeader *message,
1137                        struct CadetTunnel *t, struct CadetConnection *c,
1138                        int force, GCT_sent cont, void *cont_cls,
1139                        struct CadetTunnelQueue *existing_q)
1140 {
1141   struct CadetTunnelQueue *tq;
1142   struct GNUNET_CADET_Encrypted *msg;
1143   size_t size = ntohs (message->size);
1144   char cbuf[sizeof (struct GNUNET_CADET_Encrypted) + size];
1145   uint32_t mid;
1146   uint32_t iv;
1147   uint16_t type;
1148   int fwd;
1149
1150   LOG (GNUNET_ERROR_TYPE_DEBUG, "GMT Send on Tunnel %s\n", GCT_2s (t));
1151
1152   if (GNUNET_NO == is_ready (t))
1153   {
1154     struct CadetTunnelDelayed *tqd;
1155     /* A non null existing_q indicates sending of queued data.
1156      * Should only happen after tunnel becomes ready.
1157      */
1158     GNUNET_assert (NULL == existing_q);
1159     tqd = queue_data (t, message);
1160     if (NULL == cont)
1161       return NULL;
1162     tq = GNUNET_new (struct CadetTunnelQueue);
1163     tq->tqd = tqd;
1164     tqd->tq = tq;
1165     tq->cont = cont;
1166     tq->cont_cls = cont_cls;
1167     return tq;
1168   }
1169
1170   GNUNET_assert (GNUNET_NO == GCT_is_loopback (t));
1171
1172   iv = GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_NONCE, UINT32_MAX);
1173   msg = (struct GNUNET_CADET_Encrypted *) cbuf;
1174   msg->header.type = htons (GNUNET_MESSAGE_TYPE_CADET_ENCRYPTED);
1175   msg->iv = iv;
1176   GNUNET_assert (t_encrypt (t, &msg[1], message, size, iv, GNUNET_NO) == size);
1177   t_hmac (&msg[1], size, iv, select_key (t), &msg->hmac);
1178   msg->header.size = htons (sizeof (struct GNUNET_CADET_Encrypted) + size);
1179
1180   if (NULL == c)
1181     c = tunnel_get_connection (t);
1182   if (NULL == c)
1183   {
1184     /* Why is tunnel 'ready'? Should have been queued! */
1185     if (GNUNET_SCHEDULER_NO_TASK != t->destroy_task)
1186     {
1187       GNUNET_break (0);
1188       GCT_debug (t, GNUNET_ERROR_TYPE_WARNING);
1189     }
1190     return NULL; /* Drop... */
1191   }
1192
1193   mid = 0;
1194   type = ntohs (message->type);
1195   switch (type)
1196   {
1197     case GNUNET_MESSAGE_TYPE_CADET_DATA:
1198     case GNUNET_MESSAGE_TYPE_CADET_DATA_ACK:
1199       if (GNUNET_MESSAGE_TYPE_CADET_DATA == type)
1200         mid = ntohl (((struct GNUNET_CADET_Data *) message)->mid);
1201       else
1202         mid = ntohl (((struct GNUNET_CADET_DataACK *) message)->mid);
1203       /* Fall thru */
1204     case GNUNET_MESSAGE_TYPE_CADET_KEEPALIVE:
1205     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_CREATE:
1206     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_DESTROY:
1207     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_ACK:
1208     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_NACK:
1209       msg->cid = *GCC_get_id (c);
1210       msg->ttl = htonl (default_ttl);
1211       break;
1212     default:
1213       GNUNET_break (0);
1214       LOG (GNUNET_ERROR_TYPE_ERROR, "type %s not valid\n", GC_m2s (type));
1215   }
1216   LOG (GNUNET_ERROR_TYPE_DEBUG, "type %s\n", GC_m2s (type));
1217
1218   fwd = GCC_is_origin (c, GNUNET_YES);
1219
1220   if (NULL == cont)
1221   {
1222     GNUNET_break (NULL == GCC_send_prebuilt_message (&msg->header, type, mid, c,
1223                                                      fwd, force, NULL, NULL));
1224     return NULL;
1225   }
1226   if (NULL == existing_q)
1227   {
1228     tq = GNUNET_new (struct CadetTunnelQueue); /* FIXME valgrind: leak*/
1229   }
1230   else
1231   {
1232     tq = existing_q;
1233     tq->tqd = NULL;
1234   }
1235   tq->cq = GCC_send_prebuilt_message (&msg->header, type, mid, c, fwd, force,
1236                                       &tun_message_sent, tq);
1237   GNUNET_assert (NULL != tq->cq);
1238   tq->cont = cont;
1239   tq->cont_cls = cont_cls;
1240
1241   return tq;
1242 }
1243
1244
1245 /**
1246  * Send all cached messages that we can, tunnel is online.
1247  *
1248  * @param t Tunnel that holds the messages. Cannot be loopback.
1249  */
1250 static void
1251 send_queued_data (struct CadetTunnel *t)
1252 {
1253   struct CadetTunnelDelayed *tqd;
1254   struct CadetTunnelDelayed *next;
1255   unsigned int room;
1256
1257   LOG (GNUNET_ERROR_TYPE_INFO, "Send queued data, tunnel %s\n", GCT_2s (t));
1258
1259   if (GCT_is_loopback (t))
1260   {
1261     GNUNET_break (0);
1262     return;
1263   }
1264
1265   if (GNUNET_NO == is_ready (t))
1266   {
1267     LOG (GNUNET_ERROR_TYPE_DEBUG, "  not ready yet: %s/%s\n",
1268          estate2s (t->estate), cstate2s (t->cstate));
1269     return;
1270   }
1271
1272   room = GCT_get_connections_buffer (t);
1273   LOG (GNUNET_ERROR_TYPE_DEBUG, "  buffer space: %u\n", room);
1274   LOG (GNUNET_ERROR_TYPE_DEBUG, "  tq head: %p\n", t->tq_head);
1275   for (tqd = t->tq_head; NULL != tqd && room > 0; tqd = next)
1276   {
1277     LOG (GNUNET_ERROR_TYPE_DEBUG, " sending queued data\n");
1278     next = tqd->next;
1279     room--;
1280     send_prebuilt_message ((struct GNUNET_MessageHeader *) &tqd[1],
1281                            tqd->t, NULL, GNUNET_YES,
1282                            NULL != tqd->tq ? tqd->tq->cont : NULL,
1283                            NULL != tqd->tq ? tqd->tq->cont_cls : NULL,
1284                            tqd->tq);
1285     unqueue_data (tqd);
1286   }
1287   LOG (GNUNET_ERROR_TYPE_DEBUG, "GCT_send_queued_data end\n", GCP_2s (t->peer));
1288 }
1289
1290
1291 /**
1292  * Callback called when a queued message is sent.
1293  *
1294  * @param cls Closure.
1295  * @param c Connection this message was on.
1296  * @param type Type of message sent.
1297  * @param fwd Was this a FWD going message?
1298  * @param size Size of the message.
1299  */
1300 static void
1301 ephm_sent (void *cls,
1302          struct CadetConnection *c,
1303          struct CadetConnectionQueue *q,
1304          uint16_t type, int fwd, size_t size)
1305 {
1306   struct CadetTunnel *t = cls;
1307   LOG (GNUNET_ERROR_TYPE_DEBUG, "ephm_sent %s\n", GC_m2s (type));
1308   t->ephm_h = NULL;
1309 }
1310
1311 /**
1312  * Callback called when a queued message is sent.
1313  *
1314  * @param cls Closure.
1315  * @param c Connection this message was on.
1316  * @param type Type of message sent.
1317  * @param fwd Was this a FWD going message?
1318  * @param size Size of the message.
1319  */
1320 static void
1321 pong_sent (void *cls,
1322            struct CadetConnection *c,
1323            struct CadetConnectionQueue *q,
1324            uint16_t type, int fwd, size_t size)
1325 {
1326   struct CadetTunnel *t = cls;
1327   LOG (GNUNET_ERROR_TYPE_DEBUG, "pong_sent %s\n", GC_m2s (type));
1328
1329   t->pong_h = NULL;
1330 }
1331
1332 /**
1333  * Sends key exchange message on a tunnel, choosing the best connection.
1334  * Should not be called on loopback tunnels.
1335  *
1336  * @param t Tunnel on which this message is transmitted.
1337  * @param message Message to send. Function modifies it.
1338  *
1339  * @return Handle to the message in the connection queue.
1340  */
1341 static struct CadetConnectionQueue *
1342 send_kx (struct CadetTunnel *t,
1343          const struct GNUNET_MessageHeader *message)
1344 {
1345   struct CadetConnection *c;
1346   struct GNUNET_CADET_KX *msg;
1347   size_t size = ntohs (message->size);
1348   char cbuf[sizeof (struct GNUNET_CADET_KX) + size];
1349   uint16_t type;
1350   int fwd;
1351   GCC_sent cont;
1352
1353   LOG (GNUNET_ERROR_TYPE_DEBUG, "GMT KX on Tunnel %s\n", GCT_2s (t));
1354
1355   /* Avoid loopback. */
1356   if (GCT_is_loopback (t))
1357   {
1358     LOG (GNUNET_ERROR_TYPE_DEBUG, "  loopback!\n");
1359     GNUNET_break (0);
1360     return NULL;
1361   }
1362   type = ntohs (message->type);
1363
1364   /* Even if tunnel is being destroyed, send anyway.
1365    * Could be a response to a rekey initiated by remote peer,
1366    * who is trying to create a new channel!
1367    */
1368
1369   /* Must have a connection, or be looking for one. */
1370   if (NULL == t->connection_head)
1371   {
1372     if (CADET_TUNNEL_SEARCHING != t->cstate)
1373     {
1374       LOG (GNUNET_ERROR_TYPE_ERROR, "\n\n\n");
1375       GNUNET_break (0);
1376       LOG (GNUNET_ERROR_TYPE_ERROR, "no connection, sending %s\n", GC_m2s (type));
1377       GCT_debug (t, GNUNET_ERROR_TYPE_ERROR);
1378       GCP_debug (t->peer, GNUNET_ERROR_TYPE_ERROR);
1379       LOG (GNUNET_ERROR_TYPE_ERROR, "\n\n\n");
1380     }
1381     return NULL;
1382   }
1383
1384   msg = (struct GNUNET_CADET_KX *) cbuf;
1385   msg->header.type = htons (GNUNET_MESSAGE_TYPE_CADET_KX);
1386   msg->header.size = htons (sizeof (struct GNUNET_CADET_KX) + size);
1387   c = tunnel_get_connection (t);
1388   if (NULL == c)
1389   {
1390     if (GNUNET_SCHEDULER_NO_TASK == t->destroy_task
1391         && CADET_TUNNEL_READY == t->cstate)
1392     {
1393       GNUNET_break (0);
1394       GCT_debug (t, GNUNET_ERROR_TYPE_ERROR);
1395     }
1396     return NULL;
1397   }
1398   switch (type)
1399   {
1400     case GNUNET_MESSAGE_TYPE_CADET_KX_EPHEMERAL:
1401       GNUNET_assert (NULL == t->ephm_h);
1402       cont = &ephm_sent;
1403       memcpy (&msg[1], message, size);
1404       break;
1405     case GNUNET_MESSAGE_TYPE_CADET_KX_PONG:
1406       GNUNET_assert (NULL == t->pong_h);
1407       cont = &pong_sent;
1408       memcpy (&msg[1], message, size);
1409       break;
1410
1411     default:
1412       LOG (GNUNET_ERROR_TYPE_DEBUG, "unkown type %s\n", GC_m2s (type));
1413       GNUNET_assert (0);
1414   }
1415
1416   fwd = GCC_is_origin (t->connection_head->c, GNUNET_YES);
1417
1418   return GCC_send_prebuilt_message (&msg->header, type, 0, c,
1419                                     fwd, GNUNET_YES,
1420                                     cont, t);
1421 }
1422
1423
1424 /**
1425  * Send the ephemeral key on a tunnel.
1426  *
1427  * @param t Tunnel on which to send the key.
1428  */
1429 static void
1430 send_ephemeral (struct CadetTunnel *t)
1431 {
1432   LOG (GNUNET_ERROR_TYPE_INFO, "===> EPHM for %s\n", GCT_2s (t));
1433   if (NULL != t->ephm_h)
1434   {
1435     LOG (GNUNET_ERROR_TYPE_INFO, "     already queued\n");
1436     return;
1437   }
1438
1439   kx_msg.sender_status = htonl (t->estate);
1440   kx_msg.iv = GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_NONCE, UINT32_MAX);
1441   kx_msg.nonce = t->kx_ctx->challenge;
1442   LOG (GNUNET_ERROR_TYPE_DEBUG, "  send nonce c %u\n", kx_msg.nonce);
1443   t_encrypt (t, &kx_msg.nonce, &kx_msg.nonce,
1444              ping_encryption_size(), kx_msg.iv, GNUNET_YES);
1445   LOG (GNUNET_ERROR_TYPE_DEBUG, "  send nonce e %u\n", kx_msg.nonce);
1446   t->ephm_h = send_kx (t, &kx_msg.header);
1447 }
1448
1449
1450 /**
1451  * Send a pong message on a tunnel.
1452  *d_
1453  * @param t Tunnel on which to send the pong.
1454  * @param challenge Value sent in the ping that we have to send back.
1455  */
1456 static void
1457 send_pong (struct CadetTunnel *t, uint32_t challenge)
1458 {
1459   struct GNUNET_CADET_KX_Pong msg;
1460
1461   LOG (GNUNET_ERROR_TYPE_INFO, "===> PONG for %s\n", GCT_2s (t));
1462   if (NULL != t->pong_h)
1463   {
1464     LOG (GNUNET_ERROR_TYPE_INFO, "     already queued\n");
1465     return;
1466   }
1467   msg.header.size = htons (sizeof (msg));
1468   msg.header.type = htons (GNUNET_MESSAGE_TYPE_CADET_KX_PONG);
1469   msg.iv = GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_NONCE, UINT32_MAX);
1470   msg.nonce = challenge;
1471   LOG (GNUNET_ERROR_TYPE_DEBUG, "  sending %u\n", msg.nonce);
1472   t_encrypt (t, &msg.nonce, &msg.nonce,
1473              sizeof (msg.nonce), msg.iv, GNUNET_YES);
1474   LOG (GNUNET_ERROR_TYPE_DEBUG, "  e sending %u\n", msg.nonce);
1475
1476   t->pong_h = send_kx (t, &msg.header);
1477 }
1478
1479
1480 /**
1481  * Initiate a rekey with the remote peer.
1482  *
1483  * @param cls Closure (tunnel).
1484  * @param tc TaskContext.
1485  */
1486 static void
1487 rekey_tunnel (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
1488 {
1489   struct CadetTunnel *t = cls;
1490
1491   t->rekey_task = GNUNET_SCHEDULER_NO_TASK;
1492
1493   LOG (GNUNET_ERROR_TYPE_INFO, "Re-key Tunnel %s\n", GCT_2s (t));
1494   if (NULL != tc && 0 != (GNUNET_SCHEDULER_REASON_SHUTDOWN & tc->reason))
1495     return;
1496
1497   GNUNET_assert (NULL != t->kx_ctx);
1498   struct GNUNET_TIME_Relative duration;
1499
1500   duration = GNUNET_TIME_absolute_get_duration (t->kx_ctx->rekey_start_time);
1501   LOG (GNUNET_ERROR_TYPE_DEBUG, " kx started %s ago\n",
1502         GNUNET_STRINGS_relative_time_to_string (duration, GNUNET_YES));
1503
1504   // FIXME make duration of old keys configurable
1505   if (duration.rel_value_us >= GNUNET_TIME_UNIT_MINUTES.rel_value_us)
1506   {
1507     LOG (GNUNET_ERROR_TYPE_DEBUG, " deleting old keys\n");
1508     memset (&t->kx_ctx->d_key_old, 0, sizeof (t->kx_ctx->d_key_old));
1509     memset (&t->kx_ctx->e_key_old, 0, sizeof (t->kx_ctx->e_key_old));
1510   }
1511
1512   send_ephemeral (t);
1513
1514   switch (t->estate)
1515   {
1516     case CADET_TUNNEL_KEY_UNINITIALIZED:
1517       GCT_change_estate (t, CADET_TUNNEL_KEY_SENT);
1518       break;
1519
1520     case CADET_TUNNEL_KEY_SENT:
1521       break;
1522
1523     case CADET_TUNNEL_KEY_OK:
1524       /* Inconsistent!
1525        * - state should have changed during rekey_iterator
1526        * - task should have been canceled at pong_handle
1527        */
1528       GNUNET_break (0);
1529       GCT_change_estate (t, CADET_TUNNEL_KEY_REKEY);
1530       break;
1531
1532     case CADET_TUNNEL_KEY_PING:
1533     case CADET_TUNNEL_KEY_REKEY:
1534       break;
1535
1536     default:
1537       LOG (GNUNET_ERROR_TYPE_DEBUG, "Unexpected state %u\n", t->estate);
1538   }
1539
1540   // FIXME exponential backoff
1541   struct GNUNET_TIME_Relative delay;
1542
1543   delay = GNUNET_TIME_relative_divide (rekey_period, 16);
1544   delay = GNUNET_TIME_relative_min (delay, REKEY_WAIT);
1545   LOG (GNUNET_ERROR_TYPE_DEBUG, "  next call in %s\n",
1546        GNUNET_STRINGS_relative_time_to_string (delay, GNUNET_YES));
1547   t->rekey_task = GNUNET_SCHEDULER_add_delayed (delay, &rekey_tunnel, t);
1548 }
1549
1550
1551 /**
1552  * Our ephemeral key has changed, create new session key on all tunnels.
1553  *
1554  * Each tunnel will start the Key Exchange with a random delay between
1555  * 0 and number_of_tunnels*100 milliseconds, so there are 10 key exchanges
1556  * per second, on average.
1557  *
1558  * @param cls Closure (size of the hashmap).
1559  * @param key Current public key.
1560  * @param value Value in the hash map (tunnel).
1561  *
1562  * @return #GNUNET_YES, so we should continue to iterate,
1563  */
1564 static int
1565 rekey_iterator (void *cls,
1566                 const struct GNUNET_PeerIdentity *key,
1567                 void *value)
1568 {
1569   struct CadetTunnel *t = value;
1570   struct GNUNET_TIME_Relative delay;
1571   long n = (long) cls;
1572   uint32_t r;
1573
1574   if (GNUNET_SCHEDULER_NO_TASK != t->rekey_task)
1575     return GNUNET_YES;
1576
1577   if (GNUNET_YES == GCT_is_loopback (t))
1578     return GNUNET_YES;
1579
1580   r = GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_WEAK, (uint32_t) n * 100);
1581   delay = GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MILLISECONDS, r);
1582   t->rekey_task = GNUNET_SCHEDULER_add_delayed (delay, &rekey_tunnel, t);
1583   create_kx_ctx (t);
1584   GCT_change_estate (t, CADET_TUNNEL_KEY_REKEY);
1585
1586   return GNUNET_YES;
1587 }
1588
1589
1590 /**
1591  * Create a new ephemeral key and key message, schedule next rekeying.
1592  *
1593  * @param cls Closure (unused).
1594  * @param tc TaskContext.
1595  */
1596 static void
1597 rekey (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
1598 {
1599   struct GNUNET_TIME_Absolute time;
1600   long n;
1601
1602   rekey_task = GNUNET_SCHEDULER_NO_TASK;
1603
1604   if (0 != (GNUNET_SCHEDULER_REASON_SHUTDOWN & tc->reason))
1605     return;
1606
1607   GNUNET_free_non_null (my_ephemeral_key);
1608   my_ephemeral_key = GNUNET_CRYPTO_ecdhe_key_create ();
1609
1610   time = GNUNET_TIME_absolute_get ();
1611   kx_msg.creation_time = GNUNET_TIME_absolute_hton (time);
1612   time = GNUNET_TIME_absolute_add (time, rekey_period);
1613   time = GNUNET_TIME_absolute_add (time, GNUNET_TIME_UNIT_MINUTES);
1614   kx_msg.expiration_time = GNUNET_TIME_absolute_hton (time);
1615   GNUNET_CRYPTO_ecdhe_key_get_public (my_ephemeral_key, &kx_msg.ephemeral_key);
1616   LOG (GNUNET_ERROR_TYPE_INFO, "GLOBAL RE-KEY, NEW EPHM: %s\n",
1617        GNUNET_h2s ((struct GNUNET_HashCode *) &kx_msg.ephemeral_key));
1618
1619   GNUNET_assert (GNUNET_OK ==
1620                  GNUNET_CRYPTO_eddsa_sign (my_private_key,
1621                                            &kx_msg.purpose,
1622                                            &kx_msg.signature));
1623
1624   n = (long) GNUNET_CONTAINER_multipeermap_size (tunnels);
1625   GNUNET_CONTAINER_multipeermap_iterate (tunnels, &rekey_iterator, (void *) n);
1626
1627   rekey_task = GNUNET_SCHEDULER_add_delayed (rekey_period, &rekey, NULL);
1628 }
1629
1630
1631 /**
1632  * Called only on shutdown, destroy every tunnel.
1633  *
1634  * @param cls Closure (unused).
1635  * @param key Current public key.
1636  * @param value Value in the hash map (tunnel).
1637  *
1638  * @return #GNUNET_YES, so we should continue to iterate,
1639  */
1640 static int
1641 destroy_iterator (void *cls,
1642                 const struct GNUNET_PeerIdentity *key,
1643                 void *value)
1644 {
1645   struct CadetTunnel *t = value;
1646
1647   LOG (GNUNET_ERROR_TYPE_DEBUG, "GCT_shutdown destroying tunnel at %p\n", t);
1648   GCT_destroy (t);
1649   return GNUNET_YES;
1650 }
1651
1652
1653 /**
1654  * Notify remote peer that we don't know a channel he is talking about,
1655  * probably CHANNEL_DESTROY was missed.
1656  *
1657  * @param t Tunnel on which to notify.
1658  * @param gid ID of the channel.
1659  */
1660 static void
1661 send_channel_destroy (struct CadetTunnel *t, unsigned int gid)
1662 {
1663   struct GNUNET_CADET_ChannelManage msg;
1664
1665   msg.header.type = htons (GNUNET_MESSAGE_TYPE_CADET_CHANNEL_DESTROY);
1666   msg.header.size = htons (sizeof (msg));
1667   msg.chid = htonl (gid);
1668
1669   LOG (GNUNET_ERROR_TYPE_DEBUG,
1670        "WARNING destroying unknown channel %u on tunnel %s\n",
1671        gid, GCT_2s (t));
1672   send_prebuilt_message (&msg.header, t, NULL, GNUNET_YES, NULL, NULL, NULL);
1673 }
1674
1675
1676 /**
1677  * Demultiplex data per channel and call appropriate channel handler.
1678  *
1679  * @param t Tunnel on which the data came.
1680  * @param msg Data message.
1681  * @param fwd Is this message fwd? This only is meaningful in loopback channels.
1682  *            #GNUNET_YES if message is FWD on the respective channel (loopback)
1683  *            #GNUNET_NO if message is BCK on the respective channel (loopback)
1684  *            #GNUNET_SYSERR if message on a one-ended channel (remote)
1685  */
1686 static void
1687 handle_data (struct CadetTunnel *t,
1688              const struct GNUNET_CADET_Data *msg,
1689              int fwd)
1690 {
1691   struct CadetChannel *ch;
1692   size_t size;
1693
1694   /* Check size */
1695   size = ntohs (msg->header.size);
1696   if (size <
1697       sizeof (struct GNUNET_CADET_Data) +
1698       sizeof (struct GNUNET_MessageHeader))
1699   {
1700     GNUNET_break (0);
1701     return;
1702   }
1703   LOG (GNUNET_ERROR_TYPE_DEBUG, " payload of type %s\n",
1704               GC_m2s (ntohs (msg[1].header.type)));
1705
1706   /* Check channel */
1707   ch = GCT_get_channel (t, ntohl (msg->chid));
1708   if (NULL == ch)
1709   {
1710     GNUNET_STATISTICS_update (stats, "# data on unknown channel",
1711                               1, GNUNET_NO);
1712     LOG (GNUNET_ERROR_TYPE_DEBUG, "WARNING channel 0x%X unknown\n",
1713          ntohl (msg->chid));
1714     send_channel_destroy (t, ntohl (msg->chid));
1715     return;
1716   }
1717
1718   GCCH_handle_data (ch, msg, fwd);
1719 }
1720
1721
1722 /**
1723  * Demultiplex data ACKs per channel and update appropriate channel buffer info.
1724  *
1725  * @param t Tunnel on which the DATA ACK came.
1726  * @param msg DATA ACK message.
1727  * @param fwd Is this message fwd? This only is meaningful in loopback channels.
1728  *            #GNUNET_YES if message is FWD on the respective channel (loopback)
1729  *            #GNUNET_NO if message is BCK on the respective channel (loopback)
1730  *            #GNUNET_SYSERR if message on a one-ended channel (remote)
1731  */
1732 static void
1733 handle_data_ack (struct CadetTunnel *t,
1734                  const struct GNUNET_CADET_DataACK *msg,
1735                  int fwd)
1736 {
1737   struct CadetChannel *ch;
1738   size_t size;
1739
1740   /* Check size */
1741   size = ntohs (msg->header.size);
1742   if (size != sizeof (struct GNUNET_CADET_DataACK))
1743   {
1744     GNUNET_break (0);
1745     return;
1746   }
1747
1748   /* Check channel */
1749   ch = GCT_get_channel (t, ntohl (msg->chid));
1750   if (NULL == ch)
1751   {
1752     GNUNET_STATISTICS_update (stats, "# data ack on unknown channel",
1753                               1, GNUNET_NO);
1754     LOG (GNUNET_ERROR_TYPE_DEBUG, "WARNING channel %u unknown\n",
1755          ntohl (msg->chid));
1756     return;
1757   }
1758
1759   GCCH_handle_data_ack (ch, msg, fwd);
1760 }
1761
1762
1763 /**
1764  * Handle channel create.
1765  *
1766  * @param t Tunnel on which the data came.
1767  * @param msg Data message.
1768  */
1769 static void
1770 handle_ch_create (struct CadetTunnel *t,
1771                   const struct GNUNET_CADET_ChannelCreate *msg)
1772 {
1773   struct CadetChannel *ch;
1774   size_t size;
1775
1776   /* Check size */
1777   size = ntohs (msg->header.size);
1778   if (size != sizeof (struct GNUNET_CADET_ChannelCreate))
1779   {
1780     GNUNET_break (0);
1781     return;
1782   }
1783
1784   /* Check channel */
1785   ch = GCT_get_channel (t, ntohl (msg->chid));
1786   if (NULL != ch && ! GCT_is_loopback (t))
1787   {
1788     /* Probably a retransmission, safe to ignore */
1789     LOG (GNUNET_ERROR_TYPE_DEBUG, "   already exists...\n");
1790   }
1791   ch = GCCH_handle_create (t, msg);
1792   if (NULL != ch)
1793     GCT_add_channel (t, ch);
1794 }
1795
1796
1797
1798 /**
1799  * Handle channel NACK: check correctness and call channel handler for NACKs.
1800  *
1801  * @param t Tunnel on which the NACK came.
1802  * @param msg NACK message.
1803  */
1804 static void
1805 handle_ch_nack (struct CadetTunnel *t,
1806                 const struct GNUNET_CADET_ChannelManage *msg)
1807 {
1808   struct CadetChannel *ch;
1809   size_t size;
1810
1811   /* Check size */
1812   size = ntohs (msg->header.size);
1813   if (size != sizeof (struct GNUNET_CADET_ChannelManage))
1814   {
1815     GNUNET_break (0);
1816     return;
1817   }
1818
1819   /* Check channel */
1820   ch = GCT_get_channel (t, ntohl (msg->chid));
1821   if (NULL == ch)
1822   {
1823     GNUNET_STATISTICS_update (stats, "# channel NACK on unknown channel",
1824                               1, GNUNET_NO);
1825     LOG (GNUNET_ERROR_TYPE_DEBUG, "WARNING channel %u unknown\n",
1826          ntohl (msg->chid));
1827     return;
1828   }
1829
1830   GCCH_handle_nack (ch);
1831 }
1832
1833
1834 /**
1835  * Handle a CHANNEL ACK (SYNACK/ACK).
1836  *
1837  * @param t Tunnel on which the CHANNEL ACK came.
1838  * @param msg CHANNEL ACK message.
1839  * @param fwd Is this message fwd? This only is meaningful in loopback channels.
1840  *            #GNUNET_YES if message is FWD on the respective channel (loopback)
1841  *            #GNUNET_NO if message is BCK on the respective channel (loopback)
1842  *            #GNUNET_SYSERR if message on a one-ended channel (remote)
1843  */
1844 static void
1845 handle_ch_ack (struct CadetTunnel *t,
1846                const struct GNUNET_CADET_ChannelManage *msg,
1847                int fwd)
1848 {
1849   struct CadetChannel *ch;
1850   size_t size;
1851
1852   /* Check size */
1853   size = ntohs (msg->header.size);
1854   if (size != sizeof (struct GNUNET_CADET_ChannelManage))
1855   {
1856     GNUNET_break (0);
1857     return;
1858   }
1859
1860   /* Check channel */
1861   ch = GCT_get_channel (t, ntohl (msg->chid));
1862   if (NULL == ch)
1863   {
1864     GNUNET_STATISTICS_update (stats, "# channel ack on unknown channel",
1865                               1, GNUNET_NO);
1866     LOG (GNUNET_ERROR_TYPE_DEBUG, "WARNING channel %u unknown\n",
1867          ntohl (msg->chid));
1868     return;
1869   }
1870
1871   GCCH_handle_ack (ch, msg, fwd);
1872 }
1873
1874
1875 /**
1876  * Handle a channel destruction message.
1877  *
1878  * @param t Tunnel on which the message came.
1879  * @param msg Channel destroy message.
1880  * @param fwd Is this message fwd? This only is meaningful in loopback channels.
1881  *            #GNUNET_YES if message is FWD on the respective channel (loopback)
1882  *            #GNUNET_NO if message is BCK on the respective channel (loopback)
1883  *            #GNUNET_SYSERR if message on a one-ended channel (remote)
1884  */
1885 static void
1886 handle_ch_destroy (struct CadetTunnel *t,
1887                    const struct GNUNET_CADET_ChannelManage *msg,
1888                    int fwd)
1889 {
1890   struct CadetChannel *ch;
1891   size_t size;
1892
1893   /* Check size */
1894   size = ntohs (msg->header.size);
1895   if (size != sizeof (struct GNUNET_CADET_ChannelManage))
1896   {
1897     GNUNET_break (0);
1898     return;
1899   }
1900
1901   /* Check channel */
1902   ch = GCT_get_channel (t, ntohl (msg->chid));
1903   if (NULL == ch)
1904   {
1905     /* Probably a retransmission, safe to ignore */
1906     return;
1907   }
1908
1909   GCCH_handle_destroy (ch, msg, fwd);
1910 }
1911
1912
1913 /**
1914  * The peer's ephemeral key has changed: update the symmetrical keys.
1915  *
1916  * @param t Tunnel this message came on.
1917  * @param msg Key eXchange message.
1918  */
1919 static void
1920 handle_ephemeral (struct CadetTunnel *t,
1921                   const struct GNUNET_CADET_KX_Ephemeral *msg)
1922 {
1923   LOG (GNUNET_ERROR_TYPE_INFO, "<=== EPHM for %s\n", GCT_2s (t));
1924
1925   if (GNUNET_OK != check_ephemeral (t, msg))
1926   {
1927     GNUNET_break_op (0);
1928     return;
1929   }
1930
1931   /**
1932    * If the key is different from what we know, derive the new E/D keys.
1933    * Else destroy the rekey ctx (duplicate EPHM after successful KX).
1934    */
1935   if (0 != memcmp (&t->peers_ephemeral_key, &msg->ephemeral_key,
1936                    sizeof (msg->ephemeral_key)))
1937   {
1938     #if DUMP_KEYS_TO_STDERR
1939     LOG (GNUNET_ERROR_TYPE_INFO, "OLD: %s\n",
1940          GNUNET_h2s ((struct GNUNET_HashCode *) &t->peers_ephemeral_key));
1941     LOG (GNUNET_ERROR_TYPE_INFO, "NEW: %s\n",
1942          GNUNET_h2s ((struct GNUNET_HashCode *) &msg->ephemeral_key));
1943     #endif
1944     t->peers_ephemeral_key = msg->ephemeral_key;
1945
1946     create_kx_ctx (t);
1947
1948     if (CADET_TUNNEL_KEY_OK == t->estate)
1949     {
1950       GCT_change_estate (t, CADET_TUNNEL_KEY_REKEY);
1951     }
1952     if (GNUNET_SCHEDULER_NO_TASK != t->rekey_task)
1953       GNUNET_SCHEDULER_cancel (t->rekey_task);
1954     t->rekey_task = GNUNET_SCHEDULER_add_now (rekey_tunnel, t);
1955   }
1956   if (CADET_TUNNEL_KEY_SENT == t->estate)
1957   {
1958     LOG (GNUNET_ERROR_TYPE_DEBUG, "  our key was sent, sending challenge\n");
1959     send_ephemeral (t);
1960     GCT_change_estate (t, CADET_TUNNEL_KEY_PING);
1961   }
1962
1963   if (CADET_TUNNEL_KEY_UNINITIALIZED != ntohl(msg->sender_status))
1964   {
1965     uint32_t nonce;
1966
1967     LOG (GNUNET_ERROR_TYPE_DEBUG, "  recv nonce e %u\n", msg->nonce);
1968     t_decrypt (t, &nonce, &msg->nonce, ping_encryption_size (), msg->iv);
1969     LOG (GNUNET_ERROR_TYPE_DEBUG, "  recv nonce c %u\n", nonce);
1970     send_pong (t, nonce);
1971   }
1972 }
1973
1974
1975 /**
1976  * Peer has answer to our challenge.
1977  * If answer is successful, consider the key exchange finished and clean
1978  * up all related state.
1979  *
1980  * @param t Tunnel this message came on.
1981  * @param msg Key eXchange Pong message.
1982  */
1983 static void
1984 handle_pong (struct CadetTunnel *t,
1985              const struct GNUNET_CADET_KX_Pong *msg)
1986 {
1987   uint32_t challenge;
1988
1989   LOG (GNUNET_ERROR_TYPE_INFO, "<=== PONG for %s\n", GCT_2s (t));
1990   if (GNUNET_SCHEDULER_NO_TASK == t->rekey_task)
1991   {
1992     GNUNET_STATISTICS_update (stats, "# duplicate PONG messages", 1, GNUNET_NO);
1993     return;
1994   }
1995   if (NULL == t->kx_ctx)
1996   {
1997     GNUNET_STATISTICS_update (stats, "# stray PONG messages", 1, GNUNET_NO);
1998     return;
1999   }
2000
2001   t_decrypt (t, &challenge, &msg->nonce, sizeof (uint32_t), msg->iv);
2002   if (challenge != t->kx_ctx->challenge)
2003   {
2004     LOG (GNUNET_ERROR_TYPE_WARNING, "Wrong PONG challenge on %s\n", GCT_2s (t));
2005     LOG (GNUNET_ERROR_TYPE_DEBUG, "PONG: %u (e: %u). Expected: %u.\n",
2006          challenge, msg->nonce, t->kx_ctx->challenge);
2007     send_ephemeral (t);
2008     return;
2009   }
2010   GNUNET_SCHEDULER_cancel (t->rekey_task);
2011   t->rekey_task = GNUNET_SCHEDULER_NO_TASK;
2012
2013   /* Don't free the old keys right away, but after a delay.
2014    * Rationale: the KX could have happened over a very fast connection,
2015    * with payload traffic still signed with the old key stuck in a slower
2016    * connection.
2017    * Don't keep the keys longer than 1/4 the rekey period, and no longer than
2018    * one minute.
2019    */
2020   destroy_kx_ctx (t);
2021   GCT_change_estate (t, CADET_TUNNEL_KEY_OK);
2022 }
2023
2024
2025 /**
2026  * Demultiplex by message type and call appropriate handler for a message
2027  * towards a channel of a local tunnel.
2028  *
2029  * @param t Tunnel this message came on.
2030  * @param msgh Message header.
2031  * @param fwd Is this message fwd? This only is meaningful in loopback channels.
2032  *            #GNUNET_YES if message is FWD on the respective channel (loopback)
2033  *            #GNUNET_NO if message is BCK on the respective channel (loopback)
2034  *            #GNUNET_SYSERR if message on a one-ended channel (remote)
2035  */
2036 static void
2037 handle_decrypted (struct CadetTunnel *t,
2038                   const struct GNUNET_MessageHeader *msgh,
2039                   int fwd)
2040 {
2041   uint16_t type;
2042
2043   type = ntohs (msgh->type);
2044   LOG (GNUNET_ERROR_TYPE_INFO, "<=== %s on %s\n", GC_m2s (type), GCT_2s (t));
2045
2046   switch (type)
2047   {
2048     case GNUNET_MESSAGE_TYPE_CADET_KEEPALIVE:
2049       /* Do nothing, connection aleady got updated. */
2050       GNUNET_STATISTICS_update (stats, "# keepalives received", 1, GNUNET_NO);
2051       break;
2052
2053     case GNUNET_MESSAGE_TYPE_CADET_DATA:
2054       /* Don't send hop ACK, wait for client to ACK */
2055       handle_data (t, (struct GNUNET_CADET_Data *) msgh, fwd);
2056       break;
2057
2058     case GNUNET_MESSAGE_TYPE_CADET_DATA_ACK:
2059       handle_data_ack (t, (struct GNUNET_CADET_DataACK *) msgh, fwd);
2060       break;
2061
2062     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_CREATE:
2063       handle_ch_create (t,
2064                         (struct GNUNET_CADET_ChannelCreate *) msgh);
2065       break;
2066
2067     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_NACK:
2068       handle_ch_nack (t,
2069                       (struct GNUNET_CADET_ChannelManage *) msgh);
2070       break;
2071
2072     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_ACK:
2073       handle_ch_ack (t,
2074                      (struct GNUNET_CADET_ChannelManage *) msgh,
2075                      fwd);
2076       break;
2077
2078     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_DESTROY:
2079       handle_ch_destroy (t,
2080                          (struct GNUNET_CADET_ChannelManage *) msgh,
2081                          fwd);
2082       break;
2083
2084     default:
2085       GNUNET_break_op (0);
2086       LOG (GNUNET_ERROR_TYPE_WARNING,
2087            "end-to-end message not known (%u)\n",
2088            ntohs (msgh->type));
2089       GCT_debug (t, GNUNET_ERROR_TYPE_WARNING);
2090   }
2091 }
2092
2093 /******************************************************************************/
2094 /********************************    API    ***********************************/
2095 /******************************************************************************/
2096
2097 /**
2098  * Decrypt and demultiplex by message type. Call appropriate handler
2099  * for every message.
2100  *
2101  * @param t Tunnel this message came on.
2102  * @param msg Encrypted message.
2103  */
2104 void
2105 GCT_handle_encrypted (struct CadetTunnel *t,
2106                       const struct GNUNET_CADET_Encrypted *msg)
2107 {
2108   size_t size = ntohs (msg->header.size);
2109   size_t payload_size = size - sizeof (struct GNUNET_CADET_Encrypted);
2110   int decrypted_size;
2111   char cbuf [payload_size];
2112   struct GNUNET_MessageHeader *msgh;
2113   unsigned int off;
2114
2115   decrypted_size = t_decrypt_and_validate (t, cbuf, &msg[1], payload_size,
2116                                            msg->iv, &msg->hmac);
2117
2118   if (-1 == decrypted_size)
2119   {
2120     GNUNET_break_op (0);
2121     return;
2122   }
2123
2124   off = 0;
2125   while (off < decrypted_size)
2126   {
2127     uint16_t msize;
2128
2129     msgh = (struct GNUNET_MessageHeader *) &cbuf[off];
2130     msize = ntohs (msgh->size);
2131     if (msize < sizeof (struct GNUNET_MessageHeader))
2132     {
2133       GNUNET_break_op (0);
2134       return;
2135     }
2136     handle_decrypted (t, msgh, GNUNET_SYSERR);
2137     off += msize;
2138   }
2139 }
2140
2141
2142 /**
2143  * Demultiplex an encapsulated KX message by message type.
2144  *
2145  * @param t Tunnel on which the message came.
2146  * @param message Payload of KX message.
2147  */
2148 void
2149 GCT_handle_kx (struct CadetTunnel *t,
2150                const struct GNUNET_MessageHeader *message)
2151 {
2152   uint16_t type;
2153
2154   type = ntohs (message->type);
2155   LOG (GNUNET_ERROR_TYPE_DEBUG, "kx message received\n", type);
2156   switch (type)
2157   {
2158     case GNUNET_MESSAGE_TYPE_CADET_KX_EPHEMERAL:
2159       handle_ephemeral (t, (struct GNUNET_CADET_KX_Ephemeral *) message);
2160       break;
2161
2162     case GNUNET_MESSAGE_TYPE_CADET_KX_PONG:
2163       handle_pong (t, (struct GNUNET_CADET_KX_Pong *) message);
2164       break;
2165
2166     default:
2167       GNUNET_break_op (0);
2168       LOG (GNUNET_ERROR_TYPE_DEBUG, "kx message not known (%u)\n", type);
2169   }
2170 }
2171
2172
2173 /**
2174  * Initialize the tunnel subsystem.
2175  *
2176  * @param c Configuration handle.
2177  * @param key ECC private key, to derive all other keys and do crypto.
2178  */
2179 void
2180 GCT_init (const struct GNUNET_CONFIGURATION_Handle *c,
2181           const struct GNUNET_CRYPTO_EddsaPrivateKey *key)
2182 {
2183   int expected_overhead;
2184
2185   LOG (GNUNET_ERROR_TYPE_DEBUG, "init\n");
2186
2187   expected_overhead =
2188     sizeof (struct GNUNET_CADET_Encrypted) + sizeof (struct GNUNET_CADET_Data);
2189   GNUNET_assert (GNUNET_CONSTANTS_CADET_P2P_OVERHEAD == expected_overhead);
2190
2191   if (GNUNET_OK !=
2192       GNUNET_CONFIGURATION_get_value_number (c, "CADET", "DEFAULT_TTL",
2193                                              &default_ttl))
2194   {
2195     GNUNET_log_config_invalid (GNUNET_ERROR_TYPE_WARNING,
2196                                "CADET", "DEFAULT_TTL", "USING DEFAULT");
2197     default_ttl = 64;
2198   }
2199   if (GNUNET_OK !=
2200       GNUNET_CONFIGURATION_get_value_time (c, "CADET", "REKEY_PERIOD",
2201                                            &rekey_period))
2202   {
2203     rekey_period = GNUNET_TIME_UNIT_DAYS;
2204   }
2205
2206   my_private_key = key;
2207   kx_msg.header.size = htons (sizeof (kx_msg));
2208   kx_msg.header.type = htons (GNUNET_MESSAGE_TYPE_CADET_KX_EPHEMERAL);
2209   kx_msg.purpose.purpose = htonl (GNUNET_SIGNATURE_PURPOSE_CADET_KX);
2210   kx_msg.purpose.size = htonl (ephemeral_purpose_size ());
2211   kx_msg.origin_identity = my_full_id;
2212   rekey_task = GNUNET_SCHEDULER_add_now (&rekey, NULL);
2213
2214   tunnels = GNUNET_CONTAINER_multipeermap_create (128, GNUNET_YES);
2215 }
2216
2217
2218 /**
2219  * Shut down the tunnel subsystem.
2220  */
2221 void
2222 GCT_shutdown (void)
2223 {
2224   if (GNUNET_SCHEDULER_NO_TASK != rekey_task)
2225   {
2226     GNUNET_SCHEDULER_cancel (rekey_task);
2227     rekey_task = GNUNET_SCHEDULER_NO_TASK;
2228   }
2229   GNUNET_CONTAINER_multipeermap_iterate (tunnels, &destroy_iterator, NULL);
2230   GNUNET_CONTAINER_multipeermap_destroy (tunnels);
2231 }
2232
2233
2234 /**
2235  * Create a tunnel.
2236  *
2237  * @param destination Peer this tunnel is towards.
2238  */
2239 struct CadetTunnel *
2240 GCT_new (struct CadetPeer *destination)
2241 {
2242   struct CadetTunnel *t;
2243
2244   t = GNUNET_new (struct CadetTunnel);
2245   t->next_chid = 0;
2246   t->peer = destination;
2247
2248   if (GNUNET_OK !=
2249       GNUNET_CONTAINER_multipeermap_put (tunnels, GCP_get_id (destination), t,
2250                                          GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST))
2251   {
2252     GNUNET_break (0);
2253     GNUNET_free (t);
2254     return NULL;
2255   }
2256   return t;
2257 }
2258
2259
2260 /**
2261  * Change the tunnel's connection state.
2262  *
2263  * @param t Tunnel whose connection state to change.
2264  * @param cstate New connection state.
2265  */
2266 void
2267 GCT_change_cstate (struct CadetTunnel* t, enum CadetTunnelCState cstate)
2268 {
2269   if (NULL == t)
2270     return;
2271   LOG (GNUNET_ERROR_TYPE_DEBUG, "Tunnel %s cstate %s => %s\n",
2272        GCP_2s (t->peer), cstate2s (t->cstate), cstate2s (cstate));
2273   if (myid != GCP_get_short_id (t->peer) &&
2274       CADET_TUNNEL_READY != t->cstate &&
2275       CADET_TUNNEL_READY == cstate)
2276   {
2277     t->cstate = cstate;
2278     if (CADET_TUNNEL_KEY_OK == t->estate)
2279     {
2280       LOG (GNUNET_ERROR_TYPE_DEBUG, "  cstate triggered send queued data\n");
2281       send_queued_data (t);
2282     }
2283     else if (CADET_TUNNEL_KEY_UNINITIALIZED == t->estate)
2284     {
2285       LOG (GNUNET_ERROR_TYPE_DEBUG, "  cstate triggered rekey\n");
2286       if (GNUNET_SCHEDULER_NO_TASK != t->rekey_task)
2287         GNUNET_SCHEDULER_cancel (t->rekey_task);
2288       create_kx_ctx (t);
2289       rekey_tunnel (t, NULL);
2290     }
2291   }
2292   t->cstate = cstate;
2293
2294   if (CADET_TUNNEL_READY == cstate
2295       && CONNECTIONS_PER_TUNNEL <= GCT_count_connections (t))
2296   {
2297     LOG (GNUNET_ERROR_TYPE_DEBUG, "  cstate triggered stop dht\n");
2298     GCP_stop_search (t->peer);
2299   }
2300 }
2301
2302
2303 /**
2304  * Change the tunnel encryption state.
2305  *
2306  * @param t Tunnel whose encryption state to change, or NULL.
2307  * @param state New encryption state.
2308  */
2309 void
2310 GCT_change_estate (struct CadetTunnel* t, enum CadetTunnelEState state)
2311 {
2312   enum CadetTunnelEState old;
2313
2314   if (NULL == t)
2315     return;
2316
2317   old = t->estate;
2318   t->estate = state;
2319   LOG (GNUNET_ERROR_TYPE_DEBUG, "Tunnel %s estate was %s\n",
2320        GCP_2s (t->peer), estate2s (old));
2321   LOG (GNUNET_ERROR_TYPE_DEBUG, "Tunnel %s estate is now %s\n",
2322        GCP_2s (t->peer), estate2s (t->estate));
2323
2324   /* Send queued data if enc state changes to OK */
2325   if (myid != GCP_get_short_id (t->peer) &&
2326       CADET_TUNNEL_KEY_OK != old && CADET_TUNNEL_KEY_OK == t->estate)
2327   {
2328     send_queued_data (t);
2329   }
2330 }
2331
2332
2333 /**
2334  * @brief Check if tunnel has too many connections, and remove one if necessary.
2335  *
2336  * Currently this means the newest connection, unless it is a direct one.
2337  * Implemented as a task to avoid freeing a connection that is in the middle
2338  * of being created/processed.
2339  *
2340  * @param cls Closure (Tunnel to check).
2341  * @param tc Task context.
2342  */
2343 static void
2344 trim_connections (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
2345 {
2346   struct CadetTunnel *t = cls;
2347
2348   t->trim_connections_task = GNUNET_SCHEDULER_NO_TASK;
2349
2350   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
2351     return;
2352
2353   if (GCT_count_connections (t) > 2 * CONNECTIONS_PER_TUNNEL)
2354   {
2355     struct CadetTConnection *iter;
2356     struct CadetTConnection *c;
2357
2358     for (c = iter = t->connection_head; NULL != iter; iter = iter->next)
2359     {
2360       if ((iter->created.abs_value_us > c->created.abs_value_us)
2361           && GNUNET_NO == GCC_is_direct (iter->c))
2362       {
2363         c = iter;
2364       }
2365     }
2366     if (NULL != c)
2367     {
2368       LOG (GNUNET_ERROR_TYPE_DEBUG, "Too many connections on tunnel %s\n",
2369            GCT_2s (t));
2370       LOG (GNUNET_ERROR_TYPE_DEBUG, "Destroying connection %s\n",
2371            GCC_2s (c->c));
2372       GCC_destroy (c->c);
2373     }
2374     else
2375     {
2376       GNUNET_break (0);
2377     }
2378   }
2379 }
2380
2381
2382 /**
2383  * Add a connection to a tunnel.
2384  *
2385  * @param t Tunnel.
2386  * @param c Connection.
2387  */
2388 void
2389 GCT_add_connection (struct CadetTunnel *t, struct CadetConnection *c)
2390 {
2391   struct CadetTConnection *aux;
2392
2393   GNUNET_assert (NULL != c);
2394
2395   LOG (GNUNET_ERROR_TYPE_DEBUG, "add connection %s\n", GCC_2s (c));
2396   LOG (GNUNET_ERROR_TYPE_DEBUG, " to tunnel %s\n", GCT_2s (t));
2397   for (aux = t->connection_head; aux != NULL; aux = aux->next)
2398     if (aux->c == c)
2399       return;
2400
2401   aux = GNUNET_new (struct CadetTConnection);
2402   aux->c = c;
2403   aux->created = GNUNET_TIME_absolute_get ();
2404
2405   GNUNET_CONTAINER_DLL_insert (t->connection_head, t->connection_tail, aux);
2406
2407   if (CADET_TUNNEL_SEARCHING == t->cstate)
2408     GCT_change_estate (t, CADET_TUNNEL_WAITING);
2409
2410   if (GNUNET_SCHEDULER_NO_TASK != t->trim_connections_task)
2411     t->trim_connections_task = GNUNET_SCHEDULER_add_now (&trim_connections, t);
2412 }
2413
2414
2415 /**
2416  * Remove a connection from a tunnel.
2417  *
2418  * @param t Tunnel.
2419  * @param c Connection.
2420  */
2421 void
2422 GCT_remove_connection (struct CadetTunnel *t,
2423                        struct CadetConnection *c)
2424 {
2425   struct CadetTConnection *aux;
2426   struct CadetTConnection *next;
2427   unsigned int conns;
2428
2429   LOG (GNUNET_ERROR_TYPE_DEBUG, "Removing connection %s from tunnel %s\n",
2430        GCC_2s (c), GCT_2s (t));
2431   for (aux = t->connection_head; aux != NULL; aux = next)
2432   {
2433     next = aux->next;
2434     if (aux->c == c)
2435     {
2436       GNUNET_CONTAINER_DLL_remove (t->connection_head, t->connection_tail, aux);
2437       GNUNET_free (aux);
2438     }
2439   }
2440
2441   conns = GCT_count_connections (t);
2442   if (0 == conns
2443       && GNUNET_SCHEDULER_NO_TASK == t->destroy_task
2444       && CADET_TUNNEL_SHUTDOWN != t->cstate
2445       && GNUNET_NO == shutting_down)
2446   {
2447     if (0 == GCT_count_any_connections (t))
2448       GCT_change_cstate (t, CADET_TUNNEL_SEARCHING);
2449     else
2450       GCT_change_cstate (t, CADET_TUNNEL_WAITING);
2451   }
2452
2453   /* Start new connections if needed */
2454   if (CONNECTIONS_PER_TUNNEL > conns
2455       && GNUNET_SCHEDULER_NO_TASK == t->destroy_task
2456       && CADET_TUNNEL_SHUTDOWN != t->cstate
2457       && GNUNET_NO == shutting_down)
2458   {
2459     LOG (GNUNET_ERROR_TYPE_DEBUG, "  too few connections, getting new ones\n");
2460     GCP_connect (t->peer); /* Will change cstate to WAITING when possible */
2461     return;
2462   }
2463
2464   /* If not marked as ready, no change is needed */
2465   if (CADET_TUNNEL_READY != t->cstate)
2466     return;
2467
2468   /* Check if any connection is ready to maintain cstate */
2469   for (aux = t->connection_head; aux != NULL; aux = aux->next)
2470     if (CADET_CONNECTION_READY == GCC_get_state (aux->c))
2471       return;
2472 }
2473
2474
2475 /**
2476  * Add a channel to a tunnel.
2477  *
2478  * @param t Tunnel.
2479  * @param ch Channel.
2480  */
2481 void
2482 GCT_add_channel (struct CadetTunnel *t, struct CadetChannel *ch)
2483 {
2484   struct CadetTChannel *aux;
2485
2486   GNUNET_assert (NULL != ch);
2487
2488   LOG (GNUNET_ERROR_TYPE_DEBUG, "Adding channel %p to tunnel %p\n", ch, t);
2489
2490   for (aux = t->channel_head; aux != NULL; aux = aux->next)
2491   {
2492     LOG (GNUNET_ERROR_TYPE_DEBUG, "  already there %p\n", aux->ch);
2493     if (aux->ch == ch)
2494       return;
2495   }
2496
2497   aux = GNUNET_new (struct CadetTChannel);
2498   aux->ch = ch;
2499   LOG (GNUNET_ERROR_TYPE_DEBUG, " adding %p to %p\n", aux, t->channel_head);
2500   GNUNET_CONTAINER_DLL_insert_tail (t->channel_head, t->channel_tail, aux);
2501
2502   if (GNUNET_SCHEDULER_NO_TASK != t->destroy_task)
2503   {
2504     GNUNET_SCHEDULER_cancel (t->destroy_task);
2505     t->destroy_task = GNUNET_SCHEDULER_NO_TASK;
2506     LOG (GNUNET_ERROR_TYPE_DEBUG, " undo destroy!\n");
2507   }
2508 }
2509
2510
2511 /**
2512  * Remove a channel from a tunnel.
2513  *
2514  * @param t Tunnel.
2515  * @param ch Channel.
2516  */
2517 void
2518 GCT_remove_channel (struct CadetTunnel *t, struct CadetChannel *ch)
2519 {
2520   struct CadetTChannel *aux;
2521
2522   LOG (GNUNET_ERROR_TYPE_DEBUG, "Removing channel %p from tunnel %p\n", ch, t);
2523   for (aux = t->channel_head; aux != NULL; aux = aux->next)
2524   {
2525     if (aux->ch == ch)
2526     {
2527       LOG (GNUNET_ERROR_TYPE_DEBUG, " found! %s\n", GCCH_2s (ch));
2528       GNUNET_CONTAINER_DLL_remove (t->channel_head, t->channel_tail, aux);
2529       GNUNET_free (aux);
2530       return;
2531     }
2532   }
2533 }
2534
2535
2536 /**
2537  * Search for a channel by global ID.
2538  *
2539  * @param t Tunnel containing the channel.
2540  * @param chid Public channel number.
2541  *
2542  * @return channel handler, NULL if doesn't exist
2543  */
2544 struct CadetChannel *
2545 GCT_get_channel (struct CadetTunnel *t, CADET_ChannelNumber chid)
2546 {
2547   struct CadetTChannel *iter;
2548
2549   if (NULL == t)
2550     return NULL;
2551
2552   for (iter = t->channel_head; NULL != iter; iter = iter->next)
2553   {
2554     if (GCCH_get_id (iter->ch) == chid)
2555       break;
2556   }
2557
2558   return NULL == iter ? NULL : iter->ch;
2559 }
2560
2561
2562 /**
2563  * @brief Destroy a tunnel and free all resources.
2564  *
2565  * Should only be called a while after the tunnel has been marked as destroyed,
2566  * in case there is a new channel added to the same peer shortly after marking
2567  * the tunnel. This way we avoid a new public key handshake.
2568  *
2569  * @param cls Closure (tunnel to destroy).
2570  * @param tc Task context.
2571  */
2572 static void
2573 delayed_destroy (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
2574 {
2575   struct CadetTunnel *t = cls;
2576   struct CadetTConnection *iter;
2577
2578   LOG (GNUNET_ERROR_TYPE_DEBUG, "delayed destroying tunnel %p\n", t);
2579   if (0 != (GNUNET_SCHEDULER_REASON_SHUTDOWN & tc->reason))
2580   {
2581     LOG (GNUNET_ERROR_TYPE_WARNING,
2582          "Not destroying tunnel, due to shutdown. "
2583          "Tunnel at %p should have been freed by GCT_shutdown\n", t);
2584     return;
2585   }
2586   t->destroy_task = GNUNET_SCHEDULER_NO_TASK;
2587   t->cstate = CADET_TUNNEL_SHUTDOWN;
2588
2589   for (iter = t->connection_head; NULL != iter; iter = iter->next)
2590   {
2591     GCC_send_destroy (iter->c);
2592   }
2593   GCT_destroy (t);
2594 }
2595
2596
2597 /**
2598  * Tunnel is empty: destroy it.
2599  *
2600  * Notifies all connections about the destruction.
2601  *
2602  * @param t Tunnel to destroy.
2603  */
2604 void
2605 GCT_destroy_empty (struct CadetTunnel *t)
2606 {
2607   if (GNUNET_YES == shutting_down)
2608     return; /* Will be destroyed immediately anyway */
2609
2610   if (GNUNET_SCHEDULER_NO_TASK != t->destroy_task)
2611   {
2612     LOG (GNUNET_ERROR_TYPE_WARNING,
2613          "Tunnel %s is already scheduled for destruction. Tunnel debug dump:\n",
2614          GCT_2s (t));
2615     GCT_debug (t, GNUNET_ERROR_TYPE_WARNING);
2616     GNUNET_break (0);
2617     /* should never happen, tunnel can only become empty once, and the
2618      * task identifier should be NO_TASK (cleaned when the tunnel was created
2619      * or became un-empty)
2620      */
2621     return;
2622   }
2623
2624   LOG (GNUNET_ERROR_TYPE_DEBUG, "Tunnel %s empty: destroying scheduled\n",
2625        GCT_2s (t));
2626
2627   // FIXME make delay a config option
2628   t->destroy_task = GNUNET_SCHEDULER_add_delayed (GNUNET_TIME_UNIT_MINUTES,
2629                                                   &delayed_destroy, t);
2630   LOG (GNUNET_ERROR_TYPE_DEBUG, "Scheduled destroy of %p as %llX\n",
2631        t, t->destroy_task);
2632 }
2633
2634
2635 /**
2636  * Destroy tunnel if empty (no more channels).
2637  *
2638  * @param t Tunnel to destroy if empty.
2639  */
2640 void
2641 GCT_destroy_if_empty (struct CadetTunnel *t)
2642 {
2643   LOG (GNUNET_ERROR_TYPE_DEBUG, "Tunnel %s destroy if empty\n", GCT_2s (t));
2644   if (1 < GCT_count_channels (t))
2645     return;
2646
2647   GCT_destroy_empty (t);
2648 }
2649
2650
2651 /**
2652  * Destroy the tunnel.
2653  *
2654  * This function does not generate any warning traffic to clients or peers.
2655  *
2656  * Tasks:
2657  * Cancel messages belonging to this tunnel queued to neighbors.
2658  * Free any allocated resources linked to the tunnel.
2659  *
2660  * @param t The tunnel to destroy.
2661  */
2662 void
2663 GCT_destroy (struct CadetTunnel *t)
2664 {
2665   struct CadetTConnection *iter_c;
2666   struct CadetTConnection *next_c;
2667   struct CadetTChannel *iter_ch;
2668   struct CadetTChannel *next_ch;
2669
2670   if (NULL == t)
2671     return;
2672
2673   LOG (GNUNET_ERROR_TYPE_DEBUG, "destroying tunnel %s\n", GCP_2s (t->peer));
2674
2675   GNUNET_break (GNUNET_YES ==
2676                 GNUNET_CONTAINER_multipeermap_remove (tunnels,
2677                                                       GCP_get_id (t->peer), t));
2678
2679   for (iter_c = t->connection_head; NULL != iter_c; iter_c = next_c)
2680   {
2681     next_c = iter_c->next;
2682     GCC_destroy (iter_c->c);
2683   }
2684   for (iter_ch = t->channel_head; NULL != iter_ch; iter_ch = next_ch)
2685   {
2686     next_ch = iter_ch->next;
2687     GCCH_destroy (iter_ch->ch);
2688     /* Should only happen on shutdown, but it's ok. */
2689   }
2690
2691   if (GNUNET_SCHEDULER_NO_TASK != t->destroy_task)
2692   {
2693     LOG (GNUNET_ERROR_TYPE_DEBUG, "cancelling dest: %llX\n", t->destroy_task);
2694     GNUNET_SCHEDULER_cancel (t->destroy_task);
2695     t->destroy_task = GNUNET_SCHEDULER_NO_TASK;
2696   }
2697
2698   if (GNUNET_SCHEDULER_NO_TASK != t->trim_connections_task)
2699   {
2700     LOG (GNUNET_ERROR_TYPE_DEBUG, "cancelling trim: %llX\n",
2701          t->trim_connections_task);
2702     GNUNET_SCHEDULER_cancel (t->trim_connections_task);
2703     t->trim_connections_task = GNUNET_SCHEDULER_NO_TASK;
2704   }
2705
2706   GNUNET_STATISTICS_update (stats, "# tunnels", -1, GNUNET_NO);
2707   GCP_set_tunnel (t->peer, NULL);
2708
2709   if (GNUNET_SCHEDULER_NO_TASK != t->rekey_task)
2710   {
2711     GNUNET_SCHEDULER_cancel (t->rekey_task);
2712     t->rekey_task = GNUNET_SCHEDULER_NO_TASK;
2713   }
2714   if (NULL != t->kx_ctx)
2715   {
2716     if (GNUNET_SCHEDULER_NO_TASK != t->kx_ctx->finish_task)
2717       GNUNET_SCHEDULER_cancel (t->kx_ctx->finish_task);
2718     GNUNET_free (t->kx_ctx);
2719   }
2720   GNUNET_free (t);
2721 }
2722
2723
2724 /**
2725  * @brief Use the given path for the tunnel.
2726  * Update the next and prev hops (and RCs).
2727  * (Re)start the path refresh in case the tunnel is locally owned.
2728  *
2729  * @param t Tunnel to update.
2730  * @param p Path to use.
2731  *
2732  * @return Connection created.
2733  */
2734 struct CadetConnection *
2735 GCT_use_path (struct CadetTunnel *t, struct CadetPeerPath *p)
2736 {
2737   struct CadetConnection *c;
2738   struct GNUNET_CADET_Hash cid;
2739   unsigned int own_pos;
2740
2741   if (NULL == t || NULL == p)
2742   {
2743     GNUNET_break (0);
2744     return NULL;
2745   }
2746
2747   if (CADET_TUNNEL_SHUTDOWN == t->cstate)
2748   {
2749     GNUNET_break (0);
2750     return NULL;
2751   }
2752
2753   for (own_pos = 0; own_pos < p->length; own_pos++)
2754   {
2755     if (p->peers[own_pos] == myid)
2756       break;
2757   }
2758   if (own_pos >= p->length)
2759   {
2760     GNUNET_break_op (0);
2761     return NULL;
2762   }
2763
2764   GNUNET_CRYPTO_random_block (GNUNET_CRYPTO_QUALITY_NONCE, &cid, sizeof (cid));
2765   c = GCC_new (&cid, t, p, own_pos);
2766   if (NULL == c)
2767   {
2768     /* Path was flawed */
2769     return NULL;
2770   }
2771   GCT_add_connection (t, c);
2772   return c;
2773 }
2774
2775
2776 /**
2777  * Count all created connections of a tunnel. Not necessarily ready connections!
2778  *
2779  * @param t Tunnel on which to count.
2780  *
2781  * @return Number of connections created, either being established or ready.
2782  */
2783 unsigned int
2784 GCT_count_any_connections (struct CadetTunnel *t)
2785 {
2786   struct CadetTConnection *iter;
2787   unsigned int count;
2788
2789   if (NULL == t)
2790     return 0;
2791
2792   for (count = 0, iter = t->connection_head; NULL != iter; iter = iter->next)
2793     count++;
2794
2795   return count;
2796 }
2797
2798
2799 /**
2800  * Count established (ready) connections of a tunnel.
2801  *
2802  * @param t Tunnel on which to count.
2803  *
2804  * @return Number of connections.
2805  */
2806 unsigned int
2807 GCT_count_connections (struct CadetTunnel *t)
2808 {
2809   struct CadetTConnection *iter;
2810   unsigned int count;
2811
2812   if (NULL == t)
2813     return 0;
2814
2815   for (count = 0, iter = t->connection_head; NULL != iter; iter = iter->next)
2816     if (CADET_CONNECTION_READY == GCC_get_state (iter->c))
2817       count++;
2818
2819   return count;
2820 }
2821
2822
2823 /**
2824  * Count channels of a tunnel.
2825  *
2826  * @param t Tunnel on which to count.
2827  *
2828  * @return Number of channels.
2829  */
2830 unsigned int
2831 GCT_count_channels (struct CadetTunnel *t)
2832 {
2833   struct CadetTChannel *iter;
2834   unsigned int count;
2835
2836   for (count = 0, iter = t->channel_head;
2837        NULL != iter;
2838        iter = iter->next, count++) /* skip */;
2839
2840   return count;
2841 }
2842
2843
2844 /**
2845  * Get the connectivity state of a tunnel.
2846  *
2847  * @param t Tunnel.
2848  *
2849  * @return Tunnel's connectivity state.
2850  */
2851 enum CadetTunnelCState
2852 GCT_get_cstate (struct CadetTunnel *t)
2853 {
2854   if (NULL == t)
2855   {
2856     GNUNET_assert (0);
2857     return (enum CadetTunnelCState) -1;
2858   }
2859   return t->cstate;
2860 }
2861
2862
2863 /**
2864  * Get the encryption state of a tunnel.
2865  *
2866  * @param t Tunnel.
2867  *
2868  * @return Tunnel's encryption state.
2869  */
2870 enum CadetTunnelEState
2871 GCT_get_estate (struct CadetTunnel *t)
2872 {
2873   if (NULL == t)
2874   {
2875     GNUNET_break (0);
2876     return (enum CadetTunnelEState) -1;
2877   }
2878   return t->estate;
2879 }
2880
2881 /**
2882  * Get the maximum buffer space for a tunnel towards a local client.
2883  *
2884  * @param t Tunnel.
2885  *
2886  * @return Biggest buffer space offered by any channel in the tunnel.
2887  */
2888 unsigned int
2889 GCT_get_channels_buffer (struct CadetTunnel *t)
2890 {
2891   struct CadetTChannel *iter;
2892   unsigned int buffer;
2893   unsigned int ch_buf;
2894
2895   if (NULL == t->channel_head)
2896   {
2897     /* Probably getting buffer for a channel create/handshake. */
2898     LOG (GNUNET_ERROR_TYPE_DEBUG, "  no channels, allow max\n");
2899     return 64;
2900   }
2901
2902   buffer = 0;
2903   for (iter = t->channel_head; NULL != iter; iter = iter->next)
2904   {
2905     ch_buf = get_channel_buffer (iter);
2906     if (ch_buf > buffer)
2907       buffer = ch_buf;
2908   }
2909   return buffer;
2910 }
2911
2912
2913 /**
2914  * Get the total buffer space for a tunnel for P2P traffic.
2915  *
2916  * @param t Tunnel.
2917  *
2918  * @return Buffer space offered by all connections in the tunnel.
2919  */
2920 unsigned int
2921 GCT_get_connections_buffer (struct CadetTunnel *t)
2922 {
2923   struct CadetTConnection *iter;
2924   unsigned int buffer;
2925
2926   if (GNUNET_NO == is_ready (t))
2927   {
2928     if (count_queued_data (t) > 3)
2929       return 0;
2930     else
2931       return 1;
2932   }
2933
2934   buffer = 0;
2935   for (iter = t->connection_head; NULL != iter; iter = iter->next)
2936   {
2937     if (GCC_get_state (iter->c) != CADET_CONNECTION_READY)
2938     {
2939       continue;
2940     }
2941     buffer += get_connection_buffer (iter);
2942   }
2943
2944   return buffer;
2945 }
2946
2947
2948 /**
2949  * Get the tunnel's destination.
2950  *
2951  * @param t Tunnel.
2952  *
2953  * @return ID of the destination peer.
2954  */
2955 const struct GNUNET_PeerIdentity *
2956 GCT_get_destination (struct CadetTunnel *t)
2957 {
2958   return GCP_get_id (t->peer);
2959 }
2960
2961
2962 /**
2963  * Get the tunnel's next free global channel ID.
2964  *
2965  * @param t Tunnel.
2966  *
2967  * @return GID of a channel free to use.
2968  */
2969 CADET_ChannelNumber
2970 GCT_get_next_chid (struct CadetTunnel *t)
2971 {
2972   CADET_ChannelNumber chid;
2973   CADET_ChannelNumber mask;
2974   int result;
2975
2976   /* Set bit 30 depending on the ID relationship. Bit 31 is always 0 for GID.
2977    * If our ID is bigger or loopback tunnel, start at 0, bit 30 = 0
2978    * If peer's ID is bigger, start at 0x4... bit 30 = 1
2979    */
2980   result = GNUNET_CRYPTO_cmp_peer_identity (&my_full_id, GCP_get_id (t->peer));
2981   if (0 > result)
2982     mask = 0x40000000;
2983   else
2984     mask = 0x0;
2985   t->next_chid |= mask;
2986
2987   while (NULL != GCT_get_channel (t, t->next_chid))
2988   {
2989     LOG (GNUNET_ERROR_TYPE_DEBUG, "Channel %u exists...\n", t->next_chid);
2990     t->next_chid = (t->next_chid + 1) & ~GNUNET_CADET_LOCAL_CHANNEL_ID_CLI;
2991     t->next_chid |= mask;
2992   }
2993   chid = t->next_chid;
2994   t->next_chid = (t->next_chid + 1) & ~GNUNET_CADET_LOCAL_CHANNEL_ID_CLI;
2995   t->next_chid |= mask;
2996
2997   return chid;
2998 }
2999
3000
3001 /**
3002  * Send ACK on one or more channels due to buffer in connections.
3003  *
3004  * @param t Channel which has some free buffer space.
3005  */
3006 void
3007 GCT_unchoke_channels (struct CadetTunnel *t)
3008 {
3009   struct CadetTChannel *iter;
3010   unsigned int buffer;
3011   unsigned int channels = GCT_count_channels (t);
3012   unsigned int choked_n;
3013   struct CadetChannel *choked[channels];
3014
3015   LOG (GNUNET_ERROR_TYPE_DEBUG, "GCT_unchoke_channels on %s\n", GCT_2s (t));
3016   LOG (GNUNET_ERROR_TYPE_DEBUG, " head: %p\n", t->channel_head);
3017   if (NULL != t->channel_head)
3018     LOG (GNUNET_ERROR_TYPE_DEBUG, " head ch: %p\n", t->channel_head->ch);
3019
3020   /* Get buffer space */
3021   buffer = GCT_get_connections_buffer (t);
3022   if (0 == buffer)
3023   {
3024     return;
3025   }
3026
3027   /* Count and remember choked channels */
3028   choked_n = 0;
3029   for (iter = t->channel_head; NULL != iter; iter = iter->next)
3030   {
3031     if (GNUNET_NO == get_channel_allowed (iter))
3032     {
3033       choked[choked_n++] = iter->ch;
3034     }
3035   }
3036
3037   /* Unchoke random channels */
3038   while (0 < buffer && 0 < choked_n)
3039   {
3040     unsigned int r = GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_WEAK,
3041                                                choked_n);
3042     GCCH_allow_client (choked[r], GCCH_is_origin (choked[r], GNUNET_YES));
3043     choked_n--;
3044     buffer--;
3045     choked[r] = choked[choked_n];
3046   }
3047 }
3048
3049
3050 /**
3051  * Send ACK on one or more connections due to buffer space to the client.
3052  *
3053  * Iterates all connections of the tunnel and sends ACKs appropriately.
3054  *
3055  * @param t Tunnel.
3056  */
3057 void
3058 GCT_send_connection_acks (struct CadetTunnel *t)
3059 {
3060   struct CadetTConnection *iter;
3061   uint32_t allowed;
3062   uint32_t to_allow;
3063   uint32_t allow_per_connection;
3064   unsigned int cs;
3065   unsigned int buffer;
3066
3067   LOG (GNUNET_ERROR_TYPE_DEBUG, "Tunnel send connection ACKs on %s\n",
3068        GCT_2s (t));
3069
3070   if (NULL == t)
3071   {
3072     GNUNET_break (0);
3073     return;
3074   }
3075
3076   if (CADET_TUNNEL_READY != t->cstate)
3077     return;
3078
3079   buffer = GCT_get_channels_buffer (t);
3080   LOG (GNUNET_ERROR_TYPE_DEBUG, "  buffer %u\n", buffer);
3081
3082   /* Count connections, how many messages are already allowed */
3083   cs = GCT_count_connections (t);
3084   for (allowed = 0, iter = t->connection_head; NULL != iter; iter = iter->next)
3085   {
3086     allowed += get_connection_allowed (iter);
3087   }
3088   LOG (GNUNET_ERROR_TYPE_DEBUG, "  allowed %u\n", allowed);
3089
3090   /* Make sure there is no overflow */
3091   if (allowed > buffer)
3092     return;
3093
3094   /* Authorize connections to send more data */
3095   to_allow = buffer - allowed;
3096
3097   for (iter = t->connection_head;
3098        NULL != iter && to_allow > 0;
3099        iter = iter->next)
3100   {
3101     if (CADET_CONNECTION_READY != GCC_get_state (iter->c)
3102         || get_connection_allowed (iter) > 64 / 3)
3103     {
3104       continue;
3105     }
3106     allow_per_connection = to_allow/cs;
3107     to_allow -= allow_per_connection;
3108     cs--;
3109     GCC_allow (iter->c, allow_per_connection,
3110                GCC_is_origin (iter->c, GNUNET_NO));
3111   }
3112
3113   if (0 != to_allow)
3114   {
3115     /* Since we don't allow if it's allowed to send 64/3, this can happen. */
3116     LOG (GNUNET_ERROR_TYPE_DEBUG, "  reminding to_allow: %u\n", to_allow);
3117   }
3118 }
3119
3120
3121 /**
3122  * Cancel a previously sent message while it's in the queue.
3123  *
3124  * ONLY can be called before the continuation given to the send function
3125  * is called. Once the continuation is called, the message is no longer in the
3126  * queue.
3127  *
3128  * @param q Handle to the queue.
3129  */
3130 void
3131 GCT_cancel (struct CadetTunnelQueue *q)
3132 {
3133   if (NULL != q->cq)
3134   {
3135     GCC_cancel (q->cq);
3136     /* tun_message_sent() will be called and free q */
3137   }
3138   else if (NULL != q->tqd)
3139   {
3140     unqueue_data (q->tqd);
3141     q->tqd = NULL;
3142     if (NULL != q->cont)
3143       q->cont (q->cont_cls, NULL, q, 0, 0);
3144     GNUNET_free (q);
3145   }
3146   else
3147   {
3148     GNUNET_break (0);
3149   }
3150 }
3151
3152
3153 /**
3154  * Sends an already built message on a tunnel, encrypting it and
3155  * choosing the best connection if not provided.
3156  *
3157  * @param message Message to send. Function modifies it.
3158  * @param t Tunnel on which this message is transmitted.
3159  * @param c Connection to use (autoselect if NULL).
3160  * @param force Force the tunnel to take the message (buffer overfill).
3161  * @param cont Continuation to call once message is really sent.
3162  * @param cont_cls Closure for @c cont.
3163  *
3164  * @return Handle to cancel message. NULL if @c cont is NULL.
3165  */
3166 struct CadetTunnelQueue *
3167 GCT_send_prebuilt_message (const struct GNUNET_MessageHeader *message,
3168                            struct CadetTunnel *t, struct CadetConnection *c,
3169                            int force, GCT_sent cont, void *cont_cls)
3170 {
3171   return send_prebuilt_message (message, t, c, force, cont, cont_cls, NULL);
3172 }
3173
3174 /**
3175  * Sends an already built and encrypted message on a tunnel, choosing the best
3176  * connection. Useful for re-queueing messages queued on a destroyed connection.
3177  *
3178  * @param message Message to send. Function modifies it.
3179  * @param t Tunnel on which this message is transmitted.
3180  */
3181 void
3182 GCT_resend_message (const struct GNUNET_MessageHeader *message,
3183                     struct CadetTunnel *t)
3184 {
3185   struct CadetConnection *c;
3186   int fwd;
3187
3188   c = tunnel_get_connection (t);
3189   if (NULL == c)
3190   {
3191     /* TODO queue in tunnel, marked as encrypted */
3192     LOG (GNUNET_ERROR_TYPE_DEBUG, "No connection available, dropping.\n");
3193     return;
3194   }
3195   fwd = GCC_is_origin (c, GNUNET_YES);
3196   GNUNET_break (NULL == GCC_send_prebuilt_message (message, 0, 0, c, fwd,
3197                                                    GNUNET_YES, NULL, NULL));
3198 }
3199
3200
3201 /**
3202  * Is the tunnel directed towards the local peer?
3203  *
3204  * @param t Tunnel.
3205  *
3206  * @return #GNUNET_YES if it is loopback.
3207  */
3208 int
3209 GCT_is_loopback (const struct CadetTunnel *t)
3210 {
3211   return (myid == GCP_get_short_id (t->peer));
3212 }
3213
3214
3215 /**
3216  * Is the tunnel this path already?
3217  *
3218  * @param t Tunnel.
3219  * @param p Path.
3220  *
3221  * @return #GNUNET_YES a connection uses this path.
3222  */
3223 int
3224 GCT_is_path_used (const struct CadetTunnel *t, const struct CadetPeerPath *p)
3225 {
3226   struct CadetTConnection *iter;
3227
3228   for (iter = t->connection_head; NULL != iter; iter = iter->next)
3229     if (path_equivalent (GCC_get_path (iter->c), p))
3230       return GNUNET_YES;
3231
3232   return GNUNET_NO;
3233 }
3234
3235
3236 /**
3237  * Get a cost of a path for a tunnel considering existing connections.
3238  *
3239  * @param t Tunnel.
3240  * @param path Candidate path.
3241  *
3242  * @return Cost of the path (path length + number of overlapping nodes)
3243  */
3244 unsigned int
3245 GCT_get_path_cost (const struct CadetTunnel *t,
3246                    const struct CadetPeerPath *path)
3247 {
3248   struct CadetTConnection *iter;
3249   const struct CadetPeerPath *aux;
3250   unsigned int overlap;
3251   unsigned int i;
3252   unsigned int j;
3253
3254   if (NULL == path)
3255     return 0;
3256
3257   overlap = 0;
3258   GNUNET_assert (NULL != t);
3259
3260   for (i = 0; i < path->length; i++)
3261   {
3262     for (iter = t->connection_head; NULL != iter; iter = iter->next)
3263     {
3264       aux = GCC_get_path (iter->c);
3265       if (NULL == aux)
3266         continue;
3267
3268       for (j = 0; j < aux->length; j++)
3269       {
3270         if (path->peers[i] == aux->peers[j])
3271         {
3272           overlap++;
3273           break;
3274         }
3275       }
3276     }
3277   }
3278   return path->length + overlap;
3279 }
3280
3281
3282 /**
3283  * Get the static string for the peer this tunnel is directed.
3284  *
3285  * @param t Tunnel.
3286  *
3287  * @return Static string the destination peer's ID.
3288  */
3289 const char *
3290 GCT_2s (const struct CadetTunnel *t)
3291 {
3292   if (NULL == t)
3293     return "(NULL)";
3294
3295   return GCP_2s (t->peer);
3296 }
3297
3298
3299 /******************************************************************************/
3300 /*****************************    INFO/DEBUG    *******************************/
3301 /******************************************************************************/
3302
3303 /**
3304  * Log all possible info about the tunnel state.
3305  *
3306  * @param t Tunnel to debug.
3307  * @param level Debug level to use.
3308  */
3309 void
3310 GCT_debug (const struct CadetTunnel *t, enum GNUNET_ErrorType level)
3311 {
3312   struct CadetTChannel *iterch;
3313   struct CadetTConnection *iterc;
3314   int do_log;
3315
3316   do_log = GNUNET_get_log_call_status (level & (~GNUNET_ERROR_TYPE_BULK),
3317                                        "cadet-tun",
3318                                        __FILE__, __FUNCTION__, __LINE__);
3319   if (0 == do_log)
3320     return;
3321
3322   LOG2 (level, "TTT DEBUG TUNNEL TOWARDS %s\n", GCT_2s (t));
3323   LOG2 (level, "TTT  cstate %s, estate %s\n",
3324        cstate2s (t->cstate), estate2s (t->estate));
3325   LOG2 (level, "TTT  kx_ctx %p, rekey_task %u, finish task %u\n",
3326         t->kx_ctx, t->rekey_task, t->kx_ctx ? t->kx_ctx->finish_task : 0);
3327 #if DUMP_KEYS_TO_STDERR
3328   LOG2 (level, "TTT  my EPHM\t %s\n",
3329         GNUNET_h2s ((struct GNUNET_HashCode *) &kx_msg.ephemeral_key));
3330   LOG2 (level, "TTT  peers EPHM:\t %s\n",
3331         GNUNET_h2s ((struct GNUNET_HashCode *) &t->peers_ephemeral_key));
3332   LOG2 (level, "TTT  ENC key:\t %s\n",
3333         GNUNET_h2s ((struct GNUNET_HashCode *) &t->e_key));
3334   LOG2 (level, "TTT  DEC key:\t %s\n",
3335         GNUNET_h2s ((struct GNUNET_HashCode *) &t->d_key));
3336   if (t->kx_ctx)
3337   {
3338     LOG2 (level, "TTT  OLD ENC key:\t %s\n",
3339           GNUNET_h2s ((struct GNUNET_HashCode *) &t->kx_ctx->e_key_old));
3340     LOG2 (level, "TTT  OLD DEC key:\t %s\n",
3341           GNUNET_h2s ((struct GNUNET_HashCode *) &t->kx_ctx->d_key_old));
3342   }
3343 #endif
3344   LOG2 (level, "TTT  tq_head %p, tq_tail %p\n", t->tq_head, t->tq_tail);
3345   LOG2 (level, "TTT  destroy %u\n", t->destroy_task);
3346
3347   LOG2 (level, "TTT  channels:\n");
3348   for (iterch = t->channel_head; NULL != iterch; iterch = iterch->next)
3349   {
3350     LOG2 (level, "TTT  - %s\n", GCCH_2s (iterch->ch));
3351   }
3352
3353   LOG2 (level, "TTT  connections:\n");
3354   for (iterc = t->connection_head; NULL != iterc; iterc = iterc->next)
3355   {
3356     GCC_debug (iterc->c, level);
3357   }
3358
3359   LOG2 (level, "TTT DEBUG TUNNEL END\n");
3360 }
3361
3362
3363 /**
3364  * Iterate all tunnels.
3365  *
3366  * @param iter Iterator.
3367  * @param cls Closure for @c iter.
3368  */
3369 void
3370 GCT_iterate_all (GNUNET_CONTAINER_PeerMapIterator iter, void *cls)
3371 {
3372   GNUNET_CONTAINER_multipeermap_iterate (tunnels, iter, cls);
3373 }
3374
3375
3376 /**
3377  * Count all tunnels.
3378  *
3379  * @return Number of tunnels to remote peers kept by this peer.
3380  */
3381 unsigned int
3382 GCT_count_all (void)
3383 {
3384   return GNUNET_CONTAINER_multipeermap_size (tunnels);
3385 }
3386
3387
3388 /**
3389  * Iterate all connections of a tunnel.
3390  *
3391  * @param t Tunnel whose connections to iterate.
3392  * @param iter Iterator.
3393  * @param cls Closure for @c iter.
3394  */
3395 void
3396 GCT_iterate_connections (struct CadetTunnel *t, GCT_conn_iter iter, void *cls)
3397 {
3398   struct CadetTConnection *ct;
3399
3400   for (ct = t->connection_head; NULL != ct; ct = ct->next)
3401     iter (cls, ct->c);
3402 }
3403
3404
3405 /**
3406  * Iterate all channels of a tunnel.
3407  *
3408  * @param t Tunnel whose channels to iterate.
3409  * @param iter Iterator.
3410  * @param cls Closure for @c iter.
3411  */
3412 void
3413 GCT_iterate_channels (struct CadetTunnel *t, GCT_chan_iter iter, void *cls)
3414 {
3415   struct CadetTChannel *cht;
3416
3417   for (cht = t->channel_head; NULL != cht; cht = cht->next)
3418     iter (cls, cht->ch);
3419 }