src/mesh/gnunet-service-mesh_peer.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
  22 #include "platform.h"
  23 #include "gnunet_util_lib.h"
  24
  25 #include "gnunet_core_service.h"
  26 #include "gnunet_statistics_service.h"
  27
  28 #include "mesh_protocol_enc.h"
  29
  30 #include "gnunet-service-mesh_peer.h"
  31 #include "gnunet-service-mesh_dht.h"
  32 #include "gnunet-service-mesh_connection.h"
  33 #include "gnunet-service-mesh_tunnel.h"
  34 #include "mesh_path.h"
  35
  36 #define LOG(level, ...) GNUNET_log_from (level,"mesh-p2p",__VA_ARGS__)
  37
  38 /******************************************************************************/
  39 /********************************   STRUCTS  **********************************/
  40 /******************************************************************************/
  41
  42 /**
  43  * Struct containing info about a queued transmission to this peer
  44  */
  45 struct MeshPeerQueue
  46 {
  47     /**
  48       * DLL next
  49       */
  50   struct MeshPeerQueue *next;
  51
  52     /**
  53       * DLL previous
  54       */
  55   struct MeshPeerQueue *prev;
  56
  57     /**
  58      * Peer this transmission is directed to.
  59      */
  60   struct MeshPeer *peer;
  61
  62     /**
  63      * Connection this message belongs to.
  64      */
  65   struct MeshConnection *c;
  66
  67     /**
  68      * Is FWD in c?
  69      */
  70   int fwd;
  71
  72     /**
  73      * Pointer to info stucture used as cls.
  74      */
  75   void *cls;
  76
  77     /**
  78      * Type of message
  79      */
  80   uint16_t type;
  81
  82     /**
  83      * Size of the message
  84      */
  85   size_t size;
  86
  87     /**
  88      * Set when this message starts waiting for CORE.
  89      */
  90   struct GNUNET_TIME_Absolute start_waiting;
  91
  92     /**
  93      * Function to call on sending.
  94      */
  95   GMP_sent callback;
  96
  97     /**
  98      * Closure for callback.
  99      */
 100   void *callback_cls;
 101 };
 102
 103 /**
 104  * Struct containing all information regarding a given peer
 105  */
 106 struct MeshPeer
 107 {
 108     /**
 109      * ID of the peer
 110      */
 111   GNUNET_PEER_Id id;
 112
 113     /**
 114      * Last time we heard from this peer
 115      */
 116   struct GNUNET_TIME_Absolute last_contact;
 117
 118     /**
 119      * Paths to reach the peer, ordered by ascending hop count
 120      */
 121   struct MeshPeerPath *path_head;
 122
 123     /**
 124      * Paths to reach the peer, ordered by ascending hop count
 125      */
 126   struct MeshPeerPath *path_tail;
 127
 128     /**
 129      * Handle to stop the DHT search for paths to this peer
 130      */
 131   struct GMD_search_handle *search_h;
 132
 133     /**
 134      * Tunnel to this peer, if any.
 135      */
 136   struct MeshTunnel3 *tunnel;
 137
 138     /**
 139      * Connections that go through this peer, indexed by tid;
 140      */
 141   struct GNUNET_CONTAINER_MultiHashMap *connections;
 142
 143     /**
 144      * Handle for queued transmissions
 145      */
 146   struct GNUNET_CORE_TransmitHandle *core_transmit;
 147
 148   /**
 149    * Transmission queue to core DLL head
 150    */
 151   struct MeshPeerQueue *queue_head;
 152
 153   /**
 154    * Transmission queue to core DLL tail
 155    */
 156   struct MeshPeerQueue *queue_tail;
 157
 158   /**
 159    * How many messages are in the queue to this peer.
 160    */
 161   unsigned int queue_n;
 162 };
 163
 164
 165 /******************************************************************************/
 166 /*******************************   GLOBALS  ***********************************/
 167 /******************************************************************************/
 168
 169 /**
 170  * Global handle to the statistics service.
 171  */
 172 extern struct GNUNET_STATISTICS_Handle *stats;
 173
 174 /**
 175  * Local peer own ID (full value).
 176  */
 177 extern struct GNUNET_PeerIdentity my_full_id;
 178
 179 /**
 180  * Local peer own ID (short)
 181  */
 182 extern GNUNET_PEER_Id myid;
 183
 184 /**
 185  * Peers known, indexed by PeerIdentity (MeshPeer).
 186  */
 187 static struct GNUNET_CONTAINER_MultiPeerMap *peers;
 188
 189 /**
 190  * How many peers do we want to remember?
 191  */
 192 static unsigned long long max_peers;
 193
 194 /**
 195  * Percentage of messages that will be dropped (for test purposes only).
 196  */
 197 static unsigned long long drop_percent;
 198
 199 /**
 200  * Handle to communicate with core.
 201  */
 202 static struct GNUNET_CORE_Handle *core_handle;
 203
 204
 205 /******************************************************************************/
 206 /***************************** CORE CALLBACKS *********************************/
 207 /******************************************************************************/
 208
 209
 210 /**
 211  * Iterator to notify all connections of a broken link. Mark connections
 212  * to destroy after all traffic has been sent.
 213  *
 214  * @param cls Closure (peer disconnected).
 215  * @param key Current key code (peer id).
 216  * @param value Value in the hash map (connection).
 217  *
 218  * @return #GNUNET_YES to continue to iterate.
 219  */
 220 static int
 221 notify_broken (void *cls,
 222                const struct GNUNET_HashCode *key,
 223                void *value)
 224 {
 225   struct MeshPeer *peer = cls;
 226   struct MeshConnection *c = value;
 227
 228   GMC_notify_broken (c, peer);
 229
 230   return GNUNET_YES;
 231 }
 232
 233
 234 /**
 235  * Method called whenever a given peer connects.
 236  *
 237  * @param cls closure
 238  * @param peer peer identity this notification is about
 239  */
 240 static void
 241 core_connect (void *cls, const struct GNUNET_PeerIdentity *peer)
 242 {
 243   struct MeshPeer *mp;
 244   struct MeshPeerPath *path;
 245
 246   LOG (GNUNET_ERROR_TYPE_DEBUG, "Peer connected\n");
 247   LOG (GNUNET_ERROR_TYPE_DEBUG, "     %s\n", GNUNET_i2s (&my_full_id));
 248   mp = GMP_get (peer);
 249   if (myid == mp->id)
 250   {
 251     LOG (GNUNET_ERROR_TYPE_DEBUG, "     (self)\n");
 252     path = path_new (1);
 253   }
 254   else
 255   {
 256     LOG (GNUNET_ERROR_TYPE_DEBUG, "     %s\n", GNUNET_i2s (peer));
 257     path = path_new (2);
 258     path->peers[1] = mp->id;
 259     GNUNET_PEER_change_rc (mp->id, 1);
 260     GNUNET_STATISTICS_update (stats, "# peers", 1, GNUNET_NO);
 261   }
 262   path->peers[0] = myid;
 263   GNUNET_PEER_change_rc (myid, 1);
 264   GMP_add_path (mp, path, GNUNET_YES);
 265
 266   mp->connections = GNUNET_CONTAINER_multihashmap_create (32, GNUNET_YES);
 267   return;
 268 }
 269
 270
 271 /**
 272  * Method called whenever a peer disconnects.
 273  *
 274  * @param cls closure
 275  * @param peer peer identity this notification is about
 276  */
 277 static void
 278 core_disconnect (void *cls, const struct GNUNET_PeerIdentity *peer)
 279 {
 280   struct MeshPeer *pi;
 281
 282   LOG (GNUNET_ERROR_TYPE_DEBUG, "Peer disconnected\n");
 283   pi = GNUNET_CONTAINER_multipeermap_get (peers, peer);
 284   if (NULL == pi)
 285   {
 286     GNUNET_break (0);
 287     return;
 288   }
 289
 290   GNUNET_CONTAINER_multihashmap_iterate (pi->connections, &notify_broken, pi);
 291   GNUNET_CONTAINER_multihashmap_destroy (pi->connections);
 292   pi->connections = NULL;
 293   if (NULL != pi->core_transmit)
 294     {
 295       GNUNET_CORE_notify_transmit_ready_cancel (pi->core_transmit);
 296       pi->core_transmit = NULL;
 297     }
 298   if (myid == pi->id)
 299   {
 300     LOG (GNUNET_ERROR_TYPE_DEBUG, "     (self)\n");
 301   }
 302   GNUNET_STATISTICS_update (stats, "# peers", -1, GNUNET_NO);
 303
 304   return;
 305 }
 306
 307
 308 /**
 309  * Functions to handle messages from core
 310  */
 311 static struct GNUNET_CORE_MessageHandler core_handlers[] = {
 312   {&GMC_handle_create, GNUNET_MESSAGE_TYPE_MESH_CONNECTION_CREATE,
 313     0},
 314   {&GMC_handle_confirm, GNUNET_MESSAGE_TYPE_MESH_CONNECTION_ACK,
 315     sizeof (struct GNUNET_MESH_ConnectionACK)},
 316   {&GMC_handle_broken, GNUNET_MESSAGE_TYPE_MESH_CONNECTION_BROKEN,
 317     sizeof (struct GNUNET_MESH_ConnectionBroken)},
 318   {&GMC_handle_destroy, GNUNET_MESSAGE_TYPE_MESH_CONNECTION_DESTROY,
 319     sizeof (struct GNUNET_MESH_ConnectionDestroy)},
 320   {&GMC_handle_keepalive, GNUNET_MESSAGE_TYPE_MESH_FWD_KEEPALIVE,
 321     sizeof (struct GNUNET_MESH_ConnectionKeepAlive)},
 322   {&GMC_handle_keepalive, GNUNET_MESSAGE_TYPE_MESH_BCK_KEEPALIVE,
 323     sizeof (struct GNUNET_MESH_ConnectionKeepAlive)},
 324   {&GMC_handle_ack, GNUNET_MESSAGE_TYPE_MESH_ACK,
 325     sizeof (struct GNUNET_MESH_ACK)},
 326   {&GMC_handle_poll, GNUNET_MESSAGE_TYPE_MESH_POLL,
 327     sizeof (struct GNUNET_MESH_Poll)},
 328   {&GMC_handle_encrypted, GNUNET_MESSAGE_TYPE_MESH_ENCRYPTED, 0},
 329   {&GMC_handle_kx, GNUNET_MESSAGE_TYPE_MESH_KX, 0},
 330   {NULL, 0, 0}
 331 };
 332
 333
 334 /**
 335  * To be called on core init/fail.
 336  *
 337  * @param cls Closure (config)
 338  * @param identity the public identity of this peer
 339  */
 340 static void
 341 core_init (void *cls,
 342            const struct GNUNET_PeerIdentity *identity)
 343 {
 344   const struct GNUNET_CONFIGURATION_Handle *c = cls;
 345   static int i = 0;
 346
 347   LOG (GNUNET_ERROR_TYPE_DEBUG, "Core init\n");
 348   if (0 != memcmp (identity, &my_full_id, sizeof (my_full_id)))
 349   {
 350     LOG (GNUNET_ERROR_TYPE_ERROR, _("Wrong CORE service\n"));
 351     LOG (GNUNET_ERROR_TYPE_ERROR, " core id %s\n", GNUNET_i2s (identity));
 352     LOG (GNUNET_ERROR_TYPE_ERROR, " my id %s\n", GNUNET_i2s (&my_full_id));
 353     GNUNET_CORE_disconnect (core_handle);
 354     core_handle = GNUNET_CORE_connect (c, /* Main configuration */
 355                                        NULL,      /* Closure passed to MESH functions */
 356                                        &core_init,        /* Call core_init once connected */
 357                                        &core_connect,     /* Handle connects */
 358                                        &core_disconnect,  /* remove peers on disconnects */
 359                                        NULL,      /* Don't notify about all incoming messages */
 360                                        GNUNET_NO, /* For header only in notification */
 361                                        NULL,      /* Don't notify about all outbound messages */
 362                                        GNUNET_NO, /* For header-only out notification */
 363                                        core_handlers);    /* Register these handlers */
 364     if (10 < i++)
 365       GNUNET_abort();
 366   }
 367   GML_start ();
 368   return;
 369 }
 370
 371 /**
 372   * Core callback to write a pre-constructed data packet to core buffer
 373   *
 374   * @param cls Closure (MeshTransmissionDescriptor with data in "data" member).
 375   * @param size Number of bytes available in buf.
 376   * @param buf Where the to write the message.
 377   *
 378   * @return number of bytes written to buf
 379   */
 380 static size_t
 381 send_core_data_raw (void *cls, size_t size, void *buf)
 382 {
 383   struct GNUNET_MessageHeader *msg = cls;
 384   size_t total_size;
 385
 386   GNUNET_assert (NULL != msg);
 387   total_size = ntohs (msg->size);
 388
 389   if (total_size > size)
 390   {
 391     GNUNET_break (0);
 392     return 0;
 393   }
 394   memcpy (buf, msg, total_size);
 395   GNUNET_free (cls);
 396   return total_size;
 397 }
 398
 399
 400 /**
 401  * Function to send a create connection message to a peer.
 402  *
 403  * @param c Connection to create.
 404  * @param size number of bytes available in buf
 405  * @param buf where the callee should write the message
 406  * @return number of bytes written to buf
 407  */
 408 static size_t
 409 send_core_connection_create (struct MeshConnection *c, size_t size, void *buf)
 410 {
 411   struct GNUNET_MESH_ConnectionCreate *msg;
 412   struct GNUNET_PeerIdentity *peer_ptr;
 413   const struct MeshPeerPath *p = GMC_get_path (c);
 414   size_t size_needed;
 415   int i;
 416
 417   LOG (GNUNET_ERROR_TYPE_DEBUG, "Sending CONNECTION CREATE...\n");
 418   size_needed =
 419       sizeof (struct GNUNET_MESH_ConnectionCreate) +
 420       p->length * sizeof (struct GNUNET_PeerIdentity);
 421
 422   if (size < size_needed || NULL == buf)
 423   {
 424     GNUNET_break (0);
 425     return 0;
 426   }
 427   msg = (struct GNUNET_MESH_ConnectionCreate *) buf;
 428   msg->header.size = htons (size_needed);
 429   msg->header.type = htons (GNUNET_MESSAGE_TYPE_MESH_CONNECTION_CREATE);
 430   msg->cid = *GMC_get_id (c);
 431
 432   peer_ptr = (struct GNUNET_PeerIdentity *) &msg[1];
 433   for (i = 0; i < p->length; i++)
 434   {
 435     GNUNET_PEER_resolve (p->peers[i], peer_ptr++);
 436   }
 437
 438   LOG (GNUNET_ERROR_TYPE_DEBUG,
 439        "CONNECTION CREATE (%u bytes long) sent!\n",
 440        size_needed);
 441   return size_needed;
 442 }
 443
 444
 445 /**
 446  * Creates a path ack message in buf and frees all unused resources.
 447  *
 448  * @param c Connection to send an ACK on.
 449  * @param size number of bytes available in buf
 450  * @param buf where the callee should write the message
 451  *
 452  * @return number of bytes written to buf
 453  */
 454 static size_t
 455 send_core_connection_ack (struct MeshConnection *c, size_t size, void *buf)
 456 {
 457   struct GNUNET_MESH_ConnectionACK *msg = buf;
 458
 459   LOG (GNUNET_ERROR_TYPE_DEBUG, "Sending CONNECTION ACK...\n");
 460   if (sizeof (struct GNUNET_MESH_ConnectionACK) > size)
 461   {
 462     GNUNET_break (0);
 463     return 0;
 464   }
 465   msg->header.size = htons (sizeof (struct GNUNET_MESH_ConnectionACK));
 466   msg->header.type = htons (GNUNET_MESSAGE_TYPE_MESH_CONNECTION_ACK);
 467   msg->cid = *GMC_get_id (c);
 468   msg->reserved = 0;
 469
 470   /* TODO add signature */
 471
 472   LOG (GNUNET_ERROR_TYPE_DEBUG, "CONNECTION ACK sent!\n");
 473   return sizeof (struct GNUNET_MESH_ConnectionACK);
 474 }
 475
 476
 477 /******************************************************************************/
 478 /********************************   STATIC  ***********************************/
 479 /******************************************************************************/
 480
 481 /**
 482  * Iterator over tunnel hash map entries to destroy the tunnel during shutdown.
 483  *
 484  * @param cls closure
 485  * @param key current key code
 486  * @param value value in the hash map
 487  * @return #GNUNET_YES if we should continue to iterate,
 488  *         #GNUNET_NO if not.
 489  */
 490 static int
 491 shutdown_tunnel (void *cls,
 492                  const struct GNUNET_PeerIdentity *key,
 493                  void *value)
 494 {
 495   struct MeshPeer *p = value;
 496   struct MeshTunnel3 *t = p->tunnel;
 497
 498   if (NULL != t)
 499     GMT_destroy (t);
 500   return GNUNET_YES;
 501 }
 502
 503
 504
 505 /**
 506  * Destroy the peer_info and free any allocated resources linked to it
 507  *
 508  * @param peer The peer_info to destroy.
 509  *
 510  * @return GNUNET_OK on success
 511  */
 512 static int
 513 peer_destroy (struct MeshPeer *peer)
 514 {
 515   struct GNUNET_PeerIdentity id;
 516   struct MeshPeerPath *p;
 517   struct MeshPeerPath *nextp;
 518
 519   GNUNET_PEER_resolve (peer->id, &id);
 520   GNUNET_PEER_change_rc (peer->id, -1);
 521
 522   if (GNUNET_YES !=
 523     GNUNET_CONTAINER_multipeermap_remove (peers, &id, peer))
 524   {
 525     GNUNET_break (0);
 526     LOG (GNUNET_ERROR_TYPE_WARNING,
 527                 "removing peer %s, not in peermap\n", GNUNET_i2s (&id));
 528   }
 529   if (NULL != peer->search_h)
 530   {
 531     GMD_search_stop (peer->search_h);
 532   }
 533   p = peer->path_head;
 534   while (NULL != p)
 535   {
 536     nextp = p->next;
 537     GNUNET_CONTAINER_DLL_remove (peer->path_head, peer->path_tail, p);
 538     path_destroy (p);
 539     p = nextp;
 540   }
 541   GMT_destroy_empty (peer->tunnel);
 542   GNUNET_free (peer);
 543   return GNUNET_OK;
 544 }
 545
 546
 547 /**
 548  * Returns if peer is used (has a tunnel or is neighbor).
 549  *
 550  * @param peer Peer to check.
 551  *
 552  * @return #GNUNET_YES if peer is in use.
 553  */
 554 static int
 555 peer_is_used (struct MeshPeer *peer)
 556 {
 557   struct MeshPeerPath *p;
 558
 559   if (NULL != peer->tunnel)
 560     return GNUNET_YES;
 561
 562   for (p = peer->path_head; NULL != p; p = p->next)
 563   {
 564     if (p->length < 3)
 565       return GNUNET_YES;
 566   }
 567     return GNUNET_NO;
 568 }
 569
 570
 571 /**
 572  * Iterator over all the peers to get the oldest timestamp.
 573  *
 574  * @param cls Closure (unsued).
 575  * @param key ID of the peer.
 576  * @param value Peer_Info of the peer.
 577  */
 578 static int
 579 peer_get_oldest (void *cls,
 580                  const struct GNUNET_PeerIdentity *key,
 581                  void *value)
 582 {
 583   struct MeshPeer *p = value;
 584   struct GNUNET_TIME_Absolute *abs = cls;
 585
 586   /* Don't count active peers */
 587   if (GNUNET_YES == peer_is_used (p))
 588     return GNUNET_YES;
 589
 590   if (abs->abs_value_us < p->last_contact.abs_value_us)
 591     abs->abs_value_us = p->last_contact.abs_value_us;
 592
 593   return GNUNET_YES;
 594 }
 595
 596
 597 /**
 598  * Iterator over all the peers to remove the oldest entry.
 599  *
 600  * @param cls Closure (unsued).
 601  * @param key ID of the peer.
 602  * @param value Peer_Info of the peer.
 603  */
 604 static int
 605 peer_timeout (void *cls,
 606               const struct GNUNET_PeerIdentity *key,
 607               void *value)
 608 {
 609   struct MeshPeer *p = value;
 610   struct GNUNET_TIME_Absolute *abs = cls;
 611
 612   if (p->last_contact.abs_value_us == abs->abs_value_us &&
 613     GNUNET_NO == peer_is_used (p))
 614   {
 615     peer_destroy (p);
 616     return GNUNET_NO;
 617   }
 618     return GNUNET_YES;
 619 }
 620
 621
 622 /**
 623  * Delete oldest unused peer.
 624  */
 625 static void
 626 peer_delete_oldest (void)
 627 {
 628   struct GNUNET_TIME_Absolute abs;
 629
 630   abs = GNUNET_TIME_UNIT_FOREVER_ABS;
 631
 632   GNUNET_CONTAINER_multipeermap_iterate (peers,
 633                                          &peer_get_oldest,
 634                                          &abs);
 635   GNUNET_CONTAINER_multipeermap_iterate (peers,
 636                                          &peer_timeout,
 637                                          &abs);
 638 }
 639
 640
 641 /**
 642  * Choose the best path towards a peer considering the tunnel properties.
 643  *
 644  * @param peer The destination peer.
 645  *
 646  * @return Best current known path towards the peer, if any.
 647  */
 648 static struct MeshPeerPath *
 649 peer_get_best_path (const struct MeshPeer *peer)
 650 {
 651   struct MeshPeerPath *best_p;
 652   struct MeshPeerPath *p;
 653   unsigned int best_cost;
 654   unsigned int cost;
 655
 656   best_cost = UINT_MAX;
 657   best_p = NULL;
 658   for (p = peer->path_head; NULL != p; p = p->next)
 659   {
 660     if (GNUNET_YES == GMT_is_path_used (peer->tunnel, p))
 661       continue; /* If path is already in use, skip it. */
 662
 663     if ((cost = GMT_get_path_cost (peer->tunnel, p)) < best_cost)
 664     {
 665       best_cost = cost;
 666       best_p = p;
 667     }
 668   }
 669   return best_p;
 670 }
 671
 672
 673 static int
 674 queue_is_sendable (struct MeshPeerQueue *q)
 675 {
 676   /* Is PID-independent? */
 677   switch (q->type)
 678   {
 679     case GNUNET_MESSAGE_TYPE_MESH_ACK:
 680     case GNUNET_MESSAGE_TYPE_MESH_POLL:
 681       return GNUNET_YES;
 682   }
 683
 684   if (GMC_is_sendable (q->c, q->fwd))
 685     return GNUNET_YES;
 686
 687   return GNUNET_NO;
 688 }
 689
 690
 691 /**
 692  * Get first sendable message.
 693  *
 694  * @param peer The destination peer.
 695  *
 696  * @return Best current known path towards the peer, if any.
 697  */
 698 static struct MeshPeerQueue *
 699 peer_get_first_message (const struct MeshPeer *peer)
 700 {
 701   struct MeshPeerQueue *q;
 702
 703   for (q = peer->queue_head; NULL != q; q = q->next)
 704   {
 705     if (queue_is_sendable (q))
 706       return q;
 707   }
 708
 709   return NULL;
 710 }
 711
 712
 713 /**
 714  * Function to process paths received for a new peer addition. The recorded
 715  * paths form the initial tunnel, which can be optimized later.
 716  * Called on each result obtained for the DHT search.
 717  *
 718  * @param cls closure
 719  * @param path
 720  */
 721 static void
 722 search_handler (void *cls, const struct MeshPeerPath *path)
 723 {
 724   struct MeshPeer *peer = cls;
 725   unsigned int connection_count;
 726
 727   GMP_add_path_to_all (path, GNUNET_NO);
 728
 729   /* Count connections */
 730   connection_count = GMT_count_connections (peer->tunnel);
 731
 732   /* If we already have 3 (or more (?!)) connections, it's enough */
 733   if (3 <= connection_count)
 734     return;
 735
 736   if (MESH_TUNNEL3_SEARCHING == GMT_get_state (peer->tunnel))
 737   {
 738     LOG (GNUNET_ERROR_TYPE_DEBUG, " ... connect!\n");
 739     GMP_connect (peer);
 740   }
 741   return;
 742 }
 743
 744
 745 /**
 746  * Free a transmission that was already queued with all resources
 747  * associated to the request.
 748  *
 749  * @param queue Queue handler to cancel.
 750  * @param clear_cls Is it necessary to free associated cls?
 751  */
 752 static void
 753 queue_destroy (struct MeshPeerQueue *queue, int clear_cls)
 754 {
 755   struct MeshPeer *peer;
 756
 757   peer = queue->peer;
 758   GNUNET_assert (NULL != queue->c);
 759
 760   if (GNUNET_YES == clear_cls)
 761   {
 762     LOG (GNUNET_ERROR_TYPE_DEBUG, "#   queue destroy type %s\n",
 763                 GNUNET_MESH_DEBUG_M2S (queue->type));
 764     switch (queue->type)
 765     {
 766       case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_DESTROY:
 767       case GNUNET_MESSAGE_TYPE_MESH_TUNNEL_DESTROY:
 768         LOG (GNUNET_ERROR_TYPE_INFO, "destroying a DESTROY message\n");
 769         /* fall through */
 770       case GNUNET_MESSAGE_TYPE_MESH_ENCRYPTED:
 771       case GNUNET_MESSAGE_TYPE_MESH_ACK:
 772       case GNUNET_MESSAGE_TYPE_MESH_POLL:
 773       case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_ACK:
 774       case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_CREATE:
 775       case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_BROKEN:
 776         LOG (GNUNET_ERROR_TYPE_DEBUG, "#   prebuilt message\n");;
 777         GNUNET_free_non_null (queue->cls);
 778         break;
 779
 780       default:
 781         GNUNET_break (0);
 782         LOG (GNUNET_ERROR_TYPE_ERROR, "#   type %s unknown!\n",
 783                     GNUNET_MESH_DEBUG_M2S (queue->type));
 784     }
 785   }
 786   GNUNET_CONTAINER_DLL_remove (peer->queue_head, peer->queue_tail, queue);
 787
 788   if (queue->type != GNUNET_MESSAGE_TYPE_MESH_ACK &&
 789       queue->type != GNUNET_MESSAGE_TYPE_MESH_POLL)
 790   {
 791     peer->queue_n--;
 792   }
 793
 794   if (NULL != queue->callback)
 795   {
 796     LOG (GNUNET_ERROR_TYPE_DEBUG, "#   Calling callback\n");
 797     queue->callback (queue->callback_cls,
 798                      queue->c, queue->type,
 799                      queue->fwd, queue->size,
 800                      GNUNET_TIME_absolute_get_duration (queue->start_waiting));
 801   }
 802
 803   GNUNET_free (queue);
 804 }
 805
 806 /**
 807  * Core callback to write a queued packet to core buffer
 808  *
 809  * @param cls Closure (peer info).
 810  * @param size Number of bytes available in buf.
 811  * @param buf Where the to write the message.
 812  *
 813  * @return number of bytes written to buf
 814  */
 815 static size_t
 816 queue_send (void *cls, size_t size, void *buf)
 817 {
 818   struct MeshPeer *peer = cls;
 819   struct MeshConnection *c;
 820   struct MeshPeerQueue *queue;
 821   const struct GNUNET_PeerIdentity *dst_id;
 822   size_t data_size;
 823
 824   peer->core_transmit = NULL;
 825   LOG (GNUNET_ERROR_TYPE_DEBUG, "* Queue send (max %u)\n", size);
 826
 827   if (NULL == buf || 0 == size)
 828   {
 829     LOG (GNUNET_ERROR_TYPE_DEBUG, "* Buffer size 0.\n");
 830     return 0;
 831   }
 832
 833   /* Initialize */
 834   queue = peer_get_first_message (peer);
 835   if (NULL == queue)
 836   {
 837     GNUNET_break (0); /* Core tmt_rdy should've been canceled */
 838     return 0;
 839   }
 840   c = queue->c;
 841
 842   dst_id = GNUNET_PEER_resolve2 (peer->id);
 843   LOG (GNUNET_ERROR_TYPE_DEBUG, "*   towards %s\n", GNUNET_i2s (dst_id));
 844   /* Check if buffer size is enough for the message */
 845   if (queue->size > size)
 846   {
 847       LOG (GNUNET_ERROR_TYPE_DEBUG, "*   not enough room, reissue\n");
 848       peer->core_transmit =
 849           GNUNET_CORE_notify_transmit_ready (core_handle,
 850                                              GNUNET_NO,
 851                                              0,
 852                                              GNUNET_TIME_UNIT_FOREVER_REL,
 853                                              dst_id,
 854                                              queue->size,
 855                                              &queue_send,
 856                                              peer);
 857       return 0;
 858   }
 859   LOG (GNUNET_ERROR_TYPE_DEBUG, "*   size %u ok\n", queue->size);
 860
 861   /* Fill buf */
 862   switch (queue->type)
 863   {
 864     case GNUNET_MESSAGE_TYPE_MESH_TUNNEL_DESTROY:
 865     case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_DESTROY:
 866     case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_BROKEN:
 867     case GNUNET_MESSAGE_TYPE_MESH_ENCRYPTED:
 868     case GNUNET_MESSAGE_TYPE_MESH_ACK:
 869     case GNUNET_MESSAGE_TYPE_MESH_POLL:
 870       LOG (GNUNET_ERROR_TYPE_DEBUG,
 871                   "*   raw: %s\n",
 872                   GNUNET_MESH_DEBUG_M2S (queue->type));
 873       data_size = send_core_data_raw (queue->cls, size, buf);
 874       break;
 875     case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_CREATE:
 876       LOG (GNUNET_ERROR_TYPE_DEBUG, "*   path create\n");
 877       if (GMC_is_origin (c, GNUNET_YES))
 878         data_size = send_core_connection_create (queue->c, size, buf);
 879       else
 880         data_size = send_core_data_raw (queue->cls, size, buf);
 881       break;
 882     case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_ACK:
 883       LOG (GNUNET_ERROR_TYPE_DEBUG, "*   path ack\n");
 884       if (GMC_is_origin (c, GNUNET_NO) ||
 885           GMC_is_origin (c, GNUNET_YES))
 886         data_size = send_core_connection_ack (queue->c, size, buf);
 887       else
 888         data_size = send_core_data_raw (queue->cls, size, buf);
 889       break;
 890     case GNUNET_MESSAGE_TYPE_MESH_DATA:
 891     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_CREATE:
 892     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_DESTROY:
 893       /* This should be encapsulted */
 894       GNUNET_break (0);
 895       data_size = 0;
 896       break;
 897     default:
 898       GNUNET_break (0);
 899       LOG (GNUNET_ERROR_TYPE_WARNING, "*   type unknown: %u\n",
 900                   queue->type);
 901       data_size = 0;
 902   }
 903
 904   if (0 < drop_percent &&
 905       GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_WEAK, 101) < drop_percent)
 906   {
 907     LOG (GNUNET_ERROR_TYPE_WARNING,
 908                 "Dropping message of type %s\n",
 909                 GNUNET_MESH_DEBUG_M2S (queue->type));
 910     data_size = 0;
 911   }
 912
 913   /* Free queue, but cls was freed by send_core_* */
 914   queue_destroy (queue, GNUNET_NO);
 915
 916   /* If more data in queue, send next */
 917   queue = peer_get_first_message (peer);
 918   if (NULL != queue)
 919   {
 920     LOG (GNUNET_ERROR_TYPE_DEBUG, "*   more data!\n");
 921     if (NULL == peer->core_transmit)
 922     {
 923       peer->core_transmit =
 924           GNUNET_CORE_notify_transmit_ready(core_handle,
 925                                             0,
 926                                             0,
 927                                             GNUNET_TIME_UNIT_FOREVER_REL,
 928                                             dst_id,
 929                                             queue->size,
 930                                             &queue_send,
 931                                             peer);
 932       queue->start_waiting = GNUNET_TIME_absolute_get ();
 933     }
 934     else
 935     {
 936       LOG (GNUNET_ERROR_TYPE_DEBUG,
 937                   "*   tmt rdy called somewhere else\n");
 938     }
 939 //     GMC_start_poll (); FIXME needed?
 940   }
 941   else
 942   {
 943 //     GMC_stop_poll(); FIXME needed?
 944   }
 945
 946   LOG (GNUNET_ERROR_TYPE_DEBUG, "*  Return %d\n", data_size);
 947   return data_size;
 948 }
 949
 950
 951 /******************************************************************************/
 952 /********************************    API    ***********************************/
 953 /******************************************************************************/
 954
 955 /**
 956  * @brief Queue and pass message to core when possible.
 957  *
 958  * @param peer Peer towards which to queue the message.
 959  * @param cls Closure (@c type dependant). It will be used by queue_send to
 960  *            build the message to be sent if not already prebuilt.
 961  * @param type Type of the message, 0 for a raw message.
 962  * @param size Size of the message.
 963  * @param c Connection this message belongs to (cannot be NULL).
 964  * @param fwd Is this a message going root->dest? (FWD ACK are NOT FWD!)
 965  * @param cont Continuation to be called once CORE has taken the message.
 966  * @param cont_cls Closure for @c cont.
 967  */
 968 void
 969 GMP_queue_add (struct MeshPeer *peer, void *cls, uint16_t type, size_t size,
 970                struct MeshConnection *c, int fwd,
 971                GMP_sent cont, void *cont_cls)
 972 {
 973   struct MeshPeerQueue *queue;
 974   int priority;
 975   int call_core;
 976
 977   LOG (GNUNET_ERROR_TYPE_DEBUG,
 978        "queue add %s %s towards %s (size %u) on c %p (%s)\n",
 979        fwd ? "FWD" : "BCK",  GNUNET_MESH_DEBUG_M2S (type), GMP_2s(peer),
 980        size, c, GMC_2s (c));
 981   GNUNET_assert (NULL != c);
 982
 983   if (NULL == peer->connections)
 984   {
 985     /* We are not connected to this peer, ignore request. */
 986     GNUNET_break_op (0);
 987     return;
 988   }
 989
 990   priority = 0;
 991
 992   if (GNUNET_MESSAGE_TYPE_MESH_POLL == type ||
 993       GNUNET_MESSAGE_TYPE_MESH_ACK == type)
 994   {
 995     priority = 100;
 996   }
 997
 998   LOG (GNUNET_ERROR_TYPE_DEBUG, "priority %d\n", priority);
 999
1000   call_core = GMC_is_sendable (c, fwd);
1001   queue = GNUNET_malloc (sizeof (struct MeshPeerQueue));
1002   queue->cls = cls;
1003   queue->type = type;
1004   queue->size = size;
1005   queue->peer = peer;
1006   queue->c = c;
1007   queue->fwd = fwd;
1008   queue->callback = cont;
1009   queue->callback_cls = cont_cls;
1010   if (100 <= priority)
1011   {
1012     struct MeshPeerQueue *copy;
1013     struct MeshPeerQueue *next;
1014
1015     for (copy = peer->queue_head; NULL != copy; copy = next)
1016     {
1017       next = copy->next;
1018       if (copy->type == type && copy->c == c && copy->fwd == fwd)
1019       {
1020         /* Example: also a FWD ACK for connection XYZ */
1021         queue_destroy (copy, GNUNET_YES);
1022       }
1023     }
1024     GNUNET_CONTAINER_DLL_insert (peer->queue_head, peer->queue_tail, queue);
1025   }
1026   else
1027   {
1028     GNUNET_CONTAINER_DLL_insert_tail (peer->queue_head, peer->queue_tail, queue);
1029     peer->queue_n++;
1030   }
1031
1032   if (NULL == peer->core_transmit && GNUNET_YES == call_core)
1033   {
1034     LOG (GNUNET_ERROR_TYPE_DEBUG,
1035                 "calling core tmt rdy towards %s for %u bytes\n",
1036                 GMP_2s (peer), size);
1037     peer->core_transmit =
1038         GNUNET_CORE_notify_transmit_ready (core_handle,
1039                                            0,
1040                                            0,
1041                                            GNUNET_TIME_UNIT_FOREVER_REL,
1042                                            GNUNET_PEER_resolve2 (peer->id),
1043                                            size,
1044                                            &queue_send,
1045                                            peer);
1046     queue->start_waiting = GNUNET_TIME_absolute_get ();
1047   }
1048   else
1049   {
1050     LOG (GNUNET_ERROR_TYPE_DEBUG,
1051                 "core tmt rdy towards %s already called\n",
1052                 GMP_2s (peer));
1053
1054   }
1055 }
1056
1057
1058 /**
1059  * Cancel all queued messages to a peer that belong to a certain connection.
1060  *
1061  * @param peer Peer towards whom to cancel.
1062  * @param c Connection whose queued messages to cancel. Might be destroyed by
1063  *          the sent continuation call.
1064  */
1065 void
1066 GMP_queue_cancel (struct MeshPeer *peer, struct MeshConnection *c)
1067 {
1068   struct MeshPeerQueue *q;
1069   struct MeshPeerQueue *next;
1070   struct MeshPeerQueue *prev;
1071
1072   for (q = peer->queue_head; NULL != q; q = next)
1073   {
1074     prev = q->prev;
1075     if (q->c == c)
1076     {
1077       LOG (GNUNET_ERROR_TYPE_DEBUG,
1078                   "GMP_cancel_queue %s\n",
1079                   GNUNET_MESH_DEBUG_M2S (q->type));
1080       queue_destroy (q, GNUNET_YES);
1081
1082       /* Get next from prev, q->next might be already freed:
1083        * queue destroy -> callback -> GMC_destroy -> cancel_queues -> here
1084        */
1085       if (NULL == prev)
1086         next = peer->queue_head;
1087       else
1088         next = prev->next;
1089     }
1090     else
1091     {
1092       next = q->next;
1093     }
1094   }
1095   if (NULL == peer->queue_head)
1096   {
1097     if (NULL != peer->core_transmit)
1098     {
1099       GNUNET_CORE_notify_transmit_ready_cancel (peer->core_transmit);
1100       peer->core_transmit = NULL;
1101     }
1102   }
1103 }
1104
1105
1106 /**
1107  * Get the first transmittable message for a connection.
1108  *
1109  * @param peer Neighboring peer.
1110  * @param c Connection.
1111  *
1112  * @return First transmittable message.
1113  */
1114 static struct MeshPeerQueue *
1115 connection_get_first_message (struct MeshPeer *peer, struct MeshConnection *c)
1116 {
1117   struct MeshPeerQueue *q;
1118
1119   for (q = peer->queue_head; NULL != q; q = q->next)
1120   {
1121     if (q->c != c)
1122       continue;
1123     if (queue_is_sendable (q))
1124       return q;
1125   }
1126
1127   return NULL;
1128 }
1129
1130 void
1131 GMP_queue_unlock (struct MeshPeer *peer, struct MeshConnection *c)
1132 {
1133   struct MeshPeerQueue *q;
1134   size_t size;
1135
1136   if (NULL != peer->core_transmit)
1137   {
1138     LOG (GNUNET_ERROR_TYPE_DEBUG, "  already unlocked!\n");
1139     return; /* Already unlocked */
1140   }
1141
1142   q = connection_get_first_message (peer, c);
1143   if (NULL == q)
1144   {
1145     LOG (GNUNET_ERROR_TYPE_DEBUG, "  queue empty!\n");
1146     return; /* Nothing to transmit */
1147   }
1148
1149   size = q->size;
1150   peer->core_transmit =
1151       GNUNET_CORE_notify_transmit_ready (core_handle,
1152                                          GNUNET_NO,
1153                                          0,
1154                                          GNUNET_TIME_UNIT_FOREVER_REL,
1155                                          GNUNET_PEER_resolve2 (peer->id),
1156                                          size,
1157                                          &queue_send,
1158                                          peer);
1159 }
1160
1161
1162 /**
1163  * Initialize the peer subsystem.
1164  *
1165  * @param c Configuration.
1166  */
1167 void
1168 GMP_init (const struct GNUNET_CONFIGURATION_Handle *c)
1169 {
1170   LOG (GNUNET_ERROR_TYPE_DEBUG, "init\n");
1171   peers = GNUNET_CONTAINER_multipeermap_create (128, GNUNET_NO);
1172   if (GNUNET_OK !=
1173       GNUNET_CONFIGURATION_get_value_number (c, "MESH", "MAX_PEERS",
1174                                              &max_peers))
1175   {
1176     GNUNET_log_config_invalid (GNUNET_ERROR_TYPE_WARNING,
1177                                "MESH", "MAX_PEERS", "USING DEFAULT");
1178     max_peers = 1000;
1179   }
1180
1181   if (GNUNET_OK !=
1182       GNUNET_CONFIGURATION_get_value_number (c, "MESH", "DROP_PERCENT",
1183                                              &drop_percent))
1184   {
1185     drop_percent = 0;
1186   }
1187   else
1188   {
1189     LOG (GNUNET_ERROR_TYPE_WARNING,
1190                 "\n***************************************\n"
1191                 "Mesh is running with drop mode enabled.\n"
1192                 "This is NOT a good idea!\n"
1193                 "Remove the DROP_PERCENT option from your configuration.\n"
1194                 "***************************************\n");
1195   }
1196
1197   core_handle = GNUNET_CORE_connect (c, /* Main configuration */
1198                                      NULL,      /* Closure passed to MESH functions */
1199                                      &core_init,        /* Call core_init once connected */
1200                                      &core_connect,     /* Handle connects */
1201                                      &core_disconnect,  /* remove peers on disconnects */
1202                                      NULL,      /* Don't notify about all incoming messages */
1203                                      GNUNET_NO, /* For header only in notification */
1204                                      NULL,      /* Don't notify about all outbound messages */
1205                                      GNUNET_NO, /* For header-only out notification */
1206                                      core_handlers);    /* Register these handlers */
1207   if (NULL == core_handle)
1208   {
1209     GNUNET_break (0);
1210     GNUNET_SCHEDULER_shutdown ();
1211     return;
1212   }
1213 }
1214
1215 /**
1216  * Shut down the peer subsystem.
1217  */
1218 void
1219 GMP_shutdown (void)
1220 {
1221   GNUNET_CONTAINER_multipeermap_iterate (peers, &shutdown_tunnel, NULL);
1222
1223   if (core_handle != NULL)
1224   {
1225     GNUNET_CORE_disconnect (core_handle);
1226     core_handle = NULL;
1227   }
1228   GNUNET_PEER_change_rc (myid, -1);
1229 }
1230
1231 /**
1232  * Retrieve the MeshPeer stucture associated with the peer, create one
1233  * and insert it in the appropriate structures if the peer is not known yet.
1234  *
1235  * @param peer_id Full identity of the peer.
1236  *
1237  * @return Existing or newly created peer structure.
1238  */
1239 struct MeshPeer *
1240 GMP_get (const struct GNUNET_PeerIdentity *peer_id)
1241 {
1242   struct MeshPeer *peer;
1243
1244   peer = GNUNET_CONTAINER_multipeermap_get (peers, peer_id);
1245   if (NULL == peer)
1246   {
1247     peer = GNUNET_new (struct MeshPeer);
1248     if (GNUNET_CONTAINER_multipeermap_size (peers) > max_peers)
1249     {
1250       peer_delete_oldest ();
1251     }
1252         GNUNET_CONTAINER_multipeermap_put (peers, peer_id, peer,
1253                                            GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST);
1254         peer->id = GNUNET_PEER_intern (peer_id);
1255   }
1256   peer->last_contact = GNUNET_TIME_absolute_get();
1257
1258   return peer;
1259 }
1260
1261
1262 /**
1263  * Retrieve the MeshPeer stucture associated with the peer, create one
1264  * and insert it in the appropriate structures if the peer is not known yet.
1265  *
1266  * @param peer Short identity of the peer.
1267  *
1268  * @return Existing or newly created peer structure.
1269  */
1270 struct MeshPeer *
1271 GMP_get_short (const GNUNET_PEER_Id peer)
1272 {
1273   return GMP_get (GNUNET_PEER_resolve2 (peer));
1274 }
1275
1276
1277 /**
1278  * Try to establish a new connection to this peer (in its tunnel).
1279  * If the peer doesn't have any path to it yet, try to get one.
1280  * If the peer already has some path, send a CREATE CONNECTION towards it.
1281  *
1282  * @param peer Peer to connect to.
1283  */
1284 void
1285 GMP_connect (struct MeshPeer *peer)
1286 {
1287   struct MeshTunnel3 *t;
1288   struct MeshPeerPath *p;
1289   struct MeshConnection *c;
1290   int rerun_search;
1291
1292   LOG (GNUNET_ERROR_TYPE_DEBUG,
1293               "peer_connect towards %s\n",
1294               GMP_2s (peer));
1295   t = peer->tunnel;
1296   c = NULL;
1297   rerun_search = GNUNET_NO;
1298
1299   if (NULL != peer->path_head)
1300   {
1301     LOG (GNUNET_ERROR_TYPE_DEBUG, "path exists\n");
1302     p = peer_get_best_path (peer);
1303     if (NULL != p)
1304     {
1305       LOG (GNUNET_ERROR_TYPE_DEBUG, "  %u hops\n", p->length);
1306       c = GMT_use_path (t, p);
1307       if (NULL == c)
1308       {
1309         /* This case can happen when the path includes a first hop that is
1310          * not yet known to be connected.
1311          *
1312          * This happens quite often during testing when running mesh
1313          * under valgrind: core connect notifications come very late and the
1314          * DHT result has already come and created a valid path.
1315          * In this case, the peer->connections hashmap will be NULL and
1316          * tunnel_use_path will not be able to create a connection from that
1317          * path.
1318          *
1319          * Re-running the DHT GET should give core time to callback.
1320          */
1321         GNUNET_break(0);
1322                 rerun_search = GNUNET_YES;
1323       }
1324       else
1325       {
1326         GMC_send_create (c);
1327         return;
1328       }
1329     }
1330   }
1331
1332   if (NULL != peer->search_h && GNUNET_YES == rerun_search)
1333   {
1334     GMD_search_stop (peer->search_h);
1335     peer->search_h = NULL;
1336     LOG (GNUNET_ERROR_TYPE_DEBUG,
1337          "  Stopping DHT GET for peer %s\n",
1338          GMP_2s (peer));
1339   }
1340
1341   if (NULL == peer->search_h)
1342   {
1343     const struct GNUNET_PeerIdentity *id;
1344
1345     id = GNUNET_PEER_resolve2 (peer->id);
1346     LOG (GNUNET_ERROR_TYPE_DEBUG,
1347                 "  Starting DHT GET for peer %s\n", GMP_2s (peer));
1348     peer->search_h = GMD_search (id, &search_handler, peer);
1349     if (MESH_TUNNEL3_NEW == GMT_get_state (t))
1350       GMT_change_state (t, MESH_TUNNEL3_SEARCHING);
1351   }
1352 }
1353
1354
1355 /**
1356  * Set tunnel.
1357  *
1358  * @param peer Peer.
1359  * @param t Tunnel.
1360  */
1361 void
1362 GMP_set_tunnel (struct MeshPeer *peer, struct MeshTunnel3 *t)
1363 {
1364   peer->tunnel = t;
1365 }
1366
1367
1368 /**
1369  * Chech whether there is a direct (core level)  connection to peer.
1370  *
1371  * @param peer Peer to check.
1372  *
1373  * @return #GNUNET_YES if there is a direct connection.
1374  */
1375 int
1376 GMP_is_neighbor (const struct MeshPeer *peer)
1377 {
1378   struct MeshPeerPath *path;
1379
1380   if (NULL == peer->connections)
1381     return GNUNET_NO;
1382
1383   for (path = peer->path_head; NULL != path; path = path->next)
1384   {
1385     if (3 > path->length)
1386       return GNUNET_YES;
1387   }
1388
1389   GNUNET_break (0); /* Is not a neighbor but connections is not NULL */
1390   return GNUNET_NO;
1391 }
1392
1393
1394 /**
1395  * Create and initialize a new tunnel towards a peer, in case it has none.
1396  * In case the peer already has a tunnel, nothing is done.
1397  *
1398  * Does not generate any traffic, just creates the local data structures.
1399  *
1400  * @param peer Peer towards which to create the tunnel.
1401  */
1402 void
1403 GMP_add_tunnel (struct MeshPeer *peer)
1404 {
1405   if (NULL != peer->tunnel)
1406     return;
1407   peer->tunnel = GMT_new (peer);
1408 }
1409
1410
1411 /**
1412  * Add a connection to a neighboring peer.
1413  *
1414  * Store that the peer is the first hop of the connection in one
1415  * direction and that on peer disconnect the connection must be
1416  * notified and destroyed, for it will no longer be valid.
1417  *
1418  * @param peer Peer to add connection to.
1419  * @param c Connection to add.
1420  *
1421  * @return GNUNET_OK on success.
1422  */
1423 int
1424 GMP_add_connection (struct MeshPeer *peer,
1425                     struct MeshConnection *c)
1426 {
1427   if (NULL == peer->connections)
1428   {
1429     GNUNET_break (0);
1430     return GNUNET_SYSERR;
1431   }
1432   return GNUNET_CONTAINER_multihashmap_put (peer->connections,
1433                                             GMC_get_id (c),
1434                                             c,
1435                                             GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST);
1436 }
1437
1438
1439 /**
1440  * Add the path to the peer and update the path used to reach it in case this
1441  * is the shortest.
1442  *
1443  * @param peer Destination peer to add the path to.
1444  * @param path New path to add. Last peer must be the peer in arg 1.
1445  *             Path will be either used of freed if already known.
1446  * @param trusted Do we trust that this path is real?
1447  *
1448  * @return path if path was taken, pointer to existing duplicate if exists
1449  *         NULL on error.
1450  */
1451 struct MeshPeerPath *
1452 GMP_add_path (struct MeshPeer *peer, struct MeshPeerPath *path,
1453               int trusted)
1454 {
1455   struct MeshPeerPath *aux;
1456   unsigned int l;
1457   unsigned int l2;
1458
1459   LOG (GNUNET_ERROR_TYPE_DEBUG, "adding path [%u] to peer %s\n",
1460        path->length, GMP_2s (peer));
1461
1462   if ((NULL == peer) || (NULL == path))
1463   {
1464     GNUNET_break (0);
1465     path_destroy (path);
1466     return NULL;
1467   }
1468   if (path->peers[path->length - 1] != peer->id)
1469   {
1470     GNUNET_break (0);
1471     path_destroy (path);
1472     return NULL;
1473   }
1474   if (2 >= path->length && GNUNET_NO == trusted)
1475   {
1476     /* Only allow CORE to tell us about direct paths */
1477     path_destroy (path);
1478     return NULL;
1479   }
1480   for (l = 1; l < path->length; l++)
1481   {
1482     if (path->peers[l] == myid)
1483     {
1484       LOG (GNUNET_ERROR_TYPE_DEBUG, "shortening path by %u\n", l);
1485       for (l2 = 0; l2 < path->length - l; l2++)
1486       {
1487         path->peers[l2] = path->peers[l + l2];
1488       }
1489       path->length -= l;
1490       l = 1;
1491       path->peers = GNUNET_realloc (path->peers,
1492                                     path->length * sizeof (GNUNET_PEER_Id));
1493     }
1494   }
1495
1496   LOG (GNUNET_ERROR_TYPE_DEBUG, "adding path [%u]\n", path->length);
1497
1498   l = path_get_length (path);
1499   if (0 == l)
1500   {
1501     path_destroy (path);
1502     return NULL;
1503   }
1504
1505   GNUNET_assert (peer->id == path->peers[path->length - 1]);
1506   for (aux = peer->path_head; aux != NULL; aux = aux->next)
1507   {
1508     l2 = path_get_length (aux);
1509     if (l2 > l)
1510     {
1511       LOG (GNUNET_ERROR_TYPE_DEBUG, "  added\n");
1512       GNUNET_CONTAINER_DLL_insert_before (peer->path_head,
1513                                           peer->path_tail, aux, path);
1514       return path;
1515     }
1516     else
1517     {
1518       if (l2 == l && memcmp (path->peers, aux->peers, l) == 0)
1519       {
1520         LOG (GNUNET_ERROR_TYPE_DEBUG, "  already known\n");
1521         path_destroy (path);
1522         return aux;
1523       }
1524     }
1525   }
1526   GNUNET_CONTAINER_DLL_insert_tail (peer->path_head, peer->path_tail,
1527                                     path);
1528   LOG (GNUNET_ERROR_TYPE_DEBUG, "  added last\n");
1529   return path;
1530 }
1531
1532
1533 /**
1534  * Add the path to the origin peer and update the path used to reach it in case
1535  * this is the shortest.
1536  * The path is given in peer_info -> destination, therefore we turn the path
1537  * upside down first.
1538  *
1539  * @param peer Peer to add the path to, being the origin of the path.
1540  * @param path New path to add after being inversed.
1541  *             Path will be either used or freed.
1542  * @param trusted Do we trust that this path is real?
1543  *
1544  * @return path if path was taken, pointer to existing duplicate if exists
1545  *         NULL on error.
1546  */
1547 struct MeshPeerPath *
1548 GMP_add_path_to_origin (struct MeshPeer *peer,
1549                         struct MeshPeerPath *path,
1550                         int trusted)
1551 {
1552   if (NULL == path)
1553     return NULL;
1554   path_invert (path);
1555   return GMP_add_path (peer, path, trusted);
1556 }
1557
1558
1559 /**
1560  * Adds a path to the info of all the peers in the path
1561  *
1562  * @param p Path to process.
1563  * @param confirmed Whether we know if the path works or not.
1564  */
1565 void
1566 GMP_add_path_to_all (const struct MeshPeerPath *p, int confirmed)
1567 {
1568   unsigned int i;
1569
1570   /* TODO: invert and add */
1571   for (i = 0; i < p->length && p->peers[i] != myid; i++) /* skip'em */ ;
1572   for (i++; i < p->length; i++)
1573   {
1574     struct MeshPeer *aux;
1575     struct MeshPeerPath *copy;
1576
1577     aux = GMP_get_short (p->peers[i]);
1578     copy = path_duplicate (p);
1579     copy->length = i + 1;
1580     GMP_add_path (aux, copy, p->length < 3 ? GNUNET_NO : confirmed);
1581   }
1582 }
1583
1584
1585 /**
1586  * Remove a connection from a neighboring peer.
1587  *
1588  * @param peer Peer to remove connection from.
1589  * @param c Connection to remove.
1590  *
1591  * @return GNUNET_OK on success.
1592  */
1593 int
1594 GMP_remove_connection (struct MeshPeer *peer,
1595                        const struct MeshConnection *c)
1596 {
1597   if (NULL == peer || NULL == peer->connections)
1598   {
1599     GNUNET_break (0);
1600     LOG (GNUNET_ERROR_TYPE_DEBUG,
1601          "Peer %s is not a neighbor!\n",
1602          GMP_2s (peer));
1603     return GNUNET_SYSERR;
1604   }
1605   return GNUNET_CONTAINER_multihashmap_remove (peer->connections,
1606                                                GMC_get_id (c),
1607                                                c);
1608 }
1609
1610 /**
1611  * Start the DHT search for new paths towards the peer: we don't have
1612  * enough good connections.
1613  *
1614  * @param peer Destination peer.
1615  */
1616 void
1617 GMP_start_search (struct MeshPeer *peer)
1618 {
1619   if (NULL != peer->search_h)
1620   {
1621     GNUNET_break (0);
1622     return;
1623   }
1624
1625   peer->search_h = GMD_search (GMP_get_id (peer), &search_handler, peer);
1626 }
1627
1628
1629 /**
1630  * Stop the DHT search for new paths towards the peer: we already have
1631  * enough good connections.
1632  *
1633  * @param peer Destination peer.
1634  */
1635 void
1636 GMP_stop_search (struct MeshPeer *peer)
1637 {
1638   if (NULL == peer->search_h)
1639   {
1640     GNUNET_break (0);
1641     return;
1642   }
1643
1644   GMD_search_stop (peer->search_h);
1645   peer->search_h = NULL;
1646 }
1647
1648
1649 /**
1650  * Get the Full ID of a peer.
1651  *
1652  * @param peer Peer to get from.
1653  *
1654  * @return Full ID of peer.
1655  */
1656 const struct GNUNET_PeerIdentity *
1657 GMP_get_id (const struct MeshPeer *peer)
1658 {
1659   return GNUNET_PEER_resolve2 (peer->id);
1660 }
1661
1662
1663 /**
1664  * Get the Short ID of a peer.
1665  *
1666  * @param peer Peer to get from.
1667  *
1668  * @return Short ID of peer.
1669  */
1670 GNUNET_PEER_Id
1671 GMP_get_short_id (const struct MeshPeer *peer)
1672 {
1673   return peer->id;
1674 }
1675
1676
1677 /**
1678  * Get the tunnel towards a peer.
1679  *
1680  * @param peer Peer to get from.
1681  *
1682  * @return Tunnel towards peer.
1683  */
1684 struct MeshTunnel3 *
1685 GMP_get_tunnel (const struct MeshPeer *peer)
1686 {
1687   return peer->tunnel;
1688 }
1689
1690
1691 /**
1692  * Get the static string for a peer ID.
1693  *
1694  * @param peer Peer.
1695  *
1696  * @return Static string for it's ID.
1697  */
1698 const char *
1699 GMP_2s (const struct MeshPeer *peer)
1700 {
1701   if (NULL == peer)
1702     return "(NULL)";
1703   return GNUNET_i2s (GNUNET_PEER_resolve2 (peer->id));
1704 }