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