GNUnet 0.22.1
gnunet-service-messenger_list_handles.c
Go to the documentation of this file.
1/*
2 This file is part of GNUnet.
3 Copyright (C) 2020--2024 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 */
27
29
30void
32{
33 GNUNET_assert (handles);
34
35 handles->head = NULL;
36 handles->tail = NULL;
37}
38
39
40void
42{
43 GNUNET_assert (handles);
44
45 while (handles->head)
46 {
47 struct GNUNET_MESSENGER_ListHandle *element = handles->head;
48
49 GNUNET_CONTAINER_DLL_remove (handles->head, handles->tail, element);
50 destroy_srv_handle (element->handle);
51 GNUNET_free (element);
52 }
53
54 handles->head = NULL;
55 handles->tail = NULL;
56}
57
58
59void
62{
63 struct GNUNET_MESSENGER_ListHandle *element;
64
65 GNUNET_assert ((handles) && (handle));
66
67 element = GNUNET_new (struct GNUNET_MESSENGER_ListHandle);
68 element->handle = handle;
69
70 GNUNET_CONTAINER_DLL_insert_tail (handles->head, handles->tail, element);
71}
72
73
77{
78 struct GNUNET_MESSENGER_ListHandle *element;
79
80 GNUNET_assert ((handles) && (handle));
81
82 for (element = handles->head; element; element = element->next)
83 if (element->handle == handle)
84 break;
85
86 if (! element)
87 return GNUNET_NO;
88
89 GNUNET_CONTAINER_DLL_remove (handles->head, handles->tail, element);
90 GNUNET_free (element);
91
92 return GNUNET_YES;
93}
94
95
98 const struct GNUNET_HashCode *key)
99{
100 struct GNUNET_MESSENGER_ListHandle *element;
102
103 GNUNET_assert ((handles) && (key));
104
105 handle = NULL;
106
107 for (element = handles->head; element; element = element->next)
108 {
109 if (get_srv_handle_member_id ((struct
111 key))
112 handle = (struct GNUNET_MESSENGER_SrvHandle *) element->handle;
113
115 break;
116 }
117
118 return handle;
119}
struct GNUNET_HashCode key
The key used in the DHT.
const struct GNUNET_ShortHashCode * get_srv_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.
enum GNUNET_GenericReturnValue is_srv_handle_routing(const struct GNUNET_MESSENGER_SrvHandle *handle, const struct GNUNET_HashCode *key)
Returns whether a given handle has enabled routing for a room using a specific key by opening that ro...
void destroy_srv_handle(struct GNUNET_MESSENGER_SrvHandle *handle)
Destroys a handle and frees its memory fully.
struct GNUNET_MESSENGER_SrvHandle * find_list_handle_by_member(const struct GNUNET_MESSENGER_ListHandles *handles, const struct GNUNET_HashCode *key)
Searches linearly through the list of handles for members of a specific room which is identified by a...
void add_list_handle(struct GNUNET_MESSENGER_ListHandles *handles, struct GNUNET_MESSENGER_SrvHandle *handle)
Adds a specific handle to the end of the list.
void init_list_handles(struct GNUNET_MESSENGER_ListHandles *handles)
Initializes list of handles as empty list.
enum GNUNET_GenericReturnValue remove_list_handle(struct GNUNET_MESSENGER_ListHandles *handles, struct GNUNET_MESSENGER_SrvHandle *handle)
Removes the first entry matching with a specific handle from the list of handles and returns GNUNET_Y...
void clear_list_handles(struct GNUNET_MESSENGER_ListHandles *handles)
Destroys remaining handles and clears the list.
static struct GNUNET_VPN_Handle * handle
Handle to vpn service.
Definition: gnunet-vpn.c:35
#define GNUNET_CONTAINER_DLL_remove(head, tail, element)
Remove an element from a DLL.
#define GNUNET_CONTAINER_DLL_insert_tail(head, tail, element)
Insert an element at the tail of a DLL.
GNUNET_GenericReturnValue
Named constants for return values.
@ GNUNET_YES
@ GNUNET_NO
#define GNUNET_assert(cond)
Use this for fatal errors that cannot be handled.
#define GNUNET_new(type)
Allocate a struct or union of the given type.
#define GNUNET_free(ptr)
Wrapper around free.
A 512-bit hashcode.
struct GNUNET_MESSENGER_ListHandle * next
struct GNUNET_MESSENGER_SrvHandle * handle
struct GNUNET_MESSENGER_ListHandle * tail
struct GNUNET_MESSENGER_ListHandle * head