docu

diff --git a/TODO b/TODO
index b6fca4e15fd32bfb225dbf669de3f501c30f9ce4..b40bb9909e8d9f78efbe446e3ecaf65520a79021 100644 (file)
--- a/TODO
+++ b/TODO
@@ -60,7 +60,7 @@ that would cause them to be executed and check that they are working:
 
 
 Module features to implement:
-* datacache (needed for DHT)
+* DATACACHE (needed for DHT)
   - implement testcases for dstore API 
   - implement testcases for dstore plugin
   - implement performance tests
@@ -83,7 +83,7 @@ Module features to implement:
   - implement performance tests
 * DHT (needed for FS)
   - review DHT API
-  - implement DHT service (needs DV, DSTORE)
+  - implement DHT service (needs DV, DATACACHE)
   - implement DHT library
   - implement testcases
   - implement performance tests

diff --git a/src/include/gnunet_dht_service.h b/src/include/gnunet_dht_service.h
index 9e164245d9eb4753ceb478346e17d35ec64dd492..8dcbc19c53a0ca2137cf6272c0d70535c6a7aab1 100644 (file)
--- a/src/include/gnunet_dht_service.h
+++ b/src/include/gnunet_dht_service.h
@@ -37,39 +37,46 @@ extern "C"
 #endif
 #endif
 
+// FIXME: document
 struct GNUNET_DHT_GetHandle;
 
-  /**
-   * Perform an asynchronous GET operation on the DHT identified.
-   *
-   * @param type expected type of the response object
-   * @param key the key to look up
-   * @param callback function to call on each result
-   * @param closure extra argument to callback
-   * @return handle to stop the async get
-   */
-  struct GNUNET_DHT_GetHandle *
-GNUNET_DHT_get_start) (struct GNUNET_DHT_Handle *h,
-               unsigned int type,
-                                             const GNUNET_HashCode * key,
-                                             GNUNET_DHT_ResultProcessor callback,
-                                             void *callback_cls);
-
-  /**
-   * Stop async DHT-get.  Frees associated resources.
-   */
-  int GNUNET_DHT_get_stop (struct GNUNET_DHT_GetHandle * record);
-
-  /**
-   * Perform a PUT operation on the DHT identified by 'table' storing
-   * a binding of 'key' to 'value'.  The peer does not have to be part
-   * of the table (if so, we will attempt to locate a peer that is!)
-   *
-   * @param key the key to store under
-   */
-  int GNUNET_DHT_put (struct GNUNET_DHT_Handle *h, 
-const GNUNET_HashCode * key,
-              unsigned int type, unsigned int size, const char *data);
+
+/**
+ * Perform an asynchronous GET operation on the DHT identified.
+ *
+ * @param type expected type of the response object
+ * @param key the key to look up
+ * @param iter function to call on each result
+ * @param iter_cls closure for iter
+ * @return handle to stop the async get
+ */
+struct GNUNET_DHT_GetHandle *
+GNUNET_DHT_get_start (struct GNUNET_DHT_Handle *h,
+                     uint32_t type,
+                     const GNUNET_HashCode * key,
+                     GNUNET_DHT_Iterator iter,
+                     void *iter_cls);
+
+
+/**
+ * Stop async DHT-get.  Frees associated resources.
+ */
+int GNUNET_DHT_get_stop (struct GNUNET_DHT_GetHandle *record);
+
+
+// FIXME: add continuation? expiration?
+/**
+ * Perform a PUT operation on the DHT identified by 'table' storing
+ * a binding of 'key' to 'value'.  The peer does not have to be part
+ * of the table (if so, we will attempt to locate a peer that is!)
+ *
+ * @param key the key to store under
+ */
+int GNUNET_DHT_put (struct GNUNET_DHT_Handle *h, 
+                   const GNUNET_HashCode * key,
+                   uint32_t type, 
+                   uint32_t size, 
+                   const char *data);
 
 
 #if 0                           /* keep Emacsens' auto-indent happy */
@@ -80,4 +87,5 @@ const GNUNET_HashCode * key,
 #endif
 
 
-#endif /* DHT_SERVICE_API_H */
+#endif 
+/* gnunet_dht_service.h */