X-Git-Url: https://git.librecmc.org/?a=blobdiff_plain;f=src%2Finclude%2Fgnunet_cadet_service.h;h=fd838df8d63d998911901478f8c22754c50fd532;hb=abdec5e11ff11bb10d32c013e11344a54786f80f;hp=1434180f49dc8b5bbc930a0ace82a71b96070b81;hpb=ae5354d85a43830da6921a53071edfe3859e21a9;p=oweals%2Fgnunet.git diff --git a/src/include/gnunet_cadet_service.h b/src/include/gnunet_cadet_service.h index 1434180f4..fd838df8d 100644 --- a/src/include/gnunet_cadet_service.h +++ b/src/include/gnunet_cadet_service.h @@ -456,7 +456,7 @@ typedef void int tunnel, int neighbor, unsigned int n_paths, - struct GNUNET_PeerIdentity *paths); + const struct GNUNET_PeerIdentity *paths); /** @@ -702,9 +702,6 @@ GC_u2h (uint32_t port); * @param cls Closure from #GNUNET_CADET_open_porT. * @param channel New handle to the channel. * @param source Peer that started this channel. - * FIXME: Add port that this channel is created for, or is cls enough? - * Port cannot be closed yet, #handle_channel_create would have - * rejected it. * @return Closure for the incoming @a channel. It's given to: * - The #GNUNET_CADET_DisconnectEventHandler (given to * #GNUNET_CADET_open_porT) when the channel dies. @@ -716,6 +713,7 @@ typedef void * struct GNUNET_CADET_Channel *channel, const struct GNUNET_PeerIdentity *source); + /** * Function called whenever an MQ-channel is destroyed, even if the destruction * was requested by #GNUNET_CADET_channel_destroy. @@ -731,6 +729,7 @@ typedef void (*GNUNET_CADET_DisconnectEventHandler) (void *cls, const struct GNUNET_CADET_Channel *channel); + /** * Function called whenever an MQ-channel's transmission window size changes. * @@ -741,15 +740,16 @@ typedef void * #GNUNET_CADET_ConnectEventHandler, also with a non-zero value. * * @param cls Channel closure. - * @param channel Connection to the other end (henceforth invalid). + * @param channel Connection to the other end --- FIXME: drop? * @param window_size New window size. If the is more messages than buffer size - * this value will be negative.. + * this value will be negative. -- FIXME: make unsigned, we never call negative? */ typedef void (*GNUNET_CADET_WindowSizeEventHandler) (void *cls, const struct GNUNET_CADET_Channel *channel, int window_size); + /** * Connect to the MQ-based cadet service. * @@ -759,6 +759,7 @@ typedef void struct GNUNET_CADET_Handle * GNUNET_CADET_connecT (const struct GNUNET_CONFIGURATION_Handle *cfg); + /** * Open a port to receive incomming MQ-based channels. * @@ -813,6 +814,7 @@ GNUNET_CADET_channel_creatE (struct GNUNET_CADET_Handle *h, GNUNET_CADET_DisconnectEventHandler disconnects, const struct GNUNET_MQ_MessageHandler *handlers); + /** * Obtain the message queue for a connected channel. *