summaryrefslogtreecommitdiff
path: root/src/consensus
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2021-12-29 19:12:28 +0100
committerChristian Grothoff <christian@grothoff.org>2021-12-29 19:12:28 +0100
commitdaa9284567865177279a692eb722e257ed06923e (patch)
tree1954840c92a91027d2caee63668f9c7b2b79f04e /src/consensus
parent2536cd090b7e467e604cf5cfe5d1d93b32431876 (diff)
implement revised block API
Diffstat (limited to 'src/consensus')
-rw-r--r--src/consensus/plugin_block_consensus.c116
1 files changed, 113 insertions, 3 deletions
diff --git a/src/consensus/plugin_block_consensus.c b/src/consensus/plugin_block_consensus.c
index cdac12ed5..67309bc79 100644
--- a/src/consensus/plugin_block_consensus.c
+++ b/src/consensus/plugin_block_consensus.c
@@ -1,6 +1,6 @@
/*
This file is part of GNUnet
- Copyright (C) 2017 GNUnet e.V.
+ Copyright (C) 2017, 2021 GNUnet e.V.
GNUnet is free software: you can redistribute it and/or modify it
under the terms of the GNU Affero General Public License as published
@@ -80,6 +80,109 @@ block_plugin_consensus_evaluate (void *cls,
/**
+ * Function called to validate a query.
+ *
+ * @param cls closure
+ * @param ctx block context
+ * @param type block type
+ * @param query original query (hash)
+ * @param xquery extrended query data (can be NULL, depending on type)
+ * @param xquery_size number of bytes in @a xquery
+ * @return #GNUNET_OK if the query is fine, #GNUNET_NO if not
+ */
+static enum GNUNET_GenericReturnValue
+block_plugin_consensus_check_query (void *cls,
+ enum GNUNET_BLOCK_Type type,
+ const struct GNUNET_HashCode *query,
+ const void *xquery,
+ size_t xquery_size)
+{
+ /* consensus does not use queries/DHT */
+ GNUNET_break (0);
+ return GNUNET_SYSERR;
+}
+
+
+/**
+ * Function called to validate a block for storage.
+ *
+ * @param cls closure
+ * @param type block type
+ * @param query key for the block (hash), must match exactly
+ * @param block block data to validate
+ * @param block_size number of bytes in @a block
+ * @return #GNUNET_OK if the block is fine, #GNUNET_NO if not
+ */
+static enum GNUNET_GenericReturnValue
+block_plugin_consensus_check_block (void *cls,
+ enum GNUNET_BLOCK_Type type,
+ const struct GNUNET_HashCode *query,
+ const void *block,
+ size_t block_size)
+{
+ struct GNUNET_BLOCK_Context *ctx = cls;
+ const struct ConsensusElement *ce = block;
+
+ if (block_size < sizeof(*ce))
+ return GNUNET_NO;
+ if ( (0 != ce->marker) ||
+ (0 == ce->payload_type) )
+ return GNUNET_OK;
+ return GNUNET_BLOCK_check_block (ctx,
+ ntohl (ce->payload_type),
+ query,
+ &ce[1],
+ block_size - sizeof(*ce));
+}
+
+
+/**
+ * Function called to validate a reply to a request. Note that it is assumed
+ * that the reply has already been matched to the key (and signatures checked)
+ * as it would be done with the GetKeyFunction and the
+ * BlockEvaluationFunction.
+ *
+ * @param cls closure
+ * @param type block type
+ * @param group which block group to use for evaluation
+ * @param query original query (hash)
+ * @param xquery extrended query data (can be NULL, depending on type)
+ * @param xquery_size number of bytes in @a xquery
+ * @param reply_block response to validate
+ * @param reply_block_size number of bytes in @a reply_block
+ * @return characterization of result
+ */
+static enum GNUNET_BLOCK_ReplyEvaluationResult
+block_plugin_consensus_check_reply (
+ void *cls,
+ enum GNUNET_BLOCK_Type type,
+ struct GNUNET_BLOCK_Group *group,
+ const struct GNUNET_HashCode *query,
+ const void *xquery,
+ size_t xquery_size,
+ const void *reply_block,
+ size_t reply_block_size)
+{
+ struct GNUNET_BLOCK_Context *ctx = cls;
+ const struct ConsensusElement *ce = reply_block;
+
+ if (reply_block_size < sizeof(struct ConsensusElement))
+ return GNUNET_NO;
+ if ( (0 != ce->marker) ||
+ (0 == ce->payload_type) )
+ return GNUNET_BLOCK_REPLY_OK_MORE;
+ return GNUNET_BLOCK_check_reply (ctx,
+ ntohl (ce->payload_type),
+ group,
+ query,
+ xquery,
+ xquery_size,
+ &ce[1],
+ reply_block_size - sizeof(*ce));
+}
+
+
+/**
* Function called to obtain the key for a block.
*
* @param cls closure
@@ -90,7 +193,7 @@ block_plugin_consensus_evaluate (void *cls,
* @return #GNUNET_OK on success, #GNUNET_SYSERR if type not supported
* (or if extracting a key from a block of this type does not work)
*/
-static int
+static enum GNUNET_GenericReturnValue
block_plugin_consensus_get_key (void *cls,
enum GNUNET_BLOCK_Type type,
const void *block,
@@ -107,15 +210,20 @@ block_plugin_consensus_get_key (void *cls,
void *
libgnunet_plugin_block_consensus_init (void *cls)
{
- static enum GNUNET_BLOCK_Type types[] = {
+ static const enum GNUNET_BLOCK_Type types[] = {
GNUNET_BLOCK_TYPE_CONSENSUS_ELEMENT,
GNUNET_BLOCK_TYPE_ANY /* end of list */
};
+ const struct GNUNET_CONFIGURATION_Handle *cfg = cls;
struct GNUNET_BLOCK_PluginFunctions *api;
api = GNUNET_new (struct GNUNET_BLOCK_PluginFunctions);
+ api->cls = GNUNET_BLOCK_context_create (cfg);
api->evaluate = &block_plugin_consensus_evaluate;
api->get_key = &block_plugin_consensus_get_key;
+ api->check_query = &block_plugin_consensus_check_query;
+ api->check_block = &block_plugin_consensus_check_block;
+ api->check_reply = &block_plugin_consensus_check_reply;
api->types = types;
return api;
}
@@ -128,7 +236,9 @@ void *
libgnunet_plugin_block_consensus_done (void *cls)
{
struct GNUNET_BLOCK_PluginFunctions *api = cls;
+ struct GNUNET_BLOCK_Context *bc = api->cls;
+ GNUNET_BLOCK_context_destroy (bc);
GNUNET_free (api);
return NULL;
}