Identity service

Identity management. More...

Collaboration diagram for Identity service:

Macros
#define	GNUNET_IDENTITY_VERSION   0x00000100
	Version number of GNUnet Identity API. More...

Typedefs
typedef void(*	GNUNET_IDENTITY_Callback) (void *cls, struct GNUNET_IDENTITY_Ego *ego, void **ctx, const char *name)
	Method called to inform about the egos of this peer. More...
typedef void(*	GNUNET_IDENTITY_Continuation) (void *cls, enum GNUNET_ErrorCode ec)
	Function called once the requested operation has been completed. More...
typedef void(*	GNUNET_IDENTITY_CreateContinuation) (void *cls, const struct GNUNET_CRYPTO_PrivateKey *pk, enum GNUNET_ErrorCode ec)
	Function called once the requested operation has been completed. More...
typedef void(*	GNUNET_IDENTITY_EgoCallback) (void *cls, struct GNUNET_IDENTITY_Ego *ego)
	Function called with the result. More...
typedef void(*	GNUNET_IDENTITY_EgoSuffixCallback) (void *cls, const struct GNUNET_CRYPTO_PrivateKey *priv, const char *ego_name)
	Function called with the result. More...

Functions
const struct GNUNET_CRYPTO_PrivateKey *	GNUNET_IDENTITY_ego_get_private_key (const struct GNUNET_IDENTITY_Ego *ego)
	Obtain the ECC key associated with a ego. More...
struct GNUNET_IDENTITY_Ego *	GNUNET_IDENTITY_ego_get_anonymous (void)
	Obtain the ego representing 'anonymous' users. More...
void	GNUNET_IDENTITY_ego_get_public_key (struct GNUNET_IDENTITY_Ego *ego, struct GNUNET_CRYPTO_PublicKey *pk)
	Get the identifier (public key) of an ego. More...
const char *	GNUNET_IDENTITY_ego_get_name (const struct GNUNET_IDENTITY_Ego *ego)
	Obtain the name associated with an ego. More...
struct GNUNET_IDENTITY_Handle *	GNUNET_IDENTITY_connect (const struct GNUNET_CONFIGURATION_Handle *cfg, GNUNET_IDENTITY_Callback cb, void *cb_cls)
	Connect to the identity service. More...
struct GNUNET_IDENTITY_Operation *	GNUNET_IDENTITY_get (struct GNUNET_IDENTITY_Handle *id, const char *service_name, GNUNET_IDENTITY_Callback cb, void *cb_cls)
	Obtain the ego that is currently preferred/default for a service. More...
struct GNUNET_IDENTITY_Operation *	GNUNET_IDENTITY_set (struct GNUNET_IDENTITY_Handle *id, const char *service_name, struct GNUNET_IDENTITY_Ego *ego, GNUNET_IDENTITY_Continuation cont, void *cont_cls)
	Set the preferred/default ego for a service. More...
void	GNUNET_IDENTITY_disconnect (struct GNUNET_IDENTITY_Handle *h)
	Disconnect from identity service. More...
struct GNUNET_IDENTITY_Operation *	GNUNET_IDENTITY_create (struct GNUNET_IDENTITY_Handle *id, const char *name, const struct GNUNET_CRYPTO_PrivateKey *privkey, enum GNUNET_CRYPTO_KeyType ktype, GNUNET_IDENTITY_CreateContinuation cont, void *cont_cls)
	Create a new ego with the given name. More...
struct GNUNET_IDENTITY_Operation *	GNUNET_IDENTITY_rename (struct GNUNET_IDENTITY_Handle *id, const char *old_name, const char *new_name, GNUNET_IDENTITY_Continuation cb, void *cb_cls)
	Renames an existing ego. More...
struct GNUNET_IDENTITY_Operation *	GNUNET_IDENTITY_delete (struct GNUNET_IDENTITY_Handle *id, const char *name, GNUNET_IDENTITY_Continuation cb, void *cb_cls)
	Delete an existing ego. More...
void	GNUNET_IDENTITY_cancel (struct GNUNET_IDENTITY_Operation *op)
	Cancel an identity operation. More...
struct GNUNET_IDENTITY_EgoLookup *	GNUNET_IDENTITY_ego_lookup (const struct GNUNET_CONFIGURATION_Handle *cfg, const char *name, GNUNET_IDENTITY_EgoCallback cb, void *cb_cls)
	Lookup an ego by name. More...
void	GNUNET_IDENTITY_ego_lookup_cancel (struct GNUNET_IDENTITY_EgoLookup *el)
	Abort ego lookup attempt. More...
struct GNUNET_IDENTITY_EgoSuffixLookup *	GNUNET_IDENTITY_ego_lookup_by_suffix (const struct GNUNET_CONFIGURATION_Handle *cfg, const char *suffix, GNUNET_IDENTITY_EgoSuffixCallback cb, void *cb_cls)
	Obtain the ego with the maximum suffix match between the ego's name and the given domain name suffix. More...
void	GNUNET_IDENTITY_ego_lookup_by_suffix_cancel (struct GNUNET_IDENTITY_EgoSuffixLookup *el)
	Abort ego suffix lookup attempt. More...

Detailed Description

Identity management.

Egos in GNUnet are ECDSA keys. You assume an ego by using (signing with) a particular private key. As GNUnet users are expected to have many egos, we need an identity service to allow users to manage their egos. The identity service manages the egos (private keys) of the local user; it does NOT manage egos of other users (public keys). For giving names to other users and manage their public keys securely, we use GNS.

See also

Documentation

Macro Definition Documentation

GNUNET_IDENTITY_VERSION

#define GNUNET_IDENTITY_VERSION   0x00000100

Version number of GNUnet Identity API.

Definition at line 63 of file gnunet_identity_service.h.

Typedef Documentation

GNUNET_IDENTITY_Callback

typedef void(* GNUNET_IDENTITY_Callback) (void *cls, struct GNUNET_IDENTITY_Ego *ego, void **ctx, const char *name)

Method called to inform about the egos of this peer.

When used with GNUNET_IDENTITY_connect, this function is initially called for all egos and then again whenever a ego's name changes or if it is deleted. At the end of the initial pass over all egos, the function is once called with 'NULL' for ego. That does NOT mean that the callback won't be invoked in the future or that there was an error.

When used with GNUNET_IDENTITY_create or GNUNET_IDENTITY_get, this function is only called ONCE, and 'NULL' being passed in ego does indicate an error (for example because name is taken or no default value is known). If ego is non-NULL and if '*ctx' is set in those callbacks, the value WILL be passed to a subsequent call to the identity callback of GNUNET_IDENTITY_connect (if that one was not NULL).

When an identity is renamed, this function is called with the (known) ego but the NEW name.

When an identity is deleted, this function is called with the (known) ego and "NULL" for the name. In this case, the ego is henceforth invalid (and the ctx should also be cleaned up).

Parameters

cls	closure
ego	ego handle
ctx	context for application to store data for this ego (during the lifetime of this process, initially NULL)
name	name assigned by the user for this ego, NULL if the user just deleted the ego and it must thus no longer be used

Definition at line 155 of file gnunet_identity_service.h.

GNUNET_IDENTITY_Continuation

typedef void(* GNUNET_IDENTITY_Continuation) (void *cls, enum GNUNET_ErrorCode ec)

Function called once the requested operation has been completed.

Parameters

cls	closure
ec	the GNUNET_ErrorCode

Definition at line 199 of file gnunet_identity_service.h.

GNUNET_IDENTITY_CreateContinuation

typedef void(* GNUNET_IDENTITY_CreateContinuation) (void *cls, const struct GNUNET_CRYPTO_PrivateKey *pk, enum GNUNET_ErrorCode ec)

Function called once the requested operation has been completed.

Parameters

cls	closure
pk	private key, NULL on error
ec	the GNUNET_ErrorCode

Definition at line 239 of file gnunet_identity_service.h.

GNUNET_IDENTITY_EgoCallback

typedef void(* GNUNET_IDENTITY_EgoCallback) (void *cls, struct GNUNET_IDENTITY_Ego *ego)

Function called with the result.

Parameters

cls	closure
ego	NULL on error / ego not found

Definition at line 320 of file gnunet_identity_service.h.

GNUNET_IDENTITY_EgoSuffixCallback

typedef void(* GNUNET_IDENTITY_EgoSuffixCallback) (void *cls, const struct GNUNET_CRYPTO_PrivateKey *priv, const char *ego_name)

Function called with the result.

Parameters

cls	closure
ego	NULL on error / ego not found
ego_name	NULL on error, name of the ego otherwise

Definition at line 361 of file gnunet_identity_service.h.

Function Documentation

GNUNET_IDENTITY_ego_get_private_key()

const struct GNUNET_CRYPTO_PrivateKey * GNUNET_IDENTITY_ego_get_private_key

(

const struct GNUNET_IDENTITY_Ego *

ego

)

Obtain the ECC key associated with a ego.

Parameters

ego

the ego

Returns

associated ECC key, valid as long as the ego is valid

Definition at line 517 of file identity_api.c.

{
  return &ego->pk;
}

References GNUNET_IDENTITY_Ego::pk.

Referenced by add_attribute_cont(), add_credential_cont(), authorize_endpoint(), code_redirect(), collect_orphans(), delete_attribute_cont(), delete_credential_cont(), DID_create(), directory_trim_complete(), display_record(), ego_callback(), ego_cb(), ego_get_all(), ego_get_response(), get_anonymous_private_key(), get_ego(), get_identity_for_string(), GNUNET_CONVERSATION_phone_create(), handle_gns_response(), id_connect_cb(), identity_cb(), list_attribute_cont(), list_credential_cont(), list_tickets_cont(), namestore_add_or_update(), namestore_delete(), namestore_get(), namestore_import(), on_ego_lookup(), origin_lookup_cb(), print_ego(), read_encrypted_message(), remove_did_document_ego_lookup_cb(), revoke_ticket_cont(), sign_cb(), store_cb(), and uri_ksk_continuation().

Here is the caller graph for this function:

GNUNET_IDENTITY_ego_get_anonymous()

struct GNUNET_IDENTITY_Ego * GNUNET_IDENTITY_ego_get_anonymous

(

void

)

Obtain the ego representing 'anonymous' users.

Returns

handle for the anonymous user, MUST NOT be freed

Definition at line 157 of file identity_api.c.

{
  static struct GNUNET_IDENTITY_Ego anon;
  static int setup;
  ssize_t key_len;
 
  if (setup)
    return &anon;
  anon.pk.type = htonl (GNUNET_PUBLIC_KEY_TYPE_ECDSA);
  anon.pub.type = htonl (GNUNET_PUBLIC_KEY_TYPE_ECDSA);
  anon.pk.ecdsa_key = *GNUNET_CRYPTO_ecdsa_key_get_anonymous ();
  key_len = GNUNET_CRYPTO_private_key_get_length (&anon.pk);
  GNUNET_assert (0 < key_len);
  GNUNET_CRYPTO_hash (&anon.pk,
                      key_len,
                      &anon.id);
  setup = 1;
  return &anon;
}

References GNUNET_CRYPTO_PrivateKey::ecdsa_key, GNUNET_assert, GNUNET_CRYPTO_ecdsa_key_get_anonymous(), GNUNET_CRYPTO_hash(), GNUNET_CRYPTO_private_key_get_length(), GNUNET_PUBLIC_KEY_TYPE_ECDSA, GNUNET_IDENTITY_Ego::id, GNUNET_IDENTITY_Ego::pk, GNUNET_IDENTITY_Ego::pub, GNUNET_CRYPTO_PrivateKey::type, and GNUNET_CRYPTO_PublicKey::type.

Referenced by get_anonymous_private_key(), and get_anonymous_public_key().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_IDENTITY_ego_get_public_key()

void GNUNET_IDENTITY_ego_get_public_key	(	struct GNUNET_IDENTITY_Ego *	ego,
		struct GNUNET_CRYPTO_PublicKey *	pk
	)

Get the identifier (public key) of an ego.

Parameters

ego	identity handle with the private key
pk	set to ego's public key

Definition at line 529 of file identity_api.c.

{
  if (GNUNET_NO == ego->pub_initialized)
  {
    GNUNET_CRYPTO_key_get_public (&ego->pk, &ego->pub);
    ego->pub_initialized = GNUNET_YES;
  }
  *pk = ego->pub;
}

References GNUNET_CRYPTO_key_get_public(), GNUNET_NO, GNUNET_YES, pk, GNUNET_IDENTITY_Ego::pk, GNUNET_IDENTITY_Ego::pub, and GNUNET_IDENTITY_Ego::pub_initialized.

Referenced by code_redirect(), DID_create(), DID_ego_to_did(), DID_identity_to_did(), DID_identity_to_did_document(), ego_callback(), find_ego(), get_anonymous_public_key(), get_ego(), get_identity_for_string(), id_connect_cb(), list_ego(), print_ego(), revoke_ticket_cont(), and store_cb().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_IDENTITY_ego_get_name()

const char * GNUNET_IDENTITY_ego_get_name

(

const struct GNUNET_IDENTITY_Ego *

ego

)

Obtain the name associated with an ego.

Parameters

ego

the ego

Returns

associated name, valid as long as the ego is valid

GNUNET_IDENTITY_connect()

struct GNUNET_IDENTITY_Handle * GNUNET_IDENTITY_connect	(	const struct GNUNET_CONFIGURATION_Handle *	cfg,
		GNUNET_IDENTITY_Callback	cb,
		void *	cb_cls
	)

Connect to the identity service.

Parameters

cfg	Configuration to contact the identity service.
cb	function to call on all identity events, can be NULL
cb_cls	closure for cb

Returns

handle to communicate with identity service

Parameters

cfg	the configuration to use
cb	function to call on all identity events, can be NULL
cb_cls	closure for cb

Returns

handle to use

Definition at line 487 of file identity_api.c.

{
  struct GNUNET_IDENTITY_Handle *h;
 
  h = GNUNET_new (struct GNUNET_IDENTITY_Handle);
  h->cfg = cfg;
  h->cb = cb;
  h->cb_cls = cb_cls;
  h->egos = GNUNET_CONTAINER_multihashmap_create (16,
                                                  GNUNET_YES);
  reconnect (h);
  if (NULL == h->mq)
  {
    GNUNET_free (h);
    return NULL;
  }
  return h;
}

References GNUNET_IDENTITY_Handle::cb, GNUNET_IDENTITY_Handle::cb_cls, cfg, GNUNET_ARM_Handle::cfg, GNUNET_CONTAINER_multihashmap_create(), GNUNET_free, GNUNET_new, GNUNET_YES, h, GNUNET_ARM_Handle::mq, and reconnect().

Referenced by REST_identity_init(), REST_namestore_init(), REST_openid_init(), REST_reclaim_init(), and run().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_IDENTITY_get()

struct GNUNET_IDENTITY_Operation * GNUNET_IDENTITY_get	(	struct GNUNET_IDENTITY_Handle *	id,
		const char *	service_name,
		GNUNET_IDENTITY_Callback	cb,
		void *	cb_cls
	)

Obtain the ego that is currently preferred/default for a service.

Parameters

id	identity service to query
service_name	for which service is an identity wanted
cb	function to call with the result (will only be called once)
cb_cls	closure for cb

Returns

handle to abort the operation

GNUNET_IDENTITY_set()

struct GNUNET_IDENTITY_Operation * GNUNET_IDENTITY_set	(	struct GNUNET_IDENTITY_Handle *	id,
		const char *	service_name,
		struct GNUNET_IDENTITY_Ego *	ego,
		GNUNET_IDENTITY_Continuation	cont,
		void *	cont_cls
	)

Set the preferred/default ego for a service.

Parameters

id	identity service to inform
service_name	for which service is an identity set
ego	new default identity to be set for this service
cont	function to call once the operation finished
cont_cls	closure for cont

Returns

handle to abort the operation

GNUNET_IDENTITY_disconnect()

void GNUNET_IDENTITY_disconnect

(

struct GNUNET_IDENTITY_Handle *

h

)

Disconnect from identity service.

Parameters

h	identity service to disconnect
h	handle to destroy

Definition at line 732 of file identity_api.c.

{
  struct GNUNET_IDENTITY_Operation *op;
 
  GNUNET_assert (NULL != h);
  if (h->reconnect_task != NULL)
  {
    GNUNET_SCHEDULER_cancel (h->reconnect_task);
    h->reconnect_task = NULL;
  }
  if (NULL != h->egos)
  {
    GNUNET_CONTAINER_multihashmap_iterate (h->egos,
                                           &free_ego,
                                           h);
    GNUNET_CONTAINER_multihashmap_destroy (h->egos);
    h->egos = NULL;
  }
  while (NULL != (op = h->op_head))
  {
    GNUNET_break (NULL == op->cont);
    GNUNET_CONTAINER_DLL_remove (h->op_head, h->op_tail, op);
    memset (&op->pk,
            0,
            sizeof (op->pk));
    GNUNET_free (op);
  }
  if (NULL != h->mq)
  {
    GNUNET_MQ_destroy (h->mq);
    h->mq = NULL;
  }
  GNUNET_free (h);
}

References free_ego(), GNUNET_assert, GNUNET_break, GNUNET_CONTAINER_DLL_remove, GNUNET_CONTAINER_multihashmap_destroy(), GNUNET_CONTAINER_multihashmap_iterate(), GNUNET_free, GNUNET_MQ_destroy(), GNUNET_SCHEDULER_cancel(), h, GNUNET_ARM_Handle::mq, op, and GNUNET_ARM_Handle::reconnect_task.

Referenced by cleanup(), do_cleanup(), do_shutdown(), do_stop_task(), process_stdin(), REST_identity_done(), REST_namestore_done(), REST_openid_done(), REST_reclaim_done(), and shutdown_task().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_IDENTITY_create()

struct GNUNET_IDENTITY_Operation * GNUNET_IDENTITY_create	(	struct GNUNET_IDENTITY_Handle *	id,
		const char *	name,
		const struct GNUNET_CRYPTO_PrivateKey *	privkey,
		enum GNUNET_CRYPTO_KeyType	ktype,
		GNUNET_IDENTITY_CreateContinuation	cont,
		void *	cont_cls
	)

Create a new ego with the given name.

Parameters

id	identity service to use
name	desired name
privkey	desired private key or NULL to create one
ktype	the type of key to create. Ignored if privkey != NULL.
cont	function to call with the result (will only be called once)
cont_cls	closure for cont

Returns

handle to abort the operation

Definition at line 561 of file identity_api.c.

{
  struct GNUNET_CRYPTO_PrivateKey private_key;
  struct GNUNET_IDENTITY_Operation *op;
  struct GNUNET_MQ_Envelope *env;
  struct CreateRequestMessage *crm;
  size_t slen;
  size_t key_len;
 
  if (NULL == h->mq)
    return NULL;
  slen = strlen (name) + 1;
  if (slen >= GNUNET_MAX_MESSAGE_SIZE - sizeof(struct CreateRequestMessage))
  {
    GNUNET_break (0);
    return NULL;
  }
  op = GNUNET_new (struct GNUNET_IDENTITY_Operation);
  op->h = h;
  op->create_cont = cont;
  op->cls = cont_cls;
  GNUNET_CONTAINER_DLL_insert_tail (h->op_head, h->op_tail, op);
  if (NULL == privkey)
  {
    GNUNET_assert (GNUNET_OK ==
                   private_key_create (ktype, &private_key));
  }
  else
    private_key = *privkey;
  key_len = GNUNET_CRYPTO_private_key_get_length (&private_key);
  env = GNUNET_MQ_msg_extra (crm, slen + key_len,
                             GNUNET_MESSAGE_TYPE_IDENTITY_CREATE);
  crm->name_len = htons (slen);
  GNUNET_CRYPTO_write_private_key_to_buffer (&private_key,
                                               &crm[1],
                                               key_len);
  crm->key_len = htons (key_len);
  op->pk = private_key;
  GNUNET_memcpy ((char*) &crm[1] + key_len, name, slen);
  GNUNET_MQ_send (h->mq, env);
  return op;
}

References env, GNUNET_assert, GNUNET_break, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_CRYPTO_private_key_get_length(), GNUNET_CRYPTO_write_private_key_to_buffer(), GNUNET_MAX_MESSAGE_SIZE, GNUNET_memcpy, GNUNET_MESSAGE_TYPE_IDENTITY_CREATE, GNUNET_MQ_msg_extra, GNUNET_MQ_send(), GNUNET_new, GNUNET_OK, h, GNUNET_ARM_Operation::h, CreateRequestMessage::key_len, GNUNET_ARM_Handle::mq, name, CreateRequestMessage::name_len, op, and private_key_create().

Referenced by create_did_ego_lockup_cb(), ego_create(), origin_lookup_cb(), and run().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_IDENTITY_rename()

struct GNUNET_IDENTITY_Operation * GNUNET_IDENTITY_rename	(	struct GNUNET_IDENTITY_Handle *	h,
		const char *	old_name,
		const char *	new_name,
		GNUNET_IDENTITY_Continuation	cb,
		void *	cb_cls
	)

Renames an existing ego.

Parameters

id	identity service to use
old_name	old name
new_name	desired new name
cb	function to call with the result (will only be called once)
cb_cls	closure for cb

Returns

handle to abort the operation

Renames an existing ego.

Parameters

h	identity service to use
old_name	old name
new_name	desired new name
cb	function to call with the result (will only be called once)
cb_cls	closure for cb

Returns

handle to abort the operation

Definition at line 621 of file identity_api.c.

{
  struct GNUNET_IDENTITY_Operation *op;
  struct GNUNET_MQ_Envelope *env;
  struct RenameMessage *grm;
  size_t slen_old;
  size_t slen_new;
  char *dst;
 
  if (NULL == h->mq)
    return NULL;
  slen_old = strlen (old_name) + 1;
  slen_new = strlen (new_name) + 1;
  if ((slen_old >= GNUNET_MAX_MESSAGE_SIZE) ||
      (slen_new >= GNUNET_MAX_MESSAGE_SIZE) ||
      (slen_old + slen_new >=
       GNUNET_MAX_MESSAGE_SIZE - sizeof(struct RenameMessage)))
  {
    GNUNET_break (0);
    return NULL;
  }
  op = GNUNET_new (struct GNUNET_IDENTITY_Operation);
  op->h = h;
  op->cont = cb;
  op->cls = cb_cls;
  GNUNET_CONTAINER_DLL_insert_tail (h->op_head, h->op_tail, op);
  env = GNUNET_MQ_msg_extra (grm,
                             slen_old + slen_new,
                             GNUNET_MESSAGE_TYPE_IDENTITY_RENAME);
  grm->old_name_len = htons (slen_old);
  grm->new_name_len = htons (slen_new);
  dst = (char *) &grm[1];
  GNUNET_memcpy (dst, old_name, slen_old);
  GNUNET_memcpy (&dst[slen_old], new_name, slen_new);
  GNUNET_MQ_send (h->mq, env);
  return op;
}

References env, GNUNET_break, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_MAX_MESSAGE_SIZE, GNUNET_memcpy, GNUNET_MESSAGE_TYPE_IDENTITY_RENAME, GNUNET_MQ_msg_extra, GNUNET_MQ_send(), GNUNET_new, h, GNUNET_ARM_Operation::h, GNUNET_ARM_Handle::mq, RenameMessage::new_name_len, RenameMessage::old_name_len, and op.

Referenced by ego_edit().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_IDENTITY_delete()

struct GNUNET_IDENTITY_Operation * GNUNET_IDENTITY_delete	(	struct GNUNET_IDENTITY_Handle *	h,
		const char *	name,
		GNUNET_IDENTITY_Continuation	cb,
		void *	cb_cls
	)

Delete an existing ego.

Parameters

id	identity service to use
name	name of the identity to delete
cb	function to call with the result (will only be called once)
cb_cls	closure for cb

Returns

handle to abort the operation

Delete an existing ego.

Parameters

h	identity service to use
name	name of the identity to delete
cb	function to call with the result (will only be called once)
cb_cls	closure for cb

Returns

handle to abort the operation

Definition at line 674 of file identity_api.c.

{
  struct GNUNET_IDENTITY_Operation *op;
  struct GNUNET_MQ_Envelope *env;
  struct DeleteMessage *gdm;
  size_t slen;
 
  if (NULL == h->mq)
    return NULL;
  slen = strlen (name) + 1;
  if (slen >= GNUNET_MAX_MESSAGE_SIZE - sizeof(struct DeleteMessage))
  {
    GNUNET_break (0);
    return NULL;
  }
  op = GNUNET_new (struct GNUNET_IDENTITY_Operation);
  op->h = h;
  op->cont = cb;
  op->cls = cb_cls;
  GNUNET_CONTAINER_DLL_insert_tail (h->op_head, h->op_tail, op);
  env = GNUNET_MQ_msg_extra (gdm, slen, GNUNET_MESSAGE_TYPE_IDENTITY_DELETE);
  gdm->name_len = htons (slen);
  gdm->reserved = htons (0);
  GNUNET_memcpy (&gdm[1], name, slen);
  GNUNET_MQ_send (h->mq, env);
  return op;
}

References env, GNUNET_break, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_MAX_MESSAGE_SIZE, GNUNET_memcpy, GNUNET_MESSAGE_TYPE_IDENTITY_DELETE, GNUNET_MQ_msg_extra, GNUNET_MQ_send(), GNUNET_new, h, GNUNET_ARM_Operation::h, GNUNET_ARM_Handle::mq, name, DeleteMessage::name_len, op, and DeleteMessage::reserved.

Referenced by ego_delete_name(), ego_delete_pubkey(), and run().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_IDENTITY_cancel()

void GNUNET_IDENTITY_cancel

(

struct GNUNET_IDENTITY_Operation *

op

)

Cancel an identity operation.

Note that the operation MAY still be executed; this merely cancels the continuation; if the request was already transmitted, the service may still choose to complete the operation.

Parameters

op	operation to cancel

Definition at line 715 of file identity_api.c.

{
  op->cont = NULL;
  op->cb = NULL;
  op->create_cont = NULL;
  memset (&op->pk,
          0,
          sizeof (op->pk));
}

References op.

Referenced by do_shutdown(), and shutdown_task().

Here is the caller graph for this function:

GNUNET_IDENTITY_ego_lookup()

struct GNUNET_IDENTITY_EgoLookup * GNUNET_IDENTITY_ego_lookup	(	const struct GNUNET_CONFIGURATION_Handle *	cfg,
		const char *	name,
		GNUNET_IDENTITY_EgoCallback	cb,
		void *	cb_cls
	)

Lookup an ego by name.

Parameters

cfg	configuration to use
name	name to look up
cb	callback to invoke with the result
cb_cls	closure for cb

Returns

NULL on error

Definition at line 186 of file identity_api_lookup.c.

{
  struct GNUNET_IDENTITY_EgoLookup *el;
  struct GNUNET_MQ_Envelope *env;
  struct GNUNET_MessageHeader *req;
  size_t nlen;
 
  GNUNET_assert (NULL != cb);
  el = GNUNET_new (struct GNUNET_IDENTITY_EgoLookup);
  el->cb = cb;
  el->cb_cls = cb_cls;
  {
    struct GNUNET_MQ_MessageHandler handlers[] =
    { GNUNET_MQ_hd_var_size (identity_result_code,
                             GNUNET_MESSAGE_TYPE_IDENTITY_RESULT_CODE,
                             struct ResultCodeMessage,
                             el),
      GNUNET_MQ_hd_var_size (identity_update,
                             GNUNET_MESSAGE_TYPE_IDENTITY_UPDATE,
                             struct UpdateMessage,
                             el),
      GNUNET_MQ_handler_end () };
 
    el->mq =
      GNUNET_CLIENT_connect (cfg, "identity", handlers, &mq_error_handler, el);
  }
  if (NULL == el->mq)
  {
    GNUNET_break (0);
    GNUNET_free (el);
    return NULL;
  }
  el->name = GNUNET_strdup (name);
  nlen = strlen (name) + 1;
  env = GNUNET_MQ_msg_extra (req, nlen, GNUNET_MESSAGE_TYPE_IDENTITY_LOOKUP);
  memcpy (&req[1], name, nlen);
  GNUNET_MQ_send (el->mq, env);
  return el;
}

References GNUNET_IDENTITY_EgoLookup::cb, GNUNET_IDENTITY_EgoLookup::cb_cls, cfg, el, env, GNUNET_assert, GNUNET_break, GNUNET_CLIENT_connect(), GNUNET_free, GNUNET_MESSAGE_TYPE_IDENTITY_LOOKUP, GNUNET_MESSAGE_TYPE_IDENTITY_RESULT_CODE, GNUNET_MESSAGE_TYPE_IDENTITY_UPDATE, GNUNET_MQ_handler_end, GNUNET_MQ_hd_var_size, GNUNET_MQ_msg_extra, GNUNET_MQ_send(), GNUNET_new, GNUNET_strdup, handlers, GNUNET_IDENTITY_EgoLookup::mq, mq_error_handler(), name, and GNUNET_IDENTITY_EgoLookup::name.

Referenced by add_continuation(), create_did(), create_did_ego_create_cb(), ego_sign_data(), parse(), remove_did_document(), replace_did_document_remove_cb(), and run().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_IDENTITY_ego_lookup_cancel()

void GNUNET_IDENTITY_ego_lookup_cancel

(

struct GNUNET_IDENTITY_EgoLookup *

el

)

Abort ego lookup attempt.

Parameters

el	handle for lookup to abort

Definition at line 236 of file identity_api_lookup.c.

{
  GNUNET_MQ_destroy (el->mq);
  GNUNET_free (el->name);
  GNUNET_free (el);
}

References el, GNUNET_free, GNUNET_MQ_destroy(), GNUNET_IDENTITY_EgoLookup::mq, and GNUNET_IDENTITY_EgoLookup::name.

Referenced by do_shutdown(), handle_identity_result_code(), handle_identity_update(), and shutdown_hook().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_IDENTITY_ego_lookup_by_suffix()

struct GNUNET_IDENTITY_EgoSuffixLookup * GNUNET_IDENTITY_ego_lookup_by_suffix	(	const struct GNUNET_CONFIGURATION_Handle *	cfg,
		const char *	suffix,
		GNUNET_IDENTITY_EgoSuffixCallback	cb,
		void *	cb_cls
	)

Obtain the ego with the maximum suffix match between the ego's name and the given domain name suffix.

For example, given a suffix "a.b.c" and egos with names "d.a.b.c", "b.c" and "c", we return the ego for "b.c".

Parameters

cfg	configuration to use
suffix	for which domain name suffix is an identity wanted
cb	function to call with the result (will only be called once)
cb_cls	closure for cb

Returns

handle to abort the operation

Obtain the ego with the maximum suffix match between the ego's name and the given domain name suffix.

Parameters

cfg	configuration to use
name	name to look up
cb	callback to invoke with the result
cb_cls	closure for cb

Returns

NULL on error

Definition at line 185 of file identity_api_suffix_lookup.c.

{
  struct GNUNET_IDENTITY_EgoSuffixLookup *el;
  struct GNUNET_MQ_Envelope *env;
  struct GNUNET_MessageHeader *req;
  size_t nlen;
 
  GNUNET_assert (NULL != cb);
  el = GNUNET_new (struct GNUNET_IDENTITY_EgoSuffixLookup);
  el->cb = cb;
  el->cb_cls = cb_cls;
  {
    struct GNUNET_MQ_MessageHandler handlers[] =
    { GNUNET_MQ_hd_var_size (identity_result_code,
                             GNUNET_MESSAGE_TYPE_IDENTITY_RESULT_CODE,
                             struct ResultCodeMessage,
                             el),
      GNUNET_MQ_hd_var_size (identity_update,
                             GNUNET_MESSAGE_TYPE_IDENTITY_UPDATE,
                             struct UpdateMessage,
                             el),
      GNUNET_MQ_handler_end () };
 
    el->mq =
      GNUNET_CLIENT_connect (cfg, "identity", handlers, &mq_error_handler, el);
  }
  if (NULL == el->mq)
  {
    GNUNET_break (0);
    GNUNET_free (el);
    return NULL;
  }
  el->suffix = GNUNET_strdup (suffix);
  nlen = strlen (suffix) + 1;
  env = GNUNET_MQ_msg_extra (req, nlen,
                             GNUNET_MESSAGE_TYPE_IDENTITY_LOOKUP_BY_SUFFIX);
  memcpy (&req[1], suffix, nlen);
  GNUNET_MQ_send (el->mq, env);
  return el;
}

References GNUNET_IDENTITY_EgoLookup::cb, GNUNET_IDENTITY_EgoLookup::cb_cls, cfg, el, env, GNUNET_assert, GNUNET_break, GNUNET_CLIENT_connect(), GNUNET_free, GNUNET_MESSAGE_TYPE_IDENTITY_LOOKUP_BY_SUFFIX, GNUNET_MESSAGE_TYPE_IDENTITY_RESULT_CODE, GNUNET_MESSAGE_TYPE_IDENTITY_UPDATE, GNUNET_MQ_handler_end, GNUNET_MQ_hd_var_size, GNUNET_MQ_msg_extra, GNUNET_MQ_send(), GNUNET_new, GNUNET_strdup, handlers, GNUNET_IDENTITY_EgoLookup::mq, and mq_error_handler().

Referenced by GNUNET_GNS_lookup_with_tld().

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_IDENTITY_ego_lookup_by_suffix_cancel()

void GNUNET_IDENTITY_ego_lookup_by_suffix_cancel

(

struct GNUNET_IDENTITY_EgoSuffixLookup *

el

)

Abort ego suffix lookup attempt.

Parameters

el	handle for lookup to abort

Abort ego suffix lookup attempt.

Parameters

el	handle for lookup to abort

Definition at line 237 of file identity_api_suffix_lookup.c.

{
  GNUNET_MQ_destroy (el->mq);
  GNUNET_free (el->suffix);
  GNUNET_free (el);
}

References el, GNUNET_free, GNUNET_MQ_destroy(), and GNUNET_IDENTITY_EgoLookup::mq.

Referenced by GNUNET_GNS_lookup_with_tld_cancel(), handle_identity_result_code(), handle_identity_update(), and mq_error_handler().

Here is the call graph for this function:

Here is the caller graph for this function: