*/
typedef void (*GNUNET_STATISTICS_Callback) (void *cls, int success);
+/**
+ * Handle that can be used to cancel a statistics 'get' operation.
+ */
+struct GNUNET_STATISTICS_GetHandle;
+
/**
* Get statistic from the peer.
*
* @param cont continuation to call when done (can be NULL)
* @param proc function to call on each value
* @param cls closure for proc and cont
+ * @return NULL on error
*/
-void
+struct GNUNET_STATISTICS_GetHandle *
GNUNET_STATISTICS_get (struct GNUNET_STATISTICS_Handle *handle,
const char *subsystem,
const char *name,
GNUNET_STATISTICS_Callback cont,
GNUNET_STATISTICS_Iterator proc, void *cls);
+
+/**
+ * Cancel a 'get' request. Must be called before the 'cont'
+ * function is called.
+ *
+ * @param gh handle of the request to cancel
+ */
+void
+GNUNET_STATISTICS_get_cancel (struct GNUNET_STATISTICS_GetHandle *gh);
+
+
/**
* Set statistic value for the peer. Will always use our
* subsystem (the argument used when "handle" was created).