- respond to data on unknown channels with destroy (avoids retransmissions)
[oweals/gnunet.git] / src / mesh / gnunet-service-mesh_tunnel.c
1 /*
2      This file is part of GNUnet.
3      (C) 2013 Christian Grothoff (and other contributing authors)
4
5      GNUnet is free software; you can redistribute it and/or modify
6      it under the terms of the GNU General Public License as published
7      by the Free Software Foundation; either version 3, or (at your
8      option) any later version.
9
10      GNUnet is distributed in the hope that it will be useful, but
11      WITHOUT ANY WARRANTY; without even the implied warranty of
12      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13      General Public License for more details.
14
15      You should have received a copy of the GNU General Public License
16      along with GNUnet; see the file COPYING.  If not, write to the
17      Free Software Foundation, Inc., 59 Temple Place - Suite 330,
18      Boston, MA 02111-1307, USA.
19 */
20
21 #include "platform.h"
22 #include "gnunet_util_lib.h"
23
24 #include "gnunet_signatures.h"
25 #include "gnunet_statistics_service.h"
26
27 #include "mesh_protocol.h"
28 #include "mesh_path.h"
29
30 #include "gnunet-service-mesh_tunnel.h"
31 #include "gnunet-service-mesh_connection.h"
32 #include "gnunet-service-mesh_channel.h"
33 #include "gnunet-service-mesh_peer.h"
34
35 #define LOG(level, ...) GNUNET_log_from(level,"mesh-tun",__VA_ARGS__)
36
37 #define REKEY_WAIT GNUNET_TIME_relative_multiply(GNUNET_TIME_UNIT_SECONDS, 5)
38
39 /******************************************************************************/
40 /********************************   STRUCTS  **********************************/
41 /******************************************************************************/
42
43 struct MeshTChannel
44 {
45   struct MeshTChannel *next;
46   struct MeshTChannel *prev;
47   struct MeshChannel *ch;
48 };
49
50 struct MeshTConnection
51 {
52   struct MeshTConnection *next;
53   struct MeshTConnection *prev;
54   struct MeshConnection *c;
55 };
56
57 /**
58  * Structure used during a Key eXchange.
59  */
60 struct MeshTunnelKXCtx
61 {
62   /**
63    * Decryption ("their") old key, for decrypting traffic sent by the
64    * other end before the key exchange started.
65    */
66   struct GNUNET_CRYPTO_SymmetricSessionKey d_key_old;
67
68   /**
69    * Challenge to send in a ping and expect in the pong.
70    */
71   uint32_t challenge;
72 };
73
74 /**
75  * Struct containing all information regarding a tunnel to a peer.
76  */
77 struct MeshTunnel3
78 {
79     /**
80      * Endpoint of the tunnel.
81      */
82   struct MeshPeer *peer;
83
84     /**
85      * State of the tunnel connectivity.
86      */
87   enum MeshTunnel3CState cstate;
88
89   /**
90    * State of the tunnel encryption.
91    */
92   enum MeshTunnel3EState estate;
93
94   /**
95    * Key eXchange context.
96    */
97   struct MeshTunnelKXCtx *kx_ctx;
98
99   /**
100    * Encryption ("our") key.
101    */
102   struct GNUNET_CRYPTO_SymmetricSessionKey e_key;
103
104   /**
105    * Decryption ("their") key.
106    */
107   struct GNUNET_CRYPTO_SymmetricSessionKey d_key;
108
109   /**
110    * Task to start the rekey process.
111    */
112   GNUNET_SCHEDULER_TaskIdentifier rekey_task;
113
114   /**
115    * Paths that are actively used to reach the destination peer.
116    */
117   struct MeshTConnection *connection_head;
118   struct MeshTConnection *connection_tail;
119
120   /**
121    * Next connection number.
122    */
123   uint32_t next_cid;
124
125   /**
126    * Channels inside this tunnel.
127    */
128   struct MeshTChannel *channel_head;
129   struct MeshTChannel *channel_tail;
130
131   /**
132    * Channel ID for the next created channel.
133    */
134   MESH_ChannelNumber next_chid;
135
136   /**
137    * Destroy flag: if true, destroy on last message.
138    */
139   int destroy;
140
141   /**
142    * Queued messages, to transmit once tunnel gets connected.
143    */
144   struct MeshTunnelDelayed *tq_head;
145   struct MeshTunnelDelayed *tq_tail;
146 };
147
148
149 /**
150  * Struct used to save messages in a non-ready tunnel to send once connected.
151  */
152 struct MeshTunnelDelayed
153 {
154   /**
155    * DLL
156    */
157   struct MeshTunnelDelayed *next;
158   struct MeshTunnelDelayed *prev;
159
160   /**
161    * Tunnel.
162    */
163   struct MeshTunnel3 *t;
164
165   /**
166    * Tunnel queue given to the channel to cancel request. Update on send_queued.
167    */
168   struct MeshTunnel3Queue *tq;
169
170   /**
171    * Message to send.
172    */
173   /* struct GNUNET_MessageHeader *msg; */
174 };
175
176
177 /**
178  * Handle for messages queued but not yet sent.
179  */
180 struct MeshTunnel3Queue
181 {
182   /**
183    * Connection queue handle, to cancel if necessary.
184    */
185   struct MeshConnectionQueue *cq;
186
187   /**
188    * Handle in case message hasn't been given to a connection yet.
189    */
190   struct MeshTunnelDelayed *tqd;
191
192   /**
193    * Continuation to call once sent.
194    */
195   GMT_sent cont;
196
197   /**
198    * Closure for @c cont.
199    */
200   void *cont_cls;
201 };
202
203
204 /******************************************************************************/
205 /*******************************   GLOBALS  ***********************************/
206 /******************************************************************************/
207
208 /**
209  * Global handle to the statistics service.
210  */
211 extern struct GNUNET_STATISTICS_Handle *stats;
212
213 /**
214  * Local peer own ID (memory efficient handle).
215  */
216 extern GNUNET_PEER_Id myid;
217
218 /**
219  * Local peer own ID (full value).
220  */
221 extern struct GNUNET_PeerIdentity my_full_id;
222
223
224 /**
225  * Don't try to recover tunnels if shutting down.
226  */
227 extern int shutting_down;
228
229
230 /**
231  * Set of all tunnels, in order to trigger a new exchange on rekey.
232  * Indexed by peer's ID.
233  */
234 static struct GNUNET_CONTAINER_MultiPeerMap *tunnels;
235
236 /**
237  * Default TTL for payload packets.
238  */
239 static unsigned long long default_ttl;
240
241 /**
242  * Own private key.
243  */
244 const static struct GNUNET_CRYPTO_EddsaPrivateKey *my_private_key;
245
246 /**
247  * Own ephemeral private key.
248  */
249 static struct GNUNET_CRYPTO_EcdhePrivateKey *my_ephemeral_key;
250
251 /**
252  * Cached message used to perform a key exchange.
253  */
254 static struct GNUNET_MESH_KX_Ephemeral kx_msg;
255
256 /**
257  * Task to generate a new ephemeral key.
258  */
259 static GNUNET_SCHEDULER_TaskIdentifier rekey_task;
260
261 /**
262  * Rekey period.
263  */
264 static struct GNUNET_TIME_Relative rekey_period;
265
266 /******************************************************************************/
267 /********************************   STATIC  ***********************************/
268 /******************************************************************************/
269
270 /**
271  * Get string description for tunnel connectivity state.
272  *
273  * @param cs Tunnel state.
274  *
275  * @return String representation.
276  */
277 static const char *
278 cstate2s (enum MeshTunnel3CState cs)
279 {
280   static char buf[128];
281
282   switch (cs)
283   {
284     case MESH_TUNNEL3_NEW:
285       return "MESH_TUNNEL3_NEW";
286     case MESH_TUNNEL3_SEARCHING:
287       return "MESH_TUNNEL3_SEARCHING";
288     case MESH_TUNNEL3_WAITING:
289       return "MESH_TUNNEL3_WAITING";
290     case MESH_TUNNEL3_READY:
291       return "MESH_TUNNEL3_READY";
292
293     default:
294       sprintf (buf, "%u (UNKNOWN STATE)", cs);
295       return buf;
296   }
297   return "";
298 }
299
300
301 /**
302  * Get string description for tunnel encryption state.
303  *
304  * @param es Tunnel state.
305  *
306  * @return String representation.
307  */
308 static const char *
309 estate2s (enum MeshTunnel3EState es)
310 {
311   static char buf[128];
312
313   switch (es)
314   {
315     case MESH_TUNNEL3_KEY_UNINITIALIZED:
316       return "MESH_TUNNEL3_KEY_UNINITIALIZED";
317     case MESH_TUNNEL3_KEY_SENT:
318       return "MESH_TUNNEL3_KEY_SENT";
319     case MESH_TUNNEL3_KEY_PING:
320       return "MESH_TUNNEL3_KEY_PING";
321     case MESH_TUNNEL3_KEY_OK:
322       return "MESH_TUNNEL3_KEY_OK";
323
324     default:
325       sprintf (buf, "%u (UNKNOWN STATE)", es);
326       return buf;
327   }
328   return "";
329 }
330
331
332 /**
333  * @brief Check if tunnel is ready to send traffic.
334  *
335  * Tunnel must be connected and with encryption correctly set up.
336  *
337  * @param t Tunnel to check.
338  *
339  * @return #GNUNET_YES if ready, #GNUNET_NO otherwise
340  */
341 static int
342 is_ready (struct MeshTunnel3 *t)
343 {
344   return (MESH_TUNNEL3_READY == t->cstate
345           && MESH_TUNNEL3_KEY_OK == t->estate)
346          || GMT_is_loopback (t);
347 }
348
349
350 /**
351  * Ephemeral key message purpose size.
352  *
353  * @return Size of the part of the ephemeral key message that must be signed.
354  */
355 size_t
356 ephemeral_purpose_size (void)
357 {
358   return sizeof (struct GNUNET_CRYPTO_EccSignaturePurpose) +
359          sizeof (struct GNUNET_TIME_AbsoluteNBO) +
360          sizeof (struct GNUNET_TIME_AbsoluteNBO) +
361          sizeof (struct GNUNET_CRYPTO_EcdhePublicKey) +
362          sizeof (struct GNUNET_PeerIdentity);
363 }
364
365
366 /**
367  * Size of the encrypted part of a ping message.
368  *
369  * @return Size of the encrypted part of a ping message.
370  */
371 size_t
372 ping_encryption_size (void)
373 {
374   return sizeof (struct GNUNET_PeerIdentity) + sizeof (uint32_t);
375 }
376
377
378 /**
379  * Get the channel's buffer. ONLY FOR NON-LOOPBACK CHANNELS!!
380  *
381  * @param tch Tunnel's channel handle.
382  *
383  * @return Amount of messages the channel can still buffer towards the client.
384  */
385 static unsigned int
386 get_channel_buffer (const struct MeshTChannel *tch)
387 {
388   int fwd;
389
390   /* If channel is outgoing, is origin in the FWD direction and fwd is YES */
391   fwd = GMCH_is_origin (tch->ch, GNUNET_YES);
392
393   return GMCH_get_buffer (tch->ch, fwd);
394 }
395
396
397 /**
398  * Get the channel's allowance status.
399  *
400  * @param tch Tunnel's channel handle.
401  *
402  * @return #GNUNET_YES if we allowed the client to send data to us.
403  */
404 static int
405 get_channel_allowed (const struct MeshTChannel *tch)
406 {
407   int fwd;
408
409   /* If channel is outgoing, is origin in the FWD direction and fwd is YES */
410   fwd = GMCH_is_origin (tch->ch, GNUNET_YES);
411
412   return GMCH_get_allowed (tch->ch, fwd);
413 }
414
415
416 /**
417  * Get the connection's buffer.
418  *
419  * @param tc Tunnel's connection handle.
420  *
421  * @return Amount of messages the connection can still buffer.
422  */
423 static unsigned int
424 get_connection_buffer (const struct MeshTConnection *tc)
425 {
426   int fwd;
427
428   /* If connection is outgoing, is origin in the FWD direction and fwd is YES */
429   fwd = GMC_is_origin (tc->c, GNUNET_YES);
430
431   return GMC_get_buffer (tc->c, fwd);
432 }
433
434
435 /**
436  * Get the connection's allowance.
437  *
438  * @param tc Tunnel's connection handle.
439  *
440  * @return Amount of messages we have allowed the next peer to send us.
441  */
442 static unsigned int
443 get_connection_allowed (const struct MeshTConnection *tc)
444 {
445   int fwd;
446
447   /* If connection is outgoing, is origin in the FWD direction and fwd is YES */
448   fwd = GMC_is_origin (tc->c, GNUNET_YES);
449
450   return GMC_get_allowed (tc->c, fwd);
451 }
452
453
454 /**
455  * Check that a ephemeral key message s well formed and correctly signed.
456  *
457  * @param t Tunnel on which the message came.
458  * @param msg The ephemeral key message.
459  *
460  * @return GNUNET_OK if message is fine, GNUNET_SYSERR otherwise.
461  */
462 int
463 check_ephemeral (struct MeshTunnel3 *t,
464                  const struct GNUNET_MESH_KX_Ephemeral *msg)
465 {
466   /* Check message size */
467   if (ntohs (msg->header.size) != sizeof (struct GNUNET_MESH_KX_Ephemeral))
468     return GNUNET_SYSERR;
469
470   /* Check signature size */
471   if (ntohl (msg->purpose.size) != ephemeral_purpose_size ())
472     return GNUNET_SYSERR;
473
474   /* Check origin */
475   if (0 != memcmp (&msg->origin_identity,
476                    GMP_get_id (t->peer),
477                    sizeof (struct GNUNET_PeerIdentity)))
478     return GNUNET_SYSERR;
479
480   /* Check signature */
481   if (GNUNET_OK !=
482       GNUNET_CRYPTO_eddsa_verify (GNUNET_SIGNATURE_PURPOSE_MESH_KX,
483                                   &msg->purpose,
484                                   &msg->signature,
485                                   &msg->origin_identity.public_key))
486     return GNUNET_SYSERR;
487
488   return GNUNET_OK;
489 }
490
491
492 /**
493  * Encrypt data with the tunnel key.
494  *
495  * @param t Tunnel whose key to use.
496  * @param dst Destination for the encrypted data.
497  * @param src Source of the plaintext. Can overlap with @c dst.
498  * @param size Size of the plaintext.
499  * @param iv Initialization Vector to use.
500  */
501 static int
502 t_encrypt (struct MeshTunnel3 *t,
503            void *dst, const void *src,
504            size_t size, uint32_t iv)
505 {
506   struct GNUNET_CRYPTO_SymmetricInitializationVector siv;
507
508   GNUNET_CRYPTO_symmetric_derive_iv (&siv, &t->e_key, &iv, sizeof (uint32_t), NULL);
509   return GNUNET_CRYPTO_symmetric_encrypt (src, size, &t->e_key, &siv, dst);
510 }
511
512
513 /**
514  * Decrypt data with the tunnel key.
515  *
516  * @param t Tunnel whose key to use.
517  * @param dst Destination for the plaintext.
518  * @param src Source of the encrypted data. Can overlap with @c dst.
519  * @param size Size of the encrypted data.
520  * @param iv Initialization Vector to use.
521  */
522 static int
523 t_decrypt (struct MeshTunnel3 *t,
524            void *dst, const void *src,
525            size_t size, uint32_t iv)
526 {
527   struct GNUNET_CRYPTO_SymmetricInitializationVector siv;
528   struct GNUNET_CRYPTO_SymmetricSessionKey *key;
529
530   if (t->estate == MESH_TUNNEL3_KEY_OK || t->estate == MESH_TUNNEL3_KEY_PING)
531   {
532     key = &t->d_key;
533   }
534   else if (NULL != t->kx_ctx)
535   {
536     key = &t->kx_ctx->d_key_old;
537   }
538   else
539   {
540     GNUNET_STATISTICS_update (stats, "# non decryptable data", 1, GNUNET_NO);
541     LOG (GNUNET_ERROR_TYPE_DEBUG,
542          "WARNING got data on %s without a valid key\n",
543          GMT_2s (t));
544     GMT_debug (t);
545     return 0;
546   }
547
548   GNUNET_CRYPTO_symmetric_derive_iv (&siv, key, &iv, sizeof (uint32_t), NULL);
549   return GNUNET_CRYPTO_symmetric_decrypt (src, size, key, &siv, dst);
550 }
551
552
553 /**
554  * Create key material by doing ECDH on the local and remote ephemeral keys.
555  *
556  * @param key_material Where to store the key material.
557  * @param ephemeral_key Peer's public ephemeral key.
558  */
559 void
560 derive_key_material (struct GNUNET_HashCode *key_material,
561                      const struct GNUNET_CRYPTO_EcdhePublicKey *ephemeral_key)
562 {
563   if (GNUNET_OK !=
564       GNUNET_CRYPTO_ecc_ecdh (my_ephemeral_key,
565                               ephemeral_key,
566                               key_material))
567   {
568     GNUNET_break (0);
569   }
570 }
571
572 /**
573  * Create a symmetic key from the identities of both ends and the key material
574  * from ECDH.
575  *
576  * @param key Destination for the generated key.
577  * @param sender ID of the peer that will encrypt with @c key.
578  * @param receiver ID of the peer that will decrypt with @c key.
579  * @param key_material Hash created with ECDH with the ephemeral keys.
580  */
581 void
582 derive_symmertic (struct GNUNET_CRYPTO_SymmetricSessionKey *key,
583                   const struct GNUNET_PeerIdentity *sender,
584                   const struct GNUNET_PeerIdentity *receiver,
585                   const struct GNUNET_HashCode *key_material)
586 {
587   const char salt[] = "MESH kx salt";
588
589   GNUNET_CRYPTO_kdf (key, sizeof (struct GNUNET_CRYPTO_SymmetricSessionKey),
590                      salt, sizeof (salt),
591                      key_material, sizeof (struct GNUNET_HashCode),
592                      sender, sizeof (struct GNUNET_PeerIdentity),
593                      receiver, sizeof (struct GNUNET_PeerIdentity),
594                      NULL);
595 }
596
597 /**
598  * Pick a connection on which send the next data message.
599  *
600  * @param t Tunnel on which to send the message.
601  *
602  * @return The connection on which to send the next message.
603  */
604 static struct MeshConnection *
605 tunnel_get_connection (struct MeshTunnel3 *t)
606 {
607   struct MeshTConnection *iter;
608   struct MeshConnection *best;
609   unsigned int qn;
610   unsigned int lowest_q;
611
612   LOG (GNUNET_ERROR_TYPE_DEBUG, "tunnel_get_connection %s\n", GMP_2s (t->peer));
613   best = NULL;
614   lowest_q = UINT_MAX;
615   for (iter = t->connection_head; NULL != iter; iter = iter->next)
616   {
617     LOG (GNUNET_ERROR_TYPE_DEBUG, "  connection %s: %u\n",
618          GMC_2s (iter->c), GMC_get_state (iter->c));
619     if (MESH_CONNECTION_READY == GMC_get_state (iter->c))
620     {
621       qn = GMC_get_qn (iter->c, GMC_is_origin (iter->c, GNUNET_YES));
622       LOG (GNUNET_ERROR_TYPE_DEBUG, "    q_n %u, \n", qn);
623       if (qn < lowest_q)
624       {
625         best = iter->c;
626         lowest_q = qn;
627       }
628     }
629   }
630   LOG (GNUNET_ERROR_TYPE_DEBUG, " selected: connection %s\n", GMC_2s (best));
631   return best;
632 }
633
634
635 /**
636  * Callback called when a queued message is sent.
637  *
638  * Calculates the average time and connection packet tracking.
639  *
640  * @param cls Closure (TunnelQueue handle).
641  * @param c Connection this message was on.
642  * @param q Connection queue handle (unused).
643  * @param type Type of message sent.
644  * @param fwd Was this a FWD going message?
645  * @param size Size of the message.
646  */
647 static void
648 message_sent (void *cls,
649               struct MeshConnection *c,
650               struct MeshConnectionQueue *q,
651               uint16_t type, int fwd, size_t size)
652 {
653   struct MeshTunnel3Queue *qt = cls;
654
655   GNUNET_assert (NULL != qt->cont);
656   qt->cont (qt->cont_cls, GMC_get_tunnel (c), qt, type, size);
657   GNUNET_free (qt);
658 }
659
660
661 /**
662  * Delete a queued message: either was sent or the channel was destroyed
663  * before the tunnel's key exchange had a chance to finish.
664  *
665  * @param tqd Delayed queue handle.
666  */
667 static void
668 unqueue_data (struct MeshTunnelDelayed *tqd)
669 {
670   GNUNET_CONTAINER_DLL_remove (tqd->t->tq_head, tqd->t->tq_tail, tqd);
671   GNUNET_free (tqd);
672 }
673
674
675 /**
676  * Cache a message to be sent once tunnel is online.
677  *
678  * @param t Tunnel to hold the message.
679  * @param msg Message itself (copy will be made).
680  */
681 static struct MeshTunnelDelayed *
682 queue_data (struct MeshTunnel3 *t, const struct GNUNET_MessageHeader *msg)
683 {
684   struct MeshTunnelDelayed *tqd;
685   uint16_t size = ntohs (msg->size);
686
687   LOG (GNUNET_ERROR_TYPE_DEBUG, "queue data on Tunnel %s\n", GMT_2s (t));
688
689   if (GNUNET_YES == is_ready (t))
690   {
691     GNUNET_break (0);
692     return NULL;
693   }
694
695   tqd = GNUNET_malloc (sizeof (struct MeshTunnelDelayed) + size);
696
697   tqd->t = t;
698   memcpy (&tqd[1], msg, size);
699   GNUNET_CONTAINER_DLL_insert_tail (t->tq_head, t->tq_tail, tqd);
700   return tqd;
701 }
702
703
704
705 /**
706  * Sends an already built message on a tunnel, encrypting it and
707  * choosing the best connection.
708  *
709  * @param message Message to send. Function modifies it.
710  * @param t Tunnel on which this message is transmitted.
711  * @param force Force the tunnel to take the message (buffer overfill).
712  * @param cont Continuation to call once message is really sent.
713  * @param cont_cls Closure for @c cont.
714  * @param existing_q In case this a transmission of previously queued data,
715  *                   this should be TunnelQueue given to the client.
716  *                   Otherwise, NULL.
717  *
718  * @return Handle to cancel message. NULL if @c cont is NULL.
719  */
720 static struct MeshTunnel3Queue *
721 send_prebuilt_message (const struct GNUNET_MessageHeader *message,
722                        struct MeshTunnel3 *t, int force,
723                        GMT_sent cont, void *cont_cls,
724                        struct MeshTunnel3Queue *existing_q)
725 {
726   struct MeshTunnel3Queue *tq;
727   struct MeshConnection *c;
728   struct GNUNET_MESH_Encrypted *msg;
729   size_t size = ntohs (message->size);
730   char cbuf[sizeof (struct GNUNET_MESH_Encrypted) + size];
731   uint32_t iv;
732   uint16_t type;
733   int fwd;
734
735   LOG (GNUNET_ERROR_TYPE_DEBUG, "GMT Send on Tunnel %s\n", GMT_2s (t));
736
737   if (GNUNET_NO == is_ready (t))
738   {
739     struct MeshTunnelDelayed *tqd;
740     /* A non null existing_q indicates sending of queued data.
741      * Should only happen after tunnel becomes ready.
742      */
743     GNUNET_assert (NULL == existing_q);
744     tqd = queue_data (t, message);
745     if (NULL == cont)
746       return NULL;
747     tq = GNUNET_new (struct MeshTunnel3Queue);
748     tq->tqd = tqd;
749     tqd->tq = tq;
750     tq->cont = cont;
751     tq->cont_cls = cont_cls;
752     return tq;
753   }
754
755   GNUNET_assert (GNUNET_NO == GMT_is_loopback (t));
756
757   iv = GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_NONCE, UINT32_MAX);
758   msg = (struct GNUNET_MESH_Encrypted *) cbuf;
759   msg->header.type = htons (GNUNET_MESSAGE_TYPE_MESH_ENCRYPTED);
760   msg->iv = iv;
761   GNUNET_assert (t_encrypt (t, &msg[1], message, size, iv) == size);
762   msg->header.size = htons (sizeof (struct GNUNET_MESH_Encrypted) + size);
763   c = tunnel_get_connection (t);
764   if (NULL == c)
765   {
766     if (GNUNET_YES == t->destroy || MESH_TUNNEL3_SEARCHING != t->cstate)
767     {
768       GNUNET_break (0);
769       GMT_debug (t);
770     }
771     return NULL;
772   }
773   type = ntohs (message->type);
774   switch (type)
775   {
776     case GNUNET_MESSAGE_TYPE_MESH_DATA:
777     case GNUNET_MESSAGE_TYPE_MESH_DATA_ACK:
778     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_CREATE:
779     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_DESTROY:
780     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_ACK:
781     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_NACK:
782       msg->cid = *GMC_get_id (c);
783       msg->ttl = htonl (default_ttl);
784       break;
785     default:
786       LOG (GNUNET_ERROR_TYPE_DEBUG, "unkown type %s\n",
787            GM_m2s (type));
788       GNUNET_break (0);
789   }
790
791   fwd = GMC_is_origin (c, GNUNET_YES);
792
793   if (NULL == cont)
794   {
795     (void) GMC_send_prebuilt_message (&msg->header, c, fwd, force, NULL, NULL);
796     return NULL;
797   }
798   if (NULL == existing_q)
799   {
800     tq = GNUNET_new (struct MeshTunnel3Queue); /* FIXME valgrind: leak*/
801   }
802   else
803   {
804     tq = existing_q;
805     tq->tqd = NULL;
806   }
807   tq->cq = GMC_send_prebuilt_message (&msg->header, c, fwd, force,
808                                       &message_sent, tq);
809   tq->cont = cont;
810   tq->cont_cls = cont_cls;
811
812   return tq;
813 }
814
815
816 /**
817  * Send all cached messages that we can, tunnel is online.
818  *
819  * @param t Tunnel that holds the messages. Cannot be loopback.
820  */
821 static void
822 send_queued_data (struct MeshTunnel3 *t)
823 {
824   struct MeshTunnelDelayed *tqd;
825   struct MeshTunnelDelayed *next;
826   unsigned int room;
827
828   LOG (GNUNET_ERROR_TYPE_DEBUG,
829        "GMT_send_queued_data on tunnel %s\n",
830        GMT_2s (t));
831
832   if (GMT_is_loopback (t))
833   {
834     GNUNET_break (0);
835     return;
836   }
837
838   if (GNUNET_NO == is_ready (t))
839   {
840     LOG (GNUNET_ERROR_TYPE_DEBUG, "  not ready yet: %s/%s\n",
841          estate2s (t->estate), cstate2s (t->cstate));
842     return;
843   }
844
845   room = GMT_get_connections_buffer (t);
846   LOG (GNUNET_ERROR_TYPE_DEBUG, "  buffer space: %u\n", room);
847   LOG (GNUNET_ERROR_TYPE_DEBUG, "  tq head: %p\n", t->tq_head);
848   for (tqd = t->tq_head; NULL != tqd && room > 0; tqd = next)
849   {
850     LOG (GNUNET_ERROR_TYPE_DEBUG, " sending queued data\n");
851     next = tqd->next;
852     room--;
853     send_prebuilt_message ((struct GNUNET_MessageHeader *) &tqd[1],
854                            tqd->t, GNUNET_YES,
855                            NULL != tqd->tq ? tqd->tq->cont : NULL,
856                            NULL != tqd->tq ? tqd->tq->cont_cls : NULL,
857                            tqd->tq);
858     unqueue_data (tqd);
859   }
860   LOG (GNUNET_ERROR_TYPE_DEBUG, "GMT_send_queued_data end\n", GMP_2s (t->peer));
861 }
862
863
864 /**
865  * Sends key exchange message on a tunnel, choosing the best connection.
866  * Should not be called on loopback tunnels.
867  *
868  * @param t Tunnel on which this message is transmitted.
869  * @param message Message to send. Function modifies it.
870  */
871 static void
872 send_kx (struct MeshTunnel3 *t,
873          const struct GNUNET_MessageHeader *message)
874 {
875   struct MeshConnection *c;
876   struct GNUNET_MESH_KX *msg;
877   size_t size = ntohs (message->size);
878   char cbuf[sizeof (struct GNUNET_MESH_KX) + size];
879   uint16_t type;
880   int fwd;
881
882   LOG (GNUNET_ERROR_TYPE_DEBUG, "GMT KX on Tunnel %s\n", GMT_2s (t));
883
884   /* Avoid loopback. */
885   if (GMT_is_loopback (t))
886   {
887     LOG (GNUNET_ERROR_TYPE_DEBUG, "  loopback!\n");
888     GNUNET_break (0);
889     return;
890   }
891
892   /* Must have a connection. */
893   if (NULL == t->connection_head)
894   {
895     GNUNET_break (MESH_TUNNEL3_SEARCHING == t->cstate);
896     GMT_debug (t);
897     return;
898   }
899
900   msg = (struct GNUNET_MESH_KX *) cbuf;
901   msg->header.type = htons (GNUNET_MESSAGE_TYPE_MESH_KX);
902   msg->header.size = htons (sizeof (struct GNUNET_MESH_KX) + size);
903   c = tunnel_get_connection (t);
904   if (NULL == c)
905   {
906     GNUNET_break (GNUNET_YES == t->destroy || MESH_TUNNEL3_READY != t->cstate);
907     GMT_debug (t);
908     return;
909   }
910   type = ntohs (message->type);
911   switch (type)
912   {
913     case GNUNET_MESSAGE_TYPE_MESH_KX_EPHEMERAL:
914     case GNUNET_MESSAGE_TYPE_MESH_KX_PING:
915     case GNUNET_MESSAGE_TYPE_MESH_KX_PONG:
916       msg->reserved = htonl (0);
917       memcpy (&msg[1], message, size);
918       break;
919     default:
920       LOG (GNUNET_ERROR_TYPE_DEBUG, "unkown type %s\n",
921            GM_m2s (type));
922       GNUNET_break (0);
923   }
924
925   fwd = GMC_is_origin (t->connection_head->c, GNUNET_YES);
926   /* TODO save handle and cancel in case of a unneeded retransmission */
927   GMC_send_prebuilt_message (&msg->header, c, fwd, GNUNET_YES, NULL, NULL);
928 }
929
930
931 /**
932  * Send the ephemeral key on a tunnel.
933  *
934  * @param t Tunnel on which to send the key.
935  */
936 static void
937 send_ephemeral (struct MeshTunnel3 *t)
938 {
939   LOG (GNUNET_ERROR_TYPE_DEBUG, "%s()\n", __FUNCTION__);
940
941   kx_msg.sender_status = htonl (t->estate);
942   send_kx (t, &kx_msg.header);
943 }
944
945 /**
946  * Send a ping message on a tunnel.
947  *
948  * @param t Tunnel on which to send the ping.
949  */
950 static void
951 send_ping (struct MeshTunnel3 *t)
952 {
953   struct GNUNET_MESH_KX_Ping msg;
954
955   LOG (GNUNET_ERROR_TYPE_DEBUG, "%s()\n", __FUNCTION__);
956   msg.header.size = htons (sizeof (msg));
957   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_KX_PING);
958   msg.iv = GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_NONCE, UINT32_MAX);
959   msg.target = *GMP_get_id (t->peer);
960   msg.nonce = t->kx_ctx->challenge;
961
962   LOG (GNUNET_ERROR_TYPE_DEBUG, "  sending %u\n", msg.nonce);
963   LOG (GNUNET_ERROR_TYPE_DEBUG, "  towards %s\n", GNUNET_i2s (&msg.target));
964   t_encrypt (t, &msg.target, &msg.target, ping_encryption_size(), msg.iv);
965   LOG (GNUNET_ERROR_TYPE_DEBUG, "  e sending %u\n", msg.nonce);
966   LOG (GNUNET_ERROR_TYPE_DEBUG, "  e towards %s\n", GNUNET_i2s (&msg.target));
967
968   send_kx (t, &msg.header);
969 }
970
971
972 /**
973  * Send a pong message on a tunnel.
974  *
975  * @param t Tunnel on which to send the pong.
976  * @param challenge Value sent in the ping that we have to send back.
977  */
978 static void
979 send_pong (struct MeshTunnel3 *t, uint32_t challenge)
980 {
981   struct GNUNET_MESH_KX_Pong msg;
982
983   LOG (GNUNET_ERROR_TYPE_DEBUG, "%s()\n", __FUNCTION__);
984   msg.header.size = htons (sizeof (msg));
985   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_KX_PONG);
986   msg.iv = GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_NONCE, UINT32_MAX);
987   msg.nonce = challenge;
988   LOG (GNUNET_ERROR_TYPE_DEBUG, "  sending %u\n", msg.nonce);
989   t_encrypt (t, &msg.nonce, &msg.nonce, sizeof (msg.nonce), msg.iv);
990   LOG (GNUNET_ERROR_TYPE_DEBUG, "  e sending %u\n", msg.nonce);
991
992   send_kx (t, &msg.header);
993 }
994
995
996 /**
997  * Initiate a rekey with the remote peer.
998  *
999  * @param cls Closure (tunnel).
1000  * @param tc TaskContext.
1001  */
1002 static void
1003 rekey_tunnel (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
1004 {
1005   struct MeshTunnel3 *t = cls;
1006
1007   t->rekey_task = GNUNET_SCHEDULER_NO_TASK;
1008
1009   LOG (GNUNET_ERROR_TYPE_DEBUG, "Re-key Tunnel %s\n", GMT_2s (t));
1010   if (NULL != tc && 0 != (GNUNET_SCHEDULER_REASON_SHUTDOWN & tc->reason))
1011     return;
1012
1013   if (NULL == t->kx_ctx)
1014   {
1015     LOG (GNUNET_ERROR_TYPE_DEBUG, "  new kx ctx\n");
1016     t->kx_ctx = GNUNET_new (struct MeshTunnelKXCtx);
1017     t->kx_ctx->challenge =
1018         GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_NONCE, UINT32_MAX);
1019     t->kx_ctx->d_key_old = t->d_key;
1020     LOG (GNUNET_ERROR_TYPE_DEBUG, "  new challenge for %s: %u\n",
1021          GMT_2s (t), t->kx_ctx->challenge);
1022   }
1023   send_ephemeral (t);
1024   switch (t->estate)
1025   {
1026     case MESH_TUNNEL3_KEY_UNINITIALIZED:
1027       t->estate = MESH_TUNNEL3_KEY_SENT;
1028       break;
1029     case MESH_TUNNEL3_KEY_SENT:
1030       break;
1031     case MESH_TUNNEL3_KEY_PING:
1032     case MESH_TUNNEL3_KEY_OK:
1033       send_ping (t);
1034       t->estate = MESH_TUNNEL3_KEY_PING;
1035       break;
1036     default:
1037       LOG (GNUNET_ERROR_TYPE_DEBUG, "Unexpected state %u\n", t->estate);
1038   }
1039
1040   LOG (GNUNET_ERROR_TYPE_DEBUG, "  next call in %s\n",
1041        GNUNET_STRINGS_relative_time_to_string (REKEY_WAIT, GNUNET_YES));
1042   t->rekey_task = GNUNET_SCHEDULER_add_delayed (REKEY_WAIT, &rekey_tunnel, t);
1043 }
1044
1045
1046 /**
1047  * Out ephemeral key has changed, create new session key on all tunnels.
1048  *
1049  * @param cls Closure (size of the hashmap).
1050  * @param key Current public key.
1051  * @param value Value in the hash map (tunnel).
1052  *
1053  * @return #GNUNET_YES, so we should continue to iterate,
1054  */
1055 static int
1056 rekey_iterator (void *cls,
1057                 const struct GNUNET_PeerIdentity *key,
1058                 void *value)
1059 {
1060   struct MeshTunnel3 *t = value;
1061   struct GNUNET_TIME_Relative delay;
1062   long n = (long) cls;
1063   uint32_t r;
1064
1065   if (GNUNET_SCHEDULER_NO_TASK != t->rekey_task)
1066     return GNUNET_YES;
1067
1068   r = GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_WEAK, (uint32_t) n * 100);
1069   delay = GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MILLISECONDS, r);
1070   t->rekey_task = GNUNET_SCHEDULER_add_delayed (delay, &rekey_tunnel, t);
1071
1072   return GNUNET_YES;
1073 }
1074
1075
1076 /**
1077  * Create a new ephemeral key and key message, schedule next rekeying.
1078  *
1079  * @param cls Closure (unused).
1080  * @param tc TaskContext.
1081  */
1082 static void
1083 rekey (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
1084 {
1085   struct GNUNET_TIME_Absolute time;
1086   long n;
1087
1088   rekey_task = GNUNET_SCHEDULER_NO_TASK;
1089
1090   if (0 != (GNUNET_SCHEDULER_REASON_SHUTDOWN & tc->reason))
1091     return;
1092
1093   GNUNET_free_non_null (my_ephemeral_key);
1094   my_ephemeral_key = GNUNET_CRYPTO_ecdhe_key_create ();
1095
1096   time = GNUNET_TIME_absolute_get ();
1097   kx_msg.creation_time = GNUNET_TIME_absolute_hton (time);
1098   time = GNUNET_TIME_absolute_add (time, rekey_period);
1099   time = GNUNET_TIME_absolute_add (time, GNUNET_TIME_UNIT_MINUTES);
1100   kx_msg.expiration_time = GNUNET_TIME_absolute_hton (time);
1101   GNUNET_CRYPTO_ecdhe_key_get_public (my_ephemeral_key, &kx_msg.ephemeral_key);
1102
1103   GNUNET_assert (GNUNET_OK ==
1104                  GNUNET_CRYPTO_eddsa_sign (my_private_key,
1105                                            &kx_msg.purpose,
1106                                            &kx_msg.signature));
1107
1108   n = (long) GNUNET_CONTAINER_multipeermap_size (tunnels);
1109   GNUNET_CONTAINER_multipeermap_iterate (tunnels, &rekey_iterator, (void *) n);
1110
1111   rekey_task = GNUNET_SCHEDULER_add_delayed (rekey_period, &rekey, NULL);
1112 }
1113
1114
1115 /**
1116  * Called only on shutdown, destroy every tunnel.
1117  *
1118  * @param cls Closure (unused).
1119  * @param key Current public key.
1120  * @param value Value in the hash map (tunnel).
1121  *
1122  * @return #GNUNET_YES, so we should continue to iterate,
1123  */
1124 static int
1125 destroy_iterator (void *cls,
1126                 const struct GNUNET_PeerIdentity *key,
1127                 void *value)
1128 {
1129   struct MeshTunnel3 *t = value;
1130
1131   GMT_destroy (t);
1132   return GNUNET_YES;
1133 }
1134
1135
1136 /**
1137  * Notify remote peer that we don't know a channel he is talking about,
1138  * probably CHANNEL_DESTROY was missed.
1139  *
1140  * @param t Tunnel on which to notify.
1141  * @param gid ID of the channel.
1142  */
1143 static void
1144 send_channel_destroy (struct MeshTunnel3 *t, unsigned int gid)
1145 {
1146   struct GNUNET_MESH_ChannelManage msg;
1147
1148   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_CHANNEL_DESTROY);
1149   msg.header.size = htons (sizeof (msg));
1150   msg.chid = htonl (gid);
1151
1152   LOG (GNUNET_ERROR_TYPE_DEBUG,
1153        "WARNING destroying unknown channel %u on tunnel %s\n",
1154        gid, GMT_2s (t));
1155   send_prebuilt_message (&msg.header, t, GNUNET_YES, NULL, NULL, NULL);
1156 }
1157
1158
1159 /**
1160  * Demultiplex data per channel and call appropriate channel handler.
1161  *
1162  * @param t Tunnel on which the data came.
1163  * @param msg Data message.
1164  * @param fwd Is this message fwd? This only is meaningful in loopback channels.
1165  *            #GNUNET_YES if message is FWD on the respective channel (loopback)
1166  *            #GNUNET_NO if message is BCK on the respective channel (loopback)
1167  *            #GNUNET_SYSERR if message on a one-ended channel (remote)
1168  */
1169 static void
1170 handle_data (struct MeshTunnel3 *t,
1171              const struct GNUNET_MESH_Data *msg,
1172              int fwd)
1173 {
1174   struct MeshChannel *ch;
1175   size_t size;
1176
1177   /* Check size */
1178   size = ntohs (msg->header.size);
1179   if (size <
1180       sizeof (struct GNUNET_MESH_Data) +
1181       sizeof (struct GNUNET_MessageHeader))
1182   {
1183     GNUNET_break (0);
1184     return;
1185   }
1186   LOG (GNUNET_ERROR_TYPE_DEBUG, " payload of type %s\n",
1187               GM_m2s (ntohs (msg[1].header.type)));
1188
1189   /* Check channel */
1190   ch = GMT_get_channel (t, ntohl (msg->chid));
1191   if (NULL == ch)
1192   {
1193     GNUNET_STATISTICS_update (stats, "# data on unknown channel",
1194                               1, GNUNET_NO);
1195     LOG (GNUNET_ERROR_TYPE_DEBUG, "WARNING channel 0x%X unknown\n",
1196          ntohl (msg->chid));
1197     send_channel_destroy (t, ntohl (msg->chid));
1198     return;
1199   }
1200
1201   GMCH_handle_data (ch, msg, fwd);
1202 }
1203
1204
1205 /**
1206  * Demultiplex data ACKs per channel and update appropriate channel buffer info.
1207  *
1208  * @param t Tunnel on which the DATA ACK came.
1209  * @param msg DATA ACK message.
1210  * @param fwd Is this message fwd? This only is meaningful in loopback channels.
1211  *            #GNUNET_YES if message is FWD on the respective channel (loopback)
1212  *            #GNUNET_NO if message is BCK on the respective channel (loopback)
1213  *            #GNUNET_SYSERR if message on a one-ended channel (remote)
1214  */
1215 static void
1216 handle_data_ack (struct MeshTunnel3 *t,
1217                  const struct GNUNET_MESH_DataACK *msg,
1218                  int fwd)
1219 {
1220   struct MeshChannel *ch;
1221   size_t size;
1222
1223   /* Check size */
1224   size = ntohs (msg->header.size);
1225   if (size != sizeof (struct GNUNET_MESH_DataACK))
1226   {
1227     GNUNET_break (0);
1228     return;
1229   }
1230
1231   /* Check channel */
1232   ch = GMT_get_channel (t, ntohl (msg->chid));
1233   if (NULL == ch)
1234   {
1235     GNUNET_STATISTICS_update (stats, "# data ack on unknown channel",
1236                               1, GNUNET_NO);
1237     LOG (GNUNET_ERROR_TYPE_DEBUG, "WARNING channel %u unknown\n",
1238          ntohl (msg->chid));
1239     return;
1240   }
1241
1242   GMCH_handle_data_ack (ch, msg, fwd);
1243 }
1244
1245
1246 /**
1247  * Handle channel create.
1248  *
1249  * @param t Tunnel on which the data came.
1250  * @param msg Data message.
1251  */
1252 static void
1253 handle_ch_create (struct MeshTunnel3 *t,
1254                   const struct GNUNET_MESH_ChannelCreate *msg)
1255 {
1256   struct MeshChannel *ch;
1257   size_t size;
1258
1259   /* Check size */
1260   size = ntohs (msg->header.size);
1261   if (size != sizeof (struct GNUNET_MESH_ChannelCreate))
1262   {
1263     GNUNET_break (0);
1264     return;
1265   }
1266
1267   /* Check channel */
1268   ch = GMT_get_channel (t, ntohl (msg->chid));
1269   if (NULL != ch && ! GMT_is_loopback (t))
1270   {
1271     /* Probably a retransmission, safe to ignore */
1272     LOG (GNUNET_ERROR_TYPE_DEBUG, "   already exists...\n");
1273   }
1274   else
1275   {
1276     ch = GMCH_handle_create (t, msg);
1277   }
1278   if (NULL != ch)
1279     GMT_add_channel (t, ch);
1280 }
1281
1282
1283
1284 /**
1285  * Handle channel NACK: check correctness and call channel handler for NACKs.
1286  *
1287  * @param t Tunnel on which the NACK came.
1288  * @param msg NACK message.
1289  */
1290 static void
1291 handle_ch_nack (struct MeshTunnel3 *t,
1292                 const struct GNUNET_MESH_ChannelManage *msg)
1293 {
1294   struct MeshChannel *ch;
1295   size_t size;
1296
1297   /* Check size */
1298   size = ntohs (msg->header.size);
1299   if (size != sizeof (struct GNUNET_MESH_ChannelManage))
1300   {
1301     GNUNET_break (0);
1302     return;
1303   }
1304
1305   /* Check channel */
1306   ch = GMT_get_channel (t, ntohl (msg->chid));
1307   if (NULL == ch)
1308   {
1309     GNUNET_STATISTICS_update (stats, "# channel NACK on unknown channel",
1310                               1, GNUNET_NO);
1311     LOG (GNUNET_ERROR_TYPE_DEBUG, "WARNING channel %u unknown\n",
1312          ntohl (msg->chid));
1313     return;
1314   }
1315
1316   GMCH_handle_nack (ch);
1317 }
1318
1319
1320 /**
1321  * Handle a CHANNEL ACK (SYNACK/ACK).
1322  *
1323  * @param t Tunnel on which the CHANNEL ACK came.
1324  * @param msg CHANNEL ACK message.
1325  * @param fwd Is this message fwd? This only is meaningful in loopback channels.
1326  *            #GNUNET_YES if message is FWD on the respective channel (loopback)
1327  *            #GNUNET_NO if message is BCK on the respective channel (loopback)
1328  *            #GNUNET_SYSERR if message on a one-ended channel (remote)
1329  */
1330 static void
1331 handle_ch_ack (struct MeshTunnel3 *t,
1332                const struct GNUNET_MESH_ChannelManage *msg,
1333                int fwd)
1334 {
1335   struct MeshChannel *ch;
1336   size_t size;
1337
1338   /* Check size */
1339   size = ntohs (msg->header.size);
1340   if (size != sizeof (struct GNUNET_MESH_ChannelManage))
1341   {
1342     GNUNET_break (0);
1343     return;
1344   }
1345
1346   /* Check channel */
1347   ch = GMT_get_channel (t, ntohl (msg->chid));
1348   if (NULL == ch)
1349   {
1350     GNUNET_STATISTICS_update (stats, "# channel ack on unknown channel",
1351                               1, GNUNET_NO);
1352     LOG (GNUNET_ERROR_TYPE_DEBUG, "WARNING channel %u unknown\n",
1353          ntohl (msg->chid));
1354     return;
1355   }
1356
1357   GMCH_handle_ack (ch, msg, fwd);
1358 }
1359
1360
1361
1362 /**
1363  * Handle a channel destruction message.
1364  *
1365  * @param t Tunnel on which the message came.
1366  * @param msg Channel destroy message.
1367  * @param fwd Is this message fwd? This only is meaningful in loopback channels.
1368  *            #GNUNET_YES if message is FWD on the respective channel (loopback)
1369  *            #GNUNET_NO if message is BCK on the respective channel (loopback)
1370  *            #GNUNET_SYSERR if message on a one-ended channel (remote)
1371  */
1372 static void
1373 handle_ch_destroy (struct MeshTunnel3 *t,
1374                    const struct GNUNET_MESH_ChannelManage *msg,
1375                    int fwd)
1376 {
1377   struct MeshChannel *ch;
1378   size_t size;
1379
1380   /* Check size */
1381   size = ntohs (msg->header.size);
1382   if (size != sizeof (struct GNUNET_MESH_ChannelManage))
1383   {
1384     GNUNET_break (0);
1385     return;
1386   }
1387
1388   /* Check channel */
1389   ch = GMT_get_channel (t, ntohl (msg->chid));
1390   if (NULL == ch)
1391   {
1392     /* Probably a retransmission, safe to ignore */
1393     return;
1394   }
1395
1396   GMCH_handle_destroy (ch, msg, fwd);
1397 }
1398
1399
1400 /**
1401  * The peer's ephemeral key has changed: update the symmetrical keys.
1402  *
1403  * @param t Tunnel this message came on.
1404  * @param msg Key eXchange message.
1405  */
1406 static void
1407 handle_ephemeral (struct MeshTunnel3 *t,
1408                   const struct GNUNET_MESH_KX_Ephemeral *msg)
1409 {
1410   struct GNUNET_HashCode km;
1411   LOG (GNUNET_ERROR_TYPE_DEBUG, "  ephemeral key message\n");
1412
1413   if (GNUNET_OK != check_ephemeral (t, msg))
1414   {
1415     GNUNET_break_op (0);
1416     return;
1417   }
1418   derive_key_material (&km, &msg->ephemeral_key);
1419   LOG (GNUNET_ERROR_TYPE_DEBUG, "  km is %s\n", GNUNET_h2s (&km));
1420   derive_symmertic (&t->e_key, &my_full_id, GMP_get_id (t->peer), &km);
1421   derive_symmertic (&t->d_key, GMP_get_id (t->peer), &my_full_id, &km);
1422   if (MESH_TUNNEL3_KEY_SENT == t->estate)
1423   {
1424     LOG (GNUNET_ERROR_TYPE_DEBUG, "  our key was sent, send ping\n");
1425     send_ping (t);
1426     t->estate = MESH_TUNNEL3_KEY_PING;
1427   }
1428 }
1429
1430
1431 /**
1432  * Peer wants to check our symmetrical keys by sending an encrypted challenge.
1433  * Answer with by retransmitting the challenge with the "opposite" key.
1434  *
1435  * @param t Tunnel this message came on.
1436  * @param msg Key eXchange Ping message.
1437  */
1438 static void
1439 handle_ping (struct MeshTunnel3 *t,
1440              const struct GNUNET_MESH_KX_Ping *msg)
1441 {
1442   struct GNUNET_MESH_KX_Ping res;
1443
1444   if (ntohs (msg->header.size) != sizeof (res))
1445   {
1446     GNUNET_break_op (0);
1447     return;
1448   }
1449
1450   LOG (GNUNET_ERROR_TYPE_DEBUG, "  ping message\n");
1451   t_decrypt (t, &res.target, &msg->target, ping_encryption_size (), msg->iv);
1452   if (0 != memcmp (&my_full_id, &res.target, sizeof (my_full_id)))
1453   {
1454     GNUNET_break_op (0);
1455     LOG (GNUNET_ERROR_TYPE_DEBUG, "  e got %u\n", msg->nonce);
1456     LOG (GNUNET_ERROR_TYPE_DEBUG, "  e towards %s\n", GNUNET_i2s (&msg->target));
1457     LOG (GNUNET_ERROR_TYPE_DEBUG, "  got %u\n", res.nonce);
1458     LOG (GNUNET_ERROR_TYPE_DEBUG, "  towards %s\n", GNUNET_i2s (&res.target));
1459     return;
1460   }
1461
1462   send_pong (t, res.nonce);
1463 }
1464
1465
1466 /**
1467  * Peer has answer to our challenge.
1468  * If answer is successful, consider the key exchange finished and clean
1469  * up all related state.
1470  *
1471  * @param t Tunnel this message came on.
1472  * @param msg Key eXchange Pong message.
1473  */
1474 static void
1475 handle_pong (struct MeshTunnel3 *t,
1476              const struct GNUNET_MESH_KX_Pong *msg)
1477 {
1478   uint32_t challenge;
1479
1480   LOG (GNUNET_ERROR_TYPE_DEBUG, "PONG received\n");
1481   if (GNUNET_SCHEDULER_NO_TASK == t->rekey_task)
1482   {
1483     GNUNET_STATISTICS_update (stats, "# duplicate PONG messages", 1, GNUNET_NO);
1484     return;
1485   }
1486   t_decrypt (t, &challenge, &msg->nonce, sizeof (uint32_t), msg->iv);
1487
1488   if (challenge != t->kx_ctx->challenge)
1489   {
1490     LOG (GNUNET_ERROR_TYPE_DEBUG,
1491          "Wrong PONG challenge: %u (e: %u). Expected: %u.\n",
1492          challenge, msg->nonce, t->kx_ctx->challenge);
1493     GNUNET_break_op (0);
1494     return;
1495   }
1496   GNUNET_SCHEDULER_cancel (t->rekey_task);
1497   t->rekey_task = GNUNET_SCHEDULER_NO_TASK;
1498   GNUNET_free (t->kx_ctx);
1499   t->kx_ctx = NULL;
1500   GMT_change_estate (t, MESH_TUNNEL3_KEY_OK);
1501 }
1502
1503
1504 /**
1505  * Demultiplex by message type and call appropriate handler for a message
1506  * towards a channel of a local tunnel.
1507  *
1508  * @param t Tunnel this message came on.
1509  * @param msgh Message header.
1510  * @param fwd Is this message fwd? This only is meaningful in loopback channels.
1511  *            #GNUNET_YES if message is FWD on the respective channel (loopback)
1512  *            #GNUNET_NO if message is BCK on the respective channel (loopback)
1513  *            #GNUNET_SYSERR if message on a one-ended channel (remote)
1514  */
1515 static void
1516 handle_decrypted (struct MeshTunnel3 *t,
1517                   const struct GNUNET_MessageHeader *msgh,
1518                   int fwd)
1519 {
1520   uint16_t type;
1521
1522   type = ntohs (msgh->type);
1523   LOG (GNUNET_ERROR_TYPE_DEBUG,
1524        "Got a %s message!\n",
1525        GM_m2s (type));
1526
1527   switch (type)
1528   {
1529     case GNUNET_MESSAGE_TYPE_MESH_DATA:
1530       /* Don't send hop ACK, wait for client to ACK */
1531       handle_data (t, (struct GNUNET_MESH_Data *) msgh, fwd);
1532       break;
1533
1534     case GNUNET_MESSAGE_TYPE_MESH_DATA_ACK:
1535       handle_data_ack (t, (struct GNUNET_MESH_DataACK *) msgh, fwd);
1536       break;
1537
1538     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_CREATE:
1539       handle_ch_create (t,
1540                         (struct GNUNET_MESH_ChannelCreate *) msgh);
1541       break;
1542
1543     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_NACK:
1544       handle_ch_nack (t,
1545                       (struct GNUNET_MESH_ChannelManage *) msgh);
1546       break;
1547
1548     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_ACK:
1549       handle_ch_ack (t,
1550                      (struct GNUNET_MESH_ChannelManage *) msgh,
1551                      fwd);
1552       break;
1553
1554     case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_DESTROY:
1555       handle_ch_destroy (t,
1556                          (struct GNUNET_MESH_ChannelManage *) msgh,
1557                          fwd);
1558       break;
1559
1560     default:
1561       GNUNET_break_op (0);
1562       LOG (GNUNET_ERROR_TYPE_DEBUG,
1563            "end-to-end message not known (%u)\n",
1564            ntohs (msgh->type));
1565   }
1566 }
1567
1568 /******************************************************************************/
1569 /********************************    API    ***********************************/
1570 /******************************************************************************/
1571
1572 /**
1573  * Decrypt and demultiplex by message type. Call appropriate handler
1574  * for every message.
1575  *
1576  * @param t Tunnel this message came on.
1577  * @param msg Encrypted message.
1578  */
1579 void
1580 GMT_handle_encrypted (struct MeshTunnel3 *t,
1581                       const struct GNUNET_MESH_Encrypted *msg)
1582 {
1583   size_t size = ntohs (msg->header.size);
1584   size_t payload_size = size - sizeof (struct GNUNET_MESH_Encrypted);
1585   size_t decrypted_size;
1586   char cbuf [payload_size];
1587   struct GNUNET_MessageHeader *msgh;
1588   unsigned int off;
1589
1590   decrypted_size = t_decrypt (t, cbuf, &msg[1], payload_size, msg->iv);
1591   off = 0;
1592   while (off < decrypted_size)
1593   {
1594     msgh = (struct GNUNET_MessageHeader *) &cbuf[off];
1595     handle_decrypted (t, msgh, GNUNET_SYSERR);
1596     off += ntohs (msgh->size);
1597   }
1598 }
1599
1600
1601 /**
1602  * Demultiplex an encapsulated KX message by message type.
1603  *
1604  * @param t Tunnel on which the message came.
1605  * @param message Payload of KX message.
1606  */
1607 void
1608 GMT_handle_kx (struct MeshTunnel3 *t,
1609                const struct GNUNET_MessageHeader *message)
1610 {
1611   uint16_t type;
1612
1613   type = ntohs (message->type);
1614   LOG (GNUNET_ERROR_TYPE_DEBUG, "kx message received\n", type);
1615   switch (type)
1616   {
1617     case GNUNET_MESSAGE_TYPE_MESH_KX_EPHEMERAL:
1618       handle_ephemeral (t, (struct GNUNET_MESH_KX_Ephemeral *) message);
1619       break;
1620
1621     case GNUNET_MESSAGE_TYPE_MESH_KX_PING:
1622       handle_ping (t, (struct GNUNET_MESH_KX_Ping *) message);
1623       break;
1624
1625     case GNUNET_MESSAGE_TYPE_MESH_KX_PONG:
1626       handle_pong (t, (struct GNUNET_MESH_KX_Pong *) message);
1627       break;
1628
1629     default:
1630       GNUNET_break_op (0);
1631       LOG (GNUNET_ERROR_TYPE_DEBUG, "kx message not known (%u)\n", type);
1632   }
1633 }
1634
1635
1636 /**
1637  * Initialize the tunnel subsystem.
1638  *
1639  * @param c Configuration handle.
1640  * @param key ECC private key, to derive all other keys and do crypto.
1641  */
1642 void
1643 GMT_init (const struct GNUNET_CONFIGURATION_Handle *c,
1644           const struct GNUNET_CRYPTO_EddsaPrivateKey *key)
1645 {
1646   LOG (GNUNET_ERROR_TYPE_DEBUG, "init\n");
1647   if (GNUNET_OK !=
1648       GNUNET_CONFIGURATION_get_value_number (c, "MESH", "DEFAULT_TTL",
1649                                              &default_ttl))
1650   {
1651     GNUNET_log_config_invalid (GNUNET_ERROR_TYPE_WARNING,
1652                                "MESH", "DEFAULT_TTL", "USING DEFAULT");
1653     default_ttl = 64;
1654   }
1655   if (GNUNET_OK !=
1656       GNUNET_CONFIGURATION_get_value_time (c, "MESH", "REKEY_PERIOD",
1657                                            &rekey_period))
1658   {
1659     rekey_period = GNUNET_TIME_UNIT_DAYS;
1660   }
1661
1662   my_private_key = key;
1663   kx_msg.header.size = htons (sizeof (kx_msg));
1664   kx_msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_KX_EPHEMERAL);
1665   kx_msg.purpose.purpose = htonl (GNUNET_SIGNATURE_PURPOSE_MESH_KX);
1666   kx_msg.purpose.size = htonl (ephemeral_purpose_size ());
1667   kx_msg.origin_identity = my_full_id;
1668   rekey_task = GNUNET_SCHEDULER_add_now (&rekey, NULL);
1669
1670   tunnels = GNUNET_CONTAINER_multipeermap_create (128, GNUNET_YES);
1671 }
1672
1673
1674 /**
1675  * Shut down the tunnel subsystem.
1676  */
1677 void
1678 GMT_shutdown (void)
1679 {
1680   if (GNUNET_SCHEDULER_NO_TASK != rekey_task)
1681   {
1682     GNUNET_SCHEDULER_cancel (rekey_task);
1683     rekey_task = GNUNET_SCHEDULER_NO_TASK;
1684   }
1685   GNUNET_CONTAINER_multipeermap_iterate (tunnels, &destroy_iterator, NULL);
1686   GNUNET_CONTAINER_multipeermap_destroy (tunnels);
1687 }
1688
1689
1690 /**
1691  * Create a tunnel.
1692  *
1693  * @param destination Peer this tunnel is towards.
1694  */
1695 struct MeshTunnel3 *
1696 GMT_new (struct MeshPeer *destination)
1697 {
1698   struct MeshTunnel3 *t;
1699
1700   t = GNUNET_new (struct MeshTunnel3);
1701   t->next_chid = 0;
1702   t->peer = destination;
1703
1704   if (GNUNET_OK !=
1705       GNUNET_CONTAINER_multipeermap_put (tunnels, GMP_get_id (destination), t,
1706                                          GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST))
1707   {
1708     GNUNET_break (0);
1709     GNUNET_free (t);
1710     return NULL;
1711   }
1712   return t;
1713 }
1714
1715
1716 /**
1717  * Change the tunnel's connection state.
1718  *
1719  * @param t Tunnel whose connection state to change.
1720  * @param cstate New connection state.
1721  */
1722 void
1723 GMT_change_cstate (struct MeshTunnel3* t, enum MeshTunnel3CState cstate)
1724 {
1725   if (NULL == t)
1726     return;
1727   LOG (GNUNET_ERROR_TYPE_DEBUG,
1728               "Tunnel %s cstate was %s\n",
1729               GMP_2s (t->peer), cstate2s (t->cstate));
1730   LOG (GNUNET_ERROR_TYPE_DEBUG,
1731               "Tunnel %s cstate is now %s\n",
1732               GMP_2s (t->peer), cstate2s (cstate));
1733   if (myid != GMP_get_short_id (t->peer) &&
1734       MESH_TUNNEL3_READY != t->cstate &&
1735       MESH_TUNNEL3_READY == cstate)
1736   {
1737     t->cstate = cstate;
1738     if (MESH_TUNNEL3_KEY_OK == t->estate)
1739     {
1740       LOG (GNUNET_ERROR_TYPE_DEBUG, "  triggered send queued data\n");
1741       send_queued_data (t);
1742     }
1743     else if (MESH_TUNNEL3_KEY_UNINITIALIZED == t->estate)
1744     {
1745       LOG (GNUNET_ERROR_TYPE_DEBUG, "  triggered rekey\n");
1746       rekey_tunnel (t, NULL);
1747     }
1748   }
1749   t->cstate = cstate;
1750
1751   if (MESH_TUNNEL3_READY == cstate && 3 <= GMT_count_connections (t))
1752   {
1753     GMP_stop_search (t->peer);
1754   }
1755 }
1756
1757 /**
1758  * Change the tunnel encryption state.
1759  *
1760  * @param t Tunnel whose encryption state to change.
1761  * @param state New encryption state.
1762  */
1763 void
1764 GMT_change_estate (struct MeshTunnel3* t, enum MeshTunnel3EState state)
1765 {
1766   if (NULL == t)
1767     return;
1768   LOG (GNUNET_ERROR_TYPE_DEBUG,
1769        "Tunnel %s estate was %s\n",
1770        GMP_2s (t->peer), estate2s (t->estate));
1771   LOG (GNUNET_ERROR_TYPE_DEBUG,
1772        "Tunnel %s estate is now %s\n",
1773        GMP_2s (t->peer), estate2s (state));
1774   if (myid != GMP_get_short_id (t->peer) &&
1775       MESH_TUNNEL3_KEY_OK != t->estate && MESH_TUNNEL3_KEY_OK == state)
1776   {
1777     t->estate = state;
1778     send_queued_data (t);
1779     return;
1780   }
1781   t->estate = state;
1782 }
1783
1784
1785 /**
1786  * Add a connection to a tunnel.
1787  *
1788  * @param t Tunnel.
1789  * @param c Connection.
1790  */
1791 void
1792 GMT_add_connection (struct MeshTunnel3 *t, struct MeshConnection *c)
1793 {
1794   struct MeshTConnection *aux;
1795
1796   GNUNET_assert (NULL != c);
1797
1798   for (aux = t->connection_head; aux != NULL; aux = aux->next)
1799     if (aux->c == c)
1800       return;
1801
1802   aux = GNUNET_new (struct MeshTConnection);
1803   aux->c = c;
1804   GNUNET_CONTAINER_DLL_insert_tail (t->connection_head, t->connection_tail, aux);
1805 }
1806
1807
1808 /**
1809  * Mark a path as no longer valid for this tunnel: has been tried and failed.
1810  *
1811  * @param t Tunnel to update.
1812  * @param path Invalid path to remove. Is destroyed after removal.
1813  */
1814 void
1815 GMT_remove_path (struct MeshTunnel3 *t, struct MeshPeerPath *path)
1816 {
1817   GMP_remove_path (t->peer, path);
1818 }
1819
1820
1821 /**
1822  * Remove a connection from a tunnel.
1823  *
1824  * @param t Tunnel.
1825  * @param c Connection.
1826  */
1827 void
1828 GMT_remove_connection (struct MeshTunnel3 *t,
1829                        struct MeshConnection *c)
1830 {
1831   struct MeshTConnection *aux;
1832   struct MeshTConnection *next;
1833
1834   LOG (GNUNET_ERROR_TYPE_DEBUG, "Removing connection %s from tunnel %s\n",
1835        GMC_2s (c), GMT_2s (t));
1836   for (aux = t->connection_head; aux != NULL; aux = next)
1837   {
1838     next = aux->next;
1839     if (aux->c == c)
1840     {
1841       GNUNET_CONTAINER_DLL_remove (t->connection_head, t->connection_tail, aux);
1842       GNUNET_free (aux);
1843     }
1844   }
1845
1846   /* Start new connections if needed */
1847   if (NULL == t->connection_head
1848       && GNUNET_NO == t->destroy
1849       && GNUNET_NO == shutting_down)
1850   {
1851     LOG (GNUNET_ERROR_TYPE_DEBUG, "  no more connections, getting new ones\n");
1852     GMP_connect (t->peer);
1853     t->cstate = MESH_TUNNEL3_SEARCHING;
1854     return;
1855   }
1856
1857   /* If not marked as ready, no change is needed */
1858   if (MESH_TUNNEL3_READY != t->cstate)
1859     return;
1860
1861   /* Check if any connection is ready to maintaing cstate */
1862   for (aux = t->connection_head; aux != NULL; aux = aux->next)
1863     if (MESH_CONNECTION_READY == GMC_get_state (aux->c))
1864       return;
1865
1866   t->cstate = MESH_TUNNEL3_WAITING;
1867 }
1868
1869
1870 /**
1871  * Add a channel to a tunnel.
1872  *
1873  * @param t Tunnel.
1874  * @param ch Channel.
1875  */
1876 void
1877 GMT_add_channel (struct MeshTunnel3 *t, struct MeshChannel *ch)
1878 {
1879   struct MeshTChannel *aux;
1880
1881   GNUNET_assert (NULL != ch);
1882
1883   LOG (GNUNET_ERROR_TYPE_DEBUG, "Adding channel %p to tunnel %p\n", ch, t);
1884
1885   for (aux = t->channel_head; aux != NULL; aux = aux->next)
1886   {
1887     LOG (GNUNET_ERROR_TYPE_DEBUG, "  already there %p\n", aux->ch);
1888     if (aux->ch == ch)
1889       return;
1890   }
1891
1892   aux = GNUNET_new (struct MeshTChannel);
1893   aux->ch = ch;
1894   LOG (GNUNET_ERROR_TYPE_DEBUG, " adding %p to %p\n", aux, t->channel_head);
1895   GNUNET_CONTAINER_DLL_insert_tail (t->channel_head, t->channel_tail, aux);
1896
1897   if (GNUNET_YES == t->destroy)
1898   {
1899     t->destroy = GNUNET_NO;
1900     LOG (GNUNET_ERROR_TYPE_DEBUG, " undo destroy!\n");
1901   }
1902 }
1903
1904
1905 /**
1906  * Remove a channel from a tunnel.
1907  *
1908  * @param t Tunnel.
1909  * @param ch Channel.
1910  */
1911 void
1912 GMT_remove_channel (struct MeshTunnel3 *t, struct MeshChannel *ch)
1913 {
1914   struct MeshTChannel *aux;
1915
1916   LOG (GNUNET_ERROR_TYPE_DEBUG, "Removing channel %p from tunnel %p\n", ch, t);
1917   for (aux = t->channel_head; aux != NULL; aux = aux->next)
1918   {
1919     if (aux->ch == ch)
1920     {
1921       LOG (GNUNET_ERROR_TYPE_DEBUG, " found! %s\n", GMCH_2s (ch));
1922       GNUNET_CONTAINER_DLL_remove (t->channel_head, t->channel_tail, aux);
1923       GNUNET_free (aux);
1924       return;
1925     }
1926   }
1927 }
1928
1929
1930 /**
1931  * Search for a channel by global ID.
1932  *
1933  * @param t Tunnel containing the channel.
1934  * @param chid Public channel number.
1935  *
1936  * @return channel handler, NULL if doesn't exist
1937  */
1938 struct MeshChannel *
1939 GMT_get_channel (struct MeshTunnel3 *t, MESH_ChannelNumber chid)
1940 {
1941   struct MeshTChannel *iter;
1942
1943   if (NULL == t)
1944     return NULL;
1945
1946   for (iter = t->channel_head; NULL != iter; iter = iter->next)
1947   {
1948     if (GMCH_get_id (iter->ch) == chid)
1949       break;
1950   }
1951
1952   return NULL == iter ? NULL : iter->ch;
1953 }
1954
1955
1956 /**
1957  * Tunnel is empty: destroy it.
1958  *
1959  * Notifies all connections about the destruction.
1960  *
1961  * @param t Tunnel to destroy.
1962  */
1963 void
1964 GMT_destroy_empty (struct MeshTunnel3 *t)
1965 {
1966   struct MeshTConnection *iter;
1967
1968   LOG (GNUNET_ERROR_TYPE_DEBUG, "Tunnel %s empty: destroying scheduled\n",
1969        GMT_2s (t));
1970   for (iter = t->connection_head; NULL != iter; iter = iter->next)
1971   {
1972     GMC_send_destroy (iter->c);
1973   }
1974
1975   if (GNUNET_SCHEDULER_NO_TASK != t->rekey_task)
1976   {
1977     t->estate = MESH_TUNNEL3_KEY_UNINITIALIZED;
1978     GNUNET_SCHEDULER_cancel (t->rekey_task);
1979     t->rekey_task = GNUNET_SCHEDULER_NO_TASK;
1980     GNUNET_free (t->kx_ctx);
1981     t->kx_ctx = NULL;
1982   }
1983   t->cstate = MESH_TUNNEL3_NEW;
1984   t->destroy = GNUNET_YES;
1985 }
1986
1987
1988 /**
1989  * Destroy tunnel if empty (no more channels).
1990  *
1991  * @param t Tunnel to destroy if empty.
1992  */
1993 void
1994 GMT_destroy_if_empty (struct MeshTunnel3 *t)
1995 {
1996   if (1 < GMT_count_channels (t))
1997     return;
1998
1999   GMT_destroy_empty (t);
2000 }
2001
2002
2003 /**
2004  * Destroy the tunnel.
2005  *
2006  * This function does not generate any warning traffic to clients or peers.
2007  *
2008  * Tasks:
2009  * Cancel messages belonging to this tunnel queued to neighbors.
2010  * Free any allocated resources linked to the tunnel.
2011  *
2012  * @param t The tunnel to destroy.
2013  */
2014 void
2015 GMT_destroy (struct MeshTunnel3 *t)
2016 {
2017   struct MeshTConnection *iter_c;
2018   struct MeshTConnection *next_c;
2019   struct MeshTChannel *iter_ch;
2020   struct MeshTChannel *next_ch;
2021
2022   if (NULL == t)
2023     return;
2024
2025   t->destroy = 2;
2026
2027   LOG (GNUNET_ERROR_TYPE_DEBUG, "destroying tunnel %s\n", GMP_2s (t->peer));
2028
2029   GNUNET_break (GNUNET_YES ==
2030                 GNUNET_CONTAINER_multipeermap_remove (tunnels,
2031                                                       GMP_get_id (t->peer), t));
2032
2033   for (iter_c = t->connection_head; NULL != iter_c; iter_c = next_c)
2034   {
2035     next_c = iter_c->next;
2036     GMC_destroy (iter_c->c);
2037   }
2038   for (iter_ch = t->channel_head; NULL != iter_ch; iter_ch = next_ch)
2039   {
2040     next_ch = iter_ch->next;
2041     GMCH_destroy (iter_ch->ch);
2042     /* Should only happen on shutdown, but it's ok. */
2043   }
2044
2045   GNUNET_STATISTICS_update (stats, "# tunnels", -1, GNUNET_NO);
2046   GMP_set_tunnel (t->peer, NULL);
2047
2048   if (GNUNET_SCHEDULER_NO_TASK != t->rekey_task)
2049     GNUNET_SCHEDULER_cancel (t->rekey_task);
2050
2051   GNUNET_free (t);
2052 }
2053
2054
2055 /**
2056  * @brief Use the given path for the tunnel.
2057  * Update the next and prev hops (and RCs).
2058  * (Re)start the path refresh in case the tunnel is locally owned.
2059  *
2060  * @param t Tunnel to update.
2061  * @param p Path to use.
2062  *
2063  * @return Connection created.
2064  */
2065 struct MeshConnection *
2066 GMT_use_path (struct MeshTunnel3 *t, struct MeshPeerPath *p)
2067 {
2068   struct MeshConnection *c;
2069   struct GNUNET_HashCode cid;
2070   unsigned int own_pos;
2071
2072   if (NULL == t || NULL == p)
2073   {
2074     GNUNET_break (0);
2075     return NULL;
2076   }
2077
2078   for (own_pos = 0; own_pos < p->length; own_pos++)
2079   {
2080     if (p->peers[own_pos] == myid)
2081       break;
2082   }
2083   if (own_pos > p->length - 1)
2084   {
2085     GNUNET_break_op (0);
2086     return NULL;
2087   }
2088
2089   GNUNET_CRYPTO_hash_create_random (GNUNET_CRYPTO_QUALITY_NONCE, &cid);
2090   c = GMC_new (&cid, t, p, own_pos);
2091   if (NULL == c)
2092   {
2093     /* Path was flawed */
2094     return NULL;
2095   }
2096   GMT_add_connection (t, c);
2097   return c;
2098 }
2099
2100
2101 /**
2102  * Count established (ready) connections of a tunnel.
2103  *
2104  * @param t Tunnel on which to count.
2105  *
2106  * @return Number of connections.
2107  */
2108 unsigned int
2109 GMT_count_connections (struct MeshTunnel3 *t)
2110 {
2111   struct MeshTConnection *iter;
2112   unsigned int count;
2113
2114   for (count = 0, iter = t->connection_head; NULL != iter; iter = iter->next)
2115     if (MESH_CONNECTION_DESTROYED != GMC_get_state (iter->c))
2116       count++;
2117
2118   return count;
2119 }
2120
2121 /**
2122  * Count channels of a tunnel.
2123  *
2124  * @param t Tunnel on which to count.
2125  *
2126  * @return Number of channels.
2127  */
2128 unsigned int
2129 GMT_count_channels (struct MeshTunnel3 *t)
2130 {
2131   struct MeshTChannel *iter;
2132   unsigned int count;
2133
2134   for (count = 0, iter = t->channel_head;
2135        NULL != iter;
2136        iter = iter->next, count++) /* skip */;
2137
2138   return count;
2139 }
2140
2141
2142 /**
2143  * Get the connectivity state of a tunnel.
2144  *
2145  * @param t Tunnel.
2146  *
2147  * @return Tunnel's connectivity state.
2148  */
2149 enum MeshTunnel3CState
2150 GMT_get_cstate (struct MeshTunnel3 *t)
2151 {
2152   if (NULL == t)
2153   {
2154     GNUNET_assert (0);
2155     return (enum MeshTunnel3CState) -1;
2156   }
2157   return t->cstate;
2158 }
2159
2160
2161 /**
2162  * Get the maximum buffer space for a tunnel towards a local client.
2163  *
2164  * @param t Tunnel.
2165  *
2166  * @return Biggest buffer space offered by any channel in the tunnel.
2167  */
2168 unsigned int
2169 GMT_get_channels_buffer (struct MeshTunnel3 *t)
2170 {
2171   struct MeshTChannel *iter;
2172   unsigned int buffer;
2173   unsigned int ch_buf;
2174
2175   if (NULL == t->channel_head)
2176   {
2177     /* Probably getting buffer for a channel create/handshake. */
2178     return 64;
2179   }
2180
2181   buffer = 0;
2182   for (iter = t->channel_head; NULL != iter; iter = iter->next)
2183   {
2184     ch_buf = get_channel_buffer (iter);
2185     if (ch_buf > buffer)
2186       buffer = ch_buf;
2187   }
2188   return buffer;
2189 }
2190
2191
2192 /**
2193  * Get the total buffer space for a tunnel for P2P traffic.
2194  *
2195  * @param t Tunnel.
2196  *
2197  * @return Buffer space offered by all connections in the tunnel.
2198  */
2199 unsigned int
2200 GMT_get_connections_buffer (struct MeshTunnel3 *t)
2201 {
2202   struct MeshTConnection *iter;
2203   unsigned int buffer;
2204
2205   buffer = 0;
2206   for (iter = t->connection_head; NULL != iter; iter = iter->next)
2207   {
2208     if (GMC_get_state (iter->c) != MESH_CONNECTION_READY)
2209     {
2210       continue;
2211     }
2212     buffer += get_connection_buffer (iter);
2213   }
2214
2215   return buffer;
2216 }
2217
2218
2219 /**
2220  * Get the tunnel's destination.
2221  *
2222  * @param t Tunnel.
2223  *
2224  * @return ID of the destination peer.
2225  */
2226 const struct GNUNET_PeerIdentity *
2227 GMT_get_destination (struct MeshTunnel3 *t)
2228 {
2229   return GMP_get_id (t->peer);
2230 }
2231
2232
2233 /**
2234  * Get the tunnel's next free global channel ID.
2235  *
2236  * @param t Tunnel.
2237  *
2238  * @return GID of a channel free to use.
2239  */
2240 MESH_ChannelNumber
2241 GMT_get_next_chid (struct MeshTunnel3 *t)
2242 {
2243   MESH_ChannelNumber chid;
2244   MESH_ChannelNumber mask;
2245   int result;
2246
2247   /* Set bit 30 depending on the ID relationship. Bit 31 is always 0 for GID.
2248    * If our ID is bigger or loopback tunnel, start at 0, bit 30 = 0
2249    * If peer's ID is bigger, start at 0x4... bit 30 = 1
2250    */
2251   result = GNUNET_CRYPTO_cmp_peer_identity (&my_full_id, GMP_get_id (t->peer));
2252   if (0 > result)
2253     mask = 0x4000000;
2254   else
2255     mask = 0x0;
2256
2257   while (NULL != GMT_get_channel (t, t->next_chid))
2258   {
2259     LOG (GNUNET_ERROR_TYPE_DEBUG, "Channel %u exists...\n", t->next_chid);
2260     t->next_chid = (t->next_chid + 1) & ~GNUNET_MESH_LOCAL_CHANNEL_ID_CLI;
2261     t->next_chid |= mask;
2262   }
2263   chid = t->next_chid;
2264   t->next_chid = (t->next_chid + 1) & ~GNUNET_MESH_LOCAL_CHANNEL_ID_CLI;
2265   t->next_chid |= mask;
2266
2267   return chid;
2268 }
2269
2270
2271 /**
2272  * Send ACK on one or more channels due to buffer in connections.
2273  *
2274  * @param t Channel which has some free buffer space.
2275  */
2276 void
2277 GMT_unchoke_channels (struct MeshTunnel3 *t)
2278 {
2279   struct MeshTChannel *iter;
2280   unsigned int buffer;
2281   unsigned int channels = GMT_count_channels (t);
2282   unsigned int choked_n;
2283   struct MeshChannel *choked[channels];
2284
2285   LOG (GNUNET_ERROR_TYPE_DEBUG, "GMT_unchoke_channels on %s\n", GMT_2s (t));
2286   LOG (GNUNET_ERROR_TYPE_DEBUG, " head: %p\n", t->channel_head);
2287   if (NULL != t->channel_head)
2288     LOG (GNUNET_ERROR_TYPE_DEBUG, " head ch: %p\n", t->channel_head->ch);
2289
2290   /* Get buffer space */
2291   buffer = GMT_get_connections_buffer (t);
2292   if (0 == buffer)
2293   {
2294     return;
2295   }
2296
2297   /* Count and remember choked channels */
2298   choked_n = 0;
2299   for (iter = t->channel_head; NULL != iter; iter = iter->next)
2300   {
2301     if (GNUNET_NO == get_channel_allowed (iter))
2302     {
2303       choked[choked_n++] = iter->ch;
2304     }
2305   }
2306
2307   /* Unchoke random channels */
2308   while (0 < buffer && 0 < choked_n)
2309   {
2310     unsigned int r = GNUNET_CRYPTO_random_u32 (GNUNET_CRYPTO_QUALITY_WEAK,
2311                                                choked_n);
2312     GMCH_allow_client (choked[r], GMCH_is_origin (choked[r], GNUNET_YES));
2313     choked_n--;
2314     buffer--;
2315     choked[r] = choked[choked_n];
2316   }
2317 }
2318
2319
2320 /**
2321  * Send ACK on one or more connections due to buffer space to the client.
2322  *
2323  * Iterates all connections of the tunnel and sends ACKs appropriately.
2324  *
2325  * @param t Tunnel.
2326  */
2327 void
2328 GMT_send_connection_acks (struct MeshTunnel3 *t)
2329 {
2330   struct MeshTConnection *iter;
2331   uint32_t allowed;
2332   uint32_t to_allow;
2333   uint32_t allow_per_connection;
2334   unsigned int cs;
2335   unsigned int buffer;
2336
2337   LOG (GNUNET_ERROR_TYPE_DEBUG, "Tunnel send connection ACKs on %s\n",
2338        GMT_2s (t));
2339
2340   if (NULL == t)
2341   {
2342     GNUNET_break (0);
2343     return;
2344   }
2345
2346   buffer = GMT_get_channels_buffer (t);
2347   LOG (GNUNET_ERROR_TYPE_DEBUG, "  buffer %u\n", buffer);
2348
2349   /* Count connections, how many messages are already allowed */
2350   cs = GMT_count_connections (t);
2351   for (allowed = 0, iter = t->connection_head; NULL != iter; iter = iter->next)
2352   {
2353     allowed += get_connection_allowed (iter);
2354   }
2355   LOG (GNUNET_ERROR_TYPE_DEBUG, "  allowed %u\n", allowed);
2356
2357   /* Make sure there is no overflow */
2358   if (allowed > buffer)
2359   {
2360     return;
2361   }
2362
2363   /* Authorize connections to send more data */
2364   to_allow = buffer; /* - allowed; */
2365
2366   for (iter = t->connection_head; NULL != iter && to_allow > 0; iter = iter->next)
2367   {
2368     allow_per_connection = to_allow/cs;
2369     to_allow -= allow_per_connection;
2370     cs--;
2371     if (get_connection_allowed (iter) > 64 / 3)
2372     {
2373       continue;
2374     }
2375     GMC_allow (iter->c, allow_per_connection,
2376                GMC_is_origin (iter->c, GNUNET_NO));
2377   }
2378
2379   GNUNET_break (to_allow == 0);
2380 }
2381
2382
2383 /**
2384  * Cancel a previously sent message while it's in the queue.
2385  *
2386  * ONLY can be called before the continuation given to the send function
2387  * is called. Once the continuation is called, the message is no longer in the
2388  * queue.
2389  *
2390  * @param q Handle to the queue.
2391  */
2392 void
2393 GMT_cancel (struct MeshTunnel3Queue *q)
2394 {
2395   if (NULL != q->cq)
2396   {
2397     GMC_cancel (q->cq);
2398     /* message_sent() will be called and free q */
2399   }
2400   else if (NULL != q->tqd)
2401   {
2402     unqueue_data (q->tqd);
2403     q->tqd = NULL;
2404     if (NULL != q->cont)
2405       q->cont (q->cont_cls, NULL, q, 0, 0);
2406     GNUNET_free (q);
2407   }
2408   else
2409   {
2410     GNUNET_break (0);
2411   }
2412 }
2413
2414
2415 /**
2416  * Sends an already built message on a tunnel, encrypting it and
2417  * choosing the best connection.
2418  *
2419  * @param message Message to send. Function modifies it.
2420  * @param t Tunnel on which this message is transmitted.
2421  * @param force Force the tunnel to take the message (buffer overfill).
2422  * @param cont Continuation to call once message is really sent.
2423  * @param cont_cls Closure for @c cont.
2424  *
2425  * @return Handle to cancel message. NULL if @c cont is NULL.
2426  */
2427 struct MeshTunnel3Queue *
2428 GMT_send_prebuilt_message (const struct GNUNET_MessageHeader *message,
2429                            struct MeshTunnel3 *t, int force,
2430                            GMT_sent cont, void *cont_cls)
2431 {
2432   return send_prebuilt_message (message, t, force, cont, cont_cls, NULL);
2433 }
2434
2435
2436 /**
2437  * Is the tunnel directed towards the local peer?
2438  *
2439  * @param t Tunnel.
2440  *
2441  * @return #GNUNET_YES if it is loopback.
2442  */
2443 int
2444 GMT_is_loopback (const struct MeshTunnel3 *t)
2445 {
2446   return (myid == GMP_get_short_id (t->peer));
2447 }
2448
2449
2450 /**
2451  * Is the tunnel this path already?
2452  *
2453  * @param t Tunnel.
2454  * @param p Path.
2455  *
2456  * @return #GNUNET_YES a connection uses this path.
2457  */
2458 int
2459 GMT_is_path_used (const struct MeshTunnel3 *t, const struct MeshPeerPath *p)
2460 {
2461   struct MeshTConnection *iter;
2462
2463   for (iter = t->connection_head; NULL != iter; iter = iter->next)
2464     if (GMC_get_path (iter->c) == p)
2465       return GNUNET_YES;
2466
2467   return GNUNET_NO;
2468 }
2469
2470
2471 /**
2472  * Get a cost of a path for a tunnel considering existing connections.
2473  *
2474  * @param t Tunnel.
2475  * @param path Candidate path.
2476  *
2477  * @return Cost of the path (path length + number of overlapping nodes)
2478  */
2479 unsigned int
2480 GMT_get_path_cost (const struct MeshTunnel3 *t,
2481                    const struct MeshPeerPath *path)
2482 {
2483   struct MeshTConnection *iter;
2484   const struct MeshPeerPath *aux;
2485   unsigned int overlap;
2486   unsigned int i;
2487   unsigned int j;
2488
2489   if (NULL == path)
2490     return 0;
2491
2492   overlap = 0;
2493   GNUNET_assert (NULL != t);
2494
2495   for (i = 0; i < path->length; i++)
2496   {
2497     for (iter = t->connection_head; NULL != iter; iter = iter->next)
2498     {
2499       aux = GMC_get_path (iter->c);
2500       if (NULL == aux)
2501         continue;
2502
2503       for (j = 0; j < aux->length; j++)
2504       {
2505         if (path->peers[i] == aux->peers[j])
2506         {
2507           overlap++;
2508           break;
2509         }
2510       }
2511     }
2512   }
2513   return (path->length + overlap) * (path->score * -1);
2514 }
2515
2516
2517 /**
2518  * Get the static string for the peer this tunnel is directed.
2519  *
2520  * @param t Tunnel.
2521  *
2522  * @return Static string the destination peer's ID.
2523  */
2524 const char *
2525 GMT_2s (const struct MeshTunnel3 *t)
2526 {
2527   if (NULL == t)
2528     return "(NULL)";
2529
2530   return GMP_2s (t->peer);
2531 }
2532
2533
2534 /**
2535  * Log all possible info about the tunnel state.
2536  *
2537  * @param t Tunnel to debug.
2538  */
2539 void
2540 GMT_debug (const struct MeshTunnel3 *t)
2541 {
2542   struct MeshTChannel *iterch;
2543   struct MeshTConnection *iterc;
2544
2545   LOG (GNUNET_ERROR_TYPE_DEBUG, "DEBUG TUNNEL TOWARDS %s\n", GMT_2s (t));
2546   LOG (GNUNET_ERROR_TYPE_DEBUG, "  cstate %s, estate %s\n",
2547        cstate2s (t->cstate), estate2s (t->estate));
2548   LOG (GNUNET_ERROR_TYPE_DEBUG, "  kx_ctx %p, rekey_task %u\n",
2549        t->kx_ctx, t->rekey_task);
2550   LOG (GNUNET_ERROR_TYPE_DEBUG, "  tq_head %p, tq_tail %p\n",
2551        t->tq_head, t->tq_tail);
2552   LOG (GNUNET_ERROR_TYPE_DEBUG, "  destroy %u\n", t->destroy);
2553
2554   LOG (GNUNET_ERROR_TYPE_DEBUG, "  channels:\n");
2555   for (iterch = t->channel_head; NULL != iterch; iterch = iterch->next)
2556   {
2557     LOG (GNUNET_ERROR_TYPE_DEBUG, "  - %s\n", GMCH_2s (iterch->ch));
2558   }
2559
2560   LOG (GNUNET_ERROR_TYPE_DEBUG, "  connections:\n");
2561   for (iterc = t->connection_head; NULL != iterc; iterc = iterc->next)
2562   {
2563     LOG (GNUNET_ERROR_TYPE_DEBUG, "  - %s [%u] buf: %u/%u (qn %u/%u)\n",
2564          GMC_2s (iterc->c), GMC_get_state (iterc->c),
2565          GMC_get_buffer (iterc->c, GNUNET_YES),
2566          GMC_get_buffer (iterc->c, GNUNET_NO),
2567          GMC_get_qn (iterc->c, GNUNET_YES),
2568          GMC_get_qn (iterc->c, GNUNET_NO));
2569   }
2570
2571   LOG (GNUNET_ERROR_TYPE_DEBUG, "DEBUG TUNNEL END\n");
2572 }