print stat
[oweals/gnunet.git] / src / dht / gnunet-service-dht_neighbours.h
index 2c20df2c4748a4347cb5b18f14f8d1db4297a75a..d23ea10ab109b95e377222784c6030d582192b6c 100644 (file)
@@ -27,6 +27,9 @@
 #ifndef GNUNET_SERVICE_DHT_NEIGHBOURS_H
 #define GNUNET_SERVICE_DHT_NEIGHBOURS_H
 
+#include "gnunet_util_lib.h"
+#include "gnunet_block_lib.h"
+#include "gnunet_dht_service.h"
 
 /**
  * Perform a PUT operation.  Forwards the given request to other
  * @param data_size number of bytes in data
  */
 void
-GDS_NEIGHBOURS_handle_put (uint32_t type,
-                          uint32_t options,
+GDS_NEIGHBOURS_handle_put (enum GNUNET_BLOCK_Type type,
+                          enum GNUNET_DHT_RouteOption options,
                           uint32_t desired_replication_level,
-                          GNUNET_TIME_Absolute expiration_time,
+                          struct GNUNET_TIME_Absolute expiration_time,
                           uint32_t hop_count,
                           struct GNUNET_CONTAINER_BloomFilter *bf,
                           const GNUNET_HashCode *key,
@@ -76,11 +79,11 @@ GDS_NEIGHBOURS_handle_put (uint32_t type,
  * @param xquery_size number of bytes in xquery
  * @param reply_bf bloomfilter to filter duplicates
  * @param reply_bf_mutator mutator for reply_bf
- * @param peer_bf filter for peers not to select (again)
+ * @param peer_bf filter for peers not to select (again, updated)
  */
 void
-GDS_NEIGHBOURS_handle_get (uint32_t type,
-                          uint32_t options,
+GDS_NEIGHBOURS_handle_get (enum GNUNET_BLOCK_Type type,
+                          enum GNUNET_DHT_RouteOption options,
                           uint32_t desired_replication_level,
                           uint32_t hop_count,
                           const GNUNET_HashCode *key,
@@ -88,7 +91,7 @@ GDS_NEIGHBOURS_handle_get (uint32_t type,
                           size_t xquery_size,
                           const struct GNUNET_CONTAINER_BloomFilter *reply_bf,
                           uint32_t reply_bf_mutator,
-                          const struct GNUNET_CONTAINER_BloomFilter *peer_bf);
+                          struct GNUNET_CONTAINER_BloomFilter *peer_bf);
 
 
 /**
@@ -96,6 +99,7 @@ GDS_NEIGHBOURS_handle_get (uint32_t type,
  * other peers waiting for it.  Does not do local caching or
  * forwarding to local clients.
  *
+ * @param target neighbour that should receive the block (if still connected)
  * @param type type of the block
  * @param expiration_time when does the content expire
  * @param key key for the content
@@ -107,23 +111,27 @@ GDS_NEIGHBOURS_handle_get (uint32_t type,
  * @param data_size number of bytes in data
  */
 void
-GDS_NEIGHBOURS_handle_reply (uint32_t type,
-                            GNUNET_TIME_Absolute expiration_time,
+GDS_NEIGHBOURS_handle_reply (const struct GNUNET_PeerIdentity *target,
+                            enum GNUNET_BLOCK_Type type,
+                            struct GNUNET_TIME_Absolute expiration_time,
                             const GNUNET_HashCode *key,
                             unsigned int put_path_length,
-                            struct GNUNET_PeerIdentity *put_path,
+                            const struct GNUNET_PeerIdentity *put_path,
                             unsigned int get_path_length,
-                            struct GNUNET_PeerIdentity *get_path,
+                            const struct GNUNET_PeerIdentity *get_path,
                             const void *data,
                             size_t data_size);
 
 
 /**
  * Initialize neighbours subsystem.
+ *
+ * @return GNUNET_OK on success, GNUNET_SYSERR on error
  */
-void
+int
 GDS_NEIGHBOURS_init (void);
 
+
 /**
  * Shutdown neighbours subsystem.
  */