service

Data Structures
struct	GNUNET_RECLAIM_Ticket
	The authorization ticket. More...

Macros
#define	GNUNET_RECLAIM_VERSION   0x00000001
	Version number of the re:claimID API. More...

Typedefs
typedef void(*	GNUNET_RECLAIM_TicketCallback) (void *cls, const struct GNUNET_RECLAIM_Ticket *ticket)
	Method called when a token has been issued. More...
typedef void(*	GNUNET_RECLAIM_ContinuationWithStatus) (void *cls, int32_t success, const char *emsg)
	Continuation called to notify client about result of the operation. More...
typedef void(*	GNUNET_RECLAIM_AttributeResult) (void *cls, const struct GNUNET_CRYPTO_EcdsaPublicKey *identity, const struct GNUNET_RECLAIM_Attribute *attr)
	Callback used to notify the client of attribute results. More...
typedef void(*	GNUNET_RECLAIM_AttributeTicketResult) (void *cls, const struct GNUNET_CRYPTO_EcdsaPublicKey *identity, const struct GNUNET_RECLAIM_Attribute *attr, const struct GNUNET_RECLAIM_Attestation *attestation)
	Callback used to notify the client of attribute results. More...
typedef void(*	GNUNET_RECLAIM_AttestationResult) (void *cls, const struct GNUNET_CRYPTO_EcdsaPublicKey *identity, const struct GNUNET_RECLAIM_Attestation *attestation)
	Callback used to notify the client of attestation results. More...

Functions
struct GNUNET_RECLAIM_Handle *	GNUNET_RECLAIM_connect (const struct GNUNET_CONFIGURATION_Handle *cfg)
	Connect to the re:claimID service. More...
struct GNUNET_RECLAIM_Operation *	GNUNET_RECLAIM_attribute_store (struct GNUNET_RECLAIM_Handle *h, const struct GNUNET_CRYPTO_EcdsaPrivateKey *pkey, const struct GNUNET_RECLAIM_Attribute *attr, const struct GNUNET_TIME_Relative *exp_interval, GNUNET_RECLAIM_ContinuationWithStatus cont, void *cont_cls)
	Store an attribute. More...
struct GNUNET_RECLAIM_Operation *	GNUNET_RECLAIM_attestation_store (struct GNUNET_RECLAIM_Handle *h, const struct GNUNET_CRYPTO_EcdsaPrivateKey *pkey, const struct GNUNET_RECLAIM_Attestation *attestation, const struct GNUNET_TIME_Relative *exp_interval, GNUNET_RECLAIM_ContinuationWithStatus cont, void *cont_cls)
	Store an attestation. More...
struct GNUNET_RECLAIM_Operation *	GNUNET_RECLAIM_attribute_delete (struct GNUNET_RECLAIM_Handle *h, const struct GNUNET_CRYPTO_EcdsaPrivateKey *pkey, const struct GNUNET_RECLAIM_Attribute *attr, GNUNET_RECLAIM_ContinuationWithStatus cont, void *cont_cls)
	Delete an attribute. More...
struct GNUNET_RECLAIM_Operation *	GNUNET_RECLAIM_attestation_delete (struct GNUNET_RECLAIM_Handle *h, const struct GNUNET_CRYPTO_EcdsaPrivateKey *pkey, const struct GNUNET_RECLAIM_Attestation *attr, GNUNET_RECLAIM_ContinuationWithStatus cont, void *cont_cls)
	Delete an attestation. More...
struct GNUNET_RECLAIM_AttributeIterator *	GNUNET_RECLAIM_get_attributes_start (struct GNUNET_RECLAIM_Handle *h, const struct GNUNET_CRYPTO_EcdsaPrivateKey *identity, GNUNET_SCHEDULER_TaskCallback error_cb, void *error_cb_cls, GNUNET_RECLAIM_AttributeResult proc, void *proc_cls, GNUNET_SCHEDULER_TaskCallback finish_cb, void *finish_cb_cls)
	List all attributes for a local identity. More...
void	GNUNET_RECLAIM_get_attributes_next (struct GNUNET_RECLAIM_AttributeIterator *it)
	Calls the record processor specified in GNUNET_RECLAIM_get_attributes_start for the next record. More...
void	GNUNET_RECLAIM_get_attributes_stop (struct GNUNET_RECLAIM_AttributeIterator *it)
	Stops iteration and releases the handle for further calls. More...
struct GNUNET_RECLAIM_AttestationIterator *	GNUNET_RECLAIM_get_attestations_start (struct GNUNET_RECLAIM_Handle *h, const struct GNUNET_CRYPTO_EcdsaPrivateKey *identity, GNUNET_SCHEDULER_TaskCallback error_cb, void *error_cb_cls, GNUNET_RECLAIM_AttestationResult proc, void *proc_cls, GNUNET_SCHEDULER_TaskCallback finish_cb, void *finish_cb_cls)
	List all attestations for a local identity. More...
void	GNUNET_RECLAIM_get_attestations_next (struct GNUNET_RECLAIM_AttestationIterator *ait)
	Calls the record processor specified in #GNUNET_RECLAIM_get_attestation_start for the next record. More...
void	GNUNET_RECLAIM_get_attestations_stop (struct GNUNET_RECLAIM_AttestationIterator *ait)
	Stops iteration and releases the handle for further calls. More...
struct GNUNET_RECLAIM_Operation *	GNUNET_RECLAIM_ticket_issue (struct GNUNET_RECLAIM_Handle *h, const struct GNUNET_CRYPTO_EcdsaPrivateKey *iss, const struct GNUNET_CRYPTO_EcdsaPublicKey *rp, const struct GNUNET_RECLAIM_AttributeList *attrs, GNUNET_RECLAIM_TicketCallback cb, void *cb_cls)
	Issues a ticket to a relying party. More...
struct GNUNET_RECLAIM_Operation *	GNUNET_RECLAIM_ticket_revoke (struct GNUNET_RECLAIM_Handle *h, const struct GNUNET_CRYPTO_EcdsaPrivateKey *identity, const struct GNUNET_RECLAIM_Ticket *ticket, GNUNET_RECLAIM_ContinuationWithStatus cb, void *cb_cls)
	Revoked an issued ticket. More...
struct GNUNET_RECLAIM_Operation *	GNUNET_RECLAIM_ticket_consume (struct GNUNET_RECLAIM_Handle *h, const struct GNUNET_CRYPTO_EcdsaPrivateKey *identity, const struct GNUNET_RECLAIM_Ticket *ticket, GNUNET_RECLAIM_AttributeTicketResult cb, void *cb_cls)
	Consumes an issued ticket. More...
struct GNUNET_RECLAIM_TicketIterator *	GNUNET_RECLAIM_ticket_iteration_start (struct GNUNET_RECLAIM_Handle *h, const struct GNUNET_CRYPTO_EcdsaPrivateKey *identity, GNUNET_SCHEDULER_TaskCallback error_cb, void *error_cb_cls, GNUNET_RECLAIM_TicketCallback proc, void *proc_cls, GNUNET_SCHEDULER_TaskCallback finish_cb, void *finish_cb_cls)
	Lists all tickets that have been issued to remote identites (relying parties) More...
void	GNUNET_RECLAIM_ticket_iteration_next (struct GNUNET_RECLAIM_TicketIterator *it)
	Calls the ticket processor specified in GNUNET_RECLAIM_ticket_iteration_start for the next record. More...
void	GNUNET_RECLAIM_ticket_iteration_stop (struct GNUNET_RECLAIM_TicketIterator *it)
	Stops iteration and releases the handle for further calls. More...
void	GNUNET_RECLAIM_disconnect (struct GNUNET_RECLAIM_Handle *h)
	Disconnect from identity provider service. More...
void	GNUNET_RECLAIM_cancel (struct GNUNET_RECLAIM_Operation *op)
	Cancel an identity provider operation. More...

Detailed Description

Macro Definition Documentation

GNUNET_RECLAIM_VERSION

#define GNUNET_RECLAIM_VERSION   0x00000001

Version number of the re:claimID API.

Definition at line 47 of file gnunet_reclaim_service.h.

Typedef Documentation

GNUNET_RECLAIM_TicketCallback

typedef void(* GNUNET_RECLAIM_TicketCallback) (void *cls, const struct GNUNET_RECLAIM_Ticket *ticket)

Method called when a token has been issued.

On success returns a ticket that can be given to a relying party in order for it retrive identity attributes

Parameters

cls	closure
ticket	the ticket

Definition at line 94 of file gnunet_reclaim_service.h.

GNUNET_RECLAIM_ContinuationWithStatus

typedef void(* GNUNET_RECLAIM_ContinuationWithStatus) (void *cls, int32_t success, const char *emsg)

Continuation called to notify client about result of the operation.

Parameters

cls	The callback closure
success	GNUNET_SYSERR on failure
emsg	NULL on success, otherwise an error message

Definition at line 106 of file gnunet_reclaim_service.h.

GNUNET_RECLAIM_AttributeResult

typedef void(* GNUNET_RECLAIM_AttributeResult) (void *cls, const struct GNUNET_CRYPTO_EcdsaPublicKey *identity, const struct GNUNET_RECLAIM_Attribute *attr)

Callback used to notify the client of attribute results.

Parameters

cls	The callback closure
identity	The identity authoritative over the attributes
attr	The attribute
attestation	The attestation for the attribute (may be NULL)

Definition at line 118 of file gnunet_reclaim_service.h.

GNUNET_RECLAIM_AttributeTicketResult

typedef void(* GNUNET_RECLAIM_AttributeTicketResult) (void *cls, const struct GNUNET_CRYPTO_EcdsaPublicKey *identity, const struct GNUNET_RECLAIM_Attribute *attr, const struct GNUNET_RECLAIM_Attestation *attestation)

Callback used to notify the client of attribute results.

Parameters

cls	The callback closure
identity	The identity authoritative over the attributes
attr	The attribute
attestation	The attestation for the attribute (may be NULL)

Definition at line 130 of file gnunet_reclaim_service.h.

GNUNET_RECLAIM_AttestationResult

typedef void(* GNUNET_RECLAIM_AttestationResult) (void *cls, const struct GNUNET_CRYPTO_EcdsaPublicKey *identity, const struct GNUNET_RECLAIM_Attestation *attestation)

Callback used to notify the client of attestation results.

Parameters

cls	The callback closure
identity	The identity authoritative over the attributes
attestation	The attestation
attributes	the parsed attributes

Definition at line 144 of file gnunet_reclaim_service.h.

Function Documentation

GNUNET_RECLAIM_connect()

struct GNUNET_RECLAIM_Handle* GNUNET_RECLAIM_connect

(

const struct GNUNET_CONFIGURATION_Handle *

cfg

)

Connect to the re:claimID service.

Parameters

cfg	Configuration to contact the re:claimID service.

Returns

handle to communicate with the service

Connect to the re:claimID service.

Parameters

cfg	the configuration to use

Returns

handle to use

Definition at line 1026 of file reclaim_api.c.

References cfg, GNUNET_RECLAIM_Handle::cfg, GNUNET_free, GNUNET_new, GNUNET_RECLAIM_Operation::h, GNUNET_RECLAIM_Handle::mq, and reconnect().

Referenced by add_attestation_cont(), add_attribute_cont(), code_redirect(), consume_ticket_cont(), delete_attestation_cont(), delete_attribute_cont(), list_attestation_cont(), list_attribute_cont(), list_tickets_cont(), revoke_ticket_cont(), run(), and userinfo_endpoint().

{
  struct GNUNET_RECLAIM_Handle *h;

  h = GNUNET_new (struct GNUNET_RECLAIM_Handle);
  h->cfg = cfg;
  reconnect (h);
  if (NULL == h->mq)
  {
    GNUNET_free (h);
    return NULL;
  }
  return h;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_attribute_store()

struct GNUNET_RECLAIM_Operation* GNUNET_RECLAIM_attribute_store	(	struct GNUNET_RECLAIM_Handle *	h,
		const struct GNUNET_CRYPTO_EcdsaPrivateKey *	pkey,
		const struct GNUNET_RECLAIM_Attribute *	attr,
		const struct GNUNET_TIME_Relative *	exp_interval,
		GNUNET_RECLAIM_ContinuationWithStatus	cont,
		void *	cont_cls
	)

Store an attribute.

If the attribute is already present, it is replaced with the new attribute.

Parameters

h	handle to the reclaim service
pkey	Private key of the identity to add an attribute to
attr	The attribute
exp_interval	The relative expiration interval for the attribute
cont	Continuation to call when done
cont_cls	Closure for cont

Returns

handle Used to to abort the request

If the attribute is already present, it is replaced with the new attribute.

Parameters

h	handle to the re:claimID service
pkey	private key of the identity
attr	the attribute value
exp_interval	the relative expiration interval for the attribute
cont	continuation to call when done
cont_cls	closure for cont

Returns

handle to abort the request

Definition at line 1097 of file reclaim_api.c.

References GNUNET_RECLAIM_Operation::as_cb, AttributeStoreMessage::attr_len, GNUNET_RECLAIM_Operation::cls, GNUNET_RECLAIM_Operation::env, AttributeStoreMessage::exp, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_htonll(), GNUNET_MESSAGE_TYPE_RECLAIM_ATTRIBUTE_STORE, GNUNET_MQ_msg_extra, GNUNET_MQ_send_copy(), GNUNET_new, GNUNET_RECLAIM_attribute_serialize(), GNUNET_RECLAIM_attribute_serialize_get_size(), GNUNET_RECLAIM_Operation::h, AttributeStoreMessage::id, AttributeStoreMessage::identity, GNUNET_RECLAIM_Handle::mq, op, GNUNET_RECLAIM_Handle::op_head, GNUNET_RECLAIM_Handle::op_tail, pkey, GNUNET_RECLAIM_Operation::r_id, GNUNET_RECLAIM_Handle::r_id_gen, and GNUNET_TIME_Relative::rel_value_us.

Referenced by add_attribute_cont(), and iter_finished().

{
  struct GNUNET_RECLAIM_Operation *op;
  struct AttributeStoreMessage *sam;
  size_t attr_len;

  op = GNUNET_new (struct GNUNET_RECLAIM_Operation);
  op->h = h;
  op->as_cb = cont;
  op->cls = cont_cls;
  op->r_id = h->r_id_gen++;
  GNUNET_CONTAINER_DLL_insert_tail (h->op_head, h->op_tail, op);
  attr_len = GNUNET_RECLAIM_attribute_serialize_get_size (attr);
  op->env = GNUNET_MQ_msg_extra (sam,
                                 attr_len,
                                 GNUNET_MESSAGE_TYPE_RECLAIM_ATTRIBUTE_STORE);
  sam->identity = *pkey;
  sam->id = htonl (op->r_id);
  sam->exp = GNUNET_htonll (exp_interval->rel_value_us);

  GNUNET_RECLAIM_attribute_serialize (attr, (char *) &sam[1]);

  sam->attr_len = htons (attr_len);
  if (NULL != h->mq)
    GNUNET_MQ_send_copy (h->mq, op->env);
  return op;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_attestation_store()

struct GNUNET_RECLAIM_Operation* GNUNET_RECLAIM_attestation_store	(	struct GNUNET_RECLAIM_Handle *	h,
		const struct GNUNET_CRYPTO_EcdsaPrivateKey *	pkey,
		const struct GNUNET_RECLAIM_Attestation *	attr,
		const struct GNUNET_TIME_Relative *	exp_interval,
		GNUNET_RECLAIM_ContinuationWithStatus	cont,
		void *	cont_cls
	)

Store an attestation.

If the attestation is already present, it is replaced with the new attestation.

Parameters

h	handle to the re:claimID service
pkey	private key of the identity
attr	the attestation value
exp_interval	the relative expiration interval for the attestation
cont	continuation to call when done
cont_cls	closure for cont

Returns

handle to abort the request

Definition at line 1189 of file reclaim_api.c.

References GNUNET_RECLAIM_Operation::as_cb, AttributeStoreMessage::attr_len, GNUNET_RECLAIM_Operation::cls, GNUNET_RECLAIM_Operation::env, AttributeStoreMessage::exp, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_htonll(), GNUNET_MESSAGE_TYPE_RECLAIM_ATTESTATION_STORE, GNUNET_MQ_msg_extra, GNUNET_MQ_send_copy(), GNUNET_new, GNUNET_RECLAIM_attestation_serialize(), GNUNET_RECLAIM_attestation_serialize_get_size(), GNUNET_RECLAIM_Operation::h, AttributeStoreMessage::id, AttributeStoreMessage::identity, GNUNET_RECLAIM_Handle::mq, op, GNUNET_RECLAIM_Handle::op_head, GNUNET_RECLAIM_Handle::op_tail, pkey, GNUNET_RECLAIM_Operation::r_id, GNUNET_RECLAIM_Handle::r_id_gen, and GNUNET_TIME_Relative::rel_value_us.

Referenced by add_attestation_cont(), and attest_iter_finished().

{
  struct GNUNET_RECLAIM_Operation *op;
  struct AttributeStoreMessage *sam;
  size_t attr_len;

  op = GNUNET_new (struct GNUNET_RECLAIM_Operation);
  op->h = h;
  op->as_cb = cont;
  op->cls = cont_cls;
  op->r_id = h->r_id_gen++;
  GNUNET_CONTAINER_DLL_insert_tail (h->op_head, h->op_tail, op);
  attr_len = GNUNET_RECLAIM_attestation_serialize_get_size (attr);
  op->env = GNUNET_MQ_msg_extra (sam,
                                 attr_len,
                                 GNUNET_MESSAGE_TYPE_RECLAIM_ATTESTATION_STORE);
  sam->identity = *pkey;
  sam->id = htonl (op->r_id);
  sam->exp = GNUNET_htonll (exp_interval->rel_value_us);

  GNUNET_RECLAIM_attestation_serialize (attr, (char *) &sam[1]);

  sam->attr_len = htons (attr_len);
  if (NULL != h->mq)
    GNUNET_MQ_send_copy (h->mq, op->env);
  return op;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_attribute_delete()

struct GNUNET_RECLAIM_Operation* GNUNET_RECLAIM_attribute_delete	(	struct GNUNET_RECLAIM_Handle *	h,
		const struct GNUNET_CRYPTO_EcdsaPrivateKey *	pkey,
		const struct GNUNET_RECLAIM_Attribute *	attr,
		GNUNET_RECLAIM_ContinuationWithStatus	cont,
		void *	cont_cls
	)

Delete an attribute.

Tickets used to share this attribute are updated accordingly.

Parameters

h	handle to the re:claimID service
pkey	Private key of the identity to add an attribute to
attr	The attribute
cont	Continuation to call when done
cont_cls	Closure for cont

Returns

handle Used to to abort the request

Definition at line 1144 of file reclaim_api.c.

References GNUNET_RECLAIM_Operation::as_cb, AttributeDeleteMessage::attr_len, GNUNET_RECLAIM_Operation::cls, GNUNET_RECLAIM_Operation::env, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_MESSAGE_TYPE_RECLAIM_ATTRIBUTE_DELETE, GNUNET_MQ_msg_extra, GNUNET_MQ_send_copy(), GNUNET_new, GNUNET_RECLAIM_attribute_serialize(), GNUNET_RECLAIM_attribute_serialize_get_size(), GNUNET_RECLAIM_Operation::h, AttributeDeleteMessage::id, AttributeDeleteMessage::identity, GNUNET_RECLAIM_Handle::mq, op, GNUNET_RECLAIM_Handle::op_head, GNUNET_RECLAIM_Handle::op_tail, pkey, GNUNET_RECLAIM_Operation::r_id, and GNUNET_RECLAIM_Handle::r_id_gen.

Referenced by delete_attribute_cont(), and iter_finished().

{
  struct GNUNET_RECLAIM_Operation *op;
  struct AttributeDeleteMessage *dam;
  size_t attr_len;

  op = GNUNET_new (struct GNUNET_RECLAIM_Operation);
  op->h = h;
  op->as_cb = cont;
  op->cls = cont_cls;
  op->r_id = h->r_id_gen++;
  GNUNET_CONTAINER_DLL_insert_tail (h->op_head, h->op_tail, op);
  attr_len = GNUNET_RECLAIM_attribute_serialize_get_size (attr);
  op->env = GNUNET_MQ_msg_extra (dam,
                                 attr_len,
                                 GNUNET_MESSAGE_TYPE_RECLAIM_ATTRIBUTE_DELETE);
  dam->identity = *pkey;
  dam->id = htonl (op->r_id);
  GNUNET_RECLAIM_attribute_serialize (attr, (char *) &dam[1]);

  dam->attr_len = htons (attr_len);
  if (NULL != h->mq)
    GNUNET_MQ_send_copy (h->mq, op->env);
  return op;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_attestation_delete()

struct GNUNET_RECLAIM_Operation* GNUNET_RECLAIM_attestation_delete	(	struct GNUNET_RECLAIM_Handle *	h,
		const struct GNUNET_CRYPTO_EcdsaPrivateKey *	pkey,
		const struct GNUNET_RECLAIM_Attestation *	attr,
		GNUNET_RECLAIM_ContinuationWithStatus	cont,
		void *	cont_cls
	)

Delete an attestation.

Tickets used to share this attestation are updated accordingly.

Parameters

h	handle to the re:claimID service
pkey	Private key of the identity to add an attribute to
attr	The attestation
cont	Continuation to call when done
cont_cls	Closure for cont

Returns

handle Used to to abort the request

Definition at line 1236 of file reclaim_api.c.

References GNUNET_RECLAIM_Operation::as_cb, AttributeDeleteMessage::attr_len, GNUNET_RECLAIM_Operation::cls, GNUNET_RECLAIM_Operation::env, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_MESSAGE_TYPE_RECLAIM_ATTESTATION_DELETE, GNUNET_MQ_msg_extra, GNUNET_MQ_send_copy(), GNUNET_new, GNUNET_RECLAIM_attestation_serialize(), GNUNET_RECLAIM_attestation_serialize_get_size(), GNUNET_RECLAIM_Operation::h, AttributeDeleteMessage::id, AttributeDeleteMessage::identity, GNUNET_RECLAIM_Handle::mq, op, GNUNET_RECLAIM_Handle::op_head, GNUNET_RECLAIM_Handle::op_tail, pkey, GNUNET_RECLAIM_Operation::r_id, and GNUNET_RECLAIM_Handle::r_id_gen.

Referenced by delete_attestation_cont().

{
  struct GNUNET_RECLAIM_Operation *op;
  struct AttributeDeleteMessage *dam;
  size_t attr_len;

  op = GNUNET_new (struct GNUNET_RECLAIM_Operation);
  op->h = h;
  op->as_cb = cont;
  op->cls = cont_cls;
  op->r_id = h->r_id_gen++;
  GNUNET_CONTAINER_DLL_insert_tail (h->op_head, h->op_tail, op);
  attr_len = GNUNET_RECLAIM_attestation_serialize_get_size (attr);
  op->env = GNUNET_MQ_msg_extra (dam,
                                 attr_len,
                                 GNUNET_MESSAGE_TYPE_RECLAIM_ATTESTATION_DELETE);
  dam->identity = *pkey;
  dam->id = htonl (op->r_id);
  GNUNET_RECLAIM_attestation_serialize (attr, (char *) &dam[1]);

  dam->attr_len = htons (attr_len);
  if (NULL != h->mq)
    GNUNET_MQ_send_copy (h->mq, op->env);
  return op;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_get_attributes_start()

struct GNUNET_RECLAIM_AttributeIterator* GNUNET_RECLAIM_get_attributes_start	(	struct GNUNET_RECLAIM_Handle *	h,
		const struct GNUNET_CRYPTO_EcdsaPrivateKey *	identity,
		GNUNET_SCHEDULER_TaskCallback	error_cb,
		void *	error_cb_cls,
		GNUNET_RECLAIM_AttributeResult	proc,
		void *	proc_cls,
		GNUNET_SCHEDULER_TaskCallback	finish_cb,
		void *	finish_cb_cls
	)

List all attributes for a local identity.

This MUST lock the struct GNUNET_RECLAIM_Handle for any other calls than GNUNET_RECLAIM_get_attributes_next() and GNUNET_RECLAIM_get_attributes_stop. proc will be called once immediately, and then again after GNUNET_RECLAIM_get_attributes_next() is invoked.

On error (disconnect), error_cb will be invoked. On normal completion, finish_cb proc will be invoked.

Parameters

h	Handle to the re:claimID service
identity	Identity to iterate over
error_cb	Function to call on error (i.e. disconnect), the handle is afterwards invalid
error_cb_cls	Closure for error_cb
proc	Function to call on each attribute
proc_cls	Closure for proc
finish_cb	Function to call on completion the handle is afterwards invalid
finish_cb_cls	Closure for finish_cb

Returns

an iterator Handle to use for iteration

Definition at line 1293 of file reclaim_api.c.

References GNUNET_RECLAIM_Operation::env, GNUNET_RECLAIM_AttributeIterator::env, GNUNET_RECLAIM_AttributeIterator::error_cb, error_cb(), GNUNET_RECLAIM_AttributeIterator::error_cb_cls, GNUNET_RECLAIM_AttributeIterator::finish_cb, GNUNET_RECLAIM_AttributeIterator::finish_cb_cls, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_MESSAGE_TYPE_RECLAIM_ATTRIBUTE_ITERATION_START, GNUNET_MQ_msg, GNUNET_MQ_send(), GNUNET_new, GNUNET_RECLAIM_Operation::h, GNUNET_RECLAIM_AttributeIterator::h, AttributeIterationStartMessage::id, identity, AttributeIterationStartMessage::identity, GNUNET_RECLAIM_AttributeIterator::identity, GNUNET_RECLAIM_Handle::it_head, GNUNET_RECLAIM_Handle::it_tail, GNUNET_RECLAIM_Handle::mq, GNUNET_RECLAIM_Operation::msg, GNUNET_RECLAIM_AttributeIterator::proc, GNUNET_RECLAIM_AttributeIterator::proc_cls, GNUNET_RECLAIM_AttributeIterator::r_id, and GNUNET_RECLAIM_Handle::r_id_gen.

Referenced by attest_iter_finished(), code_redirect(), and list_attribute_cont().

{
  struct GNUNET_RECLAIM_AttributeIterator *it;
  struct GNUNET_MQ_Envelope *env;
  struct AttributeIterationStartMessage *msg;
  uint32_t rid;

  rid = h->r_id_gen++;
  it = GNUNET_new (struct GNUNET_RECLAIM_AttributeIterator);
  it->h = h;
  it->error_cb = error_cb;
  it->error_cb_cls = error_cb_cls;
  it->finish_cb = finish_cb;
  it->finish_cb_cls = finish_cb_cls;
  it->proc = proc;
  it->proc_cls = proc_cls;
  it->r_id = rid;
  it->identity = *identity;
  GNUNET_CONTAINER_DLL_insert_tail (h->it_head, h->it_tail, it);
  env =
    GNUNET_MQ_msg (msg, GNUNET_MESSAGE_TYPE_RECLAIM_ATTRIBUTE_ITERATION_START);
  msg->id = htonl (rid);
  msg->identity = *identity;
  if (NULL == h->mq)
    it->env = env;
  else
    GNUNET_MQ_send (h->mq, env);
  return it;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_get_attributes_next()

void GNUNET_RECLAIM_get_attributes_next

(

struct GNUNET_RECLAIM_AttributeIterator *

it

)

Calls the record processor specified in GNUNET_RECLAIM_get_attributes_start for the next record.

Parameters

it	The iterator
it	the iterator

Definition at line 1339 of file reclaim_api.c.

References GNUNET_RECLAIM_Operation::env, GNUNET_MESSAGE_TYPE_RECLAIM_ATTRIBUTE_ITERATION_NEXT, GNUNET_MQ_msg, GNUNET_MQ_send(), GNUNET_RECLAIM_Operation::h, GNUNET_RECLAIM_AttributeIterator::h, AttributeIterationNextMessage::id, GNUNET_RECLAIM_Handle::mq, GNUNET_RECLAIM_Operation::msg, and GNUNET_RECLAIM_AttributeIterator::r_id.

Referenced by attr_collect(), iter_cb(), and oidc_attr_collect().

{
  struct GNUNET_RECLAIM_Handle *h = it->h;
  struct AttributeIterationNextMessage *msg;
  struct GNUNET_MQ_Envelope *env;

  env =
    GNUNET_MQ_msg (msg, GNUNET_MESSAGE_TYPE_RECLAIM_ATTRIBUTE_ITERATION_NEXT);
  msg->id = htonl (it->r_id);
  GNUNET_MQ_send (h->mq, env);
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_get_attributes_stop()

void GNUNET_RECLAIM_get_attributes_stop

(

struct GNUNET_RECLAIM_AttributeIterator *

it

)

Stops iteration and releases the handle for further calls.

Must be called on any iteration that has not yet completed prior to calling GNUNET_RECLAIM_disconnect.

Parameters

it	the iterator

Definition at line 1360 of file reclaim_api.c.

References GNUNET_RECLAIM_Operation::env, free_it(), GNUNET_MESSAGE_TYPE_RECLAIM_ATTRIBUTE_ITERATION_STOP, GNUNET_MQ_msg, GNUNET_MQ_send(), GNUNET_RECLAIM_Operation::h, GNUNET_RECLAIM_AttributeIterator::h, AttributeIterationStopMessage::id, GNUNET_RECLAIM_Handle::mq, GNUNET_RECLAIM_Operation::msg, and GNUNET_RECLAIM_AttributeIterator::r_id.

Referenced by cleanup_handle(), and do_cleanup().

{
  struct GNUNET_RECLAIM_Handle *h = it->h;
  struct GNUNET_MQ_Envelope *env;
  struct AttributeIterationStopMessage *msg;

  if (NULL != h->mq)
  {
    env =
      GNUNET_MQ_msg (msg, GNUNET_MESSAGE_TYPE_RECLAIM_ATTRIBUTE_ITERATION_STOP);
    msg->id = htonl (it->r_id);
    GNUNET_MQ_send (h->mq, env);
  }
  free_it (it);
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_get_attestations_start()

struct GNUNET_RECLAIM_AttestationIterator* GNUNET_RECLAIM_get_attestations_start	(	struct GNUNET_RECLAIM_Handle *	h,
		const struct GNUNET_CRYPTO_EcdsaPrivateKey *	identity,
		GNUNET_SCHEDULER_TaskCallback	error_cb,
		void *	error_cb_cls,
		GNUNET_RECLAIM_AttestationResult	proc,
		void *	proc_cls,
		GNUNET_SCHEDULER_TaskCallback	finish_cb,
		void *	finish_cb_cls
	)

List all attestations for a local identity.

This MUST lock the struct GNUNET_RECLAIM_Handle for any other calls than GNUNET_RECLAIM_get_attestations_next() and GNUNET_RECLAIM_get_attestations_stop. proc will be called once immediately, and then again after GNUNET_RECLAIM_get_attestations_next() is invoked.

On error (disconnect), error_cb will be invoked. On normal completion, finish_cb proc will be invoked.

Parameters

h	Handle to the re:claimID service
identity	Identity to iterate over
error_cb	Function to call on error (i.e. disconnect), the handle is afterwards invalid
error_cb_cls	Closure for error_cb
proc	Function to call on each attestation
proc_cls	Closure for proc
finish_cb	Function to call on completion the handle is afterwards invalid
finish_cb_cls	Closure for finish_cb

Returns

an iterator Handle to use for iteration

Definition at line 1402 of file reclaim_api.c.

References GNUNET_RECLAIM_Handle::ait_head, GNUNET_RECLAIM_Handle::ait_tail, GNUNET_RECLAIM_Operation::env, GNUNET_RECLAIM_AttestationIterator::env, GNUNET_RECLAIM_AttestationIterator::error_cb, error_cb(), GNUNET_RECLAIM_AttestationIterator::error_cb_cls, GNUNET_RECLAIM_AttestationIterator::finish_cb, GNUNET_RECLAIM_AttestationIterator::finish_cb_cls, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_MESSAGE_TYPE_RECLAIM_ATTESTATION_ITERATION_START, GNUNET_MQ_msg, GNUNET_MQ_send(), GNUNET_new, GNUNET_RECLAIM_Operation::h, GNUNET_RECLAIM_AttestationIterator::h, AttestationIterationStartMessage::id, identity, AttestationIterationStartMessage::identity, GNUNET_RECLAIM_AttestationIterator::identity, GNUNET_RECLAIM_Handle::mq, GNUNET_RECLAIM_Operation::msg, GNUNET_RECLAIM_AttestationIterator::proc, GNUNET_RECLAIM_AttestationIterator::proc_cls, GNUNET_RECLAIM_AttestationIterator::r_id, and GNUNET_RECLAIM_Handle::r_id_gen.

Referenced by list_attestation_cont(), oidc_attr_collect_finished_cb(), and start_process().

{
  struct GNUNET_RECLAIM_AttestationIterator *ait;
  struct GNUNET_MQ_Envelope *env;
  struct AttestationIterationStartMessage *msg;
  uint32_t rid;

  rid = h->r_id_gen++;
  ait = GNUNET_new (struct GNUNET_RECLAIM_AttestationIterator);
  ait->h = h;
  ait->error_cb = error_cb;
  ait->error_cb_cls = error_cb_cls;
  ait->finish_cb = finish_cb;
  ait->finish_cb_cls = finish_cb_cls;
  ait->proc = proc;
  ait->proc_cls = proc_cls;
  ait->r_id = rid;
  ait->identity = *identity;
  GNUNET_CONTAINER_DLL_insert_tail (h->ait_head, h->ait_tail, ait);
  env =
    GNUNET_MQ_msg (msg,
                   GNUNET_MESSAGE_TYPE_RECLAIM_ATTESTATION_ITERATION_START);
  msg->id = htonl (rid);
  msg->identity = *identity;
  if (NULL == h->mq)
    ait->env = env;
  else
    GNUNET_MQ_send (h->mq, env);
  return ait;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_get_attestations_next()

void GNUNET_RECLAIM_get_attestations_next

(

struct GNUNET_RECLAIM_AttestationIterator *

ait

)

Calls the record processor specified in #GNUNET_RECLAIM_get_attestation_start for the next record.

Parameters

it	the iterator

Definition at line 1449 of file reclaim_api.c.

References GNUNET_RECLAIM_Operation::env, GNUNET_MESSAGE_TYPE_RECLAIM_ATTESTATION_ITERATION_NEXT, GNUNET_MQ_msg, GNUNET_MQ_send(), GNUNET_RECLAIM_Operation::h, GNUNET_RECLAIM_AttestationIterator::h, AttestationIterationNextMessage::id, GNUNET_RECLAIM_Handle::mq, GNUNET_RECLAIM_Operation::msg, and GNUNET_RECLAIM_AttestationIterator::r_id.

Referenced by attest_collect(), attest_iter_cb(), and oidc_attest_collect().

{
  struct GNUNET_RECLAIM_Handle *h = ait->h;
  struct AttestationIterationNextMessage *msg;
  struct GNUNET_MQ_Envelope *env;

  env =
    GNUNET_MQ_msg (msg, GNUNET_MESSAGE_TYPE_RECLAIM_ATTESTATION_ITERATION_NEXT);
  msg->id = htonl (ait->r_id);
  GNUNET_MQ_send (h->mq, env);
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_get_attestations_stop()

void GNUNET_RECLAIM_get_attestations_stop

(

struct GNUNET_RECLAIM_AttestationIterator *

ait

)

Stops iteration and releases the handle for further calls.

Must be called on any iteration that has not yet completed prior to calling GNUNET_RECLAIM_disconnect.

Parameters

it	the iterator

Definition at line 1471 of file reclaim_api.c.

References GNUNET_RECLAIM_Operation::env, free_ait(), GNUNET_MESSAGE_TYPE_RECLAIM_ATTESTATION_ITERATION_STOP, GNUNET_MQ_msg, GNUNET_MQ_send(), GNUNET_RECLAIM_Operation::h, GNUNET_RECLAIM_AttestationIterator::h, AttestationIterationStopMessage::id, GNUNET_RECLAIM_Handle::mq, GNUNET_RECLAIM_Operation::msg, and GNUNET_RECLAIM_AttestationIterator::r_id.

Referenced by cleanup_handle(), and do_cleanup().

{
  struct GNUNET_RECLAIM_Handle *h = ait->h;
  struct GNUNET_MQ_Envelope *env;
  struct AttestationIterationStopMessage *msg;

  if (NULL != h->mq)
  {
    env =
      GNUNET_MQ_msg (msg,
                     GNUNET_MESSAGE_TYPE_RECLAIM_ATTESTATION_ITERATION_STOP);
    msg->id = htonl (ait->r_id);
    GNUNET_MQ_send (h->mq, env);
  }
  free_ait (ait);
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_ticket_issue()

struct GNUNET_RECLAIM_Operation* GNUNET_RECLAIM_ticket_issue	(	struct GNUNET_RECLAIM_Handle *	h,
		const struct GNUNET_CRYPTO_EcdsaPrivateKey *	iss,
		const struct GNUNET_CRYPTO_EcdsaPublicKey *	rp,
		const struct GNUNET_RECLAIM_AttributeList *	attrs,
		GNUNET_RECLAIM_TicketCallback	cb,
		void *	cb_cls
	)

Issues a ticket to a relying party.

The identity may use GNUNET_RECLAIM_ticket_consume to consume the ticket and retrieve the attributes specified in the attribute list.

Parameters

h	the identity provider to use
iss	the issuing identity (= the user)
rp	the subject of the ticket (= the relying party)
attrs	the attributes that the relying party is given access to
cb	the callback
cb_cls	the callback closure

Returns

handle to abort the operation

Issues a ticket to a relying party.

The identity may use to consume the ticket and retrieve the attributes specified in the attribute list.

Parameters

h	the reclaim to use
iss	the issuing identity (= the user)
rp	the subject of the ticket (= the relying party)
attrs	the attributes that the relying party is given access to
cb	the callback
cb_cls	the callback closure

Returns

handle to abort the operation

Definition at line 1504 of file reclaim_api.c.

References IssueTicketMessage::attr_len, GNUNET_RECLAIM_Operation::cls, GNUNET_RECLAIM_Operation::env, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_MESSAGE_TYPE_RECLAIM_ISSUE_TICKET, GNUNET_MQ_msg_extra, GNUNET_MQ_send_copy(), GNUNET_new, GNUNET_RECLAIM_attribute_list_serialize(), GNUNET_RECLAIM_attribute_list_serialize_get_size(), GNUNET_RECLAIM_Operation::h, IssueTicketMessage::id, IssueTicketMessage::identity, GNUNET_RECLAIM_Handle::mq, op, GNUNET_RECLAIM_Handle::op_head, GNUNET_RECLAIM_Handle::op_tail, GNUNET_RECLAIM_Operation::r_id, GNUNET_RECLAIM_Handle::r_id_gen, rp, IssueTicketMessage::rp, and GNUNET_RECLAIM_Operation::tr_cb.

Referenced by iter_finished(), oidc_attest_collect_finished_cb(), and oidc_attr_collect_finished_cb().

{
  struct GNUNET_RECLAIM_Operation *op;
  struct IssueTicketMessage *tim;
  size_t attr_len;

  fprintf (stderr, "Issuing ticket\n");
  op = GNUNET_new (struct GNUNET_RECLAIM_Operation);
  op->h = h;
  op->tr_cb = cb;
  op->cls = cb_cls;
  op->r_id = h->r_id_gen++;
  GNUNET_CONTAINER_DLL_insert_tail (h->op_head, h->op_tail, op);
  attr_len = GNUNET_RECLAIM_attribute_list_serialize_get_size (attrs);
  op->env = GNUNET_MQ_msg_extra (tim,
                                 attr_len,
                                 GNUNET_MESSAGE_TYPE_RECLAIM_ISSUE_TICKET);
  tim->identity = *iss;
  tim->rp = *rp;
  tim->id = htonl (op->r_id);

  GNUNET_RECLAIM_attribute_list_serialize (attrs, (char *) &tim[1]);

  tim->attr_len = htons (attr_len);
  if (NULL != h->mq)
    GNUNET_MQ_send_copy (h->mq, op->env);
  return op;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_ticket_revoke()

struct GNUNET_RECLAIM_Operation* GNUNET_RECLAIM_ticket_revoke	(	struct GNUNET_RECLAIM_Handle *	h,
		const struct GNUNET_CRYPTO_EcdsaPrivateKey *	identity,
		const struct GNUNET_RECLAIM_Ticket *	ticket,
		GNUNET_RECLAIM_ContinuationWithStatus	cb,
		void *	cb_cls
	)

Revoked an issued ticket.

The relying party will be unable to retrieve attributes. Other issued tickets remain unaffected. This includes tickets issued to other relying parties as well as to other tickets issued to the audience specified in this ticket.

Parameters

h	the identity provider to use
identity	the issuing identity
ticket	the ticket to revoke
cb	the callback
cb_cls	the callback closure

Returns

handle to abort the operation

Definition at line 1692 of file reclaim_api.c.

References GNUNET_RECLAIM_Operation::cls, GNUNET_RECLAIM_Operation::env, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_MESSAGE_TYPE_RECLAIM_REVOKE_TICKET, GNUNET_MQ_msg, GNUNET_MQ_send(), GNUNET_new, GNUNET_RECLAIM_Operation::h, RevokeTicketMessage::id, identity, RevokeTicketMessage::identity, GNUNET_RECLAIM_Handle::mq, GNUNET_RECLAIM_Operation::msg, op, GNUNET_RECLAIM_Handle::op_head, GNUNET_RECLAIM_Handle::op_tail, GNUNET_RECLAIM_Operation::r_id, GNUNET_RECLAIM_Handle::r_id_gen, GNUNET_RECLAIM_Operation::rvk_cb, ticket, and RevokeTicketMessage::ticket.

Referenced by iter_finished(), and revoke_ticket_cont().

{
  struct GNUNET_RECLAIM_Operation *op;
  struct RevokeTicketMessage *msg;
  uint32_t rid;

  rid = h->r_id_gen++;
  op = GNUNET_new (struct GNUNET_RECLAIM_Operation);
  op->h = h;
  op->rvk_cb = cb;
  op->cls = cb_cls;
  op->r_id = rid;
  GNUNET_CONTAINER_DLL_insert_tail (h->op_head, h->op_tail, op);
  op->env = GNUNET_MQ_msg (msg, GNUNET_MESSAGE_TYPE_RECLAIM_REVOKE_TICKET);
  msg->id = htonl (rid);
  msg->identity = *identity;
  msg->ticket = *ticket;
  if (NULL != h->mq)
  {
    GNUNET_MQ_send (h->mq, op->env);
    op->env = NULL;
  }
  return op;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_ticket_consume()

struct GNUNET_RECLAIM_Operation* GNUNET_RECLAIM_ticket_consume	(	struct GNUNET_RECLAIM_Handle *	h,
		const struct GNUNET_CRYPTO_EcdsaPrivateKey *	identity,
		const struct GNUNET_RECLAIM_Ticket *	ticket,
		GNUNET_RECLAIM_AttributeTicketResult	cb,
		void *	cb_cls
	)

Consumes an issued ticket.

The ticket is used to retrieve identity information from the issuer

Parameters

h	the identity provider to use
identity	the identity that is the subject of the issued ticket (the relying party)
ticket	the issued ticket to consume
cb	the callback to call
cb_cls	the callback closure

Returns

handle to abort the operation

The ticket is persisted and used to retrieve identity information from the issuer

Parameters

h	the reclaim to use
identity	the identity that is the subject of the issued ticket (the relying party)
ticket	the issued ticket to consume
cb	the callback to call
cb_cls	the callback closure

Returns

handle to abort the operation

Definition at line 1553 of file reclaim_api.c.

References GNUNET_RECLAIM_Operation::atr_cb, GNUNET_RECLAIM_Operation::cls, GNUNET_RECLAIM_Operation::env, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_MESSAGE_TYPE_RECLAIM_CONSUME_TICKET, GNUNET_MQ_msg, GNUNET_MQ_send_copy(), GNUNET_new, GNUNET_RECLAIM_Operation::h, ConsumeTicketMessage::id, identity, ConsumeTicketMessage::identity, GNUNET_RECLAIM_Handle::mq, op, GNUNET_RECLAIM_Handle::op_head, GNUNET_RECLAIM_Handle::op_tail, GNUNET_RECLAIM_Operation::r_id, GNUNET_RECLAIM_Handle::r_id_gen, ticket, and ConsumeTicketMessage::ticket.

Referenced by consume_ticket_cont(), iter_finished(), and userinfo_endpoint().

{
  struct GNUNET_RECLAIM_Operation *op;
  struct ConsumeTicketMessage *ctm;

  op = GNUNET_new (struct GNUNET_RECLAIM_Operation);
  op->h = h;
  op->atr_cb = cb;
  op->cls = cb_cls;
  op->r_id = h->r_id_gen++;
  GNUNET_CONTAINER_DLL_insert_tail (h->op_head, h->op_tail, op);
  op->env = GNUNET_MQ_msg (ctm, GNUNET_MESSAGE_TYPE_RECLAIM_CONSUME_TICKET);
  ctm->identity = *identity;
  ctm->id = htonl (op->r_id);
  ctm->ticket = *ticket;
  if (NULL != h->mq)
    GNUNET_MQ_send_copy (h->mq, op->env);
  return op;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_ticket_iteration_start()

struct GNUNET_RECLAIM_TicketIterator* GNUNET_RECLAIM_ticket_iteration_start	(	struct GNUNET_RECLAIM_Handle *	h,
		const struct GNUNET_CRYPTO_EcdsaPrivateKey *	identity,
		GNUNET_SCHEDULER_TaskCallback	error_cb,
		void *	error_cb_cls,
		GNUNET_RECLAIM_TicketCallback	proc,
		void *	proc_cls,
		GNUNET_SCHEDULER_TaskCallback	finish_cb,
		void *	finish_cb_cls
	)

Lists all tickets that have been issued to remote identites (relying parties)

Parameters

h	the identity provider to use
identity	the issuing identity
error_cb	function to call on error (i.e. disconnect), the handle is afterwards invalid
error_cb_cls	closure for error_cb
proc	function to call on each ticket; it will be called repeatedly with a value (if available)
proc_cls	closure for proc
finish_cb	function to call on completion the handle is afterwards invalid
finish_cb_cls	closure for finish_cb

Returns

an iterator handle to use for iteration

Parameters

h	the reclaim to use
identity	the issuing identity
error_cb	function to call on error (i.e. disconnect), the handle is afterwards invalid
error_cb_cls	closure for error_cb
proc	function to call on each ticket; it will be called repeatedly with a value (if available)
proc_cls	closure for proc
finish_cb	function to call on completion the handle is afterwards invalid
finish_cb_cls	closure for finish_cb

Returns

an iterator handle to use for iteration

Definition at line 1597 of file reclaim_api.c.

References GNUNET_RECLAIM_TicketIterator::cls, GNUNET_RECLAIM_Operation::env, GNUNET_RECLAIM_TicketIterator::env, GNUNET_RECLAIM_TicketIterator::error_cb, error_cb(), GNUNET_RECLAIM_TicketIterator::error_cb_cls, GNUNET_RECLAIM_TicketIterator::finish_cb, GNUNET_RECLAIM_TicketIterator::finish_cb_cls, GNUNET_CONTAINER_DLL_insert_tail, GNUNET_MESSAGE_TYPE_RECLAIM_TICKET_ITERATION_START, GNUNET_MQ_msg, GNUNET_MQ_send(), GNUNET_new, GNUNET_RECLAIM_Operation::h, GNUNET_RECLAIM_TicketIterator::h, TicketIterationStartMessage::id, identity, TicketIterationStartMessage::identity, GNUNET_RECLAIM_Handle::mq, GNUNET_RECLAIM_Operation::msg, GNUNET_RECLAIM_TicketIterator::r_id, GNUNET_RECLAIM_Handle::r_id_gen, GNUNET_RECLAIM_Handle::ticket_it_head, GNUNET_RECLAIM_Handle::ticket_it_tail, and GNUNET_RECLAIM_TicketIterator::tr_cb.

Referenced by list_tickets_cont(), and start_process().

{
  struct GNUNET_RECLAIM_TicketIterator *it;
  struct GNUNET_MQ_Envelope *env;
  struct TicketIterationStartMessage *msg;
  uint32_t rid;

  rid = h->r_id_gen++;
  it = GNUNET_new (struct GNUNET_RECLAIM_TicketIterator);
  it->h = h;
  it->error_cb = error_cb;
  it->error_cb_cls = error_cb_cls;
  it->finish_cb = finish_cb;
  it->finish_cb_cls = finish_cb_cls;
  it->tr_cb = proc;
  it->cls = proc_cls;
  it->r_id = rid;
  GNUNET_CONTAINER_DLL_insert_tail (h->ticket_it_head, h->ticket_it_tail, it);
  env = GNUNET_MQ_msg (msg, GNUNET_MESSAGE_TYPE_RECLAIM_TICKET_ITERATION_START);
  msg->id = htonl (rid);
  msg->identity = *identity;
  if (NULL == h->mq)
    it->env = env;
  else
    GNUNET_MQ_send (h->mq, env);
  return it;
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_ticket_iteration_next()

void GNUNET_RECLAIM_ticket_iteration_next

(

struct GNUNET_RECLAIM_TicketIterator *

it

)

Calls the ticket processor specified in GNUNET_RECLAIM_ticket_iteration_start for the next record.

Parameters

it	the iterator

Definition at line 1641 of file reclaim_api.c.

References GNUNET_RECLAIM_Operation::env, GNUNET_MESSAGE_TYPE_RECLAIM_TICKET_ITERATION_NEXT, GNUNET_MQ_msg, GNUNET_MQ_send(), GNUNET_RECLAIM_Operation::h, GNUNET_RECLAIM_TicketIterator::h, TicketIterationNextMessage::id, GNUNET_RECLAIM_Handle::mq, GNUNET_RECLAIM_Operation::msg, and GNUNET_RECLAIM_TicketIterator::r_id.

Referenced by ticket_collect(), and ticket_iter().

{
  struct GNUNET_RECLAIM_Handle *h = it->h;
  struct TicketIterationNextMessage *msg;
  struct GNUNET_MQ_Envelope *env;

  env = GNUNET_MQ_msg (msg, GNUNET_MESSAGE_TYPE_RECLAIM_TICKET_ITERATION_NEXT);
  msg->id = htonl (it->r_id);
  GNUNET_MQ_send (h->mq, env);
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_ticket_iteration_stop()

void GNUNET_RECLAIM_ticket_iteration_stop

(

struct GNUNET_RECLAIM_TicketIterator *

it

)

Stops iteration and releases the handle for further calls.

Must be called on any iteration that has not yet completed prior to calling GNUNET_RECLAIM_disconnect.

Parameters

it	the iterator

Definition at line 1661 of file reclaim_api.c.

References GNUNET_RECLAIM_Operation::env, GNUNET_free, GNUNET_MESSAGE_TYPE_RECLAIM_TICKET_ITERATION_STOP, GNUNET_MQ_msg, GNUNET_MQ_send(), GNUNET_RECLAIM_Operation::h, GNUNET_RECLAIM_TicketIterator::h, TicketIterationStopMessage::id, GNUNET_RECLAIM_Handle::mq, GNUNET_RECLAIM_Operation::msg, and GNUNET_RECLAIM_TicketIterator::r_id.

Referenced by cleanup_handle(), and do_cleanup().

{
  struct GNUNET_RECLAIM_Handle *h = it->h;
  struct GNUNET_MQ_Envelope *env;
  struct TicketIterationStopMessage *msg;

  if (NULL != h->mq)
  {
    env =
      GNUNET_MQ_msg (msg, GNUNET_MESSAGE_TYPE_RECLAIM_TICKET_ITERATION_STOP);
    msg->id = htonl (it->r_id);
    GNUNET_MQ_send (h->mq, env);
  }
  GNUNET_free (it);
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_disconnect()

void GNUNET_RECLAIM_disconnect

(

struct GNUNET_RECLAIM_Handle *

h

)

Disconnect from identity provider service.

Parameters

h	identity provider service to disconnect

Disconnect from identity provider service.

Parameters

h	handle to destroy

Definition at line 1066 of file reclaim_api.c.

References GNUNET_assert, GNUNET_free, GNUNET_MQ_destroy(), GNUNET_SCHEDULER_cancel(), GNUNET_RECLAIM_Handle::mq, GNUNET_RECLAIM_Handle::op_head, and GNUNET_RECLAIM_Handle::reconnect_task.

Referenced by cleanup_handle(), and do_cleanup().

{
  GNUNET_assert (NULL != h);
  if (NULL != h->mq)
  {
    GNUNET_MQ_destroy (h->mq);
    h->mq = NULL;
  }
  if (NULL != h->reconnect_task)
  {
    GNUNET_SCHEDULER_cancel (h->reconnect_task);
    h->reconnect_task = NULL;
  }
  GNUNET_assert (NULL == h->op_head);
  GNUNET_free (h);
}

Here is the call graph for this function:

Here is the caller graph for this function:

GNUNET_RECLAIM_cancel()

void GNUNET_RECLAIM_cancel

(

struct GNUNET_RECLAIM_Operation *

op

)

Cancel an identity provider 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

Cancel an identity provider 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 1051 of file reclaim_api.c.

References free_op(), GNUNET_CONTAINER_DLL_remove, GNUNET_RECLAIM_Operation::h, GNUNET_RECLAIM_Handle::op_head, and GNUNET_RECLAIM_Handle::op_tail.

Referenced by do_cleanup().

{
  struct GNUNET_RECLAIM_Handle *h = op->h;

  GNUNET_CONTAINER_DLL_remove (h->op_head, h->op_tail, op);
  free_op (op);
}

Here is the call graph for this function:

Here is the caller graph for this function: