2 This file is part of GNUnet.
3 (C) 2013 Christian Grothoff (and other contributing authors)
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.
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.
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.
23 #include "gnunet_util_lib.h"
25 #include "gnunet_statistics_service.h"
28 #include "mesh_protocol.h"
30 #include "gnunet-service-mesh_channel.h"
31 #include "gnunet-service-mesh_local.h"
32 #include "gnunet-service-mesh_tunnel.h"
33 #include "gnunet-service-mesh_peer.h"
35 #define LOG(level, ...) GNUNET_log_from(level,"mesh-chn",__VA_ARGS__)
37 #define MESH_RETRANSMIT_TIME GNUNET_TIME_UNIT_SECONDS
38 #define MESH_RETRANSMIT_MARGIN 4
42 * All the states a connection can be in.
47 * Uninitialized status, should never appear in operation.
52 * Connection create message sent, waiting for ACK.
57 * Connection confirmed, ready to carry traffic.
65 * Info needed to retry a message in case it gets lost.
67 struct MeshReliableMessage
70 * Double linked list, FIFO style
72 struct MeshReliableMessage *next;
73 struct MeshReliableMessage *prev;
76 * Type of message (payload, channel management).
81 * Tunnel Reliability queue this message is in.
83 struct MeshChannelReliability *rel;
86 * ID of the message (ACK needed to free)
93 struct MeshTunnel3Queue *q;
96 * When was this message issued (to calculate ACK delay)
98 struct GNUNET_TIME_Absolute timestamp;
100 /* struct GNUNET_MESH_Data with payload */
105 * Info about the traffic state for a client in a channel.
107 struct MeshChannelReliability
110 * Channel this is about.
112 struct MeshChannel *ch;
115 * DLL of messages sent and not yet ACK'd.
117 struct MeshReliableMessage *head_sent;
118 struct MeshReliableMessage *tail_sent;
121 * DLL of messages received out of order.
123 struct MeshReliableMessage *head_recv;
124 struct MeshReliableMessage *tail_recv;
132 * Next MID to use for outgoing traffic.
137 * Next MID expected for incoming traffic.
142 * Can we send data to the client?
147 * Can the client send data to us?
152 * Task to resend/poll in case no ACK is received.
154 GNUNET_SCHEDULER_TaskIdentifier retry_task;
157 * Counter for exponential backoff.
159 struct GNUNET_TIME_Relative retry_timer;
162 * How long does it usually take to get an ACK.
164 struct GNUNET_TIME_Relative expected_delay;
169 * Struct containing all information regarding a channel to a remote client.
174 * Tunnel this channel is in.
176 struct MeshTunnel3 *t;
179 * Destination port of the channel.
184 * Global channel number ( < GNUNET_MESH_LOCAL_CHANNEL_ID_CLI)
186 MESH_ChannelNumber gid;
189 * Local tunnel number for root (owner) client.
190 * ( >= GNUNET_MESH_LOCAL_CHANNEL_ID_CLI or 0 )
192 MESH_ChannelNumber lid_root;
195 * Local tunnel number for local destination clients (incoming number)
196 * ( >= GNUNET_MESH_LOCAL_CHANNEL_ID_SERV or 0).
198 MESH_ChannelNumber lid_dest;
203 enum MeshChannelState state;
206 * Is the tunnel bufferless (minimum latency)?
211 * Is the tunnel reliable?
216 * Last time the channel was used
218 struct GNUNET_TIME_Absolute timestamp;
221 * Client owner of the tunnel, if any
223 struct MeshClient *root;
226 * Client destination of the tunnel, if any.
228 struct MeshClient *dest;
231 * Flag to signal the destruction of the channel.
232 * If this is set GNUNET_YES the channel will be destroyed
233 * when the queue is empty.
238 * Total messages pending for this channel, payload or not.
240 unsigned int pending_messages;
244 * Only present (non-NULL) at the owner of a tunnel.
246 struct MeshChannelReliability *root_rel;
250 * Only present (non-NULL) at the destination of a tunnel.
252 struct MeshChannelReliability *dest_rel;
257 /******************************************************************************/
258 /******************************* GLOBALS ***********************************/
259 /******************************************************************************/
262 * Global handle to the statistics service.
264 extern struct GNUNET_STATISTICS_Handle *stats;
267 * Local peer own ID (memory efficient handle).
269 extern GNUNET_PEER_Id myid;
272 /******************************************************************************/
273 /******************************** STATIC ***********************************/
274 /******************************************************************************/
277 * Destroy a reliable message after it has been acknowledged, either by
278 * direct mid ACK or bitfield. Updates the appropriate data structures and
279 * timers and frees all memory.
281 * @param copy Message that is no longer needed: remote peer got it.
282 * @param update_time Is the timing information relevant?
283 * If this message is ACK in a batch the timing information
284 * is skewed by the retransmission, count only for the
285 * retransmitted message.
288 rel_message_free (struct MeshReliableMessage *copy, int update_time);
291 * We have received a message out of order, or the client is not ready.
292 * Buffer it until we receive an ACK from the client or the missing
293 * message from the channel.
295 * @param msg Message to buffer (MUST be of type MESH_DATA).
296 * @param rel Reliability data to the corresponding direction.
299 add_buffered_data (const struct GNUNET_MESH_Data *msg,
300 struct MeshChannelReliability *rel)
302 struct MeshReliableMessage *copy;
303 struct MeshReliableMessage *prev;
307 size = ntohs (msg->header.size);
308 mid = ntohl (msg->mid);
310 LOG (GNUNET_ERROR_TYPE_DEBUG, "add_buffered_data %u\n", mid);
312 copy = GNUNET_malloc (sizeof (*copy) + size);
315 copy->type = GNUNET_MESSAGE_TYPE_MESH_DATA;
316 memcpy (©[1], msg, size);
320 // FIXME do something better than O(n), although n < 64...
321 // FIXME start from the end (most messages are the latest ones)
322 for (prev = rel->head_recv; NULL != prev; prev = prev->next)
324 LOG (GNUNET_ERROR_TYPE_DEBUG, " prev %u\n", prev->mid);
325 if (GMC_is_pid_bigger (prev->mid, mid))
327 LOG (GNUNET_ERROR_TYPE_DEBUG, " bingo!\n");
328 GNUNET_CONTAINER_DLL_insert_before (rel->head_recv, rel->tail_recv,
333 LOG (GNUNET_ERROR_TYPE_DEBUG, " insert at tail!\n");
334 GNUNET_CONTAINER_DLL_insert_tail (rel->head_recv, rel->tail_recv, copy);
335 LOG (GNUNET_ERROR_TYPE_DEBUG, "add_buffered_data END\n");
339 * Add a destination client to a channel, initializing all data structures
340 * in the channel and the client.
342 * @param ch Channel to which add the destination.
343 * @param c Client which to add to the channel.
346 add_destination (struct MeshChannel *ch, struct MeshClient *c)
348 if (NULL != ch->dest)
354 /* Assign local id as destination */
355 ch->lid_dest = GML_get_next_chid (c);
357 /* Store in client's hashmap */
358 GML_channel_add (c, ch->lid_dest, ch);
360 GNUNET_break (NULL == ch->dest_rel);
361 ch->dest_rel = GNUNET_new (struct MeshChannelReliability);
362 ch->dest_rel->ch = ch;
363 ch->dest_rel->expected_delay = MESH_RETRANSMIT_TIME;
370 * Send data to a client.
372 * If the client is ready, send directly, otherwise buffer while listening
376 * @param msg Message.
377 * @param fwd Is this a fwd (root->dest) message?
380 send_client_data (struct MeshChannel *ch,
381 const struct GNUNET_MESH_Data *msg,
386 if (ch->dest_rel->client_ready)
387 GML_send_data (ch->dest, msg, ch->lid_dest);
389 add_buffered_data (msg, ch->dest_rel);
393 if (ch->root_rel->client_ready)
394 GML_send_data (ch->root, msg, ch->lid_root);
396 add_buffered_data (msg, ch->root_rel);
402 * Send a buffered message to the client, for in order delivery or
403 * as result of client ACK.
405 * @param ch Channel on which to empty the message buffer.
406 * @param c Client to send to.
407 * @param fwd Is this to send FWD data?.
410 send_client_buffered_data (struct MeshChannel *ch,
411 struct MeshClient *c,
414 struct MeshReliableMessage *copy;
415 struct MeshChannelReliability *rel;
417 LOG (GNUNET_ERROR_TYPE_DEBUG, "send_buffered_data\n");
418 rel = fwd ? ch->dest_rel : ch->root_rel;
419 if (GNUNET_NO == rel->client_ready)
421 LOG (GNUNET_ERROR_TYPE_DEBUG, "client not ready\n");
425 copy = rel->head_recv;
426 /* We never buffer channel management messages */
429 if (copy->mid == rel->mid_recv || GNUNET_NO == ch->reliable)
431 struct GNUNET_MESH_Data *msg = (struct GNUNET_MESH_Data *) ©[1];
433 LOG (GNUNET_ERROR_TYPE_DEBUG,
434 " have %u! now expecting %u\n",
435 copy->mid, rel->mid_recv + 1);
436 send_client_data (ch, msg, fwd);
439 GNUNET_CONTAINER_DLL_remove (rel->head_recv, rel->tail_recv, copy);
444 LOG (GNUNET_ERROR_TYPE_DEBUG,
445 " reliable && don't have %u, next is %u\n",
451 LOG (GNUNET_ERROR_TYPE_DEBUG, "send_buffered_data END\n");
456 * Allow a client to send more data.
458 * In case the client was already allowed to send data, do nothing.
461 * @param fwd Is this a FWD ACK? (FWD ACKs are sent to root)
464 send_client_ack (struct MeshChannel *ch, int fwd)
466 struct MeshChannelReliability *rel = fwd ? ch->root_rel : ch->dest_rel;
468 LOG (GNUNET_ERROR_TYPE_DEBUG,
469 " sending %s ack to client on channel %s\n",
470 fwd ? "FWD" : "BCK", GMCH_2s (ch));
478 if (GNUNET_YES == rel->client_allowed)
480 LOG (GNUNET_ERROR_TYPE_DEBUG, " already allowed\n");
483 rel->client_allowed = GNUNET_YES;
485 GML_send_ack (fwd ? ch->root : ch->dest, fwd ? ch->lid_root : ch->lid_dest);
490 * Notify the root that the destination rejected the channel.
492 * @param ch Rejected channel.
495 send_client_nack (struct MeshChannel *ch)
497 if (NULL == ch->root)
502 GML_send_nack (ch->root, ch->lid_root);
507 * Destroy all reliable messages queued for a channel,
508 * during a channel destruction.
509 * Frees the reliability structure itself.
511 * @param rel Reliability data for a channel.
514 channel_rel_free_all (struct MeshChannelReliability *rel)
516 struct MeshReliableMessage *copy;
517 struct MeshReliableMessage *next;
522 for (copy = rel->head_recv; NULL != copy; copy = next)
525 GNUNET_CONTAINER_DLL_remove (rel->head_recv, rel->tail_recv, copy);
528 for (copy = rel->head_sent; NULL != copy; copy = next)
531 GNUNET_CONTAINER_DLL_remove (rel->head_sent, rel->tail_sent, copy);
534 if (GNUNET_SCHEDULER_NO_TASK != rel->retry_task)
535 GNUNET_SCHEDULER_cancel (rel->retry_task);
541 * Mark future messages as ACK'd.
543 * @param rel Reliability data.
544 * @param msg DataACK message with a bitfield of future ACK'd messages.
547 channel_rel_free_sent (struct MeshChannelReliability *rel,
548 const struct GNUNET_MESH_DataACK *msg)
550 struct MeshReliableMessage *copy;
551 struct MeshReliableMessage *next;
558 bitfield = msg->futures;
559 mid = ntohl (msg->mid);
560 LOG (GNUNET_ERROR_TYPE_DEBUG,
561 "!!! free_sent_reliable %u %llX\n",
563 LOG (GNUNET_ERROR_TYPE_DEBUG,
564 " rel %p, head %p\n",
565 rel, rel->head_sent);
566 for (i = 0, copy = rel->head_sent;
567 i < 64 && NULL != copy && 0 != bitfield;
570 LOG (GNUNET_ERROR_TYPE_DEBUG,
571 " trying bit %u (mid %u)\n",
574 if (0 == (bitfield & mask))
577 LOG (GNUNET_ERROR_TYPE_DEBUG, " set!\n");
578 /* Bit was set, clear the bit from the bitfield */
581 /* The i-th bit was set. Do we have that copy? */
582 /* Skip copies with mid < target */
583 target = mid + i + 1;
584 LOG (GNUNET_ERROR_TYPE_DEBUG, " target %u\n", target);
585 while (NULL != copy && GMC_is_pid_bigger (target, copy->mid))
588 /* Did we run out of copies? (previously freed, it's ok) */
591 LOG (GNUNET_ERROR_TYPE_DEBUG, "run out of copies...\n");
595 /* Did we overshoot the target? (previously freed, it's ok) */
596 if (GMC_is_pid_bigger (copy->mid, target))
598 LOG (GNUNET_ERROR_TYPE_DEBUG, " next copy %u\n", copy->mid);
602 /* Now copy->mid == target, free it */
604 rel_message_free (copy, GNUNET_YES);
607 LOG (GNUNET_ERROR_TYPE_DEBUG, "free_sent_reliable END\n");
612 * We haven't received an ACK after a certain time: restransmit the message.
614 * @param cls Closure (MeshReliableMessage with the message to restransmit)
615 * @param tc TaskContext.
618 channel_retransmit_message (void *cls,
619 const struct GNUNET_SCHEDULER_TaskContext *tc)
621 struct MeshChannelReliability *rel = cls;
622 struct MeshReliableMessage *copy;
623 struct MeshChannel *ch;
624 struct GNUNET_MESH_Data *payload;
627 rel->retry_task = GNUNET_SCHEDULER_NO_TASK;
628 if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
632 copy = rel->head_sent;
639 payload = (struct GNUNET_MESH_Data *) ©[1];
640 fwd = (rel == ch->root_rel);
642 /* Message not found in the queue that we are going to use. */
643 LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! RETRANSMIT %u\n", copy->mid);
645 GMCH_send_prebuilt_message (&payload->header, ch, fwd, GNUNET_YES);
646 GNUNET_STATISTICS_update (stats, "# data retransmitted", 1, GNUNET_NO);
648 copy->timestamp = GNUNET_TIME_absolute_get();
649 rel->retry_timer = GNUNET_TIME_STD_BACKOFF (rel->retry_timer);
650 rel->retry_task = GNUNET_SCHEDULER_add_delayed (rel->retry_timer,
651 &channel_retransmit_message,
657 * Destroy a reliable message after it has been acknowledged, either by
658 * direct mid ACK or bitfield. Updates the appropriate data structures and
659 * timers and frees all memory.
661 * @param copy Message that is no longer needed: remote peer got it.
662 * @param update_time Is the timing information relevant?
663 * If this message is ACK in a batch the timing information
664 * is skewed by the retransmission, count only for the
665 * retransmitted message.
668 rel_message_free (struct MeshReliableMessage *copy, int update_time)
670 struct MeshChannelReliability *rel;
671 struct GNUNET_TIME_Relative time;
674 LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! Freeing %u\n", copy->mid);
677 time = GNUNET_TIME_absolute_get_duration (copy->timestamp);
678 rel->expected_delay.rel_value_us *= 7;
679 rel->expected_delay.rel_value_us += time.rel_value_us;
680 rel->expected_delay.rel_value_us /= 8;
681 LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! took %s\n",
682 GNUNET_STRINGS_relative_time_to_string (time, GNUNET_NO));
683 LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! new expected delay %s\n",
684 GNUNET_STRINGS_relative_time_to_string (rel->expected_delay,
686 rel->retry_timer = rel->expected_delay;
690 LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! batch free, ignoring timing\n");
692 GNUNET_CONTAINER_DLL_remove (rel->head_sent, rel->tail_sent, copy);
698 * Confirm we got a channel create.
700 * @param ch The channel to confirm.
701 * @param fwd Should we send a FWD ACK? (going dest->root)
704 channel_send_ack (struct MeshChannel *ch, int fwd)
706 struct GNUNET_MESH_ChannelManage msg;
708 msg.header.size = htons (sizeof (msg));
709 msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_CHANNEL_ACK);
710 LOG (GNUNET_ERROR_TYPE_DEBUG,
711 " sending channel %s ack for channel %s\n",
712 fwd ? "FWD" : "BCK", GMCH_2s (ch));
714 msg.chid = htonl (ch->gid);
715 GMCH_send_prebuilt_message (&msg.header, ch, !fwd, GNUNET_NO);
720 * Notify that a channel create didn't succeed.
722 * @param ch The channel to reject.
725 channel_send_nack (struct MeshChannel *ch)
727 struct GNUNET_MESH_ChannelManage msg;
729 msg.header.size = htons (sizeof (msg));
730 msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_CHANNEL_NACK);
731 LOG (GNUNET_ERROR_TYPE_DEBUG,
732 " sending channel NACK for channel %s\n",
735 msg.chid = htonl (ch->gid);
736 GMCH_send_prebuilt_message (&msg.header, ch, GNUNET_NO, GNUNET_NO);
741 * Channel was ACK'd by remote peer, mark as ready and cancel retransmission.
743 * @param ch Channel to mark as ready.
744 * @param fwd Was the ACK message a FWD ACK? (dest->root, SYNACK)
747 channel_confirm (struct MeshChannel *ch, int fwd)
749 struct MeshChannelReliability *rel;
750 struct MeshReliableMessage *copy;
751 struct MeshReliableMessage *next;
753 LOG (GNUNET_ERROR_TYPE_DEBUG,
754 " channel confirm %s %s:%X\n",
755 fwd ? "FWD" : "BCK", GMT_2s (ch->t), ch->gid);
756 ch->state = MESH_CHANNEL_READY;
758 rel = fwd ? ch->root_rel : ch->dest_rel;
759 rel->client_ready = GNUNET_YES;
760 for (copy = rel->head_sent; NULL != copy; copy = next)
762 struct GNUNET_MessageHeader *msg;
765 msg = (struct GNUNET_MessageHeader *) ©[1];
766 if (ntohs (msg->type) == GNUNET_MESSAGE_TYPE_MESH_CHANNEL_CREATE)
768 rel_message_free (copy, GNUNET_YES);
772 send_client_ack (ch, fwd);
774 /* In case of a FWD ACK (SYNACK) send a BCK ACK (ACK). */
776 channel_send_ack (ch, !fwd);
781 * Message has been sent: start retransmission timer.
783 * @param cls Closure (copy sent).
785 * @param q Queue handler (no longer valid).
786 * @param type Type of message.
787 * @param size Size of the message.
790 message_sent (void *cls,
791 struct MeshTunnel3 *t,
792 struct MeshTunnel3Queue *q,
793 uint16_t type, size_t size)
795 struct MeshReliableMessage *copy = cls;
796 struct MeshChannelReliability *rel = copy->rel;
798 copy->timestamp = GNUNET_TIME_absolute_get ();
799 if (GNUNET_SCHEDULER_NO_TASK == rel->retry_task)
802 GNUNET_TIME_relative_multiply (rel->expected_delay,
803 MESH_RETRANSMIT_MARGIN);
805 GNUNET_SCHEDULER_add_delayed (rel->retry_timer,
806 &channel_retransmit_message,
813 * Save a copy to retransmit in case it gets lost.
815 * Initializes all needed callbacks and timers.
817 * @param ch Channel this message goes on.
818 * @param msg Message to copy.
819 * @param fwd Is this fwd traffic?
821 static struct MeshReliableMessage *
822 channel_save_copy (struct MeshChannel *ch,
823 const struct GNUNET_MessageHeader *msg,
826 struct MeshChannelReliability *rel;
827 struct MeshReliableMessage *copy;
832 rel = fwd ? ch->root_rel : ch->dest_rel;
833 mid = rel->mid_send - 1;
834 type = ntohs (msg->type);
835 size = ntohs (msg->size);
837 LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! SAVE %u %s\n",
838 mid, GNUNET_MESH_DEBUG_M2S (type));
839 copy = GNUNET_malloc (sizeof (struct MeshReliableMessage) + size);
843 memcpy (©[1], msg, size);
844 GNUNET_CONTAINER_DLL_insert_tail (rel->head_sent, rel->tail_sent, copy);
851 * Create a new channel.
853 * @param t Tunnel this channel is in.
854 * @param owner Client that owns the channel, NULL for foreign channels.
855 * @param lid_root Local ID for root client.
857 * @return A new initialized channel. NULL on error.
859 static struct MeshChannel *
860 channel_new (struct MeshTunnel3 *t,
861 struct MeshClient *owner,
862 MESH_ChannelNumber lid_root)
864 struct MeshChannel *ch;
866 ch = GNUNET_new (struct MeshChannel);
868 ch->lid_root = lid_root;
871 GNUNET_STATISTICS_update (stats, "# channels", 1, GNUNET_NO);
875 ch->gid = GMT_get_next_chid (t);
876 GML_channel_add (owner, lid_root, ch);
878 GMT_add_channel (t, ch);
885 * Set options in a channel, extracted from a bit flag field
887 * @param ch Channel to set options to.
888 * @param options Bit array in host byte order.
891 channel_set_options (struct MeshChannel *ch, uint32_t options)
893 ch->nobuffer = (options & GNUNET_MESH_OPTION_NOBUFFER) != 0 ?
894 GNUNET_YES : GNUNET_NO;
895 ch->reliable = (options & GNUNET_MESH_OPTION_RELIABLE) != 0 ?
896 GNUNET_YES : GNUNET_NO;
900 is_loopback (const struct MeshChannel *ch)
903 return GMT_is_loopback (ch->t);
905 return (NULL != ch->root && NULL != ch->dest);
910 * Handle a loopback message: call the appropriate handler for the message type.
912 * @param ch Channel this message is on.
913 * @param msgh Message header.
914 * @param fwd Is this FWD traffic?
917 handle_loopback (struct MeshChannel *ch,
918 const struct GNUNET_MessageHeader *msgh,
923 type = ntohs (msgh->type);
924 LOG (GNUNET_ERROR_TYPE_DEBUG,
925 "Loopback %s %s message!\n",
926 fwd ? "FWD" : "BCK", GNUNET_MESH_DEBUG_M2S (type));
930 case GNUNET_MESSAGE_TYPE_MESH_DATA:
931 /* Don't send hop ACK, wait for client to ACK */
932 GMCH_handle_data (ch, (struct GNUNET_MESH_Data *) msgh, fwd);
935 case GNUNET_MESSAGE_TYPE_MESH_DATA_ACK:
936 GMCH_handle_data_ack (ch, (struct GNUNET_MESH_DataACK *) msgh, fwd);
939 case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_CREATE:
940 GMCH_handle_create (ch->t,
941 (struct GNUNET_MESH_ChannelCreate *) msgh);
944 case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_ACK:
946 (struct GNUNET_MESH_ChannelManage *) msgh,
950 case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_NACK:
951 GMCH_handle_nack (ch);
954 case GNUNET_MESSAGE_TYPE_MESH_CHANNEL_DESTROY:
955 GMCH_handle_destroy (ch,
956 (struct GNUNET_MESH_ChannelManage *) msgh,
962 LOG (GNUNET_ERROR_TYPE_DEBUG,
963 "end-to-end message not known (%u)\n",
970 /******************************************************************************/
971 /******************************** API ***********************************/
972 /******************************************************************************/
976 * Destroy a channel and free all resources.
978 * @param ch Channel to destroy.
981 GMCH_destroy (struct MeshChannel *ch);
984 * Destroy a channel and free all resources.
986 * @param ch Channel to destroy.
989 GMCH_destroy (struct MeshChannel *ch)
991 struct MeshClient *c;
996 LOG (GNUNET_ERROR_TYPE_DEBUG, "destroying channel %s:%u\n",
997 GMT_2s (ch->t), ch->gid);
1003 GML_channel_remove (c, ch->lid_root, ch);
1009 GML_channel_remove (c, ch->lid_dest, ch);
1012 channel_rel_free_all (ch->root_rel);
1013 channel_rel_free_all (ch->dest_rel);
1015 GMT_remove_channel (ch->t, ch);
1016 GNUNET_STATISTICS_update (stats, "# channels", -1, GNUNET_NO);
1025 * @param ch Channel.
1030 GMCH_get_id (const struct MeshChannel *ch)
1037 * Get the channel tunnel.
1039 * @param ch Channel to get the tunnel from.
1041 * @return tunnel of the channel.
1043 struct MeshTunnel3 *
1044 GMCH_get_tunnel (const struct MeshChannel *ch)
1051 * Get free buffer space towards the client on a specific channel.
1053 * @param ch Channel.
1054 * @param fwd Is query about FWD traffic?
1056 * @return Free buffer space [0 - 64]
1059 GMCH_get_buffer (struct MeshChannel *ch, int fwd)
1061 struct MeshChannelReliability *rel;
1063 rel = fwd ? ch->dest_rel : ch->root_rel;
1065 /* If rel is NULL it means that the end is not yet created,
1066 * most probably is a loopback channel at the point of sending
1067 * the ChannelCreate to itself.
1072 return (64 - rel->n_recv);
1077 * Get flow control status of end point: is client allow to send?
1079 * @param ch Channel.
1080 * @param fwd Is query about FWD traffic? (Request root status).
1082 * @return #GNUNET_YES if client is allowed to send us data.
1085 GMCH_get_allowed (struct MeshChannel *ch, int fwd)
1087 struct MeshChannelReliability *rel;
1089 rel = fwd ? ch->root_rel : ch->dest_rel;
1091 return rel->client_allowed;
1096 * Is the root client for this channel on this peer?
1098 * @param ch Channel.
1099 * @param fwd Is this for fwd traffic?
1101 * @return #GNUNET_YES in case it is.
1104 GMCH_is_origin (struct MeshChannel *ch, int fwd)
1106 struct MeshClient *c;
1108 c = fwd ? ch->root : ch->dest;
1114 * Is the destination client for this channel on this peer?
1116 * @param ch Channel.
1117 * @param fwd Is this for fwd traffic?
1119 * @return #GNUNET_YES in case it is.
1122 GMCH_is_terminal (struct MeshChannel *ch, int fwd)
1124 struct MeshClient *c;
1126 c = fwd ? ch->dest : ch->root;
1132 * Notify the destination client that a new incoming channel was created.
1134 * @param ch Channel that was created.
1137 GMCH_send_create (struct MeshChannel *ch)
1141 if (NULL == ch->dest)
1145 opt |= GNUNET_YES == ch->reliable ? GNUNET_MESH_OPTION_RELIABLE : 0;
1146 opt |= GNUNET_YES == ch->nobuffer ? GNUNET_MESH_OPTION_NOBUFFER : 0;
1147 GML_send_channel_create (ch->dest, ch->lid_dest, ch->port, opt,
1148 GMT_get_destination (ch->t));
1153 * Notify a client that the channel is no longer valid.
1155 * @param ch Channel that is destroyed.
1158 GMCH_send_destroy (struct MeshChannel *ch)
1160 struct GNUNET_MESH_ChannelManage msg;
1162 msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_CHANNEL_DESTROY);
1163 msg.header.size = htons (sizeof (msg));
1164 msg.chid = htonl (ch->gid);
1166 /* If root is not NULL, notify.
1167 * If it's NULL, check lid_root. When a local destroy comes in, root
1168 * is set to NULL but lid_root is left untouched. In this case, do nothing,
1169 * the client is the one who reuqested the channel to be destroyed.
1171 if (NULL != ch->root)
1172 GML_send_channel_destroy (ch->root, ch->lid_root);
1173 else if (0 == ch->lid_root)
1174 GMCH_send_prebuilt_message (&msg.header, ch, GNUNET_NO, GNUNET_NO);
1176 if (NULL != ch->dest)
1177 GML_send_channel_destroy (ch->dest, ch->lid_dest);
1178 else if (0 == ch->lid_dest)
1179 GMCH_send_prebuilt_message (&msg.header, ch, GNUNET_YES, GNUNET_NO);
1184 * Send an end-to-end ACK message for the most recent in-sequence payload.
1186 * If channel is not reliable, do nothing.
1188 * @param ch Channel this is about.
1189 * @param fwd Is for FWD traffic? (ACK dest->owner)
1192 GMCH_send_data_ack (struct MeshChannel *ch, int fwd)
1194 struct GNUNET_MESH_DataACK msg;
1195 struct MeshChannelReliability *rel;
1196 struct MeshReliableMessage *copy;
1201 if (GNUNET_NO == ch->reliable)
1205 rel = fwd ? ch->dest_rel : ch->root_rel;
1206 ack = rel->mid_recv - 1;
1207 LOG (GNUNET_ERROR_TYPE_DEBUG,
1208 " !! Send DATA_ACK for %u\n",
1211 msg.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_DATA_ACK);
1212 msg.header.size = htons (sizeof (msg));
1213 msg.chid = htonl (ch->gid);
1215 for (copy = rel->head_recv; NULL != copy; copy = copy->next)
1217 if (copy->type != GNUNET_MESSAGE_TYPE_MESH_DATA)
1219 LOG (GNUNET_ERROR_TYPE_DEBUG,
1220 "!! Type %s, expected DATA\n",
1221 GNUNET_MESH_DEBUG_M2S (copy->type));
1224 if (copy->mid == ack + 1)
1229 delta = copy->mid - (ack + 1);
1232 mask = 0x1LL << delta;
1233 msg.futures |= mask;
1234 LOG (GNUNET_ERROR_TYPE_DEBUG,
1235 " !! setting bit for %u (delta %u) (%llX) -> %llX\n",
1236 copy->mid, delta, mask, msg.futures);
1238 msg.mid = htonl (ack);
1239 LOG (GNUNET_ERROR_TYPE_DEBUG,
1240 "!!! ACK for %u, futures %llX\n",
1243 GMCH_send_prebuilt_message (&msg.header, ch, !fwd, GNUNET_NO);
1244 LOG (GNUNET_ERROR_TYPE_DEBUG, "send_data_ack END\n");
1249 * Allow a client to send us more data, in case it was choked.
1251 * @param ch Channel.
1252 * @param fwd Is this about FWD traffic? (Root client).
1255 GMCH_allow_client (struct MeshChannel *ch, int fwd)
1257 struct MeshChannelReliability *rel;
1258 unsigned int buffer;
1260 LOG (GNUNET_ERROR_TYPE_DEBUG, "GMCH allow\n");
1262 if (MESH_CHANNEL_READY != ch->state)
1264 LOG (GNUNET_ERROR_TYPE_DEBUG, " channel not ready yet!\n");
1268 if (GNUNET_YES == ch->reliable)
1270 rel = fwd ? ch->root_rel : ch->dest_rel;
1276 if (NULL != rel->head_sent && 64 <= rel->mid_send - rel->head_sent->mid)
1278 LOG (GNUNET_ERROR_TYPE_DEBUG, " too big MID gap! Wait for ACK.\n");
1283 if (is_loopback (ch))
1284 buffer = GMCH_get_buffer (ch, fwd);
1286 buffer = GMT_get_connections_buffer (ch->t);
1290 LOG (GNUNET_ERROR_TYPE_DEBUG, " no buffer space.\n");
1294 LOG (GNUNET_ERROR_TYPE_DEBUG, " buffer space %u, allowing\n", buffer);
1295 send_client_ack (ch, fwd);
1302 * @param ch Channel.
1305 GMCH_debug (struct MeshChannel *ch)
1309 LOG (GNUNET_ERROR_TYPE_DEBUG, "*** DEBUG NULL CHANNEL ***\n");
1312 LOG (GNUNET_ERROR_TYPE_DEBUG, "Channel %s:%X (%p)\n",
1313 GMT_2s (ch->t), ch->gid, ch);
1314 LOG (GNUNET_ERROR_TYPE_DEBUG, " root %p/%p\n",
1315 ch->root, ch->root_rel);
1316 if (NULL != ch->root)
1318 LOG (GNUNET_ERROR_TYPE_DEBUG, " cli %s\n", GML_2s (ch->root));
1319 LOG (GNUNET_ERROR_TYPE_DEBUG, " ready %s\n",
1320 ch->root_rel->client_ready ? "YES" : "NO");
1321 LOG (GNUNET_ERROR_TYPE_DEBUG, " id %X\n", ch->lid_root);
1323 LOG (GNUNET_ERROR_TYPE_DEBUG, " dest %p/%p\n",
1324 ch->dest, ch->dest_rel);
1325 if (NULL != ch->dest)
1327 LOG (GNUNET_ERROR_TYPE_DEBUG, " cli %s\n", GML_2s (ch->dest));
1328 LOG (GNUNET_ERROR_TYPE_DEBUG, " ready %s\n",
1329 ch->dest_rel->client_ready ? "YES" : "NO");
1330 LOG (GNUNET_ERROR_TYPE_DEBUG, " id %X\n", ch->lid_dest);
1336 * Handle an ACK given by a client.
1338 * Mark client as ready and send him any buffered data we could have for him.
1340 * @param ch Channel.
1341 * @param fwd Is this a "FWD ACK"? (FWD ACKs are sent by dest and go BCK)
1344 GMCH_handle_local_ack (struct MeshChannel *ch, int fwd)
1346 struct MeshChannelReliability *rel;
1347 struct MeshClient *c;
1349 rel = fwd ? ch->dest_rel : ch->root_rel;
1350 c = fwd ? ch->dest : ch->root;
1352 rel->client_ready = GNUNET_YES;
1353 send_client_buffered_data (ch, c, fwd);
1354 if (is_loopback (ch))
1356 unsigned int buffer;
1358 buffer = GMCH_get_buffer (ch, fwd);
1360 GMCH_allow_client (ch, fwd);
1364 GMT_send_connection_acks (ch->t);
1369 * Handle data given by a client.
1371 * Check whether the client is allowed to send in this tunnel, save if channel
1372 * is reliable and send an ACK to the client if there is still buffer space
1375 * @param ch Channel.
1376 * @param c Client which sent the data.
1377 * @param message Message.
1378 * @param fwd Is this a FWD data?
1380 * @return GNUNET_OK if everything goes well, GNUNET_SYSERR in case of en error.
1383 GMCH_handle_local_data (struct MeshChannel *ch,
1384 struct MeshClient *c,
1385 struct GNUNET_MessageHeader *message,
1388 struct MeshChannelReliability *rel;
1389 struct GNUNET_MESH_Data *payload;
1390 size_t size = ntohs (message->size);
1391 uint16_t p2p_size = sizeof(struct GNUNET_MESH_Data) + size;
1392 unsigned char cbuf[p2p_size];
1394 /* Is the client in the channel? */
1401 GNUNET_break_op (0);
1402 return GNUNET_SYSERR;
1405 rel = fwd ? ch->root_rel : ch->dest_rel;
1407 if (GNUNET_NO == rel->client_allowed)
1409 GNUNET_break_op (0);
1410 return GNUNET_SYSERR;
1413 rel->client_allowed = GNUNET_NO;
1415 /* Ok, everything is correct, send the message. */
1416 payload = (struct GNUNET_MESH_Data *) cbuf;
1417 payload->mid = htonl (rel->mid_send);
1419 memcpy (&payload[1], message, size);
1420 payload->header.size = htons (p2p_size);
1421 payload->header.type = htons (GNUNET_MESSAGE_TYPE_MESH_DATA);
1422 payload->chid = htonl (ch->gid);
1423 LOG (GNUNET_ERROR_TYPE_DEBUG, " sending on channel...\n");
1424 GMCH_send_prebuilt_message (&payload->header, ch, fwd, GNUNET_NO);
1426 if (is_loopback (ch))
1428 if (GMCH_get_buffer (ch, fwd) > 0)
1429 send_client_ack (ch, fwd);
1434 if (GMT_get_connections_buffer (ch->t) > 0)
1436 send_client_ack (ch, fwd);
1444 * Handle a channel destroy requested by a client.
1446 * Destroy the channel and the tunnel in case this was the last channel.
1448 * @param ch Channel.
1449 * @param c Client that requested the destruction (to avoid notifying him).
1452 GMCH_handle_local_destroy (struct MeshChannel *ch,
1453 struct MeshClient *c)
1455 struct MeshTunnel3 *t;
1457 /* Cleanup after the tunnel */
1460 LOG (GNUNET_ERROR_TYPE_DEBUG, " Client %s is destination.\n", GML_2s (c));
1461 GML_client_delete_channel (c, ch, ch->lid_dest);
1466 LOG (GNUNET_ERROR_TYPE_DEBUG, " Client %s is owner.\n", GML_2s (c));
1467 GML_client_delete_channel (c, ch, ch->lid_root);
1472 GMCH_send_destroy (ch);
1474 GMT_destroy_if_empty (t);
1479 * Handle a channel create requested by a client.
1481 * Create the channel and the tunnel in case this was the first0 channel.
1483 * @param c Client that requested the creation (will be the root).
1484 * @param msg Create Channel message.
1486 * @return GNUNET_OK if everything went fine, GNUNET_SYSERR otherwise.
1489 GMCH_handle_local_create (struct MeshClient *c,
1490 struct GNUNET_MESH_ChannelMessage *msg)
1492 struct MeshChannel *ch;
1493 struct MeshTunnel3 *t;
1494 struct MeshPeer *peer;
1495 MESH_ChannelNumber chid;
1497 LOG (GNUNET_ERROR_TYPE_DEBUG, " towards %s:%u\n",
1498 GNUNET_i2s (&msg->peer), ntohl (msg->port));
1499 chid = ntohl (msg->channel_id);
1501 /* Sanity check for duplicate channel IDs */
1502 if (NULL != GML_channel_get (c, chid))
1505 return GNUNET_SYSERR;
1508 peer = GMP_get (&msg->peer);
1509 GMP_add_tunnel (peer);
1510 t = GMP_get_tunnel (peer);
1512 if (GMP_get_short_id (peer) == myid)
1514 GMT_change_state (t, MESH_TUNNEL3_READY);
1521 /* Create channel */
1522 ch = channel_new (t, c, chid);
1526 return GNUNET_SYSERR;
1528 ch->port = ntohl (msg->port);
1529 channel_set_options (ch, ntohl (msg->opt));
1531 /* In unreliable channels, we'll use the DLL to buffer BCK data */
1532 ch->root_rel = GNUNET_new (struct MeshChannelReliability);
1533 ch->root_rel->ch = ch;
1534 ch->root_rel->expected_delay = MESH_RETRANSMIT_TIME;
1536 LOG (GNUNET_ERROR_TYPE_DEBUG, "CREATED CHANNEL %s\n", GMCH_2s (ch));
1538 /* Send create channel */
1540 struct GNUNET_MESH_ChannelCreate msgcc;
1542 msgcc.header.size = htons (sizeof (msgcc));
1543 msgcc.header.type = htons (GNUNET_MESSAGE_TYPE_MESH_CHANNEL_CREATE);
1544 msgcc.chid = htonl (ch->gid);
1545 msgcc.port = msg->port;
1546 msgcc.opt = msg->opt;
1548 GMT_send_prebuilt_message (&msgcc.header, t, ch, GNUNET_YES, NULL, NULL);
1555 * Handler for mesh network payload traffic.
1557 * @param ch Channel for the message.
1558 * @param msg Unencryted data message.
1559 * @param fwd Is this message fwd? This only is meaningful in loopback channels.
1560 * #GNUNET_YES if message is FWD on the respective channel (loopback)
1561 * #GNUNET_NO if message is BCK on the respective channel (loopback)
1562 * #GNUNET_SYSERR if message on a one-ended channel (remote)
1565 GMCH_handle_data (struct MeshChannel *ch,
1566 const struct GNUNET_MESH_Data *msg,
1569 struct MeshChannelReliability *rel;
1570 struct MeshClient *c;
1573 /* If this is a remote (non-loopback) channel, find 'fwd'. */
1574 if (GNUNET_SYSERR == fwd)
1576 if (is_loopback (ch))
1578 /* It is a loopback channel after all... */
1582 fwd = (NULL != ch->dest) ? GNUNET_YES : GNUNET_NO;
1585 /* Initialize FWD/BCK data */
1586 c = fwd ? ch->dest : ch->root;
1587 rel = fwd ? ch->dest_rel : ch->root_rel;
1595 GNUNET_STATISTICS_update (stats, "# data received", 1, GNUNET_NO);
1597 mid = ntohl (msg->mid);
1598 LOG (GNUNET_ERROR_TYPE_DEBUG, "!! got mid %u\n", mid);
1600 if (GNUNET_NO == ch->reliable ||
1601 ( !GMC_is_pid_bigger (rel->mid_recv, mid) &&
1602 GMC_is_pid_bigger (rel->mid_recv + 64, mid) ) )
1604 LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! RECV %u\n", mid);
1605 if (GNUNET_YES == ch->reliable)
1607 /* Is this the exact next expected messasge? */
1608 if (mid == rel->mid_recv)
1610 LOG (GNUNET_ERROR_TYPE_DEBUG, "as expected\n");
1612 send_client_data (ch, msg, fwd);
1616 LOG (GNUNET_ERROR_TYPE_DEBUG, "save for later\n");
1617 add_buffered_data (msg, rel);
1622 /* Tunnel is unreliable: send to clients directly */
1623 /* FIXME: accept Out Of Order traffic */
1624 rel->mid_recv = mid + 1;
1625 send_client_data (ch, msg, fwd);
1630 GNUNET_break_op (0);
1631 LOG (GNUNET_ERROR_TYPE_DEBUG,
1632 " MID %u not expected (%u - %u), dropping!\n",
1633 mid, rel->mid_recv, rel->mid_recv + 63);
1636 GMCH_send_data_ack (ch, fwd);
1641 * Handler for mesh network traffic end-to-end ACKs.
1643 * @param ch Channel on which we got this message.
1644 * @param msg Data message.
1645 * @param fwd Is this message fwd? This only is meaningful in loopback channels.
1646 * #GNUNET_YES if message is FWD on the respective channel (loopback)
1647 * #GNUNET_NO if message is BCK on the respective channel (loopback)
1648 * #GNUNET_SYSERR if message on a one-ended channel (remote)
1651 GMCH_handle_data_ack (struct MeshChannel *ch,
1652 const struct GNUNET_MESH_DataACK *msg,
1655 struct MeshChannelReliability *rel;
1656 struct MeshReliableMessage *copy;
1657 struct MeshReliableMessage *next;
1661 /* If this is a remote (non-loopback) channel, find 'fwd'. */
1662 if (GNUNET_SYSERR == fwd)
1664 if (is_loopback (ch))
1666 /* It is a loopback channel after all... */
1670 /* Inverted: if message came 'FWD' is a 'BCK ACK'. */
1671 fwd = (NULL != ch->dest) ? GNUNET_NO : GNUNET_YES;
1674 ack = ntohl (msg->mid);
1675 LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! %s ACK %u\n",
1676 (GNUNET_YES == fwd) ? "FWD" : "BCK", ack);
1678 if (GNUNET_YES == fwd)
1688 GNUNET_break_op (0);
1692 /* Free ACK'd copies: no need to retransmit those anymore */
1693 for (work = GNUNET_NO, copy = rel->head_sent; copy != NULL; copy = next)
1695 if (GMC_is_pid_bigger (copy->mid, ack))
1697 LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! head %u, out!\n", copy->mid);
1698 channel_rel_free_sent (rel, msg);
1702 LOG (GNUNET_ERROR_TYPE_DEBUG, " !! id %u\n", copy->mid);
1704 rel_message_free (copy, GNUNET_YES);
1707 /* ACK client if needed */
1708 GMCH_allow_client (ch, fwd);
1710 /* If some message was free'd, update the retransmission delay */
1711 if (GNUNET_YES == work)
1713 if (GNUNET_SCHEDULER_NO_TASK != rel->retry_task)
1715 GNUNET_SCHEDULER_cancel (rel->retry_task);
1716 if (NULL == rel->head_sent)
1718 rel->retry_task = GNUNET_SCHEDULER_NO_TASK;
1722 struct GNUNET_TIME_Absolute new_target;
1723 struct GNUNET_TIME_Relative delay;
1725 delay = GNUNET_TIME_relative_multiply (rel->retry_timer,
1726 MESH_RETRANSMIT_MARGIN);
1727 new_target = GNUNET_TIME_absolute_add (rel->head_sent->timestamp,
1729 delay = GNUNET_TIME_absolute_get_remaining (new_target);
1731 GNUNET_SCHEDULER_add_delayed (delay,
1732 &channel_retransmit_message,
1743 * Handler for channel create messages.
1745 * Does not have fwd parameter because it's always 'FWD': channel is incoming.
1747 * @param t Tunnel this channel will be in.
1748 * @param msg Channel crate message.
1750 struct MeshChannel *
1751 GMCH_handle_create (struct MeshTunnel3 *t,
1752 const struct GNUNET_MESH_ChannelCreate *msg)
1754 MESH_ChannelNumber chid;
1755 struct MeshChannel *ch;
1756 struct MeshClient *c;
1759 chid = ntohl (msg->chid);
1761 ch = GMT_get_channel (t, chid);
1764 /* Create channel */
1765 ch = channel_new (t, NULL, 0);
1768 channel_set_options (ch, ntohl (msg->opt));
1770 /* Find a destination client */
1771 port = ntohl (msg->port);
1772 LOG (GNUNET_ERROR_TYPE_DEBUG, " port %u\n", port);
1773 c = GML_client_get_by_port (port);
1776 /* TODO send reject */
1777 LOG (GNUNET_ERROR_TYPE_DEBUG, " no client has port registered\n");
1778 if (is_loopback (ch))
1780 LOG (GNUNET_ERROR_TYPE_DEBUG, " loopback: destroy on handler\n");
1781 channel_send_nack (ch);
1785 LOG (GNUNET_ERROR_TYPE_DEBUG, " not loopback: destroy now\n");
1786 channel_send_nack (ch);
1793 LOG (GNUNET_ERROR_TYPE_DEBUG, " client %p has port registered\n", c);
1796 add_destination (ch, c);
1797 if (GNUNET_YES == ch->reliable)
1798 LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! Reliable\n");
1800 LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! Not Reliable\n");
1802 GMCH_send_create (ch);
1803 channel_send_ack (ch, GNUNET_YES);
1810 * Handler for channel NACK messages.
1812 * NACK messages always go dest -> root, no need for 'fwd' or 'msg' parameter.
1814 * @param ch Channel.
1817 GMCH_handle_nack (struct MeshChannel *ch)
1819 send_client_nack (ch);
1825 * Handler for channel ack messages.
1827 * @param ch Channel.
1828 * @param msg Message.
1829 * @param fwd Is this message fwd? This only is meaningful in loopback channels.
1830 * #GNUNET_YES if message is FWD on the respective channel (loopback)
1831 * #GNUNET_NO if message is BCK on the respective channel (loopback)
1832 * #GNUNET_SYSERR if message on a one-ended channel (remote)
1835 GMCH_handle_ack (struct MeshChannel *ch,
1836 const struct GNUNET_MESH_ChannelManage *msg,
1839 /* If this is a remote (non-loopback) channel, find 'fwd'. */
1840 if (GNUNET_SYSERR == fwd)
1842 if (is_loopback (ch))
1844 /* It is a loopback channel after all... */
1848 fwd = (NULL != ch->dest) ? GNUNET_YES : GNUNET_NO;
1851 channel_confirm (ch, !fwd);
1856 * Handler for channel destroy messages.
1858 * @param ch Channel to be destroyed of.
1859 * @param msg Message.
1860 * @param fwd Is this message fwd? This only is meaningful in loopback channels.
1861 * #GNUNET_YES if message is FWD on the respective channel (loopback)
1862 * #GNUNET_NO if message is BCK on the respective channel (loopback)
1863 * #GNUNET_SYSERR if message on a one-ended channel (remote)
1866 GMCH_handle_destroy (struct MeshChannel *ch,
1867 const struct GNUNET_MESH_ChannelManage *msg,
1870 struct MeshTunnel3 *t;
1872 /* If this is a remote (non-loopback) channel, find 'fwd'. */
1873 if (GNUNET_SYSERR == fwd)
1875 if (is_loopback (ch))
1877 /* It is a loopback channel after all... */
1881 fwd = (NULL != ch->dest) ? GNUNET_YES : GNUNET_NO;
1885 if ( (fwd && NULL == ch->dest) || (!fwd && NULL == ch->root) )
1887 /* Not for us (don't destroy twice a half-open loopback channel) */
1892 GMCH_send_destroy (ch);
1894 GMT_destroy_if_empty (t);
1899 * Sends an already built message on a channel.
1901 * If the channel is on a loopback tunnel, notifies the appropriate destination
1904 * On a normal channel passes the message to the tunnel for encryption and
1905 * sending on a connection.
1907 * This function DOES NOT save the message for retransmission.
1909 * @param message Message to send. Function makes a copy of it.
1910 * @param ch Channel on which this message is transmitted.
1911 * @param fwd Is this a fwd message?
1912 * @param retransmission Is this a retransmission? (Don't save a copy)
1915 GMCH_send_prebuilt_message (const struct GNUNET_MessageHeader *message,
1916 struct MeshChannel *ch, int fwd,
1919 LOG (GNUNET_ERROR_TYPE_DEBUG, "GMCH Send %s %s on channel %s\n",
1920 fwd ? "FWD" : "BCK", GNUNET_MESH_DEBUG_M2S (ntohs (message->type)),
1923 if (GMT_is_loopback (ch->t))
1925 handle_loopback (ch, message, fwd);
1929 if (GNUNET_YES == ch->reliable && GNUNET_NO == retransmission
1930 && ntohs (message->type) == GNUNET_MESSAGE_TYPE_MESH_DATA)
1932 struct MeshReliableMessage *copy;
1934 copy = channel_save_copy (ch, message, fwd);
1935 copy->q = GMT_send_prebuilt_message (message, ch->t, ch, fwd,
1936 &message_sent, copy);
1939 GMT_send_prebuilt_message (message, ch->t, ch, fwd, NULL, NULL);
1944 * Get the static string for identification of the channel.
1946 * @param ch Channel.
1948 * @return Static string with the channel IDs.
1951 GMCH_2s (const struct MeshChannel *ch)
1953 static char buf[64];
1956 return "(NULL Channel)";
1958 sprintf (buf, "%s:%X (%X / %X)",
1959 GMT_2s (ch->t), ch->gid, ch->lid_root, ch->lid_dest);