GNUnet  0.11.x
gnunet-service-messenger_handle.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  */
26 #ifndef GNUNET_SERVICE_MESSENGER_HANDLE_H
27 #define GNUNET_SERVICE_MESSENGER_HANDLE_H
28 
29 #include "platform.h"
30 #include "gnunet_cadet_service.h"
31 #include "gnunet_container_lib.h"
32 #include "gnunet_crypto_lib.h"
34 #include "gnunet_peer_lib.h"
35 #include "gnunet_mq_lib.h"
36 
38 
39 #include "messenger_api_ego.h"
40 #include "messenger_api_message.h"
41 
43 {
46 
47  char *name;
48 
50 
52 
54 };
55 
65 
71 void
73 
82 void
83 get_handle_data_subdir (struct GNUNET_MESSENGER_SrvHandle *handle, const char *name, char **dir);
84 
94 const struct GNUNET_ShortHashCode*
96 
106 void
108  const struct GNUNET_ShortHashCode *unique_id);
109 
116 struct GNUNET_MESSENGER_Ego*
118 
125 void
127 
135 int
137 
148 int
150 
159 int
161 
171 int
173  const struct GNUNET_HashCode *key);
174 
183 int
185 
194 int
196  struct GNUNET_MESSENGER_Message *message);
197 
204 void
206 
213 void
215 
216 #endif //GNUNET_SERVICE_MESSENGER_HANDLE_H
static char * dir
Set to the directory where runtime files are stored.
Definition: gnunet-arm.c:89
int entry_handle_room(struct GNUNET_MESSENGER_SrvHandle *handle, const struct GNUNET_PeerIdentity *door, const struct GNUNET_HashCode *key)
Makes a given handle a member of the room using a specific key and enters the room through a tunnel t...
void destroy_handle(struct GNUNET_MESSENGER_SrvHandle *handle)
Destroys a handle and frees its memory fully.
struct GNUNET_MESSENGER_Service * service
int set_handle_name(struct GNUNET_MESSENGER_SrvHandle *handle, const char *name)
Tries to rename the handle which implies renaming the EGO its using and moving all related data into ...
void setup_handle_name(struct GNUNET_MESSENGER_SrvHandle *handle, const char *name)
Tries to set the name and EGO key of a handle initially by looking up a specific name.
struct GNUNET_MESSENGER_Ego * get_handle_ego(struct GNUNET_MESSENGER_SrvHandle *handle)
Returns the EGO used by a given handle.
void save_handle_configuration(struct GNUNET_MESSENGER_SrvHandle *handle)
Saves member ids and other potential configuration from a given handle which depends on the given nam...
Internal representation of the hash map.
Handle for an operation with the identity service.
Definition: identity_api.c:39
struct GNUNET_MESSENGER_SrvHandle * create_handle(struct GNUNET_MESSENGER_Service *service, struct GNUNET_MQ_Handle *mq)
Creates and allocates a new handle related to a service and using a given mq (message queue)...
A 256-bit hashcode.
struct GNUNET_MESSENGER_Ego * ego
cryptographic primitives for GNUnet
void change_handle_member_id(struct GNUNET_MESSENGER_SrvHandle *handle, const struct GNUNET_HashCode *key, const struct GNUNET_ShortHashCode *unique_id)
Changes the member id of a given handle in a specific room to match a unique_id.
struct GNUNET_IDENTITY_Operation * operation
static struct GNUNET_DNS_Handle * handle
Handle to transport service.
void get_handle_data_subdir(struct GNUNET_MESSENGER_SrvHandle *handle, const char *name, char **dir)
Writes the path of the directory for a given handle using a specific name to the parameter dir...
A 512-bit hashcode.
GNUnet MESSENGER service.
int close_handle_room(struct GNUNET_MESSENGER_SrvHandle *handle, const struct GNUNET_HashCode *key)
Removes the membership of the room using a specific key and closes it if no other handle from this se...
struct GNUNET_HashCode key
The key used in the DHT.
Handle to a message queue.
Definition: mq.c:85
The identity of the host (wraps the signing key of the peer).
void load_handle_configuration(struct GNUNET_MESSENGER_SrvHandle *handle)
Loads member ids and other potential configuration from a given handle which depends on the given nam...
int update_handle(struct GNUNET_MESSENGER_SrvHandle *handle)
Tries to change the keypair of an EGO of a handle under the same name and informs all rooms about the...
struct GNUNET_CONTAINER_MultiHashMap * member_ids
int open_handle_room(struct GNUNET_MESSENGER_SrvHandle *handle, const struct GNUNET_HashCode *key)
Makes a given handle a member of the room using a specific key and opens the room from the handles se...
int send_handle_message(struct GNUNET_MESSENGER_SrvHandle *handle, const struct GNUNET_HashCode *key, struct GNUNET_MESSENGER_Message *message)
Sends a message from a given handle to the room using a specific key.
GNUnet MESSENGER service.
messenger api: client and service implementation of GNUnet MESSENGER service
const struct GNUNET_ShortHashCode * get_handle_member_id(const struct GNUNET_MESSENGER_SrvHandle *handle, const struct GNUNET_HashCode *key)
Returns the member id of a given handle in a specific room.