[GNUnet-SVN] r25621 - gnunet/src/include

[gnunet]

Author: grothoff
Date: 2012-12-21 14:31:55 +0100 (Fri, 21 Dec 2012)
New Revision: 25621

Modified:
   gnunet/src/include/gnunet_consensus_service.h
Log:
-API discussion

Modified: gnunet/src/include/gnunet_consensus_service.h
===================================================================
--- gnunet/src/include/gnunet_consensus_service.h       2012-12-21 13:12:03 UTC 
(rev 25620)
+++ gnunet/src/include/gnunet_consensus_service.h       2012-12-21 13:31:55 UTC 
(rev 25621)
@@ -154,14 +154,57 @@
 
 
 
+struct GNUNET_CONSENSUS_DeltaRequest;
 
 /**
+ * We are finished inserting new elements into the consensus;
+ * try to conclude the consensus within a given time window.
+ *
+ * @param consensus consensus session
+ * @param timeout timeout after which the conculde callback
+ *                must be called
+ * @param conclude called when the conclusion was successful
+ * @param conclude_cls closure for the conclude callback
+ */
+struct GNUNET_CONSENSUS_DeltaRequest *
+GNUNET_CONSENSUS_get_delta (struct GNUNET_CONSENSUS_Handle *consensus,
+                           uint32_t group_id,
+                           GNUNET_CONSENSUS_NewElementCallback 
remove_element_cb,
+                           void *remove_element_cb_cls);
+
+
+void
+GNUNET_CONSENSUS_get_delta_cancel (struct GNUNET_CONSENSUS_DeltaRequest *dr);
+
+
+struct GNUNET_CONSENSUS_Group
+{
+  uint32_t group_id; /* offset into groups? */
+  unsigned int num_members;
+  uint64_t total_elements_in_group;
+  const struct GNUNET_PeerIdentity **members;
+};
+                                      
+
+/**
  * Called when a conclusion was successful.
  *
  * @param cls
  * @param num_peers_in_consensus
  * @param peers_in_consensus
  */
+typedef void (*GNUNET_CONSENSUS_NewConcludeCallback) (void *cls, 
+                                                     unsigned int 
consensus_group_count,
+                                                     const struct 
GNUNET_CONSENSUS_Group *groups);
+
+
+/**
+ * Called when a conclusion was successful.
+ *
+ * @param cls
+ * @param num_peers_in_consensus
+ * @param peers_in_consensus
+ */
 typedef void (*GNUNET_CONSENSUS_ConcludeCallback) (void *cls, 
                                                   unsigned int 
num_peers_in_consensus,
                                                   const struct 
GNUNET_PeerIdentity *peers_in_consensus);