2 This file is part of GNUnet.
3 Copyright (C) 2009-2013, 2016 GNUnet e.V.
5 GNUnet is free software: you can redistribute it and/or modify it
6 under the terms of the GNU Affero General Public License as published
7 by the Free Software Foundation, either version 3 of the License,
8 or (at your 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 Affero General Public License for more details.
15 You should have received a copy of the GNU Affero General Public License
16 along with this program. If not, see <http://www.gnu.org/licenses/>.
18 SPDX-License-Identifier: AGPL3.0-or-later
22 * @file transport/transport_api_core.c
23 * @brief library to access the transport service for message exchange
24 * @author Christian Grothoff
27 #include "gnunet_util_lib.h"
28 #include "gnunet_constants.h"
29 #include "gnunet_arm_service.h"
30 #include "gnunet_hello_lib.h"
31 #include "gnunet_protocols.h"
32 #include "gnunet_transport_service.h"
33 #include "transport.h"
35 #define LOG(kind, ...) GNUNET_log_from (kind, "transport-api-core", __VA_ARGS__)
38 * If we could not send any payload to a peer for this amount of
39 * time, we print a warning.
41 #define UNREADY_WARN_TIME GNUNET_TIME_UNIT_MINUTES
44 * How large to start with for the hashmap of neighbours.
46 #define STARTING_NEIGHBOURS_SIZE 16
50 * Entry in hash table of all of our current (connected) neighbours.
55 * Overall transport handle.
57 struct GNUNET_TRANSPORT_CoreHandle *h;
60 * Active message queue for the peer.
62 struct GNUNET_MQ_Handle *mq;
65 * Envelope with the message we are currently transmitting (or NULL).
67 struct GNUNET_MQ_Envelope *env;
70 * Closure for @e mq handlers.
75 * Identity of this neighbour.
77 struct GNUNET_PeerIdentity id;
80 * Outbound bandwidh tracker.
82 struct GNUNET_BANDWIDTH_Tracker out_tracker;
85 * Entry in our readyness heap (which is sorted by @e next_ready
86 * value). NULL if there is no pending transmission request for
87 * this neighbour or if we're waiting for @e is_ready to become
88 * true AFTER the @e out_tracker suggested that this peer's quota
89 * has been satisfied (so once @e is_ready goes to #GNUNET_YES,
90 * we should immediately go back into the heap).
92 struct GNUNET_CONTAINER_HeapNode *hn;
95 * Task to trigger MQ when we have enough bandwidth for the
98 struct GNUNET_SCHEDULER_Task *timeout_task;
101 * Sending consumed more bytes on wire than payload was announced
102 * This overhead is added to the delay of next sending operation
104 unsigned long long traffic_overhead;
107 * Is this peer currently ready to receive a message?
112 * Size of the message in @e env.
119 * Handle for the transport service (includes all of the
120 * state for the transport service).
122 struct GNUNET_TRANSPORT_CoreHandle
125 * Closure for the callbacks.
130 * Functions to call for received data (template for
131 * new message queues).
133 struct GNUNET_MQ_MessageHandler *handlers;
136 * function to call on connect events
138 GNUNET_TRANSPORT_NotifyConnect nc_cb;
141 * function to call on disconnect events
143 GNUNET_TRANSPORT_NotifyDisconnect nd_cb;
146 * function to call on excess bandwidth events
148 GNUNET_TRANSPORT_NotifyExcessBandwidth neb_cb;
151 * My client connection to the transport service.
153 struct GNUNET_MQ_Handle *mq;
158 const struct GNUNET_CONFIGURATION_Handle *cfg;
161 * Hash map of the current connected neighbours of this peer.
162 * Maps peer identities to `struct Neighbour` entries.
164 struct GNUNET_CONTAINER_MultiPeerMap *neighbours;
167 * Peer identity as assumed by this process, or all zeros.
169 struct GNUNET_PeerIdentity self;
172 * ID of the task trying to reconnect to the service.
174 struct GNUNET_SCHEDULER_Task *reconnect_task;
177 * Delay until we try to reconnect.
179 struct GNUNET_TIME_Relative reconnect_delay;
182 * Internal counter to check how many more receive OK messages this
183 * CORE service is allowed to send in total. Just to detect easy
184 * cases of protocol violations by the CORE implementation.
185 * NOTE: we may want to make this stronger by counting per peer
186 * instead of globally.
188 unsigned int rom_pending;
191 * Should we check that @e self matches what the service thinks?
192 * (if #GNUNET_NO, then @e self is all zeros!).
199 * Function that will schedule the job that will try
200 * to connect us again to the client.
202 * @param h transport service to reconnect
205 disconnect_and_schedule_reconnect (struct GNUNET_TRANSPORT_CoreHandle *h);
209 * Get the neighbour list entry for the given peer
211 * @param h our context
212 * @param peer peer to look up
213 * @return NULL if no such peer entry exists
215 static struct Neighbour *
216 neighbour_find (struct GNUNET_TRANSPORT_CoreHandle *h,
217 const struct GNUNET_PeerIdentity *peer)
219 return GNUNET_CONTAINER_multipeermap_get (h->neighbours, peer);
224 * Function called by the bandwidth tracker if we have excess
227 * @param cls the `struct Neighbour` that has excess bandwidth
230 notify_excess_cb (void *cls)
232 struct Neighbour *n = cls;
233 struct GNUNET_TRANSPORT_CoreHandle *h = n->h;
235 LOG (GNUNET_ERROR_TYPE_DEBUG,
236 "Notifying CORE that more bandwidth is available for %s\n",
237 GNUNET_i2s (&n->id));
239 if (NULL != h->neb_cb)
240 h->neb_cb (h->cls, &n->id, n->handlers_cls);
245 * Iterator over hash map entries, for deleting state of a neighbour.
247 * @param cls the `struct GNUNET_TRANSPORT_CoreHandle *`
248 * @param key peer identity
249 * @param value value in the hash map, the neighbour entry to delete
250 * @return #GNUNET_YES if we should continue to
255 neighbour_delete (void *cls, const struct GNUNET_PeerIdentity *key, void *value)
257 struct GNUNET_TRANSPORT_CoreHandle *handle = cls;
258 struct Neighbour *n = value;
260 LOG (GNUNET_ERROR_TYPE_DEBUG,
261 "Dropping entry for neighbour `%s'.\n",
263 GNUNET_BANDWIDTH_tracker_notification_stop (&n->out_tracker);
264 if (NULL != handle->nd_cb)
265 handle->nd_cb (handle->cls, &n->id, n->handlers_cls);
266 if (NULL != n->timeout_task)
268 GNUNET_SCHEDULER_cancel (n->timeout_task);
269 n->timeout_task = NULL;
273 GNUNET_MQ_send_cancel (n->env);
276 GNUNET_MQ_destroy (n->mq);
277 GNUNET_assert (NULL == n->mq);
280 GNUNET_CONTAINER_multipeermap_remove (handle->neighbours, key, n));
287 * Generic error handler, called with the appropriate
288 * error code and the same closure specified at the creation of
290 * Not every message queue implementation supports an error handler.
292 * @param cls closure with the `struct GNUNET_TRANSPORT_CoreHandle *`
293 * @param error error code
296 mq_error_handler (void *cls, enum GNUNET_MQ_Error error)
298 struct GNUNET_TRANSPORT_CoreHandle *h = cls;
300 LOG (GNUNET_ERROR_TYPE_ERROR,
301 "Error receiving from transport service (%d), disconnecting temporarily.\n",
303 disconnect_and_schedule_reconnect (h);
308 * Function we use for checking incoming HELLO messages.
310 * @param cls closure, a `struct GNUNET_TRANSPORT_CoreHandle *`
311 * @param msg message received
312 * @return #GNUNET_OK if message is well-formed
315 check_hello (void *cls, const struct GNUNET_MessageHeader *msg)
317 struct GNUNET_PeerIdentity me;
320 GNUNET_HELLO_get_id ((const struct GNUNET_HELLO_Message *) msg, &me))
323 return GNUNET_SYSERR;
330 * Function we use for handling incoming HELLO messages.
332 * @param cls closure, a `struct GNUNET_TRANSPORT_CoreHandle *`
333 * @param msg message received
336 handle_hello (void *cls, const struct GNUNET_MessageHeader *msg)
338 /* we do not care => FIXME: signal in options to NEVER send HELLOs! */
343 * A message from the handler's message queue to a neighbour was
344 * transmitted. Now trigger (possibly delayed) notification of the
345 * neighbour's message queue that we are done and thus ready for
348 * @param cls the `struct Neighbour` where the message was sent
351 notify_send_done_fin (void *cls)
353 struct Neighbour *n = cls;
355 n->timeout_task = NULL;
356 n->is_ready = GNUNET_YES;
357 GNUNET_MQ_impl_send_continue (n->mq);
362 * A message from the handler's message queue to a neighbour was
363 * transmitted. Now trigger (possibly delayed) notification of the
364 * neighbour's message queue that we are done and thus ready for
367 * @param cls the `struct Neighbour` where the message was sent
370 notify_send_done (void *cls)
372 struct Neighbour *n = cls;
373 struct GNUNET_TIME_Relative delay;
375 n->timeout_task = NULL;
378 GNUNET_BANDWIDTH_tracker_consume (&n->out_tracker,
379 n->env_size + n->traffic_overhead);
381 n->traffic_overhead = 0;
383 delay = GNUNET_BANDWIDTH_tracker_get_delay (&n->out_tracker, 128);
384 if (0 == delay.rel_value_us)
386 n->is_ready = GNUNET_YES;
387 GNUNET_MQ_impl_send_continue (n->mq);
390 GNUNET_MQ_impl_send_in_flight (n->mq);
391 /* cannot send even a small message without violating
392 quota, wait a before allowing MQ to send next message */
394 GNUNET_SCHEDULER_add_delayed (delay, ¬ify_send_done_fin, n);
399 * Implement sending functionality of a message queue.
400 * Called one message at a time. Should send the @a msg
401 * to the transport service and then notify the queue
402 * once we are ready for the next one.
404 * @param mq the message queue
405 * @param msg the message to send
406 * @param impl_state state of the implementation
409 mq_send_impl (struct GNUNET_MQ_Handle *mq,
410 const struct GNUNET_MessageHeader *msg,
413 struct Neighbour *n = impl_state;
414 struct GNUNET_TRANSPORT_CoreHandle *h = n->h;
415 struct OutboundMessage *obm;
418 GNUNET_assert (GNUNET_YES == n->is_ready);
419 msize = ntohs (msg->size);
420 if (msize >= GNUNET_MAX_MESSAGE_SIZE - sizeof(*obm))
423 GNUNET_MQ_impl_send_continue (mq);
426 GNUNET_assert (NULL == n->env);
428 GNUNET_MQ_msg_nested_mh (obm, GNUNET_MESSAGE_TYPE_TRANSPORT_SEND, msg);
430 struct GNUNET_MQ_Envelope *env;
432 env = GNUNET_MQ_get_current_envelope (mq);
433 obm->priority = htonl ((uint32_t) GNUNET_MQ_env_get_options (env));
435 obm->timeout = GNUNET_TIME_relative_hton (
436 GNUNET_TIME_UNIT_MINUTES); /* FIXME: to be removed */
438 GNUNET_assert (NULL == n->timeout_task);
439 n->is_ready = GNUNET_NO;
440 n->env_size = ntohs (msg->size);
441 GNUNET_MQ_notify_sent (n->env, ¬ify_send_done, n);
442 GNUNET_MQ_send (h->mq, n->env);
443 LOG (GNUNET_ERROR_TYPE_DEBUG,
444 "Queued message of type %u for neighbour `%s'.\n",
446 GNUNET_i2s (&n->id));
451 * Handle destruction of a message queue. Implementations must not
452 * free @a mq, but should take care of @a impl_state.
454 * @param mq the message queue to destroy
455 * @param impl_state state of the implementation
458 mq_destroy_impl (struct GNUNET_MQ_Handle *mq, void *impl_state)
460 struct Neighbour *n = impl_state;
462 GNUNET_assert (mq == n->mq);
468 * Implementation function that cancels the currently sent message.
469 * Should basically undo whatever #mq_send_impl() did.
471 * @param mq message queue
472 * @param impl_state state specific to the implementation
475 mq_cancel_impl (struct GNUNET_MQ_Handle *mq, void *impl_state)
477 struct Neighbour *n = impl_state;
479 GNUNET_assert (GNUNET_NO == n->is_ready);
482 GNUNET_MQ_send_cancel (n->env);
486 n->is_ready = GNUNET_YES;
491 * We had an error processing a message we forwarded from a peer to
492 * the CORE service. We should just complain about it but otherwise
493 * continue processing.
496 * @param error error code
499 peer_mq_error_handler (void *cls, enum GNUNET_MQ_Error error)
501 /* struct Neighbour *n = cls; */
508 * The outbound quota has changed in a way that may require
509 * us to reset the timeout. Update the timeout.
511 * @param cls the `struct Neighbour` for which the timeout changed
514 outbound_bw_tracker_update (void *cls)
516 struct Neighbour *n = cls;
517 struct GNUNET_TIME_Relative delay;
519 if (NULL == n->timeout_task)
521 delay = GNUNET_BANDWIDTH_tracker_get_delay (&n->out_tracker, 128);
522 GNUNET_SCHEDULER_cancel (n->timeout_task);
523 n->timeout_task = GNUNET_SCHEDULER_add_delayed (delay, ¬ify_send_done, n);
528 * Function we use for handling incoming connect messages.
530 * @param cls closure, a `struct GNUNET_TRANSPORT_Handle *`
531 * @param cim message received
534 handle_connect (void *cls, const struct ConnectInfoMessage *cim)
536 struct GNUNET_TRANSPORT_CoreHandle *h = cls;
539 LOG (GNUNET_ERROR_TYPE_DEBUG,
540 "Receiving CONNECT message for `%s' with quota %u\n",
541 GNUNET_i2s (&cim->id),
542 ntohl (cim->quota_out.value__));
543 n = neighbour_find (h, &cim->id);
546 GNUNET_break (0); /* FIXME: this assertion seems to fail sometimes!? */
547 disconnect_and_schedule_reconnect (h);
550 n = GNUNET_new (struct Neighbour);
553 n->is_ready = GNUNET_YES;
554 n->traffic_overhead = 0;
555 GNUNET_BANDWIDTH_tracker_init2 (&n->out_tracker,
556 &outbound_bw_tracker_update,
558 GNUNET_CONSTANTS_DEFAULT_BW_IN_OUT,
559 MAX_BANDWIDTH_CARRY_S,
562 GNUNET_assert (GNUNET_OK ==
563 GNUNET_CONTAINER_multipeermap_put (
567 GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_ONLY));
569 GNUNET_BANDWIDTH_tracker_update_quota (&n->out_tracker, cim->quota_out);
570 n->mq = GNUNET_MQ_queue_for_callbacks (&mq_send_impl,
575 &peer_mq_error_handler,
577 if (NULL != h->nc_cb)
579 n->handlers_cls = h->nc_cb (h->cls, &n->id, n->mq);
580 GNUNET_MQ_set_handlers_closure (n->mq, n->handlers_cls);
586 * Function we use for handling incoming disconnect messages.
588 * @param cls closure, a `struct GNUNET_TRANSPORT_CoreHandle *`
589 * @param dim message received
592 handle_disconnect (void *cls, const struct DisconnectInfoMessage *dim)
594 struct GNUNET_TRANSPORT_CoreHandle *h = cls;
597 GNUNET_break (ntohl (dim->reserved) == 0);
598 LOG (GNUNET_ERROR_TYPE_DEBUG,
599 "Receiving DISCONNECT message for `%s'.\n",
600 GNUNET_i2s (&dim->peer));
601 n = neighbour_find (h, &dim->peer);
605 disconnect_and_schedule_reconnect (h);
608 GNUNET_assert (GNUNET_YES == neighbour_delete (h, &dim->peer, n));
613 * Function we use for handling incoming send-ok messages.
615 * @param cls closure, a `struct GNUNET_TRANSPORT_CoreHandle *`
616 * @param okm message received
619 handle_send_ok (void *cls, const struct SendOkMessage *okm)
621 struct GNUNET_TRANSPORT_CoreHandle *h = cls;
624 uint32_t bytes_physical;
626 bytes_msg = ntohl (okm->bytes_msg);
627 bytes_physical = ntohl (okm->bytes_physical);
628 LOG (GNUNET_ERROR_TYPE_DEBUG,
629 "Receiving SEND_OK message, transmission to %s %s.\n",
630 GNUNET_i2s (&okm->peer),
631 ntohl (okm->success) == GNUNET_OK ? "succeeded" : "failed");
632 n = neighbour_find (h, &okm->peer);
635 /* We should never get a 'SEND_OK' for a peer that we are not
638 disconnect_and_schedule_reconnect (h);
641 if (bytes_physical > bytes_msg)
643 LOG (GNUNET_ERROR_TYPE_DEBUG,
644 "Overhead for %u byte message was %u\n",
646 bytes_physical - bytes_msg);
647 n->traffic_overhead += bytes_physical - bytes_msg;
653 * Function we use for checking incoming "inbound" messages.
655 * @param cls closure, a `struct GNUNET_TRANSPORT_CoreHandle *`
656 * @param im message received
659 check_recv (void *cls, const struct InboundMessage *im)
661 const struct GNUNET_MessageHeader *imm;
664 size = ntohs (im->header.size) - sizeof(*im);
665 if (size < sizeof(struct GNUNET_MessageHeader))
668 return GNUNET_SYSERR;
670 imm = (const struct GNUNET_MessageHeader *) &im[1];
671 if (ntohs (imm->size) != size)
674 return GNUNET_SYSERR;
681 * Function we use for handling incoming messages.
683 * @param cls closure, a `struct GNUNET_TRANSPORT_CoreHandle *`
684 * @param im message received
687 handle_recv (void *cls, const struct InboundMessage *im)
689 struct GNUNET_TRANSPORT_CoreHandle *h = cls;
690 const struct GNUNET_MessageHeader *imm =
691 (const struct GNUNET_MessageHeader *) &im[1];
694 LOG (GNUNET_ERROR_TYPE_DEBUG,
695 "Received message of type %u with %u bytes from `%s'.\n",
696 (unsigned int) ntohs (imm->type),
697 (unsigned int) ntohs (imm->size),
698 GNUNET_i2s (&im->peer));
699 n = neighbour_find (h, &im->peer);
703 disconnect_and_schedule_reconnect (h);
707 GNUNET_MQ_inject_message (n->mq, imm);
712 * Function we use for handling incoming set quota messages.
714 * @param cls closure, a `struct GNUNET_TRANSPORT_CoreHandle *`
715 * @param msg message received
718 handle_set_quota (void *cls, const struct QuotaSetMessage *qm)
720 struct GNUNET_TRANSPORT_CoreHandle *h = cls;
723 LOG (GNUNET_ERROR_TYPE_DEBUG,
724 "Receiving SET_QUOTA message for `%s' with quota %u\n",
725 GNUNET_i2s (&qm->peer),
726 ntohl (qm->quota.value__));
727 n = neighbour_find (h, &qm->peer);
731 0); /* FIXME: julius reports this assertion fails sometimes? */
732 disconnect_and_schedule_reconnect (h);
735 GNUNET_BANDWIDTH_tracker_update_quota (&n->out_tracker, qm->quota);
740 * Try again to connect to transport service.
742 * @param cls the handle to the transport service
745 reconnect (void *cls)
747 struct GNUNET_TRANSPORT_CoreHandle *h = cls;
748 struct GNUNET_MQ_MessageHandler handlers[] =
749 { GNUNET_MQ_hd_var_size (hello,
750 GNUNET_MESSAGE_TYPE_HELLO,
751 struct GNUNET_MessageHeader,
753 GNUNET_MQ_hd_fixed_size (connect,
754 GNUNET_MESSAGE_TYPE_TRANSPORT_CONNECT,
755 struct ConnectInfoMessage,
757 GNUNET_MQ_hd_fixed_size (disconnect,
758 GNUNET_MESSAGE_TYPE_TRANSPORT_DISCONNECT,
759 struct DisconnectInfoMessage,
761 GNUNET_MQ_hd_fixed_size (send_ok,
762 GNUNET_MESSAGE_TYPE_TRANSPORT_SEND_OK,
763 struct SendOkMessage,
765 GNUNET_MQ_hd_var_size (recv,
766 GNUNET_MESSAGE_TYPE_TRANSPORT_RECV,
767 struct InboundMessage,
769 GNUNET_MQ_hd_fixed_size (set_quota,
770 GNUNET_MESSAGE_TYPE_TRANSPORT_SET_QUOTA,
771 struct QuotaSetMessage,
773 GNUNET_MQ_handler_end () };
774 struct GNUNET_MQ_Envelope *env;
775 struct StartMessage *s;
778 h->reconnect_task = NULL;
779 LOG (GNUNET_ERROR_TYPE_DEBUG, "Connecting to transport service.\n");
780 GNUNET_assert (NULL == h->mq);
782 GNUNET_CLIENT_connect (h->cfg, "transport", handlers, &mq_error_handler, h);
785 env = GNUNET_MQ_msg (s, GNUNET_MESSAGE_TYPE_TRANSPORT_START);
789 if (NULL != h->handlers)
791 s->options = htonl (options);
793 GNUNET_MQ_send (h->mq, env);
798 * Function that will schedule the job that will try
799 * to connect us again to the client.
801 * @param h transport service to reconnect
804 disconnect_and_schedule_reconnect (struct GNUNET_TRANSPORT_CoreHandle *h)
806 GNUNET_assert (NULL == h->reconnect_task);
807 /* Forget about all neighbours that we used to be connected to */
808 GNUNET_CONTAINER_multipeermap_iterate (h->neighbours, &neighbour_delete, h);
811 GNUNET_MQ_destroy (h->mq);
814 LOG (GNUNET_ERROR_TYPE_DEBUG,
815 "Scheduling task to reconnect to transport service in %s.\n",
816 GNUNET_STRINGS_relative_time_to_string (h->reconnect_delay, GNUNET_YES));
818 GNUNET_SCHEDULER_add_delayed (h->reconnect_delay, &reconnect, h);
819 h->reconnect_delay = GNUNET_TIME_STD_BACKOFF (h->reconnect_delay);
824 * Checks if a given peer is connected to us and get the message queue.
826 * @param handle connection to transport service
827 * @param peer the peer to check
828 * @return NULL if disconnected, otherwise message queue for @a peer
830 struct GNUNET_MQ_Handle *
831 GNUNET_TRANSPORT_core_get_mq (struct GNUNET_TRANSPORT_CoreHandle *handle,
832 const struct GNUNET_PeerIdentity *peer)
836 n = neighbour_find (handle, peer);
844 * Connect to the transport service. Note that the connection may
845 * complete (or fail) asynchronously.
847 * @param cfg configuration to use
848 * @param self our own identity (API should check that it matches
849 * the identity found by transport), or NULL (no check)
850 * @param cls closure for the callbacks
851 * @param rec receive function to call
852 * @param nc function to call on connect events
853 * @param nd function to call on disconnect events
854 * @param neb function to call if we have excess bandwidth to a peer
855 * @return NULL on error
857 struct GNUNET_TRANSPORT_CoreHandle *
858 GNUNET_TRANSPORT_core_connect (const struct GNUNET_CONFIGURATION_Handle *cfg,
859 const struct GNUNET_PeerIdentity *self,
860 const struct GNUNET_MQ_MessageHandler *handlers,
862 GNUNET_TRANSPORT_NotifyConnect nc,
863 GNUNET_TRANSPORT_NotifyDisconnect nd,
864 GNUNET_TRANSPORT_NotifyExcessBandwidth neb)
866 struct GNUNET_TRANSPORT_CoreHandle *h;
869 h = GNUNET_new (struct GNUNET_TRANSPORT_CoreHandle);
873 h->check_self = GNUNET_YES;
880 h->reconnect_delay = GNUNET_TIME_UNIT_ZERO;
881 if (NULL != handlers)
883 for (i = 0; NULL != handlers[i].cb; i++)
885 h->handlers = GNUNET_new_array (i + 1, struct GNUNET_MQ_MessageHandler);
886 GNUNET_memcpy (h->handlers,
888 i * sizeof(struct GNUNET_MQ_MessageHandler));
890 LOG (GNUNET_ERROR_TYPE_DEBUG, "Connecting to transport service\n");
894 GNUNET_free_non_null (h->handlers);
899 GNUNET_CONTAINER_multipeermap_create (STARTING_NEIGHBOURS_SIZE, GNUNET_YES);
905 * Disconnect from the transport service.
907 * @param handle handle to the service as returned from
908 * #GNUNET_TRANSPORT_core_connect()
911 GNUNET_TRANSPORT_core_disconnect (struct GNUNET_TRANSPORT_CoreHandle *handle)
913 LOG (GNUNET_ERROR_TYPE_DEBUG, "Transport disconnect called!\n");
914 /* this disconnects all neighbours... */
915 if (NULL == handle->reconnect_task)
916 disconnect_and_schedule_reconnect (handle);
917 /* and now we stop trying to connect again... */
918 if (NULL != handle->reconnect_task)
920 GNUNET_SCHEDULER_cancel (handle->reconnect_task);
921 handle->reconnect_task = NULL;
923 GNUNET_CONTAINER_multipeermap_destroy (handle->neighbours);
924 handle->neighbours = NULL;
925 GNUNET_free_non_null (handle->handlers);
926 handle->handlers = NULL;
927 GNUNET_free (handle);
932 * Notification from the CORE service to the TRANSPORT service
933 * that the CORE service has finished processing a message from
934 * TRANSPORT (via the @code{handlers} of #GNUNET_TRANSPORT_core_connect())
935 * and that it is thus now OK for TRANSPORT to send more messages
938 * Used to provide flow control, this is our equivalent to
939 * #GNUNET_SERVICE_client_continue() of an ordinary service.
941 * Note that due to the use of a window, TRANSPORT may send multiple
942 * messages destined for the same peer even without an intermediate
943 * call to this function. However, CORE must still call this function
944 * once per message received, as otherwise eventually the window will
945 * be full and TRANSPORT will stop providing messages to CORE for @a
948 * @param ch core handle
949 * @param pid which peer was the message from that was fully processed by CORE
952 GNUNET_TRANSPORT_core_receive_continue (struct GNUNET_TRANSPORT_CoreHandle *ch,
953 const struct GNUNET_PeerIdentity *pid)
955 struct RecvOkMessage *rom;
956 struct GNUNET_MQ_Envelope *env;
958 GNUNET_assert (ch->rom_pending > 0);
960 env = GNUNET_MQ_msg (rom, GNUNET_MESSAGE_TYPE_TRANSPORT_RECV_OK);
961 rom->increase_window_delta = htonl (1);
963 GNUNET_MQ_send (ch->mq, env);
967 /* end of transport_api_core.c */