[GNUnet-SVN] r8785 - in gnunet: . src/include

[gnunet]

Author: grothoff
Date: 2009-07-25 17:19:49 -0600 (Sat, 25 Jul 2009)
New Revision: 8785

Modified:
   gnunet/TODO
   gnunet/src/include/gnunet_dht_service.h
Log:
docu

Modified: gnunet/TODO
===================================================================
--- gnunet/TODO 2009-07-25 23:13:12 UTC (rev 8784)
+++ gnunet/TODO 2009-07-25 23:19:49 UTC (rev 8785)
@@ -60,7 +60,7 @@
 
 
 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 @@
   - 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

Modified: gnunet/src/include/gnunet_dht_service.h
===================================================================
--- gnunet/src/include/gnunet_dht_service.h     2009-07-25 23:13:12 UTC (rev 
8784)
+++ gnunet/src/include/gnunet_dht_service.h     2009-07-25 23:19:49 UTC (rev 
8785)
@@ -37,41 +37,48 @@
 #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 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);
 
-  /**
-   * 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);
 
+/**
+ * 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 */
 {
 #endif
@@ -80,4 +87,5 @@
 #endif
 
 
-#endif /* DHT_SERVICE_API_H */
+#endif 
+/* gnunet_dht_service.h */