src/cadet/gnunet-service-cadet_tunnel.c

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