reclaim_credential.c File Reference

helper library to manage identity attribute credentials More...

#include "gnunet_util_lib.h"
#include "gnunet_reclaim_plugin.h"
#include "reclaim_credential.h"

Include dependency graph for reclaim_credential.c:

Go to the source code of this file.

Data Structures
struct	Plugin
	Handle for a plugin. More...

Functions
static void	add_plugin (void *cls, const char *library_name, void *lib_ret)
	Add a plugin.
static void	init ()
	Load plugins.
void	RECLAIM_CREDENTIAL_fini (void)
void	__attribute__ ((destructor))
	Dual function to init().
uint32_t	GNUNET_RECLAIM_credential_typename_to_number (const char *typename)
	Convert an credential type name to the corresponding number.
const char *	GNUNET_RECLAIM_credential_number_to_typename (uint32_t type)
	Convert an credential type number to the corresponding credential type string.
int	GNUNET_RECLAIM_credential_string_to_value (uint32_t type, const char *s, void **data, size_t *data_size)
	Convert human-readable version of a 'claim' of an credential to the binary representation.
char *	GNUNET_RECLAIM_credential_value_to_string (uint32_t type, const void *data, size_t data_size)
	Convert the 'claim' of an credential to a string.
struct GNUNET_RECLAIM_Credential *	GNUNET_RECLAIM_credential_new (const char *attr_name, uint32_t type, const void *data, size_t data_size)
	Create a new credential.
size_t	GNUNET_RECLAIM_credential_list_serialize_get_size (const struct GNUNET_RECLAIM_CredentialList *credentials)
	Get required size for serialization buffer.
size_t	GNUNET_RECLAIM_credential_list_serialize (const struct GNUNET_RECLAIM_CredentialList *credentials, char *result)
	Serialize a credential list.
struct GNUNET_RECLAIM_CredentialList *	GNUNET_RECLAIM_credential_list_deserialize (const char *data, size_t data_size)
	Deserialize an attribute list.
struct GNUNET_RECLAIM_CredentialList *	GNUNET_RECLAIM_credential_list_dup (const struct GNUNET_RECLAIM_CredentialList *al)
void	GNUNET_RECLAIM_credential_list_destroy (struct GNUNET_RECLAIM_CredentialList *credentials)
	Destroy credential list.
size_t	GNUNET_RECLAIM_credential_serialize_get_size (const struct GNUNET_RECLAIM_Credential *credential)
	Get required size for serialization buffer.
size_t	GNUNET_RECLAIM_credential_serialize (const struct GNUNET_RECLAIM_Credential *credential, char *result)
	Serialize an credential.
struct GNUNET_RECLAIM_Credential *	GNUNET_RECLAIM_credential_deserialize (const char *data, size_t data_size)
	Deserialize an credential.
struct GNUNET_RECLAIM_AttributeList *	GNUNET_RECLAIM_credential_get_attributes (const struct GNUNET_RECLAIM_Credential *credential)
	Convert an credential type name to the corresponding number.
char *	GNUNET_RECLAIM_credential_get_issuer (const struct GNUNET_RECLAIM_Credential *credential)
int	GNUNET_RECLAIM_credential_get_expiration (const struct GNUNET_RECLAIM_Credential *credential, struct GNUNET_TIME_Absolute *exp)
uint32_t	GNUNET_RECLAIM_presentation_typename_to_number (const char *typename)
	Convert an presentation type name to the corresponding number.
const char *	GNUNET_RECLAIM_presentation_number_to_typename (uint32_t type)
	Convert a presentation type number to the corresponding credential type string.
int	GNUNET_RECLAIM_presentation_string_to_value (uint32_t type, const char *s, void **data, size_t *data_size)
	Convert human-readable version of a 'claim' of an presentation to the binary representation.
char *	GNUNET_RECLAIM_presentation_value_to_string (uint32_t type, const void *data, size_t data_size)
	Convert the 'claim' of an presentation to a string.
struct GNUNET_RECLAIM_Presentation *	GNUNET_RECLAIM_presentation_new (uint32_t type, const void *data, size_t data_size)
size_t	GNUNET_RECLAIM_presentation_list_serialize_get_size (const struct GNUNET_RECLAIM_PresentationList *presentations)
	Get required size for serialization buffer.
size_t	GNUNET_RECLAIM_presentation_list_serialize (const struct GNUNET_RECLAIM_PresentationList *presentations, char *result)
	Serialize a presentation list.
struct GNUNET_RECLAIM_PresentationList *	GNUNET_RECLAIM_presentation_list_deserialize (const char *data, size_t data_size)
	Deserialize an presentation list.
struct GNUNET_RECLAIM_PresentationList *	GNUNET_RECLAIM_presentation_list_dup (const struct GNUNET_RECLAIM_PresentationList *al)
	Make a (deep) copy of the presentation list.
void	GNUNET_RECLAIM_presentation_list_destroy (struct GNUNET_RECLAIM_PresentationList *presentations)
	Destroy presentations list.
size_t	GNUNET_RECLAIM_presentation_serialize_get_size (const struct GNUNET_RECLAIM_Presentation *presentation)
	Get required size for serialization buffer.
size_t	GNUNET_RECLAIM_presentation_serialize (const struct GNUNET_RECLAIM_Presentation *presentation, char *result)
	Serialize a presentation.
struct GNUNET_RECLAIM_Presentation *	GNUNET_RECLAIM_presentation_deserialize (const char *data, size_t data_size)
	Deserialize an presentation.
struct GNUNET_RECLAIM_AttributeList *	GNUNET_RECLAIM_presentation_get_attributes (const struct GNUNET_RECLAIM_Presentation *presentation)
char *	GNUNET_RECLAIM_presentation_get_issuer (const struct GNUNET_RECLAIM_Presentation *presentation)
int	GNUNET_RECLAIM_presentation_get_expiration (const struct GNUNET_RECLAIM_Presentation *presentation, struct GNUNET_TIME_Absolute *exp)
int	GNUNET_RECLAIM_credential_get_presentation (const struct GNUNET_RECLAIM_Credential *cred, const struct GNUNET_RECLAIM_AttributeList *attrs, struct GNUNET_RECLAIM_Presentation **presentation)
	Create a presentation from a credential and a lift of (selected) attributes in the credential.

Variables
static struct Plugin **	credential_plugins
	Plugins.
static unsigned int	num_plugins
	Number of plugins.
static int	initialized
	Init canary.

Detailed Description

helper library to manage identity attribute credentials

Author

Martin Schanzenbach

Definition in file reclaim_credential.c.

Function Documentation

add_plugin()

static void add_plugin ( void *  cls, const char *  library_name, void *  lib_ret  )

static

Add a plugin.

Parameters

cls	closure
library_name	name of the API library
lib_ret	the plugin API pointer

Definition at line 74 of file reclaim_credential.c.

{
  struct GNUNET_RECLAIM_CredentialPluginFunctions *api = lib_ret;
  struct Plugin *plugin;
 
  GNUNET_log (GNUNET_ERROR_TYPE_DEBUG,
              "Loading credential plugin `%s'\n",
              library_name);
  plugin = GNUNET_new (struct Plugin);
  plugin->api = api;
  plugin->library_name = GNUNET_strdup (library_name);
  GNUNET_array_append (credential_plugins, num_plugins, plugin);
}

References Plugin::api, credential_plugins, GNUNET_array_append, GNUNET_ERROR_TYPE_DEBUG, GNUNET_log, GNUNET_new, GNUNET_strdup, Plugin::library_name, num_plugins, and plugin.

Referenced by init().

Here is the caller graph for this function:

init()

static void init ( )

static

Load plugins.

Definition at line 93 of file reclaim_credential.c.

{
  if (GNUNET_YES == initialized)
    return;
  initialized = GNUNET_YES;
  GNUNET_PLUGIN_load_all (GNUNET_OS_project_data_gnunet (),
                          "libgnunet_plugin_reclaim_credential_",
                          NULL,
                          &add_plugin,
                          NULL);
}

References add_plugin(), GNUNET_OS_project_data_gnunet(), GNUNET_PLUGIN_load_all(), GNUNET_YES, and initialized.

Referenced by GNUNET_RECLAIM_credential_get_attributes(), GNUNET_RECLAIM_credential_get_expiration(), GNUNET_RECLAIM_credential_get_issuer(), GNUNET_RECLAIM_credential_get_presentation(), GNUNET_RECLAIM_credential_number_to_typename(), GNUNET_RECLAIM_credential_string_to_value(), GNUNET_RECLAIM_credential_typename_to_number(), GNUNET_RECLAIM_credential_value_to_string(), GNUNET_RECLAIM_presentation_get_attributes(), GNUNET_RECLAIM_presentation_get_expiration(), GNUNET_RECLAIM_presentation_get_issuer(), GNUNET_RECLAIM_presentation_number_to_typename(), GNUNET_RECLAIM_presentation_string_to_value(), GNUNET_RECLAIM_presentation_typename_to_number(), and GNUNET_RECLAIM_presentation_value_to_string().

Here is the call graph for this function:

Here is the caller graph for this function:

RECLAIM_CREDENTIAL_fini()

void RECLAIM_CREDENTIAL_fini

(

void

)

__attribute__()

void __attribute__

(

(destructor)

)

Dual function to init().

Definition at line 112 of file reclaim_credential.c.

{
  struct Plugin *plugin;
 
  for (unsigned int i = 0; i < num_plugins; i++)
  {
    plugin = credential_plugins[i];
    GNUNET_break (NULL ==
                  GNUNET_PLUGIN_unload (plugin->library_name,
                                        plugin->api));
    GNUNET_free (plugin->library_name);
    GNUNET_free (plugin);
  }
  GNUNET_free (credential_plugins);
  credential_plugins = NULL;
}

References credential_plugins, GNUNET_break, GNUNET_free, GNUNET_PLUGIN_unload(), num_plugins, and plugin.

Here is the call graph for this function:

Variable Documentation

credential_plugins

struct Plugin** credential_plugins

static

Plugins.

Definition at line 51 of file reclaim_credential.c.

Referenced by __attribute__(), add_plugin(), GNUNET_RECLAIM_credential_get_attributes(), GNUNET_RECLAIM_credential_get_expiration(), GNUNET_RECLAIM_credential_get_issuer(), GNUNET_RECLAIM_credential_get_presentation(), GNUNET_RECLAIM_credential_number_to_typename(), GNUNET_RECLAIM_credential_string_to_value(), GNUNET_RECLAIM_credential_typename_to_number(), GNUNET_RECLAIM_credential_value_to_string(), GNUNET_RECLAIM_presentation_get_attributes(), GNUNET_RECLAIM_presentation_get_expiration(), GNUNET_RECLAIM_presentation_get_issuer(), GNUNET_RECLAIM_presentation_number_to_typename(), GNUNET_RECLAIM_presentation_string_to_value(), GNUNET_RECLAIM_presentation_typename_to_number(), and GNUNET_RECLAIM_presentation_value_to_string().

num_plugins

unsigned int num_plugins

static

Number of plugins.

Definition at line 57 of file reclaim_credential.c.

Referenced by __attribute__(), add_plugin(), GNUNET_RECLAIM_credential_get_attributes(), GNUNET_RECLAIM_credential_get_expiration(), GNUNET_RECLAIM_credential_get_issuer(), GNUNET_RECLAIM_credential_get_presentation(), GNUNET_RECLAIM_credential_number_to_typename(), GNUNET_RECLAIM_credential_string_to_value(), GNUNET_RECLAIM_credential_typename_to_number(), GNUNET_RECLAIM_credential_value_to_string(), GNUNET_RECLAIM_presentation_get_attributes(), GNUNET_RECLAIM_presentation_get_expiration(), GNUNET_RECLAIM_presentation_get_issuer(), GNUNET_RECLAIM_presentation_number_to_typename(), GNUNET_RECLAIM_presentation_string_to_value(), GNUNET_RECLAIM_presentation_typename_to_number(), and GNUNET_RECLAIM_presentation_value_to_string().

initialized

int initialized

static

Init canary.

Definition at line 63 of file reclaim_credential.c.

Referenced by init().