API to perform and access key revocations. More...

#include "platform.h"
#include "gnunet_revocation_service.h"
#include "gnunet_signatures.h"
#include "gnunet_protocols.h"
#include "revocation.h"
#include <inttypes.h>

Include dependency graph for revocation_api.c:

Data Structures
struct	GNUNET_REVOCATION_Query
	Handle for the key revocation query. More...

struct	BestPow
	Helper struct that holds a found pow nonce and the corresponding number of leading zeros. More...

struct	GNUNET_REVOCATION_PowCalculationHandle
	The handle to a PoW calculation. More...

struct	GNUNET_REVOCATION_Handle
	Handle for the key revocation operation. More...

Functions
static void	query_mq_error_handler (void *cls, enum GNUNET_MQ_Error error)
	Generic error handler, called with the appropriate error code and the same closure specified at the creation of the message queue. More...

static void	handle_revocation_query_response (void cls, const struct QueryResponseMessage qrm)
	Handle response to our revocation query. More...

struct GNUNET_REVOCATION_Query *	GNUNET_REVOCATION_query (const struct GNUNET_CONFIGURATION_Handle cfg, const struct GNUNET_IDENTITY_PublicKey key, GNUNET_REVOCATION_Callback func, void *func_cls)
	Check if a key was revoked. More...

void	GNUNET_REVOCATION_query_cancel (struct GNUNET_REVOCATION_Query *q)
	Cancel key revocation check. More...

static void	revocation_mq_error_handler (void *cls, enum GNUNET_MQ_Error error)
	Generic error handler, called with the appropriate error code and the same closure specified at the creation of the message queue. More...

static void	handle_revocation_response (void cls, const struct RevocationResponseMessage rrm)
	Handle response to our revocation query. More...

struct GNUNET_REVOCATION_Handle *	GNUNET_REVOCATION_revoke (const struct GNUNET_CONFIGURATION_Handle cfg, const struct GNUNET_REVOCATION_PowP pow, GNUNET_REVOCATION_Callback func, void *func_cls)
	Perform key revocation. More...

void	GNUNET_REVOCATION_revoke_cancel (struct GNUNET_REVOCATION_Handle *h)
	Cancel key revocation. More...

static unsigned int	calculate_score (const struct GNUNET_REVOCATION_PowCalculationHandle *ph)
	Calculate the average zeros in the pows. More...

struct GNUNET_REVOCATION_SignaturePurposePS *	REV_create_signature_message (const struct GNUNET_REVOCATION_PowP *pow)
	Create the revocation metadata to sign for a revocation message. More...

enum GNUNET_GenericReturnValue	check_signature_identity (const struct GNUNET_REVOCATION_PowP pow, const struct GNUNET_IDENTITY_PublicKey key)

enum GNUNET_GenericReturnValue	check_signature (const struct GNUNET_REVOCATION_PowP *pow)

enum GNUNET_GenericReturnValue	GNUNET_REVOCATION_check_pow (const struct GNUNET_REVOCATION_PowP *pow, unsigned int difficulty, struct GNUNET_TIME_Relative epoch_duration)
	Check if the given proof-of-work is valid. More...

enum GNUNET_GenericReturnValue	sign_pow_identity (const struct GNUNET_IDENTITY_PrivateKey key, struct GNUNET_REVOCATION_PowP pow)

enum GNUNET_GenericReturnValue	sign_pow (const struct GNUNET_IDENTITY_PrivateKey key, struct GNUNET_REVOCATION_PowP pow)

void	GNUNET_REVOCATION_pow_init (const struct GNUNET_IDENTITY_PrivateKey key, struct GNUNET_REVOCATION_PowP pow)
	Initializes a fresh PoW computation. More...

struct GNUNET_REVOCATION_PowCalculationHandle *	GNUNET_REVOCATION_pow_start (struct GNUNET_REVOCATION_PowP *pow, int epochs, unsigned int difficulty)
	Starts a proof-of-work calculation given the pow object as well as target epochs and difficulty. More...

static int	cmp_pow_value (const void a, const void b)
	Comparison function for quicksort. More...

enum GNUNET_GenericReturnValue	GNUNET_REVOCATION_pow_round (struct GNUNET_REVOCATION_PowCalculationHandle *pc)
	Calculate a key revocation valid for broadcasting for a number of epochs. More...

void	GNUNET_REVOCATION_pow_stop (struct GNUNET_REVOCATION_PowCalculationHandle *pc)
	Stop a PoW calculation. More...

size_t	GNUNET_REVOCATION_proof_get_size (const struct GNUNET_REVOCATION_PowP *pow)

Variables
static struct GNUNET_CRYPTO_PowSalt	salt = { "GnsRevocationPow" }

Detailed Description

API to perform and access key revocations.

Author: Christian Grothoff

Definition in file revocation_api.c.

Function Documentation

◆ query_mq_error_handler()

static void query_mq_error_handler	(	void *	cls,
		enum GNUNET_MQ_Error	error
	)

static

Generic error handler, called with the appropriate error code and the same closure specified at the creation of the message queue.

Not every message queue implementation supports an error handler.

Parameters

cls	closure with the `struct GNUNET_NSE_Handle *`
error	error code

Definition at line 118 of file revocation_api.c.

 {
   struct GNUNET_REVOCATION_Query *q = cls;
  
   GNUNET_log (GNUNET_ERROR_TYPE_INFO,
               "Revocation query MQ error\n");
   q->func (q->func_cls,
            GNUNET_SYSERR);
   GNUNET_REVOCATION_query_cancel (q);
 }

References GNUNET_REVOCATION_Query::func, GNUNET_REVOCATION_Query::func_cls, GNUNET_ERROR_TYPE_INFO, GNUNET_log, GNUNET_REVOCATION_query_cancel(), GNUNET_SYSERR, and q.

Referenced by GNUNET_REVOCATION_query().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ handle_revocation_query_response()

static void handle_revocation_query_response	(	void *	cls,
		const struct QueryResponseMessage *	qrm
	)

static

Handle response to our revocation query.

Parameters

cls	our `struct GNUNET_REVOCATION_Query` handle
qrm	response we got

Definition at line 138 of file revocation_api.c.

 {
   struct GNUNET_REVOCATION_Query *q = cls;
  
   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
               "Revocation query result: %d\n",
               (uint32_t) ntohl (qrm->is_valid));
   q->func (q->func_cls,
            ntohl (qrm->is_valid));
   GNUNET_REVOCATION_query_cancel (q);
 }

References GNUNET_REVOCATION_Query::func, GNUNET_REVOCATION_Query::func_cls, GNUNET_ERROR_TYPE_DEBUG, GNUNET_log, GNUNET_REVOCATION_query_cancel(), QueryResponseMessage::is_valid, and q.

Here is the call graph for this function:

◆ revocation_mq_error_handler()

static void revocation_mq_error_handler	(	void *	cls,
		enum GNUNET_MQ_Error	error
	)

static

Generic error handler, called with the appropriate error code and the same closure specified at the creation of the message queue.

Not every message queue implementation supports an error handler.

Parameters

cls	closure with the `struct GNUNET_NSE_Handle *`
error	error code

Definition at line 252 of file revocation_api.c.

 {
   struct GNUNET_REVOCATION_Handle *h = cls;
  
   GNUNET_log (GNUNET_ERROR_TYPE_WARNING,
               "Revocation MQ error\n");
   h->func (h->func_cls,
            GNUNET_SYSERR);
   GNUNET_REVOCATION_revoke_cancel (h);
 }

References GNUNET_ERROR_TYPE_WARNING, GNUNET_log, GNUNET_REVOCATION_revoke_cancel(), GNUNET_SYSERR, and h.

Referenced by GNUNET_REVOCATION_revoke().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ handle_revocation_response()

static void handle_revocation_response	(	void *	cls,
		const struct RevocationResponseMessage *	rrm
	)

static

Handle response to our revocation query.

Parameters

cls	our `struct GNUNET_REVOCATION_Handle` handle
rrm	response we got

Definition at line 272 of file revocation_api.c.

 {
   struct GNUNET_REVOCATION_Handle *h = cls;
  
   GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
               "Revocation transmission result: %d\n",
               (uint32_t) ntohl (rrm->is_valid));
   h->func (h->func_cls,
            ntohl (rrm->is_valid));
   GNUNET_REVOCATION_revoke_cancel (h);
 }

References GNUNET_ERROR_TYPE_DEBUG, GNUNET_log, GNUNET_REVOCATION_revoke_cancel(), h, and RevocationResponseMessage::is_valid.

Here is the call graph for this function:

◆ calculate_score()

static unsigned int calculate_score ( const struct GNUNET_REVOCATION_PowCalculationHandle * ph )

static

Calculate the average zeros in the pows.

Parameters

ph	the PowHandle

Returns: the average number of zeros.

Definition at line 395 of file revocation_api.c.

 {
   double sum = 0.0;
   for (unsigned int j = 0; j<POW_COUNT; j++)
     sum += ph->best[j].bits;
   double avg = sum / POW_COUNT;
   return avg;
 }

References ph, POW_COUNT, and consensus-simulation::sum.

◆ REV_create_signature_message()

struct GNUNET_REVOCATION_SignaturePurposePS* REV_create_signature_message ( const struct GNUNET_REVOCATION_PowP * pow )

Create the revocation metadata to sign for a revocation message.

Parameters

pow	the PoW to sign

Returns: the signature purpose

Definition at line 406 of file revocation_api.c.

 {
   struct GNUNET_REVOCATION_SignaturePurposePS *spurp;
   const struct GNUNET_IDENTITY_PublicKey *pk;
   size_t ksize;
  
   pk = (const struct GNUNET_IDENTITY_PublicKey *) &pow[1];
   ksize = GNUNET_IDENTITY_public_key_get_length (pk);
   spurp = GNUNET_malloc (sizeof (*spurp) + ksize);
   spurp->timestamp = pow->timestamp;
   spurp->purpose.purpose = htonl (GNUNET_SIGNATURE_PURPOSE_GNS_REVOCATION);
   spurp->purpose.size = htonl (sizeof(*spurp) + ksize);
   GNUNET_IDENTITY_write_public_key_to_buffer (pk,
                                               (char*) &spurp[1],
                                               ksize);
   return spurp;
 }

Referenced by run_with_key().

Here is the caller graph for this function:

◆ check_signature_identity()

enum GNUNET_GenericReturnValue check_signature_identity	(	const struct GNUNET_REVOCATION_PowP *	pow,
		const struct GNUNET_IDENTITY_PublicKey *	key
	)

Definition at line 406 of file revocation_api.c.

 {
   struct GNUNET_REVOCATION_SignaturePurposePS *spurp;
   unsigned char *sig;
   size_t ksize;
   int ret;
  
   ksize = GNUNET_IDENTITY_public_key_get_length (key);
   spurp = REV_create_signature_message (pow);
   sig = ((unsigned char*) &pow[1] + ksize);
   ret =
     GNUNET_IDENTITY_signature_verify_raw_ (
       GNUNET_SIGNATURE_PURPOSE_GNS_REVOCATION,
       &spurp->purpose,
       sig,
       key);
   GNUNET_free (spurp);
   return ret == GNUNET_OK ? GNUNET_OK : GNUNET_SYSERR;
 }

◆ check_signature()

enum GNUNET_GenericReturnValue check_signature ( const struct GNUNET_REVOCATION_PowP * pow )

Definition at line 406 of file revocation_api.c.

 {
   const struct GNUNET_IDENTITY_PublicKey *pk;
  
   pk = (const struct GNUNET_IDENTITY_PublicKey *) &pow[1];
   return check_signature_identity (pow, pk);
 }

References GNUNET_IDENTITY_public_key_get_length(), GNUNET_IDENTITY_write_public_key_to_buffer(), GNUNET_malloc, GNUNET_SIGNATURE_PURPOSE_GNS_REVOCATION, pk, GNUNET_CRYPTO_EccSignaturePurpose::purpose, GNUNET_REVOCATION_SignaturePurposePS::purpose, GNUNET_CRYPTO_EccSignaturePurpose::size, GNUNET_REVOCATION_SignaturePurposePS::timestamp, and GNUNET_REVOCATION_PowP::timestamp.

Here is the call graph for this function:

◆ sign_pow_identity()

enum GNUNET_GenericReturnValue sign_pow_identity	(	const struct GNUNET_IDENTITY_PrivateKey *	key,
		struct GNUNET_REVOCATION_PowP *	pow
	)

Predate the validity period to prevent rejections due to unsynchronized clocks

Definition at line 406 of file revocation_api.c.

 {
   struct GNUNET_TIME_Absolute ts = GNUNET_TIME_absolute_get ();
   struct GNUNET_REVOCATION_SignaturePurposePS *rp;
   const struct GNUNET_IDENTITY_PublicKey *pk;
   size_t ksize;
   char *sig;
  
   ts = GNUNET_TIME_absolute_subtract (ts,
                                       GNUNET_TIME_UNIT_WEEKS);
   pk = (const struct GNUNET_IDENTITY_PublicKey *) &pow[1];
   ksize = GNUNET_IDENTITY_public_key_get_length (pk);
   pow->timestamp = GNUNET_TIME_absolute_hton (ts);
   rp = REV_create_signature_message (pow);
   sig = ((char*) &pow[1]) + ksize;
   int result = GNUNET_IDENTITY_sign_raw_ (key,
                                           &rp->purpose,
                                           (void*) sig);
   GNUNET_free (rp);
   if (result == GNUNET_SYSERR)
     return GNUNET_NO;
   else
     return result;
 }

◆ sign_pow()

enum GNUNET_GenericReturnValue sign_pow	(	const struct GNUNET_IDENTITY_PrivateKey *	key,
		struct GNUNET_REVOCATION_PowP *	pow
	)

Definition at line 406 of file revocation_api.c.

 {
   struct GNUNET_IDENTITY_PublicKey *pk;
  
   pk = (struct GNUNET_IDENTITY_PublicKey *) &pow[1];
   GNUNET_IDENTITY_key_get_public (key, pk);
   return sign_pow_identity (key, pow);
 }

Referenced by GNUNET_REVOCATION_pow_init().

Here is the caller graph for this function:

◆ cmp_pow_value()

static int cmp_pow_value	(	const void *	a,
		const void *	b
	)

static

Comparison function for quicksort.

Parameters

a	left element
b	right element

Returns: a-b

Definition at line 656 of file revocation_api.c.

 {
   return (GNUNET_ntohll (*(uint64_t*) a) - GNUNET_ntohll (*(uint64_t*) b));
 }

References GNUNET_ntohll().

Here is the call graph for this function:

Variable Documentation

◆ salt

struct GNUNET_CRYPTO_PowSalt salt = { "GnsRevocationPow" }

static

Definition at line 1 of file revocation_api.c.

Data Structures

Functions

Variables

Detailed Description

Function Documentation

◆ query_mq_error_handler()

◆ handle_revocation_query_response()

◆ revocation_mq_error_handler()

◆ handle_revocation_response()

◆ calculate_score()

◆ REV_create_signature_message()

◆ check_signature_identity()

◆ check_signature()

◆ sign_pow_identity()

◆ sign_pow()

◆ cmp_pow_value()

Variable Documentation

◆ salt