[GNUnet-SVN] r18592 - gnunet/src/include

[gnunet]

Author: grothoff
Date: 2011-12-14 14:41:42 +0100 (Wed, 14 Dec 2011)
New Revision: 18592

Modified:
   gnunet/src/include/gnunet_stream_lib.h
Log:
-api improvement

Modified: gnunet/src/include/gnunet_stream_lib.h
===================================================================
--- gnunet/src/include/gnunet_stream_lib.h      2011-12-14 13:36:23 UTC (rev 
18591)
+++ gnunet/src/include/gnunet_stream_lib.h      2011-12-14 13:41:42 UTC (rev 
18592)
@@ -81,6 +81,28 @@
 
 
 /**
+ * Options for the stream.
+ */
+enum GNUNET_STREAM_Option
+  {
+    /**
+     * End of the option list.
+     */
+    GNUNET_STREAM_OPTION_END = 0,
+
+    /**
+     * Option to set the initial retransmission timeout (when do we retransmit
+     * a packet that did not yield an acknowledgement for the first time?).  
+     * Repeated retransmissions will then use an exponential back-off.
+     * Takes a 'struct GNUNET_TIME_Relative' as the only argument.  A value
+     * of '0' means to use the round-trip time (plus a tiny grace period);
+     * this is also the default.
+     */
+    GNUNET_STREAM_OPTION_INITIAL_RETRANSMIT_TIMEOUT
+  };
+
+
+/**
  * Tries to open a stream to the target peer
  *
  * @param target the target peer to which the stream has to be opened
@@ -88,6 +110,7 @@
  *            stream
  * @param open_cb this function will be called after stream has be established 
  * @param open_cb_cls the closure for open_cb
+ * @param ... options to the stream, terminated by GNUNET_STREAM_OPTION_END
  * @return if successful it returns the stream socket; NULL if stream cannot be
  *         opened 
  */
@@ -95,7 +118,8 @@
 GNUNET_STREAM_open (const struct GNUNET_PeerIdentity *target,
                     GNUNET_MESH_ApplicationType app_port,
                     GNUNET_STREAM_OpenCallback open_cb,
-                   void *open_cb_cls);
+                   void *open_cb_cls,
+                   ...);
 
 
 /**