GNUnet  0.11.x
gnunet-service-reclaim_tickets.h
Go to the documentation of this file.
1 /*
2  This file is part of GNUnet.
3  Copyright (C) 2012-2015 GNUnet e.V.
4 
5  GNUnet is free software: you can redistribute it and/or modify it
6  under the terms of the GNU Affero General Public License as published
7  by the Free Software Foundation, either version 3 of the License,
8  or (at your option) any later version.
9 
10  GNUnet is distributed in the hope that it will be useful, but
11  WITHOUT ANY WARRANTY; without even the implied warranty of
12  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13  Affero General Public License for more details.
14 
15  You should have received a copy of the GNU Affero General Public License
16  along with this program. If not, see <http://www.gnu.org/licenses/>.
17 
18  SPDX-License-Identifier: AGPL3.0-or-later
19  */
20 
28 #ifndef GNUNET_SERVICE_RECLAIM_TICKETS_H
29 #define GNUNET_SERVICE_RECLAIM_TICKETS_H
30 
31 #include "platform.h"
32 
33 #include "gnunet_util_lib.h"
34 
35 #include "gnunet_constants.h"
36 #include "gnunet_gns_service.h"
37 #include "gnunet_gnsrecord_lib.h"
38 #include "gnunet_protocols.h"
39 #include "gnunet_reclaim_lib.h"
40 #include "gnunet_reclaim_service.h"
41 #include "gnunet_signatures.h"
43 #include "reclaim.h"
44 
49 
50 
55 
56 
61 
62 
67 {
72 
77 
81  unsigned int rd_count;
82 
86  char *data;
87 
91  size_t data_size;
92 
96  char *label;
97 };
98 
99 
106 typedef void (*RECLAIM_TICKETS_TicketIter) (
107  void *cls,
108  struct GNUNET_RECLAIM_Ticket *ticket);
109 
110 
122  void *cls,
124  struct GNUNET_RECLAIM_PresentationList *presentations,
125  int32_t success,
126  const char *emsg);
127 
128 
140  void *cls,
141  const struct GNUNET_IDENTITY_PublicKey *identity,
142  const struct GNUNET_RECLAIM_AttributeList *attributes,
143  const struct GNUNET_RECLAIM_PresentationList *presentations,
144  int32_t success,
145  const char *emsg);
146 
147 
154 typedef void (*RECLAIM_TICKETS_RevokeCallback) (void *cls, int32_t success);
155 
156 
169 RECLAIM_TICKETS_revoke (const struct GNUNET_RECLAIM_Ticket *ticket,
170  const struct GNUNET_IDENTITY_PrivateKey *identity,
172  void *cb_cls);
173 
174 
180 void
182 
183 
197  const struct GNUNET_RECLAIM_Ticket *ticket,
199  void *cb_cls);
200 
201 
207 void
209 
210 
222 void
223 RECLAIM_TICKETS_issue (const struct GNUNET_IDENTITY_PrivateKey *identity,
224  const struct GNUNET_RECLAIM_AttributeList *attrs,
225  const struct GNUNET_IDENTITY_PublicKey *audience,
227  void *cb_cls);
228 
229 
235 void
237 
238 
244 void
246 
247 
258  const struct GNUNET_IDENTITY_PrivateKey *identity,
260  void *cb_cls);
261 
262 
269 int
271 
272 
277 void
279 
280 #endif
void RECLAIM_TICKETS_consume_cancel(struct RECLAIM_TICKETS_ConsumeHandle *cth)
Cancel a consume operation.
void RECLAIM_TICKETS_iteration_stop(struct RECLAIM_TICKETS_Iterator *iter)
Stop a running ticket iteration.
The authorization ticket.
Ticket revocation request handle.
void RECLAIM_TICKETS_revoke_cancel(struct RECLAIM_TICKETS_RevokeHandle *rh)
Cancel a revocation.
A private key for an identity as per LSD0001.
A list of GNUNET_RECLAIM_Attribute structures.
void(* RECLAIM_TICKETS_TicketIter)(void *cls, struct GNUNET_RECLAIM_Ticket *ticket)
Continuation called with ticket.
struct RECLAIM_TICKETS_ConsumeHandle * RECLAIM_TICKETS_consume(const struct GNUNET_IDENTITY_PrivateKey *id, const struct GNUNET_RECLAIM_Ticket *ticket, RECLAIM_TICKETS_ConsumeCallback cb, void *cb_cls)
Consume a ticket.
struct RECLAIM_TICKETS_RevokeHandle * RECLAIM_TICKETS_revoke(const struct GNUNET_RECLAIM_Ticket *ticket, const struct GNUNET_IDENTITY_PrivateKey *identity, RECLAIM_TICKETS_RevokeCallback cb, void *cb_cls)
Revoke a ticket.
struct GNUNET_RECLAIM_AttributeList * attrs
Attributes.
Common type definitions for the identity provider service and API.
void RECLAIM_TICKETS_deinit(void)
Close handles and clean up.
static struct GNUNET_RECLAIM_Ticket ticket
Ticket to consume.
RECLAIM_TICKETS_TicketIter cb
Iter callback.
struct TicketRecordsEntry * next
DLL.
void RECLAIM_TICKETS_iteration_next(struct RECLAIM_TICKETS_Iterator *iter)
Continue ticket iteration.
unsigned int rd_count
Record count.
Handle to a consume operation.
int RECLAIM_TICKETS_init(const struct GNUNET_CONFIGURATION_Handle *c)
Initialize tickets component.
RECLAIM_TICKETS_RevokeCallback cb
Callback.
static struct GNUNET_IDENTITY_Handle * identity
Which namespace do we publish to? NULL if we do not publish to a namespace.
struct RECLAIM_TICKETS_Iterator * RECLAIM_TICKETS_iteration_start(const struct GNUNET_IDENTITY_PrivateKey *identity, RECLAIM_TICKETS_TicketIter cb, void *cb_cls)
Iterate over all tickets issued by an identity.
void(* RECLAIM_TICKETS_TicketResult)(void *cls, struct GNUNET_RECLAIM_Ticket *ticket, struct GNUNET_RECLAIM_PresentationList *presentations, int32_t success, const char *emsg)
Continuation called with ticket.
An identity key as per LSD0001.
A list of GNUNET_RECLAIM_Presentation structures.
configuration data
RECLAIM_TICKETS_ConsumeCallback cb
Callback.
struct TicketRecordsEntry * prev
DLL.
void(* RECLAIM_TICKETS_RevokeCallback)(void *cls, int32_t success)
Revocation callback.
void(* RECLAIM_TICKETS_ConsumeCallback)(void *cls, const struct GNUNET_IDENTITY_PublicKey *identity, const struct GNUNET_RECLAIM_AttributeList *attributes, const struct GNUNET_RECLAIM_PresentationList *presentations, int32_t success, const char *emsg)
Consume callback.
void RECLAIM_TICKETS_issue(const struct GNUNET_IDENTITY_PrivateKey *identity, const struct GNUNET_RECLAIM_AttributeList *attrs, const struct GNUNET_IDENTITY_PublicKey *audience, RECLAIM_TICKETS_TicketResult cb, void *cb_cls)
Issue a new reclaim ticket, thereby authorizing the audience to access the set of provided attributes...