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 1b3aac7c9315ac4c6f6a6cd73d9b2a193b6cf7d6..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);
 
 
 /**
@@ -713,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.
@@ -728,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.
  *
@@ -738,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.
  *
@@ -756,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.
  *
@@ -810,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.
  *