GNUnet  0.19.2
core_api.c
Go to the documentation of this file.
1 /*
2  This file is part of GNUnet.
3  Copyright (C) 2009-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  */
26 #include "platform.h"
27 #include "gnunet_util_lib.h"
28 #include "gnunet_constants.h"
29 #include "gnunet_core_service.h"
30 #include "core.h"
31 
32 #define LOG(kind, ...) GNUNET_log_from (kind, "core-api", __VA_ARGS__)
33 
34 
38 struct PeerRecord
39 {
44 
49 
55 
60  void *client_cls;
61 
66 
70  uint16_t smr_id_gen;
71 };
72 
73 
78 {
83 
87  void *cls;
88 
93 
98 
103 
108 
113 
119 
123  struct GNUNET_PeerIdentity me;
124 
129 
134 
138  unsigned int hcnt;
139 
144 };
145 
146 
153 static void
154 reconnect (struct GNUNET_CORE_Handle *h);
155 
156 
162 static void
163 reconnect_task (void *cls)
164 {
165  struct GNUNET_CORE_Handle *h = cls;
166 
167  h->reconnect_task = NULL;
168  LOG (GNUNET_ERROR_TYPE_DEBUG, "Connecting to CORE service after delay\n");
169  reconnect (h);
170 }
171 
172 
182 static int
184  const struct GNUNET_PeerIdentity *key,
185  void *value)
186 {
187  struct GNUNET_CORE_Handle *h = cls;
188  struct PeerRecord *pr = value;
189 
190  GNUNET_assert (pr->h == h);
191  if (NULL != h->disconnects)
192  h->disconnects (h->cls, &pr->peer, pr->client_cls);
195  GNUNET_MQ_destroy (pr->mq);
196  GNUNET_assert (NULL == pr->mq);
197  if (NULL != pr->env)
198  {
199  GNUNET_MQ_discard (pr->env);
200  pr->env = NULL;
201  }
202  GNUNET_free (pr);
203  return GNUNET_YES;
204 }
205 
206 
213 static void
215 {
216  GNUNET_assert (NULL == h->reconnect_task);
217  if (NULL != h->mq)
218  {
220  h->mq = NULL;
221  }
222  GNUNET_assert (NULL == h->reconnect_task);
223  h->reconnect_task =
227  h);
229 }
230 
231 
239 static void
240 handle_mq_error (void *cls, enum GNUNET_MQ_Error error)
241 {
242  struct GNUNET_CORE_Handle *h = cls;
243 
244  LOG (GNUNET_ERROR_TYPE_DEBUG, "MQ ERROR: %d\n", error);
245  reconnect_later (h);
246 }
247 
248 
257 static void
259  const struct GNUNET_MessageHeader *msg,
260  void *impl_state)
261 {
262  struct PeerRecord *pr = impl_state;
263  struct GNUNET_CORE_Handle *h = pr->h;
264  struct SendMessageRequest *smr;
265  struct SendMessage *sm;
266  struct GNUNET_MQ_Envelope *env;
267  uint16_t msize;
269 
270  if (NULL == h->mq)
271  {
272  /* We're currently reconnecting, pretend this worked */
274  return;
275  }
276  GNUNET_assert (NULL == pr->env);
277  /* extract options from envelope */
279  flags = GNUNET_MQ_env_get_options (env);
280 
281  /* check message size for sanity */
282  msize = ntohs (msg->size);
283  if (msize >= GNUNET_MAX_MESSAGE_SIZE - sizeof(struct SendMessage))
284  {
285  GNUNET_break (0);
287  return;
288  }
289 
290  /* ask core for transmission */
292  "Asking core for transmission of %u bytes to `%s'\n",
293  (unsigned int) msize,
294  GNUNET_i2s (&pr->peer));
296  smr->priority = htonl ((uint32_t) flags);
297  smr->peer = pr->peer;
298  smr->size = htons (msize);
299  smr->smr_id = htons (++pr->smr_id_gen);
300  GNUNET_MQ_send (h->mq, env);
301 
302  /* prepare message with actual transmission data */
304  sm->priority = htonl ((uint32_t) flags);
305  sm->peer = pr->peer;
307  "Calling get_message with buffer of %u bytes\n",
308  (unsigned int) msize);
309 }
310 
311 
319 static void
320 core_mq_destroy_impl (struct GNUNET_MQ_Handle *mq, void *impl_state)
321 {
322  struct PeerRecord *pr = impl_state;
323 
324  GNUNET_assert (mq == pr->mq);
325  pr->mq = NULL;
326 }
327 
328 
336 static void
337 core_mq_cancel_impl (struct GNUNET_MQ_Handle *mq, void *impl_state)
338 {
339  struct PeerRecord *pr = impl_state;
340 
341  (void) mq;
342  GNUNET_assert (NULL != pr->env);
343  GNUNET_MQ_discard (pr->env);
344  pr->env = NULL;
345 }
346 
347 
356 static void
357 core_mq_error_handler (void *cls, enum GNUNET_MQ_Error error)
358 {
359  /* struct PeerRecord *pr = cls; */
360  (void) cls;
361  (void) error;
362  GNUNET_break_op (0);
363 }
364 
365 
374 static void
376  const struct GNUNET_PeerIdentity *peer)
377 {
378  struct PeerRecord *pr;
379 
380  pr = GNUNET_new (struct PeerRecord);
381  pr->peer = *peer;
382  pr->h = h;
385  h->peers,
386  &pr->peer,
387  pr,
392  pr,
393  h->handlers,
395  pr);
396  if (NULL != h->connects)
397  {
398  pr->client_cls = h->connects (h->cls, &pr->peer, pr->mq);
400  }
401 }
402 
403 
412 static void
413 handle_init_reply (void *cls, const struct InitReplyMessage *m)
414 {
415  struct GNUNET_CORE_Handle *h = cls;
417 
418  GNUNET_break (0 == ntohl (m->reserved));
420  if (NULL != (init = h->init))
421  {
422  /* mark so we don't call init on reconnect */
423  h->init = NULL;
424  h->me = m->my_identity;
426  "Connected to core service of peer `%s'.\n",
427  GNUNET_i2s (&h->me));
428  h->have_init = GNUNET_YES;
429  init (h->cls, &h->me);
430  }
431  else
432  {
434  "Successfully reconnected to core service.\n");
435  if (GNUNET_NO == h->have_init)
436  {
437  h->me = m->my_identity;
438  h->have_init = GNUNET_YES;
439  }
440  else
441  {
442  GNUNET_break (0 == memcmp (&h->me,
443  &m->my_identity,
444  sizeof(struct GNUNET_PeerIdentity)));
445  }
446  }
447  /* fake 'connect to self' */
448  connect_peer (h, &h->me);
449 }
450 
451 
459 static void
461 {
462  struct GNUNET_CORE_Handle *h = cls;
463  struct PeerRecord *pr;
464 
466  "Received notification about connection from `%s'.\n",
467  GNUNET_i2s (&cnm->peer));
468  if (0 == memcmp (&h->me, &cnm->peer, sizeof(struct GNUNET_PeerIdentity)))
469  {
470  /* connect to self!? */
471  GNUNET_break (0);
472  return;
473  }
474  pr = GNUNET_CONTAINER_multipeermap_get (h->peers, &cnm->peer);
475  if (NULL != pr)
476  {
477  GNUNET_break (0);
478  reconnect_later (h);
479  return;
480  }
481  connect_peer (h, &cnm->peer);
482 }
483 
484 
492 static void
493 handle_disconnect_notify (void *cls, const struct DisconnectNotifyMessage *dnm)
494 {
495  struct GNUNET_CORE_Handle *h = cls;
496  struct PeerRecord *pr;
497 
498  if (0 == memcmp (&h->me, &dnm->peer, sizeof(struct GNUNET_PeerIdentity)))
499  {
500  /* disconnect from self!? */
501  GNUNET_break (0);
502  return;
503  }
504  GNUNET_break (0 == ntohl (dnm->reserved));
506  "Received notification about disconnect from `%s'.\n",
507  GNUNET_i2s (&dnm->peer));
508  pr = GNUNET_CONTAINER_multipeermap_get (h->peers, &dnm->peer);
509  if (NULL == pr)
510  {
511  GNUNET_break (0);
512  reconnect_later (h);
513  return;
514  }
516 }
517 
518 
526 static int
527 check_notify_inbound (void *cls, const struct NotifyTrafficMessage *ntm)
528 {
529  uint16_t msize;
530  const struct GNUNET_MessageHeader *em;
531 
532  (void) cls;
533  msize = ntohs (ntm->header.size) - sizeof(struct NotifyTrafficMessage);
534  if (msize < sizeof(struct GNUNET_MessageHeader))
535  {
536  GNUNET_break (0);
537  return GNUNET_SYSERR;
538  }
539  em = (const struct GNUNET_MessageHeader *) &ntm[1];
540  if (msize != ntohs (em->size))
541  {
542  GNUNET_break (0);
543  return GNUNET_SYSERR;
544  }
545  return GNUNET_OK;
546 }
547 
548 
556 static void
557 handle_notify_inbound (void *cls, const struct NotifyTrafficMessage *ntm)
558 {
559  struct GNUNET_CORE_Handle *h = cls;
560  const struct GNUNET_MessageHeader *em;
561  struct PeerRecord *pr;
562 
564  "Received inbound message from `%s'.\n",
565  GNUNET_i2s (&ntm->peer));
566  em = (const struct GNUNET_MessageHeader *) &ntm[1];
567  pr = GNUNET_CONTAINER_multipeermap_get (h->peers, &ntm->peer);
568  if (NULL == pr)
569  {
570  GNUNET_break (0);
571  reconnect_later (h);
572  return;
573  }
574  GNUNET_MQ_inject_message (pr->mq, em);
575 }
576 
577 
586 static void
587 handle_send_ready (void *cls, const struct SendMessageReady *smr)
588 {
589  struct GNUNET_CORE_Handle *h = cls;
590  struct PeerRecord *pr;
591 
592  pr = GNUNET_CONTAINER_multipeermap_get (h->peers, &smr->peer);
593  if (NULL == pr)
594  {
595  GNUNET_break (0);
596  reconnect_later (h);
597  return;
598  }
600  "Received notification about transmission readiness to `%s'.\n",
601  GNUNET_i2s (&smr->peer));
602  if (NULL == pr->env)
603  {
604  /* request must have been cancelled between the original request
605  * and the response from CORE, ignore CORE's readiness */
606  return;
607  }
608  if (ntohs (smr->smr_id) != pr->smr_id_gen)
609  {
610  /* READY message is for expired or cancelled message,
611  * ignore! (we should have already sent another request) */
612  return;
613  }
614 
615  /* ok, all good, send message out! */
616  GNUNET_MQ_send (h->mq, pr->env);
617  pr->env = NULL;
619 }
620 
621 
628 static void
630 {
632  { GNUNET_MQ_hd_fixed_size (init_reply,
634  struct InitReplyMessage,
635  h),
638  struct ConnectNotifyMessage,
639  h),
643  h),
644  GNUNET_MQ_hd_var_size (notify_inbound,
646  struct NotifyTrafficMessage,
647  h),
648  GNUNET_MQ_hd_fixed_size (send_ready,
650  struct SendMessageReady,
651  h),
653  struct InitMessage *init;
654  struct GNUNET_MQ_Envelope *env;
655  uint16_t *ts;
656 
657  GNUNET_assert (NULL == h->mq);
659  if (NULL == h->mq)
660  {
661  reconnect_later (h);
662  return;
663  }
665  sizeof(uint16_t) * h->hcnt,
667  LOG (GNUNET_ERROR_TYPE_INFO, "(Re)connecting to CORE service\n");
668  init->options = htonl (0);
669  ts = (uint16_t *) &init[1];
670  for (unsigned int hpos = 0; hpos < h->hcnt; hpos++)
671  ts[hpos] = htons (h->handlers[hpos].type);
672  GNUNET_MQ_send (h->mq, env);
673 }
674 
675 
690 struct GNUNET_CORE_Handle *
692  void *cls,
696  const struct GNUNET_MQ_MessageHandler *handlers)
697 {
698  struct GNUNET_CORE_Handle *h;
699 
700  h = GNUNET_new (struct GNUNET_CORE_Handle);
701  h->cfg = cfg;
702  h->cls = cls;
703  h->init = init;
704  h->connects = connects;
705  h->disconnects = disconnects;
707  h->handlers = GNUNET_MQ_copy_handlers (handlers);
709  GNUNET_assert (h->hcnt <
710  (GNUNET_MAX_MESSAGE_SIZE - sizeof(struct InitMessage))
711  / sizeof(uint16_t));
712  LOG (GNUNET_ERROR_TYPE_DEBUG, "Connecting to CORE service\n");
713  reconnect (h);
714  if (NULL == h->mq)
715  {
717  return NULL;
718  }
719  return h;
720 }
721 
722 
728 void
730 {
731  LOG (GNUNET_ERROR_TYPE_DEBUG, "Disconnecting from CORE service\n");
734  handle);
736  handle->peers = NULL;
737  if (NULL != handle->reconnect_task)
738  {
740  handle->reconnect_task = NULL;
741  }
742  if (NULL != handle->mq)
743  {
745  handle->mq = NULL;
746  }
747  GNUNET_free (handle->handlers);
749 }
750 
751 
759 struct GNUNET_MQ_Handle *
761  const struct GNUNET_PeerIdentity *pid)
762 {
763  struct PeerRecord *pr;
764 
765  pr = GNUNET_CONTAINER_multipeermap_get (h->peers, pid);
766  if (NULL == pr)
767  return NULL;
768  return pr->mq;
769 }
770 
771 
772 /* end of core_api.c */
struct GNUNET_MQ_Handle * mq
Definition: 003.c:5
struct GNUNET_MessageHeader * msg
Definition: 005.c:2
struct GNUNET_MQ_Envelope * env
Definition: 005.c:1
void * connects(void *cls, const struct GNUNET_PeerIdentity *peer, struct GNUNET_MQ_Handle *mq)
Definition: 010.c:2
void disconnects(void *cls, const struct GNUNET_PeerIdentity *peer)
Definition: 011.c:2
common internal definitions for core service
static int disconnect_and_free_peer_entry(void *cls, const struct GNUNET_PeerIdentity *key, void *value)
Notify clients about disconnect and free the entry for connected peer.
Definition: core_api.c:183
static void handle_send_ready(void *cls, const struct SendMessageReady *smr)
Handle message received from CORE service notifying us that we are now allowed to send a message to a...
Definition: core_api.c:587
static void reconnect_later(struct GNUNET_CORE_Handle *h)
Close down any existing connection to the CORE service and try re-establishing it later.
Definition: core_api.c:214
static int check_notify_inbound(void *cls, const struct NotifyTrafficMessage *ntm)
Check that message received from CORE service is well-formed.
Definition: core_api.c:527
static void handle_connect_notify(void *cls, const struct ConnectNotifyMessage *cnm)
Handle connect message received from CORE service.
Definition: core_api.c:460
static void core_mq_send_impl(struct GNUNET_MQ_Handle *mq, const struct GNUNET_MessageHeader *msg, void *impl_state)
Implement sending functionality of a message queue for us sending messages to a peer.
Definition: core_api.c:258
static void handle_disconnect_notify(void *cls, const struct DisconnectNotifyMessage *dnm)
Handle disconnect message received from CORE service.
Definition: core_api.c:493
static void reconnect(struct GNUNET_CORE_Handle *h)
Our current client connection went down.
Definition: core_api.c:629
static void handle_notify_inbound(void *cls, const struct NotifyTrafficMessage *ntm)
Handle inbound message received from CORE service.
Definition: core_api.c:557
static void handle_init_reply(void *cls, const struct InitReplyMessage *m)
Handle init reply message received from CORE service.
Definition: core_api.c:413
static void core_mq_cancel_impl(struct GNUNET_MQ_Handle *mq, void *impl_state)
Implementation function that cancels the currently sent message.
Definition: core_api.c:337
#define LOG(kind,...)
Definition: core_api.c:32
static void core_mq_destroy_impl(struct GNUNET_MQ_Handle *mq, void *impl_state)
Handle destruction of a message queue.
Definition: core_api.c:320
static void connect_peer(struct GNUNET_CORE_Handle *h, const struct GNUNET_PeerIdentity *peer)
Add the given peer to the list of our connected peers and create the respective data structures and n...
Definition: core_api.c:375
static void handle_mq_error(void *cls, enum GNUNET_MQ_Error error)
Error handler for the message queue to the CORE service.
Definition: core_api.c:240
static void reconnect_task(void *cls)
Task schedule to try to re-connect to core.
Definition: core_api.c:163
static void core_mq_error_handler(void *cls, enum GNUNET_MQ_Error error)
We had an error processing a message we forwarded from a peer to the CORE service.
Definition: core_api.c:357
static const struct GNUNET_CONFIGURATION_Handle * cfg
Configuration we are using.
Definition: gnunet-abd.c:36
static struct GNUNET_ARM_MonitorHandle * m
Monitor connection with ARM.
Definition: gnunet-arm.c:104
static struct GNUNET_ARM_Handle * h
Connection with ARM.
Definition: gnunet-arm.c:99
static char * init
Set to the name of a service to start.
Definition: gnunet-arm.c:74
static struct GNUNET_CADET_MessageHandler handlers[]
Handlers, for diverse services.
static void disconnect_notify(void *cls, const struct GNUNET_PeerIdentity *peer, void *internal_cls)
Method called whenever a peer disconnects.
static void * connect_notify(void *cls, const struct GNUNET_PeerIdentity *peer, struct GNUNET_MQ_Handle *mq)
Method called whenever a peer connects.
struct GNUNET_HashCode key
The key used in the DHT.
static struct GNUNET_DNS_Handle * handle
Handle to transport service.
static char * value
Value of the record to add/remove.
static struct GNUNET_PeerIdentity pid
Identity of the peer we transmit to / connect to.
Core service; the main API for encrypted P2P communications.
#define GNUNET_MAX_MESSAGE_SIZE
Largest supported message (to be precise, one byte more than the largest possible message,...
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:1057
void(* GNUNET_CORE_DisconnectEventHandler)(void *cls, const struct GNUNET_PeerIdentity *peer, void *peer_cls)
Method called whenever a peer disconnects.
void *(* GNUNET_CORE_ConnectEventHandler)(void *cls, const struct GNUNET_PeerIdentity *peer, struct GNUNET_MQ_Handle *mq)
Method called whenever a given peer connects.
struct GNUNET_CORE_Handle * GNUNET_CORE_connect(const struct GNUNET_CONFIGURATION_Handle *cfg, void *cls, GNUNET_CORE_StartupCallback init, GNUNET_CORE_ConnectEventHandler connects, GNUNET_CORE_DisconnectEventHandler disconnects, const struct GNUNET_MQ_MessageHandler *handlers)
Connect to the core service.
Definition: core_api.c:691
struct GNUNET_MQ_Handle * GNUNET_CORE_get_mq(const struct GNUNET_CORE_Handle *h, const struct GNUNET_PeerIdentity *pid)
Obtain the message queue for a connected peer.
Definition: core_api.c:760
void(* GNUNET_CORE_StartupCallback)(void *cls, const struct GNUNET_PeerIdentity *my_identity)
Function called after GNUNET_CORE_connect has succeeded (or failed for good).
void GNUNET_CORE_disconnect(struct GNUNET_CORE_Handle *handle)
Disconnect from the core service.
Definition: core_api.c:729
void GNUNET_CONTAINER_multipeermap_destroy(struct GNUNET_CONTAINER_MultiPeerMap *map)
Destroy a hash map.
int GNUNET_CONTAINER_multipeermap_iterate(struct GNUNET_CONTAINER_MultiPeerMap *map, GNUNET_CONTAINER_PeerMapIterator it, void *it_cls)
Iterate over all entries in the map.
struct GNUNET_CONTAINER_MultiPeerMap * GNUNET_CONTAINER_multipeermap_create(unsigned int len, int do_not_copy_keys)
Create a multi peer map (hash map for public keys of peers).
void * GNUNET_CONTAINER_multipeermap_get(const struct GNUNET_CONTAINER_MultiPeerMap *map, const struct GNUNET_PeerIdentity *key)
Given a key find a value in the map matching the key.
int GNUNET_CONTAINER_multipeermap_put(struct GNUNET_CONTAINER_MultiPeerMap *map, const struct GNUNET_PeerIdentity *key, void *value, enum GNUNET_CONTAINER_MultiHashMapOption opt)
Store a key-value pair in the map.
enum GNUNET_GenericReturnValue GNUNET_CONTAINER_multipeermap_remove(struct GNUNET_CONTAINER_MultiPeerMap *map, const struct GNUNET_PeerIdentity *key, const void *value)
Remove the given key-value pair from the map.
@ GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_ONLY
There must only be one value per key; storing a value should fail if a value under the same key alrea...
@ GNUNET_OK
@ GNUNET_YES
@ GNUNET_NO
@ GNUNET_SYSERR
#define GNUNET_break_op(cond)
Use this for assertion violations caused by other peers (i.e.
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur.
@ GNUNET_ERROR_TYPE_DEBUG
@ GNUNET_ERROR_TYPE_INFO
#define GNUNET_new(type)
Allocate a struct or union of the given type.
#define GNUNET_free(ptr)
Wrapper around free.
GNUNET_MQ_Error
Error codes for the queue.
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:304
#define GNUNET_MQ_handler_end()
End-marker for the handlers array.
void GNUNET_MQ_discard(struct GNUNET_MQ_Envelope *mqm)
Discard the message queue message, free all allocated resources.
Definition: mq.c:285
struct GNUNET_MQ_Handle * GNUNET_MQ_queue_for_callbacks(GNUNET_MQ_SendImpl send, GNUNET_MQ_DestroyImpl destroy, GNUNET_MQ_CancelImpl cancel, void *impl_state, const struct GNUNET_MQ_MessageHandler *handlers, GNUNET_MQ_ErrorHandler error_handler, void *cls)
Create a message queue for the specified handlers.
Definition: mq.c:465
#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:62
#define GNUNET_MQ_msg_nested_mh(mvar, type, mh)
Allocate a GNUNET_MQ_Envelope, and append a payload message after the given message struct.
void GNUNET_MQ_impl_send_continue(struct GNUNET_MQ_Handle *mq)
Call the send implementation for the next queued message, if any.
Definition: mq.c:421
#define GNUNET_MQ_msg(mvar, type)
Allocate a GNUNET_MQ_Envelope.
Definition: gnunet_mq_lib.h:77
void GNUNET_MQ_inject_message(struct GNUNET_MQ_Handle *mq, const struct GNUNET_MessageHeader *mh)
Call the message message handler that was registered for the type of the given message in the given m...
Definition: mq.c:187
GNUNET_MQ_PriorityPreferences
Per envelope preferences and priorities.
#define GNUNET_MQ_hd_var_size(name, code, str, ctx)
enum GNUNET_MQ_PriorityPreferences GNUNET_MQ_env_get_options(struct GNUNET_MQ_Envelope *env)
Get performance preferences set for this envelope.
Definition: mq.c:839
#define GNUNET_MQ_hd_fixed_size(name, code, str, ctx)
void GNUNET_MQ_set_handlers_closure(struct GNUNET_MQ_Handle *mq, void *handlers_cls)
Change the closure argument in all of the handlers of the mq.
Definition: mq.c:489
struct GNUNET_MQ_MessageHandler * GNUNET_MQ_copy_handlers(const struct GNUNET_MQ_MessageHandler *handlers)
Copy an array of handlers.
Definition: mq.c:957
struct GNUNET_MQ_Envelope * GNUNET_MQ_get_current_envelope(struct GNUNET_MQ_Handle *mq)
Function to obtain the current envelope from within GNUNET_MQ_SendImpl implementations.
Definition: mq.c:813
unsigned int GNUNET_MQ_count_handlers(const struct GNUNET_MQ_MessageHandler *handlers)
Count the handlers in a handler array.
Definition: mq.c:1000
void GNUNET_MQ_destroy(struct GNUNET_MQ_Handle *mq)
Destroy the message queue.
Definition: mq.c:683
#define GNUNET_MESSAGE_TYPE_CORE_SEND_REQUEST
Request from client to transmit message.
#define GNUNET_MESSAGE_TYPE_CORE_NOTIFY_CONNECT
Notify clients about new peer-to-peer connections (triggered after key exchange).
#define GNUNET_MESSAGE_TYPE_CORE_NOTIFY_DISCONNECT
Notify clients about peer disconnecting.
#define GNUNET_MESSAGE_TYPE_CORE_INIT
Initial setup message from core client to core.
#define GNUNET_MESSAGE_TYPE_CORE_SEND
Client with message to transmit (after SEND_READY confirmation was received).
#define GNUNET_MESSAGE_TYPE_CORE_NOTIFY_INBOUND
Notify clients about incoming P2P messages.
#define GNUNET_MESSAGE_TYPE_CORE_INIT_REPLY
Response from core to core client to INIT message.
#define GNUNET_MESSAGE_TYPE_CORE_SEND_READY
Confirmation from core that message can now be sent.
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:944
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_delayed(struct GNUNET_TIME_Relative delay, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay.
Definition: scheduler.c:1241
#define GNUNET_TIME_UNIT_MILLISECONDS
One millisecond.
#define GNUNET_TIME_STD_BACKOFF(r)
Perform our standard exponential back-off calculation, starting at 1 ms and then going by a factor of...
Message sent by the service to clients to notify them about a peer connecting.
Definition: core.h:124
struct GNUNET_PeerIdentity peer
Identity of the connecting peer.
Definition: core.h:138
Message sent by the service to clients to notify them about a peer disconnecting.
Definition: core.h:147
uint32_t reserved
Always zero.
Definition: core.h:156
struct GNUNET_PeerIdentity peer
Identity of the connecting peer.
Definition: core.h:161
struct GNUNET_MQ_Handle * mq
Our connection to the ARM service.
Definition: arm_api.c:107
const struct GNUNET_CONFIGURATION_Handle * cfg
The configuration that we are using.
Definition: arm_api.c:112
struct GNUNET_TIME_Relative retry_backoff
Current delay we use for re-trying to connect to core.
Definition: arm_api.c:152
struct GNUNET_SCHEDULER_Task * reconnect_task
ID of the reconnect task (if any).
Definition: arm_api.c:147
Internal representation of the hash map.
Context for the core service connection.
Definition: core_api.c:78
void * cls
Closure for the various callbacks.
Definition: core_api.c:87
struct GNUNET_CONTAINER_MultiPeerMap * peers
Hash map listing all of the peers that we are currently connected to.
Definition: core_api.c:118
GNUNET_CORE_DisconnectEventHandler disconnects
Function to call whenever we're notified about a peer disconnecting.
Definition: core_api.c:102
GNUNET_CORE_ConnectEventHandler connects
Function to call whenever we're notified about a peer connecting.
Definition: core_api.c:97
struct GNUNET_MQ_Handle * mq
Our message queue for transmissions to the service.
Definition: core_api.c:112
struct GNUNET_MQ_MessageHandler * handlers
Function handlers for messages of particular type.
Definition: core_api.c:107
int have_init
Did we ever get INIT?
Definition: core_api.c:143
struct GNUNET_TIME_Relative retry_backoff
Current delay we use for re-trying to connect to core.
Definition: core_api.c:133
GNUNET_CORE_StartupCallback init
Function to call once we've handshaked with the core service.
Definition: core_api.c:92
const struct GNUNET_CONFIGURATION_Handle * cfg
Configuration we're using.
Definition: core_api.c:82
unsigned int hcnt
Number of entries in the handlers array.
Definition: core_api.c:138
struct GNUNET_SCHEDULER_Task * reconnect_task
ID of reconnect task (if any).
Definition: core_api.c:128
struct GNUNET_PeerIdentity me
Identity of this peer.
Definition: core_api.c:123
struct GNUNET_SCHEDULER_Task * reconnect_task
Task to reconnect to the service.
Definition: dns_api.c:81
struct GNUNET_MQ_Handle * mq
Connection to DNS service, or NULL.
Definition: dns_api.c:61
Handle to a message queue.
Definition: mq.c:87
Message handler for a specific message type.
Header for all communications.
uint16_t size
The length of the struct (in bytes, including the length field itself), in big-endian format.
The identity of the host (wraps the signing key of the peer).
Entry in list of pending tasks.
Definition: scheduler.c:136
Time for relative time used by GNUnet, in microseconds.
Message transmitted core clients to gnunet-service-core to start the interaction.
Definition: core.h:83
Message transmitted by the gnunet-service-core process to its clients in response to an INIT message.
Definition: core.h:101
Message sent by the service to clients to notify them about messages being received or transmitted.
Definition: core.h:175
struct GNUNET_MessageHeader header
Header with type GNUNET_MESSAGE_TYPE_CORE_NOTIFY_INBOUND or GNUNET_MESSAGE_TYPE_CORE_NOTIFY_OUTBOUND.
Definition: core.h:180
struct GNUNET_PeerIdentity peer
Identity of the receiver or sender.
Definition: core.h:185
Information we track for each peer.
Definition: core_api.c:39
uint16_t smr_id_gen
SendMessageRequest ID generator for this peer.
Definition: core_api.c:70
struct GNUNET_CORE_Handle * h
Corresponding CORE handle.
Definition: core_api.c:43
void * client_cls
Value the client returned when we connected, used as the closure in various places.
Definition: core_api.c:60
struct GNUNET_PeerIdentity peer
Peer the record is about.
Definition: core_api.c:65
struct GNUNET_MQ_Handle * mq
Message queue for the peer.
Definition: core_api.c:48
struct GNUNET_MQ_Envelope * env
Message we are currently trying to pass to the CORE service for this peer (from mq).
Definition: core_api.c:54
Core notifying client that it is allowed to now transmit a message to the given target (response to G...
Definition: core.h:241
uint16_t smr_id
smr_id from the request.
Definition: core.h:258
struct GNUNET_PeerIdentity peer
Identity of the intended target.
Definition: core.h:263
Client notifying core about the maximum-priority message it has in the queue for a particular target.
Definition: core.h:196
uint32_t priority
How important is this message?
Definition: core.h:205
struct GNUNET_PeerIdentity peer
Identity of the intended target.
Definition: core.h:216
uint16_t size
How large is the message?
Definition: core.h:226
uint16_t smr_id
Counter for this peer to match SMRs to replies.
Definition: core.h:231
Client asking core to transmit a particular message to a particular target (response to GNUNET_MESSAG...
Definition: core.h:272
uint32_t priority
How important is this message? Contains a enum GNUNET_MQ_PriorityPreferences in NBO.
Definition: core.h:282
struct GNUNET_PeerIdentity peer
Identity of the intended receiver.
Definition: core.h:293
struct GNUNET_TESTBED_Peer * peer
The peer associated with this model.