- dont try to send data on connections that are going to be destroyed
[oweals/gnunet.git] / src / mesh / gnunet-service-mesh_connection.c
1 /*
2      This file is part of GNUnet.
3      (C) 2001-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  * @file mesh/gnunet-service-mesh_connection.c
23  * @brief GNUnet MESH service connection handling
24  * @author Bartlomiej Polot
25  */
26
27 #include "platform.h"
28 #include "gnunet_util_lib.h"
29
30 #include "gnunet_statistics_service.h"
31
32 #include "mesh_path.h"
33 #include "mesh_protocol.h"
34 #include "mesh.h"
35 #include "gnunet-service-mesh_connection.h"
36 #include "gnunet-service-mesh_peer.h"
37 #include "gnunet-service-mesh_tunnel.h"
38
39
40 #define LOG(level, ...) GNUNET_log_from (level,"mesh-con",__VA_ARGS__)
41
42 #define MESH_MAX_POLL_TIME      GNUNET_TIME_relative_multiply (\
43                                   GNUNET_TIME_UNIT_MINUTES,\
44                                   10)
45 #define AVG_MSGS                32
46
47
48 /******************************************************************************/
49 /********************************   STRUCTS  **********************************/
50 /******************************************************************************/
51
52 /**
53  * Struct to encapsulate all the Flow Control information to a peer to which
54  * we are directly connected (on a core level).
55  */
56 struct MeshFlowControl
57 {
58   /**
59    * Connection this controls.
60    */
61   struct MeshConnection *c;
62
63   /**
64    * How many messages are in the queue on this connection.
65    */
66   unsigned int queue_n;
67
68   /**
69    * How many messages do we accept in the queue.
70    */
71   unsigned int queue_max;
72
73   /**
74    * Next ID to use.
75    */
76   uint32_t next_pid;
77
78   /**
79    * ID of the last packet sent towards the peer.
80    */
81   uint32_t last_pid_sent;
82
83   /**
84    * ID of the last packet received from the peer.
85    */
86   uint32_t last_pid_recv;
87
88   /**
89    * Last ACK sent to the peer (peer can't send more than this PID).
90    */
91   uint32_t last_ack_sent;
92
93   /**
94    * Last ACK sent towards the origin (for traffic towards leaf node).
95    */
96   uint32_t last_ack_recv;
97
98   /**
99    * Task to poll the peer in case of a lost ACK causes stall.
100    */
101   GNUNET_SCHEDULER_TaskIdentifier poll_task;
102
103   /**
104    * How frequently to poll for ACKs.
105    */
106   struct GNUNET_TIME_Relative poll_time;
107
108   /**
109    * Queued poll message, to cancel if not necessary anymore (got ACK).
110    */
111   struct MeshConnectionQueue *poll_msg;
112
113   /**
114    * Queued poll message, to cancel if not necessary anymore (got ACK).
115    */
116   struct MeshConnectionQueue *ack_msg;
117 };
118
119 /**
120  * Keep a record of the last messages sent on this connection.
121  */
122 struct MeshConnectionPerformance
123 {
124   /**
125    * Circular buffer for storing measurements.
126    */
127   double usecsperbyte[AVG_MSGS];
128
129   /**
130    * Running average of @c usecsperbyte.
131    */
132   double avg;
133
134   /**
135    * How many values of @c usecsperbyte are valid.
136    */
137   uint16_t size;
138
139   /**
140    * Index of the next "free" position in @c usecsperbyte.
141    */
142   uint16_t idx;
143 };
144
145
146 /**
147  * Struct containing all information regarding a connection to a peer.
148  */
149 struct MeshConnection
150 {
151   /**
152    * Tunnel this connection is part of.
153    */
154   struct MeshTunnel3 *t;
155
156   /**
157    * Flow control information for traffic fwd.
158    */
159   struct MeshFlowControl fwd_fc;
160
161   /**
162    * Flow control information for traffic bck.
163    */
164   struct MeshFlowControl bck_fc;
165
166   /**
167    * Measure connection performance on the endpoint.
168    */
169   struct MeshConnectionPerformance *perf;
170
171   /**
172    * ID of the connection.
173    */
174   struct GNUNET_HashCode id;
175
176   /**
177    * State of the connection.
178    */
179   enum MeshConnectionState state;
180
181   /**
182    * Path being used for the tunnel.
183    */
184   struct MeshPeerPath *path;
185
186   /**
187    * Position of the local peer in the path.
188    */
189   unsigned int own_pos;
190
191   /**
192    * Task to keep the used paths alive at the owner,
193    * time tunnel out on all the other peers.
194    */
195   GNUNET_SCHEDULER_TaskIdentifier fwd_maintenance_task;
196
197   /**
198    * Task to keep the used paths alive at the destination,
199    * time tunnel out on all the other peers.
200    */
201   GNUNET_SCHEDULER_TaskIdentifier bck_maintenance_task;
202
203   /**
204    * Pending message count.
205    */
206   int pending_messages;
207
208   /**
209    * Destroy flag: if true, destroy on last message.
210    */
211   int destroy;
212 };
213
214 /**
215  * Handle for messages queued but not yet sent.
216  */
217 struct MeshConnectionQueue
218 {
219   /**
220    * Peer queue handle, to cancel if necessary.
221    */
222   struct MeshPeerQueue *q;
223
224   /**
225    * Continuation to call once sent.
226    */
227   GMC_sent cont;
228
229   /**
230    * Closure for @c cont.
231    */
232   void *cont_cls;
233 };
234
235 /******************************************************************************/
236 /*******************************   GLOBALS  ***********************************/
237 /******************************************************************************/
238
239 /**
240  * Global handle to the statistics service.
241  */
242 extern struct GNUNET_STATISTICS_Handle *stats;
243
244 /**
245  * Local peer own ID (memory efficient handle).
246  */
247 extern GNUNET_PEER_Id myid;
248
249 /**
250  * Local peer own ID (full value).
251  */
252 extern struct GNUNET_PeerIdentity my_full_id;
253
254 /**
255  * Connections known, indexed by cid (MeshConnection).
256  */
257 static struct GNUNET_CONTAINER_MultiHashMap *connections;
258
259 /**
260  * How many connections are we willing to maintain.
261  * Local connections are always allowed, even if there are more connections than max.
262  */
263 static unsigned long long max_connections;
264
265 /**
266  * How many messages *in total* are we willing to queue, divide by number of
267  * connections to get connection queue size.
268  */
269 static unsigned long long max_msgs_queue;
270
271 /**
272  * How often to send path keepalives. Paths timeout after 4 missed.
273  */
274 static struct GNUNET_TIME_Relative refresh_connection_time;
275
276 /**
277  * How often to send path create / ACKs.
278  */
279 static struct GNUNET_TIME_Relative create_connection_time;
280
281
282 /******************************************************************************/
283 /********************************   STATIC  ***********************************/
284 /******************************************************************************/
285
286 #if 0 // avoid compiler warning for unused static function
287 static void
288 fc_debug (struct MeshFlowControl *fc)
289 {
290   LOG (GNUNET_ERROR_TYPE_DEBUG, "    IN: %u/%u\n",
291               fc->last_pid_recv, fc->last_ack_sent);
292   LOG (GNUNET_ERROR_TYPE_DEBUG, "    OUT: %u/%u\n",
293               fc->last_pid_sent, fc->last_ack_recv);
294   LOG (GNUNET_ERROR_TYPE_DEBUG, "    QUEUE: %u/%u\n",
295               fc->queue_n, fc->queue_max);
296 }
297
298 static void
299 connection_debug (struct MeshConnection *c)
300 {
301   if (NULL == c)
302   {
303     LOG (GNUNET_ERROR_TYPE_DEBUG, "*** DEBUG NULL CONNECTION ***\n");
304     return;
305   }
306   LOG (GNUNET_ERROR_TYPE_DEBUG, "Connection %s:%X\n",
307               peer2s (c->t->peer), GMC_2s (c));
308   LOG (GNUNET_ERROR_TYPE_DEBUG, "  state: %u, pending msgs: %u\n",
309               c->state, c->pending_messages);
310   LOG (GNUNET_ERROR_TYPE_DEBUG, "  FWD FC\n");
311   fc_debug (&c->fwd_fc);
312   LOG (GNUNET_ERROR_TYPE_DEBUG, "  BCK FC\n");
313   fc_debug (&c->bck_fc);
314 }
315 #endif
316
317 /**
318  * Get string description for tunnel state.
319  *
320  * @param s Tunnel state.
321  *
322  * @return String representation.
323  */
324 static const char *
325 GMC_state2s (enum MeshConnectionState s)
326 {
327   switch (s)
328   {
329     case MESH_CONNECTION_NEW:
330       return "MESH_CONNECTION_NEW";
331     case MESH_CONNECTION_SENT:
332       return "MESH_CONNECTION_SENT";
333     case MESH_CONNECTION_ACK:
334       return "MESH_CONNECTION_ACK";
335     case MESH_CONNECTION_READY:
336       return "MESH_CONNECTION_READY";
337     case MESH_CONNECTION_DESTROYED:
338       return "MESH_CONNECTION_DESTROYED";
339     default:
340       return "MESH_CONNECTION_STATE_ERROR";
341   }
342 }
343
344
345 /**
346  * Initialize a Flow Control structure to the initial state.
347  *
348  * @param fc Flow Control structure to initialize.
349  */
350 static void
351 fc_init (struct MeshFlowControl *fc)
352 {
353   fc->next_pid = 0;
354   fc->last_pid_sent = (uint32_t) -1; /* Next (expected) = 0 */
355   fc->last_pid_recv = (uint32_t) -1;
356   fc->last_ack_sent = (uint32_t) 0;
357   fc->last_ack_recv = (uint32_t) 0;
358   fc->poll_task = GNUNET_SCHEDULER_NO_TASK;
359   fc->poll_time = GNUNET_TIME_UNIT_SECONDS;
360   fc->queue_n = 0;
361   fc->queue_max = (max_msgs_queue / max_connections) + 1;
362 }
363
364
365 /**
366  * Find a connection.
367  *
368  * @param cid Connection ID.
369  */
370 static struct MeshConnection *
371 connection_get (const struct GNUNET_HashCode *cid)
372 {
373   return GNUNET_CONTAINER_multihashmap_get (connections, cid);
374 }
375
376
377 static void
378 connection_change_state (struct MeshConnection* c,
379                          enum MeshConnectionState state)
380 {
381   LOG (GNUNET_ERROR_TYPE_DEBUG,
382               "Connection %s state was %s\n",
383               GMC_2s (c), GMC_state2s (c->state));
384   if (MESH_CONNECTION_DESTROYED == c->state)
385   {
386     LOG (GNUNET_ERROR_TYPE_DEBUG, "state not changing anymore\n");
387     return;
388   }
389   LOG (GNUNET_ERROR_TYPE_DEBUG,
390               "Connection %s state is now %s\n",
391               GMC_2s (c), GMC_state2s (state));
392   c->state = state;
393 }
394
395
396 /**
397  * Callback called when a queued ACK message is sent.
398  *
399  * @param cls Closure (FC).
400  * @param c Connection this message was on.
401  * @param q Queue handler this call invalidates.
402  * @param type Type of message sent.
403  * @param fwd Was this a FWD going message?
404  * @param size Size of the message.
405  */
406 static void
407 ack_sent (void *cls,
408           struct MeshConnection *c,
409           struct MeshConnectionQueue *q,
410           uint16_t type, int fwd, size_t size)
411 {
412   struct MeshFlowControl *fc = cls;
413
414   fc->ack_msg = NULL;
415 }
416
417
418 /**
419  * Send an ACK on the connection, informing the predecessor about
420  * the available buffer space. Should not be called in case the peer
421  * is origin (no predecessor) in the @c fwd direction.
422  *
423  * Note that for fwd ack, the FWD mean forward *traffic* (root->dest),
424  * the ACK itself goes "back" (dest->root).
425  *
426  * @param c Connection on which to send the ACK.
427  * @param buffer How much space free to advertise?
428  * @param fwd Is this FWD ACK? (Going dest -> root)
429  * @param force Don't optimize out.
430  */
431 static void
432 send_ack (struct MeshConnection *c, unsigned int buffer, int fwd, int force)
433 {
434   struct MeshFlowControl *next_fc;
435   struct MeshFlowControl *prev_fc;
436   struct GNUNET_MESH_ACK msg;
437   uint32_t ack;
438   int delta;
439
440   /* If origin, there is no connection to send ACKs. Wrong function! */
441   if (GMC_is_origin (c, fwd))
442   {
443     GNUNET_break (0);
444     return;
445   }
446
447   next_fc = fwd ? &c->fwd_fc : &c->bck_fc;
448   prev_fc = fwd ? &c->bck_fc : &c->fwd_fc;
449
450   LOG (GNUNET_ERROR_TYPE_DEBUG,
451               "connection send %s ack on %s\n",
452               fwd ? "FWD" : "BCK", GMC_2s (c));
453
454   /* Check if we need to transmit the ACK. */
455   delta = prev_fc->last_ack_sent - prev_fc->last_pid_recv;
456   if (3 < delta && buffer < delta && GNUNET_NO == force)
457   {
458     LOG (GNUNET_ERROR_TYPE_DEBUG, "Not sending ACK, buffer > 3\n");
459     LOG (GNUNET_ERROR_TYPE_DEBUG,
460          "  last pid recv: %u, last ack sent: %u\n",
461          prev_fc->last_pid_recv, prev_fc->last_ack_sent);
462     return;
463   }
464
465   /* Ok, ACK might be necessary, what PID to ACK? */
466   ack = prev_fc->last_pid_recv + buffer;
467   LOG (GNUNET_ERROR_TYPE_DEBUG, " ACK %u\n", ack);
468   LOG (GNUNET_ERROR_TYPE_DEBUG,
469        " last pid %u, last ack %u, qmax %u, q %u\n",
470        prev_fc->last_pid_recv, prev_fc->last_ack_sent,
471        next_fc->queue_max, next_fc->queue_n);
472   if (ack == prev_fc->last_ack_sent && GNUNET_NO == force)
473   {
474     LOG (GNUNET_ERROR_TYPE_DEBUG, "Not sending FWD ACK, not needed\n");
475     return;
476   }
477
478   /* Check if message is already in queue */
479   if (NULL != prev_fc->ack_msg)
480   {
481     if (GMC_is_pid_bigger (ack, prev_fc->last_ack_sent))
482     {
483       LOG (GNUNET_ERROR_TYPE_DEBUG, " canceling old ACK\n");
484       GMC_cancel (prev_fc->ack_msg);
485       /* GMC_cancel triggers ack_sent(), which clears fc->ack_msg */
486     }
487     else
488     {
489       LOG (GNUNET_ERROR_TYPE_DEBUG, " same ACK already in queue\n");
490       return;
491     }
492   }
493
494   prev_fc->last_ack_sent = ack;
495
496   /* Build ACK message and send on connection */
497   msg.header.size = htons (sizeof (msg));
498   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_ACK);
499   msg.ack = htonl (ack);
500   msg.cid = c->id;
501
502   prev_fc->ack_msg = GMC_send_prebuilt_message (&msg.header, c, !fwd,
503                                                 &ack_sent, prev_fc);
504 }
505
506
507 /**
508  * Callback called when a queued message is sent.
509  *
510  * Calculates the average time and connection packet tracking.
511  *
512  * @param cls Closure (ConnectionQueue Handle).
513  * @param c Connection this message was on.
514  * @param type Type of message sent.
515  * @param fwd Was this a FWD going message?
516  * @param size Size of the message.
517  * @param wait Time spent waiting for core (only the time for THIS message)
518  */
519 static void
520 message_sent (void *cls,
521               struct MeshConnection *c, uint16_t type,
522               int fwd, size_t size,
523               struct GNUNET_TIME_Relative wait)
524 {
525   struct MeshConnectionPerformance *p;
526   struct MeshFlowControl *fc;
527   struct MeshConnectionQueue *q = cls;
528   double usecsperbyte;
529
530   fc = fwd ? &c->fwd_fc : &c->bck_fc;
531   LOG (GNUNET_ERROR_TYPE_DEBUG,
532        "!  sent %s %s\n",
533        fwd ? "FWD" : "BCK",
534        GNUNET_MESH_DEBUG_M2S (type));
535   LOG (GNUNET_ERROR_TYPE_DEBUG, "!  C_P- %p %u\n", c, c->pending_messages);
536   if (NULL != q)
537   {
538     if (NULL != q->cont)
539     {
540       LOG (GNUNET_ERROR_TYPE_DEBUG, "!  calling cont\n");
541       q->cont (q->cont_cls, c, q, type, fwd, size);
542     }
543     GNUNET_free (q);
544   }
545   c->pending_messages--;
546   if (GNUNET_YES == c->destroy && 0 == c->pending_messages)
547   {
548     LOG (GNUNET_ERROR_TYPE_DEBUG, "!  destroying connection!\n");
549     GMC_destroy (c);
550     return;
551   }
552   /* Send ACK if needed, after accounting for sent ID in fc->queue_n */
553   switch (type)
554   {
555     case GNUNET_MESSAGE_TYPE_MESH_ENCRYPTED:
556       fc->last_pid_sent++;
557       LOG (GNUNET_ERROR_TYPE_DEBUG, "!  Q_N- %p %u\n", fc, fc->queue_n);
558       fc->queue_n--;
559       LOG (GNUNET_ERROR_TYPE_DEBUG,
560            "!   accounting pid %u\n",
561            fc->last_pid_sent);
562       GMC_send_ack (c, fwd, GNUNET_NO);
563       break;
564
565     case GNUNET_MESSAGE_TYPE_MESH_POLL:
566       fc->poll_msg = NULL;
567       break;
568
569     case GNUNET_MESSAGE_TYPE_MESH_ACK:
570       fc->ack_msg = NULL;
571       break;
572
573     default:
574       break;
575   }
576   LOG (GNUNET_ERROR_TYPE_DEBUG, "!  message sent!\n");
577
578   if (NULL == c->perf)
579     return; /* Only endpoints are interested in timing. */
580
581   p = c->perf;
582   usecsperbyte = ((double) wait.rel_value_us) / size;
583   if (p->size == AVG_MSGS)
584   {
585     /* Array is full. Substract oldest value, add new one and store. */
586     p->avg -= (p->usecsperbyte[p->idx] / AVG_MSGS);
587     p->usecsperbyte[p->idx] = usecsperbyte;
588     p->avg += (p->usecsperbyte[p->idx] / AVG_MSGS);
589   }
590   else
591   {
592     /* Array not yet full. Add current value to avg and store. */
593     p->usecsperbyte[p->idx] = usecsperbyte;
594     p->avg *= p->size;
595     p->avg += p->usecsperbyte[p->idx];
596     p->size++;
597     p->avg /= p->size;
598   }
599   p->idx = (p->idx + 1) % AVG_MSGS;
600 }
601
602
603 /**
604  * Get the previous hop in a connection
605  *
606  * @param c Connection.
607  *
608  * @return Previous peer in the connection.
609  */
610 static struct MeshPeer *
611 get_prev_hop (const struct MeshConnection *c)
612 {
613   GNUNET_PEER_Id id;
614
615   LOG (GNUNET_ERROR_TYPE_DEBUG, "Get prev hop, own pos %u\n", c->own_pos);
616   if (0 == c->own_pos || c->path->length < 2)
617     id = c->path->peers[0];
618   else
619     id = c->path->peers[c->own_pos - 1];
620
621   return GMP_get_short (id);
622 }
623
624
625 /**
626  * Get the next hop in a connection
627  *
628  * @param c Connection.
629  *
630  * @return Next peer in the connection.
631  */
632 static struct MeshPeer *
633 get_next_hop (const struct MeshConnection *c)
634 {
635   GNUNET_PEER_Id id;
636
637   if ((c->path->length - 1) == c->own_pos || c->path->length < 2)
638     id = c->path->peers[c->path->length - 1];
639   else
640     id = c->path->peers[c->own_pos + 1];
641
642   return GMP_get_short (id);
643 }
644
645
646 /**
647  * Get the hop in a connection.
648  *
649  * @param c Connection.
650  * @param fwd Next hop?
651  *
652  * @return Next peer in the connection.
653  */
654 static struct MeshPeer *
655 get_hop (struct MeshConnection *c, int fwd)
656 {
657   if (fwd)
658     return get_next_hop (c);
659   return get_prev_hop (c);
660 }
661
662
663 /**
664  * Is traffic coming from this sender 'FWD' traffic?
665  *
666  * @param c Connection to check.
667  * @param sender Peer identity of neighbor.
668  *
669  * @return #GNUNET_YES in case the sender is the 'prev' hop and therefore
670  *         the traffic is 'FWD'.
671  *         #GNUNET_NO for BCK.
672  *         #GNUNET_SYSERR for errors.
673  */
674 static int
675 is_fwd (const struct MeshConnection *c,
676         const struct GNUNET_PeerIdentity *sender)
677 {
678   GNUNET_PEER_Id id;
679
680   id = GNUNET_PEER_search (sender);
681   if (GMP_get_short_id (get_prev_hop (c)) == id)
682     return GNUNET_YES;
683
684   if (GMP_get_short_id (get_next_hop (c)) == id)
685     return GNUNET_NO;
686
687   GNUNET_break (0);
688   return GNUNET_SYSERR;
689 }
690
691
692 /**
693  * Sends a CONNECTION ACK message in reponse to a received CONNECTION_CREATE
694  * or a first CONNECTION_ACK directed to us.
695  *
696  * @param connection Connection to confirm.
697  * @param fwd Should we send it FWD? (root->dest)
698  *            (First (~SYNACK) goes BCK, second (~ACK) goes FWD)
699  */
700 static void
701 send_connection_ack (struct MeshConnection *connection, int fwd)
702 {
703   struct MeshTunnel3 *t;
704
705   t = connection->t;
706   LOG (GNUNET_ERROR_TYPE_DEBUG, "Send connection %s ACK\n",
707        !fwd ? "FWD" : "BCK");
708   GMP_queue_add (get_hop (connection, fwd), NULL,
709                  GNUNET_MESSAGE_TYPE_MESH_CONNECTION_ACK,
710                  sizeof (struct GNUNET_MESH_ConnectionACK),
711                  connection, fwd, &message_sent, NULL);
712   connection->pending_messages++;
713   if (MESH_TUNNEL3_NEW == GMT_get_state (t))
714     GMT_change_state (t, MESH_TUNNEL3_WAITING);
715   if (MESH_CONNECTION_READY != connection->state)
716     connection_change_state (connection, MESH_CONNECTION_SENT);
717 }
718
719
720 /**
721  * Send a notification that a connection is broken.
722  *
723  * @param c Connection that is broken.
724  * @param id1 Peer that has disconnected.
725  * @param id2 Peer that has disconnected.
726  * @param fwd Direction towards which to send it.
727  */
728 static void
729 send_broken (struct MeshConnection *c,
730              const struct GNUNET_PeerIdentity *id1,
731              const struct GNUNET_PeerIdentity *id2,
732              int fwd)
733 {
734   struct GNUNET_MESH_ConnectionBroken msg;
735
736   msg.header.size = htons (sizeof (struct GNUNET_MESH_ConnectionBroken));
737   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_CONNECTION_BROKEN);
738   msg.cid = c->id;
739   msg.peer1 = *id1;
740   msg.peer2 = *id2;
741   GMC_send_prebuilt_message (&msg.header, c, fwd, NULL, NULL);
742 }
743
744
745
746 /**
747  * Send keepalive packets for a connection.
748  *
749  * @param c Connection to keep alive..
750  * @param fwd Is this a FWD keepalive? (owner -> dest).
751  *
752  * FIXME use only one type, register in GMC_send_prebuilt_message()
753  */
754 static void
755 connection_keepalive (struct MeshConnection *c, int fwd)
756 {
757   struct GNUNET_MESH_ConnectionKeepAlive *msg;
758   size_t size = sizeof (struct GNUNET_MESH_ConnectionKeepAlive);
759   char cbuf[size];
760   uint16_t type;
761
762   type = fwd ? GNUNET_MESSAGE_TYPE_MESH_FWD_KEEPALIVE :
763                GNUNET_MESSAGE_TYPE_MESH_BCK_KEEPALIVE;
764
765   LOG (GNUNET_ERROR_TYPE_DEBUG,
766        "sending %s keepalive for connection %s]\n",
767        fwd ? "FWD" : "BCK", GMC_2s (c));
768
769   msg = (struct GNUNET_MESH_ConnectionKeepAlive *) cbuf;
770   msg->header.size = htons (size);
771   msg->header.type = htons (type);
772   msg->cid = c->id;
773
774   GMC_send_prebuilt_message (&msg->header, c, fwd, NULL, NULL);
775 }
776
777
778 /**
779  * Send CONNECTION_{CREATE/ACK} packets for a connection.
780  *
781  * @param c Connection for which to send the message.
782  * @param fwd If #GNUNET_YES, send CREATE, otherwise send ACK.
783  */
784 static void
785 connection_recreate (struct MeshConnection *c, int fwd)
786 {
787   LOG (GNUNET_ERROR_TYPE_DEBUG, "sending connection recreate\n");
788   if (fwd)
789     GMC_send_create (c);
790   else
791     send_connection_ack (c, GNUNET_NO);
792 }
793
794
795 /**
796  * Generic connection timer management.
797  * Depending on the role of the peer in the connection will send the
798  * appropriate message (build or keepalive)
799  *
800  * @param c Conncetion to maintain.
801  * @param fwd Is FWD?
802  */
803 static void
804 connection_maintain (struct MeshConnection *c, int fwd)
805 {
806   if (MESH_TUNNEL3_SEARCHING == GMT_get_state (c->t))
807   {
808     /* TODO DHT GET with RO_BART */
809     return;
810   }
811   switch (c->state)
812   {
813     case MESH_CONNECTION_NEW:
814       GNUNET_break (0);
815       /* fall-through */
816     case MESH_CONNECTION_SENT:
817       connection_recreate (c, fwd);
818       break;
819     case MESH_CONNECTION_READY:
820       connection_keepalive (c, fwd);
821       break;
822     default:
823       break;
824   }
825 }
826
827
828 static void
829 connection_fwd_keepalive (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
830 {
831   struct MeshConnection *c = cls;
832   struct GNUNET_TIME_Relative delay;
833
834   c->fwd_maintenance_task = GNUNET_SCHEDULER_NO_TASK;
835   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
836     return;
837
838   connection_maintain (c, GNUNET_YES);
839   delay = c->state == MESH_CONNECTION_READY ?
840           refresh_connection_time : create_connection_time;
841   c->fwd_maintenance_task = GNUNET_SCHEDULER_add_delayed (delay,
842                                                           &connection_fwd_keepalive,
843                                                           c);
844 }
845
846
847 static void
848 connection_bck_keepalive (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
849 {
850   struct MeshConnection *c = cls;
851   struct GNUNET_TIME_Relative delay;
852
853   c->bck_maintenance_task = GNUNET_SCHEDULER_NO_TASK;
854   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
855     return;
856
857   connection_maintain (c, GNUNET_NO);
858   delay = c->state == MESH_CONNECTION_READY ?
859           refresh_connection_time : create_connection_time;
860   c->bck_maintenance_task = GNUNET_SCHEDULER_add_delayed (delay,
861                                                           &connection_bck_keepalive,
862                                                           c);
863 }
864
865
866 /**
867  * @brief Re-initiate traffic on this connection if necessary.
868  *
869  * Check if there is traffic queued towards this peer
870  * and the core transmit handle is NULL (traffic was stalled).
871  * If so, call core tmt rdy.
872  *
873  * @param c Connection on which initiate traffic.
874  * @param fwd Is this about fwd traffic?
875  */
876 static void
877 connection_unlock_queue (struct MeshConnection *c, int fwd)
878 {
879   struct MeshPeer *peer;
880
881   LOG (GNUNET_ERROR_TYPE_DEBUG,
882               "connection_unlock_queue %s on %s\n",
883               fwd ? "FWD" : "BCK", GMC_2s (c));
884
885   if (GMC_is_terminal (c, fwd))
886   {
887     LOG (GNUNET_ERROR_TYPE_DEBUG, " is terminal!\n");
888     return;
889   }
890
891   peer = get_hop (c, fwd);
892   GMP_queue_unlock (peer, c);
893 }
894
895
896 /**
897  * Cancel all transmissions that belong to a certain connection.
898  *
899  * If the connection is scheduled for destruction and no more messages are left,
900  * the connection will be destroyed by the continuation call.
901  *
902  * @param c Connection which to cancel. Might be destroyed during this call.
903  * @param fwd Cancel fwd traffic?
904  */
905 static void
906 connection_cancel_queues (struct MeshConnection *c, int fwd)
907 {
908   struct MeshFlowControl *fc;
909   struct MeshPeer *peer;
910
911   LOG (GNUNET_ERROR_TYPE_DEBUG,
912        " *** Cancel %s queues for connection %s\n",
913        fwd ? "FWD" : "BCK", GMC_2s (c));
914   if (NULL == c)
915   {
916     GNUNET_break (0);
917     return;
918   }
919
920   fc = fwd ? &c->fwd_fc : &c->bck_fc;
921   if (GNUNET_SCHEDULER_NO_TASK != fc->poll_task)
922   {
923     GNUNET_SCHEDULER_cancel (fc->poll_task);
924     fc->poll_task = GNUNET_SCHEDULER_NO_TASK;
925     LOG (GNUNET_ERROR_TYPE_DEBUG, " *** Cancel POLL in ccq for fc %p\n", fc);
926   }
927   peer = get_hop (c, fwd);
928   GMP_queue_cancel (peer, c);
929 }
930
931
932 /**
933  * Function called if a connection has been stalled for a while,
934  * possibly due to a missed ACK. Poll the neighbor about its ACK status.
935  *
936  * @param cls Closure (poll ctx).
937  * @param tc TaskContext.
938  */
939 static void
940 connection_poll (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc);
941
942
943 /**
944  * Callback called when a queued POLL message is sent.
945  *
946  * @param cls Closure (FC).
947  * @param c Connection this message was on.
948  * @param q Queue handler this call invalidates.
949  * @param type Type of message sent.
950  * @param fwd Was this a FWD going message?
951  * @param size Size of the message.
952  */
953 static void
954 poll_sent (void *cls,
955            struct MeshConnection *c,
956            struct MeshConnectionQueue *q,
957            uint16_t type, int fwd, size_t size)
958 {
959   struct MeshFlowControl *fc = cls;
960
961   if (2 == c->destroy)
962   {
963     LOG (GNUNET_ERROR_TYPE_DEBUG, " *** POLL canceled on shutdown\n");
964     return;
965   }
966   LOG (GNUNET_ERROR_TYPE_DEBUG,
967        " *** POLL sent for , scheduling new one!\n");
968   fc->poll_msg = NULL;
969   fc->poll_time = GNUNET_TIME_STD_BACKOFF (fc->poll_time);
970   fc->poll_task = GNUNET_SCHEDULER_add_delayed (fc->poll_time,
971                                                 &connection_poll, fc);
972   LOG (GNUNET_ERROR_TYPE_DEBUG, " task %u\n", fc->poll_task);
973
974 }
975
976 /**
977  * Function called if a connection has been stalled for a while,
978  * possibly due to a missed ACK. Poll the neighbor about its ACK status.
979  *
980  * @param cls Closure (poll ctx).
981  * @param tc TaskContext.
982  */
983 static void
984 connection_poll (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
985 {
986   struct MeshFlowControl *fc = cls;
987   struct GNUNET_MESH_Poll msg;
988   struct MeshConnection *c;
989
990   fc->poll_task = GNUNET_SCHEDULER_NO_TASK;
991   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
992   {
993     return;
994   }
995
996   c = fc->c;
997   LOG (GNUNET_ERROR_TYPE_DEBUG, " *** Polling!\n");
998   LOG (GNUNET_ERROR_TYPE_DEBUG, " *** connection [%s]\n", GMC_2s (c));
999   LOG (GNUNET_ERROR_TYPE_DEBUG, " ***   %s\n",
1000        fc == &c->fwd_fc ? "FWD" : "BCK");
1001
1002   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_POLL);
1003   msg.header.size = htons (sizeof (msg));
1004   msg.pid = htonl (fc->last_pid_sent);
1005   LOG (GNUNET_ERROR_TYPE_DEBUG, " *** last pid sent: %u!\n", fc->last_pid_sent);
1006   fc->poll_msg = GMC_send_prebuilt_message (&msg.header, c, fc == &c->fwd_fc,
1007                                             &poll_sent, fc);
1008 }
1009
1010
1011 /**
1012  * Timeout function due to lack of keepalive/traffic from the owner.
1013  * Destroys connection if called.
1014  *
1015  * @param cls Closure (connection to destroy).
1016  * @param tc TaskContext.
1017  */
1018 static void
1019 connection_fwd_timeout (void *cls,
1020                         const struct GNUNET_SCHEDULER_TaskContext *tc)
1021 {
1022   struct MeshConnection *c = cls;
1023
1024   c->fwd_maintenance_task = GNUNET_SCHEDULER_NO_TASK;
1025   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
1026     return;
1027   LOG (GNUNET_ERROR_TYPE_DEBUG,
1028               "Connection %s[%X] FWD timed out. Destroying.\n",
1029               GMT_2s (c->t),
1030               c->id);
1031
1032   if (GMC_is_origin (c, GNUNET_YES)) /* If local, leave. */
1033     return;
1034
1035   GMC_destroy (c);
1036 }
1037
1038
1039 /**
1040  * Timeout function due to lack of keepalive/traffic from the destination.
1041  * Destroys connection if called.
1042  *
1043  * @param cls Closure (connection to destroy).
1044  * @param tc TaskContext
1045  */
1046 static void
1047 connection_bck_timeout (void *cls,
1048                         const struct GNUNET_SCHEDULER_TaskContext *tc)
1049 {
1050   struct MeshConnection *c = cls;
1051
1052   c->bck_maintenance_task = GNUNET_SCHEDULER_NO_TASK;
1053   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
1054     return;
1055
1056   LOG (GNUNET_ERROR_TYPE_DEBUG,
1057               "Connection %s[%X] FWD timed out. Destroying.\n",
1058               GMT_2s (c->t), c->id);
1059
1060   if (GMC_is_origin (c, GNUNET_NO)) /* If local, leave. */
1061     return;
1062
1063   GMC_destroy (c);
1064 }
1065
1066
1067 /**
1068  * Resets the connection timeout task, some other message has done the
1069  * task's job.
1070  * - For the first peer on the direction this means to send
1071  *   a keepalive or a path confirmation message (either create or ACK).
1072  * - For all other peers, this means to destroy the connection,
1073  *   due to lack of activity.
1074  * Starts the tiemout if no timeout was running (connection just created).
1075  *
1076  * @param c Connection whose timeout to reset.
1077  * @param fwd Is this forward?
1078  *
1079  * TODO use heap to improve efficiency of scheduler.
1080  */
1081 static void
1082 connection_reset_timeout (struct MeshConnection *c, int fwd)
1083 {
1084   GNUNET_SCHEDULER_TaskIdentifier *ti;
1085   GNUNET_SCHEDULER_Task f;
1086
1087   ti = fwd ? &c->fwd_maintenance_task : &c->bck_maintenance_task;
1088
1089   if (GNUNET_SCHEDULER_NO_TASK != *ti)
1090     GNUNET_SCHEDULER_cancel (*ti);
1091
1092   if (GMC_is_origin (c, fwd)) /* Startpoint */
1093   {
1094     f  = fwd ? &connection_fwd_keepalive : &connection_bck_keepalive;
1095     *ti = GNUNET_SCHEDULER_add_delayed (refresh_connection_time, f, c);
1096   }
1097   else /* Relay, endpoint. */
1098   {
1099     struct GNUNET_TIME_Relative delay;
1100
1101     delay = GNUNET_TIME_relative_multiply (refresh_connection_time, 4);
1102     f  = fwd ? &connection_fwd_timeout : &connection_bck_timeout;
1103     *ti = GNUNET_SCHEDULER_add_delayed (delay, f, c);
1104   }
1105 }
1106
1107
1108 /**
1109  * Add the connection to the list of both neighbors.
1110  *
1111  * @param c Connection.
1112  *
1113  * @return #GNUNET_OK if everything went fine
1114  *         #GNUNET_SYSERR if the was an error and @c c is malformed.
1115  */
1116 static int
1117 register_neighbors (struct MeshConnection *c)
1118 {
1119   struct MeshPeer *next_peer;
1120   struct MeshPeer *prev_peer;
1121
1122   next_peer = get_next_hop (c);
1123   prev_peer = get_prev_hop (c);
1124
1125   if (GNUNET_NO == GMP_is_neighbor (next_peer)
1126       || GNUNET_NO == GMP_is_neighbor (prev_peer))
1127     return GNUNET_SYSERR;
1128
1129   GMP_add_connection (next_peer, c);
1130   GMP_add_connection (prev_peer, c);
1131
1132   return GNUNET_OK;
1133 }
1134
1135
1136 /**
1137  * Remove the connection from the list of both neighbors.
1138  *
1139  * @param c Connection.
1140  */
1141 static void
1142 unregister_neighbors (struct MeshConnection *c)
1143 {
1144   struct MeshPeer *peer;
1145
1146   peer = get_next_hop (c);
1147   GMP_remove_connection (peer, c);
1148
1149   peer = get_prev_hop (c);
1150   GMP_remove_connection (peer, c);
1151
1152 }
1153
1154
1155 /**
1156  * Bind the connection to the peer and the tunnel to that peer.
1157  *
1158  * If the peer has no tunnel, create one. Update tunnel and connection
1159  * data structres to reflect new status.
1160  *
1161  * @param c Connection.
1162  * @param peer Peer.
1163  */
1164 static void
1165 add_to_peer (struct MeshConnection *c, struct MeshPeer *peer)
1166 {
1167   GMP_add_tunnel (peer);
1168   c->t = GMP_get_tunnel (peer);
1169   GMT_add_connection (c->t, c);
1170 }
1171
1172 /******************************************************************************/
1173 /********************************    API    ***********************************/
1174 /******************************************************************************/
1175
1176 /**
1177  * Core handler for connection creation.
1178  *
1179  * @param cls Closure (unused).
1180  * @param peer Sender (neighbor).
1181  * @param message Message.
1182  *
1183  * @return GNUNET_OK to keep the connection open,
1184  *         GNUNET_SYSERR to close it (signal serious error)
1185  */
1186 int
1187 GMC_handle_create (void *cls, const struct GNUNET_PeerIdentity *peer,
1188                    const struct GNUNET_MessageHeader *message)
1189 {
1190   struct GNUNET_MESH_ConnectionCreate *msg;
1191   struct GNUNET_PeerIdentity *id;
1192   struct GNUNET_HashCode *cid;
1193   struct MeshPeerPath *path;
1194   struct MeshPeer *dest_peer;
1195   struct MeshPeer *orig_peer;
1196   struct MeshConnection *c;
1197   unsigned int own_pos;
1198   uint16_t size;
1199   uint16_t i;
1200
1201   LOG (GNUNET_ERROR_TYPE_DEBUG, "\n\n");
1202   LOG (GNUNET_ERROR_TYPE_DEBUG, "Received a connection create msg\n");
1203
1204   /* Check size */
1205   size = ntohs (message->size);
1206   if (size < sizeof (struct GNUNET_MESH_ConnectionCreate))
1207   {
1208     GNUNET_break_op (0);
1209     return GNUNET_OK;
1210   }
1211
1212   /* Calculate hops */
1213   size -= sizeof (struct GNUNET_MESH_ConnectionCreate);
1214   if (size % sizeof (struct GNUNET_PeerIdentity))
1215   {
1216     GNUNET_break_op (0);
1217     return GNUNET_OK;
1218   }
1219   size /= sizeof (struct GNUNET_PeerIdentity);
1220   if (1 > size)
1221   {
1222     GNUNET_break_op (0);
1223     return GNUNET_OK;
1224   }
1225   LOG (GNUNET_ERROR_TYPE_DEBUG, "    path has %u hops.\n", size);
1226
1227   /* Get parameters */
1228   msg = (struct GNUNET_MESH_ConnectionCreate *) message;
1229   cid = &msg->cid;
1230   id = (struct GNUNET_PeerIdentity *) &msg[1];
1231   LOG (GNUNET_ERROR_TYPE_DEBUG,
1232               "    connection %s (%s).\n",
1233               GNUNET_h2s (cid), GNUNET_i2s (id));
1234
1235   /* Create connection */
1236   c = connection_get (cid);
1237   if (NULL == c)
1238   {
1239     /* Create path */
1240     LOG (GNUNET_ERROR_TYPE_DEBUG, "  Creating path...\n");
1241     path = path_new (size);
1242     own_pos = 0;
1243     for (i = 0; i < size; i++)
1244     {
1245       LOG (GNUNET_ERROR_TYPE_DEBUG, "  ... adding %s\n",
1246                   GNUNET_i2s (&id[i]));
1247       path->peers[i] = GNUNET_PEER_intern (&id[i]);
1248       if (path->peers[i] == myid)
1249         own_pos = i;
1250     }
1251     if (own_pos == 0 && path->peers[own_pos] != myid)
1252     {
1253       /* create path: self not found in path through self */
1254       GNUNET_break_op (0);
1255       path_destroy (path);
1256       return GNUNET_OK;
1257     }
1258     LOG (GNUNET_ERROR_TYPE_DEBUG, "  Own position: %u\n", own_pos);
1259     GMP_add_path_to_all (path, GNUNET_NO);
1260         LOG (GNUNET_ERROR_TYPE_DEBUG, "  Creating connection\n");
1261     c = GMC_new (cid, NULL, path_duplicate (path), own_pos);
1262     if (NULL == c)
1263     {
1264       path_destroy (path);
1265       return GNUNET_OK;
1266     }
1267     connection_reset_timeout (c, GNUNET_YES);
1268   }
1269   else
1270   {
1271     path = path_duplicate (c->path);
1272   }
1273   if (MESH_CONNECTION_NEW == c->state)
1274     connection_change_state (c, MESH_CONNECTION_SENT);
1275
1276   /* Remember peers */
1277   dest_peer = GMP_get (&id[size - 1]);
1278   orig_peer = GMP_get (&id[0]);
1279
1280   /* Is it a connection to us? */
1281   if (c->own_pos == size - 1)
1282   {
1283     LOG (GNUNET_ERROR_TYPE_DEBUG, "  It's for us!\n");
1284     GMP_add_path_to_origin (orig_peer, path_duplicate (path), GNUNET_YES);
1285
1286     add_to_peer (c, orig_peer);
1287     if (MESH_TUNNEL3_NEW == GMT_get_state (c->t))
1288       GMT_change_state (c->t,  MESH_TUNNEL3_WAITING);
1289
1290     send_connection_ack (c, GNUNET_NO);
1291     if (MESH_CONNECTION_SENT == c->state)
1292       connection_change_state (c, MESH_CONNECTION_ACK);
1293
1294     /* Keep tunnel alive in direction dest->owner*/
1295     c->bck_maintenance_task =
1296             GNUNET_SCHEDULER_add_delayed (create_connection_time,
1297                                           &connection_bck_keepalive, c);
1298   }
1299   else
1300   {
1301     /* It's for somebody else! Retransmit. */
1302     LOG (GNUNET_ERROR_TYPE_DEBUG, "  Retransmitting.\n");
1303     GMP_add_path (dest_peer, path_duplicate (path), GNUNET_NO);
1304     GMP_add_path_to_origin (orig_peer, path_duplicate (path), GNUNET_NO);
1305     GMC_send_prebuilt_message (message, c, GNUNET_YES, NULL, NULL);
1306   }
1307   path_destroy (path);
1308   return GNUNET_OK;
1309 }
1310
1311
1312 /**
1313  * Core handler for path confirmations.
1314  *
1315  * @param cls closure
1316  * @param message message
1317  * @param peer peer identity this notification is about
1318  *
1319  * @return GNUNET_OK to keep the connection open,
1320  *         GNUNET_SYSERR to close it (signal serious error)
1321  */
1322 int
1323 GMC_handle_confirm (void *cls, const struct GNUNET_PeerIdentity *peer,
1324                     const struct GNUNET_MessageHeader *message)
1325 {
1326   struct GNUNET_MESH_ConnectionACK *msg;
1327   struct MeshConnection *c;
1328   struct MeshPeerPath *p;
1329   struct MeshPeer *pi;
1330   enum MeshConnectionState oldstate;
1331   int fwd;
1332
1333   LOG (GNUNET_ERROR_TYPE_DEBUG, "\n\n");
1334   LOG (GNUNET_ERROR_TYPE_DEBUG, "Received a connection ACK msg\n");
1335   msg = (struct GNUNET_MESH_ConnectionACK *) message;
1336   LOG (GNUNET_ERROR_TYPE_DEBUG, "  on connection %s\n",
1337               GNUNET_h2s (&msg->cid));
1338   c = connection_get (&msg->cid);
1339   if (NULL == c)
1340   {
1341     GNUNET_STATISTICS_update (stats, "# control on unknown connection",
1342                               1, GNUNET_NO);
1343     LOG (GNUNET_ERROR_TYPE_DEBUG, "  don't know the connection!\n");
1344     return GNUNET_OK;
1345   }
1346
1347   oldstate = c->state;
1348   LOG (GNUNET_ERROR_TYPE_DEBUG, "  via peer %s\n", GNUNET_i2s (peer));
1349   pi = GMP_get (peer);
1350   if (get_next_hop (c) == pi)
1351   {
1352     LOG (GNUNET_ERROR_TYPE_DEBUG, "  SYNACK\n");
1353     fwd = GNUNET_NO;
1354     if (MESH_CONNECTION_SENT == oldstate)
1355       connection_change_state (c, MESH_CONNECTION_ACK);
1356   }
1357   else if (get_prev_hop (c) == pi)
1358   {
1359     LOG (GNUNET_ERROR_TYPE_DEBUG, "  ACK\n");
1360     fwd = GNUNET_YES;
1361     connection_change_state (c, MESH_CONNECTION_READY);
1362   }
1363   else
1364   {
1365     GNUNET_break_op (0);
1366     return GNUNET_OK;
1367   }
1368
1369   connection_reset_timeout (c, fwd);
1370
1371   /* Add path to peers? */
1372   p = c->path;
1373   if (NULL != p)
1374   {
1375     GMP_add_path_to_all (p, GNUNET_YES);
1376   }
1377   else
1378   {
1379     GNUNET_break (0);
1380   }
1381
1382   /* Message for us as creator? */
1383   if (GMC_is_origin (c, GNUNET_YES))
1384   {
1385     if (GNUNET_NO != fwd)
1386     {
1387       GNUNET_break_op (0);
1388       return GNUNET_OK;
1389     }
1390     LOG (GNUNET_ERROR_TYPE_DEBUG, "  Connection (SYN)ACK for us!\n");
1391
1392     /* If just created, cancel the short timeout and start a long one */
1393     if (MESH_CONNECTION_SENT == oldstate)
1394       connection_reset_timeout (c, GNUNET_YES);
1395
1396     /* Change connection and tunnel state */
1397     connection_change_state (c, MESH_CONNECTION_READY);
1398     if (MESH_TUNNEL3_WAITING == GMT_get_state (c->t))
1399       GMT_change_state (c->t, MESH_TUNNEL3_READY);
1400
1401     /* Send ACK (~TCP ACK)*/
1402     send_connection_ack (c, GNUNET_YES);
1403     return GNUNET_OK;
1404   }
1405
1406   /* Message for us as destination? */
1407   if (GMC_is_terminal (c, GNUNET_YES))
1408   {
1409     if (GNUNET_YES != fwd)
1410     {
1411       GNUNET_break_op (0);
1412       return GNUNET_OK;
1413     }
1414     LOG (GNUNET_ERROR_TYPE_DEBUG, "  Connection ACK for us!\n");
1415
1416     /* If just created, cancel the short timeout and start a long one */
1417     if (MESH_CONNECTION_ACK == oldstate)
1418       connection_reset_timeout (c, GNUNET_NO);
1419
1420     /* Change tunnel state */
1421     if (MESH_TUNNEL3_WAITING == GMT_get_state (c->t))
1422       GMT_change_state (c->t, MESH_TUNNEL3_READY);
1423
1424     return GNUNET_OK;
1425   }
1426
1427   LOG (GNUNET_ERROR_TYPE_DEBUG, "  not for us, retransmitting...\n");
1428   GMC_send_prebuilt_message (message, c, fwd, NULL, NULL);
1429   return GNUNET_OK;
1430 }
1431
1432
1433 /**
1434  * Core handler for notifications of broken paths
1435  *
1436  * @param cls Closure (unused).
1437  * @param id Peer identity of sending neighbor.
1438  * @param message Message.
1439  *
1440  * @return GNUNET_OK to keep the connection open,
1441  *         GNUNET_SYSERR to close it (signal serious error)
1442  */
1443 int
1444 GMC_handle_broken (void* cls,
1445                    const struct GNUNET_PeerIdentity* id,
1446                    const struct GNUNET_MessageHeader* message)
1447 {
1448   struct GNUNET_MESH_ConnectionBroken *msg;
1449   struct MeshConnection *c;
1450   int fwd;
1451
1452   LOG (GNUNET_ERROR_TYPE_DEBUG,
1453               "Received a CONNECTION BROKEN msg from %s\n", GNUNET_i2s (id));
1454   msg = (struct GNUNET_MESH_ConnectionBroken *) message;
1455   LOG (GNUNET_ERROR_TYPE_DEBUG, "  regarding %s\n",
1456               GNUNET_i2s (&msg->peer1));
1457   LOG (GNUNET_ERROR_TYPE_DEBUG, "  regarding %s\n",
1458               GNUNET_i2s (&msg->peer2));
1459   c = connection_get (&msg->cid);
1460   if (NULL == c)
1461   {
1462     GNUNET_break_op (0);
1463     return GNUNET_OK;
1464   }
1465
1466   fwd = is_fwd (c, id);
1467   connection_cancel_queues (c, !fwd);
1468   if (GMC_is_terminal (c, fwd))
1469   {
1470     if (0 < c->pending_messages)
1471       c->destroy = GNUNET_YES;
1472     else
1473       GMC_destroy (c);
1474   }
1475   else
1476   {
1477     GMC_send_prebuilt_message (message, c, fwd, NULL, NULL);
1478     c->destroy = GNUNET_YES;
1479   }
1480
1481   return GNUNET_OK;
1482
1483 }
1484
1485
1486 /**
1487  * Core handler for tunnel destruction
1488  *
1489  * @param cls Closure (unused).
1490  * @param peer Peer identity of sending neighbor.
1491  * @param message Message.
1492  *
1493  * @return GNUNET_OK to keep the connection open,
1494  *         GNUNET_SYSERR to close it (signal serious error)
1495  */
1496 int
1497 GMC_handle_destroy (void *cls, const struct GNUNET_PeerIdentity *peer,
1498                     const struct GNUNET_MessageHeader *message)
1499 {
1500   struct GNUNET_MESH_ConnectionDestroy *msg;
1501   struct MeshConnection *c;
1502   int fwd;
1503
1504   msg = (struct GNUNET_MESH_ConnectionDestroy *) message;
1505   LOG (GNUNET_ERROR_TYPE_DEBUG,
1506               "Got a CONNECTION DESTROY message from %s\n",
1507               GNUNET_i2s (peer));
1508   LOG (GNUNET_ERROR_TYPE_DEBUG,
1509               "  for connection %s\n",
1510               GNUNET_h2s (&msg->cid));
1511   c = connection_get (&msg->cid);
1512   if (NULL == c)
1513   {
1514     /* Probably already got the message from another path,
1515      * destroyed the tunnel and retransmitted to children.
1516      * Safe to ignore.
1517      */
1518     GNUNET_STATISTICS_update (stats, "# control on unknown tunnel",
1519                               1, GNUNET_NO);
1520     return GNUNET_OK;
1521   }
1522   fwd = is_fwd (c, peer);
1523   if (GNUNET_SYSERR == fwd)
1524   {
1525     GNUNET_break_op (0);
1526     return GNUNET_OK;
1527   }
1528   GMC_send_prebuilt_message (message, c, fwd, NULL, NULL);
1529   c->destroy = GNUNET_YES;
1530   c->state = MESH_CONNECTION_DESTROYED;
1531
1532   return GNUNET_OK;
1533 }
1534
1535 /**
1536  * Generic handler for mesh network encrypted traffic.
1537  *
1538  * @param peer Peer identity this notification is about.
1539  * @param msg Encrypted message.
1540  *
1541  * @return GNUNET_OK to keep the connection open,
1542  *         GNUNET_SYSERR to close it (signal serious error)
1543  */
1544 static int
1545 handle_mesh_encrypted (const struct GNUNET_PeerIdentity *peer,
1546                        const struct GNUNET_MESH_Encrypted *msg)
1547 {
1548   struct MeshConnection *c;
1549   struct MeshPeer *neighbor;
1550   struct MeshFlowControl *fc;
1551   GNUNET_PEER_Id peer_id;
1552   uint32_t pid;
1553   uint32_t ttl;
1554   uint16_t type;
1555   size_t size;
1556   int fwd;
1557
1558   /* Check size */
1559   size = ntohs (msg->header.size);
1560   if (size <
1561       sizeof (struct GNUNET_MESH_Encrypted) +
1562       sizeof (struct GNUNET_MessageHeader))
1563   {
1564     GNUNET_break_op (0);
1565     return GNUNET_OK;
1566   }
1567   type = ntohs (msg->header.type);
1568   LOG (GNUNET_ERROR_TYPE_DEBUG, "\n\n");
1569   LOG (GNUNET_ERROR_TYPE_DEBUG, "got a %s message (#%u) from %s\n",
1570        GNUNET_MESH_DEBUG_M2S (type), ntohl (msg->pid), GNUNET_i2s (peer));
1571
1572   /* Check connection */
1573   c = connection_get (&msg->cid);
1574   if (NULL == c)
1575   {
1576     GNUNET_STATISTICS_update (stats, "# unknown connection", 1, GNUNET_NO);
1577     LOG (GNUNET_ERROR_TYPE_DEBUG,
1578          "WARNING connection %s unknown\n",
1579          GNUNET_h2s (&msg->cid));
1580     return GNUNET_OK;
1581   }
1582
1583   /* Check if origin is as expected */
1584   neighbor = get_prev_hop (c);
1585   peer_id = GNUNET_PEER_search (peer);
1586   if (peer_id == GMP_get_short_id (neighbor))
1587   {
1588     fwd = GNUNET_YES;
1589   }
1590   else
1591   {
1592     neighbor = get_next_hop (c);
1593     if (peer_id == GMP_get_short_id (neighbor))
1594     {
1595       fwd = GNUNET_NO;
1596     }
1597     else
1598     {
1599       /* Unexpected peer sending traffic on a connection. */
1600       GNUNET_break_op (0);
1601       return GNUNET_OK;
1602     }
1603   }
1604
1605   /* Check PID */
1606   fc = fwd ? &c->bck_fc : &c->fwd_fc;
1607   pid = ntohl (msg->pid);
1608   if (GMC_is_pid_bigger (pid, fc->last_ack_sent))
1609   {
1610     GNUNET_STATISTICS_update (stats, "# unsolicited message", 1, GNUNET_NO);
1611     LOG (GNUNET_ERROR_TYPE_DEBUG,
1612                 "WARNING Received PID %u, (prev %u), ACK %u\n",
1613                 pid, fc->last_pid_recv, fc->last_ack_sent);
1614     return GNUNET_OK;
1615   }
1616   if (GNUNET_NO == GMC_is_pid_bigger (pid, fc->last_pid_recv))
1617   {
1618     GNUNET_STATISTICS_update (stats, "# duplicate PID", 1, GNUNET_NO);
1619     LOG (GNUNET_ERROR_TYPE_DEBUG,
1620                 " Pid %u not expected (%u+), dropping!\n",
1621                 pid, fc->last_pid_recv + 1);
1622     return GNUNET_OK;
1623   }
1624   if (MESH_CONNECTION_SENT == c->state || MESH_CONNECTION_ACK == c->state)
1625     connection_change_state (c, MESH_CONNECTION_READY);
1626   connection_reset_timeout (c, fwd);
1627   fc->last_pid_recv = pid;
1628
1629   /* Is this message for us? */
1630   if (GMC_is_terminal (c, fwd))
1631   {
1632     /* TODO signature verification */
1633     LOG (GNUNET_ERROR_TYPE_DEBUG, "  message for us!\n");
1634     GNUNET_STATISTICS_update (stats, "# messages received", 1, GNUNET_NO);
1635
1636     if (NULL == c->t)
1637     {
1638       GNUNET_break (0);
1639       return GNUNET_OK;
1640     }
1641     fc->last_pid_recv = pid;
1642     GMT_handle_encrypted (c->t, msg);
1643     GMC_send_ack (c, fwd, GNUNET_NO);
1644     return GNUNET_OK;
1645   }
1646
1647   /* Message not for us: forward to next hop */
1648   LOG (GNUNET_ERROR_TYPE_DEBUG, "  not for us, retransmitting...\n");
1649   ttl = ntohl (msg->ttl);
1650   LOG (GNUNET_ERROR_TYPE_DEBUG, "   ttl: %u\n", ttl);
1651   if (ttl == 0)
1652   {
1653     GNUNET_STATISTICS_update (stats, "# TTL drops", 1, GNUNET_NO);
1654     LOG (GNUNET_ERROR_TYPE_WARNING, " TTL is 0, DROPPING!\n");
1655     GMC_send_ack (c, fwd, GNUNET_NO);
1656     return GNUNET_OK;
1657   }
1658
1659   GNUNET_STATISTICS_update (stats, "# messages forwarded", 1, GNUNET_NO);
1660   GMC_send_prebuilt_message (&msg->header, c, fwd, NULL, NULL);
1661
1662   return GNUNET_OK;
1663 }
1664
1665 /**
1666  * Generic handler for mesh network encrypted traffic.
1667  *
1668  * @param peer Peer identity this notification is about.
1669  * @param msg Encrypted message.
1670  *
1671  * @return GNUNET_OK to keep the connection open,
1672  *         GNUNET_SYSERR to close it (signal serious error)
1673  */
1674 static int
1675 handle_mesh_kx (const struct GNUNET_PeerIdentity *peer,
1676                 const struct GNUNET_MESH_KX *msg)
1677 {
1678   struct MeshConnection *c;
1679   struct MeshPeer *neighbor;
1680   GNUNET_PEER_Id peer_id;
1681   size_t size;
1682   uint16_t type;
1683   int fwd;
1684
1685   /* Check size */
1686   size = ntohs (msg->header.size);
1687   if (size <
1688       sizeof (struct GNUNET_MESH_Encrypted) +
1689       sizeof (struct GNUNET_MessageHeader))
1690   {
1691     GNUNET_break_op (0);
1692     return GNUNET_OK;
1693   }
1694   type = ntohs (msg->header.type);
1695   LOG (GNUNET_ERROR_TYPE_DEBUG, "\n\n");
1696   LOG (GNUNET_ERROR_TYPE_DEBUG, "got a %s message from %s\n",
1697               GNUNET_MESH_DEBUG_M2S (type), GNUNET_i2s (peer));
1698
1699   /* Check connection */
1700   c = connection_get (&msg->cid);
1701   if (NULL == c)
1702   {
1703     GNUNET_STATISTICS_update (stats, "# unknown connection", 1, GNUNET_NO);
1704     LOG (GNUNET_ERROR_TYPE_DEBUG, "WARNING connection unknown\n");
1705     return GNUNET_OK;
1706   }
1707
1708   /* Check if origin is as expected */
1709   neighbor = get_prev_hop (c);
1710   peer_id = GNUNET_PEER_search (peer);
1711   if (peer_id == GMP_get_short_id (neighbor))
1712   {
1713     fwd = GNUNET_YES;
1714   }
1715   else
1716   {
1717     neighbor = get_next_hop (c);
1718     if (peer_id == GMP_get_short_id (neighbor))
1719     {
1720       fwd = GNUNET_NO;
1721     }
1722     else
1723     {
1724       /* Unexpected peer sending traffic on a connection. */
1725       GNUNET_break_op (0);
1726       return GNUNET_OK;
1727     }
1728   }
1729
1730   /* Count as connection confirmation. */
1731   if (MESH_CONNECTION_SENT == c->state || MESH_CONNECTION_ACK == c->state)
1732     connection_change_state (c, MESH_CONNECTION_READY);
1733   connection_reset_timeout (c, fwd);
1734   if (NULL != c->t)
1735   {
1736     if (MESH_TUNNEL3_WAITING == GMT_get_state (c->t))
1737       GMT_change_state (c->t, MESH_TUNNEL3_READY);
1738   }
1739
1740   /* Is this message for us? */
1741   if (GMC_is_terminal (c, fwd))
1742   {
1743     LOG (GNUNET_ERROR_TYPE_DEBUG, "  message for us!\n");
1744     GNUNET_STATISTICS_update (stats, "# messages received", 1, GNUNET_NO);
1745     if (NULL == c->t)
1746     {
1747       GNUNET_break (0);
1748       return GNUNET_OK;
1749     }
1750     GMT_handle_kx (c->t, &msg[1].header);
1751     return GNUNET_OK;
1752   }
1753
1754   /* Message not for us: forward to next hop */
1755   LOG (GNUNET_ERROR_TYPE_DEBUG, "  not for us, retransmitting...\n");
1756   GNUNET_STATISTICS_update (stats, "# messages forwarded", 1, GNUNET_NO);
1757   GMC_send_prebuilt_message (&msg->header, c, fwd, NULL, NULL);
1758
1759   return GNUNET_OK;
1760 }
1761
1762
1763 /**
1764  * Core handler for encrypted mesh network traffic (channel mgmt, data).
1765  *
1766  * @param cls Closure (unused).
1767  * @param message Message received.
1768  * @param peer Peer who sent the message.
1769  *
1770  * @return GNUNET_OK to keep the connection open,
1771  *         GNUNET_SYSERR to close it (signal serious error)
1772  */
1773 int
1774 GMC_handle_encrypted (void *cls, const struct GNUNET_PeerIdentity *peer,
1775                       const struct GNUNET_MessageHeader *message)
1776 {
1777   return handle_mesh_encrypted (peer,
1778                                 (struct GNUNET_MESH_Encrypted *)message);
1779 }
1780
1781
1782 /**
1783  * Core handler for key exchange traffic (ephemeral key, ping, pong).
1784  *
1785  * @param cls Closure (unused).
1786  * @param message Message received.
1787  * @param peer Peer who sent the message.
1788  *
1789  * @return GNUNET_OK to keep the connection open,
1790  *         GNUNET_SYSERR to close it (signal serious error)
1791  */
1792 int
1793 GMC_handle_kx (void *cls, const struct GNUNET_PeerIdentity *peer,
1794                const struct GNUNET_MessageHeader *message)
1795 {
1796   return handle_mesh_kx (peer,
1797                          (struct GNUNET_MESH_KX *) message);
1798 }
1799
1800
1801 /**
1802  * Core handler for mesh network traffic point-to-point acks.
1803  *
1804  * @param cls closure
1805  * @param message message
1806  * @param peer peer identity this notification is about
1807  *
1808  * @return GNUNET_OK to keep the connection open,
1809  *         GNUNET_SYSERR to close it (signal serious error)
1810  */
1811 int
1812 GMC_handle_ack (void *cls, const struct GNUNET_PeerIdentity *peer,
1813                 const struct GNUNET_MessageHeader *message)
1814 {
1815   struct GNUNET_MESH_ACK *msg;
1816   struct MeshConnection *c;
1817   struct MeshFlowControl *fc;
1818   GNUNET_PEER_Id id;
1819   uint32_t ack;
1820   int fwd;
1821
1822   LOG (GNUNET_ERROR_TYPE_DEBUG, "\n\n");
1823   LOG (GNUNET_ERROR_TYPE_DEBUG, "Got an ACK packet from %s!\n",
1824               GNUNET_i2s (peer));
1825   msg = (struct GNUNET_MESH_ACK *) message;
1826
1827   c = connection_get (&msg->cid);
1828
1829   if (NULL == c)
1830   {
1831     GNUNET_STATISTICS_update (stats, "# ack on unknown connection", 1,
1832                               GNUNET_NO);
1833     return GNUNET_OK;
1834   }
1835
1836   /* Is this a forward or backward ACK? */
1837   id = GNUNET_PEER_search (peer);
1838   if (GMP_get_short_id (get_next_hop (c)) == id)
1839   {
1840     LOG (GNUNET_ERROR_TYPE_DEBUG, "  FWD ACK\n");
1841     fc = &c->fwd_fc;
1842     fwd = GNUNET_YES;
1843   }
1844   else if (GMP_get_short_id (get_prev_hop (c)) == id)
1845   {
1846     LOG (GNUNET_ERROR_TYPE_DEBUG, "  BCK ACK\n");
1847     fc = &c->bck_fc;
1848     fwd = GNUNET_NO;
1849   }
1850   else
1851   {
1852     GNUNET_break_op (0);
1853     return GNUNET_OK;
1854   }
1855
1856   ack = ntohl (msg->ack);
1857   LOG (GNUNET_ERROR_TYPE_DEBUG, "  ACK %u (was %u)\n",
1858               ack, fc->last_ack_recv);
1859   if (GMC_is_pid_bigger (ack, fc->last_ack_recv))
1860     fc->last_ack_recv = ack;
1861
1862   /* Cancel polling if the ACK is big enough. */
1863   if (GNUNET_SCHEDULER_NO_TASK != fc->poll_task &&
1864       GMC_is_pid_bigger (fc->last_ack_recv, fc->last_pid_sent))
1865   {
1866     LOG (GNUNET_ERROR_TYPE_DEBUG, "  Cancel poll\n");
1867     GNUNET_SCHEDULER_cancel (fc->poll_task);
1868     fc->poll_task = GNUNET_SCHEDULER_NO_TASK;
1869     fc->poll_time = GNUNET_TIME_UNIT_SECONDS;
1870   }
1871
1872   connection_unlock_queue (c, fwd);
1873
1874   return GNUNET_OK;
1875 }
1876
1877
1878 /**
1879  * Core handler for mesh network traffic point-to-point ack polls.
1880  *
1881  * @param cls closure
1882  * @param message message
1883  * @param peer peer identity this notification is about
1884  *
1885  * @return GNUNET_OK to keep the connection open,
1886  *         GNUNET_SYSERR to close it (signal serious error)
1887  */
1888 int
1889 GMC_handle_poll (void *cls, const struct GNUNET_PeerIdentity *peer,
1890                  const struct GNUNET_MessageHeader *message)
1891 {
1892   struct GNUNET_MESH_Poll *msg;
1893   struct MeshConnection *c;
1894   struct MeshFlowControl *fc;
1895   GNUNET_PEER_Id id;
1896   uint32_t pid;
1897   int fwd;
1898
1899   LOG (GNUNET_ERROR_TYPE_DEBUG, "\n\n");
1900   LOG (GNUNET_ERROR_TYPE_DEBUG,
1901        "Got a POLL packet from %s!\n",
1902        GNUNET_i2s (peer));
1903
1904   msg = (struct GNUNET_MESH_Poll *) message;
1905
1906   c = connection_get (&msg->cid);
1907
1908   if (NULL == c)
1909   {
1910     GNUNET_STATISTICS_update (stats, "# poll on unknown connection", 1,
1911                               GNUNET_NO);
1912     GNUNET_break_op (0);
1913     return GNUNET_OK;
1914   }
1915
1916   /* Is this a forward or backward ACK?
1917    * Note: a poll should never be needed in a loopback case,
1918    * since there is no possiblility of packet loss there, so
1919    * this way of discerining FWD/BCK should not be a problem.
1920    */
1921   id = GNUNET_PEER_search (peer);
1922   if (GMP_get_short_id (get_next_hop (c)) == id)
1923   {
1924     LOG (GNUNET_ERROR_TYPE_DEBUG, "  FWD FC\n");
1925     fc = &c->fwd_fc;
1926   }
1927   else if (GMP_get_short_id (get_prev_hop (c)) == id)
1928   {
1929     LOG (GNUNET_ERROR_TYPE_DEBUG, "  BCK FC\n");
1930     fc = &c->bck_fc;
1931   }
1932   else
1933   {
1934     GNUNET_break_op (0);
1935     return GNUNET_OK;
1936   }
1937
1938   pid = ntohl (msg->pid);
1939   LOG (GNUNET_ERROR_TYPE_DEBUG, "  PID %u, OLD %u\n", pid, fc->last_pid_recv);
1940   fc->last_pid_recv = pid;
1941   fwd = fc == &c->bck_fc;
1942   GMC_send_ack (c, fwd, GNUNET_YES);
1943
1944   return GNUNET_OK;
1945 }
1946
1947
1948 /**
1949  * Core handler for mesh keepalives.
1950  *
1951  * @param cls closure
1952  * @param message message
1953  * @param peer peer identity this notification is about
1954  * @return GNUNET_OK to keep the connection open,
1955  *         GNUNET_SYSERR to close it (signal serious error)
1956  *
1957  * TODO: Check who we got this from, to validate route.
1958  */
1959 int
1960 GMC_handle_keepalive (void *cls, const struct GNUNET_PeerIdentity *peer,
1961                       const struct GNUNET_MessageHeader *message)
1962 {
1963   struct GNUNET_MESH_ConnectionKeepAlive *msg;
1964   struct MeshConnection *c;
1965   struct MeshPeer *neighbor;
1966   int fwd;
1967
1968   msg = (struct GNUNET_MESH_ConnectionKeepAlive *) message;
1969   LOG (GNUNET_ERROR_TYPE_DEBUG, "got a keepalive packet from %s\n",
1970               GNUNET_i2s (peer));
1971
1972   c = connection_get (&msg->cid);
1973   if (NULL == c)
1974   {
1975     GNUNET_STATISTICS_update (stats, "# keepalive on unknown connection", 1,
1976                               GNUNET_NO);
1977     return GNUNET_OK;
1978   }
1979
1980   fwd = GNUNET_MESSAGE_TYPE_MESH_FWD_KEEPALIVE == ntohs (message->type) ?
1981         GNUNET_YES : GNUNET_NO;
1982
1983   /* Check if origin is as expected */
1984   neighbor = get_hop (c, fwd);
1985   if (GNUNET_PEER_search (peer) != GMP_get_short_id (neighbor))
1986   {
1987     GNUNET_break_op (0);
1988     return GNUNET_OK;
1989   }
1990
1991   connection_change_state (c, MESH_CONNECTION_READY);
1992   connection_reset_timeout (c, fwd);
1993
1994   if (GMC_is_terminal (c, fwd))
1995     return GNUNET_OK;
1996
1997   GNUNET_STATISTICS_update (stats, "# keepalives forwarded", 1, GNUNET_NO);
1998   GMC_send_prebuilt_message (message, c, fwd, NULL, NULL);
1999
2000   return GNUNET_OK;
2001 }
2002
2003
2004 /**
2005  * Send an ACK on the appropriate connection/channel, depending on
2006  * the direction and the position of the peer.
2007  *
2008  * @param c Which connection to send the hop-by-hop ACK.
2009  * @param fwd Is this a fwd ACK? (will go dest->root).
2010  * @param force Send the ACK even if suboptimal (e.g. requested by POLL).
2011  */
2012 void
2013 GMC_send_ack (struct MeshConnection *c, int fwd, int force)
2014 {
2015   unsigned int buffer;
2016
2017   LOG (GNUNET_ERROR_TYPE_DEBUG,
2018        "GMC send %s ACK on %s\n",
2019        fwd ? "FWD" : "BCK", GMC_2s (c));
2020
2021   if (NULL == c)
2022   {
2023     GNUNET_break (0);
2024     return;
2025   }
2026
2027   if (GNUNET_NO != c->destroy)
2028   {
2029     LOG (GNUNET_ERROR_TYPE_DEBUG, "  being destroyed, why bother...\n");
2030     return;
2031   }
2032
2033   /* Get available buffer space */
2034   if (GMC_is_terminal (c, fwd))
2035   {
2036     LOG (GNUNET_ERROR_TYPE_DEBUG, "  getting from all channels\n");
2037     buffer = GMT_get_channels_buffer (c->t);
2038   }
2039   else
2040   {
2041     LOG (GNUNET_ERROR_TYPE_DEBUG, "  getting from one connection\n");
2042     buffer = GMC_get_buffer (c, fwd);
2043   }
2044   LOG (GNUNET_ERROR_TYPE_DEBUG, "  buffer available: %u\n", buffer);
2045   if (0 == buffer && GNUNET_NO == force)
2046     return;
2047
2048   /* Send available buffer space */
2049   if (GMC_is_origin (c, fwd))
2050   {
2051     GNUNET_assert (NULL != c->t);
2052     LOG (GNUNET_ERROR_TYPE_DEBUG, "  sending on channels...\n");
2053     GMT_unchoke_channels (c->t);
2054   }
2055   else
2056   {
2057     LOG (GNUNET_ERROR_TYPE_DEBUG, "  sending on connection\n");
2058     send_ack (c, buffer, fwd, force);
2059   }
2060 }
2061
2062
2063 /**
2064  * Initialize the connections subsystem
2065  *
2066  * @param c Configuration handle.
2067  */
2068 void
2069 GMC_init (const struct GNUNET_CONFIGURATION_Handle *c)
2070 {
2071   LOG (GNUNET_ERROR_TYPE_DEBUG, "init\n");
2072   if (GNUNET_OK !=
2073       GNUNET_CONFIGURATION_get_value_number (c, "MESH", "MAX_MSGS_QUEUE",
2074                                              &max_msgs_queue))
2075   {
2076     GNUNET_log_config_invalid (GNUNET_ERROR_TYPE_ERROR,
2077                                "MESH", "MAX_MSGS_QUEUE", "MISSING");
2078     GNUNET_SCHEDULER_shutdown ();
2079     return;
2080   }
2081
2082   if (GNUNET_OK !=
2083       GNUNET_CONFIGURATION_get_value_number (c, "MESH", "MAX_CONNECTIONS",
2084                                              &max_connections))
2085   {
2086     GNUNET_log_config_invalid (GNUNET_ERROR_TYPE_ERROR,
2087                                "MESH", "MAX_CONNECTIONS", "MISSING");
2088     GNUNET_SCHEDULER_shutdown ();
2089     return;
2090   }
2091
2092   if (GNUNET_OK !=
2093       GNUNET_CONFIGURATION_get_value_time (c, "MESH", "REFRESH_CONNECTION_TIME",
2094                                            &refresh_connection_time))
2095   {
2096     GNUNET_log_config_invalid (GNUNET_ERROR_TYPE_ERROR,
2097                                "MESH", "REFRESH_CONNECTION_TIME", "MISSING");
2098     GNUNET_SCHEDULER_shutdown ();
2099     return;
2100   }
2101   create_connection_time = GNUNET_TIME_UNIT_SECONDS;
2102   connections = GNUNET_CONTAINER_multihashmap_create (1024, GNUNET_YES);
2103 }
2104
2105
2106 /**
2107  * Destroy each connection on shutdown.
2108  *
2109  * @param cls Closure (unused).
2110  * @param key Current key code (CID, unused).
2111  * @param value Value in the hash map (connection)
2112  *
2113  * @return #GNUNET_YES, because we should continue to iterate,
2114  */
2115 static int
2116 shutdown_iterator (void *cls,
2117                    const struct GNUNET_HashCode *key,
2118                    void *value)
2119 {
2120   struct MeshConnection *c = value;
2121
2122   GMC_destroy (c);
2123   return GNUNET_YES;
2124 }
2125
2126
2127 /**
2128  * Shut down the connections subsystem.
2129  */
2130 void
2131 GMC_shutdown (void)
2132 {
2133   GNUNET_CONTAINER_multihashmap_iterate (connections, &shutdown_iterator, NULL);
2134   GNUNET_CONTAINER_multihashmap_destroy (connections);
2135   connections = NULL;
2136 }
2137
2138
2139 struct MeshConnection *
2140 GMC_new (const struct GNUNET_HashCode *cid,
2141          struct MeshTunnel3 *t,
2142          struct MeshPeerPath *p,
2143          unsigned int own_pos)
2144 {
2145   struct MeshConnection *c;
2146
2147   c = GNUNET_new (struct MeshConnection);
2148   c->id = *cid;
2149   GNUNET_CONTAINER_multihashmap_put (connections, &c->id, c,
2150                                      GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST);
2151   fc_init (&c->fwd_fc);
2152   fc_init (&c->bck_fc);
2153   c->fwd_fc.c = c;
2154   c->bck_fc.c = c;
2155
2156   c->t = t;
2157   if (own_pos > p->length - 1)
2158   {
2159     GNUNET_break (0);
2160     GMC_destroy (c);
2161     return NULL;
2162   }
2163   c->own_pos = own_pos;
2164   c->path = p;
2165
2166   if (0 == own_pos)
2167   {
2168     c->fwd_maintenance_task =
2169             GNUNET_SCHEDULER_add_delayed (create_connection_time,
2170                                           &connection_fwd_keepalive, c);
2171   }
2172   if (GNUNET_OK != register_neighbors (c))
2173   {
2174     GMC_destroy (c);
2175     return NULL;
2176   }
2177
2178   return c;
2179 }
2180
2181
2182 void
2183 GMC_destroy (struct MeshConnection *c)
2184 {
2185   if (NULL == c)
2186     return;
2187
2188   if (2 == c->destroy) /* cancel queues -> GMP_queue_cancel -> q_destroy -> */
2189     return;            /* -> message_sent -> GMC_destroy. Don't loop. */
2190   c->destroy = 2;
2191
2192   LOG (GNUNET_ERROR_TYPE_DEBUG, "destroying connection %s\n", GMC_2s (c));
2193   LOG (GNUNET_ERROR_TYPE_DEBUG, " fc's f: %p, b: %p\n",
2194        &c->fwd_fc, &c->bck_fc);
2195   LOG (GNUNET_ERROR_TYPE_DEBUG, " fc tasks f: %u, b: %u\n",
2196        c->fwd_fc.poll_task, c->bck_fc.poll_task);
2197
2198   /* Cancel all traffic */
2199   connection_cancel_queues (c, GNUNET_YES);
2200   connection_cancel_queues (c, GNUNET_NO);
2201
2202   LOG (GNUNET_ERROR_TYPE_DEBUG, " fc tasks f: %u, b: %u\n",
2203        c->fwd_fc.poll_task, c->bck_fc.poll_task);
2204
2205   /* Cancel maintainance task (keepalive/timeout) */
2206   if (GNUNET_SCHEDULER_NO_TASK != c->fwd_maintenance_task)
2207     GNUNET_SCHEDULER_cancel (c->fwd_maintenance_task);
2208   if (GNUNET_SCHEDULER_NO_TASK != c->bck_maintenance_task)
2209     GNUNET_SCHEDULER_cancel (c->bck_maintenance_task);
2210   if (GNUNET_SCHEDULER_NO_TASK != c->fwd_fc.poll_task)
2211   {
2212     GNUNET_SCHEDULER_cancel (c->fwd_fc.poll_task);
2213     LOG (GNUNET_ERROR_TYPE_DEBUG, " *** POLL FWD canceled\n");
2214   }
2215   if (GNUNET_SCHEDULER_NO_TASK != c->bck_fc.poll_task)
2216   {
2217     GNUNET_SCHEDULER_cancel (c->bck_fc.poll_task);
2218     LOG (GNUNET_ERROR_TYPE_DEBUG, " *** POLL BCK canceled\n");
2219   }
2220   if (NULL != c->fwd_fc.poll_msg)
2221   {
2222     GMC_cancel (c->fwd_fc.poll_msg);
2223     LOG (GNUNET_ERROR_TYPE_DEBUG, " *** POLL msg FWD canceled\n");
2224   }
2225   if (NULL != c->bck_fc.poll_msg)
2226   {
2227     GMC_cancel (c->bck_fc.poll_msg);
2228     LOG (GNUNET_ERROR_TYPE_DEBUG, " *** POLL msg BCK canceled\n");
2229   }
2230
2231   /* Unregister from neighbors */
2232   unregister_neighbors (c);
2233
2234   /* Delete */
2235   GNUNET_STATISTICS_update (stats, "# connections", -1, GNUNET_NO);
2236   if (NULL != c->t)
2237     GMT_remove_connection (c->t, c);
2238
2239   if (GNUNET_NO == GMC_is_origin (c, GNUNET_YES))
2240     path_destroy (c->path);
2241
2242   GNUNET_break (GNUNET_YES ==
2243                 GNUNET_CONTAINER_multihashmap_remove (connections, &c->id, c));
2244
2245   GNUNET_free (c);
2246 }
2247
2248 /**
2249  * Get the connection ID.
2250  *
2251  * @param c Connection to get the ID from.
2252  *
2253  * @return ID of the connection.
2254  */
2255 const struct GNUNET_HashCode *
2256 GMC_get_id (const struct MeshConnection *c)
2257 {
2258   return &c->id;
2259 }
2260
2261
2262 /**
2263  * Get the connection path.
2264  *
2265  * @param c Connection to get the path from.
2266  *
2267  * @return path used by the connection.
2268  */
2269 const struct MeshPeerPath *
2270 GMC_get_path (const struct MeshConnection *c)
2271 {
2272   return c->path;
2273 }
2274
2275
2276 /**
2277  * Get the connection state.
2278  *
2279  * @param c Connection to get the state from.
2280  *
2281  * @return state of the connection.
2282  */
2283 enum MeshConnectionState
2284 GMC_get_state (const struct MeshConnection *c)
2285 {
2286   return c->state;
2287 }
2288
2289 /**
2290  * Get the connection tunnel.
2291  *
2292  * @param c Connection to get the tunnel from.
2293  *
2294  * @return tunnel of the connection.
2295  */
2296 struct MeshTunnel3 *
2297 GMC_get_tunnel (const struct MeshConnection *c)
2298 {
2299   return c->t;
2300 }
2301
2302
2303 /**
2304  * Get free buffer space in a connection.
2305  *
2306  * @param c Connection.
2307  * @param fwd Is query about FWD traffic?
2308  *
2309  * @return Free buffer space [0 - max_msgs_queue/max_connections]
2310  */
2311 unsigned int
2312 GMC_get_buffer (struct MeshConnection *c, int fwd)
2313 {
2314   struct MeshFlowControl *fc;
2315
2316   fc = fwd ? &c->fwd_fc : &c->bck_fc;
2317
2318   return (fc->queue_max - fc->queue_n);
2319 }
2320
2321 /**
2322  * Get how many messages have we allowed to send to us from a direction.
2323  *
2324  * @param c Connection.
2325  * @param fwd Are we asking about traffic from FWD (BCK messages)?
2326  *
2327  * @return last_ack_sent - last_pid_recv
2328  */
2329 unsigned int
2330 GMC_get_allowed (struct MeshConnection *c, int fwd)
2331 {
2332   struct MeshFlowControl *fc;
2333
2334   fc = fwd ? &c->fwd_fc : &c->bck_fc;
2335   if (GMC_is_pid_bigger(fc->last_pid_recv, fc->last_ack_sent))
2336   {
2337     return 0;
2338   }
2339   return (fc->last_ack_sent - fc->last_pid_recv);
2340 }
2341
2342 /**
2343  * Get messages queued in a connection.
2344  *
2345  * @param c Connection.
2346  * @param fwd Is query about FWD traffic?
2347  *
2348  * @return Number of messages queued.
2349  */
2350 unsigned int
2351 GMC_get_qn (struct MeshConnection *c, int fwd)
2352 {
2353   struct MeshFlowControl *fc;
2354
2355   fc = fwd ? &c->fwd_fc : &c->bck_fc;
2356
2357   return fc->queue_n;
2358 }
2359
2360
2361 /**
2362  * Allow the connection to advertise a buffer of the given size.
2363  *
2364  * The connection will send an @c fwd ACK message (so: in direction !fwd)
2365  * allowing up to last_pid_recv + buffer.
2366  *
2367  * @param c Connection.
2368  * @param buffer How many more messages the connection can accept.
2369  * @param fwd Is this about FWD traffic? (The ack will go dest->root).
2370  */
2371 void
2372 GMC_allow (struct MeshConnection *c, unsigned int buffer, int fwd)
2373 {
2374   send_ack (c, buffer, fwd, GNUNET_NO);
2375 }
2376
2377
2378 /**
2379  * Notify other peers on a connection of a broken link. Mark connections
2380  * to destroy after all traffic has been sent.
2381  *
2382  * @param c Connection on which there has been a disconnection.
2383  * @param peer Peer that disconnected.
2384  */
2385 void
2386 GMC_notify_broken (struct MeshConnection *c,
2387                    struct MeshPeer *peer)
2388 {
2389   int fwd;
2390
2391   LOG (GNUNET_ERROR_TYPE_DEBUG,
2392        " notify broken on %s due to %s disconnect\n",
2393        GMC_2s (c), GMP_2s (peer));
2394
2395   fwd = peer == get_prev_hop (c);
2396
2397   if (GNUNET_YES == GMC_is_terminal (c, fwd))
2398   {
2399     /* Local shutdown, no one to notify about this. */
2400     GMC_destroy (c);
2401     return;
2402   }
2403   if (GNUNET_NO == c->destroy)
2404     send_broken (c, &my_full_id, GMP_get_id (peer), fwd);
2405
2406   /* Connection will have at least one pending message
2407    * (the one we just scheduled), so no point in checking whether to
2408    * destroy immediately. */
2409   c->destroy = GNUNET_YES;
2410   c->state = MESH_CONNECTION_DESTROYED;
2411
2412   /**
2413    * Cancel all queues, if no message is left, connection will be destroyed.
2414    */
2415   connection_cancel_queues (c, !fwd);
2416
2417   return;
2418 }
2419
2420
2421 /**
2422  * Is this peer the first one on the connection?
2423  *
2424  * @param c Connection.
2425  * @param fwd Is this about fwd traffic?
2426  *
2427  * @return #GNUNET_YES if origin, #GNUNET_NO if relay/terminal.
2428  */
2429 int
2430 GMC_is_origin (struct MeshConnection *c, int fwd)
2431 {
2432   if (!fwd && c->path->length - 1 == c->own_pos )
2433     return GNUNET_YES;
2434   if (fwd && 0 == c->own_pos)
2435     return GNUNET_YES;
2436   return GNUNET_NO;
2437 }
2438
2439
2440 /**
2441  * Is this peer the last one on the connection?
2442  *
2443  * @param c Connection.
2444  * @param fwd Is this about fwd traffic?
2445  *            Note that the ROOT is the terminal for BCK traffic!
2446  *
2447  * @return #GNUNET_YES if terminal, #GNUNET_NO if relay/origin.
2448  */
2449 int
2450 GMC_is_terminal (struct MeshConnection *c, int fwd)
2451 {
2452   return GMC_is_origin (c, !fwd);
2453 }
2454
2455
2456 /**
2457  * See if we are allowed to send by the next hop in the given direction.
2458  *
2459  * @param c Connection.
2460  * @param fwd Is this about fwd traffic?
2461  *
2462  * @return #GNUNET_YES in case it's OK to send.
2463  */
2464 int
2465 GMC_is_sendable (struct MeshConnection *c, int fwd)
2466 {
2467   struct MeshFlowControl *fc;
2468
2469   fc = fwd ? &c->fwd_fc : &c->bck_fc;
2470   if (GMC_is_pid_bigger (fc->last_ack_recv, fc->last_pid_sent))
2471     return GNUNET_YES;
2472   return GNUNET_NO;
2473 }
2474
2475 /**
2476  * Sends an already built message on a connection, properly registering
2477  * all used resources.
2478  *
2479  * @param message Message to send. Function makes a copy of it.
2480  *                If message is not hop-by-hop, decrements TTL of copy.
2481  * @param c Connection on which this message is transmitted.
2482  * @param fwd Is this a fwd message?
2483  * @param cont Continuation called once message is sent. Can be NULL.
2484  * @param cont_cls Closure for @c cont.
2485  *
2486  * @return Handle to cancel the message before it's sent.
2487  *         NULL on error or if @c cont is NULL.
2488  *         Invalid on @c cont call.
2489  */
2490 struct MeshConnectionQueue *
2491 GMC_send_prebuilt_message (const struct GNUNET_MessageHeader *message,
2492                            struct MeshConnection *c, int fwd,
2493                            GMC_sent cont, void *cont_cls)
2494 {
2495   struct MeshFlowControl *fc;
2496   struct MeshConnectionQueue *q;
2497   void *data;
2498   size_t size;
2499   uint16_t type;
2500   int droppable;
2501
2502   size = ntohs (message->size);
2503   data = GNUNET_malloc (size);
2504   memcpy (data, message, size);
2505   type = ntohs (message->type);
2506   LOG (GNUNET_ERROR_TYPE_DEBUG, "Send %s (%u bytes) on connection %s\n",
2507               GNUNET_MESH_DEBUG_M2S (type), size, GMC_2s (c));
2508
2509   fc = fwd ? &c->fwd_fc : &c->bck_fc;
2510   droppable = GNUNET_YES;
2511   switch (type)
2512   {
2513     struct GNUNET_MESH_Encrypted *emsg;
2514     struct GNUNET_MESH_KX        *kmsg;
2515     struct GNUNET_MESH_ACK       *amsg;
2516     struct GNUNET_MESH_Poll      *pmsg;
2517     struct GNUNET_MESH_ConnectionDestroy *dmsg;
2518     struct GNUNET_MESH_ConnectionBroken  *bmsg;
2519     uint32_t ttl;
2520
2521     case GNUNET_MESSAGE_TYPE_MESH_ENCRYPTED:
2522       emsg = (struct GNUNET_MESH_Encrypted *) data;
2523       ttl = ntohl (emsg->ttl);
2524       if (0 == ttl)
2525       {
2526         GNUNET_break_op (0);
2527         GNUNET_free (data);
2528         return NULL;
2529       }
2530       emsg->cid = c->id;
2531       emsg->ttl = htonl (ttl - 1);
2532       emsg->pid = htonl (fc->next_pid++);
2533       LOG (GNUNET_ERROR_TYPE_DEBUG, "  Q_N+ %p %u\n", fc, fc->queue_n);
2534       fc->queue_n++;
2535       LOG (GNUNET_ERROR_TYPE_DEBUG, "pid %u\n", ntohl (emsg->pid));
2536       LOG (GNUNET_ERROR_TYPE_DEBUG, "last pid sent %u\n", fc->last_pid_sent);
2537       LOG (GNUNET_ERROR_TYPE_DEBUG, "     ack recv %u\n", fc->last_ack_recv);
2538       if (GMC_is_pid_bigger (fc->last_pid_sent + 1, fc->last_ack_recv))
2539       {
2540         GMC_start_poll (c, fwd);
2541       }
2542       break;
2543
2544     case GNUNET_MESSAGE_TYPE_MESH_KX:
2545       kmsg = (struct GNUNET_MESH_KX *) data;
2546       kmsg->cid = c->id;
2547       break;
2548
2549     case GNUNET_MESSAGE_TYPE_MESH_ACK:
2550       amsg = (struct GNUNET_MESH_ACK *) data;
2551       amsg->cid = c->id;
2552       LOG (GNUNET_ERROR_TYPE_DEBUG, " ack %u\n", ntohl (amsg->ack));
2553       droppable = GNUNET_NO;
2554       break;
2555
2556     case GNUNET_MESSAGE_TYPE_MESH_POLL:
2557       pmsg = (struct GNUNET_MESH_Poll *) data;
2558       pmsg->cid = c->id;
2559       LOG (GNUNET_ERROR_TYPE_DEBUG, " poll %u\n", ntohl (pmsg->pid));
2560       droppable = GNUNET_NO;
2561       break;
2562
2563     case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_DESTROY:
2564       dmsg = (struct GNUNET_MESH_ConnectionDestroy *) data;
2565       dmsg->cid = c->id;
2566       dmsg->reserved = 0;
2567       break;
2568
2569     case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_BROKEN:
2570       bmsg = (struct GNUNET_MESH_ConnectionBroken *) data;
2571       bmsg->cid = c->id;
2572       bmsg->reserved = 0;
2573       break;
2574
2575     case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_CREATE:
2576     case GNUNET_MESSAGE_TYPE_MESH_CONNECTION_ACK:
2577       break;
2578
2579     default:
2580       GNUNET_break (0);
2581   }
2582
2583   if (fc->queue_n > fc->queue_max && droppable)
2584   {
2585     GNUNET_STATISTICS_update (stats, "# messages dropped (buffer full)",
2586                               1, GNUNET_NO);
2587     GNUNET_break (0);
2588     LOG (GNUNET_ERROR_TYPE_DEBUG,
2589                 "queue full: %u/%u\n",
2590                 fc->queue_n, fc->queue_max);
2591     if (GNUNET_MESSAGE_TYPE_MESH_ENCRYPTED == type)
2592     {
2593       fc->queue_n--;
2594       fc->next_pid--;
2595     }
2596     GNUNET_free (data);
2597     return NULL; /* Drop this message */
2598   }
2599
2600   LOG (GNUNET_ERROR_TYPE_DEBUG, "  C_P+ %p %u\n", c, c->pending_messages);
2601   c->pending_messages++;
2602
2603   if (NULL == cont)
2604   {
2605     (void) GMP_queue_add (get_hop (c, fwd), data, type, size, c, fwd,
2606                           &message_sent, NULL);
2607     return NULL;
2608   }
2609
2610   q = GNUNET_new (struct MeshConnectionQueue);
2611   q->q = GMP_queue_add (get_hop (c, fwd), data, type, size, c, fwd,
2612                         &message_sent, q);
2613   if (NULL == q->q)
2614   {
2615     GNUNET_break (0);
2616     GNUNET_free (data);
2617     GNUNET_free (q);
2618     return NULL;
2619   }
2620   q->cont = cont;
2621   q->cont_cls = cont_cls;
2622   return q;
2623 }
2624
2625
2626 /**
2627  * Cancel a previously sent message while it's in the queue.
2628  *
2629  * ONLY can be called before the continuation given to the send function
2630  * is called. Once the continuation is called, the message is no longer in the
2631  * queue.
2632  *
2633  * @param q Handle to the queue.
2634  */
2635 void
2636 GMC_cancel (struct MeshConnectionQueue *q)
2637 {
2638   LOG (GNUNET_ERROR_TYPE_DEBUG, "!  GMC cancel message\n");
2639
2640   /* queue destroy calls message_sent, which calls q->cont and frees q */
2641   GMP_queue_destroy (q->q, GNUNET_YES);
2642 }
2643
2644
2645 /**
2646  * Sends a CREATE CONNECTION message for a path to a peer.
2647  * Changes the connection and tunnel states if necessary.
2648  *
2649  * @param connection Connection to create.
2650  */
2651 void
2652 GMC_send_create (struct MeshConnection *connection)
2653 {
2654   enum MeshTunnel3State state;
2655   size_t size;
2656
2657   size = sizeof (struct GNUNET_MESH_ConnectionCreate);
2658   size += connection->path->length * sizeof (struct GNUNET_PeerIdentity);
2659   LOG (GNUNET_ERROR_TYPE_DEBUG, "Send connection create\n");
2660   GMP_queue_add (get_next_hop (connection), NULL,
2661                  GNUNET_MESSAGE_TYPE_MESH_CONNECTION_CREATE,
2662                  size, connection, GNUNET_YES, &message_sent, NULL);
2663   LOG (GNUNET_ERROR_TYPE_DEBUG, "  C_P+ %p %u (create)\n",
2664        connection, connection->pending_messages);
2665   connection->pending_messages++;
2666   state = GMT_get_state (connection->t);
2667   if (MESH_TUNNEL3_SEARCHING == state || MESH_TUNNEL3_NEW == state)
2668     GMT_change_state (connection->t, MESH_TUNNEL3_WAITING);
2669   if (MESH_CONNECTION_NEW == connection->state)
2670     connection_change_state (connection, MESH_CONNECTION_SENT);
2671 }
2672
2673
2674 /**
2675  * Send a message to all peers in this connection that the connection
2676  * is no longer valid.
2677  *
2678  * If some peer should not receive the message, it should be zero'ed out
2679  * before calling this function.
2680  *
2681  * @param c The connection whose peers to notify.
2682  */
2683 void
2684 GMC_send_destroy (struct MeshConnection *c)
2685 {
2686   struct GNUNET_MESH_ConnectionDestroy msg;
2687
2688   if (GNUNET_YES == c->destroy)
2689     return;
2690
2691   msg.header.size = htons (sizeof (msg));
2692   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_CONNECTION_DESTROY);;
2693   msg.cid = c->id;
2694   LOG (GNUNET_ERROR_TYPE_DEBUG,
2695               "  sending connection destroy for connection %s\n",
2696               GMC_2s (c));
2697
2698   if (GNUNET_NO == GMC_is_terminal (c, GNUNET_YES))
2699     GMC_send_prebuilt_message (&msg.header, c, GNUNET_YES, NULL, NULL);
2700   if (GNUNET_NO == GMC_is_terminal (c, GNUNET_NO))
2701     GMC_send_prebuilt_message (&msg.header, c, GNUNET_NO, NULL, NULL);
2702   c->destroy = GNUNET_YES;
2703   c->state = MESH_CONNECTION_DESTROYED;
2704 }
2705
2706
2707 /**
2708  * @brief Start a polling timer for the connection.
2709  *
2710  * When a neighbor does not accept more traffic on the connection it could be
2711  * caused by a simple congestion or by a lost ACK. Polling enables to check
2712  * for the lastest ACK status for a connection.
2713  *
2714  * @param c Connection.
2715  * @param fwd Should we poll in the FWD direction?
2716  */
2717 void
2718 GMC_start_poll (struct MeshConnection *c, int fwd)
2719 {
2720   struct MeshFlowControl *fc;
2721
2722   fc = fwd ? &c->fwd_fc : &c->bck_fc;
2723   LOG (GNUNET_ERROR_TYPE_DEBUG, " *** POLL %s requested\n",
2724        fwd ? "FWD" : "BCK");
2725   if (GNUNET_SCHEDULER_NO_TASK != fc->poll_task || NULL != fc->poll_msg)
2726   {
2727     LOG (GNUNET_ERROR_TYPE_DEBUG, " ***   not needed (%u, %p)\n",
2728          fc->poll_task, fc->poll_msg);
2729     return;
2730   }
2731   LOG (GNUNET_ERROR_TYPE_DEBUG, " *** POLL started on request\n");
2732   fc->poll_task = GNUNET_SCHEDULER_add_delayed (fc->poll_time,
2733                                                 &connection_poll,
2734                                                 fc);
2735 }
2736
2737
2738 /**
2739  * @brief Stop polling a connection for ACKs.
2740  *
2741  * Once we have enough ACKs for future traffic, polls are no longer necessary.
2742  *
2743  * @param c Connection.
2744  * @param fwd Should we stop the poll in the FWD direction?
2745  */
2746 void
2747 GMC_stop_poll (struct MeshConnection *c, int fwd)
2748 {
2749   struct MeshFlowControl *fc;
2750
2751   fc = fwd ? &c->fwd_fc : &c->bck_fc;
2752   if (GNUNET_SCHEDULER_NO_TASK != fc->poll_task)
2753   {
2754     GNUNET_SCHEDULER_cancel (fc->poll_task);
2755     fc->poll_task = GNUNET_SCHEDULER_NO_TASK;
2756   }
2757 }
2758
2759 /**
2760  * Get a (static) string for a connection.
2761  *
2762  * @param c Connection.
2763  */
2764 const char *
2765 GMC_2s (struct MeshConnection *c)
2766 {
2767   if (NULL != c->t)
2768   {
2769     static char buf[128];
2770
2771     sprintf (buf, "%s (->%s)", GNUNET_h2s (&c->id), GMT_2s (c->t));
2772     return buf;
2773   }
2774   return GNUNET_h2s (&c->id);
2775 }