- Remove deprecated code, coverity 10236
[oweals/gnunet.git] / src / mesh / mesh_api.c
1 /*
2      This file is part of GNUnet.
3      (C) 2011 Christian Grothoff (and other contributing authors)
4      GNUnet is free software; you can redistribute it and/or modify
5      it under the terms of the GNU General Public License as published
6      by the Free Software Foundation; either version 3, or (at your
7      option) any later version.
8      GNUnet is distributed in the hope that it will be useful, but
9      WITHOUT ANY WARRANTY; without even the implied warranty of
10      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
11      General Public License for more details.
12      You should have received a copy of the GNU General Public License
13      along with GNUnet; see the file COPYING.  If not, write to the
14      Free Software Foundation, Inc., 59 Temple Place - Suite 330,
15      Boston, MA 02111-1307, USA.
16 */
17
18 /**
19  * @file mesh/mesh_api.c
20  * @brief mesh api: client implementation of mesh service
21  * @author Bartlomiej Polot
22  *
23  * STRUCTURE:
24  * - DATA STRUCTURES
25  * - DECLARATIONS
26  * - AUXILIARY FUNCTIONS
27  * - RECEIVE HANDLERS
28  * - SEND FUNCTIONS
29  * - API CALL DEFINITIONS
30  *
31  * TODO: add regex to reconnect
32  */
33 #include "platform.h"
34 #include "gnunet_common.h"
35 #include "gnunet_client_lib.h"
36 #include "gnunet_util_lib.h"
37 #include "gnunet_peer_lib.h"
38 #include "gnunet_mesh_service.h"
39 #include "mesh.h"
40 #include "mesh_protocol.h"
41
42 #define LOG(kind,...) GNUNET_log_from (kind, "mesh-api",__VA_ARGS__)
43
44 #define DEBUG_ACK GNUNET_YES
45
46 /******************************************************************************/
47 /************************      DATA STRUCTURES     ****************************/
48 /******************************************************************************/
49
50 /**
51  * Transmission queue to the service
52  */
53 struct GNUNET_MESH_TransmitHandle
54 {
55
56     /**
57      * Double Linked list
58      */
59   struct GNUNET_MESH_TransmitHandle *next;
60
61     /**
62      * Double Linked list
63      */
64   struct GNUNET_MESH_TransmitHandle *prev;
65
66     /**
67      * Tunnel this message is sent on / for (may be NULL for control messages).
68      */
69   struct GNUNET_MESH_Tunnel *tunnel;
70
71     /**
72      * Callback to obtain the message to transmit, or NULL if we
73      * got the message in 'data'.  Notice that messages built
74      * by 'notify' need to be encapsulated with information about
75      * the 'target'.
76      */
77   GNUNET_CONNECTION_TransmitReadyNotify notify;
78
79     /**
80      * Closure for 'notify'
81      */
82   void *notify_cls;
83
84     /**
85      * How long is this message valid.  Once the timeout has been
86      * reached, the message must no longer be sent.  If this
87      * is a message with a 'notify' callback set, the 'notify'
88      * function should be called with 'buf' NULL and size 0.
89      */
90   struct GNUNET_TIME_Absolute timeout;
91
92     /**
93      * Task triggering a timeout, can be NO_TASK if the timeout is FOREVER.
94      */
95   GNUNET_SCHEDULER_TaskIdentifier timeout_task;
96
97     /**
98      * Target of the message, 0 for multicast.  This field
99      * is only valid if 'notify' is non-NULL.
100      */
101   GNUNET_PEER_Id target;
102
103     /**
104      * Size of 'data' -- or the desired size of 'notify' if 'data' is NULL.
105      */
106   size_t size;
107 };
108
109
110 /**
111  * Opaque handle to the service.
112  */
113 struct GNUNET_MESH_Handle
114 {
115
116     /**
117      * Handle to the server connection, to send messages later
118      */
119   struct GNUNET_CLIENT_Connection *client;
120
121     /**
122      * Set of handlers used for processing incoming messages in the tunnels
123      */
124   const struct GNUNET_MESH_MessageHandler *message_handlers;
125
126     /**
127      * Set of applications that should be claimed to be offered at this node.
128      * Note that this is just informative, the appropiate handlers must be
129      * registered independently and the mapping is up to the developer of the
130      * client application.
131      */
132   const GNUNET_MESH_ApplicationType *applications;
133
134     /**
135      * Double linked list of the tunnels this client is connected to, head.
136      */
137   struct GNUNET_MESH_Tunnel *tunnels_head;
138
139     /**
140      * Double linked list of the tunnels this client is connected to, tail.
141      */
142   struct GNUNET_MESH_Tunnel *tunnels_tail;
143
144     /**
145      * Callback for inbound tunnel creation
146      */
147   GNUNET_MESH_InboundTunnelNotificationHandler *new_tunnel;
148
149     /**
150      * Callback for inbound tunnel disconnection
151      */
152   GNUNET_MESH_TunnelEndHandler *cleaner;
153
154     /**
155      * Handle to cancel pending transmissions in case of disconnection
156      */
157   struct GNUNET_CLIENT_TransmitHandle *th;
158
159     /**
160      * Closure for all the handlers given by the client
161      */
162   void *cls;
163
164     /**
165      * Messages to send to the service, head.
166      */
167   struct GNUNET_MESH_TransmitHandle *th_head;
168
169     /**
170      * Messages to send to the service, tail.
171      */
172   struct GNUNET_MESH_TransmitHandle *th_tail;
173
174     /**
175      * tid of the next tunnel to create (to avoid reusing IDs often)
176      */
177   MESH_TunnelNumber next_tid;
178
179     /**
180      * Number of handlers in the handlers array.
181      */
182   unsigned int n_handlers;
183
184     /**
185      * Number of applications in the applications array.
186      */
187   unsigned int n_applications;
188
189     /**
190      * Have we started the task to receive messages from the service
191      * yet? We do this after we send the 'MESH_LOCAL_CONNECT' message.
192      */
193   int in_receive;
194
195   /**
196    * Configuration given by the client, in case of reconnection
197    */
198   const struct GNUNET_CONFIGURATION_Handle *cfg;
199
200   /**
201    * Time to the next reconnect in case one reconnect fails
202    */
203   struct GNUNET_TIME_Relative reconnect_time;
204   
205   /**
206    * Task for trying to reconnect.
207    */
208   GNUNET_SCHEDULER_TaskIdentifier reconnect_task;
209
210 #if DEBUG_ACK
211   unsigned int acks_sent;
212   unsigned int acks_recv;
213 #endif
214 };
215
216
217 /**
218  * Description of a peer
219  */
220 struct GNUNET_MESH_Peer
221 {
222     /**
223      * ID of the peer in short form
224      */
225   GNUNET_PEER_Id id;
226
227   /**
228    * Tunnel this peer belongs to
229    */
230   struct GNUNET_MESH_Tunnel *t;
231
232   /**
233    * Flag indicating whether service has informed about its connection
234    */
235   int connected;
236
237 };
238
239
240 /**
241  * Opaque handle to a tunnel.
242  */
243 struct GNUNET_MESH_Tunnel
244 {
245
246     /**
247      * DLL next
248      */
249   struct GNUNET_MESH_Tunnel *next;
250
251     /**
252      * DLL prev
253      */
254   struct GNUNET_MESH_Tunnel *prev;
255
256     /**
257      * Callback to execute when peers connect to the tunnel
258      */
259   GNUNET_MESH_PeerConnectHandler connect_handler;
260
261     /**
262      * Callback to execute when peers disconnect from the tunnel
263      */
264   GNUNET_MESH_PeerDisconnectHandler disconnect_handler;
265
266     /**
267      * Closure for the connect/disconnect handlers
268      */
269   void *cls;
270
271     /**
272      * Handle to the mesh this tunnel belongs to
273      */
274   struct GNUNET_MESH_Handle *mesh;
275
276     /**
277      * Local ID of the tunnel
278      */
279   MESH_TunnelNumber tid;
280
281     /**
282      * Owner of the tunnel. 0 if the tunnel is the local client.
283      */
284   GNUNET_PEER_Id owner;
285
286     /**
287      * All peers added to the tunnel
288      */
289   struct GNUNET_MESH_Peer **peers;
290
291   /**
292    * List of application types that have been requested for this tunnel
293    */
294   GNUNET_MESH_ApplicationType *apps;
295
296   /**
297    * Any data the caller wants to put in here
298    */
299   void *ctx;
300
301   /**
302      * Number of peers added to the tunnel
303      */
304   unsigned int npeers;
305
306     /**
307      * Size of packet queued in this tunnel
308      */
309   unsigned int packet_size;
310
311     /**
312      * Number of applications requested this tunnel
313      */
314   unsigned int napps;
315
316     /**
317      * Is the tunnel throttled to the slowest peer?
318      */
319   int speed_min;
320
321     /**
322      * Is the tunnel allowed to buffer?
323      */
324   int buffering;
325
326     /**
327      * Next packet ID to send.
328      */
329   uint32_t next_send_pid;
330
331     /**
332      * Maximum allowed PID to send (ACK recevied).
333      */
334   uint32_t max_send_pid;
335
336     /**
337      * Last pid received from the service.
338      */
339   uint32_t last_recv_pid;
340
341   /**
342    * Which ACK value have we last sent to the service?
343    */
344   uint32_t max_recv_pid;
345 };
346
347
348 /******************************************************************************/
349 /***********************         DECLARATIONS         *************************/
350 /******************************************************************************/
351
352 /**
353  * Function called to send a message to the service.
354  * "buf" will be NULL and "size" zero if the socket was closed for writing in
355  * the meantime.
356  *
357  * @param cls closure, the mesh handle
358  * @param size number of bytes available in buf
359  * @param buf where the callee should write the connect message
360  * @return number of bytes written to buf
361  */
362 static size_t
363 send_callback (void *cls, size_t size, void *buf);
364
365
366 /******************************************************************************/
367 /***********************     AUXILIARY FUNCTIONS      *************************/
368 /******************************************************************************/
369
370 /**
371  * Check if transmission is a payload packet.
372  *
373  * @param th Transmission handle.
374  *
375  * @return GNUNET_YES if it is a payload packet,
376  *         GNUNET_NO if it is a mesh management packet.
377  */
378 static int
379 th_is_payload (struct GNUNET_MESH_TransmitHandle *th)
380 {
381   return (th->notify != NULL) ? GNUNET_YES : GNUNET_NO;
382 }
383
384
385 /**
386  * Check whether there is any message ready in the queue and find the size.
387  * 
388  * @param h Mesh handle.
389  * 
390  * @return The size of the first ready message in the queue,
391  *         0 if there is none.
392  */
393 static size_t
394 message_ready_size (struct GNUNET_MESH_Handle *h)
395 {
396   struct GNUNET_MESH_TransmitHandle *th;
397   struct GNUNET_MESH_Tunnel *t;
398
399   for (th = h->th_head; NULL != th; th = th->next)
400   {
401     t = th->tunnel;
402     if (GNUNET_NO == th_is_payload (th))
403     {
404       LOG (GNUNET_ERROR_TYPE_DEBUG, "  message internal\n");
405       return th->size;
406     }
407     if (GNUNET_NO == GMC_is_pid_bigger(t->next_send_pid, t->max_send_pid))
408     {
409       LOG (GNUNET_ERROR_TYPE_DEBUG, "  message payload ok (%u <= %u)\n",
410            t->next_send_pid, t->max_send_pid);
411       return th->size;
412     }
413   }
414   return 0;
415 }
416
417
418 /**
419  * Get the tunnel handler for the tunnel specified by id from the given handle
420  * @param h Mesh handle
421  * @param tid ID of the wanted tunnel
422  * @return handle to the required tunnel or NULL if not found
423  */
424 static struct GNUNET_MESH_Tunnel *
425 retrieve_tunnel (struct GNUNET_MESH_Handle *h, MESH_TunnelNumber tid)
426 {
427   struct GNUNET_MESH_Tunnel *t;
428
429   t = h->tunnels_head;
430   while (t != NULL)
431   {
432     if (t->tid == tid)
433       return t;
434     t = t->next;
435   }
436   return NULL;
437 }
438
439
440 /**
441  * Create a new tunnel and insert it in the tunnel list of the mesh handle
442  * @param h Mesh handle
443  * @param tid desired tid of the tunnel, 0 to assign one automatically
444  * @return handle to the created tunnel
445  */
446 static struct GNUNET_MESH_Tunnel *
447 create_tunnel (struct GNUNET_MESH_Handle *h, MESH_TunnelNumber tid)
448 {
449   struct GNUNET_MESH_Tunnel *t;
450
451   t = GNUNET_malloc (sizeof (struct GNUNET_MESH_Tunnel));
452   GNUNET_CONTAINER_DLL_insert (h->tunnels_head, h->tunnels_tail, t);
453   t->mesh = h;
454   if (0 == tid)
455   {
456     t->tid = h->next_tid;
457     while (NULL != retrieve_tunnel (h, h->next_tid))
458     {
459       h->next_tid++;
460       h->next_tid &= ~GNUNET_MESH_LOCAL_TUNNEL_ID_SERV;
461       h->next_tid |= GNUNET_MESH_LOCAL_TUNNEL_ID_CLI;
462     }
463   }
464   else
465   {
466     t->tid = tid;
467   }
468   t->max_send_pid = INITIAL_WINDOW_SIZE - 1;
469   t->last_recv_pid = (uint32_t) -1;
470   return t;
471 }
472
473
474 /**
475  * Destroy the specified tunnel.
476  * - Destroys all peers, calling the disconnect callback on each if needed
477  * - Cancels all outgoing traffic for that tunnel, calling respective notifys
478  * - Calls cleaner if tunnel was inbound
479  * - Frees all memory used
480  *
481  * @param t Pointer to the tunnel.
482  * @param call_cleaner Whether to call the cleaner handler.
483  *
484  * @return Handle to the required tunnel or NULL if not found.
485  */
486 static void
487 destroy_tunnel (struct GNUNET_MESH_Tunnel *t, int call_cleaner)
488 {
489   struct GNUNET_MESH_Handle *h;
490   struct GNUNET_PeerIdentity pi;
491   struct GNUNET_MESH_TransmitHandle *th;
492   struct GNUNET_MESH_TransmitHandle *next;
493   unsigned int i;
494
495   LOG (GNUNET_ERROR_TYPE_DEBUG, "destroy_tunnel %X\n", t->tid);
496
497   if (NULL == t)
498   {
499     GNUNET_break (0);
500     return;
501   }
502   h = t->mesh;
503
504   /* disconnect all peers */
505   GNUNET_CONTAINER_DLL_remove (h->tunnels_head, h->tunnels_tail, t);
506   for (i = 0; i < t->npeers; i++)
507   {
508     if ( (NULL != t->disconnect_handler) && t->peers[i]->connected)
509     {
510       GNUNET_PEER_resolve (t->peers[i]->id, &pi);
511       t->disconnect_handler (t->cls, &pi);
512     }
513     GNUNET_PEER_change_rc (t->peers[i]->id, -1);
514     GNUNET_free (t->peers[i]);
515   }
516
517   /* signal tunnel destruction */
518   if ( (NULL != h->cleaner) && (0 != t->owner) && (GNUNET_YES == call_cleaner) )
519     h->cleaner (h->cls, t, t->ctx);
520
521   /* check that clients did not leave messages behind in the queue */
522   for (th = h->th_head; NULL != th; th = next)
523   {
524     next = th->next;
525     if (th->tunnel != t)
526       continue;
527     /* Clients should have aborted their requests already.
528      * Management traffic should be ok, as clients can't cancel that */
529     GNUNET_break (GNUNET_NO == th_is_payload(th));
530     GNUNET_CONTAINER_DLL_remove (h->th_head, h->th_tail, th);
531
532     /* clean up request */
533     if (GNUNET_SCHEDULER_NO_TASK != th->timeout_task)
534       GNUNET_SCHEDULER_cancel (th->timeout_task);
535     GNUNET_free (th);    
536   }
537
538   /* if there are no more pending requests with mesh service, cancel active request */
539   /* Note: this should be unnecessary... */
540   if ((0 == message_ready_size (h)) && (NULL != h->th))
541   {
542     GNUNET_CLIENT_notify_transmit_ready_cancel (h->th);
543     h->th = NULL;
544   }
545
546
547   if (t->npeers > 0)
548     GNUNET_free (t->peers);
549   if (0 != t->owner)
550     GNUNET_PEER_change_rc (t->owner, -1);
551   if (0 != t->napps && t->apps)
552     GNUNET_free (t->apps);
553   GNUNET_free (t);
554   return;
555 }
556
557
558 /**
559  * Get the peer descriptor for the peer with id from the given tunnel
560  * @param t Tunnel handle
561  * @param id Short form ID of the wanted peer
562  * @return handle to the requested peer or NULL if not found
563  */
564 static struct GNUNET_MESH_Peer *
565 retrieve_peer (struct GNUNET_MESH_Tunnel *t, GNUNET_PEER_Id id)
566 {
567   unsigned int i;
568
569   for (i = 0; i < t->npeers; i++)
570     if (t->peers[i]->id == id)
571       return t->peers[i];
572   return NULL;
573 }
574
575
576 /**
577  * Add a peer into a tunnel
578  * @param t Tunnel handle
579  * @param pi Full ID of the new peer
580  * @return handle to the newly created peer
581  */
582 static struct GNUNET_MESH_Peer *
583 add_peer_to_tunnel (struct GNUNET_MESH_Tunnel *t,
584                     const struct GNUNET_PeerIdentity *pi)
585 {
586   struct GNUNET_MESH_Peer *p;
587   GNUNET_PEER_Id id;
588
589   if (0 != t->owner)
590   {
591     GNUNET_break (0);
592     return NULL;
593   }
594   id = GNUNET_PEER_intern (pi);
595
596   p = GNUNET_malloc (sizeof (struct GNUNET_MESH_Peer));
597   p->id = id;
598   p->t = t;
599   GNUNET_array_append (t->peers, t->npeers, p);
600   return p;
601 }
602
603
604 /**
605  * Remove a peer from a tunnel
606  * @param p Peer handle
607  */
608 static void
609 remove_peer_from_tunnel (struct GNUNET_MESH_Peer *p)
610 {
611   unsigned int i;
612
613   for (i = 0; i < p->t->npeers; i++)
614   {
615     if (p->t->peers[i] == p)
616       break;
617   }
618   if (i == p->t->npeers)
619   {
620     GNUNET_break (0);
621     return;
622   }
623   p->t->peers[i] = p->t->peers[p->t->npeers - 1];
624   GNUNET_array_grow (p->t->peers, p->t->npeers, p->t->npeers - 1);
625 }
626
627
628 /**
629  * Notify client that the transmission has timed out
630  * 
631  * @param cls closure
632  * @param tc task context
633  */
634 static void
635 timeout_transmission (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
636 {
637   struct GNUNET_MESH_TransmitHandle *th = cls;
638   struct GNUNET_MESH_Handle *mesh;
639
640   mesh = th->tunnel->mesh;
641   GNUNET_CONTAINER_DLL_remove (mesh->th_head, mesh->th_tail, th);
642   th->tunnel->packet_size = 0;
643   if (GNUNET_YES == th_is_payload (th))
644     th->notify (th->notify_cls, 0, NULL);
645   GNUNET_free (th);
646   if ((0 == message_ready_size (mesh)) && (NULL != mesh->th))
647   {
648     /* nothing ready to transmit, no point in asking for transmission */
649     GNUNET_CLIENT_notify_transmit_ready_cancel (mesh->th);
650     mesh->th = NULL;
651   }
652 }
653
654
655 /**
656  * Add a transmit handle to the transmission queue and set the
657  * timeout if needed.
658  *
659  * @param h mesh handle with the queue head and tail
660  * @param th handle to the packet to be transmitted
661  */
662 static void
663 add_to_queue (struct GNUNET_MESH_Handle *h,
664               struct GNUNET_MESH_TransmitHandle *th)
665 {
666   GNUNET_CONTAINER_DLL_insert_tail (h->th_head, h->th_tail, th);
667   if (GNUNET_TIME_UNIT_FOREVER_ABS.abs_value == th->timeout.abs_value)
668     return;
669   th->timeout_task =
670       GNUNET_SCHEDULER_add_delayed (GNUNET_TIME_absolute_get_remaining
671                                     (th->timeout), &timeout_transmission, th);
672 }
673
674
675 /**
676  * Auxiliary function to send an already constructed packet to the service.
677  * Takes care of creating a new queue element, copying the message and
678  * calling the tmt_rdy function if necessary.
679  *
680  * @param h mesh handle
681  * @param msg message to transmit
682  * @param tunnel tunnel this send is related to (NULL if N/A)
683  */
684 static void
685 send_packet (struct GNUNET_MESH_Handle *h,
686              const struct GNUNET_MessageHeader *msg,
687              struct GNUNET_MESH_Tunnel *tunnel);
688
689
690 /**
691  * Send an ack on the tunnel to confirm the processing of a message.
692  * 
693  * @param h Mesh handle.
694  * @param t Tunnel on which to send the ACK.
695  */
696 static void
697 send_ack (struct GNUNET_MESH_Handle *h, struct GNUNET_MESH_Tunnel *t)
698 {
699   struct GNUNET_MESH_LocalAck msg;
700   uint32_t delta;
701
702   delta = t->max_recv_pid - t->last_recv_pid;
703   if (delta > ACK_THRESHOLD)
704   {
705     LOG (GNUNET_ERROR_TYPE_DEBUG,
706          "Not sending ACK on tunnel %X: ACK: %u, PID: %u, buffer %u\n",
707          t->tid, t->max_recv_pid, t->last_recv_pid, delta);
708     return;
709   }
710   t->max_recv_pid = t->last_recv_pid + INITIAL_WINDOW_SIZE;
711   LOG (GNUNET_ERROR_TYPE_DEBUG,
712        "Sending ACK on tunnel %X: %u\n",
713        t->tid, t->max_recv_pid);
714   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_ACK);
715   msg.header.size = htons (sizeof (msg));
716   msg.tunnel_id = htonl (t->tid);
717   msg.max_pid = htonl (t->max_recv_pid);
718
719 #if DEBUG_ACK
720   t->mesh->acks_sent++;
721 #endif
722
723   send_packet (h, &msg.header, t);
724   return;
725 }
726
727
728
729 /**
730  * Reconnect callback: tries to reconnect again after a failer previous
731  * reconnecttion
732  * @param cls closure (mesh handle)
733  * @param tc task context
734  */
735 static void
736 reconnect_cbk (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc);
737
738
739 /**
740  * Send a connect packet to the service with the applications and types
741  * requested by the user.
742  *
743  * @param h The mesh handle.
744  *
745  */
746 static void
747 send_connect (struct GNUNET_MESH_Handle *h)
748 {
749   size_t size;
750
751   size = sizeof (struct GNUNET_MESH_ClientConnect);
752   size += h->n_applications * sizeof (GNUNET_MESH_ApplicationType);
753   size += h->n_handlers * sizeof (uint16_t);
754   {
755     char buf[size] GNUNET_ALIGN;
756     struct GNUNET_MESH_ClientConnect *msg;
757     GNUNET_MESH_ApplicationType *apps;
758     uint16_t napps;
759     uint16_t *types;
760     uint16_t ntypes;
761
762     /* build connection packet */
763     msg = (struct GNUNET_MESH_ClientConnect *) buf;
764     msg->header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_CONNECT);
765     msg->header.size = htons (size);
766     apps = (GNUNET_MESH_ApplicationType *) &msg[1];
767     for (napps = 0; napps < h->n_applications; napps++)
768     {
769       apps[napps] = htonl (h->applications[napps]);
770       LOG (GNUNET_ERROR_TYPE_DEBUG, " app %u\n",
771            h->applications[napps]);
772     }
773     types = (uint16_t *) & apps[napps];
774     for (ntypes = 0; ntypes < h->n_handlers; ntypes++)
775     {
776       types[ntypes] = htons (h->message_handlers[ntypes].type);
777       LOG (GNUNET_ERROR_TYPE_DEBUG, " type %u\n",
778            h->message_handlers[ntypes].type);
779     }
780     msg->applications = htons (napps);
781     msg->types = htons (ntypes);
782     LOG (GNUNET_ERROR_TYPE_DEBUG,
783          "Sending %lu bytes long message %d types and %d apps\n",
784          ntohs (msg->header.size), ntypes, napps);
785     send_packet (h, &msg->header, NULL);
786   }
787 }
788
789
790 /**
791  * Reconnect to the service, retransmit all infomation to try to restore the
792  * original state.
793  *
794  * @param h handle to the mesh
795  *
796  * @return GNUNET_YES in case of sucess, GNUNET_NO otherwise (service down...)
797  */
798 static int
799 do_reconnect (struct GNUNET_MESH_Handle *h)
800 {
801   struct GNUNET_MESH_Tunnel *t;
802   unsigned int i;
803
804   LOG (GNUNET_ERROR_TYPE_DEBUG, "*****************************\n");
805   LOG (GNUNET_ERROR_TYPE_DEBUG, "*******   RECONNECT   *******\n");
806   LOG (GNUNET_ERROR_TYPE_DEBUG, "*****************************\n");
807   LOG (GNUNET_ERROR_TYPE_DEBUG, "******** on %p *******\n", h);
808   LOG (GNUNET_ERROR_TYPE_DEBUG, "*****************************\n");
809
810   /* disconnect */
811   if (NULL != h->th)
812   {
813     GNUNET_CLIENT_notify_transmit_ready_cancel (h->th);
814     h->th = NULL;
815   }
816   if (NULL != h->client)
817   {
818     GNUNET_CLIENT_disconnect (h->client);
819   }
820
821   /* connect again */
822   h->client = GNUNET_CLIENT_connect ("mesh", h->cfg);
823   if (h->client == NULL)
824   {
825     h->reconnect_task = GNUNET_SCHEDULER_add_delayed (h->reconnect_time,
826                                                       &reconnect_cbk, h);
827     h->reconnect_time =
828         GNUNET_TIME_relative_min (GNUNET_TIME_UNIT_SECONDS,
829                                   GNUNET_TIME_relative_multiply
830                                   (h->reconnect_time, 2));
831     LOG (GNUNET_ERROR_TYPE_DEBUG, "  Next retry in %sms\n",
832          GNUNET_TIME_relative_to_string (h->reconnect_time));
833     GNUNET_break (0);
834     return GNUNET_NO;
835   }
836   else
837   {
838     h->reconnect_time = GNUNET_TIME_UNIT_MILLISECONDS;
839   }
840   send_connect (h);
841   /* Rebuild all tunnels */
842   for (t = h->tunnels_head; NULL != t; t = t->next)
843   {
844     struct GNUNET_MESH_TunnelMessage tmsg;
845     struct GNUNET_MESH_PeerControl pmsg;
846
847     if (t->tid >= GNUNET_MESH_LOCAL_TUNNEL_ID_SERV)
848     {
849       /* Tunnel was created by service (incoming tunnel) */
850       /* TODO: Notify service of missing tunnel, to request
851        * creator to recreate path (find a path to him via DHT?)
852        */
853       continue;
854     }
855     t->next_send_pid = 0;
856     t->max_send_pid = INITIAL_WINDOW_SIZE - 1;
857     t->last_recv_pid = (uint32_t) -1;
858     tmsg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_TUNNEL_CREATE);
859     tmsg.header.size = htons (sizeof (struct GNUNET_MESH_TunnelMessage));
860     tmsg.tunnel_id = htonl (t->tid);
861     send_packet (h, &tmsg.header, t);
862
863     pmsg.header.size = htons (sizeof (struct GNUNET_MESH_PeerControl));
864     pmsg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_PEER_ADD);
865     pmsg.tunnel_id = htonl (t->tid);
866
867     /* Reconnect all peers */
868     /* If the tunnel was "by type", dont connect individual peers */
869     for (i = 0; i < t->npeers && 0 == t->napps; i++)
870     {
871       GNUNET_PEER_resolve (t->peers[i]->id, &pmsg.peer);
872       if (NULL != t->disconnect_handler && t->peers[i]->connected)
873         t->disconnect_handler (t->cls, &pmsg.peer);
874       send_packet (t->mesh, &pmsg.header, t);
875     }
876     /* Reconnect all types, if any  */
877     for (i = 0; i < t->napps; i++)
878     {
879       struct GNUNET_MESH_ConnectPeerByType msg;
880
881       msg.header.size = htons (sizeof (struct GNUNET_MESH_ConnectPeerByType));
882       msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_PEER_ADD_BY_TYPE);
883       msg.tunnel_id = htonl (t->tid);
884       msg.type = htonl (t->apps[i]);
885       send_packet (t->mesh, &msg.header, t);
886     }
887     if (GNUNET_NO == t->buffering)
888       GNUNET_MESH_tunnel_buffer (t, GNUNET_NO);
889     if (GNUNET_YES == t->speed_min)
890       GNUNET_MESH_tunnel_speed_min (t);
891   }
892   return GNUNET_YES;
893 }
894
895 /**
896  * Reconnect callback: tries to reconnect again after a failer previous
897  * reconnecttion
898  * @param cls closure (mesh handle)
899  * @param tc task context
900  */
901 static void
902 reconnect_cbk (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
903 {
904   struct GNUNET_MESH_Handle *h = cls;
905
906   h->reconnect_task = GNUNET_SCHEDULER_NO_TASK;
907   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
908     return;
909   do_reconnect (h);
910 }
911
912
913 /**
914  * Reconnect to the service, retransmit all infomation to try to restore the
915  * original state.
916  *
917  * @param h handle to the mesh
918  *
919  * @return GNUNET_YES in case of sucess, GNUNET_NO otherwise (service down...)
920  */
921 static void
922 reconnect (struct GNUNET_MESH_Handle *h)
923 {
924   LOG (GNUNET_ERROR_TYPE_DEBUG, "Requested RECONNECT\n");
925   h->in_receive = GNUNET_NO;
926   if (GNUNET_SCHEDULER_NO_TASK == h->reconnect_task)
927     h->reconnect_task = GNUNET_SCHEDULER_add_delayed (h->reconnect_time,
928                                                       &reconnect_cbk, h);
929 }
930
931
932 /******************************************************************************/
933 /***********************      RECEIVE HANDLERS     ****************************/
934 /******************************************************************************/
935
936 /**
937  * Process the new tunnel notification and add it to the tunnels in the handle
938  *
939  * @param h     The mesh handle
940  * @param msg   A message with the details of the new incoming tunnel
941  */
942 static void
943 process_tunnel_created (struct GNUNET_MESH_Handle *h,
944                         const struct GNUNET_MESH_TunnelNotification *msg)
945 {
946   struct GNUNET_MESH_Tunnel *t;
947   MESH_TunnelNumber tid;
948
949   tid = ntohl (msg->tunnel_id);
950   LOG (GNUNET_ERROR_TYPE_DEBUG, "Creating incoming tunnel %X\n", tid);
951   if (tid < GNUNET_MESH_LOCAL_TUNNEL_ID_SERV)
952   {
953     GNUNET_break (0);
954     return;
955   }
956   if (NULL != h->new_tunnel)
957   {
958     struct GNUNET_ATS_Information atsi;
959
960     t = create_tunnel (h, tid);
961     t->owner = GNUNET_PEER_intern (&msg->peer);
962     t->npeers = 1;
963     t->peers = GNUNET_malloc (sizeof (struct GNUNET_MESH_Peer *));
964     t->peers[0] = GNUNET_malloc (sizeof (struct GNUNET_MESH_Peer));
965     t->peers[0]->t = t;
966     t->peers[0]->connected = 1;
967     t->peers[0]->id = t->owner;
968     GNUNET_PEER_change_rc (t->owner, 1);
969     t->mesh = h;
970     t->tid = tid;
971     atsi.type = 0;
972     atsi.value = 0;
973     LOG (GNUNET_ERROR_TYPE_DEBUG, "  created tunnel %p\n", t);
974     t->ctx = h->new_tunnel (h->cls, t, &msg->peer, &atsi);
975     LOG (GNUNET_ERROR_TYPE_DEBUG, "User notified\n");
976   }
977   else
978   {
979     struct GNUNET_MESH_TunnelMessage d_msg;
980
981     LOG (GNUNET_ERROR_TYPE_DEBUG, "No handler for incoming tunnels\n");
982
983     d_msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_TUNNEL_DESTROY);
984     d_msg.header.size = htons (sizeof (struct GNUNET_MESH_TunnelMessage));
985     d_msg.tunnel_id = msg->tunnel_id;
986
987     send_packet (h, &d_msg.header, NULL);
988   }
989   return;
990 }
991
992
993 /**
994  * Process the tunnel destroy notification and free associated resources
995  *
996  * @param h     The mesh handle
997  * @param msg   A message with the details of the tunnel being destroyed
998  */
999 static void
1000 process_tunnel_destroy (struct GNUNET_MESH_Handle *h,
1001                         const struct GNUNET_MESH_TunnelMessage *msg)
1002 {
1003   struct GNUNET_MESH_Tunnel *t;
1004   MESH_TunnelNumber tid;
1005
1006   tid = ntohl (msg->tunnel_id);
1007   t = retrieve_tunnel (h, tid);
1008
1009   if (NULL == t)
1010   {
1011     return;
1012   }
1013   if (0 == t->owner)
1014   {
1015     GNUNET_break (0);
1016   }
1017   LOG (GNUNET_ERROR_TYPE_DEBUG, "tunnel %X destroyed\n", t->tid);
1018   destroy_tunnel (t, GNUNET_YES);
1019   return;
1020 }
1021
1022
1023 /**
1024  * Process the new peer event and notify the upper level of it
1025  *
1026  * @param h     The mesh handle
1027  * @param msg   A message with the details of the peer event
1028  */
1029 static void
1030 process_peer_event (struct GNUNET_MESH_Handle *h,
1031                     const struct GNUNET_MESH_PeerControl *msg)
1032 {
1033   struct GNUNET_MESH_Tunnel *t;
1034   struct GNUNET_MESH_Peer *p;
1035   struct GNUNET_ATS_Information atsi;
1036   GNUNET_PEER_Id id;
1037   uint16_t size;
1038
1039   LOG (GNUNET_ERROR_TYPE_DEBUG, "processig peer event\n");
1040   size = ntohs (msg->header.size);
1041   if (size != sizeof (struct GNUNET_MESH_PeerControl))
1042   {
1043     GNUNET_break (0);
1044     return;
1045   }
1046   t = retrieve_tunnel (h, ntohl (msg->tunnel_id));
1047   if (NULL == t)
1048   {
1049     GNUNET_break (0);
1050     return;
1051   }
1052   id = GNUNET_PEER_search (&msg->peer);
1053   if ((p = retrieve_peer (t, id)) == NULL)
1054     p = add_peer_to_tunnel (t, &msg->peer);
1055   if (GNUNET_MESSAGE_TYPE_MESH_LOCAL_PEER_ADD == ntohs (msg->header.type))
1056   {
1057     LOG (GNUNET_ERROR_TYPE_DEBUG, "adding peer\n");
1058     if (NULL != t->connect_handler)
1059     {
1060       atsi.type = 0;
1061       atsi.value = 0;
1062       t->connect_handler (t->cls, &msg->peer, &atsi);
1063     }
1064     p->connected = 1;
1065   }
1066   else
1067   {
1068     LOG (GNUNET_ERROR_TYPE_DEBUG, "removing peer\n");
1069     if (NULL != t->disconnect_handler && p->connected)
1070     {
1071       t->disconnect_handler (t->cls, &msg->peer);
1072     }
1073     remove_peer_from_tunnel (p);
1074     GNUNET_free (p);
1075   }
1076   LOG (GNUNET_ERROR_TYPE_DEBUG, "processing peer event END\n");
1077 }
1078
1079
1080 /**
1081  * Process the incoming data packets
1082  *
1083  * @param h         The mesh handle
1084  * @param message   A message encapsulating the data
1085  * 
1086  * @return GNUNET_YES if everything went fine
1087  *         GNUNET_NO if client closed connection (h no longer valid)
1088  */
1089 static int
1090 process_incoming_data (struct GNUNET_MESH_Handle *h,
1091                        const struct GNUNET_MessageHeader *message)
1092 {
1093   const struct GNUNET_MessageHeader *payload;
1094   const struct GNUNET_MESH_MessageHandler *handler;
1095   const struct GNUNET_PeerIdentity *peer;
1096   struct GNUNET_MESH_Unicast *ucast;
1097   struct GNUNET_MESH_Multicast *mcast;
1098   struct GNUNET_MESH_ToOrigin *to_orig;
1099   struct GNUNET_MESH_Tunnel *t;
1100   unsigned int i;
1101   uint32_t pid;
1102   uint16_t type;
1103
1104   LOG (GNUNET_ERROR_TYPE_DEBUG, "Got a data message!\n");
1105   type = ntohs (message->type);
1106   switch (type)
1107   {
1108   case GNUNET_MESSAGE_TYPE_MESH_UNICAST:
1109     ucast = (struct GNUNET_MESH_Unicast *) message;
1110
1111     t = retrieve_tunnel (h, ntohl (ucast->tid));
1112     payload = (struct GNUNET_MessageHeader *) &ucast[1];
1113     peer = &ucast->oid;
1114     pid = ntohl (ucast->pid);
1115     LOG (GNUNET_ERROR_TYPE_DEBUG, "  ucast on tunnel %s [%X]\n",
1116          GNUNET_i2s (peer), ntohl (ucast->tid));
1117     break;
1118   case GNUNET_MESSAGE_TYPE_MESH_MULTICAST:
1119     mcast = (struct GNUNET_MESH_Multicast *) message;
1120     t = retrieve_tunnel (h, ntohl (mcast->tid));
1121     payload = (struct GNUNET_MessageHeader *) &mcast[1];
1122     peer = &mcast->oid;
1123     pid = ntohl (mcast->pid);
1124     LOG (GNUNET_ERROR_TYPE_DEBUG, "  mcast on tunnel %s [%X]\n",
1125          GNUNET_i2s (peer), ntohl (mcast->tid));
1126     break;
1127   case GNUNET_MESSAGE_TYPE_MESH_TO_ORIGIN:
1128     to_orig = (struct GNUNET_MESH_ToOrigin *) message;
1129     t = retrieve_tunnel (h, ntohl (to_orig->tid));
1130     payload = (struct GNUNET_MessageHeader *) &to_orig[1];
1131     peer = &to_orig->sender;
1132     pid = ntohl (to_orig->pid);
1133     LOG (GNUNET_ERROR_TYPE_DEBUG, "  torig on tunnel %s [%X]\n",
1134          GNUNET_i2s (peer), ntohl (to_orig->tid));
1135     break;
1136   default:
1137     GNUNET_break (0);
1138     return GNUNET_YES;
1139   }
1140   LOG (GNUNET_ERROR_TYPE_DEBUG, "  pid %u\n", pid);
1141   if (NULL == t)
1142   {
1143     /* Tunnel was ignored, probably service didn't get it yet */
1144     LOG (GNUNET_ERROR_TYPE_DEBUG, "  ignored!\n");
1145     return GNUNET_YES;
1146   }
1147     if (GNUNET_YES ==
1148         GMC_is_pid_bigger(pid, t->max_recv_pid))
1149   {
1150     GNUNET_break (0);
1151     LOG (GNUNET_ERROR_TYPE_WARNING, "  unauthorized message!\n");
1152     // FIXME fc what now? accept? reject?
1153     return GNUNET_YES;
1154   }
1155   t->last_recv_pid = pid;
1156   type = ntohs (payload->type);
1157   send_ack (h, t);
1158   for (i = 0; i < h->n_handlers; i++)
1159   {
1160     handler = &h->message_handlers[i];
1161     if (handler->type == type)
1162     {
1163       struct GNUNET_ATS_Information atsi;
1164
1165       atsi.type = 0;
1166       atsi.value = 0;
1167       if (GNUNET_OK !=
1168           handler->callback (h->cls, t, &t->ctx, peer, payload, &atsi))
1169       {
1170         LOG (GNUNET_ERROR_TYPE_DEBUG, "callback caused disconnection\n");
1171         GNUNET_MESH_disconnect (h);
1172         return GNUNET_NO;
1173       }
1174       else
1175       {
1176         LOG (GNUNET_ERROR_TYPE_DEBUG,
1177              "callback completed successfully\n");
1178       }
1179     }
1180   }
1181   return GNUNET_YES;
1182 }
1183
1184
1185 /**
1186  * Process a local ACK message, enabling the client to send
1187  * more data to the service.
1188  * 
1189  * @param h Mesh handle.
1190  * @param message Message itself.
1191  */
1192 static void
1193 process_ack (struct GNUNET_MESH_Handle *h,
1194              const struct GNUNET_MessageHeader *message)
1195 {
1196   struct GNUNET_MESH_LocalAck *msg;
1197   struct GNUNET_MESH_Tunnel *t;
1198   uint32_t ack;
1199
1200   LOG (GNUNET_ERROR_TYPE_DEBUG, "Got an ACK!\n");
1201   h->acks_recv++;
1202   msg = (struct GNUNET_MESH_LocalAck *) message;
1203
1204   t = retrieve_tunnel (h, ntohl (msg->tunnel_id));
1205
1206   if (NULL == t)
1207   {
1208     LOG (GNUNET_ERROR_TYPE_WARNING,
1209          "ACK on unknown tunnel %X\n",
1210          ntohl (msg->tunnel_id));
1211     return;
1212   }
1213   ack = ntohl (msg->max_pid);
1214   LOG (GNUNET_ERROR_TYPE_DEBUG, "  on tunnel %X, ack %u!\n", t->tid, ack);
1215   if (GNUNET_YES == GMC_is_pid_bigger(ack, t->max_send_pid))
1216     t->max_send_pid = ack;
1217   else
1218     return;
1219   if (NULL == h->th && 0 < t->packet_size)
1220   {
1221     LOG (GNUNET_ERROR_TYPE_DEBUG, "  tmt rdy was NULL, requesting!\n", t->tid, ack);
1222     h->th =
1223         GNUNET_CLIENT_notify_transmit_ready (h->client, t->packet_size,
1224                                              GNUNET_TIME_UNIT_FOREVER_REL,
1225                                              GNUNET_YES, &send_callback, h);
1226   }
1227 }
1228
1229
1230 /**
1231  * Function to process all messages received from the service
1232  *
1233  * @param cls closure
1234  * @param msg message received, NULL on timeout or fatal error
1235  */
1236 static void
1237 msg_received (void *cls, const struct GNUNET_MessageHeader *msg)
1238 {
1239   struct GNUNET_MESH_Handle *h = cls;
1240
1241   if (msg == NULL)
1242   {
1243     LOG (GNUNET_ERROR_TYPE_WARNING, "Received NULL msg on %p\n", h);
1244     reconnect (h);
1245     return;
1246   }
1247   LOG (GNUNET_ERROR_TYPE_DEBUG, "\n",
1248        GNUNET_MESH_DEBUG_M2S (ntohs (msg->type)));
1249   LOG (GNUNET_ERROR_TYPE_DEBUG, "Received a message: %s\n",
1250        GNUNET_MESH_DEBUG_M2S (ntohs (msg->type)));
1251   switch (ntohs (msg->type))
1252   {
1253     /* Notify of a new incoming tunnel */
1254   case GNUNET_MESSAGE_TYPE_MESH_LOCAL_TUNNEL_CREATE:
1255     process_tunnel_created (h, (struct GNUNET_MESH_TunnelNotification *) msg);
1256     break;
1257     /* Notify of a tunnel disconnection */
1258   case GNUNET_MESSAGE_TYPE_MESH_LOCAL_TUNNEL_DESTROY:
1259     process_tunnel_destroy (h, (struct GNUNET_MESH_TunnelMessage *) msg);
1260     break;
1261     /* Notify of a new peer or a peer disconnect in the tunnel */
1262   case GNUNET_MESSAGE_TYPE_MESH_LOCAL_PEER_ADD:
1263   case GNUNET_MESSAGE_TYPE_MESH_LOCAL_PEER_DEL:
1264     process_peer_event (h, (struct GNUNET_MESH_PeerControl *) msg);
1265     break;
1266     /* Notify of a new data packet in the tunnel */
1267   case GNUNET_MESSAGE_TYPE_MESH_UNICAST:
1268   case GNUNET_MESSAGE_TYPE_MESH_MULTICAST:
1269   case GNUNET_MESSAGE_TYPE_MESH_TO_ORIGIN:
1270     if (GNUNET_NO == process_incoming_data (h, msg))
1271       return;
1272     break;
1273   case GNUNET_MESSAGE_TYPE_MESH_LOCAL_ACK:
1274     process_ack (h, msg);
1275     break;
1276   default:
1277     /* We shouldn't get any other packages, log and ignore */
1278     LOG (GNUNET_ERROR_TYPE_WARNING,
1279          "unsolicited message form service (type %hu)\n",
1280          ntohs (msg->type));
1281   }
1282   LOG (GNUNET_ERROR_TYPE_DEBUG, "message processed\n");
1283   if (GNUNET_YES == h->in_receive)
1284   {
1285     GNUNET_CLIENT_receive (h->client, &msg_received, h,
1286                            GNUNET_TIME_UNIT_FOREVER_REL);
1287   }
1288   else
1289   {
1290     LOG (GNUNET_ERROR_TYPE_DEBUG,
1291          "in receive off, not calling CLIENT_receive\n");
1292   }
1293 }
1294
1295
1296 /******************************************************************************/
1297 /************************       SEND FUNCTIONS     ****************************/
1298 /******************************************************************************/
1299
1300 /**
1301  * Function called to send a message to the service.
1302  * "buf" will be NULL and "size" zero if the socket was closed for writing in
1303  * the meantime.
1304  *
1305  * @param cls closure, the mesh handle
1306  * @param size number of bytes available in buf
1307  * @param buf where the callee should write the connect message
1308  * @return number of bytes written to buf
1309  */
1310 static size_t
1311 send_callback (void *cls, size_t size, void *buf)
1312 {
1313   struct GNUNET_MESH_Handle *h = cls;
1314   struct GNUNET_MESH_TransmitHandle *th;
1315   struct GNUNET_MESH_TransmitHandle *next;
1316   struct GNUNET_MESH_Tunnel *t;
1317   char *cbuf = buf;
1318   size_t tsize;
1319   size_t psize;
1320   size_t nsize;
1321
1322   LOG (GNUNET_ERROR_TYPE_DEBUG, "\n");
1323   LOG (GNUNET_ERROR_TYPE_DEBUG, "Send packet() Buffer %u\n", size);
1324   if ((0 == size) || (NULL == buf))
1325   {
1326     LOG (GNUNET_ERROR_TYPE_DEBUG, "Received NULL send callback on %p\n", h);
1327     reconnect (h);
1328     h->th = NULL;
1329     return 0;
1330   }
1331   tsize = 0;
1332   next = h->th_head;
1333   nsize = message_ready_size (h);
1334   while ((NULL != (th = next)) && (0 < nsize) && (size >= nsize))
1335   {
1336     t = th->tunnel;
1337     if (GNUNET_YES == th_is_payload (th))
1338     {
1339       LOG (GNUNET_ERROR_TYPE_DEBUG, " payload\n");
1340       if (GNUNET_YES == GMC_is_pid_bigger(t->next_send_pid, t->max_send_pid))
1341       {
1342         /* This tunnel is not ready to transmit yet, try next message */
1343         next = th->next;
1344         continue;
1345       }
1346       t->packet_size = 0;
1347       if (t->tid >= GNUNET_MESH_LOCAL_TUNNEL_ID_SERV)
1348       {
1349         /* traffic to origin */
1350         struct GNUNET_MESH_ToOrigin to;
1351         struct GNUNET_MessageHeader *mh;
1352
1353         GNUNET_assert (size >= th->size);
1354         mh = (struct GNUNET_MessageHeader *) &cbuf[sizeof (to)];
1355         psize = th->notify (th->notify_cls, size - sizeof (to), mh);
1356         LOG (GNUNET_ERROR_TYPE_DEBUG, "  to origin, type %s\n",
1357              GNUNET_MESH_DEBUG_M2S (ntohs (mh->type)));
1358         if (psize > 0)
1359         {
1360           psize += sizeof (to);
1361           GNUNET_assert (size >= psize);
1362           to.header.size = htons (psize);
1363           to.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_TO_ORIGIN);
1364           to.tid = htonl (t->tid);
1365           to.pid = htonl (t->next_send_pid);
1366           to.ttl = 0;
1367           memset (&to.oid, 0, sizeof (struct GNUNET_PeerIdentity));
1368           memset (&to.sender, 0, sizeof (struct GNUNET_PeerIdentity));
1369           memcpy (cbuf, &to, sizeof (to));
1370         }
1371       }
1372       else if (th->target == 0)
1373       {
1374         /* multicast */
1375         struct GNUNET_MESH_Multicast mc;
1376         struct GNUNET_MessageHeader *mh;
1377
1378         GNUNET_assert (size >= th->size);
1379         mh = (struct GNUNET_MessageHeader *) &cbuf[sizeof (mc)];
1380         psize = th->notify (th->notify_cls, size - sizeof (mc), mh);
1381         LOG (GNUNET_ERROR_TYPE_DEBUG, "  multicast, type %s\n",
1382              GNUNET_MESH_DEBUG_M2S (ntohs (mh->type)));
1383         if (psize > 0)
1384         {
1385           psize += sizeof (mc);
1386           GNUNET_assert (size >= psize);
1387           mc.header.size = htons (psize);
1388           mc.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_MULTICAST);
1389           mc.tid = htonl (t->tid);
1390           mc.pid = htonl (t->next_send_pid);
1391           mc.ttl = 0;
1392           memset (&mc.oid, 0, sizeof (struct GNUNET_PeerIdentity));
1393           memcpy (cbuf, &mc, sizeof (mc));
1394         }
1395       }
1396       else
1397       {
1398         /* unicast */
1399         struct GNUNET_MESH_Unicast uc;
1400         struct GNUNET_MessageHeader *mh;
1401
1402         GNUNET_assert (size >= th->size);
1403         mh = (struct GNUNET_MessageHeader *) &cbuf[sizeof (uc)];
1404         psize = th->notify (th->notify_cls, size - sizeof (uc), mh);
1405         LOG (GNUNET_ERROR_TYPE_DEBUG, "  unicast, type %s\n",
1406              GNUNET_MESH_DEBUG_M2S (ntohs (mh->type)));
1407         if (psize > 0)
1408         {
1409           psize += sizeof (uc);
1410           GNUNET_assert (size >= psize);
1411           uc.header.size = htons (psize);
1412           uc.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_UNICAST);
1413           uc.tid = htonl (t->tid);
1414           uc.pid = htonl (t->next_send_pid);
1415           memset (&uc.oid, 0, sizeof (struct GNUNET_PeerIdentity));
1416           GNUNET_PEER_resolve (th->target, &uc.destination);
1417           memcpy (cbuf, &uc, sizeof (uc));
1418         }
1419       }
1420       t->next_send_pid++;
1421     }
1422     else
1423     {
1424       struct GNUNET_MessageHeader *mh = (struct GNUNET_MessageHeader *) &th[1];
1425
1426       LOG (GNUNET_ERROR_TYPE_DEBUG, "  mesh traffic, type %s\n",
1427            GNUNET_MESH_DEBUG_M2S (ntohs (mh->type)));
1428       memcpy (cbuf, &th[1], th->size);
1429       psize = th->size;
1430     }
1431     if (th->timeout_task != GNUNET_SCHEDULER_NO_TASK)
1432       GNUNET_SCHEDULER_cancel (th->timeout_task);
1433     GNUNET_CONTAINER_DLL_remove (h->th_head, h->th_tail, th);
1434     GNUNET_free (th);
1435     next = h->th_head;
1436     nsize = message_ready_size (h);
1437     cbuf += psize;
1438     size -= psize;
1439     tsize += psize;
1440   }
1441   LOG (GNUNET_ERROR_TYPE_DEBUG, "  total size: %u\n", tsize);
1442   h->th = NULL;
1443   size = message_ready_size (h);
1444   if (0 != size)
1445   {
1446     LOG (GNUNET_ERROR_TYPE_DEBUG, "  next size: %u\n", size);
1447     h->th =
1448         GNUNET_CLIENT_notify_transmit_ready (h->client, size,
1449                                              GNUNET_TIME_UNIT_FOREVER_REL,
1450                                              GNUNET_YES, &send_callback, h);
1451   }
1452   else
1453   {
1454     if (NULL != h->th_head)
1455       LOG (GNUNET_ERROR_TYPE_DEBUG, "  can't transmit any more\n");
1456     else
1457       LOG (GNUNET_ERROR_TYPE_DEBUG, "  nothing left to transmit\n");
1458   }
1459   if (GNUNET_NO == h->in_receive)
1460   {
1461     LOG (GNUNET_ERROR_TYPE_DEBUG, " start receiving from service\n");
1462     h->in_receive = GNUNET_YES;
1463     GNUNET_CLIENT_receive (h->client, &msg_received, h,
1464                            GNUNET_TIME_UNIT_FOREVER_REL);
1465   }
1466   LOG (GNUNET_ERROR_TYPE_DEBUG, "Send packet() END\n");
1467   return tsize;
1468 }
1469
1470
1471 /**
1472  * Auxiliary function to send an already constructed packet to the service.
1473  * Takes care of creating a new queue element, copying the message and
1474  * calling the tmt_rdy function if necessary.
1475  * 
1476  * @param h mesh handle
1477  * @param msg message to transmit
1478  * @param tunnel tunnel this send is related to (NULL if N/A)
1479  */
1480 static void
1481 send_packet (struct GNUNET_MESH_Handle *h,
1482              const struct GNUNET_MessageHeader *msg,
1483              struct GNUNET_MESH_Tunnel *tunnel)
1484 {
1485   struct GNUNET_MESH_TransmitHandle *th;
1486   size_t msize;
1487
1488   LOG (GNUNET_ERROR_TYPE_DEBUG, " Sending message to service: %s\n",
1489        GNUNET_MESH_DEBUG_M2S(ntohs(msg->type)));
1490   msize = ntohs (msg->size);
1491   th = GNUNET_malloc (sizeof (struct GNUNET_MESH_TransmitHandle) + msize);
1492   th->timeout = GNUNET_TIME_UNIT_FOREVER_ABS;
1493   th->size = msize;
1494   th->tunnel = tunnel;
1495   memcpy (&th[1], msg, msize);
1496   add_to_queue (h, th);
1497   LOG (GNUNET_ERROR_TYPE_DEBUG, "  queued\n");
1498   if (NULL != h->th)
1499     return;
1500   LOG (GNUNET_ERROR_TYPE_DEBUG, "  calling ntfy tmt rdy for %u bytes\n", msize);
1501   h->th =
1502       GNUNET_CLIENT_notify_transmit_ready (h->client, msize,
1503                                            GNUNET_TIME_UNIT_FOREVER_REL,
1504                                            GNUNET_YES, &send_callback, h);
1505 }
1506
1507
1508 /******************************************************************************/
1509 /**********************      API CALL DEFINITIONS     *************************/
1510 /******************************************************************************/
1511
1512 /**
1513  * Connect to the mesh service.
1514  *
1515  * @param cfg configuration to use
1516  * @param cls closure for the various callbacks that follow
1517  *            (including handlers in the handlers array)
1518  * @param new_tunnel function called when an *inbound* tunnel is created
1519  * @param cleaner function called when an *inbound* tunnel is destroyed by the
1520  *                remote peer, it is *not* called if GNUNET_MESH_tunnel_destroy
1521  *                is called on the tunnel
1522  * @param handlers callbacks for messages we care about, NULL-terminated
1523  *                note that the mesh is allowed to drop notifications about
1524  *                inbound messages if the client does not process them fast
1525  *                enough (for this notification type, a bounded queue is used)
1526  * @param stypes list of the applications that this client claims to provide
1527  * @return handle to the mesh service NULL on error
1528  *         (in this case, init is never called)
1529  */
1530 struct GNUNET_MESH_Handle *
1531 GNUNET_MESH_connect (const struct GNUNET_CONFIGURATION_Handle *cfg, void *cls,
1532                      GNUNET_MESH_InboundTunnelNotificationHandler new_tunnel,
1533                      GNUNET_MESH_TunnelEndHandler cleaner,
1534                      const struct GNUNET_MESH_MessageHandler *handlers,
1535                      const GNUNET_MESH_ApplicationType *stypes)
1536 {
1537   struct GNUNET_MESH_Handle *h;
1538
1539   LOG (GNUNET_ERROR_TYPE_DEBUG, "GNUNET_MESH_connect()\n");
1540   h = GNUNET_malloc (sizeof (struct GNUNET_MESH_Handle));
1541   LOG (GNUNET_ERROR_TYPE_DEBUG, " addr %p\n", h);
1542   h->cfg = cfg;
1543   h->new_tunnel = new_tunnel;
1544   h->cleaner = cleaner;
1545   h->client = GNUNET_CLIENT_connect ("mesh", cfg);
1546   if (h->client == NULL)
1547   {
1548     GNUNET_break (0);
1549     GNUNET_free (h);
1550     return NULL;
1551   }
1552   h->cls = cls;
1553   /* FIXME memdup? */
1554   h->applications = stypes;
1555   h->message_handlers = handlers;
1556   h->next_tid = GNUNET_MESH_LOCAL_TUNNEL_ID_CLI;
1557   h->reconnect_time = GNUNET_TIME_UNIT_MILLISECONDS;
1558   h->reconnect_task = GNUNET_SCHEDULER_NO_TASK;
1559
1560   /* count handlers and apps, calculate size */
1561   for (h->n_applications = 0; stypes[h->n_applications]; h->n_applications++) ;
1562   for (h->n_handlers = 0; handlers[h->n_handlers].type; h->n_handlers++) ;
1563   send_connect (h);
1564   LOG (GNUNET_ERROR_TYPE_DEBUG, "GNUNET_MESH_connect() END\n");
1565   return h;
1566 }
1567
1568
1569 /**
1570  * Disconnect from the mesh service. All tunnels will be destroyed. All tunnel
1571  * disconnect callbacks will be called on any still connected peers, notifying
1572  * about their disconnection. The registered inbound tunnel cleaner will be
1573  * called should any inbound tunnels still exist.
1574  *
1575  * @param handle connection to mesh to disconnect
1576  */
1577 void
1578 GNUNET_MESH_disconnect (struct GNUNET_MESH_Handle *handle)
1579 {
1580   struct GNUNET_MESH_Tunnel *t;
1581   struct GNUNET_MESH_Tunnel *aux;
1582   struct GNUNET_MESH_TransmitHandle *th;
1583
1584   LOG (GNUNET_ERROR_TYPE_DEBUG, "MESH DISCONNECT\n");
1585
1586 #if DEBUG_ACK
1587   LOG (GNUNET_ERROR_TYPE_INFO, "Sent %d ACKs\n", handle->acks_sent);
1588   LOG (GNUNET_ERROR_TYPE_INFO, "Recv %d ACKs\n\n", handle->acks_recv);
1589 #endif
1590
1591   t = handle->tunnels_head;
1592   while (NULL != t)
1593   {
1594     aux = t->next;
1595     if (t->tid < GNUNET_MESH_LOCAL_TUNNEL_ID_SERV)
1596     {
1597       GNUNET_break (0);
1598       LOG (GNUNET_ERROR_TYPE_DEBUG, "tunnel %X not destroyed\n", t->tid);
1599     }
1600     destroy_tunnel (t, GNUNET_YES);
1601     t = aux;
1602   }
1603   while ( (th = handle->th_head) != NULL)
1604   {
1605     struct GNUNET_MessageHeader *msg;
1606
1607     /* Make sure it is an allowed packet (everything else should have been
1608      * already canceled).
1609      */
1610     GNUNET_break (GNUNET_NO == th_is_payload (th));
1611     msg = (struct GNUNET_MessageHeader *) &th[1];
1612     switch (ntohs(msg->type))
1613     {
1614       case GNUNET_MESSAGE_TYPE_MESH_LOCAL_CONNECT:
1615       case GNUNET_MESSAGE_TYPE_MESH_LOCAL_TUNNEL_DESTROY:
1616         break;
1617       default:
1618         GNUNET_break (0);
1619         LOG (GNUNET_ERROR_TYPE_DEBUG, "unexpected msg %u\n",
1620              ntohs(msg->type));
1621     }
1622
1623     GNUNET_CONTAINER_DLL_remove (handle->th_head, handle->th_tail, th);
1624     GNUNET_free (th);
1625   }
1626
1627   if (NULL != handle->th)
1628   {
1629     GNUNET_CLIENT_notify_transmit_ready_cancel (handle->th);
1630     handle->th = NULL;
1631   }
1632   if (NULL != handle->client)
1633   {
1634     GNUNET_CLIENT_disconnect (handle->client);
1635     handle->client = NULL;
1636   }
1637   if (GNUNET_SCHEDULER_NO_TASK != handle->reconnect_task)
1638   {
1639     GNUNET_SCHEDULER_cancel(handle->reconnect_task);
1640     handle->reconnect_task = GNUNET_SCHEDULER_NO_TASK;
1641   }
1642   GNUNET_free (handle);
1643 }
1644
1645
1646 /**
1647  * Announce to ther peer the availability of services described by the regex,
1648  * in order to be reachable to other peers via connect_by_string.
1649  * 
1650  * Note that the first 8 characters are considered to be part of a prefix,
1651  * (for instance 'gnunet://'). If you put a variable part in there (*, +. ()),
1652  * all matching strings will be stored in the DHT.
1653  *
1654  * @param h handle to mesh.
1655  * @param regex string with the regular expression describing local services.
1656  */
1657 void
1658 GNUNET_MESH_announce_regex (struct GNUNET_MESH_Handle *h,
1659                             const char *regex)
1660 {
1661   struct GNUNET_MessageHeader *msg;
1662   size_t len;
1663   size_t msgsize;
1664
1665   len = strlen (regex);
1666   msgsize = sizeof(struct GNUNET_MessageHeader) + len;
1667   GNUNET_assert (UINT16_MAX > msgsize);
1668
1669   {
1670     char buffer[msgsize];
1671
1672     msg = (struct GNUNET_MessageHeader *) buffer;
1673     msg->size = htons (msgsize);
1674     msg->type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_ANNOUNCE_REGEX);
1675     memcpy (&msg[1], regex, len);
1676
1677     send_packet(h, msg, NULL);
1678   }
1679 }
1680
1681 /**
1682  * Create a new tunnel (we're initiator and will be allowed to add/remove peers
1683  * and to broadcast).
1684  *
1685  * @param h mesh handle
1686  * @param tunnel_ctx client's tunnel context to associate with the tunnel
1687  * @param connect_handler function to call when peers are actually connected
1688  * @param disconnect_handler function to call when peers are disconnected
1689  * @param handler_cls closure for connect/disconnect handlers
1690  */
1691 struct GNUNET_MESH_Tunnel *
1692 GNUNET_MESH_tunnel_create (struct GNUNET_MESH_Handle *h, void *tunnel_ctx,
1693                            GNUNET_MESH_PeerConnectHandler connect_handler,
1694                            GNUNET_MESH_PeerDisconnectHandler disconnect_handler,
1695                            void *handler_cls)
1696 {
1697   struct GNUNET_MESH_Tunnel *t;
1698   struct GNUNET_MESH_TunnelMessage msg;
1699
1700   LOG (GNUNET_ERROR_TYPE_DEBUG, "Creating new tunnel\n");
1701   t = create_tunnel (h, 0);
1702   LOG (GNUNET_ERROR_TYPE_DEBUG, "  at %p\n", t);
1703   LOG (GNUNET_ERROR_TYPE_DEBUG, "  number %X\n", t->tid);
1704   t->connect_handler = connect_handler;
1705   t->disconnect_handler = disconnect_handler;
1706   t->cls = handler_cls;
1707   t->ctx = tunnel_ctx;
1708   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_TUNNEL_CREATE);
1709   msg.header.size = htons (sizeof (struct GNUNET_MESH_TunnelMessage));
1710   msg.tunnel_id = htonl (t->tid);
1711   send_packet (h, &msg.header, t);
1712   return t;
1713 }
1714
1715
1716 /**
1717  * Destroy an existing tunnel. The existing callback for the tunnel will NOT
1718  * be called.
1719  *
1720  * @param tunnel tunnel handle
1721  */
1722 void
1723 GNUNET_MESH_tunnel_destroy (struct GNUNET_MESH_Tunnel *tunnel)
1724 {
1725   struct GNUNET_MESH_Handle *h;
1726   struct GNUNET_MESH_TunnelMessage msg;
1727   struct GNUNET_MESH_TransmitHandle *th;
1728
1729   LOG (GNUNET_ERROR_TYPE_DEBUG, "Destroying tunnel\n");
1730   h = tunnel->mesh;
1731
1732   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_TUNNEL_DESTROY);
1733   msg.header.size = htons (sizeof (struct GNUNET_MESH_TunnelMessage));
1734   msg.tunnel_id = htonl (tunnel->tid);
1735   th = h->th_head;
1736   while (th != NULL)
1737   {
1738     struct GNUNET_MESH_TransmitHandle *aux;
1739     if (th->tunnel == tunnel)
1740     {
1741       aux = th->next;
1742       /* FIXME call the handler? */
1743       if (GNUNET_YES == th_is_payload (th))
1744         th->notify (th->notify_cls, 0, NULL);
1745       GNUNET_CONTAINER_DLL_remove (h->th_head, h->th_tail, th);
1746       GNUNET_free (th);
1747       th = aux;
1748     }
1749     else
1750       th = th->next;
1751   }
1752
1753   destroy_tunnel (tunnel, GNUNET_NO);
1754   send_packet (h, &msg.header, NULL);
1755 }
1756
1757 /**
1758  * Request that the tunnel data rate is limited to the speed of the slowest
1759  * receiver.
1760  *
1761  * @param tunnel Tunnel affected.
1762  */
1763 void
1764 GNUNET_MESH_tunnel_speed_min (struct GNUNET_MESH_Tunnel *tunnel)
1765 {
1766   struct GNUNET_MESH_TunnelMessage msg;
1767   struct GNUNET_MESH_Handle *h;
1768
1769   h = tunnel->mesh;
1770   tunnel->speed_min = GNUNET_YES;
1771
1772   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_TUNNEL_MIN);
1773   msg.header.size = htons (sizeof (struct GNUNET_MESH_TunnelMessage));
1774   msg.tunnel_id = htonl (tunnel->tid);
1775
1776   send_packet (h, &msg.header, NULL);
1777 }
1778
1779
1780 /**
1781  * Request that the tunnel data rate is limited to the speed of the fastest
1782  * receiver. This is the default behavior.
1783  *
1784  * @param tunnel Tunnel affected.
1785  */
1786 void
1787 GNUNET_MESH_tunnel_speed_max (struct GNUNET_MESH_Tunnel *tunnel)
1788 {
1789   struct GNUNET_MESH_TunnelMessage msg;
1790   struct GNUNET_MESH_Handle *h;
1791
1792   h = tunnel->mesh;
1793   tunnel->speed_min = GNUNET_NO;
1794
1795   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_TUNNEL_MAX);
1796   msg.header.size = htons (sizeof (struct GNUNET_MESH_TunnelMessage));
1797   msg.tunnel_id = htonl (tunnel->tid);
1798
1799   send_packet (h, &msg.header, NULL);
1800 }
1801
1802 /**
1803  * Turn on/off the buffering status of the tunnel.
1804  * 
1805  * @param tunnel Tunnel affected.
1806  * @param buffer GNUNET_YES to turn buffering on (default),
1807  *               GNUNET_NO otherwise.
1808  */
1809 void
1810 GNUNET_MESH_tunnel_buffer (struct GNUNET_MESH_Tunnel *tunnel, int buffer)
1811 {
1812   struct GNUNET_MESH_TunnelMessage msg;
1813   struct GNUNET_MESH_Handle *h;
1814
1815   h = tunnel->mesh;
1816   tunnel->buffering = buffer;
1817
1818   if (GNUNET_YES == buffer)
1819     msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_TUNNEL_BUFFER);
1820   else
1821     msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_TUNNEL_NOBUFFER);
1822   msg.header.size = htons (sizeof (struct GNUNET_MESH_TunnelMessage));
1823   msg.tunnel_id = htonl (tunnel->tid);
1824
1825   send_packet (h, &msg.header, NULL);
1826 }
1827
1828 /**
1829  * Request that a peer should be added to the tunnel.  The existing
1830  * connect handler will be called ONCE with either success or failure.
1831  * This function should NOT be called again with the same peer before the
1832  * connect handler is called.
1833  *
1834  * @param tunnel handle to existing tunnel
1835  * @param peer peer to add
1836  */
1837 void
1838 GNUNET_MESH_peer_request_connect_add (struct GNUNET_MESH_Tunnel *tunnel,
1839                                       const struct GNUNET_PeerIdentity *peer)
1840 {
1841   struct GNUNET_MESH_PeerControl msg;
1842   GNUNET_PEER_Id peer_id;
1843   unsigned int i;
1844
1845   peer_id = GNUNET_PEER_intern (peer);
1846   for (i = 0; i < tunnel->npeers; i++)
1847   {
1848     if (tunnel->peers[i]->id == peer_id)
1849     {
1850       /* Peer already exists in tunnel */
1851       GNUNET_PEER_change_rc (peer_id, -1);
1852       GNUNET_break (0);
1853       return;
1854     }
1855   }
1856   if (NULL == add_peer_to_tunnel (tunnel, peer))
1857     return;
1858
1859   msg.header.size = htons (sizeof (struct GNUNET_MESH_PeerControl));
1860   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_PEER_ADD);
1861   msg.tunnel_id = htonl (tunnel->tid);
1862   msg.peer = *peer;
1863   send_packet (tunnel->mesh, &msg.header, tunnel);
1864
1865   return;
1866 }
1867
1868
1869 /**
1870  * Request that a peer should be removed from the tunnel.  The existing
1871  * disconnect handler will be called ONCE if we were connected.
1872  *
1873  * @param tunnel handle to existing tunnel
1874  * @param peer peer to remove
1875  */
1876 void
1877 GNUNET_MESH_peer_request_connect_del (struct GNUNET_MESH_Tunnel *tunnel,
1878                                       const struct GNUNET_PeerIdentity *peer)
1879 {
1880   struct GNUNET_MESH_PeerControl msg;
1881   GNUNET_PEER_Id peer_id;
1882   unsigned int i;
1883
1884   peer_id = GNUNET_PEER_search (peer);
1885   if (0 == peer_id)
1886   {
1887     GNUNET_break (0);
1888     return;
1889   }
1890   for (i = 0; i < tunnel->npeers; i++)
1891     if (tunnel->peers[i]->id == peer_id)
1892       break;
1893   if (i == tunnel->npeers)
1894   {
1895     GNUNET_break (0);
1896     return;
1897   }
1898   if (NULL != tunnel->disconnect_handler && tunnel->peers[i]->connected == 1)
1899     tunnel->disconnect_handler (tunnel->cls, peer);
1900   GNUNET_PEER_change_rc (peer_id, -1);
1901   GNUNET_free (tunnel->peers[i]);
1902   tunnel->peers[i] = tunnel->peers[tunnel->npeers - 1];
1903   GNUNET_array_grow (tunnel->peers, tunnel->npeers, tunnel->npeers - 1);
1904
1905   msg.header.size = htons (sizeof (struct GNUNET_MESH_PeerControl));
1906   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_PEER_DEL);
1907   msg.tunnel_id = htonl (tunnel->tid);
1908   memcpy (&msg.peer, peer, sizeof (struct GNUNET_PeerIdentity));
1909   send_packet (tunnel->mesh, &msg.header, tunnel);
1910 }
1911
1912
1913 /**
1914  * Request that the mesh should try to connect to a peer supporting the given
1915  * message type.
1916  *
1917  * @param tunnel handle to existing tunnel
1918  * @param app_type application type that must be supported by the peer (MESH
1919  *                 should discover peer in proximity handling this type)
1920  */
1921 void
1922 GNUNET_MESH_peer_request_connect_by_type (struct GNUNET_MESH_Tunnel *tunnel,
1923                                           GNUNET_MESH_ApplicationType app_type)
1924 {
1925   struct GNUNET_MESH_ConnectPeerByType msg;
1926
1927   GNUNET_array_append (tunnel->apps, tunnel->napps, app_type);
1928
1929   LOG (GNUNET_ERROR_TYPE_DEBUG, "* CONNECT BY TYPE *\n");
1930   msg.header.size = htons (sizeof (struct GNUNET_MESH_ConnectPeerByType));
1931   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_PEER_ADD_BY_TYPE);
1932   msg.tunnel_id = htonl (tunnel->tid);
1933   msg.type = htonl (app_type);
1934   send_packet (tunnel->mesh, &msg.header, tunnel);
1935 }
1936
1937
1938 /**
1939  * Request that the mesh should try to connect to a peer matching the
1940  * description given in the service string.
1941  * 
1942  * FIXME: allow multiple? how to deal with reconnect?
1943  *
1944  * @param tunnel handle to existing tunnel
1945  * @param description string describing the destination node requirements
1946  */
1947 void
1948 GNUNET_MESH_peer_request_connect_by_string (struct GNUNET_MESH_Tunnel *tunnel,
1949                                             const char *description)
1950 {
1951   struct GNUNET_MESH_ConnectPeerByString *m;
1952   size_t len;
1953   size_t msgsize;
1954
1955   len = strlen (description);
1956   msgsize = sizeof(struct GNUNET_MESH_ConnectPeerByString) + len;
1957   GNUNET_assert (UINT16_MAX > msgsize);
1958   {
1959     char buffer[msgsize];
1960
1961     m = (struct GNUNET_MESH_ConnectPeerByString *) buffer;
1962     m->header.size = htons (msgsize);
1963     m->header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_PEER_ADD_BY_STRING);
1964     m->tunnel_id = htonl (tunnel->tid);
1965     memcpy(&m[1], description, len);
1966
1967     send_packet (tunnel->mesh, &m->header, tunnel);
1968   }
1969 }
1970
1971
1972 /**
1973  * Request that the given peer isn't added to this tunnel in calls to
1974  * connect_by_* calls, (due to misbehaviour, bad performance, ...).
1975  *
1976  * @param tunnel handle to existing tunnel.
1977  * @param peer peer identity of the peer which should be blacklisted
1978  *                  for the tunnel.
1979  */
1980 void
1981 GNUNET_MESH_peer_blacklist (struct GNUNET_MESH_Tunnel *tunnel,
1982                             const struct GNUNET_PeerIdentity *peer)
1983 {
1984   struct GNUNET_MESH_PeerControl msg;
1985
1986   msg.header.size = htons (sizeof (struct GNUNET_MESH_PeerControl));
1987   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_PEER_BLACKLIST);
1988   msg.tunnel_id = htonl (tunnel->tid);
1989   msg.peer = *peer;
1990   send_packet (tunnel->mesh, &msg.header, tunnel);
1991
1992   return;
1993 }
1994
1995
1996 /**
1997  * Request that the given peer isn't blacklisted anymore from this tunnel,
1998  * and therefore can be added in future calls to connect_by_*.
1999  * The peer must have been previously blacklisted for this tunnel.
2000  *
2001  * @param tunnel handle to existing tunnel.
2002  * @param peer peer identity of the peer which shouldn't be blacklisted
2003  *                  for the tunnel anymore.
2004  */
2005 void
2006 GNUNET_MESH_peer_unblacklist (struct GNUNET_MESH_Tunnel *tunnel,
2007                               const struct GNUNET_PeerIdentity *peer)
2008 {
2009   struct GNUNET_MESH_PeerControl msg;
2010
2011   msg.header.size = htons (sizeof (struct GNUNET_MESH_PeerControl));
2012   msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_LOCAL_PEER_UNBLACKLIST);
2013   msg.tunnel_id = htonl (tunnel->tid);
2014   msg.peer = *peer;
2015   send_packet (tunnel->mesh, &msg.header, tunnel);
2016
2017   return;
2018 }
2019
2020
2021 /**
2022  * Ask the mesh to call "notify" once it is ready to transmit the
2023  * given number of bytes to the specified tunnel or target.
2024  * Only one call can be active at any time, to issue another request,
2025  * wait for the callback or cancel the current request.
2026  *
2027  * @param tunnel tunnel to use for transmission
2028  * @param cork is corking allowed for this transmission?
2029  * @param maxdelay how long can the message wait?
2030  * @param target destination for the message
2031  *               NULL for multicast to all tunnel targets
2032  * @param notify_size how many bytes of buffer space does notify want?
2033  * @param notify function to call when buffer space is available;
2034  *        will be called with NULL on timeout or if the overall queue
2035  *        for this peer is larger than queue_size and this is currently
2036  *        the message with the lowest priority
2037  * @param notify_cls closure for notify
2038  * @return non-NULL if the notify callback was queued,
2039  *         NULL if we can not even queue the request (insufficient
2040  *         memory); if NULL is returned, "notify" will NOT be called.
2041  */
2042 struct GNUNET_MESH_TransmitHandle *
2043 GNUNET_MESH_notify_transmit_ready (struct GNUNET_MESH_Tunnel *tunnel, int cork,
2044                                    struct GNUNET_TIME_Relative maxdelay,
2045                                    const struct GNUNET_PeerIdentity *target,
2046                                    size_t notify_size,
2047                                    GNUNET_CONNECTION_TransmitReadyNotify notify,
2048                                    void *notify_cls)
2049 {
2050   struct GNUNET_MESH_TransmitHandle *th;
2051   size_t overhead;
2052
2053   GNUNET_assert (NULL != tunnel);
2054   LOG (GNUNET_ERROR_TYPE_DEBUG, "MESH NOTIFY TRANSMIT READY\n");
2055   LOG (GNUNET_ERROR_TYPE_DEBUG, "    on tunnel %X\n", tunnel->tid);
2056   if (tunnel->tid >= GNUNET_MESH_LOCAL_TUNNEL_ID_SERV)
2057     LOG (GNUNET_ERROR_TYPE_DEBUG, "    to origin\n");
2058   else if (NULL != target)
2059     LOG (GNUNET_ERROR_TYPE_DEBUG, "    target %s\n", GNUNET_i2s (target));
2060   else
2061     LOG (GNUNET_ERROR_TYPE_DEBUG, "    target multicast\n");
2062   LOG (GNUNET_ERROR_TYPE_DEBUG, "    payload size %u\n", notify_size);
2063   GNUNET_assert (NULL != notify);
2064   GNUNET_assert (0 == tunnel->packet_size); // Only one data packet allowed
2065   th = GNUNET_malloc (sizeof (struct GNUNET_MESH_TransmitHandle));
2066   th->tunnel = tunnel;
2067   th->timeout = GNUNET_TIME_relative_to_absolute (maxdelay);
2068   th->target = GNUNET_PEER_intern (target);
2069   if (tunnel->tid >= GNUNET_MESH_LOCAL_TUNNEL_ID_SERV)
2070     overhead = sizeof (struct GNUNET_MESH_ToOrigin);
2071   else if (NULL == target)
2072     overhead = sizeof (struct GNUNET_MESH_Multicast);
2073   else
2074     overhead = sizeof (struct GNUNET_MESH_Unicast);
2075   tunnel->packet_size = th->size = notify_size + overhead;
2076   LOG (GNUNET_ERROR_TYPE_DEBUG, "    total size %u\n", th->size);
2077   th->notify = notify;
2078   th->notify_cls = notify_cls;
2079   add_to_queue (tunnel->mesh, th);
2080   if (NULL != tunnel->mesh->th)
2081     return th;
2082   if (GMC_is_pid_bigger(tunnel->next_send_pid, tunnel->max_send_pid))
2083     return th;
2084   LOG (GNUNET_ERROR_TYPE_DEBUG, "    call notify tmt rdy\n");
2085   tunnel->mesh->th =
2086       GNUNET_CLIENT_notify_transmit_ready (tunnel->mesh->client, th->size,
2087                                            GNUNET_TIME_UNIT_FOREVER_REL,
2088                                            GNUNET_YES, &send_callback,
2089                                            tunnel->mesh);
2090   LOG (GNUNET_ERROR_TYPE_DEBUG, "MESH NOTIFY TRANSMIT READY END\n");
2091   return th;
2092 }
2093
2094
2095 /**
2096  * Cancel the specified transmission-ready notification.
2097  *
2098  * @param th handle that was returned by "notify_transmit_ready".
2099  */
2100 void
2101 GNUNET_MESH_notify_transmit_ready_cancel (struct GNUNET_MESH_TransmitHandle *th)
2102 {
2103   struct GNUNET_MESH_Handle *mesh;
2104
2105   th->tunnel->packet_size = 0;
2106   mesh = th->tunnel->mesh;
2107   if (th->timeout_task != GNUNET_SCHEDULER_NO_TASK)
2108     GNUNET_SCHEDULER_cancel (th->timeout_task);
2109   GNUNET_CONTAINER_DLL_remove (mesh->th_head, mesh->th_tail, th);
2110   GNUNET_free (th);
2111   if ((0 == message_ready_size (mesh)) && (NULL != mesh->th))
2112   {
2113     /* queue empty, no point in asking for transmission */
2114     GNUNET_CLIENT_notify_transmit_ready_cancel (mesh->th);
2115     mesh->th = NULL;
2116   }
2117 }
2118
2119
2120 /**
2121  * Transition API for tunnel ctx management
2122  */
2123 void
2124 GNUNET_MESH_tunnel_set_data (struct GNUNET_MESH_Tunnel *tunnel, void *data)
2125 {
2126   tunnel->ctx = data;
2127 }
2128
2129 /**
2130  * Transition API for tunnel ctx management
2131  */
2132 void *
2133 GNUNET_MESH_tunnel_get_data (struct GNUNET_MESH_Tunnel *tunnel)
2134 {
2135   return tunnel->ctx;
2136 }
2137
2138