GNUnet  0.20.0
messenger_api.c
Go to the documentation of this file.
1 /*
2  This file is part of GNUnet.
3  Copyright (C) 2020--2021 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"
28 
30 
31 #include "messenger_api_handle.h"
32 #include "messenger_api_message.h"
33 #include "messenger_api_util.h"
34 
35 const char*
37 {
38  switch (kind)
39  {
41  return "INFO";
43  return "JOIN";
45  return "LEAVE";
47  return "NAME";
49  return "KEY";
51  return "PEER";
53  return "ID";
55  return "MISS";
57  return "MERGE";
59  return "REQUEST";
61  return "INVITE";
63  return "TEXT";
65  return "FILE";
67  return "PRIVATE";
69  return "DELETE";
70  default:
71  return "UNKNOWN";
72  }
73 }
74 
75 static int
76 check_get_name (void *cls,
77  const struct GNUNET_MESSENGER_NameMessage *msg)
78 {
80  return GNUNET_OK;
81 }
82 
83 static void
84 handle_get_name (void *cls,
85  const struct GNUNET_MESSENGER_NameMessage *msg)
86 {
87  struct GNUNET_MESSENGER_Handle *handle = cls;
88 
89  const char *name = ((const char*) msg) + sizeof(*msg);
90 
91  GNUNET_log(GNUNET_ERROR_TYPE_DEBUG, "Set name of handle: %s\n", name);
92 
93  set_handle_name (handle, strlen (name) > 0 ? name : NULL);
94 }
95 
96 static int
97 check_get_key (void *cls,
98  const struct GNUNET_MESSENGER_KeyMessage *msg)
99 {
100  const uint16_t full_length = ntohs (msg->header.size);
101 
102  if (full_length < sizeof(*msg))
103  return GNUNET_NO;
104 
105  const uint16_t length = full_length - sizeof(*msg);
106  const char *buffer = ((const char*) msg) + sizeof(*msg);
107 
109  size_t read;
110  if (GNUNET_SYSERR ==
112  &pubkey, &read))
113  return GNUNET_NO;
114 
115  return GNUNET_OK;
116 }
117 
118 static void
119 handle_get_key (void *cls,
120  const struct GNUNET_MESSENGER_KeyMessage *msg)
121 {
122  struct GNUNET_MESSENGER_Handle *handle = cls;
123 
124  const uint16_t length = ntohs (msg->header.size) - sizeof(*msg);
125  const char *buffer = ((const char*) msg) + sizeof(*msg);
126 
128  size_t read;
129  if (GNUNET_SYSERR ==
131  &pubkey, &read))
132  return;
133 
135  GNUNET_log(GNUNET_ERROR_TYPE_DEBUG, "Set key of handle: %s\n", str);
136  GNUNET_free(str);
137 
139 
140  if (handle->identity_callback)
141  handle->identity_callback (handle->identity_cls, handle);
142 }
143 
144 static void
145 handle_member_id (void *cls,
146  const struct GNUNET_MESSENGER_MemberMessage *msg)
147 {
148  struct GNUNET_MESSENGER_Handle *handle = cls;
149 
150  const struct GNUNET_HashCode *key = &(msg->key);
151  const struct GNUNET_ShortHashCode *id = &(msg->id);
152 
153  GNUNET_log(GNUNET_ERROR_TYPE_DEBUG, "Set id of handle in room: %s\n", GNUNET_h2s (key));
154 
156 
157  if (room)
158  {
159  if (!room->contact_id)
161 
162  GNUNET_memcpy(room->contact_id, id, sizeof(*id));
163  }
164 }
165 
166 static void
167 handle_room_open (void *cls,
168  const struct GNUNET_MESSENGER_RoomMessage *msg)
169 {
170  struct GNUNET_MESSENGER_Handle *handle = cls;
171 
172  const struct GNUNET_HashCode *key = &(msg->key);
173 
174  GNUNET_log(GNUNET_ERROR_TYPE_DEBUG, "Opened room: %s\n", GNUNET_h2s (key));
175 
177 }
178 
179 static void
180 handle_room_entry (void *cls,
181  const struct GNUNET_MESSENGER_RoomMessage *msg)
182 {
183  struct GNUNET_MESSENGER_Handle *handle = cls;
184 
185  const struct GNUNET_PeerIdentity *door = &(msg->door);
186  const struct GNUNET_HashCode *key = &(msg->key);
187 
188  GNUNET_log(GNUNET_ERROR_TYPE_DEBUG, "Entered room: %s\n", GNUNET_h2s (key));
189 
191 }
192 
193 static void
194 handle_room_close (void *cls,
195  const struct GNUNET_MESSENGER_RoomMessage *msg)
196 {
197  struct GNUNET_MESSENGER_Handle *handle = cls;
198 
199  const struct GNUNET_HashCode *key = &(msg->key);
200 
201  GNUNET_log(GNUNET_ERROR_TYPE_DEBUG, "Closed room: %s\n", GNUNET_h2s (key));
202 
204 }
205 
206 static int
208  const struct GNUNET_MESSENGER_RecvMessage *msg)
209 {
210  const uint16_t full_length = ntohs (msg->header.size);
211 
212  if (full_length < sizeof(*msg))
213  return GNUNET_NO;
214 
215  const uint16_t length = full_length - sizeof(*msg);
216  const char *buffer = ((const char*) msg) + sizeof(*msg);
217 
218  struct GNUNET_MESSENGER_Message message;
219 
221  return GNUNET_NO;
222 
223  if (GNUNET_YES != decode_message (&message, length, buffer, GNUNET_YES, NULL))
224  return GNUNET_NO;
225 
226  cleanup_message(&message);
227  return GNUNET_OK;
228 }
229 
230 static void
232  const struct GNUNET_MESSENGER_RecvMessage *msg)
233 {
234  struct GNUNET_MESSENGER_Handle *handle = cls;
235 
236  const struct GNUNET_HashCode *key = &(msg->key);
237  const struct GNUNET_HashCode *sender = &(msg->sender);
238  const struct GNUNET_HashCode *context = &(msg->context);
239  const struct GNUNET_HashCode *hash = &(msg->hash);
240  const enum GNUNET_MESSENGER_MessageFlags flags = (
241  (enum GNUNET_MESSENGER_MessageFlags) (msg->flags)
242  );
243 
244  const uint16_t length = ntohs (msg->header.size) - sizeof(*msg);
245  const char *buffer = ((const char*) msg) + sizeof(*msg);
246 
247  struct GNUNET_MESSENGER_Message message;
248  decode_message (&message, length, buffer, GNUNET_YES, NULL);
249 
250  GNUNET_log(GNUNET_ERROR_TYPE_DEBUG, "Receiving message: %s\n", GNUNET_MESSENGER_name_of_kind (message.header.kind));
251 
253 
254  if (room)
255  {
257 
258  GNUNET_log(GNUNET_ERROR_TYPE_DEBUG, "Raw contact from sender and context: (%s : %s)\n",
260 
262  store, context, sender
263  );
264 
265  contact = handle_room_message (room, contact, &message, hash);
266 
267  const struct GNUNET_MESSENGER_Message *stored_message = get_room_message(room, hash);
268 
269  if (handle->msg_callback)
270  handle->msg_callback (handle->msg_cls, room, contact, stored_message, hash, flags);
271  }
272  else
273  GNUNET_log(GNUNET_ERROR_TYPE_DEBUG, "Unknown room for this client: %s\n", GNUNET_h2s (key));
274 
275  cleanup_message(&message);
276 }
277 
278 static void
280 
281 static void
283  struct GNUNET_MESSENGER_Room *room)
284 {
286  struct GNUNET_MQ_Envelope *env;
287 
289  GNUNET_memcpy(&(msg->key), &(room->key), sizeof(msg->key));
291 }
292 
293 static void
295  struct GNUNET_MESSENGER_Room *room,
296  const struct GNUNET_PeerIdentity *door)
297 {
299  struct GNUNET_MQ_Envelope *env;
300 
302  GNUNET_memcpy(&(msg->door), door, sizeof(*door));
303  GNUNET_memcpy(&(msg->key), &(room->key), sizeof(msg->key));
305 }
306 
307 static void
309  struct GNUNET_MESSENGER_Room *room)
310 {
312  struct GNUNET_MQ_Envelope *env;
313 
315  GNUNET_memcpy(&(msg->key), &(room->key), sizeof(msg->key));
317 }
318 
319 static int
321  const struct GNUNET_HashCode *key,
322  void *value)
323 {
324  struct GNUNET_MESSENGER_Handle *handle = cls;
325  struct GNUNET_MESSENGER_Room *room = value;
326 
327  if (GNUNET_YES == room->opened)
328  send_open_room (handle, room);
329 
330  struct GNUNET_MESSENGER_ListTunnel *entry = room->entries.head;
331 
332  struct GNUNET_PeerIdentity door;
333 
334  while (entry)
335  {
336  GNUNET_PEER_resolve (entry->peer, &door);
337 
338  send_enter_room (handle, room, &door);
339 
340  entry = entry->next;
341  }
342 
343  return GNUNET_YES;
344 }
345 
346 static void
348 {
349  struct GNUNET_MESSENGER_Handle *handle = cls;
350 
351  handle->reconnect_task = NULL;
352  handle->reconnect_time = GNUNET_TIME_STD_BACKOFF(handle->reconnect_time)
353  ;
354 
355  reconnect (handle);
356 
358 }
359 
360 static int
362  const struct GNUNET_HashCode *key,
363  void *value)
364 {
365  struct GNUNET_MESSENGER_Handle *handle = cls;
366  struct GNUNET_MESSENGER_Room *room = value;
367 
368  send_close_room (handle, room);
369 
370  return GNUNET_YES;
371 }
372 
373 static void
374 callback_mq_error (void *cls,
375  enum GNUNET_MQ_Error error)
376 {
377  struct GNUNET_MESSENGER_Handle *handle = cls;
378 
379  GNUNET_log(GNUNET_ERROR_TYPE_ERROR, "MQ_Error: %u\n", error);
380 
382 
383  if (handle->mq)
384  {
386  handle->mq = NULL;
387  }
388 
390 }
391 
392 static void
394 {
395  const struct GNUNET_MQ_MessageHandler handlers[] =
396  {
400  ),
404  ),
406  member_id,
409  ),
411  room_open,
414  ),
416  room_entry,
419  ),
421  room_close,
424  ),
426  recv_message,
429  ),
431  };
432 
434 }
435 
438  const char *name,
440  void *identity_cls,
442  void *msg_cls)
443 {
445 
446  reconnect (handle);
447 
448  if (handle->mq)
449  {
450  const uint16_t name_len = name ? strlen (name) : 0;
451 
453  struct GNUNET_MQ_Envelope *env;
454 
456 
457  char *extra = ((char*) msg) + sizeof(*msg);
458 
459  if (name_len)
460  GNUNET_memcpy(extra, name, name_len);
461 
462  extra[name_len] = '\0';
463 
465  return handle;
466  }
467  else
468  {
470  return NULL;
471  }
472 }
473 
474 int
476 {
477  if ((!handle) || (!get_handle_name (handle)))
478  return GNUNET_SYSERR;
479 
481  struct GNUNET_MQ_Envelope *env;
482 
485  return GNUNET_OK;
486 }
487 
488 void
490 {
491  if (!handle)
492  return;
493 
495  struct GNUNET_MQ_Envelope *env;
496 
499 
501 }
502 
503 const char*
505 {
506  if (!handle)
507  return NULL;
508 
509  return get_handle_name (handle);
510 }
511 
512 int
514  const char *name)
515 {
516  if (!handle)
517  return GNUNET_SYSERR;
518 
519  const uint16_t name_len = name ? strlen (name) : 0;
520 
522  struct GNUNET_MQ_Envelope *env;
523 
525 
526  char *extra = ((char*) msg) + sizeof(*msg);
527 
528  if (name_len)
529  GNUNET_memcpy(extra, name, name_len);
530 
531  extra[name_len] = '\0';
532 
534  return GNUNET_YES;
535 }
536 
537 static const struct GNUNET_IDENTITY_PublicKey*
539 {
540  if (0 == GNUNET_memcmp(public_key, get_anonymous_public_key()))
541  return NULL;
542 
543  return public_key;
544 }
545 
546 const struct GNUNET_IDENTITY_PublicKey*
548 {
549  if (!handle)
550  return NULL;
551 
553 }
554 
555 struct GNUNET_MESSENGER_Room*
557  const struct GNUNET_HashCode *key)
558 {
559  if ((!handle) || (!key))
560  return NULL;
561 
563 
564  if (!room)
565  {
566  room = create_room (handle, key);
567 
570  {
571  destroy_room (room);
572  return NULL;
573  }
574  }
575 
576  send_open_room (handle, room);
577  return room;
578 }
579 
580 struct GNUNET_MESSENGER_Room*
582  const struct GNUNET_PeerIdentity *door,
583  const struct GNUNET_HashCode *key)
584 {
585  if ((!handle) || (!door) || (!key))
586  return NULL;
587 
589 
590  if (!room)
591  {
592  room = create_room (handle, key);
593 
596  {
597  destroy_room (room);
598  return NULL;
599  }
600  }
601 
602  send_enter_room (handle, room, door);
603  return room;
604 }
605 
606 void
608 {
609  if (!room)
610  return;
611 
612  send_close_room (room->handle, room);
613 }
614 
616 {
619  size_t counter;
620  void *cls;
621 };
622 
623 static int
624 iterate_find_room (void* cls,
625  const struct GNUNET_HashCode *key,
626  void *value)
627 {
628  struct GNUNET_MESSENGER_RoomFind *find = cls;
629  struct GNUNET_MESSENGER_Room *room = value;
630 
631  if ((find->counter > 0) && ((!find->contact) || (GNUNET_YES == find_room_member(room, find->contact))))
632  {
633  find->counter--;
634 
635  if (!find->callback)
636  return GNUNET_YES;
637 
638  return find->callback(find->cls, room, find->contact);
639  }
640  else
641  return GNUNET_NO;
642 }
643 
644 int
646  const struct GNUNET_MESSENGER_Contact *contact,
648  void *cls)
649 {
650  if (!handle)
651  return GNUNET_SYSERR;
652 
653  struct GNUNET_MESSENGER_RoomFind find;
654 
655  find.contact = contact;
656  find.callback = callback;
657  find.counter = (contact? contact->rc : SIZE_MAX);
658  find.cls = cls;
659 
661 }
662 
663 const struct GNUNET_HashCode*
665 {
666  if (!room)
667  return NULL;
668 
669  return &(room->key);
670 }
671 
672 const struct GNUNET_MESSENGER_Contact*
674  const struct GNUNET_HashCode *hash)
675 {
676  if ((!room) || (!hash))
677  return NULL;
678 
679  return get_room_sender(room, hash);
680 }
681 
682 const char*
684 {
685  if (!contact)
686  return NULL;
687 
688  return get_contact_name (contact);
689 }
690 
691 const struct GNUNET_IDENTITY_PublicKey*
693 {
694  if (!contact)
695  return NULL;
696 
697  return get_non_anonymous_key (get_contact_key (contact));
698 }
699 
700 void
702  const struct GNUNET_MESSENGER_Message *message,
703  const struct GNUNET_MESSENGER_Contact *contact)
704 {
705  if ((!room) || (!message))
706  return;
707 
708  switch (filter_message_sending (message))
709  {
710  case GNUNET_SYSERR:
711  GNUNET_log(GNUNET_ERROR_TYPE_ERROR, "Sending message aborted: This kind of message is reserved for the service!\n");
712  return;
713  case GNUNET_NO:
714  GNUNET_log(GNUNET_ERROR_TYPE_WARNING, "Sending message aborted: This kind of message could cause issues!\n");
715  return;
716  default:
717  break;
718  }
719 
720  ssize_t key_length = 0;
721 
722  if (contact)
723  {
724  const struct GNUNET_IDENTITY_PublicKey *public_key = get_non_anonymous_key (
725  get_contact_key(contact)
726  );
727 
728  if (public_key)
729  key_length = GNUNET_IDENTITY_public_key_get_length(public_key);
730  else
731  key_length = -1;
732  }
733 
734  if (key_length < 0)
735  {
736  GNUNET_log(GNUNET_ERROR_TYPE_WARNING, "Sending message aborted: Invalid key!\n");
737  return;
738  }
739 
740  const uint16_t msg_length = get_message_size (message, GNUNET_NO);
741 
743  struct GNUNET_MQ_Envelope *env;
744 
745  const uint16_t length = (uint16_t) key_length + msg_length;
746 
748  msg, length,
750  );
751 
752  GNUNET_memcpy(&(msg->key), &(room->key), sizeof(msg->key));
753 
754  msg->flags = (uint32_t) (
756  );
757 
758  char *buffer = ((char*) msg) + sizeof(*msg);
759  char *msg_buffer = buffer + key_length;
760 
761  if (key_length > 0)
762  GNUNET_IDENTITY_write_public_key_to_buffer(get_contact_key(contact), buffer, key_length);
763 
764  encode_message (message, msg_length, msg_buffer, GNUNET_NO);
765 
766  GNUNET_MQ_send (room->handle->mq, env);
767 }
768 
769 const struct GNUNET_MESSENGER_Message*
771  const struct GNUNET_HashCode *hash)
772 {
773  if ((!room) || (!hash))
774  return NULL;
775 
776  const struct GNUNET_MESSENGER_Message *message = get_room_message (room, hash);
777 
778  if (!message)
779  {
781  struct GNUNET_MQ_Envelope *env;
782 
784  GNUNET_memcpy(&(msg->key), &(room->key), sizeof(msg->key));
785  GNUNET_memcpy(&(msg->hash), hash, sizeof(*hash));
786  GNUNET_MQ_send (room->handle->mq, env);
787  }
788 
789  return message;
790 }
791 
792 int
795  void *cls)
796 {
797  if (!room)
798  return GNUNET_SYSERR;
799 
800  return iterate_room_members(room, callback, cls);
801 }
struct GNUNET_MessageHeader * msg
Definition: 005.c:2
struct GNUNET_MQ_Envelope * env
Definition: 005.c:1
static enum GNUNET_GenericReturnValue recv_message(void *cls, const struct GNUNET_MessageHeader *msg)
We have received a full message, pass to the MQ dispatcher.
Definition: client.c:335
static const struct GNUNET_CONFIGURATION_Handle * cfg
Configuration we are using.
Definition: gnunet-abd.c:36
static struct GNUNET_CADET_MessageHandler handlers[]
Handlers, for diverse services.
struct GNUNET_HashCode key
The key used in the DHT.
static struct GNUNET_DNS_Handle * handle
Handle to transport service.
static pa_context * context
Pulseaudio context.
static struct GNUNET_IDENTITY_PublicKey pubkey
Public key of the zone to look in.
static char * value
Value of the record to add/remove.
GNUnet MESSENGER service.
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
enum GNUNET_GenericReturnValue GNUNET_CONTAINER_multihashmap_put(struct GNUNET_CONTAINER_MultiHashMap *map, const struct GNUNET_HashCode *key, void *value, enum GNUNET_CONTAINER_MultiHashMapOption opt)
Store a key-value pair in the map.
enum GNUNET_GenericReturnValue GNUNET_CONTAINER_multihashmap_iterate(struct GNUNET_CONTAINER_MultiHashMap *map, GNUNET_CONTAINER_MultiHashMapIteratorCallback it, void *it_cls)
Iterate over all entries in the map.
void * GNUNET_CONTAINER_multihashmap_get(const struct GNUNET_CONTAINER_MultiHashMap *map, const struct GNUNET_HashCode *key)
Given a key find a value in the map matching the key.
@ GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE_FAST
, ' bother checking if a value already exists (faster than GNUNET_CONTAINER_MULTIHASHMAPOPTION_UNIQUE...
ssize_t GNUNET_IDENTITY_write_public_key_to_buffer(const struct GNUNET_IDENTITY_PublicKey *key, void *buffer, size_t len)
Writes a GNUNET_IDENTITY_PublicKey to a compact buffer.
Definition: identity_api.c:890
ssize_t GNUNET_IDENTITY_public_key_get_length(const struct GNUNET_IDENTITY_PublicKey *key)
Get the compacted length of a GNUNET_IDENTITY_PublicKey.
Definition: identity_api.c:830
char * GNUNET_IDENTITY_public_key_to_string(const struct GNUNET_IDENTITY_PublicKey *key)
Creates a (Base32) string representation of the public key.
enum GNUNET_GenericReturnValue GNUNET_IDENTITY_read_public_key_from_buffer(const void *buffer, size_t len, struct GNUNET_IDENTITY_PublicKey *key, size_t *kb_read)
Reads a GNUNET_IDENTITY_PublicKey from a compact buffer.
Definition: identity_api.c:865
#define GNUNET_log(kind,...)
#define GNUNET_memcmp(a, b)
Compare memory in a and b, where both must be of the same pointer type.
#define GNUNET_memcpy(dst, src, n)
Call memcpy() but check for n being 0 first.
@ GNUNET_OK
@ GNUNET_YES
@ GNUNET_NO
@ GNUNET_SYSERR
const char * GNUNET_h2s_full(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
const char * GNUNET_h2s(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
@ GNUNET_ERROR_TYPE_WARNING
@ GNUNET_ERROR_TYPE_ERROR
@ GNUNET_ERROR_TYPE_DEBUG
#define GNUNET_new(type)
Allocate a struct or union of the given type.
#define GNUNET_free(ptr)
Wrapper around free.
const char * GNUNET_MESSENGER_get_name(const struct GNUNET_MESSENGER_Handle *handle)
Get the name (if specified, otherwise NULL) used by the messenger.
struct GNUNET_MESSENGER_Room * GNUNET_MESSENGER_enter_room(struct GNUNET_MESSENGER_Handle *handle, const struct GNUNET_PeerIdentity *door, const struct GNUNET_HashCode *key)
Enter a room to send and receive messages through a door opened using GNUNET_MESSENGER_open_room.
void(* GNUNET_MESSENGER_IdentityCallback)(void *cls, struct GNUNET_MESSENGER_Handle *handle)
Method called whenever the EGO of a handle changes or if the first connection fails to load a valid E...
int GNUNET_MESSENGER_iterate_members(struct GNUNET_MESSENGER_Room *room, GNUNET_MESSENGER_MemberCallback callback, void *cls)
Iterates through all members of a given room and calls a selected callback for each of them with a pr...
struct GNUNET_MESSENGER_Room * GNUNET_MESSENGER_open_room(struct GNUNET_MESSENGER_Handle *handle, const struct GNUNET_HashCode *key)
Open a room to send and receive messages.
int GNUNET_MESSENGER_find_rooms(const struct GNUNET_MESSENGER_Handle *handle, const struct GNUNET_MESSENGER_Contact *contact, GNUNET_MESSENGER_MemberCallback callback, void *cls)
Searches for a specific contact in a given room and calls a selected callback with a given closure fo...
GNUNET_MESSENGER_MessageKind
Enum for the different supported kinds of messages.
GNUNET_MESSENGER_MessageFlags
Enum for the different supported flags used by message handling Compatible flags can be OR'ed togethe...
const struct GNUNET_IDENTITY_PublicKey * GNUNET_MESSENGER_contact_get_key(const struct GNUNET_MESSENGER_Contact *contact)
Get the public key used by the contact or NULL if the anonymous key was used.
int(* GNUNET_MESSENGER_MemberCallback)(void *cls, struct GNUNET_MESSENGER_Room *room, const struct GNUNET_MESSENGER_Contact *contact)
Method called for each member in a room during iteration.
struct GNUNET_MESSENGER_Handle * GNUNET_MESSENGER_connect(const struct GNUNET_CONFIGURATION_Handle *cfg, const char *name, GNUNET_MESSENGER_IdentityCallback identity_callback, void *identity_cls, GNUNET_MESSENGER_MessageCallback msg_callback, void *msg_cls)
Set up a handle for the messenger related functions and connects to all necessary services.
int GNUNET_MESSENGER_update(struct GNUNET_MESSENGER_Handle *handle)
Update a handle of the messenger to use a different ego key and replace the old one with a newly gene...
const char * GNUNET_MESSENGER_contact_get_name(const struct GNUNET_MESSENGER_Contact *contact)
Get the name used by the contact.
const struct GNUNET_IDENTITY_PublicKey * GNUNET_MESSENGER_get_key(const struct GNUNET_MESSENGER_Handle *handle)
Get the public key used by the messenger or NULL if the anonymous key was used.
const char * GNUNET_MESSENGER_name_of_kind(enum GNUNET_MESSENGER_MessageKind kind)
Get the name of a message kind.
Definition: messenger_api.c:36
const struct GNUNET_MESSENGER_Contact * GNUNET_MESSENGER_get_sender(const struct GNUNET_MESSENGER_Room *room, const struct GNUNET_HashCode *hash)
Get the contact of a member in a room which sent a specific message identified with a given hash.
void GNUNET_MESSENGER_disconnect(struct GNUNET_MESSENGER_Handle *handle)
Disconnect all of the messengers used services and clears up its used memory.
const struct GNUNET_HashCode * GNUNET_MESSENGER_room_get_key(const struct GNUNET_MESSENGER_Room *room)
Get the key of a given room.
#define GNUNET_MESSENGER_SERVICE_NAME
Identifier of GNUnet MESSENGER Service.
void GNUNET_MESSENGER_close_room(struct GNUNET_MESSENGER_Room *room)
Close a room which was entered, opened or both in various order and variety.
const struct GNUNET_MESSENGER_Message * GNUNET_MESSENGER_get_message(const struct GNUNET_MESSENGER_Room *room, const struct GNUNET_HashCode *hash)
Get the message in a room identified by its hash.
int GNUNET_MESSENGER_set_name(struct GNUNET_MESSENGER_Handle *handle, const char *name)
Set the name for the messenger.
void GNUNET_MESSENGER_send_message(struct GNUNET_MESSENGER_Room *room, const struct GNUNET_MESSENGER_Message *message, const struct GNUNET_MESSENGER_Contact *contact)
Send a message into a room.
void(* GNUNET_MESSENGER_MessageCallback)(void *cls, struct GNUNET_MESSENGER_Room *room, const struct GNUNET_MESSENGER_Contact *sender, const struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash, enum GNUNET_MESSENGER_MessageFlags flags)
Method called whenever a message is sent or received from a room.
@ GNUNET_MESSENGER_KIND_INFO
The info kind.
@ GNUNET_MESSENGER_KIND_MISS
The miss kind.
@ GNUNET_MESSENGER_KIND_INVITE
The invite kind.
@ GNUNET_MESSENGER_KIND_PRIVATE
The private kind.
@ GNUNET_MESSENGER_KIND_FILE
The file kind.
@ GNUNET_MESSENGER_KIND_REQUEST
The request kind.
@ GNUNET_MESSENGER_KIND_NAME
The name kind.
@ GNUNET_MESSENGER_KIND_LEAVE
The leave kind.
@ GNUNET_MESSENGER_KIND_PEER
The peer kind.
@ GNUNET_MESSENGER_KIND_UNKNOWN
The unknown kind.
@ GNUNET_MESSENGER_KIND_KEY
The key kind.
@ GNUNET_MESSENGER_KIND_TEXT
The text kind.
@ GNUNET_MESSENGER_KIND_JOIN
The join kind.
@ GNUNET_MESSENGER_KIND_DELETE
The delete kind.
@ GNUNET_MESSENGER_KIND_MERGE
The merge kind.
@ GNUNET_MESSENGER_KIND_ID
The id kind.
@ GNUNET_MESSENGER_FLAG_PRIVATE
The private flag.
@ GNUNET_MESSENGER_FLAG_NONE
The none flag.
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.
#define GNUNET_MQ_check_zero_termination(m)
Insert code for a "check_" function that verifies that a given variable-length message received over ...
#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:63
#define GNUNET_MQ_msg(mvar, type)
Allocate a GNUNET_MQ_Envelope.
Definition: gnunet_mq_lib.h:78
#define GNUNET_MQ_hd_var_size(name, code, str, ctx)
#define GNUNET_MQ_hd_fixed_size(name, code, str, ctx)
void GNUNET_MQ_destroy(struct GNUNET_MQ_Handle *mq)
Destroy the message queue.
Definition: mq.c:683
void GNUNET_PEER_resolve(GNUNET_PEER_Id id, struct GNUNET_PeerIdentity *pid)
Convert an interned PID to a normal peer identity.
Definition: peer.c:220
#define GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_OPEN
#define GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_SEND_MESSAGE
#define GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_RECV_MESSAGE
#define GNUNET_MESSAGE_TYPE_MESSENGER_CONNECTION_CREATE
#define GNUNET_MESSAGE_TYPE_MESSENGER_CONNECTION_UPDATE
#define GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_GET_MESSAGE
#define GNUNET_MESSAGE_TYPE_MESSENGER_CONNECTION_DESTROY
#define GNUNET_MESSAGE_TYPE_MESSENGER_CONNECTION_GET_NAME
#define GNUNET_MESSAGE_TYPE_MESSENGER_CONNECTION_SET_NAME
#define GNUNET_MESSAGE_TYPE_MESSENGER_CONNECTION_GET_KEY
#define GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_CLOSE
#define GNUNET_MESSAGE_TYPE_MESSENGER_CONNECTION_MEMBER_ID
#define GNUNET_MESSAGE_TYPE_MESSENGER_ROOM_ENTRY
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:1272
#define GNUNET_TIME_STD_BACKOFF(r)
Perform our standard exponential back-off calculation, starting at 1 ms and then going by a factor of...
static int iterate_reset_room(void *cls, const struct GNUNET_HashCode *key, void *value)
static void handle_recv_message(void *cls, const struct GNUNET_MESSENGER_RecvMessage *msg)
static void callback_reconnect(void *cls)
static void handle_room_close(void *cls, const struct GNUNET_MESSENGER_RoomMessage *msg)
static const struct GNUNET_IDENTITY_PublicKey * get_non_anonymous_key(const struct GNUNET_IDENTITY_PublicKey *public_key)
static int iterate_find_room(void *cls, const struct GNUNET_HashCode *key, void *value)
static void handle_room_open(void *cls, const struct GNUNET_MESSENGER_RoomMessage *msg)
static void handle_room_entry(void *cls, const struct GNUNET_MESSENGER_RoomMessage *msg)
static void send_enter_room(struct GNUNET_MESSENGER_Handle *handle, struct GNUNET_MESSENGER_Room *room, const struct GNUNET_PeerIdentity *door)
static void send_close_room(struct GNUNET_MESSENGER_Handle *handle, struct GNUNET_MESSENGER_Room *room)
static void callback_mq_error(void *cls, enum GNUNET_MQ_Error error)
static void handle_get_key(void *cls, const struct GNUNET_MESSENGER_KeyMessage *msg)
static void handle_member_id(void *cls, const struct GNUNET_MESSENGER_MemberMessage *msg)
static int iterate_close_room(void *cls, const struct GNUNET_HashCode *key, void *value)
static int check_get_key(void *cls, const struct GNUNET_MESSENGER_KeyMessage *msg)
Definition: messenger_api.c:97
static void handle_get_name(void *cls, const struct GNUNET_MESSENGER_NameMessage *msg)
Definition: messenger_api.c:84
static int check_recv_message(void *cls, const struct GNUNET_MESSENGER_RecvMessage *msg)
static void reconnect(struct GNUNET_MESSENGER_Handle *handle)
static void send_open_room(struct GNUNET_MESSENGER_Handle *handle, struct GNUNET_MESSENGER_Room *room)
static int check_get_name(void *cls, const struct GNUNET_MESSENGER_NameMessage *msg)
Definition: messenger_api.c:76
const struct GNUNET_IDENTITY_PublicKey * get_contact_key(const struct GNUNET_MESSENGER_Contact *contact)
Returns the public key of a given contact.
const char * get_contact_name(const struct GNUNET_MESSENGER_Contact *contact)
Returns the current name of a given contact or NULL if no valid name was assigned yet.
struct GNUNET_MESSENGER_Contact * get_store_contact_raw(struct GNUNET_MESSENGER_ContactStore *store, const struct GNUNET_HashCode *context, const struct GNUNET_HashCode *key_hash)
Returns a contact using the hash of a specific public key.
void entry_handle_room_at(struct GNUNET_MESSENGER_Handle *handle, const struct GNUNET_PeerIdentity *door, const struct GNUNET_HashCode *key)
Adds a tunnel for a room known to a handle identified by a given key to a list of opened connections.
const char * get_handle_name(const struct GNUNET_MESSENGER_Handle *handle)
Returns the current name of a given handle or NULL if no valid name was assigned yet.
struct GNUNET_MESSENGER_Handle * create_handle(const struct GNUNET_CONFIGURATION_Handle *cfg, GNUNET_MESSENGER_IdentityCallback identity_callback, void *identity_cls, GNUNET_MESSENGER_MessageCallback msg_callback, void *msg_cls)
Creates and allocates a new handle using a given configuration and a custom message callback with a g...
void open_handle_room(struct GNUNET_MESSENGER_Handle *handle, const struct GNUNET_HashCode *key)
Marks a room known to a handle identified by a given key as open.
void destroy_handle(struct GNUNET_MESSENGER_Handle *handle)
Destroys a handle and frees its memory fully from the client API.
struct GNUNET_MESSENGER_ContactStore * get_handle_contact_store(struct GNUNET_MESSENGER_Handle *handle)
Returns the used contact store of a given handle.
void close_handle_room(struct GNUNET_MESSENGER_Handle *handle, const struct GNUNET_HashCode *key)
Destroys and so implicitly closes a room known to a handle identified by a given key.
void set_handle_name(struct GNUNET_MESSENGER_Handle *handle, const char *name)
Sets the name of a handle to a specific name.
void set_handle_key(struct GNUNET_MESSENGER_Handle *handle, const struct GNUNET_IDENTITY_PublicKey *pubkey)
Sets the public key of a given handle to a specific public key.
const struct GNUNET_IDENTITY_PublicKey * get_handle_key(const struct GNUNET_MESSENGER_Handle *handle)
Returns the public key of a given handle.
messenger api: client implementation of GNUnet MESSENGER service
int filter_message_sending(const struct GNUNET_MESSENGER_Message *message)
Returns if a specific kind of message should be sent by a client.
void encode_message(const struct GNUNET_MESSENGER_Message *message, uint16_t length, char *buffer, int include_header)
Encodes a given message into a buffer of a maximal length in bytes.
int decode_message(struct GNUNET_MESSENGER_Message *message, uint16_t length, const char *buffer, int include_header, uint16_t *padding)
Decodes a message from a given buffer of a maximal length in bytes.
uint16_t get_message_kind_size(enum GNUNET_MESSENGER_MessageKind kind, int include_header)
Returns the minimal size in bytes to encode a message of a specific kind.
uint16_t get_message_size(const struct GNUNET_MESSENGER_Message *message, int include_header)
Returns the exact size in bytes to encode a given message.
void cleanup_message(struct GNUNET_MESSENGER_Message *message)
Frees the messages body memory.
messenger api: client and service implementation of GNUnet MESSENGER service
struct GNUNET_MESSENGER_Contact * handle_room_message(struct GNUNET_MESSENGER_Room *room, struct GNUNET_MESSENGER_Contact *sender, const struct GNUNET_MESSENGER_Message *message, const struct GNUNET_HashCode *hash)
Handles a message with a given hash in a room for the client API to update members and its informatio...
struct GNUNET_MESSENGER_Contact * get_room_sender(const struct GNUNET_MESSENGER_Room *room, const struct GNUNET_HashCode *hash)
Returns a messages sender locally stored from a map for a given hash in a room.
const struct GNUNET_MESSENGER_Message * get_room_message(const struct GNUNET_MESSENGER_Room *room, const struct GNUNET_HashCode *hash)
Returns a message locally stored from a map for a given hash in a room.
int find_room_member(const struct GNUNET_MESSENGER_Room *room, const struct GNUNET_MESSENGER_Contact *contact)
Checks through all members of a given room if a specific contact is found and returns a result depend...
struct GNUNET_MESSENGER_Room * create_room(struct GNUNET_MESSENGER_Handle *handle, const struct GNUNET_HashCode *key)
Creates and allocates a new room for a handle with a given key for the client API.
int iterate_room_members(struct GNUNET_MESSENGER_Room *room, GNUNET_MESSENGER_MemberCallback callback, void *cls)
Iterates through all members of a given room to forward each of them to a selected callback with a cu...
void destroy_room(struct GNUNET_MESSENGER_Room *room)
Destroys a room and frees its memory fully from the client API.
const struct GNUNET_IDENTITY_PublicKey * get_anonymous_public_key()
Returns the public identity key of GNUNET_IDENTITY_ego_get_anonymous() without recalculating it every...
messenger api: client implementation of GNUnet MESSENGER service
#define SIZE_MAX
Definition: platform.h:208
const char * name
struct GNUNET_SCHEDULER_Task * reconnect_task
Task to reconnect to the service.
Definition: dns_api.c:81
const struct GNUNET_CONFIGURATION_Handle * cfg
Configuration to use.
Definition: dns_api.c:66
struct GNUNET_MQ_Handle * mq
Connection to DNS service, or NULL.
Definition: dns_api.c:61
A 512-bit hashcode.
An identity key as per LSD0001.
Message to create a handle for a client.
Message to destroy the handle for a client.
Message to request something from a room.
struct GNUNET_MQ_Handle * mq
GNUNET_MESSENGER_MessageCallback msg_callback
GNUNET_MESSENGER_IdentityCallback identity_callback
Message to receive the current public key of a handle.
struct GNUNET_MESSENGER_ListTunnel * next
struct GNUNET_MESSENGER_ListTunnel * head
Message to receive the current member id of a handle in room.
enum GNUNET_MESSENGER_MessageKind kind
The kind of the message.
struct GNUNET_MESSENGER_MessageHeader header
Header.
Message to receive the current name of a handle.
Message to receive something from a room.
GNUNET_MESSENGER_MemberCallback callback
const struct GNUNET_MESSENGER_Contact * contact
General message to confirm interaction with a room.
struct GNUNET_MESSENGER_Handle * handle
struct GNUNET_MESSENGER_ListTunnels entries
struct GNUNET_ShortHashCode * contact_id
struct GNUNET_HashCode key
Message to send something into a room.
Message to update the handle (its EGO key) for a client.
Message handler for a specific message type.
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).
A 256-bit hashcode.
static char * get_key(const char *line)
Every line in the topology configuration starts with a string indicating which kind of information wi...
Definition: testing.c:1761