src/cadet/gnunet-service-cadet_channel.c

   1 /*
   2      This file is part of GNUnet.
   3      (C) 2013 Christian Grothoff (and other contributing authors)
   4
   5      GNUnet is free software; you can redistribute it and/or modify
   6      it under the terms of the GNU General Public License as published
   7      by the Free Software Foundation; either version 3, or (at your
   8      option) any later version.
   9
  10      GNUnet is distributed in the hope that it will be useful, but
  11      WITHOUT ANY WARRANTY; without even the implied warranty of
  12      MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  13      General Public License for more details.
  14
  15      You should have received a copy of the GNU General Public License
  16      along with GNUnet; see the file COPYING.  If not, write to the
  17      Free Software Foundation, Inc., 59 Temple Place - Suite 330,
  18      Boston, MA 02111-1307, USA.
  19 */
  20
  21
  22 #include "platform.h"
  23 #include "gnunet_util_lib.h"
  24
  25 #include "gnunet_statistics_service.h"
  26
  27 #include "cadet.h"
  28 #include "cadet_protocol.h"
  29
  30 #include "gnunet-service-cadet_channel.h"
  31 #include "gnunet-service-cadet_local.h"
  32 #include "gnunet-service-cadet_tunnel.h"
  33 #include "gnunet-service-cadet_peer.h"
  34
  35 #define LOG(level, ...) GNUNET_log_from(level,"cadet-chn",__VA_ARGS__)
  36
  37 #define CADET_RETRANSMIT_TIME    GNUNET_TIME_relative_multiply(\
  38                                     GNUNET_TIME_UNIT_MILLISECONDS, 250)
  39 #define CADET_RETRANSMIT_MARGIN  4
  40
  41
  42 /**
  43  * All the states a connection can be in.
  44  */
  45 enum CadetChannelState
  46 {
  47   /**
  48    * Uninitialized status, should never appear in operation.
  49    */
  50   CADET_CHANNEL_NEW,
  51
  52   /**
  53    * Connection create message sent, waiting for ACK.
  54    */
  55   CADET_CHANNEL_SENT,
  56
  57   /**
  58    * Connection confirmed, ready to carry traffic.
  59    */
  60   CADET_CHANNEL_READY,
  61 };
  62
  63
  64 /**
  65  * Info holder for channel messages in queues.
  66  */
  67 struct CadetChannelQueue
  68 {
  69   /**
  70    * Tunnel Queue.
  71    */
  72   struct CadetTunnelQueue *tq;
  73
  74   /**
  75    * Message type (DATA/DATA_ACK)
  76    */
  77   uint16_t type;
  78
  79   /**
  80    * Message copy (for DATAs, to start retransmission timer)
  81    */
  82   struct CadetReliableMessage *copy;
  83
  84   /**
  85    * Reliability (for DATA_ACKs, to access rel->ack_q)
  86    */
  87   struct CadetChannelReliability *rel;
  88 };
  89
  90
  91 /**
  92  * Info needed to retry a message in case it gets lost.
  93  */
  94 struct CadetReliableMessage
  95 {
  96     /**
  97      * Double linked list, FIFO style
  98      */
  99   struct CadetReliableMessage    *next;
 100   struct CadetReliableMessage    *prev;
 101
 102     /**
 103      * Type of message (payload, channel management).
 104      */
 105   int16_t type;
 106
 107     /**
 108      * Tunnel Reliability queue this message is in.
 109      */
 110   struct CadetChannelReliability  *rel;
 111
 112     /**
 113      * ID of the message (ACK needed to free)
 114      */
 115   uint32_t                      mid;
 116
 117   /**
 118    * Tunnel Queue.
 119    */
 120   struct CadetChannelQueue       *chq;
 121
 122     /**
 123      * When was this message issued (to calculate ACK delay)
 124      */
 125   struct GNUNET_TIME_Absolute   timestamp;
 126
 127   /* struct GNUNET_CADET_Data with payload */
 128 };
 129
 130
 131 /**
 132  * Info about the traffic state for a client in a channel.
 133  */
 134 struct CadetChannelReliability
 135 {
 136     /**
 137      * Channel this is about.
 138      */
 139   struct CadetChannel *ch;
 140
 141     /**
 142      * DLL of messages sent and not yet ACK'd.
 143      */
 144   struct CadetReliableMessage        *head_sent;
 145   struct CadetReliableMessage        *tail_sent;
 146
 147     /**
 148      * DLL of messages received out of order.
 149      */
 150   struct CadetReliableMessage        *head_recv;
 151   struct CadetReliableMessage        *tail_recv;
 152
 153     /**
 154      * Messages received.
 155      */
 156   unsigned int                      n_recv;
 157
 158     /**
 159      * Next MID to use for outgoing traffic.
 160      */
 161   uint32_t                          mid_send;
 162
 163     /**
 164      * Next MID expected for incoming traffic.
 165      */
 166   uint32_t                          mid_recv;
 167
 168     /**
 169      * Handle for queued unique data CREATE, DATA_ACK.
 170      */
 171   struct CadetChannelQueue           *uniq;
 172
 173     /**
 174      * Can we send data to the client?
 175      */
 176   int                               client_ready;
 177
 178   /**
 179    * Can the client send data to us?
 180    */
 181   int                               client_allowed;
 182
 183     /**
 184      * Task to resend/poll in case no ACK is received.
 185      */
 186   GNUNET_SCHEDULER_TaskIdentifier   retry_task;
 187
 188     /**
 189      * Counter for exponential backoff.
 190      */
 191   struct GNUNET_TIME_Relative       retry_timer;
 192
 193     /**
 194      * How long does it usually take to get an ACK.
 195      */
 196   struct GNUNET_TIME_Relative       expected_delay;
 197 };
 198
 199
 200 /**
 201  * Struct containing all information regarding a channel to a remote client.
 202  */
 203 struct CadetChannel
 204 {
 205     /**
 206      * Tunnel this channel is in.
 207      */
 208   struct CadetTunnel *t;
 209
 210     /**
 211      * Destination port of the channel.
 212      */
 213   uint32_t port;
 214
 215     /**
 216      * Global channel number ( < GNUNET_CADET_LOCAL_CHANNEL_ID_CLI)
 217      */
 218   CADET_ChannelNumber gid;
 219
 220     /**
 221      * Local tunnel number for root (owner) client.
 222      * ( >= GNUNET_CADET_LOCAL_CHANNEL_ID_CLI or 0 )
 223      */
 224   CADET_ChannelNumber lid_root;
 225
 226     /**
 227      * Local tunnel number for local destination clients (incoming number)
 228      * ( >= GNUNET_CADET_LOCAL_CHANNEL_ID_SERV or 0).
 229      */
 230   CADET_ChannelNumber lid_dest;
 231
 232     /**
 233      * Channel state.
 234      */
 235   enum CadetChannelState state;
 236
 237     /**
 238      * Is the tunnel bufferless (minimum latency)?
 239      */
 240   int nobuffer;
 241
 242     /**
 243      * Is the tunnel reliable?
 244      */
 245   int reliable;
 246
 247     /**
 248      * Last time the channel was used
 249      */
 250   struct GNUNET_TIME_Absolute timestamp;
 251
 252     /**
 253      * Client owner of the tunnel, if any
 254      */
 255   struct CadetClient *root;
 256
 257     /**
 258      * Client destination of the tunnel, if any.
 259      */
 260   struct CadetClient *dest;
 261
 262     /**
 263      * Flag to signal the destruction of the channel.
 264      * If this is set GNUNET_YES the channel will be destroyed
 265      * when the queue is empty.
 266      */
 267   int destroy;
 268
 269     /**
 270      * Total (reliable) messages pending ACK for this channel.
 271      */
 272   unsigned int pending_messages;
 273
 274     /**
 275      * Reliability data.
 276      * Only present (non-NULL) at the owner of a tunnel.
 277      */
 278   struct CadetChannelReliability *root_rel;
 279
 280     /**
 281      * Reliability data.
 282      * Only present (non-NULL) at the destination of a tunnel.
 283      */
 284   struct CadetChannelReliability *dest_rel;
 285
 286 };
 287
 288
 289 /******************************************************************************/
 290 /*******************************   GLOBALS  ***********************************/
 291 /******************************************************************************/
 292
 293 /**
 294  * Global handle to the statistics service.
 295  */
 296 extern struct GNUNET_STATISTICS_Handle *stats;
 297
 298 /**
 299  * Local peer own ID (memory efficient handle).
 300  */
 301 extern GNUNET_PEER_Id myid;
 302
 303
 304 /******************************************************************************/
 305 /********************************   STATIC  ***********************************/
 306 /******************************************************************************/
 307
 308
 309 /**
 310  * Destroy a reliable message after it has been acknowledged, either by
 311  * direct mid ACK or bitfield. Updates the appropriate data structures and
 312  * timers and frees all memory.
 313  *
 314  * @param copy Message that is no longer needed: remote peer got it.
 315  * @param update_time Is the timing information relevant?
 316  *                    If this message is ACK in a batch the timing information
 317  *                    is skewed by the retransmission, count only for the
 318  *                    retransmitted message.
 319  *
 320  * @return #GNUNET_YES if channel was destroyed as a result of the call,
 321  *         #GNUNET_NO otherwise.
 322  */
 323 static int
 324 rel_message_free (struct CadetReliableMessage *copy, int update_time);
 325
 326 /**
 327  * send a channel create message.
 328  *
 329  * @param ch Channel for which to send.
 330  */
 331 static void
 332 send_create (struct CadetChannel *ch);
 333
 334 /**
 335  * Confirm we got a channel create, FWD ack.
 336  *
 337  * @param ch The channel to confirm.
 338  * @param fwd Should we send a FWD ACK? (going dest->root)
 339  */
 340 static void
 341 send_ack (struct CadetChannel *ch, int fwd);
 342
 343
 344
 345 /**
 346  * Test if the channel is loopback: both root and dest are on the local peer.
 347  *
 348  * @param ch Channel to test.
 349  *
 350  * @return #GNUNET_YES if channel is loopback, #GNUNET_NO otherwise.
 351  */
 352 static int
 353 is_loopback (const struct CadetChannel *ch)
 354 {
 355   if (NULL != ch->t)
 356     return GCT_is_loopback (ch->t);
 357
 358   return (NULL != ch->root && NULL != ch->dest);
 359 }
 360
 361
 362 /**
 363  * Save a copy of the data message for later retransmission.
 364  *
 365  * @param msg Message to copy.
 366  * @param mid Message ID.
 367  * @param rel Reliability data for retransmission.
 368  */
 369 static struct CadetReliableMessage *
 370 copy_message (const struct GNUNET_CADET_Data *msg, uint32_t mid,
 371               struct CadetChannelReliability *rel)
 372 {
 373   struct CadetReliableMessage *copy;
 374   uint16_t size;
 375
 376   size = ntohs (msg->header.size);
 377   copy = GNUNET_malloc (sizeof (*copy) + size);
 378   copy->mid = mid;
 379   copy->rel = rel;
 380   copy->type = GNUNET_MESSAGE_TYPE_CADET_DATA;
 381   memcpy (&copy[1], msg, size);
 382
 383   return copy;
 384 }
 385
 386 /**
 387  * We have received a message out of order, or the client is not ready.
 388  * Buffer it until we receive an ACK from the client or the missing
 389  * message from the channel.
 390  *
 391  * @param msg Message to buffer (MUST be of type CADET_DATA).
 392  * @param rel Reliability data to the corresponding direction.
 393  */
 394 static void
 395 add_buffered_data (const struct GNUNET_CADET_Data *msg,
 396                    struct CadetChannelReliability *rel)
 397 {
 398   struct CadetReliableMessage *copy;
 399   struct CadetReliableMessage *prev;
 400   uint32_t mid;
 401
 402   mid = ntohl (msg->mid);
 403
 404   LOG (GNUNET_ERROR_TYPE_DEBUG, "add_buffered_data %u\n", mid);
 405
 406   rel->n_recv++;
 407
 408   // FIXME do something better than O(n), although n < 64...
 409   // FIXME start from the end (most messages are the latest ones)
 410   for (prev = rel->head_recv; NULL != prev; prev = prev->next)
 411   {
 412     LOG (GNUNET_ERROR_TYPE_DEBUG, " prev %u\n", prev->mid);
 413     if (prev->mid == mid)
 414     {
 415       LOG (GNUNET_ERROR_TYPE_DEBUG, " already there!\n");
 416       return;
 417     }
 418     else if (GC_is_pid_bigger (prev->mid, mid))
 419     {
 420       LOG (GNUNET_ERROR_TYPE_DEBUG, " bingo!\n");
 421       copy = copy_message (msg, mid, rel);
 422       GNUNET_CONTAINER_DLL_insert_before (rel->head_recv, rel->tail_recv,
 423                                           prev, copy);
 424       return;
 425     }
 426   }
 427   copy = copy_message (msg, mid, rel);
 428   LOG (GNUNET_ERROR_TYPE_DEBUG, " insert at tail!\n");
 429   GNUNET_CONTAINER_DLL_insert_tail (rel->head_recv, rel->tail_recv, copy);
 430   LOG (GNUNET_ERROR_TYPE_DEBUG, "add_buffered_data END\n");
 431 }
 432
 433
 434 /**
 435  * Add a destination client to a channel, initializing all data structures
 436  * in the channel and the client.
 437  *
 438  * @param ch Channel to which add the destination.
 439  * @param c Client which to add to the channel.
 440  */
 441 static void
 442 add_destination (struct CadetChannel *ch, struct CadetClient *c)
 443 {
 444   if (NULL != ch->dest)
 445   {
 446     GNUNET_break (0);
 447     return;
 448   }
 449
 450   /* Assign local id as destination */
 451   ch->lid_dest = GML_get_next_chid (c);
 452
 453   /* Store in client's hashmap */
 454   GML_channel_add (c, ch->lid_dest, ch);
 455
 456   GNUNET_break (NULL == ch->dest_rel);
 457   ch->dest_rel = GNUNET_new (struct CadetChannelReliability);
 458   ch->dest_rel->ch = ch;
 459   ch->dest_rel->expected_delay.rel_value_us = 0;
 460   ch->dest_rel->retry_timer = CADET_RETRANSMIT_TIME;
 461
 462   ch->dest = c;
 463 }
 464
 465
 466 /**
 467  * Set options in a channel, extracted from a bit flag field.
 468  *
 469  * @param ch Channel to set options to.
 470  * @param options Bit array in host byte order.
 471  */
 472 static void
 473 channel_set_options (struct CadetChannel *ch, uint32_t options)
 474 {
 475   ch->nobuffer = (options & GNUNET_CADET_OPTION_NOBUFFER) != 0 ?
 476   GNUNET_YES : GNUNET_NO;
 477   ch->reliable = (options & GNUNET_CADET_OPTION_RELIABLE) != 0 ?
 478   GNUNET_YES : GNUNET_NO;
 479 }
 480
 481
 482 /**
 483  * Get a bit flag field with the options of a channel.
 484  *
 485  * @param ch Channel to get options from.
 486  *
 487  * @return Bit array in host byte order.
 488  */
 489 static uint32_t
 490 channel_get_options (struct CadetChannel *ch)
 491 {
 492   uint32_t options;
 493
 494   options = 0;
 495   if (ch->nobuffer)
 496     options |= GNUNET_CADET_OPTION_NOBUFFER;
 497   if (ch->reliable)
 498     options |= GNUNET_CADET_OPTION_RELIABLE;
 499
 500   return options;
 501 }
 502
 503
 504 /**
 505  * Notify a client that the channel is no longer valid.
 506  *
 507  * @param ch Channel that is destroyed.
 508  * @param local_only Should we avoid sending it to other peers?
 509  */
 510 static void
 511 send_destroy (struct CadetChannel *ch, int local_only)
 512 {
 513   struct GNUNET_CADET_ChannelManage msg;
 514
 515   msg.header.type = htons (GNUNET_MESSAGE_TYPE_CADET_CHANNEL_DESTROY);
 516   msg.header.size = htons (sizeof (msg));
 517   msg.chid = htonl (ch->gid);
 518
 519   /* If root is not NULL, notify.
 520    * If it's NULL, check lid_root. When a local destroy comes in, root
 521    * is set to NULL but lid_root is left untouched. In this case, do nothing,
 522    * the client is the one who requested the channel to be destroyed.
 523    */
 524   if (NULL != ch->root)
 525     GML_send_channel_destroy (ch->root, ch->lid_root);
 526   else if (0 == ch->lid_root && GNUNET_NO == local_only)
 527     GCCH_send_prebuilt_message (&msg.header, ch, GNUNET_NO, NULL);
 528
 529   if (NULL != ch->dest)
 530     GML_send_channel_destroy (ch->dest, ch->lid_dest);
 531   else if (0 == ch->lid_dest && GNUNET_NO == local_only)
 532     GCCH_send_prebuilt_message (&msg.header, ch, GNUNET_YES, NULL);
 533 }
 534
 535
 536 /**
 537  * Notify the destination client that a new incoming channel was created.
 538  *
 539  * @param ch Channel that was created.
 540  */
 541 static void
 542 send_client_create (struct CadetChannel *ch)
 543 {
 544   uint32_t opt;
 545
 546   if (NULL == ch->dest)
 547     return;
 548
 549   opt = 0;
 550   opt |= GNUNET_YES == ch->reliable ? GNUNET_CADET_OPTION_RELIABLE : 0;
 551   opt |= GNUNET_YES == ch->nobuffer ? GNUNET_CADET_OPTION_NOBUFFER : 0;
 552   GML_send_channel_create (ch->dest, ch->lid_dest, ch->port, opt,
 553                            GCT_get_destination (ch->t));
 554
 555 }
 556
 557
 558 /**
 559  * Send data to a client.
 560  *
 561  * If the client is ready, send directly, otherwise buffer while listening
 562  * for a local ACK.
 563  *
 564  * @param ch Channel
 565  * @param msg Message.
 566  * @param fwd Is this a fwd (root->dest) message?
 567  */
 568 static void
 569 send_client_data (struct CadetChannel *ch,
 570                   const struct GNUNET_CADET_Data *msg,
 571                   int fwd)
 572 {
 573   if (fwd)
 574   {
 575     if (ch->dest_rel->client_ready)
 576     {
 577       GML_send_data (ch->dest, msg, ch->lid_dest);
 578       ch->dest_rel->client_ready = GNUNET_NO;
 579       ch->dest_rel->mid_recv++;
 580     }
 581     else
 582       add_buffered_data (msg, ch->dest_rel);
 583   }
 584   else
 585   {
 586     if (ch->root_rel->client_ready)
 587     {
 588       GML_send_data (ch->root, msg, ch->lid_root);
 589       ch->root_rel->client_ready = GNUNET_NO;
 590       ch->root_rel->mid_recv++;
 591     }
 592     else
 593       add_buffered_data (msg, ch->root_rel);
 594   }
 595 }
 596
 597
 598 /**
 599  * Send a buffered message to the client, for in order delivery or
 600  * as result of client ACK.
 601  *
 602  * @param ch Channel on which to empty the message buffer.
 603  * @param c Client to send to.
 604  * @param fwd Is this to send FWD data?.
 605  */
 606 static void
 607 send_client_buffered_data (struct CadetChannel *ch,
 608                            struct CadetClient *c,
 609                            int fwd)
 610 {
 611   struct CadetReliableMessage *copy;
 612   struct CadetChannelReliability *rel;
 613
 614   LOG (GNUNET_ERROR_TYPE_DEBUG, "send_buffered_data\n");
 615   rel = fwd ? ch->dest_rel : ch->root_rel;
 616   if (GNUNET_NO == rel->client_ready)
 617   {
 618     LOG (GNUNET_ERROR_TYPE_DEBUG, "client not ready\n");
 619     return;
 620   }
 621
 622   copy = rel->head_recv;
 623   /* We never buffer channel management messages */
 624   if (NULL != copy)
 625   {
 626     if (copy->mid == rel->mid_recv || GNUNET_NO == ch->reliable)
 627     {
 628       struct GNUNET_CADET_Data *msg = (struct GNUNET_CADET_Data *) &copy[1];
 629
 630       LOG (GNUNET_ERROR_TYPE_DEBUG, " have %u! now expecting %u\n",
 631            copy->mid, rel->mid_recv + 1);
 632       send_client_data (ch, msg, fwd);
 633       rel->n_recv--;
 634       GNUNET_CONTAINER_DLL_remove (rel->head_recv, rel->tail_recv, copy);
 635       LOG (GNUNET_ERROR_TYPE_DEBUG, " COPYFREE RECV %p\n", copy);
 636       GNUNET_free (copy);
 637       GCCH_send_data_ack (ch, fwd);
 638     }
 639     else
 640     {
 641       LOG (GNUNET_ERROR_TYPE_DEBUG, " reliable && don't have %u, next is %u\n",
 642            rel->mid_recv, copy->mid);
 643       if (GNUNET_YES == ch->destroy)
 644       {
 645         /* We don't have the next data piece and the remote peer has closed the
 646          * channel. We won't receive it anymore, so just destroy the channel.
 647          * FIXME: wait some time to allow other connections to
 648          *        deliver missing messages
 649          */
 650         send_destroy (ch, GNUNET_YES);
 651         GCCH_destroy (ch);
 652       }
 653     }
 654   }
 655   LOG (GNUNET_ERROR_TYPE_DEBUG, "send_buffered_data END\n");
 656 }
 657
 658
 659 /**
 660  * Allow a client to send more data.
 661  *
 662  * In case the client was already allowed to send data, do nothing.
 663  *
 664  * @param ch Channel.
 665  * @param fwd Is this a FWD ACK? (FWD ACKs are sent to root)
 666  */
 667 static void
 668 send_client_ack (struct CadetChannel *ch, int fwd)
 669 {
 670   struct CadetChannelReliability *rel = fwd ? ch->root_rel : ch->dest_rel;
 671   struct CadetClient *c = fwd ? ch->root : ch->dest;
 672
 673   if (NULL == c)
 674   {
 675     GNUNET_break (GNUNET_NO != ch->destroy);
 676     return;
 677   }
 678   LOG (GNUNET_ERROR_TYPE_DEBUG,
 679        "  sending %s ack to client on channel %s\n",
 680        GC_f2s (fwd), GCCH_2s (ch));
 681
 682   if (NULL == rel)
 683   {
 684     GNUNET_break (0);
 685     return;
 686   }
 687
 688   if (GNUNET_YES == rel->client_allowed)
 689   {
 690     LOG (GNUNET_ERROR_TYPE_DEBUG, "  already allowed\n");
 691     return;
 692   }
 693   rel->client_allowed = GNUNET_YES;
 694
 695   GML_send_ack (c, fwd ? ch->lid_root : ch->lid_dest);
 696 }
 697
 698
 699 /**
 700  * Notify the root that the destination rejected the channel.
 701  *
 702  * @param ch Rejected channel.
 703  */
 704 static void
 705 send_client_nack (struct CadetChannel *ch)
 706 {
 707   if (NULL == ch->root)
 708   {
 709     GNUNET_break (0);
 710     return;
 711   }
 712   GML_send_channel_nack (ch->root, ch->lid_root);
 713 }
 714
 715
 716 /**
 717  * We haven't received an ACK after a certain time: restransmit the message.
 718  *
 719  * @param cls Closure (CadetChannelReliability with the message to restransmit)
 720  * @param tc TaskContext.
 721  */
 722 static void
 723 channel_retransmit_message (void *cls,
 724                             const struct GNUNET_SCHEDULER_TaskContext *tc)
 725 {
 726   struct CadetChannelReliability *rel = cls;
 727   struct CadetReliableMessage *copy;
 728   struct CadetChannel *ch;
 729   struct GNUNET_CADET_Data *payload;
 730   int fwd;
 731
 732   rel->retry_task = GNUNET_SCHEDULER_NO_TASK;
 733   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
 734     return;
 735
 736   ch = rel->ch;
 737   copy = rel->head_sent;
 738   if (NULL == copy)
 739   {
 740     GNUNET_break (0); // FIXME tripped in rps testcase
 741     return;
 742   }
 743
 744   payload = (struct GNUNET_CADET_Data *) &copy[1];
 745   fwd = (rel == ch->root_rel);
 746
 747   /* Message not found in the queue that we are going to use. */
 748   LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! RETRANSMIT %u\n", copy->mid);
 749
 750   GCCH_send_prebuilt_message (&payload->header, ch, fwd, copy);
 751   GNUNET_STATISTICS_update (stats, "# data retransmitted", 1, GNUNET_NO);
 752 }
 753
 754
 755 /**
 756  * We haven't received an Channel ACK after a certain time: resend the CREATE.
 757  *
 758  * @param cls Closure (CadetChannelReliability of the channel to recreate)
 759  * @param tc TaskContext.
 760  */
 761 static void
 762 channel_recreate (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
 763 {
 764   struct CadetChannelReliability *rel = cls;
 765
 766   rel->retry_task = GNUNET_SCHEDULER_NO_TASK;
 767   if (0 != (tc->reason & GNUNET_SCHEDULER_REASON_SHUTDOWN))
 768     return;
 769
 770   LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! RE-CREATE\n");
 771   GNUNET_STATISTICS_update (stats, "# data retransmitted", 1, GNUNET_NO);
 772
 773   if (rel == rel->ch->root_rel)
 774   {
 775     send_create (rel->ch);
 776   }
 777   else if (rel == rel->ch->dest_rel)
 778   {
 779     send_ack (rel->ch, GNUNET_YES);
 780   }
 781   else
 782   {
 783     GNUNET_break (0);
 784   }
 785
 786 }
 787
 788
 789 /**
 790  * Message has been sent: start retransmission timer.
 791  *
 792  * @param cls Closure (queue structure).
 793  * @param t Tunnel.
 794  * @param q Queue handler (no longer valid).
 795  * @param type Type of message.
 796  * @param size Size of the message.
 797  */
 798 static void
 799 ch_message_sent (void *cls,
 800                  struct CadetTunnel *t,
 801                  struct CadetTunnelQueue *q,
 802                  uint16_t type, size_t size)
 803 {
 804   struct CadetChannelQueue *chq = cls;
 805   struct CadetReliableMessage *copy = chq->copy;
 806   struct CadetChannelReliability *rel;
 807
 808   LOG (GNUNET_ERROR_TYPE_DEBUG, "channel message sent callback %s\n",
 809        GC_m2s (chq->type));
 810
 811   switch (chq->type)
 812   {
 813     case GNUNET_MESSAGE_TYPE_CADET_DATA:
 814       LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! SENT DATA MID %u\n", copy->mid);
 815       GNUNET_assert (chq == copy->chq);
 816       copy->timestamp = GNUNET_TIME_absolute_get ();
 817       rel = copy->rel;
 818       if (GNUNET_SCHEDULER_NO_TASK == rel->retry_task)
 819       {
 820         LOG (GNUNET_ERROR_TYPE_DEBUG, "!! scheduling retry in 4 * %s\n",
 821              GNUNET_STRINGS_relative_time_to_string (rel->expected_delay,
 822                                                      GNUNET_YES));
 823         if (0 != rel->expected_delay.rel_value_us)
 824         {
 825           LOG (GNUNET_ERROR_TYPE_DEBUG, "!! delay != 0\n");
 826           rel->retry_timer =
 827           GNUNET_TIME_relative_multiply (rel->expected_delay,
 828                                          CADET_RETRANSMIT_MARGIN);
 829         }
 830         else
 831         {
 832           LOG (GNUNET_ERROR_TYPE_DEBUG, "!! delay reset\n");
 833           rel->retry_timer = CADET_RETRANSMIT_TIME;
 834         }
 835         LOG (GNUNET_ERROR_TYPE_DEBUG, "!! using delay %s\n",
 836              GNUNET_STRINGS_relative_time_to_string (rel->retry_timer,
 837                                                      GNUNET_NO));
 838         rel->retry_task =
 839             GNUNET_SCHEDULER_add_delayed (rel->retry_timer,
 840                                           &channel_retransmit_message, rel);
 841       }
 842       else
 843       {
 844         LOG (GNUNET_ERROR_TYPE_DEBUG, "!! retry task %u\n", rel->retry_task);
 845       }
 846       copy->chq = NULL;
 847       break;
 848
 849
 850     case GNUNET_MESSAGE_TYPE_CADET_DATA_ACK:
 851     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_CREATE:
 852     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_ACK:
 853       LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! SENT %s\n", GC_m2s (chq->type));
 854       rel = chq->rel;
 855       GNUNET_assert (rel->uniq == chq);
 856       rel->uniq = NULL;
 857
 858       if (CADET_CHANNEL_READY != rel->ch->state
 859           && GNUNET_MESSAGE_TYPE_CADET_DATA_ACK != type
 860           && GNUNET_NO == rel->ch->destroy)
 861       {
 862         GNUNET_assert (GNUNET_SCHEDULER_NO_TASK == rel->retry_task);
 863         LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! STD BACKOFF %s\n",
 864              GNUNET_STRINGS_relative_time_to_string (rel->retry_timer,
 865                                                      GNUNET_NO));
 866         rel->retry_timer = GNUNET_TIME_STD_BACKOFF (rel->retry_timer);
 867         rel->retry_task = GNUNET_SCHEDULER_add_delayed (rel->retry_timer,
 868                                                         &channel_recreate, rel);
 869       }
 870       break;
 871
 872     default:
 873       GNUNET_break (0);
 874   }
 875
 876   GNUNET_free (chq);
 877 }
 878
 879
 880 /**
 881  * send a channel create message.
 882  *
 883  * @param ch Channel for which to send.
 884  */
 885 static void
 886 send_create (struct CadetChannel *ch)
 887 {
 888   struct GNUNET_CADET_ChannelCreate msgcc;
 889
 890   msgcc.header.size = htons (sizeof (msgcc));
 891   msgcc.header.type = htons (GNUNET_MESSAGE_TYPE_CADET_CHANNEL_CREATE);
 892   msgcc.chid = htonl (ch->gid);
 893   msgcc.port = htonl (ch->port);
 894   msgcc.opt = htonl (channel_get_options (ch));
 895
 896   GCCH_send_prebuilt_message (&msgcc.header, ch, GNUNET_YES, NULL);
 897 }
 898
 899
 900 /**
 901  * Confirm we got a channel create or FWD ack.
 902  *
 903  * @param ch The channel to confirm.
 904  * @param fwd Should we send a FWD ACK? (going dest->root)
 905  */
 906 static void
 907 send_ack (struct CadetChannel *ch, int fwd)
 908 {
 909   struct GNUNET_CADET_ChannelManage msg;
 910
 911   msg.header.size = htons (sizeof (msg));
 912   msg.header.type = htons (GNUNET_MESSAGE_TYPE_CADET_CHANNEL_ACK);
 913   LOG (GNUNET_ERROR_TYPE_DEBUG, "  sending channel %s ack for channel %s\n",
 914        GC_f2s (fwd), GCCH_2s (ch));
 915
 916   msg.chid = htonl (ch->gid);
 917   GCCH_send_prebuilt_message (&msg.header, ch, !fwd, NULL);
 918 }
 919
 920
 921 /**
 922  * Send a message and don't keep any info about it: we won't need to cancel it
 923  * or resend it.
 924  *
 925  * @param msg Header of the message to fire away.
 926  * @param ch Channel on which the message should go.
 927  * @param force Is this a forced (undroppable) message?
 928  */
 929 static void
 930 fire_and_forget (const struct GNUNET_MessageHeader *msg,
 931                  struct CadetChannel *ch,
 932                  int force)
 933 {
 934   GNUNET_break (NULL == GCT_send_prebuilt_message (msg, ch->t, NULL,
 935                                                    force, NULL, NULL));
 936 }
 937
 938
 939 /**
 940  * Notify that a channel create didn't succeed.
 941  *
 942  * @param ch The channel to reject.
 943  */
 944 static void
 945 send_nack (struct CadetChannel *ch)
 946 {
 947   struct GNUNET_CADET_ChannelManage msg;
 948
 949   msg.header.size = htons (sizeof (msg));
 950   msg.header.type = htons (GNUNET_MESSAGE_TYPE_CADET_CHANNEL_NACK);
 951   LOG (GNUNET_ERROR_TYPE_DEBUG,
 952        "  sending channel NACK for channel %s\n",
 953        GCCH_2s (ch));
 954
 955   msg.chid = htonl (ch->gid);
 956   GCCH_send_prebuilt_message (&msg.header, ch, GNUNET_NO, NULL);
 957 }
 958
 959
 960 /**
 961  * Destroy all reliable messages queued for a channel,
 962  * during a channel destruction.
 963  * Frees the reliability structure itself.
 964  *
 965  * @param rel Reliability data for a channel.
 966  */
 967 static void
 968 channel_rel_free_all (struct CadetChannelReliability *rel)
 969 {
 970   struct CadetReliableMessage *copy;
 971   struct CadetReliableMessage *next;
 972
 973   if (NULL == rel)
 974     return;
 975
 976   for (copy = rel->head_recv; NULL != copy; copy = next)
 977   {
 978     next = copy->next;
 979     GNUNET_CONTAINER_DLL_remove (rel->head_recv, rel->tail_recv, copy);
 980     LOG (GNUNET_ERROR_TYPE_DEBUG, " COPYFREE BATCH RECV %p\n", copy);
 981     GNUNET_break (NULL == copy->chq);
 982     GNUNET_free (copy);
 983   }
 984   for (copy = rel->head_sent; NULL != copy; copy = next)
 985   {
 986     next = copy->next;
 987     GNUNET_CONTAINER_DLL_remove (rel->head_sent, rel->tail_sent, copy);
 988     LOG (GNUNET_ERROR_TYPE_DEBUG, " COPYFREE BATCH %p\n", copy);
 989     if (NULL != copy->chq)
 990     {
 991       if (NULL != copy->chq->tq)
 992       {
 993         GCT_cancel (copy->chq->tq);
 994         /* ch_message_sent will free copy->q */
 995       }
 996       else
 997       {
 998         GNUNET_free (copy->chq);
 999         GNUNET_break (0);
1000       }
1001     }
1002     GNUNET_free (copy);
1003   }
1004   if (NULL != rel->uniq && NULL != rel->uniq->tq)
1005   {
1006     GCT_cancel (rel->uniq->tq);
1007     /* ch_message_sent is called freeing uniq */
1008   }
1009   if (GNUNET_SCHEDULER_NO_TASK != rel->retry_task)
1010   {
1011     GNUNET_SCHEDULER_cancel (rel->retry_task);
1012     rel->retry_task = GNUNET_SCHEDULER_NO_TASK;
1013   }
1014   GNUNET_free (rel);
1015 }
1016
1017
1018 /**
1019  * Mark future messages as ACK'd.
1020  *
1021  * @param rel Reliability data.
1022  * @param msg DataACK message with a bitfield of future ACK'd messages.
1023  */
1024 static void
1025 channel_rel_free_sent (struct CadetChannelReliability *rel,
1026                        const struct GNUNET_CADET_DataACK *msg)
1027 {
1028   struct CadetReliableMessage *copy;
1029   struct CadetReliableMessage *next;
1030   uint64_t bitfield;
1031   uint64_t mask;
1032   uint32_t mid;
1033   uint32_t target;
1034   unsigned int i;
1035
1036   bitfield = msg->futures;
1037   mid = ntohl (msg->mid);
1038   LOG (GNUNET_ERROR_TYPE_DEBUG, "free_sent_reliable %u %llX\n", mid, bitfield);
1039   LOG (GNUNET_ERROR_TYPE_DEBUG, " rel %p, head %p\n", rel, rel->head_sent);
1040   for (i = 0, copy = rel->head_sent;
1041        i < 64 && NULL != copy && 0 != bitfield;
1042        i++)
1043   {
1044     LOG (GNUNET_ERROR_TYPE_DEBUG, " trying bit %u (mid %u)\n", i, mid + i + 1);
1045     mask = 0x1LL << i;
1046     if (0 == (bitfield & mask))
1047      continue;
1048
1049     LOG (GNUNET_ERROR_TYPE_DEBUG, " set!\n");
1050     /* Bit was set, clear the bit from the bitfield */
1051     bitfield &= ~mask;
1052
1053     /* The i-th bit was set. Do we have that copy? */
1054     /* Skip copies with mid < target */
1055     target = mid + i + 1;
1056     LOG (GNUNET_ERROR_TYPE_DEBUG, " target %u\n", target);
1057     while (NULL != copy && GC_is_pid_bigger (target, copy->mid))
1058       copy = copy->next;
1059
1060     /* Did we run out of copies? (previously freed, it's ok) */
1061     if (NULL == copy)
1062     {
1063      LOG (GNUNET_ERROR_TYPE_DEBUG, "run out of copies...\n");
1064      return;
1065     }
1066
1067     /* Did we overshoot the target? (previously freed, it's ok) */
1068     if (GC_is_pid_bigger (copy->mid, target))
1069     {
1070      LOG (GNUNET_ERROR_TYPE_DEBUG, " next copy %u\n", copy->mid);
1071      continue;
1072     }
1073
1074     /* Now copy->mid == target, free it */
1075     next = copy->next;
1076     GNUNET_break (GNUNET_YES != rel_message_free (copy, GNUNET_YES));
1077     copy = next;
1078   }
1079   LOG (GNUNET_ERROR_TYPE_DEBUG, "free_sent_reliable END\n");
1080 }
1081
1082
1083 /**
1084  * Destroy a reliable message after it has been acknowledged, either by
1085  * direct mid ACK or bitfield. Updates the appropriate data structures and
1086  * timers and frees all memory.
1087  *
1088  * @param copy Message that is no longer needed: remote peer got it.
1089  * @param update_time Is the timing information relevant?
1090  *                    If this message is ACK in a batch the timing information
1091  *                    is skewed by the retransmission, count only for the
1092  *                    retransmitted message.
1093  *
1094  * @return #GNUNET_YES if channel was destroyed as a result of the call,
1095  *         #GNUNET_NO otherwise.
1096  */
1097 static int
1098 rel_message_free (struct CadetReliableMessage *copy, int update_time)
1099 {
1100   struct CadetChannelReliability *rel;
1101   struct GNUNET_TIME_Relative time;
1102
1103   rel = copy->rel;
1104   LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! Freeing %u\n", copy->mid);
1105   if (update_time)
1106   {
1107     time = GNUNET_TIME_absolute_get_duration (copy->timestamp);
1108     if (0 == rel->expected_delay.rel_value_us)
1109       rel->expected_delay = time;
1110     else
1111     {
1112       rel->expected_delay.rel_value_us *= 7;
1113       rel->expected_delay.rel_value_us += time.rel_value_us;
1114       rel->expected_delay.rel_value_us /= 8;
1115     }
1116     LOG (GNUNET_ERROR_TYPE_INFO, "!!!  took %s, new delay %s\n",
1117          GNUNET_STRINGS_relative_time_to_string (time, GNUNET_NO),
1118          GNUNET_STRINGS_relative_time_to_string (rel->expected_delay,
1119                                                  GNUNET_NO));
1120     rel->retry_timer = rel->expected_delay;
1121   }
1122   else
1123   {
1124     LOG (GNUNET_ERROR_TYPE_INFO, "!!! batch free, ignoring timing\n");
1125   }
1126   rel->ch->pending_messages--;
1127   if (NULL != copy->chq)
1128   {
1129     GCT_cancel (copy->chq->tq);
1130     /* copy->q is set to NULL by ch_message_sent */
1131   }
1132   GNUNET_CONTAINER_DLL_remove (rel->head_sent, rel->tail_sent, copy);
1133   LOG (GNUNET_ERROR_TYPE_DEBUG, " COPYFREE %p\n", copy);
1134   GNUNET_free (copy);
1135
1136   if (GNUNET_NO != rel->ch->destroy && 0 == rel->ch->pending_messages)
1137   {
1138     GCCH_destroy (rel->ch);
1139     return GNUNET_YES;
1140   }
1141   return GNUNET_NO;
1142 }
1143
1144
1145 /**
1146  * Channel was ACK'd by remote peer, mark as ready and cancel retransmission.
1147  *
1148  * @param ch Channel to mark as ready.
1149  * @param fwd Was the ACK message a FWD ACK? (dest->root, SYNACK)
1150  */
1151 static void
1152 channel_confirm (struct CadetChannel *ch, int fwd)
1153 {
1154   struct CadetChannelReliability *rel;
1155   enum CadetChannelState oldstate;
1156
1157   rel = fwd ? ch->root_rel : ch->dest_rel;
1158   if (NULL == rel)
1159   {
1160     GNUNET_break (GNUNET_NO != ch->destroy);
1161     return;
1162   }
1163   LOG (GNUNET_ERROR_TYPE_DEBUG, "  channel confirm %s %s\n",
1164        GC_f2s (fwd), GCCH_2s (ch));
1165   oldstate = ch->state;
1166   ch->state = CADET_CHANNEL_READY;
1167
1168   if (CADET_CHANNEL_READY != oldstate || GNUNET_YES == is_loopback (ch))
1169   {
1170     rel->client_ready = GNUNET_YES;
1171     rel->expected_delay = rel->retry_timer;
1172     LOG (GNUNET_ERROR_TYPE_DEBUG, "  !! retry timer confirm %s\n",
1173          GNUNET_STRINGS_relative_time_to_string (rel->retry_timer, GNUNET_NO));
1174     if (GCT_get_connections_buffer (ch->t) > 0 || GCT_is_loopback (ch->t))
1175       send_client_ack (ch, fwd);
1176
1177     if (GNUNET_SCHEDULER_NO_TASK != rel->retry_task)
1178     {
1179       GNUNET_SCHEDULER_cancel (rel->retry_task);
1180       rel->retry_task = GNUNET_SCHEDULER_NO_TASK;
1181     }
1182     else if (NULL != rel->uniq)
1183     {
1184       GCT_cancel (rel->uniq->tq);
1185       /* ch_message_sent will free and NULL uniq */
1186     }
1187     else if (GNUNET_NO == is_loopback (ch))
1188     {
1189       /* We SHOULD have been trying to retransmit this! */
1190       GNUNET_break (0);
1191     }
1192   }
1193
1194   /* In case of a FWD ACK (SYNACK) send a BCK ACK (ACK). */
1195   if (GNUNET_YES == fwd)
1196     send_ack (ch, GNUNET_NO);
1197 }
1198
1199
1200 /**
1201  * Save a copy to retransmit in case it gets lost.
1202  *
1203  * Initializes all needed callbacks and timers.
1204  *
1205  * @param ch Channel this message goes on.
1206  * @param msg Message to copy.
1207  * @param fwd Is this fwd traffic?
1208  */
1209 static struct CadetReliableMessage *
1210 channel_save_copy (struct CadetChannel *ch,
1211                    const struct GNUNET_MessageHeader *msg,
1212                    int fwd)
1213 {
1214   struct CadetChannelReliability *rel;
1215   struct CadetReliableMessage *copy;
1216   uint32_t mid;
1217   uint16_t type;
1218   uint16_t size;
1219
1220   rel = fwd ? ch->root_rel : ch->dest_rel;
1221   mid = rel->mid_send - 1;
1222   type = ntohs (msg->type);
1223   size = ntohs (msg->size);
1224
1225   LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! SAVE %u %s\n", mid, GC_m2s (type));
1226   copy = GNUNET_malloc (sizeof (struct CadetReliableMessage) + size);
1227   LOG (GNUNET_ERROR_TYPE_DEBUG, "  at %p\n", copy);
1228   copy->mid = mid;
1229   copy->rel = rel;
1230   copy->type = type;
1231   memcpy (&copy[1], msg, size);
1232   GNUNET_CONTAINER_DLL_insert_tail (rel->head_sent, rel->tail_sent, copy);
1233   ch->pending_messages++;
1234
1235   return copy;
1236 }
1237
1238
1239 /**
1240  * Create a new channel.
1241  *
1242  * @param t Tunnel this channel is in.
1243  * @param owner Client that owns the channel, NULL for foreign channels.
1244  * @param lid_root Local ID for root client.
1245  *
1246  * @return A new initialized channel. NULL on error.
1247  */
1248 static struct CadetChannel *
1249 channel_new (struct CadetTunnel *t,
1250              struct CadetClient *owner,
1251              CADET_ChannelNumber lid_root)
1252 {
1253   struct CadetChannel *ch;
1254
1255   ch = GNUNET_new (struct CadetChannel);
1256   ch->root = owner;
1257   ch->lid_root = lid_root;
1258   ch->t = t;
1259
1260   GNUNET_STATISTICS_update (stats, "# channels", 1, GNUNET_NO);
1261
1262   if (NULL != owner)
1263   {
1264     ch->gid = GCT_get_next_chid (t);
1265     GML_channel_add (owner, lid_root, ch);
1266   }
1267   GCT_add_channel (t, ch);
1268
1269   return ch;
1270 }
1271
1272
1273 /**
1274  * Handle a loopback message: call the appropriate handler for the message type.
1275  *
1276  * @param ch Channel this message is on.
1277  * @param msgh Message header.
1278  * @param fwd Is this FWD traffic?
1279  */
1280 void
1281 handle_loopback (struct CadetChannel *ch,
1282                  const struct GNUNET_MessageHeader *msgh,
1283                  int fwd)
1284 {
1285   uint16_t type;
1286
1287   type = ntohs (msgh->type);
1288   LOG (GNUNET_ERROR_TYPE_DEBUG,
1289        "Loopback %s %s message!\n",
1290        GC_f2s (fwd), GC_m2s (type));
1291
1292   switch (type)
1293   {
1294     case GNUNET_MESSAGE_TYPE_CADET_DATA:
1295       /* Don't send hop ACK, wait for client to ACK */
1296       LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! SEND loopback %u (%u)\n",
1297            ntohl (((struct GNUNET_CADET_Data *) msgh)->mid), ntohs (msgh->size));
1298       GCCH_handle_data (ch, (struct GNUNET_CADET_Data *) msgh, fwd);
1299       break;
1300
1301     case GNUNET_MESSAGE_TYPE_CADET_DATA_ACK:
1302       GCCH_handle_data_ack (ch, (struct GNUNET_CADET_DataACK *) msgh, fwd);
1303       break;
1304
1305     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_CREATE:
1306       GCCH_handle_create (ch->t,
1307                           (struct GNUNET_CADET_ChannelCreate *) msgh);
1308       break;
1309
1310     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_ACK:
1311       GCCH_handle_ack (ch,
1312                        (struct GNUNET_CADET_ChannelManage *) msgh,
1313                        fwd);
1314       break;
1315
1316     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_NACK:
1317       GCCH_handle_nack (ch);
1318       break;
1319
1320     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_DESTROY:
1321       GCCH_handle_destroy (ch,
1322                            (struct GNUNET_CADET_ChannelManage *) msgh,
1323                            fwd);
1324       break;
1325
1326     default:
1327       GNUNET_break_op (0);
1328       LOG (GNUNET_ERROR_TYPE_DEBUG,
1329            "end-to-end message not known (%u)\n",
1330            ntohs (msgh->type));
1331   }
1332 }
1333
1334
1335
1336 /******************************************************************************/
1337 /********************************    API    ***********************************/
1338 /******************************************************************************/
1339
1340 /**
1341  * Destroy a channel and free all resources.
1342  *
1343  * @param ch Channel to destroy.
1344  */
1345 void
1346 GCCH_destroy (struct CadetChannel *ch)
1347 {
1348   struct CadetClient *c;
1349   struct CadetTunnel *t;
1350
1351   if (NULL == ch)
1352     return;
1353   if (2 == ch->destroy)
1354     return; /* recursive call */
1355   ch->destroy = 2;
1356
1357   LOG (GNUNET_ERROR_TYPE_DEBUG, "destroying channel %s:%u\n",
1358               GCT_2s (ch->t), ch->gid);
1359   GCCH_debug (ch);
1360
1361   c = ch->root;
1362   if (NULL != c)
1363   {
1364     GML_channel_remove (c, ch->lid_root, ch);
1365   }
1366
1367   c = ch->dest;
1368   if (NULL != c)
1369   {
1370     GML_channel_remove (c, ch->lid_dest, ch);
1371   }
1372
1373   channel_rel_free_all (ch->root_rel);
1374   channel_rel_free_all (ch->dest_rel);
1375
1376   t = ch->t;
1377   GCT_remove_channel (t, ch);
1378   GNUNET_STATISTICS_update (stats, "# channels", -1, GNUNET_NO);
1379
1380   GNUNET_free (ch);
1381   GCT_destroy_if_empty (t);
1382 }
1383
1384
1385 /**
1386  * Get the channel's public ID.
1387  *
1388  * @param ch Channel.
1389  *
1390  * @return ID used to identify the channel with the remote peer.
1391  */
1392 CADET_ChannelNumber
1393 GCCH_get_id (const struct CadetChannel *ch)
1394 {
1395   return ch->gid;
1396 }
1397
1398
1399 /**
1400  * Get the channel tunnel.
1401  *
1402  * @param ch Channel to get the tunnel from.
1403  *
1404  * @return tunnel of the channel.
1405  */
1406 struct CadetTunnel *
1407 GCCH_get_tunnel (const struct CadetChannel *ch)
1408 {
1409   return ch->t;
1410 }
1411
1412
1413 /**
1414  * Get free buffer space towards the client on a specific channel.
1415  *
1416  * @param ch Channel.
1417  * @param fwd Is query about FWD traffic?
1418  *
1419  * @return Free buffer space [0 - 64]
1420  */
1421 unsigned int
1422 GCCH_get_buffer (struct CadetChannel *ch, int fwd)
1423 {
1424   struct CadetChannelReliability *rel;
1425
1426   rel = fwd ? ch->dest_rel : ch->root_rel;
1427
1428   /* If rel is NULL it means that the end is not yet created,
1429    * most probably is a loopback channel at the point of sending
1430    * the ChannelCreate to itself.
1431    */
1432   if (NULL == rel)
1433     return 64;
1434
1435   return (64 - rel->n_recv);
1436 }
1437
1438
1439 /**
1440  * Get flow control status of end point: is client allow to send?
1441  *
1442  * @param ch Channel.
1443  * @param fwd Is query about FWD traffic? (Request root status).
1444  *
1445  * @return #GNUNET_YES if client is allowed to send us data.
1446  */
1447 int
1448 GCCH_get_allowed (struct CadetChannel *ch, int fwd)
1449 {
1450   struct CadetChannelReliability *rel;
1451
1452   rel = fwd ? ch->root_rel : ch->dest_rel;
1453
1454   if (NULL == rel)
1455   {
1456     /* Probably shutting down: root/dest NULL'ed to mark disconnection */
1457     GNUNET_break (GNUNET_NO != ch->destroy);
1458     return 0;
1459   }
1460
1461   return rel->client_allowed;
1462 }
1463
1464
1465 /**
1466  * Is the root client for this channel on this peer?
1467  *
1468  * @param ch Channel.
1469  * @param fwd Is this for fwd traffic?
1470  *
1471  * @return #GNUNET_YES in case it is.
1472  */
1473 int
1474 GCCH_is_origin (struct CadetChannel *ch, int fwd)
1475 {
1476   struct CadetClient *c;
1477
1478   c = fwd ? ch->root : ch->dest;
1479   return NULL != c;
1480 }
1481
1482
1483 /**
1484  * Is the destination client for this channel on this peer?
1485  *
1486  * @param ch Channel.
1487  * @param fwd Is this for fwd traffic?
1488  *
1489  * @return #GNUNET_YES in case it is.
1490  */
1491 int
1492 GCCH_is_terminal (struct CadetChannel *ch, int fwd)
1493 {
1494   struct CadetClient *c;
1495
1496   c = fwd ? ch->dest : ch->root;
1497   return NULL != c;
1498 }
1499
1500
1501 /**
1502  * Send an end-to-end ACK message for the most recent in-sequence payload.
1503  *
1504  * If channel is not reliable, do nothing.
1505  *
1506  * @param ch Channel this is about.
1507  * @param fwd Is for FWD traffic? (ACK dest->owner)
1508  */
1509 void
1510 GCCH_send_data_ack (struct CadetChannel *ch, int fwd)
1511 {
1512   struct GNUNET_CADET_DataACK msg;
1513   struct CadetChannelReliability *rel;
1514   struct CadetReliableMessage *copy;
1515   unsigned int delta;
1516   uint64_t mask;
1517   uint32_t ack;
1518
1519   if (GNUNET_NO == ch->reliable)
1520     return;
1521
1522   rel = fwd ? ch->dest_rel : ch->root_rel;
1523   ack = rel->mid_recv - 1;
1524
1525   msg.header.type = htons (GNUNET_MESSAGE_TYPE_CADET_DATA_ACK);
1526   msg.header.size = htons (sizeof (msg));
1527   msg.chid = htonl (ch->gid);
1528   msg.mid = htonl (ack);
1529
1530   msg.futures = 0LL;
1531   for (copy = rel->head_recv; NULL != copy; copy = copy->next)
1532   {
1533     if (copy->type != GNUNET_MESSAGE_TYPE_CADET_DATA)
1534     {
1535       LOG (GNUNET_ERROR_TYPE_DEBUG, " Type %s, expected DATA\n",
1536            GC_m2s (copy->type));
1537       continue;
1538     }
1539     GNUNET_assert (GC_is_pid_bigger(copy->mid, ack));
1540     delta = copy->mid - (ack + 1);
1541     if (63 < delta)
1542       break;
1543     mask = 0x1LL << delta;
1544     msg.futures |= mask;
1545     LOG (GNUNET_ERROR_TYPE_DEBUG,
1546          " setting bit for %u (delta %u) (%llX) -> %llX\n",
1547          copy->mid, delta, mask, msg.futures);
1548   }
1549   LOG (GNUNET_ERROR_TYPE_INFO, "===> DATA_ACK for %u + %llX\n",
1550        ack, msg.futures);
1551
1552   GCCH_send_prebuilt_message (&msg.header, ch, !fwd, NULL);
1553   LOG (GNUNET_ERROR_TYPE_DEBUG, "send_data_ack END\n");
1554 }
1555
1556
1557 /**
1558  * Allow a client to send us more data, in case it was choked.
1559  *
1560  * @param ch Channel.
1561  * @param fwd Is this about FWD traffic? (Root client).
1562  */
1563 void
1564 GCCH_allow_client (struct CadetChannel *ch, int fwd)
1565 {
1566   struct CadetChannelReliability *rel;
1567   unsigned int buffer;
1568
1569   LOG (GNUNET_ERROR_TYPE_DEBUG, "GMCH allow\n");
1570
1571   if (CADET_CHANNEL_READY != ch->state)
1572   {
1573     LOG (GNUNET_ERROR_TYPE_DEBUG, " channel not ready yet!\n");
1574     return;
1575   }
1576
1577   if (GNUNET_YES == ch->reliable)
1578   {
1579     rel = fwd ? ch->root_rel : ch->dest_rel;
1580     if (NULL == rel)
1581     {
1582       GNUNET_break (GNUNET_NO != ch->destroy);
1583       return;
1584     }
1585     if (NULL != rel->head_sent)
1586     {
1587       if (64 <= rel->mid_send - rel->head_sent->mid)
1588       {
1589         LOG (GNUNET_ERROR_TYPE_DEBUG, " too big MID gap! Wait for ACK.\n");
1590         return;
1591       }
1592       else
1593       {
1594         LOG (GNUNET_ERROR_TYPE_DEBUG, " gap ok: %u - %u\n",
1595              rel->head_sent->mid, rel->mid_send);
1596         struct CadetReliableMessage *aux;
1597         for (aux = rel->head_sent; NULL != aux; aux = aux->next)
1598         {
1599           LOG (GNUNET_ERROR_TYPE_DEBUG, "   - sent MID %u\n", aux->mid);
1600         }
1601       }
1602     }
1603     else
1604     {
1605       LOG (GNUNET_ERROR_TYPE_DEBUG, " head sent is NULL\n");
1606     }
1607   }
1608
1609   if (is_loopback (ch))
1610     buffer = GCCH_get_buffer (ch, fwd);
1611   else
1612     buffer = GCT_get_connections_buffer (ch->t);
1613
1614   if (0 == buffer)
1615   {
1616     LOG (GNUNET_ERROR_TYPE_DEBUG, " no buffer space.\n");
1617     return;
1618   }
1619
1620   LOG (GNUNET_ERROR_TYPE_DEBUG, " buffer space %u, allowing\n", buffer);
1621   send_client_ack (ch, fwd);
1622 }
1623
1624
1625 /**
1626  * Log channel info.
1627  *
1628  * @param ch Channel.
1629  */
1630 void
1631 GCCH_debug (struct CadetChannel *ch)
1632 {
1633   if (NULL == ch)
1634   {
1635     LOG (GNUNET_ERROR_TYPE_DEBUG, "*** DEBUG NULL CHANNEL ***\n");
1636     return;
1637   }
1638   LOG (GNUNET_ERROR_TYPE_DEBUG, "Channel %s:%X (%p)\n",
1639               GCT_2s (ch->t), ch->gid, ch);
1640   LOG (GNUNET_ERROR_TYPE_DEBUG, "  root %p/%p\n",
1641               ch->root, ch->root_rel);
1642   if (NULL != ch->root)
1643   {
1644     LOG (GNUNET_ERROR_TYPE_DEBUG, "  cli %s\n", GML_2s (ch->root));
1645     LOG (GNUNET_ERROR_TYPE_DEBUG, "  ready %s\n",
1646                 ch->root_rel->client_ready ? "YES" : "NO");
1647     LOG (GNUNET_ERROR_TYPE_DEBUG, "  id %X\n", ch->lid_root);
1648   }
1649   LOG (GNUNET_ERROR_TYPE_DEBUG, "  dest %p/%p\n",
1650               ch->dest, ch->dest_rel);
1651   if (NULL != ch->dest)
1652   {
1653     LOG (GNUNET_ERROR_TYPE_DEBUG, "  cli %s\n", GML_2s (ch->dest));
1654     LOG (GNUNET_ERROR_TYPE_DEBUG, "  ready %s\n",
1655                 ch->dest_rel->client_ready ? "YES" : "NO");
1656     LOG (GNUNET_ERROR_TYPE_DEBUG, "  id %X\n", ch->lid_dest);
1657   }
1658 }
1659
1660
1661 /**
1662  * Handle an ACK given by a client.
1663  *
1664  * Mark client as ready and send him any buffered data we could have for him.
1665  *
1666  * @param ch Channel.
1667  * @param fwd Is this a "FWD ACK"? (FWD ACKs are sent by dest and go BCK)
1668  */
1669 void
1670 GCCH_handle_local_ack (struct CadetChannel *ch, int fwd)
1671 {
1672   struct CadetChannelReliability *rel;
1673   struct CadetClient *c;
1674
1675   rel = fwd ? ch->dest_rel : ch->root_rel;
1676   c   = fwd ? ch->dest     : ch->root;
1677
1678   rel->client_ready = GNUNET_YES;
1679   send_client_buffered_data (ch, c, fwd);
1680
1681   if (GNUNET_YES == ch->destroy && 0 == rel->n_recv)
1682   {
1683     send_destroy (ch, GNUNET_YES);
1684     GCCH_destroy (ch);
1685   }
1686   /* if loopback is marked for destruction, no need to ACK to the other peer,
1687    * it requested the destruction and is already gone, therefore, else if.
1688    */
1689   else if (is_loopback (ch))
1690   {
1691     unsigned int buffer;
1692
1693     buffer = GCCH_get_buffer (ch, fwd);
1694     if (0 < buffer)
1695       GCCH_allow_client (ch, fwd);
1696
1697     return;
1698   }
1699   GCT_send_connection_acks (ch->t);
1700 }
1701
1702
1703 /**
1704  * Handle data given by a client.
1705  *
1706  * Check whether the client is allowed to send in this tunnel, save if channel
1707  * is reliable and send an ACK to the client if there is still buffer space
1708  * in the tunnel.
1709  *
1710  * @param ch Channel.
1711  * @param c Client which sent the data.
1712  * @param message Message.
1713  * @param fwd Is this a FWD data?
1714  *
1715  * @return GNUNET_OK if everything goes well, GNUNET_SYSERR in case of en error.
1716  */
1717 int
1718 GCCH_handle_local_data (struct CadetChannel *ch,
1719                         struct CadetClient *c,
1720                         struct GNUNET_MessageHeader *message,
1721                         int fwd)
1722 {
1723   struct CadetChannelReliability *rel;
1724   struct GNUNET_CADET_Data *payload;
1725   size_t size = ntohs (message->size);
1726   uint16_t p2p_size = sizeof(struct GNUNET_CADET_Data) + size;
1727   unsigned char cbuf[p2p_size];
1728
1729   /* Is the client in the channel? */
1730   if ( !( (fwd &&
1731            ch->root == c)
1732          ||
1733           (!fwd &&
1734            ch->dest == c) ) )
1735   {
1736     GNUNET_break_op (0);
1737     return GNUNET_SYSERR;
1738   }
1739
1740   rel = fwd ? ch->root_rel : ch->dest_rel;
1741
1742   if (GNUNET_NO == rel->client_allowed)
1743   {
1744     GNUNET_break_op (0);
1745     return GNUNET_SYSERR;
1746   }
1747
1748   rel->client_allowed = GNUNET_NO;
1749
1750   /* Ok, everything is correct, send the message. */
1751   payload = (struct GNUNET_CADET_Data *) cbuf;
1752   payload->mid = htonl (rel->mid_send);
1753   rel->mid_send++;
1754   memcpy (&payload[1], message, size);
1755   payload->header.size = htons (p2p_size);
1756   payload->header.type = htons (GNUNET_MESSAGE_TYPE_CADET_DATA);
1757   payload->chid = htonl (ch->gid);
1758   LOG (GNUNET_ERROR_TYPE_DEBUG, "  sending on channel...\n");
1759   GCCH_send_prebuilt_message (&payload->header, ch, fwd, NULL);
1760
1761   if (is_loopback (ch))
1762   {
1763     if (GCCH_get_buffer (ch, fwd) > 0)
1764       GCCH_allow_client (ch, fwd);
1765
1766     return GNUNET_OK;
1767   }
1768
1769   if (GCT_get_connections_buffer (ch->t) > 0)
1770   {
1771     GCCH_allow_client (ch, fwd);
1772   }
1773
1774   return GNUNET_OK;
1775 }
1776
1777
1778 /**
1779  * Handle a channel destroy requested by a client.
1780  *
1781  * TODO: add "reason" field
1782  *
1783  * Destroy the channel and the tunnel in case this was the last channel.
1784  *
1785  * @param ch Channel.
1786  * @param c Client that requested the destruction (to avoid notifying him).
1787  * @param is_root Is the request coming from root?
1788  */
1789 void
1790 GCCH_handle_local_destroy (struct CadetChannel *ch,
1791                            struct CadetClient *c,
1792                            int is_root)
1793 {
1794   ch->destroy = GNUNET_YES;
1795   /* Cleanup after the tunnel */
1796   if (GNUNET_NO == is_root && c == ch->dest)
1797   {
1798     LOG (GNUNET_ERROR_TYPE_DEBUG, " Client %s is destination.\n", GML_2s (c));
1799     GML_client_delete_channel (c, ch, ch->lid_dest);
1800     ch->dest = NULL;
1801   }
1802   if (GNUNET_YES == is_root && c == ch->root)
1803   {
1804     LOG (GNUNET_ERROR_TYPE_DEBUG, " Client %s is owner.\n", GML_2s (c));
1805     GML_client_delete_channel (c, ch, ch->lid_root);
1806     ch->root = NULL;
1807   }
1808
1809   send_destroy (ch, GNUNET_NO);
1810   if (0 == ch->pending_messages)
1811     GCCH_destroy (ch);
1812 }
1813
1814
1815 /**
1816  * Handle a channel create requested by a client.
1817  *
1818  * Create the channel and the tunnel in case this was the first0 channel.
1819  *
1820  * @param c Client that requested the creation (will be the root).
1821  * @param msg Create Channel message.
1822  *
1823  * @return GNUNET_OK if everything went fine, GNUNET_SYSERR otherwise.
1824  */
1825 int
1826 GCCH_handle_local_create (struct CadetClient *c,
1827                           struct GNUNET_CADET_ChannelMessage *msg)
1828 {
1829   struct CadetChannel *ch;
1830   struct CadetTunnel *t;
1831   struct CadetPeer *peer;
1832   CADET_ChannelNumber chid;
1833
1834   LOG (GNUNET_ERROR_TYPE_DEBUG, "  towards %s:%u\n",
1835               GNUNET_i2s (&msg->peer), ntohl (msg->port));
1836   chid = ntohl (msg->channel_id);
1837
1838   /* Sanity check for duplicate channel IDs */
1839   if (NULL != GML_channel_get (c, chid))
1840   {
1841     GNUNET_break (0);
1842     return GNUNET_SYSERR;
1843   }
1844
1845   peer = GCP_get (&msg->peer);
1846   GCP_add_tunnel (peer);
1847   t = GCP_get_tunnel (peer);
1848
1849   if (GCP_get_short_id (peer) == myid)
1850   {
1851     GCT_change_cstate (t, CADET_TUNNEL_READY);
1852   }
1853   else
1854   {
1855     /* FIXME change to a tunnel API, eliminate ch <-> peer connection */
1856     GCP_connect (peer);
1857   }
1858
1859   /* Create channel */
1860   ch = channel_new (t, c, chid);
1861   if (NULL == ch)
1862   {
1863     GNUNET_break (0);
1864     return GNUNET_SYSERR;
1865   }
1866   ch->port = ntohl (msg->port);
1867   channel_set_options (ch, ntohl (msg->opt));
1868
1869   /* In unreliable channels, we'll use the DLL to buffer BCK data */
1870   ch->root_rel = GNUNET_new (struct CadetChannelReliability);
1871   ch->root_rel->ch = ch;
1872   ch->root_rel->retry_timer = CADET_RETRANSMIT_TIME;
1873   ch->root_rel->expected_delay.rel_value_us = 0;
1874
1875   LOG (GNUNET_ERROR_TYPE_DEBUG, "CREATED CHANNEL %s\n", GCCH_2s (ch));
1876
1877   send_create (ch);
1878
1879   return GNUNET_OK;
1880 }
1881
1882
1883 /**
1884  * Handler for cadet network payload traffic.
1885  *
1886  * @param ch Channel for the message.
1887  * @param msg Unencryted data message.
1888  * @param fwd Is this message fwd? This only is meaningful in loopback channels.
1889  *            #GNUNET_YES if message is FWD on the respective channel (loopback)
1890  *            #GNUNET_NO if message is BCK on the respective channel (loopback)
1891  *            #GNUNET_SYSERR if message on a one-ended channel (remote)
1892  */
1893 void
1894 GCCH_handle_data (struct CadetChannel *ch,
1895                   const struct GNUNET_CADET_Data *msg,
1896                   int fwd)
1897 {
1898   struct CadetChannelReliability *rel;
1899   struct CadetClient *c;
1900   uint32_t mid;
1901
1902   /* If this is a remote (non-loopback) channel, find 'fwd'. */
1903   if (GNUNET_SYSERR == fwd)
1904   {
1905     if (is_loopback (ch))
1906     {
1907       /* It is a loopback channel after all... */
1908       GNUNET_break (0);
1909       return;
1910     }
1911     fwd = (NULL != ch->dest) ? GNUNET_YES : GNUNET_NO;
1912   }
1913
1914   /*  Initialize FWD/BCK data */
1915   c   = fwd ? ch->dest     : ch->root;
1916   rel = fwd ? ch->dest_rel : ch->root_rel;
1917
1918   if (NULL == c)
1919   {
1920     GNUNET_break (GNUNET_NO != ch->destroy);
1921     return;
1922   }
1923
1924   if (CADET_CHANNEL_READY != ch->state)
1925   {
1926     if (GNUNET_NO == fwd)
1927     {
1928       /* If we are the root, this means the other peer has sent traffic before
1929        * receiving our ACK. Even if the SYNACK goes missing, no traffic should
1930        * be sent before the ACK.
1931        */
1932       GNUNET_break_op (0);
1933       return;
1934     }
1935     /* If we are the dest, this means that the SYNACK got to the root but
1936      * the ACK went missing. Treat this as an ACK.
1937      */
1938     channel_confirm (ch, GNUNET_NO);
1939   }
1940
1941   GNUNET_STATISTICS_update (stats, "# data received", 1, GNUNET_NO);
1942
1943   mid = ntohl (msg->mid);
1944   LOG (GNUNET_ERROR_TYPE_INFO, "<=== DATA %u %s on channel %s\n",
1945        mid, GC_f2s (fwd), GCCH_2s (ch));
1946
1947   if (GNUNET_NO == ch->reliable ||
1948       ( !GC_is_pid_bigger (rel->mid_recv, mid) &&
1949         GC_is_pid_bigger (rel->mid_recv + 64, mid) ) )
1950   {
1951     LOG (GNUNET_ERROR_TYPE_DEBUG, "RECV %u (%u)\n",
1952          mid, ntohs (msg->header.size));
1953     if (GNUNET_YES == ch->reliable)
1954     {
1955       /* Is this the exact next expected messasge? */
1956       if (mid == rel->mid_recv)
1957       {
1958         LOG (GNUNET_ERROR_TYPE_DEBUG, "as expected, sending to client\n");
1959         send_client_data (ch, msg, fwd);
1960       }
1961       else
1962       {
1963         LOG (GNUNET_ERROR_TYPE_DEBUG, "save for later\n");
1964         add_buffered_data (msg, rel);
1965       }
1966     }
1967     else
1968     {
1969       /* Tunnel is unreliable: send to clients directly */
1970       /* FIXME: accept Out Of Order traffic */
1971       rel->mid_recv = mid + 1;
1972       send_client_data (ch, msg, fwd);
1973     }
1974   }
1975   else
1976   {
1977     if (GC_is_pid_bigger (rel->mid_recv, mid))
1978     {
1979       GNUNET_break_op (0);
1980       LOG (GNUNET_ERROR_TYPE_WARNING,
1981           "MID %u on channel %s not expected (window: %u - %u). Dropping!\n",
1982           mid, GCCH_2s (ch), rel->mid_recv, rel->mid_recv + 63);
1983     }
1984     else
1985     {
1986       LOG (GNUNET_ERROR_TYPE_WARNING,
1987            "Duplicate MID %u, channel %s (expecting MID %u). Re-sending ACK!\n",
1988            mid, GCCH_2s (ch), rel->mid_recv);
1989       if (NULL != rel->uniq)
1990       {
1991         LOG (GNUNET_ERROR_TYPE_WARNING,
1992             "We are trying to send an ACK, but don't seem have the "
1993             "bandwidth. Try to increase your ats QUOTA in you config file\n");
1994       }
1995
1996     }
1997   }
1998
1999   GCCH_send_data_ack (ch, fwd);
2000 }
2001
2002
2003 /**
2004  * Handler for cadet network traffic end-to-end ACKs.
2005  *
2006  * @param ch Channel on which we got this message.
2007  * @param msg Data message.
2008  * @param fwd Is this message fwd? This only is meaningful in loopback channels.
2009  *            #GNUNET_YES if message is FWD on the respective channel (loopback)
2010  *            #GNUNET_NO if message is BCK on the respective channel (loopback)
2011  *            #GNUNET_SYSERR if message on a one-ended channel (remote)
2012  */
2013 void
2014 GCCH_handle_data_ack (struct CadetChannel *ch,
2015                       const struct GNUNET_CADET_DataACK *msg,
2016                       int fwd)
2017 {
2018   struct CadetChannelReliability *rel;
2019   struct CadetReliableMessage *copy;
2020   struct CadetReliableMessage *next;
2021   uint32_t ack;
2022   int work;
2023
2024   /* If this is a remote (non-loopback) channel, find 'fwd'. */
2025   if (GNUNET_SYSERR == fwd)
2026   {
2027     if (is_loopback (ch))
2028     {
2029       /* It is a loopback channel after all... */
2030       GNUNET_break (0);
2031       return;
2032     }
2033     /* Inverted: if message came 'FWD' is a 'BCK ACK'. */
2034     fwd = (NULL != ch->dest) ? GNUNET_NO : GNUNET_YES;
2035   }
2036
2037   ack = ntohl (msg->mid);
2038   LOG (GNUNET_ERROR_TYPE_INFO, "<=== %s ACK %u + %llX\n",
2039        GC_f2s (fwd), ack, msg->futures);
2040
2041   if (GNUNET_YES == fwd)
2042   {
2043     rel = ch->root_rel;
2044   }
2045   else
2046   {
2047     rel = ch->dest_rel;
2048   }
2049   if (NULL == rel)
2050   {
2051     GNUNET_break_op (GNUNET_NO != ch->destroy);
2052     return;
2053   }
2054
2055   /* Free ACK'd copies: no need to retransmit those anymore FIXME refactor */
2056   for (work = GNUNET_NO, copy = rel->head_sent; copy != NULL; copy = next)
2057   {
2058     if (GC_is_pid_bigger (copy->mid, ack))
2059     {
2060       LOG (GNUNET_ERROR_TYPE_DEBUG, "  head %u, out!\n", copy->mid);
2061       channel_rel_free_sent (rel, msg);
2062       break;
2063     }
2064     work = GNUNET_YES;
2065     LOG (GNUNET_ERROR_TYPE_DEBUG, "  id %u\n", copy->mid);
2066     next = copy->next;
2067     if (GNUNET_YES == rel_message_free (copy, GNUNET_YES))
2068       return;
2069   }
2070
2071   /* ACK client if needed and possible */
2072   GCCH_allow_client (ch, fwd);
2073
2074   /* If some message was free'd, update the retransmission delay */
2075   if (GNUNET_YES == work)
2076   {
2077     if (GNUNET_SCHEDULER_NO_TASK != rel->retry_task)
2078     {
2079       GNUNET_SCHEDULER_cancel (rel->retry_task);
2080       rel->retry_task = GNUNET_SCHEDULER_NO_TASK;
2081       if (NULL != rel->head_sent && NULL == rel->head_sent->chq)
2082       {
2083         struct GNUNET_TIME_Absolute new_target;
2084         struct GNUNET_TIME_Relative delay;
2085
2086         delay = GNUNET_TIME_relative_multiply (rel->retry_timer,
2087                                                CADET_RETRANSMIT_MARGIN);
2088         new_target = GNUNET_TIME_absolute_add (rel->head_sent->timestamp,
2089                                                delay);
2090         delay = GNUNET_TIME_absolute_get_remaining (new_target);
2091         rel->retry_task =
2092             GNUNET_SCHEDULER_add_delayed (delay,
2093                                           &channel_retransmit_message,
2094                                           rel);
2095       }
2096     }
2097     else
2098     {
2099       /* Work was done but no task was pending? Shouldn't happen! */
2100       GNUNET_break (0);
2101     }
2102   }
2103 }
2104
2105
2106 /**
2107  * Handler for channel create messages.
2108  *
2109  * Does not have fwd parameter because it's always 'FWD': channel is incoming.
2110  *
2111  * @param t Tunnel this channel will be in.
2112  * @param msg Channel crate message.
2113  */
2114 struct CadetChannel *
2115 GCCH_handle_create (struct CadetTunnel *t,
2116                     const struct GNUNET_CADET_ChannelCreate *msg)
2117 {
2118   CADET_ChannelNumber chid;
2119   struct CadetChannel *ch;
2120   struct CadetClient *c;
2121   int new_channel;
2122
2123   chid = ntohl (msg->chid);
2124   ch = GCT_get_channel (t, chid);
2125   if (NULL == ch)
2126   {
2127     /* Create channel */
2128     ch = channel_new (t, NULL, 0);
2129     ch->gid = chid;
2130     channel_set_options (ch, ntohl (msg->opt));
2131     new_channel = GNUNET_YES;
2132   }
2133   else
2134   {
2135     new_channel = GNUNET_NO;
2136   }
2137
2138   if (GNUNET_YES == new_channel || GCT_is_loopback (t))
2139   {
2140     /* Find a destination client */
2141     ch->port = ntohl (msg->port);
2142     LOG (GNUNET_ERROR_TYPE_DEBUG, "   port %u\n", ch->port);
2143     c = GML_client_get_by_port (ch->port);
2144     if (NULL == c)
2145     {
2146       LOG (GNUNET_ERROR_TYPE_DEBUG, "  no client has port registered\n");
2147       if (is_loopback (ch))
2148       {
2149         LOG (GNUNET_ERROR_TYPE_DEBUG, "  loopback: destroy on handler\n");
2150         send_nack (ch);
2151       }
2152       else
2153       {
2154         LOG (GNUNET_ERROR_TYPE_DEBUG, "  not loopback: destroy now\n");
2155         send_nack (ch);
2156         GCCH_destroy (ch);
2157       }
2158       return NULL;
2159     }
2160     else
2161     {
2162       LOG (GNUNET_ERROR_TYPE_DEBUG, "  client %p has port registered\n", c);
2163     }
2164
2165     add_destination (ch, c);
2166     if (GNUNET_YES == ch->reliable)
2167       LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! Reliable\n");
2168     else
2169       LOG (GNUNET_ERROR_TYPE_DEBUG, "!!! Not Reliable\n");
2170
2171     send_client_create (ch);
2172     ch->state =  CADET_CHANNEL_SENT;
2173   }
2174   else
2175   {
2176     LOG (GNUNET_ERROR_TYPE_DEBUG, "  duplicate create channel\n");
2177     if (GNUNET_SCHEDULER_NO_TASK != ch->dest_rel->retry_task)
2178     {
2179       LOG (GNUNET_ERROR_TYPE_DEBUG, "  clearing retry task\n");
2180       /* we were waiting to re-send our 'SYNACK', wait no more! */
2181       GNUNET_SCHEDULER_cancel (ch->dest_rel->retry_task);
2182       ch->dest_rel->retry_task = GNUNET_SCHEDULER_NO_TASK;
2183     }
2184     else if (NULL != ch->dest_rel->uniq)
2185     {
2186       /* we are waiting to for our 'SYNACK' to leave the queue, all done! */
2187       return ch;
2188     }
2189   }
2190   send_ack (ch, GNUNET_YES);
2191
2192   return ch;
2193 }
2194
2195
2196 /**
2197  * Handler for channel NACK messages.
2198  *
2199  * NACK messages always go dest -> root, no need for 'fwd' or 'msg' parameter.
2200  *
2201  * @param ch Channel.
2202  */
2203 void
2204 GCCH_handle_nack (struct CadetChannel *ch)
2205 {
2206   send_client_nack (ch);
2207   GCCH_destroy (ch);
2208 }
2209
2210
2211 /**
2212  * Handler for channel ack messages.
2213  *
2214  * @param ch Channel.
2215  * @param msg Message.
2216  * @param fwd Is this message fwd? This only is meaningful in loopback channels.
2217  *            #GNUNET_YES if message is FWD on the respective channel (loopback)
2218  *            #GNUNET_NO if message is BCK on the respective channel (loopback)
2219  *            #GNUNET_SYSERR if message on a one-ended channel (remote)
2220  */
2221 void
2222 GCCH_handle_ack (struct CadetChannel *ch,
2223                  const struct GNUNET_CADET_ChannelManage *msg,
2224                  int fwd)
2225 {
2226   /* If this is a remote (non-loopback) channel, find 'fwd'. */
2227   if (GNUNET_SYSERR == fwd)
2228   {
2229     if (is_loopback (ch))
2230     {
2231       /* It is a loopback channel after all... */
2232       GNUNET_break (0);
2233       return;
2234     }
2235     fwd = (NULL != ch->dest) ? GNUNET_YES : GNUNET_NO;
2236   }
2237
2238   channel_confirm (ch, !fwd);
2239 }
2240
2241
2242 /**
2243  * Handler for channel destroy messages.
2244  *
2245  * @param ch Channel to be destroyed of.
2246  * @param msg Message.
2247  * @param fwd Is this message fwd? This only is meaningful in loopback channels.
2248  *            #GNUNET_YES if message is FWD on the respective channel (loopback)
2249  *            #GNUNET_NO if message is BCK on the respective channel (loopback)
2250  *            #GNUNET_SYSERR if message on a one-ended channel (remote)
2251  */
2252 void
2253 GCCH_handle_destroy (struct CadetChannel *ch,
2254                      const struct GNUNET_CADET_ChannelManage *msg,
2255                      int fwd)
2256 {
2257   struct CadetChannelReliability *rel;
2258
2259   /* If this is a remote (non-loopback) channel, find 'fwd'. */
2260   if (GNUNET_SYSERR == fwd)
2261   {
2262     if (is_loopback (ch))
2263     {
2264       /* It is a loopback channel after all... */
2265       GNUNET_break (0);
2266       return;
2267     }
2268     fwd = (NULL != ch->dest) ? GNUNET_YES : GNUNET_NO;
2269   }
2270
2271   GCCH_debug (ch);
2272   if ( (fwd && NULL == ch->dest) || (!fwd && NULL == ch->root) )
2273   {
2274     /* Not for us (don't destroy twice a half-open loopback channel) */
2275     return;
2276   }
2277
2278   rel = fwd ? ch->dest_rel : ch->root_rel;
2279   if (0 == rel->n_recv)
2280   {
2281     send_destroy (ch, GNUNET_YES);
2282     GCCH_destroy (ch);
2283   }
2284   else
2285   {
2286     ch->destroy = GNUNET_YES;
2287   }
2288 }
2289
2290
2291 /**
2292  * Sends an already built message on a channel.
2293  *
2294  * If the channel is on a loopback tunnel, notifies the appropriate destination
2295  * client locally.
2296  *
2297  * On a normal channel passes the message to the tunnel for encryption and
2298  * sending on a connection.
2299  *
2300  * This function DOES NOT save the message for retransmission.
2301  *
2302  * @param message Message to send. Function makes a copy of it.
2303  * @param ch Channel on which this message is transmitted.
2304  * @param fwd Is this a fwd message?
2305  * @param existing_copy This is a retransmission, don't save a copy.
2306  */
2307 void
2308 GCCH_send_prebuilt_message (const struct GNUNET_MessageHeader *message,
2309                             struct CadetChannel *ch, int fwd,
2310                             void *existing_copy)
2311 {
2312   struct CadetChannelQueue *chq;
2313   uint16_t type;
2314
2315   type = ntohs (message->type);
2316   LOG (GNUNET_ERROR_TYPE_INFO, "===> %s %s on channel %s\n",
2317        GC_m2s (type), GC_f2s (fwd), GCCH_2s (ch));
2318
2319   if (GCT_is_loopback (ch->t))
2320   {
2321     handle_loopback (ch, message, fwd);
2322     return;
2323   }
2324
2325   switch (type)
2326   {
2327     struct GNUNET_CADET_Data *payload;
2328     case GNUNET_MESSAGE_TYPE_CADET_DATA:
2329
2330       payload = (struct GNUNET_CADET_Data *) message;
2331       LOG (GNUNET_ERROR_TYPE_INFO, "===> %s %u\n",
2332            GC_m2s (type), ntohl (payload->mid));
2333       if (GNUNET_YES == ch->reliable)
2334       {
2335         chq = GNUNET_new (struct CadetChannelQueue);
2336         chq->type = type;
2337         if (NULL == existing_copy)
2338           chq->copy = channel_save_copy (ch, message, fwd);
2339         else
2340         {
2341           chq->copy = (struct CadetReliableMessage *) existing_copy;
2342           if (NULL != chq->copy->chq)
2343           {
2344             /* Last retransmission was queued but not yet sent!
2345              * This retransmission was scheduled by a ch_message_sent which
2346              * followed a very fast RTT, so the tiny delay made the
2347              * retransmission function to execute before the previous
2348              * retransmitted message even had a chance to leave the peer.
2349              * Cancel this message and wait until the pending
2350              * retransmission leaves the peer and ch_message_sent starts
2351              * the timer for the next one.
2352              */
2353             GNUNET_free (chq);
2354             LOG (GNUNET_ERROR_TYPE_DEBUG,
2355                  "  exisitng copy not yet transmitted!\n");
2356             return;
2357           }
2358           LOG (GNUNET_ERROR_TYPE_DEBUG,
2359                "  using existing copy: %p {r:%p q:%p t:%u}\n",
2360                existing_copy,
2361                chq->copy->rel, chq->copy->chq, chq->copy->type);
2362         }
2363         LOG (GNUNET_ERROR_TYPE_DEBUG, "  new chq: %p\n", chq);
2364             chq->copy->chq = chq;
2365             chq->tq = GCT_send_prebuilt_message (message, ch->t, NULL,
2366                                                  NULL != existing_copy,
2367                                                  &ch_message_sent, chq);
2368         /* q itself is stored in copy */
2369         GNUNET_assert (NULL != chq->tq || GNUNET_NO != ch->destroy);
2370       }
2371       else
2372       {
2373         fire_and_forget (message, ch, GNUNET_NO);
2374       }
2375       break;
2376
2377
2378     case GNUNET_MESSAGE_TYPE_CADET_DATA_ACK:
2379     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_CREATE:
2380     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_ACK:
2381       chq = GNUNET_new (struct CadetChannelQueue);
2382       chq->type = type;
2383       chq->rel = fwd ? ch->root_rel : ch->dest_rel;
2384       if (NULL != chq->rel->uniq)
2385       {
2386         if (NULL != chq->rel->uniq->tq)
2387         {
2388           GCT_cancel (chq->rel->uniq->tq);
2389           /* ch_message_sent is called, freeing and NULLing uniq */
2390           GNUNET_break (NULL == chq->rel->uniq);
2391         }
2392         else
2393         {
2394           GNUNET_break (0);
2395           GNUNET_free (chq->rel->uniq);
2396         }
2397       }
2398
2399       chq->tq = GCT_send_prebuilt_message (message, ch->t, NULL, GNUNET_YES,
2400                                            &ch_message_sent, chq);
2401       if (NULL == chq->tq)
2402       {
2403         GNUNET_break (0);
2404         GCT_debug (ch->t, GNUNET_ERROR_TYPE_ERROR);
2405         GNUNET_free (chq);
2406         chq = NULL;
2407         return;
2408       }
2409       chq->rel->uniq = chq;
2410       break;
2411
2412
2413     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_DESTROY:
2414     case GNUNET_MESSAGE_TYPE_CADET_CHANNEL_NACK:
2415       fire_and_forget (message, ch, GNUNET_YES);
2416       break;
2417
2418
2419     default:
2420       GNUNET_break (0);
2421       LOG (GNUNET_ERROR_TYPE_DEBUG, "type %s unknown!\n", GC_m2s (type));
2422       fire_and_forget (message, ch, GNUNET_YES);
2423   }
2424 }
2425
2426
2427 /**
2428  * Get the static string for identification of the channel.
2429  *
2430  * @param ch Channel.
2431  *
2432  * @return Static string with the channel IDs.
2433  */
2434 const char *
2435 GCCH_2s (const struct CadetChannel *ch)
2436 {
2437   static char buf[64];
2438
2439   if (NULL == ch)
2440     return "(NULL Channel)";
2441
2442   SPRINTF (buf, "%s:%u gid:%X (%X / %X)",
2443            GCT_2s (ch->t), ch->port, ch->gid, ch->lid_root, ch->lid_dest);
2444
2445   return buf;
2446 }