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. More...
static void	init ()
	Load plugins. More...
void	__attribute__ ((destructor))
	Dual function to init(). More...
uint32_t	GNUNET_RECLAIM_credential_typename_to_number (const char *typename)
	Convert an credential type name to the corresponding number. More...
const char *	GNUNET_RECLAIM_credential_number_to_typename (uint32_t type)
	Convert an credential type number to the corresponding credential type string. More...
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. More...
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. More...
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. More...
size_t	GNUNET_RECLAIM_credential_list_serialize_get_size (const struct GNUNET_RECLAIM_CredentialList *credentials)
	Get required size for serialization buffer. More...
size_t	GNUNET_RECLAIM_credential_list_serialize (const struct GNUNET_RECLAIM_CredentialList *credentials, char *result)
	Serialize a credential list. More...
struct GNUNET_RECLAIM_CredentialList *	GNUNET_RECLAIM_credential_list_deserialize (const char *data, size_t data_size)
	Deserialize an attribute list. More...
struct GNUNET_RECLAIM_CredentialList *	GNUNET_RECLAIM_credential_list_dup (const struct GNUNET_RECLAIM_CredentialList *al)
	Make a (deep) copy of the credential list. More...
void	GNUNET_RECLAIM_credential_list_destroy (struct GNUNET_RECLAIM_CredentialList *credentials)
	Destroy credential list. More...
size_t	GNUNET_RECLAIM_credential_serialize_get_size (const struct GNUNET_RECLAIM_Credential *credential)
	Get required size for serialization buffer. More...
size_t	GNUNET_RECLAIM_credential_serialize (const struct GNUNET_RECLAIM_Credential *credential, char *result)
	Serialize an credential. More...
struct GNUNET_RECLAIM_Credential *	GNUNET_RECLAIM_credential_deserialize (const char *data, size_t data_size)
	Deserialize an credential. More...
struct GNUNET_RECLAIM_AttributeList *	GNUNET_RECLAIM_credential_get_attributes (const struct GNUNET_RECLAIM_Credential *credential)
	Convert an credential type name to the corresponding number. More...
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. More...
const char *	GNUNET_RECLAIM_presentation_number_to_typename (uint32_t type)
	Convert a presentation type number to the corresponding credential type string. More...
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. More...
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. More...
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. More...
size_t	GNUNET_RECLAIM_presentation_list_serialize (const struct GNUNET_RECLAIM_PresentationList *presentations, char *result)
	Serialize a presentation list. More...
struct GNUNET_RECLAIM_PresentationList *	GNUNET_RECLAIM_presentation_list_deserialize (const char *data, size_t data_size)
	Deserialize an presentation list. More...
struct GNUNET_RECLAIM_PresentationList *	GNUNET_RECLAIM_presentation_list_dup (const struct GNUNET_RECLAIM_PresentationList *al)
	Make a (deep) copy of the presentation list. More...
void	GNUNET_RECLAIM_presentation_list_destroy (struct GNUNET_RECLAIM_PresentationList *presentations)
	Destroy presentations list. More...
size_t	GNUNET_RECLAIM_presentation_serialize_get_size (const struct GNUNET_RECLAIM_Presentation *presentation)
	Get required size for serialization buffer. More...
size_t	GNUNET_RECLAIM_presentation_serialize (const struct GNUNET_RECLAIM_Presentation *presentation, char *result)
	Serialize a presentation. More...
struct GNUNET_RECLAIM_Presentation *	GNUNET_RECLAIM_presentation_deserialize (const char *data, size_t data_size)
	Deserialize an presentation. More...
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. More...

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

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, TestcasePlugin::api, credential_plugins, GNUNET_array_append, GNUNET_ERROR_TYPE_DEBUG, GNUNET_log, GNUNET_new, GNUNET_strdup, Plugin::library_name, TestcasePlugin::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_in_context (GNUNET_OS_project_data_default (),
                                     "libgnunet_plugin_reclaim_credential_",
                                     NULL,
                                     &add_plugin,
                                     NULL);
}

References add_plugin(), GNUNET_OS_project_data_default(), GNUNET_PLUGIN_load_all_in_context(), 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:

__attribute__()

void __attribute__

(

(destructor)

)

Dual function to init().

Definition at line 109 of file reclaim_credential.c.

{
  struct Plugin *plugin;
  const struct GNUNET_OS_ProjectData *pd = GNUNET_OS_project_data_get ();
  const struct GNUNET_OS_ProjectData *dpd = GNUNET_OS_project_data_default ();
 
  if (pd != dpd)
    GNUNET_OS_init (dpd);
 
  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);
 
  if (pd != dpd)
    GNUNET_OS_init (pd);
 
  credential_plugins = NULL;
}

References TestcasePlugin::api, credential_plugins, GNUNET_break, GNUNET_free, GNUNET_OS_init(), GNUNET_OS_project_data_default(), GNUNET_OS_project_data_get(), GNUNET_PLUGIN_unload(), TestcasePlugin::library_name, num_plugins, and plugin.

Here is the call graph for this function:

GNUNET_RECLAIM_credential_list_dup()

struct GNUNET_RECLAIM_CredentialList * GNUNET_RECLAIM_credential_list_dup

(

const struct GNUNET_RECLAIM_CredentialList *

al

)

Make a (deep) copy of the credential list.

Parameters

attrs

claim list to copy

Returns

copied claim list

Definition at line 368 of file reclaim_credential.c.

{
  struct GNUNET_RECLAIM_CredentialListEntry *ale;
  struct GNUNET_RECLAIM_CredentialListEntry *result_ale;
  struct GNUNET_RECLAIM_CredentialList *result;
 
  result = GNUNET_new (struct GNUNET_RECLAIM_CredentialList);
  for (ale = al->list_head; NULL != ale; ale = ale->next)
  {
    result_ale = GNUNET_new (struct GNUNET_RECLAIM_CredentialListEntry);
    GNUNET_assert (NULL != ale->credential);
    result_ale->credential =
      GNUNET_RECLAIM_credential_new (ale->credential->name,
                                     ale->credential->type,
                                     ale->credential->data,
                                     ale->credential->data_size);
    result_ale->credential->id = ale->credential->id;
    GNUNET_CONTAINER_DLL_insert (result->list_head,
                                 result->list_tail,
                                 result_ale);
  }
  return result;
}

References GNUNET_RECLAIM_CredentialListEntry::credential, GNUNET_RECLAIM_Credential::data, GNUNET_RECLAIM_Credential::data_size, GNUNET_assert, GNUNET_CONTAINER_DLL_insert, GNUNET_new, GNUNET_RECLAIM_credential_new(), GNUNET_RECLAIM_Credential::id, GNUNET_RECLAIM_CredentialList::list_head, GNUNET_RECLAIM_Credential::name, GNUNET_RECLAIM_CredentialListEntry::next, result, and GNUNET_RECLAIM_Credential::type.

Here is the call graph for this function:

GNUNET_RECLAIM_presentation_typename_to_number()

uint32_t GNUNET_RECLAIM_presentation_typename_to_number

(

const char *

typename

)

Convert an presentation type name to the corresponding number.

Parameters

typename

name to convert

Returns

corresponding number, UINT32_MAX on error

Definition at line 576 of file reclaim_credential.c.

{
  unsigned int i;
  struct Plugin *plugin;
  uint32_t ret;
  init ();
  for (i = 0; i < num_plugins; i++)
  {
    plugin = credential_plugins[i];
    if (UINT32_MAX !=
        (ret = plugin->api->typename_to_number_p (plugin->api->cls,
                                                  typename)))
      return ret;
  }
  return UINT32_MAX;
}

References TestcasePlugin::api, credential_plugins, init(), num_plugins, plugin, and ret.

Here is the call graph for this function:

GNUNET_RECLAIM_presentation_list_dup()

struct GNUNET_RECLAIM_PresentationList * GNUNET_RECLAIM_presentation_list_dup

(

const struct GNUNET_RECLAIM_PresentationList *

al

)

Make a (deep) copy of the presentation list.

Parameters

attrs

claim list to copy

Returns

copied claim list

Definition at line 791 of file reclaim_credential.c.

{
  struct GNUNET_RECLAIM_PresentationListEntry *ale;
  struct GNUNET_RECLAIM_PresentationListEntry *result_ale;
  struct GNUNET_RECLAIM_PresentationList *result;
 
  result = GNUNET_new (struct GNUNET_RECLAIM_PresentationList);
  for (ale = al->list_head; NULL != ale; ale = ale->next)
  {
    result_ale = GNUNET_new (struct GNUNET_RECLAIM_PresentationListEntry);
    GNUNET_assert (NULL != ale->presentation);
    result_ale->presentation =
      GNUNET_RECLAIM_presentation_new (ale->presentation->type,
                                       ale->presentation->data,
                                       ale->presentation->data_size);
    result_ale->presentation->credential_id = ale->presentation->credential_id;
    GNUNET_CONTAINER_DLL_insert (result->list_head,
                                 result->list_tail,
                                 result_ale);
  }
  return result;
}

References GNUNET_RECLAIM_Presentation::credential_id, GNUNET_RECLAIM_Presentation::data, GNUNET_RECLAIM_Presentation::data_size, GNUNET_assert, GNUNET_CONTAINER_DLL_insert, GNUNET_new, GNUNET_RECLAIM_presentation_new(), GNUNET_RECLAIM_PresentationList::list_head, GNUNET_RECLAIM_PresentationListEntry::next, GNUNET_RECLAIM_PresentationListEntry::presentation, result, and GNUNET_RECLAIM_Presentation::type.

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().