GNUnet  0.10.x
consensus_api.c
Go to the documentation of this file.
1 /*
2  This file is part of GNUnet.
3  Copyright (C) 2012, 2016 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 
26 #include "platform.h"
27 #include "gnunet_util_lib.h"
28 #include "gnunet_protocols.h"
29 #include "gnunet_client_lib.h"
31 #include "consensus.h"
32 
33 
34 #define LOG(kind, ...) GNUNET_log_from(kind, "consensus-api", __VA_ARGS__)
35 
36 
45 
50 
55 
60 
64  int joined;
65 
70 
74  void *conclude_cls;
75 
80 
85 };
86 
87 
94  void *cls;
95 };
96 
97 
104 static int
106  const struct GNUNET_CONSENSUS_ElementMessage *msg)
107 {
108  /* any size is fine, elements are variable-size */
109  return GNUNET_OK;
110 }
111 
112 
119 static void
121  const struct GNUNET_CONSENSUS_ElementMessage *msg)
122 {
123  struct GNUNET_CONSENSUS_Handle *consensus = cls;
124  struct GNUNET_SET_Element element;
125 
127  "received new element\n");
128  element.element_type = msg->element_type;
129  element.size = ntohs(msg->header.size) - sizeof(struct GNUNET_CONSENSUS_ElementMessage);
130  element.data = &msg[1];
131  consensus->new_element_cb(consensus->new_element_cls,
132  &element);
133 }
134 
135 
143 static void
145  const struct GNUNET_MessageHeader *msg)
146 {
147  struct GNUNET_CONSENSUS_Handle *consensus = cls;
149 
150  GNUNET_MQ_destroy(consensus->mq);
151  consensus->mq = NULL;
152  GNUNET_assert(NULL != (cc = consensus->conclude_cb));
153  consensus->conclude_cb = NULL;
154  cc(consensus->conclude_cls);
155 }
156 
157 
167 static void
169  enum GNUNET_MQ_Error error)
170 {
172  "consensus service disconnected us\n");
173 }
174 
175 
195  unsigned int num_peers,
196  const struct GNUNET_PeerIdentity *peers,
197  const struct GNUNET_HashCode *session_id,
201  void *new_element_cls)
202 {
203  struct GNUNET_CONSENSUS_Handle *consensus
205  struct GNUNET_MQ_MessageHandler mq_handlers[] = {
206  GNUNET_MQ_hd_var_size(new_element,
209  consensus),
210  GNUNET_MQ_hd_fixed_size(conclude_done,
212  struct GNUNET_MessageHeader,
213  consensus),
215  };
216  struct GNUNET_CONSENSUS_JoinMessage *join_msg;
217  struct GNUNET_MQ_Envelope *ev;
218 
219  consensus->cfg = cfg;
220  consensus->new_element_cb = new_element_cb;
221  consensus->new_element_cls = new_element_cls;
222  consensus->session_id = *session_id;
223  consensus->mq = GNUNET_CLIENT_connect(cfg,
224  "consensus",
225  mq_handlers,
227  consensus);
228  if (NULL == consensus->mq)
229  {
230  GNUNET_free(consensus);
231  return NULL;
232  }
233  ev = GNUNET_MQ_msg_extra(join_msg,
234  (num_peers * sizeof(struct GNUNET_PeerIdentity)),
236 
237  join_msg->session_id = consensus->session_id;
238  join_msg->start = GNUNET_TIME_absolute_hton(start);
239  join_msg->deadline = GNUNET_TIME_absolute_hton(deadline);
240  join_msg->num_peers = htonl(num_peers);
241  GNUNET_memcpy(&join_msg[1],
242  peers,
243  num_peers * sizeof(struct GNUNET_PeerIdentity));
244 
245  GNUNET_MQ_send(consensus->mq, ev);
246  return consensus;
247 }
248 
249 
250 static void
251 idc_adapter(void *cls)
252 {
253  struct InsertDoneInfo *i = cls;
254 
255  i->idc(i->cls, GNUNET_OK);
256  GNUNET_free(i);
257 }
258 
269 void
271  const struct GNUNET_SET_Element *element,
273  void *idc_cls)
274 {
275  struct GNUNET_CONSENSUS_ElementMessage *element_msg;
276  struct GNUNET_MQ_Envelope *ev;
277  struct InsertDoneInfo *i;
278 
279  LOG(GNUNET_ERROR_TYPE_DEBUG, "inserting, size=%llu\n", element->size);
280 
281  ev = GNUNET_MQ_msg_extra(element_msg, element->size,
283 
284  GNUNET_memcpy(&element_msg[1], element->data, element->size);
285 
286  if (NULL != idc)
287  {
288  i = GNUNET_new(struct InsertDoneInfo);
289  i->idc = idc;
290  i->cls = idc_cls;
292  }
293  GNUNET_MQ_send(consensus->mq, ev);
294 }
295 
296 
309 void
312  void *conclude_cls)
313 {
314  struct GNUNET_MQ_Envelope *ev;
315 
316  GNUNET_assert(NULL != conclude);
317  GNUNET_assert(NULL == consensus->conclude_cb);
318 
319  consensus->conclude_cls = conclude_cls;
320  consensus->conclude_cb = conclude;
321 
323  GNUNET_MQ_send(consensus->mq, ev);
324 }
325 
326 
333 void
335 {
336  if (NULL != consensus->mq)
337  {
338  GNUNET_MQ_destroy(consensus->mq);
339  consensus->mq = NULL;
340  }
341  GNUNET_free(consensus);
342 }
343 
344 /* end of consensus_api.c */
GNUNET_CONSENSUS_ConcludeCallback conclude_cb
Called when the conclude operation finishes or fails.
Definition: consensus_api.c:69
void * new_element_cls
Closure for new_element_cb.
Definition: consensus_api.c:54
void GNUNET_CONSENSUS_destroy(struct GNUNET_CONSENSUS_Handle *consensus)
Destroy a consensus handle (free all state associated with it, no longer call any of the callbacks)...
struct GNUNET_MessageHeader * msg
Definition: 005.c:2
void(* GNUNET_CONSENSUS_ElementCallback)(void *cls, const struct GNUNET_SET_Element *element)
Called when a new element was received from another peer, or an error occurred.
struct GNUNET_MQ_Handle * GNUNET_CLIENT_connect(const struct GNUNET_CONFIGURATION_Handle *cfg, const char *service_name, const struct GNUNET_MQ_MessageHandler *handlers, GNUNET_MQ_ErrorHandler error_handler, void *error_handler_cls)
Create a message queue to connect to a GNUnet service.
Definition: client.c:900
GNUNET_MQ_Error
Error codes for the queue.
Element stored in a set.
static int start
Set if we are to start default services (including ARM).
Definition: gnunet-arm.c:39
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
#define LOG(kind,...)
Definition: consensus_api.c:34
static void mq_error_handler(void *cls, enum GNUNET_MQ_Error error)
Generic error handler, called with the appropriate error code and the same closure specified at the c...
#define GNUNET_memcpy(dst, src, n)
Call memcpy() but check for n being 0 first.
#define GNUNET_MQ_hd_fixed_size(name, code, str, ctx)
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
#define GNUNET_new(type)
Allocate a struct or union of the given type.
void GNUNET_CONSENSUS_insert(struct GNUNET_CONSENSUS_Handle *consensus, const struct GNUNET_SET_Element *element, GNUNET_CONSENSUS_InsertDoneCallback idc, void *idc_cls)
Insert an element in the set being reconsiled.
uint16_t size
The length of the struct (in bytes, including the length field itself), in big-endian format...
static void handle_new_element(void *cls, const struct GNUNET_CONSENSUS_ElementMessage *msg)
Called when the server has sent is a new element.
struct GNUNET_TIME_AbsoluteNBO start
Start time for the consensus.
Definition: consensus.h:57
struct GNUNET_HashCode session_id
The (local) session identifier for the consensus session.
Definition: consensus_api.c:59
FIXME: this should not bee necessary when the API issue has been fixed.
Definition: consensus_api.c:92
struct GNUNET_HashCode session_id
Session id of the consensus.
Definition: consensus.h:52
const void * data
Actual data of the element.
uint32_t num_peers
Number of peers (at the end of this message) that want to participate in the consensus.
Definition: consensus.h:47
GNUNET_CONSENSUS_ElementCallback new_element_cb
Callback for new elements.
Definition: consensus_api.c:49
static void idc_adapter(void *cls)
GNUNET_CONSENSUS_InsertDoneCallback idc
Definition: consensus_api.c:93
#define GNUNET_MQ_msg_extra(mvar, esize, type)
Allocate an envelope, with extra space allocated after the space needed by the message struct...
Definition: gnunet_mq_lib.h:52
void(* GNUNET_CONSENSUS_ConcludeCallback)(void *cls)
Called when a conclusion was successful.
void GNUNET_MQ_notify_sent(struct GNUNET_MQ_Envelope *ev, GNUNET_SCHEDULER_TaskCallback cb, void *cb_cls)
Call a callback once the envelope has been sent, that is, sending it can not be canceled anymore...
Definition: mq.c:772
#define GNUNET_MQ_hd_var_size(name, code, str, ctx)
Message with an element.
Definition: consensus.h:71
struct GNUNET_MessageHeader header
Type: Either GNUNET_MESSAGE_TYPE_CONSENSUS_CLIENT_RECEIVED_ELEMENT or GNUNET_MESSAGE_TYPE_CONSENSUS_C...
Definition: consensus.h:77
A 512-bit hashcode.
Message handler for a specific message type.
void(* GNUNET_CONSENSUS_InsertDoneCallback)(void *cls, int success)
Called when an insertion (transmission to consensus service, which does not imply fully consensus on ...
static int check_new_element(void *cls, const struct GNUNET_CONSENSUS_ElementMessage *msg)
Called when the server has sent is a new element.
#define GNUNET_MESSAGE_TYPE_CONSENSUS_CLIENT_RECEIVED_ELEMENT
Sent by service when a new element is added.
#define GNUNET_MESSAGE_TYPE_CONSENSUS_CLIENT_CONCLUDE
Sent by client to service in order to start the consensus conclusion.
struct GNUNET_TIME_Absolute conclude_deadline
Deadline for the conclude operation.
Definition: consensus_api.c:79
Sent by the client to the service, when the client wants the service to join a consensus session...
Definition: consensus.h:37
static unsigned int num_peers
#define GNUNET_MESSAGE_TYPE_CONSENSUS_CLIENT_INSERT
Insert an element.
int joined
GNUNET_YES iff the join message has been sent to the service.
Definition: consensus_api.c:64
Handle to a message queue.
Definition: mq.c:84
#define GNUNET_MQ_msg_header(type)
Allocate a GNUNET_MQ_Envelope, where the message only consists of a header.
Definition: gnunet_mq_lib.h:76
The identity of the host (wraps the signing key of the peer).
const struct GNUNET_CONFIGURATION_Handle * cfg
Configuration to use.
Definition: consensus_api.c:44
configuration data
Definition: configuration.c:83
static struct CadetPeer * peers
Operation to get peer ids.
uint16_t element_type
Type: GNUNET_MESSAGE_TYPE_CONSENSUS_CLIENT_NEW_ELEMENT.
Definition: consensus.h:82
#define GNUNET_MESSAGE_TYPE_CONSENSUS_CLIENT_CONCLUDE_DONE
Sent by service to client in order to signal a completed consensus conclusion.
uint16_t size
Number of bytes in the buffer pointed to by data.
void GNUNET_CONSENSUS_conclude(struct GNUNET_CONSENSUS_Handle *consensus, GNUNET_CONSENSUS_ConcludeCallback conclude, void *conclude_cls)
We are done with inserting new elements into the consensus; try to conclude the consensus within a gi...
#define GNUNET_MESSAGE_TYPE_CONSENSUS_CLIENT_JOIN
Join a consensus session.
Handle for the service.
Definition: consensus_api.c:40
static struct GNUNET_TIME_Absolute deadline
Deadline for all consensuses.
Header for all communications.
void * conclude_cls
Closure for the conclude_cb callback.
Definition: consensus_api.c:74
Time for absolute times used by GNUnet, in microseconds.
void GNUNET_MQ_destroy(struct GNUNET_MQ_Handle *mq)
Destroy the message queue.
Definition: mq.c:821
void GNUNET_MQ_send(struct GNUNET_MQ_Handle *mq, struct GNUNET_MQ_Envelope *ev)
Send a message with the given message queue.
Definition: mq.c:351
struct GNUNET_CONSENSUS_Handle * GNUNET_CONSENSUS_create(const struct GNUNET_CONFIGURATION_Handle *cfg, unsigned int num_peers, const struct GNUNET_PeerIdentity *peers, const struct GNUNET_HashCode *session_id, struct GNUNET_TIME_Absolute start, struct GNUNET_TIME_Absolute deadline, GNUNET_CONSENSUS_ElementCallback new_element_cb, void *new_element_cls)
Create a consensus session.
struct GNUNET_MQ_Handle * mq
Message queue for the client.
Definition: consensus_api.c:84
static void handle_conclude_done(void *cls, const struct GNUNET_MessageHeader *msg)
Called when the server has announced that the conclusion is over.
struct GNUNET_TIME_AbsoluteNBO GNUNET_TIME_absolute_hton(struct GNUNET_TIME_Absolute a)
Convert absolute time to network byte order.
Definition: time.c:655
#define GNUNET_MQ_handler_end()
End-marker for the handlers array.
struct GNUNET_TIME_AbsoluteNBO deadline
Deadline for conclude.
Definition: consensus.h:62
#define GNUNET_free(ptr)
Wrapper around free.
uint16_t element_type
Application-specific element type.