2 This file is part of GNUnet.
3 (C) 2009 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 2, 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.
22 * @file transport/transport_api.c
23 * @brief library to access the low-level P2P IO service
24 * @author Christian Grothoff
27 #include "gnunet_client_lib.h"
28 #include "gnunet_arm_service.h"
29 #include "gnunet_hello_lib.h"
30 #include "gnunet_protocols.h"
31 #include "gnunet_server_lib.h"
32 #include "gnunet_time_lib.h"
33 #include "gnunet_transport_service.h"
34 #include "transport.h"
37 * After how long do we give up on transmitting a HELLO
40 #define OFFER_HELLO_TIMEOUT GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 30)
43 * After how long do we automatically retry an unsuccessful
46 #define CONNECT_RETRY_TIMEOUT GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MILLISECONDS, 750)
49 * How long should ARM wait when starting up the
50 * transport service before reporting back?
52 #define START_SERVICE_TIMEOUT GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 5)
55 * How long should ARM wait when stopping the
56 * transport service before reporting back?
58 #define STOP_SERVICE_TIMEOUT GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_SECONDS, 5)
61 * Entry in linked list of all of our current neighbours.
67 * This is a linked list.
69 struct NeighbourList *next;
72 * Active transmit handle, can be NULL. Used to move
73 * from ready to wait list on disconnect and to block
74 * two transmissions to the same peer from being scheduled
77 struct GNUNET_TRANSPORT_TransmitHandle *transmit_handle;
80 * Identity of this neighbour.
82 struct GNUNET_PeerIdentity id;
85 * At what time did we reset last_sent last?
87 struct GNUNET_TIME_Absolute last_quota_update;
90 * How many bytes have we sent since the "last_quota_update"
96 * Quota for outbound traffic to the neighbour in bytes/ms.
101 * Set to GNUNET_YES if we are currently allowed to
102 * transmit a message to the transport service for this
103 * peer, GNUNET_NO otherwise.
108 * Set to GNUNET_YES if we have received an ACK for the
109 * given peer. Peers that receive our HELLO always respond
110 * with an ACK to let us know that we are successfully
111 * communicating. Note that a PING can not be used for this
112 * since PINGs are only send if a HELLO address requires
113 * confirmation (and also, PINGs are not passed to the
114 * transport API itself).
122 * Linked list of requests from clients for our HELLO
123 * that were deferred.
129 * This is a linked list.
131 struct HelloWaitList *next;
134 * Reference back to our transport handle.
136 struct GNUNET_TRANSPORT_Handle *handle;
139 * Callback to call once we got our HELLO.
141 GNUNET_TRANSPORT_HelloUpdateCallback rec;
149 * When to time out (call rec with NULL).
151 struct GNUNET_TIME_Absolute timeout;
154 * Timeout task (used to trigger timeout,
155 * cancel if we get the HELLO in time).
157 GNUNET_SCHEDULER_TaskIdentifier task;
164 * Opaque handle for a transmission-ready request.
166 struct GNUNET_TRANSPORT_TransmitHandle
170 * We keep the transmit handles that are waiting for
171 * a transport-level connection in a doubly linked list.
173 struct GNUNET_TRANSPORT_TransmitHandle *next;
176 * We keep the transmit handles that are waiting for
177 * a transport-level connection in a doubly linked list.
179 struct GNUNET_TRANSPORT_TransmitHandle *prev;
182 * Handle of the main transport data structure.
184 struct GNUNET_TRANSPORT_Handle *handle;
187 * Neighbour for this handle, can be NULL if the service
188 * is not yet connected to the target.
190 struct NeighbourList *neighbour;
193 * Which peer is this transmission going to be for? All
194 * zeros if it is control-traffic to the service.
196 struct GNUNET_PeerIdentity target;
199 * Function to call when notify_size bytes are available
202 GNUNET_CONNECTION_TransmitReadyNotify notify;
205 * Closure for notify.
210 * transmit_ready task Id. The task is used to introduce the
211 * artificial delay that may be required to maintain the bandwidth
212 * limits. Later, this will be the ID of the "transmit_timeout"
213 * task which is used to signal a timeout if the transmission could
214 * not be done in a timely fashion.
216 GNUNET_SCHEDULER_TaskIdentifier notify_delay_task;
219 * Timeout for this request.
221 struct GNUNET_TIME_Absolute timeout;
224 * How many bytes is our notify callback waiting for?
229 * How important is this message?
231 unsigned int priority;
237 * Handle for the transport service (includes all of the
238 * state for the transport service).
240 struct GNUNET_TRANSPORT_Handle
244 * Closure for the callbacks.
249 * Function to call for received data.
251 GNUNET_TRANSPORT_ReceiveCallback rec;
254 * function to call on connect events
256 GNUNET_TRANSPORT_NotifyConnect nc_cb;
259 * function to call on disconnect events
261 GNUNET_TRANSPORT_NotifyDisconnect nd_cb;
264 * The current HELLO message for this peer. Updated
265 * whenever transports change their addresses.
267 struct GNUNET_HELLO_Message *my_hello;
270 * My client connection to the transport service.
272 struct GNUNET_CLIENT_Connection *client;
275 * Handle to our registration with the client for notification.
277 struct GNUNET_CLIENT_TransmitHandle *network_handle;
280 * Linked list of transmit handles that are waiting for the
281 * transport to connect to the respective peer. When we
282 * receive notification that the transport connected to a
283 * peer, we go over this list and check if someone has already
284 * requested a transmission to the new peer; if so, we trigger
287 struct GNUNET_TRANSPORT_TransmitHandle *connect_wait_head;
290 * Linked list of transmit handles that are waiting for the
291 * transport to be ready for transmission to the respective
293 * receive notification that the transport disconnected from
294 * a peer, we go over this list and move the entry back to
295 * the connect_wait list.
297 struct GNUNET_TRANSPORT_TransmitHandle *connect_ready_head;
300 * Linked list of pending requests for our HELLO.
302 struct HelloWaitList *hwl_head;
307 struct GNUNET_SCHEDULER_Handle *sched;
312 const struct GNUNET_CONFIGURATION_Handle *cfg;
315 * Linked list of the current neighbours of this peer.
317 struct NeighbourList *neighbours;
320 * ID of the task trying to reconnect to the
323 GNUNET_SCHEDULER_TaskIdentifier reconnect_task;
326 * Delay until we try to reconnect.
328 struct GNUNET_TIME_Relative reconnect_delay;
331 * Do we currently have a transmission pending?
332 * (schedule transmission was called but has not
335 int transmission_scheduled;
339 static struct NeighbourList *
340 find_neighbour (struct GNUNET_TRANSPORT_Handle *h,
341 const struct GNUNET_PeerIdentity *peer)
343 struct NeighbourList *pos;
346 while ((pos != NULL) &&
347 (0 != memcmp (peer, &pos->id, sizeof (struct GNUNET_PeerIdentity))))
354 * Schedule the task to send one message from the
355 * connect_ready list to the service.
357 static void schedule_transmission (struct GNUNET_TRANSPORT_Handle *h);
361 * Transmit message to client...
364 transport_notify_ready (void *cls, size_t size, void *buf)
366 struct GNUNET_TRANSPORT_Handle *h = cls;
367 struct GNUNET_TRANSPORT_TransmitHandle *th;
368 struct NeighbourList *n;
372 h->network_handle = NULL;
373 h->transmission_scheduled = GNUNET_NO;
377 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
378 "Could not transmit to transport service, cancelling pending requests\n");
380 th = h->connect_ready_head;
381 if (th->next != NULL)
382 th->next->prev = NULL;
383 h->connect_ready_head = th->next;
384 if (NULL != (n = th->neighbour))
386 GNUNET_assert (n->transmit_handle == th);
387 n->transmit_handle = NULL;
389 if (th->notify_delay_task != GNUNET_SCHEDULER_NO_TASK)
391 GNUNET_SCHEDULER_cancel (h->sched, th->notify_delay_task);
392 th->notify_delay_task = GNUNET_SCHEDULER_NO_TASK;
394 if (NULL != th->notify)
395 GNUNET_assert (0 == th->notify (th->notify_cls, 0, NULL));
397 if (h->connect_ready_head != NULL)
398 schedule_transmission (h); /* FIXME: is this ok? */
402 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
403 "Ready to transmit %u bytes to transport service\n", size);
407 h->network_handle = NULL;
408 h->transmission_scheduled = GNUNET_NO;
409 while ((h->connect_ready_head != NULL) &&
410 (h->connect_ready_head->notify_size <= size))
412 th = h->connect_ready_head;
413 if (th->notify_delay_task != GNUNET_SCHEDULER_NO_TASK)
415 GNUNET_SCHEDULER_cancel (h->sched, th->notify_delay_task);
416 th->notify_delay_task = GNUNET_SCHEDULER_NO_TASK;
418 GNUNET_assert (th->notify_size <= size);
419 if (th->next != NULL)
420 th->next->prev = NULL;
421 h->connect_ready_head = th->next;
422 if (NULL != (n = th->neighbour))
424 GNUNET_assert (n->transmit_handle == th);
425 n->transmit_handle = NULL;
427 if (NULL != th->notify)
428 ret += th->notify (th->notify_cls, size, &cbuf[ret]);
434 if (h->connect_ready_head != NULL)
435 schedule_transmission (h);
437 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
438 "Transmitting %u bytes to transport service\n", ret);
445 * Schedule the task to send one message from the
446 * connect_ready list to the service.
449 schedule_transmission (struct GNUNET_TRANSPORT_Handle *h)
451 struct GNUNET_TRANSPORT_TransmitHandle *th;
453 GNUNET_assert (NULL == h->network_handle);
454 if (h->client == NULL)
456 GNUNET_log (GNUNET_ERROR_TYPE_INFO,
457 "Could not yet schedule transmission: we are not yet connected to the transport service!\n");
458 return; /* not yet connected */
460 th = h->connect_ready_head;
462 return; /* no request pending */
463 if (th->notify_delay_task != GNUNET_SCHEDULER_NO_TASK)
465 /* remove existing time out task, will be integrated
466 with transmit_ready notification! */
467 GNUNET_SCHEDULER_cancel (h->sched, th->notify_delay_task);
468 th->notify_delay_task = GNUNET_SCHEDULER_NO_TASK;
470 h->transmission_scheduled = GNUNET_YES;
471 h->network_handle = GNUNET_CLIENT_notify_transmit_ready (h->client,
473 GNUNET_TIME_absolute_get_remaining
476 &transport_notify_ready,
478 GNUNET_assert (NULL != h->network_handle);
483 * Insert the given transmit handle in the given sorted
484 * doubly linked list based on timeout.
486 * @param head pointer to the head of the linked list
487 * @param th element to insert into the list
490 insert_transmit_handle (struct GNUNET_TRANSPORT_TransmitHandle **head,
491 struct GNUNET_TRANSPORT_TransmitHandle *th)
493 struct GNUNET_TRANSPORT_TransmitHandle *pos;
494 struct GNUNET_TRANSPORT_TransmitHandle *prev;
498 while ((pos != NULL) && (pos->timeout.value < th->timeout.value))
506 if (th->next != NULL)
522 * Cancel a pending notify delay task (if pending) and also remove the
523 * given transmit handle from whatever list is on.
525 * @param th handle for the transmission request to manipulate
528 remove_from_any_list (struct GNUNET_TRANSPORT_TransmitHandle *th)
530 struct GNUNET_TRANSPORT_Handle *h;
533 if (th->notify_delay_task != GNUNET_SCHEDULER_NO_TASK)
535 GNUNET_SCHEDULER_cancel (h->sched, th->notify_delay_task);
536 th->notify_delay_task = GNUNET_SCHEDULER_NO_TASK;
538 if (th->prev == NULL)
540 if (th == h->connect_wait_head)
541 h->connect_wait_head = th->next;
543 h->connect_ready_head = th->next;
547 th->prev->next = th->next;
549 if (th->next != NULL)
550 th->next->prev = th->prev;
555 * Schedule a request to connect to the given
556 * neighbour (and if successful, add the specified
557 * handle to the wait list).
559 * @param th handle for a request to transmit once we
562 static void try_connect (struct GNUNET_TRANSPORT_TransmitHandle *th);
566 * Called when our transmit request timed out before any transport
567 * reported success connecting to the desired peer or before the
568 * transport was ready to receive. Signal error and free
572 peer_transmit_timeout (void *cls,
573 const struct GNUNET_SCHEDULER_TaskContext *tc)
575 struct GNUNET_TRANSPORT_TransmitHandle *th = cls;
577 th->notify_delay_task = GNUNET_SCHEDULER_NO_TASK;
578 if (th->neighbour != NULL)
579 th->neighbour->transmit_handle = NULL;
581 GNUNET_log (GNUNET_ERROR_TYPE_INFO,
582 "Request for transmission to peer `%s' timed out.\n",
583 GNUNET_i2s (&th->target));
585 remove_from_any_list (th);
586 if (NULL != th->notify)
587 th->notify (th->notify_cls, 0, NULL);
595 * Queue control request for transmission to the transport
598 * @param h handle to the transport service
599 * @param size number of bytes to be transmitted
600 * @param at_head request must be added to the head of the queue
601 * (otherwise request will be appended)
602 * @param timeout how long this transmission can wait (at most)
603 * @param notify function to call to get the content
604 * @param notify_cls closure for notify
607 schedule_control_transmit (struct GNUNET_TRANSPORT_Handle *h,
610 struct GNUNET_TIME_Relative timeout,
611 GNUNET_CONNECTION_TransmitReadyNotify notify,
614 struct GNUNET_TRANSPORT_TransmitHandle *th;
617 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
618 "Control transmit of %u bytes within %llums requested\n",
619 size, (unsigned long long) timeout.value);
621 th = GNUNET_malloc (sizeof (struct GNUNET_TRANSPORT_TransmitHandle));
624 th->notify_cls = notify_cls;
625 th->timeout = GNUNET_TIME_relative_to_absolute (timeout);
626 th->notify_size = size;
627 th->notify_delay_task
628 = GNUNET_SCHEDULER_add_delayed (h->sched,
629 timeout, &peer_transmit_timeout, th);
632 th->next = h->connect_ready_head;
633 h->connect_ready_head = th;
634 if (th->next != NULL)
639 insert_transmit_handle (&h->connect_ready_head, th);
641 if (GNUNET_NO == h->transmission_scheduled)
642 schedule_transmission (h);
647 * Update the quota values for the given neighbour now.
650 update_quota (struct NeighbourList *n)
652 struct GNUNET_TIME_Relative delta;
656 delta = GNUNET_TIME_absolute_get_duration (n->last_quota_update);
657 allowed = delta.value * n->quota_out;
658 if (n->last_sent < allowed)
660 remaining = allowed - n->last_sent;
661 if (n->quota_out > 0)
662 remaining /= n->quota_out;
665 if (remaining > MAX_BANDWIDTH_CARRY)
666 remaining = MAX_BANDWIDTH_CARRY;
668 n->last_quota_update = GNUNET_TIME_absolute_get ();
669 n->last_quota_update.value -= remaining;
673 n->last_sent -= allowed;
674 n->last_quota_update = GNUNET_TIME_absolute_get ();
679 struct SetQuotaContext
681 struct GNUNET_TRANSPORT_Handle *handle;
683 struct GNUNET_PeerIdentity target;
685 GNUNET_SCHEDULER_Task cont;
689 struct GNUNET_TIME_Absolute timeout;
696 send_set_quota (void *cls, size_t size, void *buf)
698 struct SetQuotaContext *sqc = cls;
699 struct QuotaSetMessage *msg;
703 GNUNET_SCHEDULER_add_continuation (sqc->handle->sched,
706 GNUNET_SCHEDULER_REASON_TIMEOUT);
711 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
712 "Transmitting `%s' request with respect to `%4s'.\n",
713 "SET_QUOTA", GNUNET_i2s (&sqc->target));
715 GNUNET_assert (size >= sizeof (struct QuotaSetMessage));
717 msg->header.size = htons (sizeof (struct QuotaSetMessage));
718 msg->header.type = htons (GNUNET_MESSAGE_TYPE_TRANSPORT_SET_QUOTA);
719 msg->quota_in = htonl (sqc->quota_in);
720 memcpy (&msg->peer, &sqc->target, sizeof (struct GNUNET_PeerIdentity));
721 if (sqc->cont != NULL)
722 GNUNET_SCHEDULER_add_continuation (sqc->handle->sched,
725 GNUNET_SCHEDULER_REASON_PREREQ_DONE);
727 return sizeof (struct QuotaSetMessage);
732 * Set the share of incoming bandwidth for the given
733 * peer to the specified amount.
735 * @param handle connection to transport service
736 * @param target who's bandwidth quota is being changed
737 * @param quota_in incoming bandwidth quota in bytes per ms
738 * @param quota_out outgoing bandwidth quota in bytes per ms
739 * @param timeout how long to wait until signaling failure if
740 * we can not communicate the quota change
741 * @param cont continuation to call when done, will be called
742 * either with reason "TIMEOUT" or with reason "PREREQ_DONE"
743 * @param cont_cls closure for continuation
746 GNUNET_TRANSPORT_set_quota (struct GNUNET_TRANSPORT_Handle *handle,
747 const struct GNUNET_PeerIdentity *target,
750 struct GNUNET_TIME_Relative timeout,
751 GNUNET_SCHEDULER_Task cont, void *cont_cls)
753 struct NeighbourList *n;
754 struct SetQuotaContext *sqc;
756 n = find_neighbour (handle, target);
760 if (n->quota_out < quota_out)
761 n->last_quota_update = GNUNET_TIME_absolute_get ();
762 n->quota_out = quota_out;
764 sqc = GNUNET_malloc (sizeof (struct SetQuotaContext));
765 sqc->handle = handle;
766 sqc->target = *target;
768 sqc->cont_cls = cont_cls;
769 sqc->timeout = GNUNET_TIME_relative_to_absolute (timeout);
770 sqc->quota_in = quota_in;
771 schedule_control_transmit (handle,
772 sizeof (struct QuotaSetMessage),
773 GNUNET_NO, timeout, &send_set_quota, sqc);
778 * Obtain the HELLO message for this peer.
780 * @param handle connection to transport service
781 * @param timeout how long to wait for the HELLO
782 * @param rec function to call with the HELLO, sender will be our peer
783 * identity; message and sender will be NULL on timeout
784 * (handshake with transport service pending/failed).
785 * cost estimate will be 0.
786 * @param rec_cls closure for rec
789 GNUNET_TRANSPORT_get_hello (struct GNUNET_TRANSPORT_Handle *handle,
790 GNUNET_TRANSPORT_HelloUpdateCallback rec,
793 struct HelloWaitList *hwl;
795 hwl = GNUNET_malloc (sizeof (struct HelloWaitList));
796 hwl->next = handle->hwl_head;
797 handle->hwl_head = hwl;
798 hwl->handle = handle;
800 hwl->rec_cls = rec_cls;
801 if (handle->my_hello == NULL)
803 rec (rec_cls, (const struct GNUNET_MessageHeader *) handle->my_hello);
809 * Stop receiving updates about changes to our HELLO message.
811 * @param handle connection to transport service
812 * @param rec function previously registered to be called with the HELLOs
813 * @param rec_cls closure for rec
816 GNUNET_TRANSPORT_get_hello_cancel (struct GNUNET_TRANSPORT_Handle *handle,
817 GNUNET_TRANSPORT_HelloUpdateCallback rec,
820 struct HelloWaitList *pos;
821 struct HelloWaitList *prev;
824 pos = handle->hwl_head;
827 if ( (pos->rec == rec) &&
828 (pos->rec_cls == rec_cls) )
833 GNUNET_break (pos != NULL);
837 handle->hwl_head = pos->next;
839 prev->next = pos->next;
845 send_hello (void *cls, size_t size, void *buf)
847 struct GNUNET_MessageHeader *hello = cls;
853 GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
854 "Timeout while trying to transmit `%s' request.\n",
861 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
862 "Transmitting `%s' request.\n", "HELLO");
864 msize = ntohs (hello->size);
865 GNUNET_assert (size >= msize);
866 memcpy (buf, hello, msize);
873 * Offer the transport service the HELLO of another peer. Note that
874 * the transport service may just ignore this message if the HELLO is
875 * malformed or useless due to our local configuration.
877 * @param handle connection to transport service
878 * @param hello the hello message
881 GNUNET_TRANSPORT_offer_hello (struct GNUNET_TRANSPORT_Handle *handle,
882 const struct GNUNET_MessageHeader *hello)
884 struct GNUNET_MessageHeader *hc;
887 if (handle->client == NULL)
890 GNUNET_log (GNUNET_ERROR_TYPE_INFO,
891 "Not connected to transport service, dropping offered HELLO\n");
895 GNUNET_break (ntohs (hello->type) == GNUNET_MESSAGE_TYPE_HELLO);
896 size = ntohs (hello->size);
897 GNUNET_break (size >= sizeof (struct GNUNET_MessageHeader));
898 hc = GNUNET_malloc (size);
899 memcpy (hc, hello, size);
900 schedule_control_transmit (handle,
902 GNUNET_NO, OFFER_HELLO_TIMEOUT, &send_hello, hc);
907 * Function we use for handling incoming messages.
909 static void demultiplexer (void *cls, const struct GNUNET_MessageHeader *msg);
913 send_start (void *cls, size_t size, void *buf)
915 struct GNUNET_MessageHeader *s = buf;
920 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
921 "Timeout while trying to transmit `%s' request.\n",
927 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
928 "Transmitting `%s' request.\n", "START");
930 GNUNET_assert (size >= sizeof (struct GNUNET_MessageHeader));
931 s->size = htons (sizeof (struct GNUNET_MessageHeader));
932 s->type = htons (GNUNET_MESSAGE_TYPE_TRANSPORT_START);
933 return sizeof (struct GNUNET_MessageHeader);
938 * We're ready to transmit the request that the transport service
939 * should connect to a new peer. In addition to sending the
940 * request, schedule the next phase for the transmission processing
941 * that caused the connect request in the first place.
944 request_connect (void *cls, size_t size, void *buf)
946 struct GNUNET_TRANSPORT_TransmitHandle *th = cls;
947 struct TryConnectMessage *tcm;
948 struct GNUNET_TRANSPORT_Handle *h;
949 struct NeighbourList *n;
951 GNUNET_assert (th->notify_delay_task == GNUNET_SCHEDULER_NO_TASK);
954 n = find_neighbour(h, &tcm->peer);
959 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
960 "Asked to TRY_CONNECT to already connected peer!\n");
969 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
970 "Failed to transmit `%s' request for `%4s' to service.\n",
971 "TRY_CONNECT", GNUNET_i2s (&th->target));
973 if (th->notify_delay_task != GNUNET_SCHEDULER_NO_TASK)
975 GNUNET_SCHEDULER_cancel (h->sched, th->notify_delay_task);
976 th->notify_delay_task = GNUNET_SCHEDULER_NO_TASK;
978 if (NULL != th->notify)
979 GNUNET_assert (0 == th->notify (th->notify_cls, 0, NULL));
984 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
985 "Transmitting `%s' message for `%4s' (need connection in %llu ms).\n",
986 "TRY_CONNECT", GNUNET_i2s (&th->target),
987 GNUNET_TIME_absolute_get_remaining (th->timeout).value);
989 GNUNET_assert (size >= sizeof (struct TryConnectMessage));
991 tcm->header.size = htons (sizeof (struct TryConnectMessage));
992 tcm->header.type = htons (GNUNET_MESSAGE_TYPE_TRANSPORT_TRY_CONNECT);
993 tcm->reserved = htonl (0);
994 memcpy (&tcm->peer, &th->target, sizeof (struct GNUNET_PeerIdentity));
995 th->notify_delay_task
996 = GNUNET_SCHEDULER_add_delayed (h->sched,
997 GNUNET_TIME_absolute_get_remaining
999 &peer_transmit_timeout, th);
1000 insert_transmit_handle (&h->connect_wait_head, th);
1001 return sizeof (struct TryConnectMessage);
1006 * Schedule a request to connect to the given
1007 * neighbour (and if successful, add the specified
1008 * handle to the wait list).
1010 * @param th handle for a request to transmit once we
1014 try_connect (struct GNUNET_TRANSPORT_TransmitHandle *th)
1016 GNUNET_assert (th->notify_delay_task == GNUNET_SCHEDULER_NO_TASK);
1017 schedule_control_transmit (th->handle,
1018 sizeof (struct TryConnectMessage),
1020 GNUNET_TIME_absolute_get_remaining (th->timeout),
1021 &request_connect, th);
1026 * Task for delayed attempts to reconnect to a peer.
1028 * @param cls must be a transmit handle that determines the peer
1029 * to which we will try to connect
1030 * @param tc scheduler information about why we were triggered (not used)
1033 try_connect_task (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
1035 struct GNUNET_TRANSPORT_TransmitHandle *th = cls;
1037 th->notify_delay_task = GNUNET_SCHEDULER_NO_TASK;
1043 * Remove neighbour from our list. Will automatically
1044 * trigger a re-connect attempt if we have messages pending
1047 * @param h our state
1048 * @param peer the peer to remove
1051 remove_neighbour (struct GNUNET_TRANSPORT_Handle *h,
1052 const struct GNUNET_PeerIdentity *peer)
1054 struct NeighbourList *prev;
1055 struct NeighbourList *pos;
1056 struct GNUNET_TRANSPORT_TransmitHandle *th;
1059 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1060 "Removing neighbour `%s' from list of connected peers.\n",
1064 pos = h->neighbours;
1065 while ((pos != NULL) &&
1066 (0 != memcmp (peer, &pos->id, sizeof (struct GNUNET_PeerIdentity))))
1077 h->neighbours = pos->next;
1079 prev->next = pos->next;
1080 if (NULL != (th = pos->transmit_handle))
1082 pos->transmit_handle = NULL;
1083 th->neighbour = NULL;
1084 remove_from_any_list (th);
1085 if (GNUNET_TIME_absolute_get_remaining (th->timeout).value <=
1086 CONNECT_RETRY_TIMEOUT.value)
1089 GNUNET_log (GNUNET_ERROR_TYPE_INFO,
1091 ("Connection with `%4s' failed and timeout was in the past, giving up on message delivery.\n"),
1093 GNUNET_assert (GNUNET_SCHEDULER_NO_TASK == th->notify_delay_task);
1094 peer_transmit_timeout (th, NULL);
1098 GNUNET_log (GNUNET_ERROR_TYPE_INFO,
1100 ("Connection with `%4s' failed, will keep trying for %llu ms to deliver message\n"),
1102 GNUNET_TIME_absolute_get_remaining (th->timeout).value);
1103 /* try again in a bit */
1104 GNUNET_assert (GNUNET_SCHEDULER_NO_TASK == th->notify_delay_task);
1105 th->notify_delay_task
1106 = GNUNET_SCHEDULER_add_delayed (h->sched,
1107 CONNECT_RETRY_TIMEOUT,
1108 &try_connect_task, th);
1111 if (h->nc_cb != NULL)
1112 h->nd_cb (h->cls, peer);
1118 * Try again to connect to transport service.
1121 reconnect (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
1123 struct GNUNET_TRANSPORT_Handle *h = cls;
1124 struct GNUNET_TRANSPORT_TransmitHandle *pos;
1125 struct NeighbourList *n;
1127 /* Forget about all neighbours that we used to be connected
1129 while (NULL != (n = h->neighbours))
1130 remove_neighbour (h, &n->id);
1132 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Connecting to transport service.\n");
1134 GNUNET_assert (h->client == NULL);
1135 h->reconnect_task = GNUNET_SCHEDULER_NO_TASK;
1136 h->client = GNUNET_CLIENT_connect (h->sched, "transport", h->cfg);
1137 GNUNET_assert (h->client != NULL);
1138 /* make sure we don't send "START" twice,
1139 remove existing entry from queue (if present) */
1140 pos = h->connect_ready_head;
1143 if (pos->notify == &send_start)
1145 if (pos->prev == NULL)
1146 h->connect_ready_head = pos->next;
1148 pos->prev->next = pos->next;
1149 if (pos->next != NULL)
1150 pos->next->prev = pos->prev;
1151 GNUNET_assert (pos->neighbour == NULL);
1152 if (GNUNET_SCHEDULER_NO_TASK != pos->notify_delay_task)
1154 GNUNET_SCHEDULER_cancel (h->sched, pos->notify_delay_task);
1155 pos->notify_delay_task = GNUNET_SCHEDULER_NO_TASK;
1162 schedule_control_transmit (h,
1163 sizeof (struct GNUNET_MessageHeader),
1165 GNUNET_TIME_UNIT_FOREVER_REL, &send_start, NULL);
1166 GNUNET_CLIENT_receive (h->client,
1167 &demultiplexer, h, GNUNET_TIME_UNIT_FOREVER_REL);
1172 * Function that will schedule the job that will try
1173 * to connect us again to the client.
1176 schedule_reconnect (struct GNUNET_TRANSPORT_Handle *h)
1179 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1180 "Scheduling task to reconnect to transport service in %llu ms.\n",
1181 h->reconnect_delay.value);
1183 GNUNET_assert (h->client == NULL);
1184 GNUNET_assert (h->reconnect_task == GNUNET_SCHEDULER_NO_TASK);
1186 = GNUNET_SCHEDULER_add_delayed (h->sched,
1187 h->reconnect_delay, &reconnect, h);
1188 h->reconnect_delay = GNUNET_TIME_UNIT_SECONDS;
1193 * We are connected to the respective peer, check the
1194 * bandwidth limits and schedule the transmission.
1196 static void schedule_request (struct GNUNET_TRANSPORT_TransmitHandle *th);
1200 * Function called by the scheduler when the timeout
1201 * for bandwidth availablility for the target
1202 * neighbour is reached.
1205 transmit_ready (void *cls, const struct GNUNET_SCHEDULER_TaskContext *tc)
1207 struct GNUNET_TRANSPORT_TransmitHandle *th = cls;
1209 th->notify_delay_task = GNUNET_SCHEDULER_NO_TASK;
1210 schedule_request (th);
1215 * Remove the given transmit handle from the wait list. Does NOT free
1219 remove_from_wait_list (struct GNUNET_TRANSPORT_TransmitHandle *th)
1221 if (th->prev == NULL)
1222 th->handle->connect_wait_head = th->next;
1224 th->prev->next = th->next;
1225 if (th->next != NULL)
1226 th->next->prev = th->prev;
1231 * We are connected to the respective peer, check the
1232 * bandwidth limits and schedule the transmission.
1235 schedule_request (struct GNUNET_TRANSPORT_TransmitHandle *th)
1237 struct GNUNET_TRANSPORT_Handle *h;
1238 struct GNUNET_TIME_Relative duration;
1239 struct NeighbourList *n;
1244 if (th->notify_delay_task != GNUNET_SCHEDULER_NO_TASK)
1246 GNUNET_SCHEDULER_cancel (h->sched, th->notify_delay_task);
1247 th->notify_delay_task = GNUNET_SCHEDULER_NO_TASK;
1249 /* check outgoing quota */
1250 duration = GNUNET_TIME_absolute_get_duration (n->last_quota_update);
1251 if (duration.value > MIN_QUOTA_REFRESH_TIME)
1254 duration = GNUNET_TIME_absolute_get_duration (n->last_quota_update);
1256 available = duration.value * n->quota_out;
1257 if (available < n->last_sent + th->notify_size)
1259 /* calculate how much bandwidth we'd still need to
1260 accumulate and based on that how long we'll have
1262 available = n->last_sent + th->notify_size - available;
1263 duration = GNUNET_TIME_relative_multiply (GNUNET_TIME_UNIT_MILLISECONDS,
1264 available / n->quota_out);
1265 if (th->timeout.value <
1266 GNUNET_TIME_relative_to_absolute (duration).value)
1268 /* signal timeout! */
1270 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1271 "Would need %llu ms before bandwidth is available for delivery to `%4s', that is too long. Signaling timeout.\n",
1272 duration.value, GNUNET_i2s (&th->target));
1274 remove_from_wait_list (th);
1275 if (NULL != th->notify)
1276 GNUNET_assert (0 == th->notify (th->notify_cls, 0, NULL));
1281 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1282 "Need more bandwidth, delaying delivery to `%4s' by %llu ms\n",
1283 GNUNET_i2s (&th->target), duration.value);
1285 th->notify_delay_task
1286 = GNUNET_SCHEDULER_add_delayed (h->sched,
1287 duration, &transmit_ready, th);
1291 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1292 "Bandwidth available for transmission to `%4s'\n",
1293 GNUNET_i2s (&n->id));
1295 if (GNUNET_NO == n->transmit_ok)
1297 /* we may be ready, but transport service is not;
1298 wait for SendOkMessage or timeout */
1300 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1301 "Need to wait for transport service `%s' message\n",
1304 th->notify_delay_task
1305 = GNUNET_SCHEDULER_add_delayed (h->sched,
1306 GNUNET_TIME_absolute_get_remaining
1307 (th->timeout), &peer_transmit_timeout,
1311 n->transmit_ok = GNUNET_NO;
1312 remove_from_wait_list (th);
1314 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1315 "Moving message for `%4s' to ready list\n",
1316 GNUNET_i2s (&n->id));
1318 insert_transmit_handle (&h->connect_ready_head, th);
1319 if (GNUNET_NO == h->transmission_scheduled)
1320 schedule_transmission (h);
1325 * Add neighbour to our list
1328 add_neighbour (struct GNUNET_TRANSPORT_Handle *h,
1330 struct GNUNET_TIME_Relative latency,
1332 const struct GNUNET_PeerIdentity *pid)
1334 struct NeighbourList *n;
1335 struct GNUNET_TRANSPORT_TransmitHandle *prev;
1336 struct GNUNET_TRANSPORT_TransmitHandle *pos;
1337 struct GNUNET_TRANSPORT_TransmitHandle *next;
1339 /* check for duplicates */
1340 if (NULL != find_neighbour (h, pid))
1346 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1347 "Creating entry for new neighbour `%4s'.\n", GNUNET_i2s (pid));
1349 n = GNUNET_malloc (sizeof (struct NeighbourList));
1351 n->last_quota_update = GNUNET_TIME_absolute_get ();
1352 n->quota_out = quota_out;
1353 n->next = h->neighbours;
1354 n->transmit_ok = GNUNET_YES;
1356 if (h->nc_cb != NULL)
1357 h->nc_cb (h->cls, &n->id, latency, distance);
1359 pos = h->connect_wait_head;
1363 if (0 == memcmp (pid,
1364 &pos->target, sizeof (struct GNUNET_PeerIdentity)))
1367 GNUNET_assert (NULL == n->transmit_handle);
1368 n->transmit_handle = pos;
1370 h->connect_wait_head = next;
1374 if (GNUNET_YES == n->received_ack)
1378 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1379 "Found pending request for `%4s' will trigger it now.\n",
1380 GNUNET_i2s (&pos->target));
1382 if (pos->notify_delay_task != GNUNET_SCHEDULER_NO_TASK)
1384 GNUNET_SCHEDULER_cancel (h->sched, pos->notify_delay_task);
1385 pos->notify_delay_task = GNUNET_SCHEDULER_NO_TASK;
1387 schedule_request (pos);
1401 * Connect to the transport service. Note that the connection may
1402 * complete (or fail) asynchronously.
1405 * @param sched scheduler to use
1406 * @param cfg configuration to use
1407 * @param cls closure for the callbacks
1408 * @param rec receive function to call
1409 * @param nc function to call on connect events
1410 * @param nd function to call on disconnect events
1412 struct GNUNET_TRANSPORT_Handle *
1413 GNUNET_TRANSPORT_connect (struct GNUNET_SCHEDULER_Handle *sched,
1414 const struct GNUNET_CONFIGURATION_Handle *cfg,
1416 GNUNET_TRANSPORT_ReceiveCallback rec,
1417 GNUNET_TRANSPORT_NotifyConnect nc,
1418 GNUNET_TRANSPORT_NotifyDisconnect nd)
1420 struct GNUNET_TRANSPORT_Handle *ret;
1422 GNUNET_ARM_start_services (cfg, sched, "peerinfo", "transport", NULL);
1423 ret = GNUNET_malloc (sizeof (struct GNUNET_TRANSPORT_Handle));
1430 ret->reconnect_delay = GNUNET_TIME_UNIT_ZERO;
1431 schedule_reconnect (ret);
1437 * Disconnect from the transport service.
1440 GNUNET_TRANSPORT_disconnect (struct GNUNET_TRANSPORT_Handle *handle)
1442 struct GNUNET_TRANSPORT_TransmitHandle *th;
1443 struct NeighbourList *n;
1444 struct HelloWaitList *hwl;
1445 struct GNUNET_CLIENT_Connection *client;
1448 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG, "Transport disconnect called!\n");
1450 while (NULL != (th = handle->connect_ready_head))
1452 handle->connect_ready_head = th->next;
1453 if (th->notify_delay_task != GNUNET_SCHEDULER_NO_TASK)
1455 GNUNET_SCHEDULER_cancel (handle->sched, th->notify_delay_task);
1456 th->notify_delay_task = GNUNET_SCHEDULER_NO_TASK;
1458 if (NULL != th->notify)
1459 GNUNET_assert (0 == th->notify (th->notify_cls, 0, NULL));
1462 while (NULL != (th = handle->connect_wait_head))
1464 handle->connect_wait_head = th->next;
1465 if (th->notify_delay_task != GNUNET_SCHEDULER_NO_TASK)
1467 GNUNET_SCHEDULER_cancel (handle->sched, th->notify_delay_task);
1468 th->notify_delay_task = GNUNET_SCHEDULER_NO_TASK;
1470 if (NULL != th->notify)
1471 GNUNET_assert (0 == th->notify (th->notify_cls, 0, NULL));
1474 while (NULL != (n = handle->neighbours))
1476 handle->neighbours = n->next;
1477 if (NULL != (th = n->transmit_handle))
1479 if (th->notify_delay_task != GNUNET_SCHEDULER_NO_TASK)
1481 GNUNET_SCHEDULER_cancel (handle->sched, th->notify_delay_task);
1482 th->notify_delay_task = GNUNET_SCHEDULER_NO_TASK;
1484 if (NULL != th->notify)
1485 GNUNET_assert (0 == th->notify (th->notify_cls, 0, NULL));
1490 while (NULL != (hwl = handle->hwl_head))
1492 handle->hwl_head = hwl->next;
1493 GNUNET_SCHEDULER_cancel (handle->sched, hwl->task);
1494 GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
1496 ("Disconnect while notification for `%s' still registered.\n"),
1498 if (hwl->rec != NULL)
1499 hwl->rec (hwl->rec_cls, NULL);
1502 if (handle->reconnect_task != GNUNET_SCHEDULER_NO_TASK)
1504 GNUNET_SCHEDULER_cancel (handle->sched, handle->reconnect_task);
1505 handle->reconnect_task = GNUNET_SCHEDULER_NO_TASK;
1507 GNUNET_free_non_null (handle->my_hello);
1508 handle->my_hello = NULL;
1509 GNUNET_ARM_stop_services (handle->cfg, handle->sched, "transport",
1511 if (NULL != handle->network_handle)
1513 GNUNET_CLIENT_notify_transmit_ready_cancel (handle->network_handle);
1514 handle->network_handle = NULL;
1516 if (NULL != (client = handle->client))
1519 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1520 "Disconnecting from transport service for good.\n");
1522 handle->client = NULL;
1523 GNUNET_CLIENT_disconnect (client);
1525 GNUNET_free (handle);
1530 * Type of a function to call when we receive a message
1533 * @param cls closure
1534 * @param msg message received, NULL on timeout or fatal error
1537 demultiplexer (void *cls, const struct GNUNET_MessageHeader *msg)
1539 struct GNUNET_TRANSPORT_Handle *h = cls;
1540 const struct DisconnectInfoMessage *dim;
1541 const struct ConnectInfoMessage *cim;
1542 const struct InboundMessage *im;
1543 const struct GNUNET_MessageHeader *imm;
1544 const struct SendOkMessage *okm;
1545 struct HelloWaitList *hwl;
1546 struct HelloWaitList *next_hwl;
1547 struct NeighbourList *n;
1548 struct GNUNET_PeerIdentity me;
1549 struct GNUNET_TRANSPORT_TransmitHandle *th;
1551 struct GNUNET_TRANSPORT_TransmitHandle *prev;
1552 struct GNUNET_TRANSPORT_TransmitHandle *pos;
1553 struct GNUNET_TRANSPORT_TransmitHandle *next;
1556 if ((msg == NULL) || (h->client == NULL))
1558 if (h->client != NULL)
1561 GNUNET_log (GNUNET_ERROR_TYPE_INFO,
1562 "Error receiving from transport service, disconnecting temporarily.\n");
1564 if (h->network_handle != NULL)
1566 GNUNET_CLIENT_notify_transmit_ready_cancel (h->network_handle);
1567 h->network_handle = NULL;
1568 h->transmission_scheduled = GNUNET_NO;
1569 th = h->connect_ready_head;
1570 /* add timeout again, we cancelled the transmit_ready task! */
1571 GNUNET_assert (th->notify_delay_task ==
1572 GNUNET_SCHEDULER_NO_TASK);
1573 th->notify_delay_task =
1574 GNUNET_SCHEDULER_add_delayed (h->sched,
1575 GNUNET_TIME_absolute_get_remaining
1577 &peer_transmit_timeout, th);
1579 GNUNET_CLIENT_disconnect (h->client);
1581 schedule_reconnect (h);
1585 /* shutdown initiated from 'GNUNET_TRANSPORT_disconnect',
1586 finish clean up work! */
1591 GNUNET_CLIENT_receive (h->client,
1592 &demultiplexer, h, GNUNET_TIME_UNIT_FOREVER_REL);
1593 size = ntohs (msg->size);
1594 switch (ntohs (msg->type))
1596 case GNUNET_MESSAGE_TYPE_HELLO:
1598 GNUNET_HELLO_get_id ((const struct GNUNET_HELLO_Message *) msg,
1605 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1606 "Receiving (my own) `%s' message, I am `%4s'.\n",
1607 "HELLO", GNUNET_i2s (&me));
1609 GNUNET_free_non_null (h->my_hello);
1611 if (size < sizeof (struct GNUNET_MessageHeader))
1616 h->my_hello = GNUNET_malloc (size);
1617 memcpy (h->my_hello, msg, size);
1621 next_hwl = hwl->next;
1622 hwl->rec (hwl->rec_cls,
1623 (const struct GNUNET_MessageHeader *) h->my_hello);
1627 case GNUNET_MESSAGE_TYPE_TRANSPORT_CONNECT:
1628 if (size != sizeof (struct ConnectInfoMessage))
1633 cim = (const struct ConnectInfoMessage *) msg;
1635 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1636 "Receiving `%s' message for `%4s'.\n",
1637 "CONNECT", GNUNET_i2s (&cim->id));
1639 if (find_neighbour(h, &cim->id) == NULL)
1642 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1643 "Don't know neighbor, adding!\n");
1646 ntohl (cim->quota_out),
1647 GNUNET_TIME_relative_ntoh (cim->latency), ntohs(cim->distance), &cim->id);
1652 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1653 "Do know neighbor, scheduling transmission!\n");
1655 n = find_neighbour(h, &cim->id);
1656 n->received_ack = GNUNET_YES;
1657 if (NULL != n->transmit_handle)
1660 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1661 "Peer connected, scheduling delayed message for delivery now.\n");
1663 schedule_request (n->transmit_handle);
1668 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1669 "Transmit handle is null... Checking for pending stuff(?)\n");
1672 pos = h->connect_wait_head;
1676 if (0 == memcmp (&cim->id,
1677 &pos->target, sizeof (struct GNUNET_PeerIdentity)))
1680 GNUNET_assert (NULL == n->transmit_handle);
1681 n->transmit_handle = pos;
1683 h->connect_wait_head = next;
1687 if (GNUNET_YES == n->received_ack)
1691 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1692 "Found pending request for `%4s' will trigger it now.\n",
1693 GNUNET_i2s (&pos->target));
1695 if (pos->notify_delay_task != GNUNET_SCHEDULER_NO_TASK)
1697 GNUNET_SCHEDULER_cancel (h->sched, pos->notify_delay_task);
1698 pos->notify_delay_task = GNUNET_SCHEDULER_NO_TASK;
1700 schedule_request (pos);
1714 case GNUNET_MESSAGE_TYPE_TRANSPORT_DISCONNECT:
1715 if (size != sizeof (struct DisconnectInfoMessage))
1720 dim = (const struct DisconnectInfoMessage *) msg;
1722 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1723 "Receiving `%s' message for `%4s'.\n",
1724 "DISCONNECT", GNUNET_i2s (&dim->peer));
1726 remove_neighbour (h, &dim->peer);
1728 case GNUNET_MESSAGE_TYPE_TRANSPORT_SEND_OK:
1729 if (size != sizeof (struct SendOkMessage))
1734 okm = (const struct SendOkMessage *) msg;
1736 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1737 "Receiving `%s' message, transmission %s.\n", "SEND_OK",
1738 ntohl (okm->success) == GNUNET_OK ? "succeeded" : "failed");
1740 n = find_neighbour (h, &okm->peer);
1741 GNUNET_assert (n != NULL);
1742 n->transmit_ok = GNUNET_YES;
1743 if (n->transmit_handle != NULL)
1746 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1747 "Processing pending message for `%4s'\n",
1748 GNUNET_i2s (&n->id));
1750 GNUNET_SCHEDULER_cancel (h->sched,
1751 n->transmit_handle->notify_delay_task);
1752 n->transmit_handle->notify_delay_task = GNUNET_SCHEDULER_NO_TASK;
1753 GNUNET_assert (GNUNET_YES == n->received_ack);
1754 schedule_request (n->transmit_handle);
1757 case GNUNET_MESSAGE_TYPE_TRANSPORT_RECV:
1759 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1760 "Receiving `%s' message.\n", "RECV");
1763 sizeof (struct InboundMessage) +
1764 sizeof (struct GNUNET_MessageHeader))
1769 im = (const struct InboundMessage *) msg;
1770 imm = (const struct GNUNET_MessageHeader *) &im[1];
1771 if (ntohs (imm->size) + sizeof (struct InboundMessage) != size)
1776 switch (ntohs (imm->type))
1778 case GNUNET_MESSAGE_TYPE_TRANSPORT_ACK:
1780 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1781 "Receiving `%s' message from `%4s'.\n",
1782 "ACK", GNUNET_i2s (&im->peer));
1784 n = find_neighbour (h, &im->peer);
1790 if (n->received_ack == GNUNET_NO)
1792 n->received_ack = GNUNET_YES;
1793 if (NULL != n->transmit_handle)
1796 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1797 "Peer connected, scheduling delayed message for delivery now.\n");
1799 schedule_request (n->transmit_handle);
1805 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1806 "Received message of type %u from `%4s'.\n",
1807 ntohs (imm->type), GNUNET_i2s (&im->peer));
1810 h->rec (h->cls, &im->peer, imm,
1811 GNUNET_TIME_relative_ntoh (im->latency), ntohs(im->distance));
1816 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
1818 ("Received unexpected message of type %u in %s:%u\n"),
1819 ntohs (msg->type), __FILE__, __LINE__);
1826 struct ClientTransmitWrapper
1828 GNUNET_CONNECTION_TransmitReadyNotify notify;
1830 struct GNUNET_TRANSPORT_TransmitHandle *th;
1835 * Transmit message of a client destined for another
1836 * peer to the service.
1839 client_notify_wrapper (void *cls, size_t size, void *buf)
1841 struct ClientTransmitWrapper *ctw = cls;
1842 struct OutboundMessage *obm;
1843 struct GNUNET_MessageHeader *hdr;
1849 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1850 "Transmission request could not be satisfied.\n");
1852 if (NULL != ctw->notify)
1853 GNUNET_assert (0 == ctw->notify (ctw->notify_cls, 0, NULL));
1857 GNUNET_assert (size >= sizeof (struct OutboundMessage));
1859 if (ctw->notify != NULL)
1860 ret = ctw->notify (ctw->notify_cls,
1861 size - sizeof (struct OutboundMessage),
1867 /* Need to reset flag, no SEND means no SEND_OK! */
1868 ctw->th->neighbour->transmit_ok = GNUNET_YES;
1872 GNUNET_assert (ret >= sizeof (struct GNUNET_MessageHeader));
1873 hdr = (struct GNUNET_MessageHeader *) &obm[1];
1874 GNUNET_assert (ntohs (hdr->size) == ret);
1875 GNUNET_assert (ret + sizeof (struct OutboundMessage) <
1876 GNUNET_SERVER_MAX_MESSAGE_SIZE);
1878 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1879 "Transmitting `%s' message with data for `%4s'\n",
1880 "SEND", GNUNET_i2s (&ctw->th->target));
1882 ret += sizeof (struct OutboundMessage);
1883 obm->header.type = htons (GNUNET_MESSAGE_TYPE_TRANSPORT_SEND);
1884 obm->header.size = htons (ret);
1885 obm->priority = htonl (ctw->th->priority);
1886 obm->peer = ctw->th->target;
1894 * Check if we could queue a message of the given size for
1895 * transmission. The transport service will take both its
1896 * internal buffers and bandwidth limits imposed by the
1897 * other peer into consideration when answering this query.
1899 * @param handle connection to transport service
1900 * @param target who should receive the message
1901 * @param size how big is the message we want to transmit?
1902 * @param priority how important is the message?
1903 * @param timeout after how long should we give up (and call
1904 * notify with buf NULL and size 0)?
1905 * @param notify function to call when we are ready to
1906 * send such a message
1907 * @param notify_cls closure for notify
1908 * @return NULL if someone else is already waiting to be notified
1909 * non-NULL if the notify callback was queued (can be used to cancel
1910 * using GNUNET_TRANSPORT_notify_transmit_ready_cancel)
1912 struct GNUNET_TRANSPORT_TransmitHandle *
1913 GNUNET_TRANSPORT_notify_transmit_ready (struct GNUNET_TRANSPORT_Handle
1915 const struct GNUNET_PeerIdentity
1916 *target, size_t size,
1917 unsigned int priority,
1918 struct GNUNET_TIME_Relative timeout,
1919 GNUNET_CONNECTION_TransmitReadyNotify
1920 notify, void *notify_cls)
1922 struct GNUNET_TRANSPORT_TransmitHandle *pos;
1923 struct GNUNET_TRANSPORT_TransmitHandle *th;
1924 struct NeighbourList *n;
1925 struct ClientTransmitWrapper *ctw;
1927 if (size + sizeof (struct OutboundMessage) >=
1928 GNUNET_SERVER_MAX_MESSAGE_SIZE)
1934 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1935 "Asking transport service for transmission of %u bytes to peer `%4s'.\n",
1936 size, GNUNET_i2s (target));
1938 n = find_neighbour (handle, target);
1939 if ((n != NULL) && (n->transmit_handle != NULL))
1940 return NULL; /* already have a request pending for this peer! */
1941 ctw = GNUNET_malloc (sizeof (struct ClientTransmitWrapper));
1942 th = GNUNET_malloc (sizeof (struct GNUNET_TRANSPORT_TransmitHandle));
1943 ctw->notify = notify;
1944 ctw->notify_cls = notify_cls;
1946 th->handle = handle;
1948 th->target = *target;
1949 th->notify = &client_notify_wrapper;
1950 th->notify_cls = ctw;
1951 th->timeout = GNUNET_TIME_relative_to_absolute (timeout);
1952 th->notify_size = size + sizeof (struct OutboundMessage);
1953 th->priority = priority;
1956 pos = handle->connect_wait_head;
1959 GNUNET_assert (0 != memcmp (target,
1961 sizeof (struct GNUNET_PeerIdentity)));
1965 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1966 "Will now try to connect to `%4s'.\n", GNUNET_i2s (target));
1973 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1974 "Transmission request queued for transmission to transport service.\n");
1976 GNUNET_assert (NULL == n->transmit_handle);
1977 n->transmit_handle = th;
1978 if (GNUNET_YES != n->transmit_ok)
1981 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1982 "Connection to `%4s' is not yet confirmed connected, scheduling timeout (%llu ms) only.\n",
1983 GNUNET_i2s (target), timeout.value);
1985 th->notify_delay_task
1986 = GNUNET_SCHEDULER_add_delayed (handle->sched,
1987 timeout, &peer_transmit_timeout, th);
1992 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
1993 "Peer `%4s' is ready to receive, scheduling message for delivery now.\n",
1994 GNUNET_i2s (target));
1996 th->notify_delay_task
1997 = GNUNET_SCHEDULER_add_now (handle->sched, &transmit_ready, th);
2003 * Cancel the specified transmission-ready notification.
2006 GNUNET_TRANSPORT_notify_transmit_ready_cancel (struct
2007 GNUNET_TRANSPORT_TransmitHandle
2010 struct GNUNET_TRANSPORT_Handle *h;
2013 GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
2014 "Transmission request of %u bytes to `%4s' was cancelled.\n",
2015 th->notify_size - sizeof (struct OutboundMessage),
2016 GNUNET_i2s (&th->target));
2018 GNUNET_assert (th->notify == &client_notify_wrapper);
2019 remove_from_any_list (th);
2021 if ((h->connect_ready_head == NULL) && (h->network_handle != NULL))
2023 GNUNET_CLIENT_notify_transmit_ready_cancel (h->network_handle);
2024 h->network_handle = NULL;
2025 h->transmission_scheduled = GNUNET_NO;
2027 GNUNET_free (th->notify_cls);
2028 GNUNET_assert (th->notify_delay_task == GNUNET_SCHEDULER_NO_TASK);
2033 /* end of transport_api.c */