GNUnet  0.11.x
gnunet_messenger_service.h
Go to the documentation of this file.
1 /*
2  This file is part of GNUnet.
3  Copyright (C) 2020 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  */
32 #ifndef GNUNET_MESSENGER_SERVICE_H
33 #define GNUNET_MESSENGER_SERVICE_H
34 
35 #ifdef __cplusplus
36 extern "C" {
37 #if 0 /* keep Emacsens' auto-indent happy */
38 }
39 #endif
40 #endif
41 
42 #include "platform.h"
44 #include "gnunet_crypto_lib.h"
46 #include "gnunet_mq_lib.h"
47 #include "gnunet_protocols.h"
48 #include "gnunet_scheduler_lib.h"
49 #include "gnunet_time_lib.h"
50 
56 #define GNUNET_MESSENGER_VERSION 0x00000001
57 
61 #define GNUNET_MESSENGER_SERVICE_NAME "messenger"
62 
67 
72 
77 
82 {
87 
92 
97 
102 
107 
112 
117 
122 
127 
132 
137 
142 
147 
152 
157 
162 };
163 
164 #define GNUNET_MESSENGER_KIND_MAX (GNUNET_MESSENGER_KIND_DELETE)
165 
172 const char*
174 
182 {
187 
192 
197 
202 
207 };
208 
216 {
220  struct GNUNET_IDENTITY_PublicKey host_key;
221 
230 };
231 
239 {
244 };
245 
253 {
254 };
255 
263 {
267  char *name;
268 };
269 
277 {
282 };
283 
291 {
296 };
297 
305 {
310 };
311 
319 {
323  struct GNUNET_PeerIdentity peer;
324 };
325 
333 {
338 };
339 
347 {
351  struct GNUNET_HashCode hash;
352 };
353 
361 {
365  struct GNUNET_PeerIdentity door;
366 
370  struct GNUNET_HashCode key;
371 };
372 
380 {
384  char *text;
385 };
386 
394 {
399 
403  struct GNUNET_HashCode hash;
404 
408  char name[NAME_MAX];
409 
413  char *uri;
414 };
415 
423 {
428 
432  uint16_t length;
433 
437  char *data;
438 };
439 
447 {
451  struct GNUNET_HashCode hash;
452 
457 };
458 
463 {
464  union
465  {
481  };
482 };
483 
488 {
493 
498 };
499 
505 {
510 
515 
520 };
521 
529 typedef void
531 
545 typedef void
547  const struct GNUNET_MESSENGER_Contact *sender,
548  const struct GNUNET_MESSENGER_Message *message,
549  const struct GNUNET_HashCode *hash,
550  enum GNUNET_MESSENGER_MessageFlags flags);
551 
560 typedef int
562  const struct GNUNET_MESSENGER_Contact *contact);
563 
580 
592 int
594 
600 void
602 
609 const char*
611 
621 int
623 
630 const struct GNUNET_IDENTITY_PublicKey*
632 
649 struct GNUNET_MESSENGER_Room*
651 
670 struct GNUNET_MESSENGER_Room*
672  const struct GNUNET_HashCode *key);
673 
683 void
685 
697 int
699  GNUNET_MESSENGER_MemberCallback callback, void *cls);
700 
707 const struct GNUNET_HashCode*
709 
719 const struct GNUNET_MESSENGER_Contact*
720 GNUNET_MESSENGER_get_sender (const struct GNUNET_MESSENGER_Room *room, const struct GNUNET_HashCode *hash);
721 
728 const char*
730 
737 const struct GNUNET_IDENTITY_PublicKey*
739 
758 void
760  const struct GNUNET_MESSENGER_Contact* contact);
761 
769 const struct GNUNET_MESSENGER_Message*
770 GNUNET_MESSENGER_get_message (const struct GNUNET_MESSENGER_Room *room, const struct GNUNET_HashCode *hash);
771 
782 int
784  void* cls);
785 
786 #if 0 /* keep Emacsens' auto-indent happy */
787 {
788 #endif
789 #ifdef __cplusplus
790 }
791 #endif
792 
793 #endif //GNUNET_MESSENGER_SERVICE_H
794 /* end of group */
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.
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.
struct GNUNET_ShortHashCode sender_id
The senders id inside of the room the message was sent in.
const struct GNUNET_HashCode * GNUNET_MESSENGER_room_get_key(const struct GNUNET_MESSENGER_Room *room)
Get the key of a given room.
static struct GNUNET_VPN_RedirectionRequest * request
Opaque redirection request handle.
Definition: gnunet-vpn.c:41
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.
static const struct GNUNET_CONFIGURATION_Handle * cfg
Configuration we are using.
Definition: gnunet-abd.c:36
struct GNUNET_TIME_AbsoluteNBO timestamp
The timestamp of the message.
The header of a GNUNET_MESSENGER_Message.
void GNUNET_MESSENGER_close_room(struct GNUNET_MESSENGER_Room *room)
Close a room which was entered, opened or both in various order and variety.
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.
char * uri
The uri of the encrypted file.
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.
const char * GNUNET_MESSENGER_contact_get_name(const struct GNUNET_MESSENGER_Contact *contact)
Get the name used by the contact.
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...
int GNUNET_MESSENGER_set_name(struct GNUNET_MESSENGER_Handle *handle, const char *name)
Set the name for the messenger.
uint32_t messenger_version
The version of GNUnet Messenger API.
static struct GNUNET_IDENTITY_Handle * id
Handle to identity service.
Time for relative time used by GNUnet, in microseconds and in network byte order. ...
char * text
The containing text.
Time for absolute time used by GNUnet, in microseconds and in network byte order. ...
A 256-bit hashcode.
GNUNET_MESSENGER_MessageFlags
Enum for the different supported flags used by message handling Compatible flags can be OR&#39;ed togethe...
cryptographic primitives for GNUnet
The unified body of a GNUNET_MESSENGER_Message.
GNUNET_MESSENGER_MessageCallback msg_callback
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...
An identity signature as per LSD0001.
const char * GNUNET_MESSENGER_name_of_kind(enum GNUNET_MESSENGER_MessageKind kind)
Get the name of a message kind.
Definition: messenger_api.c:35
static struct GNUNET_DNS_Handle * handle
Handle to transport service.
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...
uint16_t length
The length of the encrypted message.
struct GNUNET_IDENTITY_Signature signature
The signature of the senders private key.
A 512-bit hashcode.
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_HashCode previous
The hash of the previous message from the senders perspective.
struct GNUNET_TESTBED_Peer * peer
The peer associated with this model.
struct GNUNET_HashCode key
The key used in the DHT.
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...
static struct GNUNET_TIME_Relative delay
When should dkg communication start?
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.
The identity of the host (wraps the signing key of the peer).
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...
An identity key as per LSD0001.
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...
char * data
The data of the encrypted message.
configuration data
const char * name
void GNUNET_MESSENGER_disconnect(struct GNUNET_MESSENGER_Handle *handle)
Disconnect all of the messengers used services and clears up its used memory.
Public ECC key (always for Curve25519) encoded in a format suitable for network transmission and encr...
const char * GNUNET_MESSENGER_get_name(const struct GNUNET_MESSENGER_Handle *handle)
Get the name (if specified, otherwise NULL) used by the messenger.
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.
GNUNET_MESSENGER_MessageKind
Enum for the different supported kinds of messages.
char * name
The new name which replaces the current senders name.
GNUNET_MESSENGER_IdentityCallback identity_callback
A delete message body This allows deletion of an own previous message with any custom automatic delay...
enum GNUNET_MESSENGER_MessageKind kind
The kind of the message.