cleaning up set handlers, eliminating 2nd level demultiplexing and improving use...

[oweals/gnunet.git] / src / include / gnunet_cadet_service.h

diff --git a/src/include/gnunet_cadet_service.h b/src/include/gnunet_cadet_service.h
index 1434180f49dc8b5bbc930a0ace82a71b96070b81..fd838df8d63d998911901478f8c22754c50fd532 100644 (file)
--- 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.
  *