-options to play with

[oweals/gnunet.git] / src / fs / gnunet-service-fs_stream.h

diff --git a/src/fs/gnunet-service-fs_stream.h b/src/fs/gnunet-service-fs_stream.h
index daa617290ec09a1b442e443eccdccc3b0b0360c2..98276676395eedb8a3710fdcfa896abaabb4f9c5 100644 (file)
--- a/src/fs/gnunet-service-fs_stream.h
+++ b/src/fs/gnunet-service-fs_stream.h
@@ -26,6 +26,55 @@
 #ifndef GNUNET_SERVICE_FS_STREAM_H
 #define GNUNET_SERVICE_FS_STREAM_H
 
+/**
+ * Handle for a request that is going out via stream API.
+ */
+struct GSF_StreamRequest;
+
+
+/**
+ * Function called with a reply from the stream.
+ * 
+ * @param cls closure
+ * @param type type of the block, ANY on error
+ * @param expiration expiration time for the block
+ * @param data_size number of bytes in 'data', 0 on error
+ * @param data reply block data, NULL on error
+ */
+typedef void (*GSF_StreamReplyProcessor)(void *cls,
+                                        enum GNUNET_BLOCK_Type type,
+                                        struct GNUNET_TIME_Absolute expiration,
+                                        size_t data_size,
+                                        const void *data);
+
+
+/**
+ * Look for a block by directly contacting a particular peer.
+ *
+ * @param target peer that should have the block
+ * @param query hash to query for the block
+ * @param type desired type for the block
+ * @param proc function to call with result
+ * @param proc_cls closure for 'proc'
+ * @return handle to cancel the operation
+ */
+struct GSF_StreamRequest *
+GSF_stream_query (const struct GNUNET_PeerIdentity *target,
+                 const struct GNUNET_HashCode *query,
+                 enum GNUNET_BLOCK_Type type,
+                 GSF_StreamReplyProcessor proc, void *proc_cls);
+
+
+/**
+ * Cancel an active request; must not be called after 'proc'
+ * was calld.
+ *
+ * @param sr request to cancel
+ */
+void
+GSF_stream_query_cancel (struct GSF_StreamRequest *sr);
+
+
 /**
  * Initialize subsystem for non-anonymous file-sharing.
  */