src/mesh/gnunet-service-mesh_tunnel.c

   1 /*
   2      This file is part of GNUnet.
   3      (C) 2013 Christian Grothoff (and other contributing authors)
   4
   5      GNUnet is free software; you can redistribute it and/or modify
   6      it under the terms of the GNU General Public License as published
   7      by the Free Software Foundation; either version 3, or (at your
   8      option) any later version.
   9
  10      GNUnet is distributed in the hope that it will be useful, but
  11      WITHOUT ANY WARRANTY; without even the implied warranty of
  12      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13      General Public License for more details.
  14
  15      You should have received a copy of the GNU General Public License
  16      along with GNUnet; see the file COPYING.  If not, write to the
  17      Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18      Boston, MA 02111-1307, USA.
  19 */
  20
  21 #include "platform.h"
  22 #include "gnunet_util_lib.h"
  23
  24 #include "gnunet_statistics_service.h"
  25
  26 #include "mesh_protocol_enc.h"
  27
  28 #include "gnunet-service-mesh_tunnel.h"
  29 #include "gnunet-service-mesh_connection.h"
  30 #include "gnunet-service-mesh_channel.h"
  31 #include "gnunet-service-mesh_peer.h"
  32 #include "mesh_path.h"
  33
  34 #define LOG(level, ...) GNUNET_log_from(level,"mesh-tun",__VA_ARGS__)
  35
  36
  37 /******************************************************************************/
  38 /********************************   STRUCTS  **********************************/
  39 /******************************************************************************/
  40
  41 struct MeshTChannel
  42 {
  43   struct MeshTChannel *next;
  44   struct MeshTChannel *prev;
  45   struct MeshChannel *ch;
  46 };
  47
  48 struct MeshTConnection
  49 {
  50   struct MeshTConnection *next;
  51   struct MeshTConnection *prev;
  52   struct MeshConnection *c;
  53 };
  54
  55 /**
  56  * Struct containing all information regarding a tunnel to a peer.
  57  */
  58 struct MeshTunnel3
  59 {
  60     /**
  61      * Endpoint of the tunnel.
  62      */
  63   struct MeshPeer *peer;
  64
  65     /**
  66      * State of the tunnel.
  67      */
  68   enum MeshTunnelState state;
  69
  70   /**
  71    * Local peer ephemeral private key
  72    */
  73   struct GNUNET_CRYPTO_EccPrivateKey *my_eph_key;
  74
  75   /**
  76    * Local peer ephemeral public key
  77    */
  78   struct GNUNET_CRYPTO_EccPublicSignKey *my_eph;
  79
  80   /**
  81    * Remote peer's public key.
  82    */
  83   struct GNUNET_CRYPTO_EccPublicSignKey *peers_eph;
  84
  85   /**
  86    * Encryption ("our") key.
  87    */
  88   struct GNUNET_CRYPTO_SymmetricSessionKey e_key;
  89
  90   /**
  91    * Decryption ("their") key.
  92    */
  93   struct GNUNET_CRYPTO_SymmetricSessionKey d_key;
  94
  95   /**
  96    * Paths that are actively used to reach the destination peer.
  97    */
  98   struct MeshTConnection *connection_head;
  99   struct MeshTConnection *connection_tail;
 100
 101   /**
 102    * Next connection number.
 103    */
 104   uint32_t next_cid;
 105
 106   /**
 107    * Channels inside this tunnel.
 108    */
 109   struct MeshTChannel *channel_head;
 110   struct MeshTChannel *channel_tail;
 111
 112   /**
 113    * Channel ID for the next created channel.
 114    */
 115   MESH_ChannelNumber next_chid;
 116
 117   /**
 118    * Pending message count.
 119    */
 120   int pending_messages;
 121
 122   /**
 123    * Destroy flag: if true, destroy on last message.
 124    */
 125   int destroy;
 126
 127   /**
 128    * Queued messages, to transmit once tunnel gets connected.
 129    */
 130   struct MeshTunnelQueue *tq_head;
 131   struct MeshTunnelQueue *tq_tail;
 132 };
 133
 134
 135 /**
 136  * Struct used to queue messages in a tunnel.
 137  */
 138 struct MeshTunnelQueue
 139 {
 140   /**
 141    * DLL
 142    */
 143   struct MeshTunnelQueue *next;
 144   struct MeshTunnelQueue *prev;
 145
 146   /**
 147    * Channel.
 148    */
 149   struct MeshChannel *ch;
 150
 151   /**
 152    * Message to send.
 153    */
 154   /* struct GNUNET_MessageHeader *msg; */
 155 };
 156
 157 /******************************************************************************/
 158 /*******************************   GLOBALS  ***********************************/
 159 /******************************************************************************/
 160
 161 /**
 162  * Global handle to the statistics service.
 163  */
 164 extern struct GNUNET_STATISTICS_Handle *stats;
 165
 166 /**
 167  * Default TTL for payload packets.
 168  */
 169 static unsigned long long default_ttl;
 170
 171 /**
 172  * Local peer own ID (memory efficient handle).
 173  */
 174 static GNUNET_PEER_Id my_short_id;
 175
 176 /**
 177  * Local peer own ID (full value).
 178  */
 179 const static struct GNUNET_PeerIdentity *my_full_id;
 180
 181 /**
 182  * Own private key.
 183  */
 184 const static struct GNUNET_CRYPTO_EccPrivateKey *my_private_key;
 185
 186
 187 /******************************************************************************/
 188 /********************************   STATIC  ***********************************/
 189 /******************************************************************************/
 190
 191 /**
 192  * Get string description for tunnel state.
 193  *
 194  * @param s Tunnel state.
 195  *
 196  * @return String representation.
 197  */
 198 static const char *
 199 GMT_state2s (enum MeshTunnelState s)
 200 {
 201   static char buf[128];
 202
 203   switch (s)
 204   {
 205     case MESH_TUNNEL_NEW:
 206       return "MESH_TUNNEL_NEW";
 207     case MESH_TUNNEL_SEARCHING:
 208       return "MESH_TUNNEL_SEARCHING";
 209     case MESH_TUNNEL_WAITING:
 210       return "MESH_TUNNEL_WAITING";
 211     case MESH_TUNNEL_READY:
 212       return "MESH_TUNNEL_READY";
 213     case MESH_TUNNEL_RECONNECTING:
 214       return "MESH_TUNNEL_RECONNECTING";
 215
 216     default:
 217       sprintf (buf, "%u (UNKNOWN STATE)", s);
 218       return buf;
 219   }
 220 }
 221
 222 /**
 223  * Pick a connection on which send the next data message.
 224  *
 225  * @param t Tunnel on which to send the message.
 226  * @param fwd Is this a fwd message?
 227  *
 228  * @return The connection on which to send the next message.
 229  */
 230 static struct MeshConnection *
 231 tunnel_get_connection (struct MeshTunnel3 *t, int fwd)
 232 {
 233   struct MeshTConnection *iter;
 234   struct MeshConnection *best;
 235   unsigned int qn;
 236   unsigned int lowest_q;
 237
 238   LOG (GNUNET_ERROR_TYPE_DEBUG, "tunnel_get_connection %s\n", GMP_2s (t->peer));
 239   best = NULL;
 240   lowest_q = UINT_MAX;
 241   for (iter = t->connection_head; NULL != iter; iter = iter->next)
 242   {
 243     LOG (GNUNET_ERROR_TYPE_DEBUG, "  connection %s: %u\n",
 244          GNUNET_h2s (GMC_get_id (iter->c)), GMC_get_state (iter->c));
 245     if (MESH_CONNECTION_READY == GMC_get_state (iter->c))
 246     {
 247       qn = GMC_get_qn (iter->c, fwd);
 248       LOG (GNUNET_ERROR_TYPE_DEBUG, "    q_n %u, \n", qn);
 249       if (qn < lowest_q)
 250       {
 251         best = iter->c;
 252         lowest_q = qn;
 253       }
 254     }
 255   }
 256   return best;
 257 }
 258
 259
 260 void
 261 handle_data (struct MeshTunnel3 *t,
 262              const struct GNUNET_MESH_Data *msg,
 263              int fwd)
 264 {
 265   struct MeshChannel *ch;
 266   uint16_t type;
 267   size_t size;
 268
 269   /* Check size */
 270   size = ntohs (msg->header.size);
 271   if (size <
 272       sizeof (struct GNUNET_MESH_Data) +
 273       sizeof (struct GNUNET_MessageHeader))
 274   {
 275     GNUNET_break (0);
 276     return;
 277   }
 278   type = ntohs (msg->header.type);
 279   LOG (GNUNET_ERROR_TYPE_DEBUG, "got a %s message\n",
 280               GNUNET_MESH_DEBUG_M2S (type));
 281   LOG (GNUNET_ERROR_TYPE_DEBUG, " payload of type %s\n",
 282               GNUNET_MESH_DEBUG_M2S (ntohs (msg[1].header.type)));
 283
 284   /* Check channel */
 285   ch = GMT_get_channel (t, ntohl (msg->chid));
 286   if (NULL == ch)
 287   {
 288     GNUNET_STATISTICS_update (stats, "# data on unknown channel",
 289                               1, GNUNET_NO);
 290     LOG (GNUNET_ERROR_TYPE_DEBUG, "WARNING channel %u unknown\n",
 291          ntohl (msg->chid));
 292     return;
 293   }
 294
 295   GMT_change_state (t, MESH_TUNNEL_READY);
 296   GMCH_handle_data (ch, msg, fwd);
 297 }
 298
 299 void
 300 handle_data_ack (struct MeshTunnel3 *t,
 301                  const struct GNUNET_MESH_DataACK *msg,
 302                  int fwd)
 303 {
 304   struct MeshChannel *ch;
 305   size_t size;
 306
 307   /* Check size */
 308   size = ntohs (msg->header.size);
 309   if (size != sizeof (struct GNUNET_MESH_DataACK))
 310   {
 311     GNUNET_break (0);
 312     return;
 313   }
 314
 315   /* Check channel */
 316   ch = GMT_get_channel (t, ntohl (msg->chid));
 317   if (NULL == ch)
 318   {
 319     GNUNET_STATISTICS_update (stats, "# data ack on unknown channel",
 320                               1, GNUNET_NO);
 321     LOG (GNUNET_ERROR_TYPE_DEBUG, "WARNING channel %u unknown\n",
 322          ntohl (msg->chid));
 323     return;
 324   }
 325
 326   GMCH_handle_data_ack (ch, msg, fwd);
 327 }
 328
 329 void
 330 handle_ch_create (struct MeshTunnel3 *t,
 331                   const struct GNUNET_MESH_ChannelCreate *msg,
 332                   int fwd)
 333 {
 334   struct MeshTChannel *tch;
 335   struct MeshChannel *ch;
 336   size_t size;
 337
 338   /* Check size */
 339   size = ntohs (msg->header.size);
 340   if (size != sizeof (struct GNUNET_MESH_ChannelCreate))
 341   {
 342     GNUNET_break (0);
 343     return;
 344   }
 345
 346   /* Check channel */
 347   ch = GMT_get_channel (t, ntohl (msg->chid));
 348   if (NULL != ch)
 349   {
 350     /* Probably a retransmission, safe to ignore */
 351     LOG (GNUNET_ERROR_TYPE_DEBUG, "   already exists...\n");
 352   }
 353   else
 354   {
 355     ch = GMCH_handle_create (msg, fwd);
 356   }
 357
 358   tch = GNUNET_new (struct MeshTChannel);
 359   tch->ch = ch;
 360   GNUNET_CONTAINER_DLL_insert (t->channel_head, t->channel_tail, tch);
 361 }
 362
 363 void
 364 handle_ch_ack (struct MeshTunnel3 *t,
 365                const struct GNUNET_MESH_ChannelManage *msg,
 366                int fwd)
 367 {
 368   struct MeshChannel *ch;
 369   size_t size;
 370
 371   /* Check size */
 372   size = ntohs (msg->header.size);
 373   if (size != sizeof (struct GNUNET_MESH_ChannelManage))
 374   {
 375     GNUNET_break (0);
 376     return;
 377   }
 378
 379   /* Check channel */
 380   ch = GMT_get_channel (t, ntohl (msg->chid));
 381   if (NULL == ch)
 382   {
 383     GNUNET_STATISTICS_update (stats, "# channel ack on unknown channel",
 384                               1, GNUNET_NO);
 385     LOG (GNUNET_ERROR_TYPE_DEBUG, "WARNING channel %u unknown\n",
 386          ntohl (msg->chid));
 387     return;
 388   }
 389
 390   GMCH_handle_ack (ch, msg, fwd);
 391 }
 392
 393 void
 394 handle_ch_destroy (struct MeshTunnel3 *t,
 395                    const struct GNUNET_MESH_ChannelManage *msg,
 396                    int fwd)
 397 {
 398   struct MeshChannel *ch;
 399   size_t size;
 400
 401   /* Check size */
 402   size = ntohs (msg->header.size);
 403   if (size != sizeof (struct GNUNET_MESH_ChannelManage))
 404   {
 405     GNUNET_break (0);
 406     return;
 407   }
 408
 409   /* Check channel */
 410   ch = GMT_get_channel (t, ntohl (msg->chid));
 411   if (NULL == ch)
 412   {
 413     /* Probably a retransmission, safe to ignore */
 414     return;
 415   }
 416
 417   GMCH_handle_destroy (ch, msg, fwd);
 418 }
 419
 420 /******************************************************************************/
 421 /********************************    API    ***********************************/
 422 /******************************************************************************/
 423
 424 /**
 425  * Demultiplex by message type and call appropriate handler for a message
 426  * towards a channel of a local tunnel.
 427  *
 428  * @param t Tunnel this message came on.
 429  * @param msgh Message header.
 430  * @param fwd Is this message fwd?
 431  */
 432 void
 433 GMT_handle_decrypted (struct MeshTunnel3 *t,
 434                       const struct GNUNET_MessageHeader *msgh,
 435                       int fwd)
 436 {
 437   uint16_t type;
 438
 439   type = ntohs (msgh->type);
 440   LOG (GNUNET_ERROR_TYPE_DEBUG,
 441        "Got a %s message!\n",
 442        GNUNET_MESH_DEBUG_M2S (type));
 443
 444   switch (type)
 445   {
 446     case GNUNET_MESSAGE_TYPE_MESH_DATA:
 447       /* Don't send hop ACK, wait for client to ACK */
 448       handle_data (t, (struct GNUNET_MESH_Data *) msgh, fwd);
 449       break;
 450
 451     case GNUNET_MESSAGE_TYPE_MESH_DATA_ACK:
 452       handle_data_ack (t, (struct GNUNET_MESH_DataACK *) msgh, fwd);
 453       break;
 454
 455     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_CREATE:
 456       handle_ch_create (t,
 457                         (struct GNUNET_MESH_ChannelCreate *) msgh,
 458                         fwd);
 459       break;
 460
 461     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_ACK:
 462       handle_ch_ack (t,
 463                      (struct GNUNET_MESH_ChannelManage *) msgh,
 464                      fwd);
 465       break;
 466
 467     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_DESTROY:
 468       handle_ch_destroy (t,
 469                          (struct GNUNET_MESH_ChannelManage *) msgh,
 470                          fwd);
 471       break;
 472
 473     default:
 474       GNUNET_break_op (0);
 475       LOG (GNUNET_ERROR_TYPE_DEBUG,
 476            "end-to-end message not known (%u)\n",
 477            ntohs (msgh->type));
 478   }
 479 }
 480
 481
 482 /**
 483  * Cache a message to be sent once tunnel is online.
 484  *
 485  * @param t Tunnel to hold the message.
 486  * @param ch Channel the message is about.
 487  * @param msg Message itself (copy will be made).
 488  * @param fwd Is this fwd?
 489  */
 490 void
 491 GMT_queue_data (struct MeshTunnel3 *t,
 492                 struct MeshChannel *ch,
 493                 struct GNUNET_MessageHeader *msg,
 494                 int fwd)
 495 {
 496   struct MeshTunnelQueue *tq;
 497   uint16_t size = ntohs (msg->size);
 498
 499   tq = GNUNET_malloc (sizeof (struct MeshTunnelQueue) + size);
 500
 501   tq->ch = ch;
 502   memcpy (&tq[1], msg, size);
 503   GNUNET_CONTAINER_DLL_insert_tail (t->tq_head, t->tq_tail, tq);
 504
 505   if (MESH_TUNNEL_READY == t->state)
 506     GMT_send_queued_data (t, fwd);
 507 }
 508
 509
 510 /**
 511  * Send all cached messages that we can, tunnel is online.
 512  *
 513  * @param t Tunnel that holds the messages.
 514  * @param fwd Is this fwd?
 515  */
 516 void
 517 GMT_send_queued_data (struct MeshTunnel3 *t, int fwd)
 518 {
 519   struct MeshTunnelQueue *tq;
 520   struct MeshTunnelQueue *next;
 521   unsigned int room;
 522
 523   LOG (GNUNET_ERROR_TYPE_DEBUG,
 524               "GMT_send_queued_data on tunnel %s\n",
 525               GMP_2s (t->peer));
 526   room = GMT_get_buffer (t, fwd);
 527   LOG (GNUNET_ERROR_TYPE_DEBUG, "  buffer space: %u\n", room);
 528   for (tq = t->tq_head; NULL != tq && room > 0; tq = next)
 529   {
 530     next = tq->next;
 531     room--;
 532     GNUNET_CONTAINER_DLL_remove (t->tq_head, t->tq_tail, tq);
 533     GMCH_send_prebuilt_message ((struct GNUNET_MessageHeader *) &tq[1],
 534                                 tq->ch, fwd);
 535
 536     GNUNET_free (tq);
 537   }
 538 }
 539
 540
 541 /**
 542  * Initialize the tunnel subsystem.
 543  *
 544  * @param c Configuration handle.
 545  * @param id Peer identity.
 546  * @param key ECC private key, to derive all other keys and do crypto.
 547  */
 548 void
 549 GMT_init (const struct GNUNET_CONFIGURATION_Handle *c,
 550           const struct GNUNET_PeerIdentity *id,
 551           const struct GNUNET_CRYPTO_EccPrivateKey *key)
 552 {
 553   if (GNUNET_OK !=
 554       GNUNET_CONFIGURATION_get_value_number (c, "MESH", "DEFAULT_TTL",
 555                                              &default_ttl))
 556   {
 557     GNUNET_log_config_invalid (GNUNET_ERROR_TYPE_WARNING,
 558                                "MESH", "DEFAULT_TTL", "USING DEFAULT");
 559     default_ttl = 64;
 560   }
 561   my_full_id = id;
 562   my_private_key = key;
 563   my_short_id = GNUNET_PEER_intern (my_full_id);
 564 }
 565
 566
 567 /**
 568  * Shut down the tunnel subsystem.
 569  */
 570 void
 571 GMT_shutdown (void)
 572 {
 573   GNUNET_PEER_change_rc (my_short_id, -1);
 574 }
 575
 576
 577 /**
 578  * Create a tunnel.
 579  */
 580 struct MeshTunnel3 *
 581 GMT_new (void)
 582 {
 583   struct MeshTunnel3 *t;
 584
 585   t = GNUNET_new (struct MeshTunnel3);
 586   t->next_chid = 0;
 587 //   if (GNUNET_OK !=
 588 //       GNUNET_CONTAINER_multihashmap_put (tunnels, tid, t,
 589 //                                          GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST))
 590 //   {
 591 //     GNUNET_break (0);
 592 //     tunnel_destroy (t);
 593 //     return NULL;
 594 //   }
 595
 596 //   char salt[] = "salt";
 597 //   GNUNET_CRYPTO_kdf (&t->e_key, sizeof (struct GNUNET_CRYPTO_SymmetricSessionKey),
 598 //                      salt, sizeof (salt),
 599 //                      &t->e_key, sizeof (struct GNUNET_CRYPTO_SymmetricSessionKey),
 600 //                      &my_full_id, sizeof (struct GNUNET_PeerIdentity),
 601 //                      GNUNET_PEER_resolve2 (t->peer->id), sizeof (struct GNUNET_PeerIdentity),
 602 //                      NULL);
 603 //   GNUNET_CRYPTO_kdf (&t->d_key, sizeof (struct GNUNET_CRYPTO_SymmetricSessionKey),
 604 //                      salt, sizeof (salt),
 605 //                      &t->d_key, sizeof (struct GNUNET_CRYPTO_SymmetricSessionKey),
 606 //                      GNUNET_PEER_resolve2 (t->peer->id), sizeof (struct GNUNET_PeerIdentity),
 607 //                      &my_full_id, sizeof (struct GNUNET_PeerIdentity),
 608 //                      NULL);
 609
 610   return t;
 611 }
 612
 613
 614
 615 /**
 616  * Change the tunnel state.
 617  *
 618  * @param t Tunnel whose state to change.
 619  * @param state New state.
 620  */
 621 void
 622 GMT_change_state (struct MeshTunnel3* t, enum MeshTunnelState state)
 623 {
 624   if (NULL == t)
 625     return;
 626   LOG (GNUNET_ERROR_TYPE_DEBUG,
 627               "Tunnel %s state was %s\n",
 628               GMP_2s (t->peer),
 629               GMT_state2s (t->state));
 630   LOG (GNUNET_ERROR_TYPE_DEBUG,
 631               "Tunnel %s state is now %s\n",
 632               GMP_2s (t->peer),
 633               GMT_state2s (state));
 634   t->state = state;
 635 }
 636
 637
 638 /**
 639  * Add a connection to a tunnel.
 640  *
 641  * @param t Tunnel.
 642  * @param c Connection.
 643  */
 644 void
 645 GMT_add_connection (struct MeshTunnel3 *t, struct MeshConnection *c)
 646 {
 647   struct MeshTConnection *aux;
 648
 649   for (aux = t->connection_head; aux != NULL; aux = aux->next)
 650     if (aux->c == c)
 651       return;
 652
 653   aux = GNUNET_new (struct MeshTConnection);
 654   aux->c = c;
 655   GNUNET_CONTAINER_DLL_insert_tail (t->connection_head, t->connection_tail, aux);
 656 }
 657
 658
 659 /**
 660  * Remove a connection from a tunnel.
 661  *
 662  * @param t Tunnel.
 663  * @param c Connection.
 664  */
 665 void
 666 GMT_remove_connection (struct MeshTunnel3 *t, struct MeshConnection *c)
 667 {
 668   struct MeshTConnection *aux;
 669
 670   for (aux = t->connection_head; aux != NULL; aux = aux->next)
 671     if (aux->c == c)
 672     {
 673       GNUNET_CONTAINER_DLL_remove (t->connection_head, t->connection_tail, aux);
 674       GNUNET_free (aux);
 675       return;
 676     }
 677 }
 678
 679
 680 /**
 681  * Add a channel to a tunnel.
 682  *
 683  * @param t Tunnel.
 684  * @param ch Channel.
 685  */
 686 void
 687 GMT_add_channel (struct MeshTunnel3 *t, struct MeshChannel *ch)
 688 {
 689   struct MeshTChannel *aux;
 690
 691   for (aux = t->channel_head; aux != NULL; aux = aux->next)
 692     if (aux->ch == ch)
 693       return;
 694
 695   aux = GNUNET_new (struct MeshTChannel);
 696   aux->ch = ch;
 697   GNUNET_CONTAINER_DLL_insert_tail (t->channel_head, t->channel_tail, aux);
 698 }
 699
 700
 701 /**
 702  * Remove a channel from a tunnel.
 703  *
 704  * @param t Tunnel.
 705  * @param ch Channel.
 706  */
 707 void
 708 GMT_remove_channel (struct MeshTunnel3 *t, struct MeshChannel *ch)
 709 {
 710   struct MeshTChannel *aux;
 711
 712   for (aux = t->channel_head; aux != NULL; aux = aux->next)
 713     if (aux->ch == ch)
 714     {
 715       GNUNET_CONTAINER_DLL_remove (t->channel_head, t->channel_tail, aux);
 716       GNUNET_free (aux);
 717       return;
 718     }
 719 }
 720
 721
 722 /**
 723  * Search for a channel by global ID.
 724  *
 725  * @param t Tunnel containing the channel.
 726  * @param chid Public channel number.
 727  *
 728  * @return channel handler, NULL if doesn't exist
 729  */
 730 struct MeshChannel *
 731 GMT_get_channel (struct MeshTunnel3 *t, MESH_ChannelNumber chid)
 732 {
 733   struct MeshTChannel *iter;
 734
 735   if (NULL == t)
 736     return NULL;
 737
 738   for (iter = t->channel_head; NULL != iter; iter = iter->next)
 739   {
 740     if (GMCH_get_id (iter->ch) == chid)
 741       break;
 742   }
 743
 744   return NULL == iter ? NULL : iter->ch;
 745 }
 746
 747
 748 /**
 749  * Tunnel is empty: destroy it.
 750  *
 751  * Notifies all connections about the destruction.
 752  *
 753  * @param t Tunnel to destroy.
 754  */
 755 void
 756 GMT_destroy_empty (struct MeshTunnel3 *t)
 757 {
 758   struct MeshTConnection *iter;
 759
 760   for (iter = t->connection_head; NULL != iter; iter = iter->next)
 761   {
 762     GMC_send_destroy (iter->c);
 763   }
 764
 765   if (0 == t->pending_messages)
 766     GMT_destroy (t);
 767   else
 768     t->destroy = GNUNET_YES;
 769 }
 770
 771
 772 /**
 773  * Destroy tunnel if empty (no more channels).
 774  *
 775  * @param t Tunnel to destroy if empty.
 776  */
 777 void
 778 GMT_destroy_if_empty (struct MeshTunnel3 *t)
 779 {
 780   if (1 < GMT_count_channels (t))
 781     return;
 782
 783   GMT_destroy_empty (t);
 784 }
 785
 786
 787 /**
 788  * Destroy the tunnel.
 789  *
 790  * This function does not generate any warning traffic to clients or peers.
 791  *
 792  * Tasks:
 793  * Cancel messages belonging to this tunnel queued to neighbors.
 794  * Free any allocated resources linked to the tunnel.
 795  *
 796  * @param t The tunnel to destroy.
 797  */
 798 void
 799 GMT_destroy (struct MeshTunnel3 *t)
 800 {
 801   struct MeshTConnection *iter;
 802   struct MeshTConnection *next;
 803
 804   if (NULL == t)
 805     return;
 806
 807   LOG (GNUNET_ERROR_TYPE_DEBUG, "destroying tunnel %s\n", GMP_2s (t->peer));
 808
 809 //   if (GNUNET_YES != GNUNET_CONTAINER_multihashmap_remove (tunnels, &t->id, t))
 810 //     GNUNET_break (0);
 811
 812   for (iter = t->connection_head; NULL != iter; iter = next)
 813   {
 814     next = iter->next;
 815     GMC_destroy (iter->c);
 816     GNUNET_free (iter);
 817   }
 818
 819   GNUNET_STATISTICS_update (stats, "# tunnels", -1, GNUNET_NO);
 820   GMP_set_tunnel (t->peer, NULL);
 821
 822   GNUNET_free (t);
 823 }
 824
 825
 826 /**
 827  * Notifies a tunnel that a connection has broken that affects at least
 828  * some of its peers. Sends a notification towards the root of the tree.
 829  * In case the peer is the owner of the tree, notifies the client that owns
 830  * the tunnel and tries to reconnect.
 831  *
 832  * FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME
 833  *
 834  * @param t Tunnel affected.
 835  * @param p1 Peer that got disconnected from p2.
 836  * @param p2 Peer that got disconnected from p1.
 837  *
 838  * @return Short ID of the peer disconnected (either p1 or p2).
 839  *         0 if the tunnel remained unaffected.
 840  */
 841 GNUNET_PEER_Id
 842 GMT_notify_connection_broken (struct MeshTunnel3* t,
 843                               GNUNET_PEER_Id p1, GNUNET_PEER_Id p2)
 844 {
 845 //   if (myid != p1 && myid != p2) FIXME
 846 //   {
 847 //     return;
 848 //   }
 849 //
 850 //   if (tree_get_predecessor (t->tree) != 0)
 851 //   {
 852 //     /* We are the peer still connected, notify owner of the disconnection. */
 853 //     struct GNUNET_MESH_PathBroken msg;
 854 //     struct GNUNET_PeerIdentity neighbor;
 855 //
 856 //     msg.header.size = htons (sizeof (msg));
 857 //     msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_PATH_BROKEN);
 858 //     GNUNET_PEER_resolve (t->id.oid, &msg.oid);
 859 //     msg.tid = htonl (t->id.tid);
 860 //     msg.peer1 = my_full_id;
 861 //     GNUNET_PEER_resolve (pid, &msg.peer2);
 862 //     GNUNET_PEER_resolve (tree_get_predecessor (t->tree), &neighbor);
 863 //     send_prebuilt_message (&msg.header, &neighbor, t);
 864 //   }
 865   return 0;
 866 }
 867
 868 /**
 869  * @brief Use the given path for the tunnel.
 870  * Update the next and prev hops (and RCs).
 871  * (Re)start the path refresh in case the tunnel is locally owned.
 872  *
 873  * @param t Tunnel to update.
 874  * @param p Path to use.
 875  *
 876  * @return Connection created.
 877  */
 878 struct MeshConnection *
 879 GMT_use_path (struct MeshTunnel3 *t, struct MeshPeerPath *p)
 880 {
 881   struct MeshConnection *c;
 882   struct GNUNET_HashCode cid;
 883   unsigned int own_pos;
 884
 885   if (NULL == t || NULL == p)
 886   {
 887     GNUNET_break (0);
 888     return NULL;
 889   }
 890
 891   for (own_pos = 0; own_pos < p->length; own_pos++)
 892   {
 893     if (p->peers[own_pos] == my_short_id)
 894       break;
 895   }
 896   if (own_pos > p->length - 1)
 897   {
 898     GNUNET_break (0);
 899     return NULL;
 900   }
 901
 902   GNUNET_CRYPTO_hash_create_random (GNUNET_CRYPTO_QUALITY_NONCE, &cid);
 903   c = GMC_new (&cid, t, p, own_pos);
 904   GMT_add_connection (t, c);
 905   return c;
 906 }
 907
 908
 909 /**
 910  * FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME
 911  * Encrypt data with the tunnel key.
 912  * Make static?
 913  *
 914  * @param t Tunnel whose key to use.
 915  * @param dst Destination for the encrypted data.
 916  * @param src Source of the plaintext.
 917  * @param size Size of the plaintext.
 918  * @param iv Initialization Vector to use.
 919  * @param fwd Is this a fwd message?
 920  */
 921 void
 922 GMT_encrypt (struct MeshTunnel3 *t,
 923              void *dst, const void *src,
 924              size_t size, uint64_t iv, int fwd)
 925 {
 926   memcpy (dst, src, size);
 927 }
 928
 929
 930 /**
 931  * FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME FIXME
 932  * Decrypt data with the tunnel key.
 933  * Make static?
 934  *
 935  * @param t Tunnel whose key to use.
 936  * @param dst Destination for the plaintext.
 937  * @param src Source of the encrypted data.
 938  * @param size Size of the encrypted data.
 939  * @param iv Initialization Vector to use.
 940  * @param fwd Is this a fwd message?
 941  */
 942 void
 943 GMT_decrypt (struct MeshTunnel3 *t,
 944              void *dst, const void *src,
 945              size_t size, uint64_t iv, int fwd)
 946 {
 947   memcpy (dst, src, size);
 948 }
 949
 950
 951 /**
 952  * Count established (ready) connections of a tunnel.
 953  *
 954  * @param t Tunnel on which to count.
 955  *
 956  * @return Number of connections.
 957  */
 958 unsigned int
 959 GMT_count_connections (struct MeshTunnel3 *t)
 960 {
 961   struct MeshTConnection *iter;
 962   unsigned int count;
 963
 964   for (count = 0, iter = t->connection_head;
 965        NULL != iter;
 966        iter = iter->next, count++);
 967
 968   return count;
 969 }
 970
 971 /**
 972  * Count channels of a tunnel.
 973  *
 974  * @param t Tunnel on which to count.
 975  *
 976  * @return Number of channels.
 977  */
 978 unsigned int
 979 GMT_count_channels (struct MeshTunnel3 *t)
 980 {
 981   struct MeshTChannel *iter;
 982   unsigned int count;
 983
 984   for (count = 0, iter = t->channel_head;
 985        NULL != iter;
 986   iter = iter->next, count++);
 987
 988   return count;
 989 }
 990
 991
 992 /**
 993  * Get the state of a tunnel.
 994  *
 995  * @param t Tunnel.
 996  *
 997  * @return Tunnel's state.
 998  */
 999 enum MeshTunnelState
1000 GMT_get_state (struct MeshTunnel3 *t)
1001 {
1002   return t->state;
1003 }
1004
1005 /**
1006  * Get the total buffer space for a tunnel.
1007  *
1008  * @param t Tunnel.
1009  * @param fwd Is this for FWD traffic?
1010  *
1011  * @return Buffer space offered by all connections in the tunnel.
1012  */
1013 unsigned int
1014 GMT_get_buffer (struct MeshTunnel3 *t, int fwd)
1015 {
1016   struct MeshTConnection *iter;
1017   unsigned int buffer;
1018
1019   iter = t->connection_head;
1020   buffer = 0;
1021
1022   /* If terminal, return biggest channel buffer */
1023   if (NULL == iter || GMC_is_terminal (iter->c, fwd))
1024   {
1025     struct MeshTChannel *iter_ch;
1026     unsigned int ch_buf;
1027
1028     if (NULL == t->channel_head)
1029       return 64;
1030
1031     for (iter_ch = t->channel_head; NULL != iter_ch; iter_ch = iter_ch->next)
1032     {
1033       ch_buf = GMCH_get_buffer (iter_ch->ch, fwd);
1034       if (ch_buf > buffer)
1035         buffer = ch_buf;
1036     }
1037     return buffer;
1038   }
1039
1040   /* If not terminal, return sum of connection buffers */
1041   while (NULL != iter)
1042   {
1043     if (GMC_get_state (iter->c) != MESH_CONNECTION_READY)
1044     {
1045       iter = iter->next;
1046       continue;
1047     }
1048
1049     buffer += GMC_get_buffer (iter->c, fwd);
1050     iter = iter->next;
1051   }
1052
1053   return buffer;
1054 }
1055
1056
1057 /**
1058  * Get the tunnel's destination.
1059  *
1060  * @param t Tunnel.
1061  *
1062  * @return ID of the destination peer.
1063  */
1064 const struct GNUNET_PeerIdentity *
1065 GMT_get_destination (struct MeshTunnel3 *t)
1066 {
1067   return GMP_get_id (t->peer);
1068 }
1069
1070
1071 /**
1072  * Get the tunnel's next free global channel ID.
1073  *
1074  * @param t Tunnel.
1075  *
1076  * @return GID of a channel free to use.
1077  */
1078 MESH_ChannelNumber
1079 GMT_get_next_chid (struct MeshTunnel3 *t)
1080 {
1081   MESH_ChannelNumber chid;
1082
1083   while (NULL != GMT_get_channel (t, t->next_chid))
1084   {
1085     LOG (GNUNET_ERROR_TYPE_DEBUG, "Channel %u exists...\n", t->next_chid);
1086     t->next_chid = (t->next_chid + 1) & ~GNUNET_MESH_LOCAL_CHANNEL_ID_CLI;
1087   }
1088   chid = t->next_chid;
1089   t->next_chid = (t->next_chid + 1) & ~GNUNET_MESH_LOCAL_CHANNEL_ID_CLI;
1090
1091   return chid;
1092 }
1093
1094
1095 /**
1096  * Sends an already built message on a tunnel, encrypting it and
1097  * choosing the best connection.
1098  *
1099  * @param message Message to send. Function modifies it.
1100  * @param t Tunnel on which this message is transmitted.
1101  * @param ch Channel on which this message is transmitted.
1102  * @param fwd Is this a fwd message?
1103  */
1104 void
1105 GMT_send_prebuilt_message (const struct GNUNET_MessageHeader *message,
1106                            struct MeshTunnel3 *t,
1107                            struct MeshChannel *ch,
1108                            int fwd)
1109 {
1110   struct MeshConnection *c;
1111   struct GNUNET_MESH_Encrypted *msg;
1112   size_t size = ntohs (message->size);
1113   char *cbuf[sizeof (struct GNUNET_MESH_Encrypted) + size];
1114   uint64_t iv;
1115   uint16_t type;
1116
1117   LOG (GNUNET_ERROR_TYPE_DEBUG, "Send on Tunnel %s\n", GMP_2s (t->peer));
1118
1119   iv = GNUNET_CRYPTO_random_u64 (GNUNET_CRYPTO_QUALITY_NONCE, UINT64_MAX);
1120   msg = (struct GNUNET_MESH_Encrypted *) cbuf;
1121   msg->header.type = htons (GNUNET_MESSAGE_TYPE_MESH_ENCRYPTED);
1122   msg->header.size = htons (sizeof (struct GNUNET_MESH_Encrypted) + size);
1123   msg->iv = GNUNET_htonll (iv);
1124   GMT_encrypt (t, &msg[1], message, size, iv, fwd);
1125   c = tunnel_get_connection (t, fwd);
1126   if (NULL == c)
1127   {
1128     GNUNET_break (GNUNET_YES == t->destroy);
1129     return;
1130   }
1131   type = ntohs (message->type);
1132   switch (type)
1133   {
1134     case GNUNET_MESSAGE_TYPE_MESH_FWD:
1135     case GNUNET_MESSAGE_TYPE_MESH_BCK:
1136     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_CREATE:
1137     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_DESTROY:
1138       msg->cid = *GMC_get_id (c);
1139       msg->ttl = htonl (default_ttl);
1140       break;
1141     default:
1142       LOG (GNUNET_ERROR_TYPE_DEBUG, "unkown type %s\n",
1143            GNUNET_MESH_DEBUG_M2S (type));
1144       GNUNET_break (0);
1145   }
1146   msg->reserved = 0;
1147
1148   GMC_send_prebuilt_message (&msg->header, c, ch, fwd);
1149 }
1150
1151 /**
1152  * Is the tunnel directed towards the local peer?
1153  *
1154  * @param t Tunnel.
1155  *
1156  * @return GNUNET_YES if it is loopback.
1157  */
1158 int
1159 GMT_is_loopback (const struct MeshTunnel3 *t)
1160 {
1161   return (my_short_id == GMP_get_short_id(t->peer));
1162 }
1163
1164
1165 /**
1166  * Get the static string for the peer this tunnel is directed.
1167  *
1168  * @param t Tunnel.
1169  *
1170  * @return Static string the destination peer's ID.
1171  */
1172 const char *
1173 GMT_2s (const struct MeshTunnel3 *t)
1174 {
1175   return GMP_2s (t->peer);
1176 }