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  * Core callback to write a queued packet to core buffer
 747  *
 748  * @param cls Closure (peer info).
 749  * @param size Number of bytes available in buf.
 750  * @param buf Where the to write the message.
 751  *
 752  * @return number of bytes written to buf
 753  */
 754 static size_t
 755 queue_send (void *cls, size_t size, void *buf)
 756 {
 757   struct MeshPeer *peer = cls;
 758   struct MeshConnection *c;
 759   struct MeshPeerQueue *queue;
 760   const struct GNUNET_PeerIdentity *dst_id;
 761   size_t data_size;
 762
 763   peer->core_transmit = NULL;
 764   LOG (GNUNET_ERROR_TYPE_DEBUG, "* Queue send (max %u)\n", size);
 765
 766   if (NULL == buf || 0 == size)
 767   {
 768     LOG (GNUNET_ERROR_TYPE_DEBUG, "* Buffer size 0.\n");
 769     return 0;
 770   }
 771
 772   /* Initialize */
 773   queue = peer_get_first_message (peer);
 774   if (NULL == queue)
 775   {
 776     GNUNET_break (0); /* Core tmt_rdy should've been canceled */
 777     return 0;
 778   }
 779   c = queue->c;
 780
 781   dst_id = GNUNET_PEER_resolve2 (peer->id);
 782   LOG (GNUNET_ERROR_TYPE_DEBUG, "*   towards %s\n", GNUNET_i2s (dst_id));
 783   /* Check if buffer size is enough for the message */
 784   if (queue->size > size)
 785   {
 786       LOG (GNUNET_ERROR_TYPE_DEBUG, "*   not enough room, reissue\n");
 787       peer->core_transmit =
 788           GNUNET_CORE_notify_transmit_ready (core_handle,
 789                                              GNUNET_NO,
 790                                              0,
 791                                              GNUNET_TIME_UNIT_FOREVER_REL,
 792                                              dst_id,
 793                                              queue->size,
 794                                              &queue_send,
 795                                              peer);
 796       return 0;
 797   }
 798   LOG (GNUNET_ERROR_TYPE_DEBUG, "*   size %u ok\n", queue->size);
 799
 800   /* Fill buf */
 801   switch (queue->type)
 802   {
 803     case GNUNET_MESSAGE_TYPE_MESH_TUNNEL_DESTROY:
 804     case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_DESTROY:
 805     case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_BROKEN:
 806     case GNUNET_MESSAGE_TYPE_MESH_ENCRYPTED:
 807     case GNUNET_MESSAGE_TYPE_MESH_KX:
 808     case GNUNET_MESSAGE_TYPE_MESH_ACK:
 809     case GNUNET_MESSAGE_TYPE_MESH_POLL:
 810       LOG (GNUNET_ERROR_TYPE_DEBUG,
 811                   "*   raw: %s\n",
 812                   GNUNET_MESH_DEBUG_M2S (queue->type));
 813       data_size = send_core_data_raw (queue->cls, size, buf);
 814       break;
 815     case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_CREATE:
 816       LOG (GNUNET_ERROR_TYPE_DEBUG, "*   path create\n");
 817       if (GMC_is_origin (c, GNUNET_YES))
 818         data_size = send_core_connection_create (queue->c, size, buf);
 819       else
 820         data_size = send_core_data_raw (queue->cls, size, buf);
 821       break;
 822     case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_ACK:
 823       LOG (GNUNET_ERROR_TYPE_DEBUG, "*   path ack\n");
 824       if (GMC_is_origin (c, GNUNET_NO) ||
 825           GMC_is_origin (c, GNUNET_YES))
 826         data_size = send_core_connection_ack (queue->c, size, buf);
 827       else
 828         data_size = send_core_data_raw (queue->cls, size, buf);
 829       break;
 830     case GNUNET_MESSAGE_TYPE_MESH_DATA:
 831     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_CREATE:
 832     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_DESTROY:
 833       /* This should be encapsulted */
 834       GNUNET_break (0);
 835       data_size = 0;
 836       break;
 837     default:
 838       GNUNET_break (0);
 839       LOG (GNUNET_ERROR_TYPE_WARNING, "*   type unknown: %u\n",
 840                   queue->type);
 841       data_size = 0;
 842   }
 843
 844   if (0 < drop_percent &&
 845       GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_WEAK, 101) < drop_percent)
 846   {
 847     LOG (GNUNET_ERROR_TYPE_WARNING,
 848                 "Dropping message of type %s\n",
 849                 GNUNET_MESH_DEBUG_M2S (queue->type));
 850     data_size = 0;
 851   }
 852
 853   /* Free queue, but cls was freed by send_core_* */
 854   GMP_queue_destroy (queue, GNUNET_NO);
 855
 856   /* If more data in queue, send next */
 857   queue = peer_get_first_message (peer);
 858   if (NULL != queue)
 859   {
 860     LOG (GNUNET_ERROR_TYPE_DEBUG, "*   more data!\n");
 861     if (NULL == peer->core_transmit)
 862     {
 863       peer->core_transmit =
 864           GNUNET_CORE_notify_transmit_ready(core_handle,
 865                                             0,
 866                                             0,
 867                                             GNUNET_TIME_UNIT_FOREVER_REL,
 868                                             dst_id,
 869                                             queue->size,
 870                                             &queue_send,
 871                                             peer);
 872       queue->start_waiting = GNUNET_TIME_absolute_get ();
 873     }
 874     else
 875     {
 876       LOG (GNUNET_ERROR_TYPE_DEBUG,
 877                   "*   tmt rdy called somewhere else\n");
 878     }
 879 //     GMC_start_poll (); FIXME needed?
 880   }
 881   else
 882   {
 883 //     GMC_stop_poll(); FIXME needed?
 884   }
 885
 886   LOG (GNUNET_ERROR_TYPE_DEBUG, "*  Return %d\n", data_size);
 887   return data_size;
 888 }
 889
 890
 891 /******************************************************************************/
 892 /********************************    API    ***********************************/
 893 /******************************************************************************/
 894
 895
 896 /**
 897  * Free a transmission that was already queued with all resources
 898  * associated to the request.
 899  *
 900  * @param queue Queue handler to cancel.
 901  * @param clear_cls Is it necessary to free associated cls?
 902  */
 903 void
 904 GMP_queue_destroy (struct MeshPeerQueue *queue, int clear_cls)
 905 {
 906   struct MeshPeer *peer;
 907
 908   peer = queue->peer;
 909   GNUNET_assert (NULL != queue->c);
 910
 911   if (GNUNET_YES == clear_cls)
 912   {
 913     LOG (GNUNET_ERROR_TYPE_DEBUG, "#   queue destroy type %s\n",
 914                 GNUNET_MESH_DEBUG_M2S (queue->type));
 915     switch (queue->type)
 916     {
 917       case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_DESTROY:
 918       case GNUNET_MESSAGE_TYPE_MESH_TUNNEL_DESTROY:
 919         LOG (GNUNET_ERROR_TYPE_INFO, "destroying a DESTROY message\n");
 920         /* fall through */
 921       case GNUNET_MESSAGE_TYPE_MESH_ENCRYPTED:
 922       case GNUNET_MESSAGE_TYPE_MESH_ACK:
 923       case GNUNET_MESSAGE_TYPE_MESH_POLL:
 924       case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_ACK:
 925       case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_CREATE:
 926       case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_BROKEN:
 927         LOG (GNUNET_ERROR_TYPE_DEBUG, "#   prebuilt message\n");;
 928         GNUNET_free_non_null (queue->cls);
 929         break;
 930
 931       default:
 932         GNUNET_break (0);
 933         LOG (GNUNET_ERROR_TYPE_ERROR, "#   type %s unknown!\n",
 934                     GNUNET_MESH_DEBUG_M2S (queue->type));
 935     }
 936   }
 937   GNUNET_CONTAINER_DLL_remove (peer->queue_head, peer->queue_tail, queue);
 938
 939   if (queue->type != GNUNET_MESSAGE_TYPE_MESH_ACK &&
 940       queue->type != GNUNET_MESSAGE_TYPE_MESH_POLL)
 941   {
 942     peer->queue_n--;
 943   }
 944
 945   if (NULL != queue->callback)
 946   {
 947     LOG (GNUNET_ERROR_TYPE_DEBUG, "#   Calling callback\n");
 948     queue->callback (queue->callback_cls,
 949                      queue->c, queue->type,
 950                      queue->fwd, queue->size,
 951                      GNUNET_TIME_absolute_get_duration (queue->start_waiting));
 952   }
 953
 954   GNUNET_free (queue);
 955 }
 956
 957
 958 /**
 959  * @brief Queue and pass message to core when possible.
 960  *
 961  * @param peer Peer towards which to queue the message.
 962  * @param cls Closure (@c type dependant). It will be used by queue_send to
 963  *            build the message to be sent if not already prebuilt.
 964  * @param type Type of the message, 0 for a raw message.
 965  * @param size Size of the message.
 966  * @param c Connection this message belongs to (cannot be NULL).
 967  * @param fwd Is this a message going root->dest? (FWD ACK are NOT FWD!)
 968  * @param cont Continuation to be called once CORE has taken the message.
 969  * @param cont_cls Closure for @c cont.
 970  *
 971  * @return Handle to cancel the message before it is sent. Once cont is called
 972  *         message has been sent and therefore the handle is no longer valid.
 973  */
 974 struct MeshPeerQueue *
 975 GMP_queue_add (struct MeshPeer *peer, void *cls, uint16_t type, size_t size,
 976                struct MeshConnection *c, int fwd,
 977                GMP_sent cont, void *cont_cls)
 978 {
 979   struct MeshPeerQueue *queue;
 980   int priority;
 981   int call_core;
 982
 983   LOG (GNUNET_ERROR_TYPE_DEBUG,
 984        "queue add %s %s towards %s (size %u) on c %p (%s)\n",
 985        fwd ? "FWD" : "BCK",  GNUNET_MESH_DEBUG_M2S (type), GMP_2s(peer),
 986        size, c, GMC_2s (c));
 987   GNUNET_assert (NULL != c);
 988
 989   if (NULL == peer->connections)
 990   {
 991     /* We are not connected to this peer, ignore request. */
 992     GNUNET_break_op (0);
 993     return NULL;
 994   }
 995
 996   priority = 0;
 997
 998   if (GNUNET_MESSAGE_TYPE_MESH_POLL == type ||
 999       GNUNET_MESSAGE_TYPE_MESH_ACK == type)
1000   {
1001     priority = 100;
1002   }
1003
1004   LOG (GNUNET_ERROR_TYPE_DEBUG, "priority %d\n", priority);
1005
1006   call_core = GMC_is_sendable (c, fwd);
1007   queue = GNUNET_malloc (sizeof (struct MeshPeerQueue));
1008   queue->cls = cls;
1009   queue->type = type;
1010   queue->size = size;
1011   queue->peer = peer;
1012   queue->c = c;
1013   queue->fwd = fwd;
1014   queue->callback = cont;
1015   queue->callback_cls = cont_cls;
1016   if (100 > priority)
1017   {
1018     GNUNET_CONTAINER_DLL_insert_tail (peer->queue_head, peer->queue_tail, queue);
1019     peer->queue_n++;
1020   }
1021   else
1022   {
1023     GNUNET_CONTAINER_DLL_insert (peer->queue_head, peer->queue_tail, queue);
1024     call_core = GNUNET_YES;
1025   }
1026
1027   if (NULL == peer->core_transmit && GNUNET_YES == call_core)
1028   {
1029     LOG (GNUNET_ERROR_TYPE_DEBUG,
1030                 "calling core tmt rdy towards %s for %u bytes\n",
1031                 GMP_2s (peer), size);
1032     peer->core_transmit =
1033         GNUNET_CORE_notify_transmit_ready (core_handle,
1034                                            0,
1035                                            0,
1036                                            GNUNET_TIME_UNIT_FOREVER_REL,
1037                                            GNUNET_PEER_resolve2 (peer->id),
1038                                            size,
1039                                            &queue_send,
1040                                            peer);
1041     queue->start_waiting = GNUNET_TIME_absolute_get ();
1042   }
1043   else
1044   {
1045     LOG (GNUNET_ERROR_TYPE_DEBUG,
1046                 "core tmt rdy towards %s already called\n",
1047                 GMP_2s (peer));
1048
1049   }
1050   return queue;
1051 }
1052
1053
1054 /**
1055  * Cancel all queued messages to a peer that belong to a certain connection.
1056  *
1057  * @param peer Peer towards whom to cancel.
1058  * @param c Connection whose queued messages to cancel. Might be destroyed by
1059  *          the sent continuation call.
1060  */
1061 void
1062 GMP_queue_cancel (struct MeshPeer *peer, struct MeshConnection *c)
1063 {
1064   struct MeshPeerQueue *q;
1065   struct MeshPeerQueue *next;
1066   struct MeshPeerQueue *prev;
1067
1068   for (q = peer->queue_head; NULL != q; q = next)
1069   {
1070     prev = q->prev;
1071     if (q->c == c)
1072     {
1073       LOG (GNUNET_ERROR_TYPE_DEBUG,
1074                   "GMP_cancel_queue %s\n",
1075                   GNUNET_MESH_DEBUG_M2S (q->type));
1076       GMP_queue_destroy (q, GNUNET_YES);
1077
1078       /* Get next from prev, q->next might be already freed:
1079        * queue destroy -> callback -> GMC_destroy -> cancel_queues -> here
1080        */
1081       if (NULL == prev)
1082         next = peer->queue_head;
1083       else
1084         next = prev->next;
1085     }
1086     else
1087     {
1088       next = q->next;
1089     }
1090   }
1091   if (NULL == peer->queue_head)
1092   {
1093     if (NULL != peer->core_transmit)
1094     {
1095       GNUNET_CORE_notify_transmit_ready_cancel (peer->core_transmit);
1096       peer->core_transmit = NULL;
1097     }
1098   }
1099 }
1100
1101
1102 /**
1103  * Get the first transmittable message for a connection.
1104  *
1105  * @param peer Neighboring peer.
1106  * @param c Connection.
1107  *
1108  * @return First transmittable message.
1109  */
1110 static struct MeshPeerQueue *
1111 connection_get_first_message (struct MeshPeer *peer, struct MeshConnection *c)
1112 {
1113   struct MeshPeerQueue *q;
1114
1115   for (q = peer->queue_head; NULL != q; q = q->next)
1116   {
1117     if (q->c != c)
1118       continue;
1119     if (queue_is_sendable (q))
1120     {
1121       LOG (GNUNET_ERROR_TYPE_DEBUG, "  sendable!!\n");
1122       return q;
1123     }
1124     LOG (GNUNET_ERROR_TYPE_DEBUG, "  not sendable\n");
1125   }
1126
1127   return NULL;
1128 }
1129
1130
1131 void
1132 GMP_queue_unlock (struct MeshPeer *peer, struct MeshConnection *c)
1133 {
1134   struct MeshPeerQueue *q;
1135   size_t size;
1136
1137   if (NULL != peer->core_transmit)
1138   {
1139     LOG (GNUNET_ERROR_TYPE_DEBUG, "  already unlocked!\n");
1140     return; /* Already unlocked */
1141   }
1142
1143   q = connection_get_first_message (peer, c);
1144   if (NULL == q)
1145   {
1146     LOG (GNUNET_ERROR_TYPE_DEBUG, "  queue empty!\n");
1147     return; /* Nothing to transmit */
1148   }
1149
1150   size = q->size;
1151   peer->core_transmit =
1152       GNUNET_CORE_notify_transmit_ready (core_handle,
1153                                          GNUNET_NO,
1154                                          0,
1155                                          GNUNET_TIME_UNIT_FOREVER_REL,
1156                                          GNUNET_PEER_resolve2 (peer->id),
1157                                          size,
1158                                          &queue_send,
1159                                          peer);
1160 }
1161
1162
1163 /**
1164  * Initialize the peer subsystem.
1165  *
1166  * @param c Configuration.
1167  */
1168 void
1169 GMP_init (const struct GNUNET_CONFIGURATION_Handle *c)
1170 {
1171   LOG (GNUNET_ERROR_TYPE_DEBUG, "init\n");
1172   peers = GNUNET_CONTAINER_multipeermap_create (128, GNUNET_NO);
1173   if (GNUNET_OK !=
1174       GNUNET_CONFIGURATION_get_value_number (c, "MESH", "MAX_PEERS",
1175                                              &max_peers))
1176   {
1177     GNUNET_log_config_invalid (GNUNET_ERROR_TYPE_WARNING,
1178                                "MESH", "MAX_PEERS", "USING DEFAULT");
1179     max_peers = 1000;
1180   }
1181
1182   if (GNUNET_OK !=
1183       GNUNET_CONFIGURATION_get_value_number (c, "MESH", "DROP_PERCENT",
1184                                              &drop_percent))
1185   {
1186     drop_percent = 0;
1187   }
1188   else
1189   {
1190     LOG (GNUNET_ERROR_TYPE_WARNING,
1191                 "\n***************************************\n"
1192                 "Mesh is running with drop mode enabled.\n"
1193                 "This is NOT a good idea!\n"
1194                 "Remove the DROP_PERCENT option from your configuration.\n"
1195                 "***************************************\n");
1196   }
1197
1198   core_handle = GNUNET_CORE_connect (c, /* Main configuration */
1199                                      NULL,      /* Closure passed to MESH functions */
1200                                      &core_init,        /* Call core_init once connected */
1201                                      &core_connect,     /* Handle connects */
1202                                      &core_disconnect,  /* remove peers on disconnects */
1203                                      NULL,      /* Don't notify about all incoming messages */
1204                                      GNUNET_NO, /* For header only in notification */
1205                                      NULL,      /* Don't notify about all outbound messages */
1206                                      GNUNET_NO, /* For header-only out notification */
1207                                      core_handlers);    /* Register these handlers */
1208   if (NULL == core_handle)
1209   {
1210     GNUNET_break (0);
1211     GNUNET_SCHEDULER_shutdown ();
1212     return;
1213   }
1214 }
1215
1216 /**
1217  * Shut down the peer subsystem.
1218  */
1219 void
1220 GMP_shutdown (void)
1221 {
1222   GNUNET_CONTAINER_multipeermap_iterate (peers, &shutdown_tunnel, NULL);
1223
1224   if (core_handle != NULL)
1225   {
1226     GNUNET_CORE_disconnect (core_handle);
1227     core_handle = NULL;
1228   }
1229   GNUNET_PEER_change_rc (myid, -1);
1230 }
1231
1232 /**
1233  * Retrieve the MeshPeer stucture associated with the peer, create one
1234  * and insert it in the appropriate structures if the peer is not known yet.
1235  *
1236  * @param peer_id Full identity of the peer.
1237  *
1238  * @return Existing or newly created peer structure.
1239  */
1240 struct MeshPeer *
1241 GMP_get (const struct GNUNET_PeerIdentity *peer_id)
1242 {
1243   struct MeshPeer *peer;
1244
1245   peer = GNUNET_CONTAINER_multipeermap_get (peers, peer_id);
1246   if (NULL == peer)
1247   {
1248     peer = GNUNET_new (struct MeshPeer);
1249     if (GNUNET_CONTAINER_multipeermap_size (peers) > max_peers)
1250     {
1251       peer_delete_oldest ();
1252     }
1253         GNUNET_CONTAINER_multipeermap_put (peers, peer_id, peer,
1254                                            GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST);
1255         peer->id = GNUNET_PEER_intern (peer_id);
1256   }
1257   peer->last_contact = GNUNET_TIME_absolute_get();
1258
1259   return peer;
1260 }
1261
1262
1263 /**
1264  * Retrieve the MeshPeer stucture associated with the peer, create one
1265  * and insert it in the appropriate structures if the peer is not known yet.
1266  *
1267  * @param peer Short identity of the peer.
1268  *
1269  * @return Existing or newly created peer structure.
1270  */
1271 struct MeshPeer *
1272 GMP_get_short (const GNUNET_PEER_Id peer)
1273 {
1274   return GMP_get (GNUNET_PEER_resolve2 (peer));
1275 }
1276
1277
1278 /**
1279  * Try to establish a new connection to this peer (in its tunnel).
1280  * If the peer doesn't have any path to it yet, try to get one.
1281  * If the peer already has some path, send a CREATE CONNECTION towards it.
1282  *
1283  * @param peer Peer to connect to.
1284  */
1285 void
1286 GMP_connect (struct MeshPeer *peer)
1287 {
1288   struct MeshTunnel3 *t;
1289   struct MeshPeerPath *p;
1290   struct MeshConnection *c;
1291   int rerun_search;
1292
1293   LOG (GNUNET_ERROR_TYPE_DEBUG,
1294               "peer_connect towards %s\n",
1295               GMP_2s (peer));
1296   t = peer->tunnel;
1297   c = NULL;
1298   rerun_search = GNUNET_NO;
1299
1300   if (NULL != peer->path_head)
1301   {
1302     LOG (GNUNET_ERROR_TYPE_DEBUG, "path exists\n");
1303     p = peer_get_best_path (peer);
1304     if (NULL != p)
1305     {
1306       LOG (GNUNET_ERROR_TYPE_DEBUG, "  %u hops\n", p->length);
1307       c = GMT_use_path (t, p);
1308       if (NULL == c)
1309       {
1310         /* This case can happen when the path includes a first hop that is
1311          * not yet known to be connected.
1312          *
1313          * This happens quite often during testing when running mesh
1314          * under valgrind: core connect notifications come very late and the
1315          * DHT result has already come and created a valid path.
1316          * In this case, the peer->connections hashmap will be NULL and
1317          * tunnel_use_path will not be able to create a connection from that
1318          * path.
1319          *
1320          * Re-running the DHT GET should give core time to callback.
1321          */
1322         GNUNET_break(0);
1323                 rerun_search = GNUNET_YES;
1324       }
1325       else
1326       {
1327         GMC_send_create (c);
1328         return;
1329       }
1330     }
1331   }
1332
1333   if (NULL != peer->search_h && GNUNET_YES == rerun_search)
1334   {
1335     GMD_search_stop (peer->search_h);
1336     peer->search_h = NULL;
1337     LOG (GNUNET_ERROR_TYPE_DEBUG,
1338          "  Stopping DHT GET for peer %s\n",
1339          GMP_2s (peer));
1340   }
1341
1342   if (NULL == peer->search_h)
1343   {
1344     const struct GNUNET_PeerIdentity *id;
1345
1346     id = GNUNET_PEER_resolve2 (peer->id);
1347     LOG (GNUNET_ERROR_TYPE_DEBUG,
1348                 "  Starting DHT GET for peer %s\n", GMP_2s (peer));
1349     peer->search_h = GMD_search (id, &search_handler, peer);
1350     if (MESH_TUNNEL3_NEW == GMT_get_state (t))
1351       GMT_change_state (t, MESH_TUNNEL3_SEARCHING);
1352   }
1353 }
1354
1355
1356 /**
1357  * Set tunnel.
1358  *
1359  * @param peer Peer.
1360  * @param t Tunnel.
1361  */
1362 void
1363 GMP_set_tunnel (struct MeshPeer *peer, struct MeshTunnel3 *t)
1364 {
1365   peer->tunnel = t;
1366 }
1367
1368
1369 /**
1370  * Chech whether there is a direct (core level)  connection to peer.
1371  *
1372  * @param peer Peer to check.
1373  *
1374  * @return #GNUNET_YES if there is a direct connection.
1375  */
1376 int
1377 GMP_is_neighbor (const struct MeshPeer *peer)
1378 {
1379   struct MeshPeerPath *path;
1380
1381   if (NULL == peer->connections)
1382     return GNUNET_NO;
1383
1384   for (path = peer->path_head; NULL != path; path = path->next)
1385   {
1386     if (3 > path->length)
1387       return GNUNET_YES;
1388   }
1389
1390   GNUNET_break (0); /* Is not a neighbor but connections is not NULL */
1391   return GNUNET_NO;
1392 }
1393
1394
1395 /**
1396  * Create and initialize a new tunnel towards a peer, in case it has none.
1397  * In case the peer already has a tunnel, nothing is done.
1398  *
1399  * Does not generate any traffic, just creates the local data structures.
1400  *
1401  * @param peer Peer towards which to create the tunnel.
1402  */
1403 void
1404 GMP_add_tunnel (struct MeshPeer *peer)
1405 {
1406   if (NULL != peer->tunnel)
1407     return;
1408   peer->tunnel = GMT_new (peer);
1409 }
1410
1411
1412 /**
1413  * Add a connection to a neighboring peer.
1414  *
1415  * Store that the peer is the first hop of the connection in one
1416  * direction and that on peer disconnect the connection must be
1417  * notified and destroyed, for it will no longer be valid.
1418  *
1419  * @param peer Peer to add connection to.
1420  * @param c Connection to add.
1421  *
1422  * @return GNUNET_OK on success.
1423  */
1424 int
1425 GMP_add_connection (struct MeshPeer *peer,
1426                     struct MeshConnection *c)
1427 {
1428   if (NULL == peer->connections)
1429   {
1430     GNUNET_break (0);
1431     return GNUNET_SYSERR;
1432   }
1433   return GNUNET_CONTAINER_multihashmap_put (peer->connections,
1434                                             GMC_get_id (c),
1435                                             c,
1436                                             GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST);
1437 }
1438
1439
1440 /**
1441  * Add the path to the peer and update the path used to reach it in case this
1442  * is the shortest.
1443  *
1444  * @param peer Destination peer to add the path to.
1445  * @param path New path to add. Last peer must be the peer in arg 1.
1446  *             Path will be either used of freed if already known.
1447  * @param trusted Do we trust that this path is real?
1448  *
1449  * @return path if path was taken, pointer to existing duplicate if exists
1450  *         NULL on error.
1451  */
1452 struct MeshPeerPath *
1453 GMP_add_path (struct MeshPeer *peer, struct MeshPeerPath *path,
1454               int trusted)
1455 {
1456   struct MeshPeerPath *aux;
1457   unsigned int l;
1458   unsigned int l2;
1459
1460   LOG (GNUNET_ERROR_TYPE_DEBUG, "adding path [%u] to peer %s\n",
1461        path->length, GMP_2s (peer));
1462
1463   if ((NULL == peer) || (NULL == path))
1464   {
1465     GNUNET_break (0);
1466     path_destroy (path);
1467     return NULL;
1468   }
1469   if (path->peers[path->length - 1] != peer->id)
1470   {
1471     GNUNET_break (0);
1472     path_destroy (path);
1473     return NULL;
1474   }
1475   if (2 >= path->length && GNUNET_NO == trusted)
1476   {
1477     /* Only allow CORE to tell us about direct paths */
1478     path_destroy (path);
1479     return NULL;
1480   }
1481   for (l = 1; l < path->length; l++)
1482   {
1483     if (path->peers[l] == myid)
1484     {
1485       LOG (GNUNET_ERROR_TYPE_DEBUG, "shortening path by %u\n", l);
1486       for (l2 = 0; l2 < path->length - l; l2++)
1487       {
1488         path->peers[l2] = path->peers[l + l2];
1489       }
1490       path->length -= l;
1491       l = 1;
1492       path->peers = GNUNET_realloc (path->peers,
1493                                     path->length * sizeof (GNUNET_PEER_Id));
1494     }
1495   }
1496
1497   LOG (GNUNET_ERROR_TYPE_DEBUG, "adding path [%u]\n", path->length);
1498
1499   l = path_get_length (path);
1500   if (0 == l)
1501   {
1502     path_destroy (path);
1503     return NULL;
1504   }
1505
1506   GNUNET_assert (peer->id == path->peers[path->length - 1]);
1507   for (aux = peer->path_head; aux != NULL; aux = aux->next)
1508   {
1509     l2 = path_get_length (aux);
1510     if (l2 > l)
1511     {
1512       LOG (GNUNET_ERROR_TYPE_DEBUG, "  added\n");
1513       GNUNET_CONTAINER_DLL_insert_before (peer->path_head,
1514                                           peer->path_tail, aux, path);
1515       return path;
1516     }
1517     else
1518     {
1519       if (l2 == l && memcmp (path->peers, aux->peers, l) == 0)
1520       {
1521         LOG (GNUNET_ERROR_TYPE_DEBUG, "  already known\n");
1522         path_destroy (path);
1523         return aux;
1524       }
1525     }
1526   }
1527   GNUNET_CONTAINER_DLL_insert_tail (peer->path_head, peer->path_tail,
1528                                     path);
1529   LOG (GNUNET_ERROR_TYPE_DEBUG, "  added last\n");
1530   return path;
1531 }
1532
1533
1534 /**
1535  * Add the path to the origin peer and update the path used to reach it in case
1536  * this is the shortest.
1537  * The path is given in peer_info -> destination, therefore we turn the path
1538  * upside down first.
1539  *
1540  * @param peer Peer to add the path to, being the origin of the path.
1541  * @param path New path to add after being inversed.
1542  *             Path will be either used or freed.
1543  * @param trusted Do we trust that this path is real?
1544  *
1545  * @return path if path was taken, pointer to existing duplicate if exists
1546  *         NULL on error.
1547  */
1548 struct MeshPeerPath *
1549 GMP_add_path_to_origin (struct MeshPeer *peer,
1550                         struct MeshPeerPath *path,
1551                         int trusted)
1552 {
1553   if (NULL == path)
1554     return NULL;
1555   path_invert (path);
1556   return GMP_add_path (peer, path, trusted);
1557 }
1558
1559
1560 /**
1561  * Adds a path to the info of all the peers in the path
1562  *
1563  * @param p Path to process.
1564  * @param confirmed Whether we know if the path works or not.
1565  */
1566 void
1567 GMP_add_path_to_all (const struct MeshPeerPath *p, int confirmed)
1568 {
1569   unsigned int i;
1570
1571   /* TODO: invert and add */
1572   for (i = 0; i < p->length && p->peers[i] != myid; i++) /* skip'em */ ;
1573   for (i++; i < p->length; i++)
1574   {
1575     struct MeshPeer *aux;
1576     struct MeshPeerPath *copy;
1577
1578     aux = GMP_get_short (p->peers[i]);
1579     copy = path_duplicate (p);
1580     copy->length = i + 1;
1581     GMP_add_path (aux, copy, p->length < 3 ? GNUNET_NO : confirmed);
1582   }
1583 }
1584
1585
1586 /**
1587  * Remove a connection from a neighboring peer.
1588  *
1589  * @param peer Peer to remove connection from.
1590  * @param c Connection to remove.
1591  *
1592  * @return GNUNET_OK on success.
1593  */
1594 int
1595 GMP_remove_connection (struct MeshPeer *peer,
1596                        const struct MeshConnection *c)
1597 {
1598   if (NULL == peer || NULL == peer->connections)
1599   {
1600     GNUNET_break (0);
1601     LOG (GNUNET_ERROR_TYPE_DEBUG,
1602          "Peer %s is not a neighbor!\n",
1603          GMP_2s (peer));
1604     return GNUNET_SYSERR;
1605   }
1606   return GNUNET_CONTAINER_multihashmap_remove (peer->connections,
1607                                                GMC_get_id (c),
1608                                                c);
1609 }
1610
1611 /**
1612  * Start the DHT search for new paths towards the peer: we don't have
1613  * enough good connections.
1614  *
1615  * @param peer Destination peer.
1616  */
1617 void
1618 GMP_start_search (struct MeshPeer *peer)
1619 {
1620   if (NULL != peer->search_h)
1621   {
1622     GNUNET_break (0);
1623     return;
1624   }
1625
1626   peer->search_h = GMD_search (GMP_get_id (peer), &search_handler, peer);
1627 }
1628
1629
1630 /**
1631  * Stop the DHT search for new paths towards the peer: we already have
1632  * enough good connections.
1633  *
1634  * @param peer Destination peer.
1635  */
1636 void
1637 GMP_stop_search (struct MeshPeer *peer)
1638 {
1639   if (NULL == peer->search_h)
1640   {
1641     GNUNET_break (0);
1642     return;
1643   }
1644
1645   GMD_search_stop (peer->search_h);
1646   peer->search_h = NULL;
1647 }
1648
1649
1650 /**
1651  * Get the Full ID of a peer.
1652  *
1653  * @param peer Peer to get from.
1654  *
1655  * @return Full ID of peer.
1656  */
1657 const struct GNUNET_PeerIdentity *
1658 GMP_get_id (const struct MeshPeer *peer)
1659 {
1660   return GNUNET_PEER_resolve2 (peer->id);
1661 }
1662
1663
1664 /**
1665  * Get the Short ID of a peer.
1666  *
1667  * @param peer Peer to get from.
1668  *
1669  * @return Short ID of peer.
1670  */
1671 GNUNET_PEER_Id
1672 GMP_get_short_id (const struct MeshPeer *peer)
1673 {
1674   return peer->id;
1675 }
1676
1677
1678 /**
1679  * Get the tunnel towards a peer.
1680  *
1681  * @param peer Peer to get from.
1682  *
1683  * @return Tunnel towards peer.
1684  */
1685 struct MeshTunnel3 *
1686 GMP_get_tunnel (const struct MeshPeer *peer)
1687 {
1688   return peer->tunnel;
1689 }
1690
1691
1692 /**
1693  * Get the static string for a peer ID.
1694  *
1695  * @param peer Peer.
1696  *
1697  * @return Static string for it's ID.
1698  */
1699 const char *
1700 GMP_2s (const struct MeshPeer *peer)
1701 {
1702   if (NULL == peer)
1703     return "(NULL)";
1704   return GNUNET_i2s (GNUNET_PEER_resolve2 (peer->id));
1705 }