GNUnet  0.20.0
gnunet-service-messenger_list_handles.h
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 #ifndef GNUNET_SERVICE_MESSENGER_LIST_HANDLES_H
27 #define GNUNET_SERVICE_MESSENGER_LIST_HANDLES_H
28 
29 #include "platform.h"
30 #include "gnunet_util_lib.h"
31 
32 struct GNUNET_MESSENGER_SrvHandle;
33 
34 struct GNUNET_MESSENGER_ListHandle
35 {
36  struct GNUNET_MESSENGER_ListHandle *prev;
37  struct GNUNET_MESSENGER_ListHandle *next;
38 
39  struct GNUNET_MESSENGER_SrvHandle *handle;
40 };
41 
42 struct GNUNET_MESSENGER_ListHandles
43 {
44  struct GNUNET_MESSENGER_ListHandle *head;
45  struct GNUNET_MESSENGER_ListHandle *tail;
46 };
47 
53 void
54 init_list_handles (struct GNUNET_MESSENGER_ListHandles *handles);
55 
61 void
62 clear_list_handles (struct GNUNET_MESSENGER_ListHandles *handles);
63 
70 void
71 add_list_handle (struct GNUNET_MESSENGER_ListHandles *handles,
72  struct GNUNET_MESSENGER_SrvHandle *handle);
73 
82 int
83 remove_list_handle (struct GNUNET_MESSENGER_ListHandles *handles,
84  struct GNUNET_MESSENGER_SrvHandle *handle);
85 
96 struct GNUNET_MESSENGER_SrvHandle*
97 find_list_handle_by_member (const struct GNUNET_MESSENGER_ListHandles *handles,
98  const struct GNUNET_HashCode *key);
99 
100 #endif //GNUNET_SERVICE_MESSENGER_LIST_HANDLES_H
key
struct GNUNET_HashCode key
The key used in the DHT.
Definition: gnunet-dht-put.c:37
handle
static struct GNUNET_DNS_Handle * handle
Handle to transport service.
Definition: gnunet-dns-monitor.c:34
add_list_handle
void add_list_handle(struct GNUNET_MESSENGER_ListHandles *handles, struct GNUNET_MESSENGER_SrvHandle *handle)
Adds a specific handle to the end of the list.
Definition: gnunet-service-messenger_list_handles.c:59
init_list_handles
void init_list_handles(struct GNUNET_MESSENGER_ListHandles *handles)
Initializes list of handles as empty list.
Definition: gnunet-service-messenger_list_handles.c:32
find_list_handle_by_member
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...
Definition: gnunet-service-messenger_list_handles.c:93
remove_list_handle
int 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...
Definition: gnunet-service-messenger_list_handles.c:72
clear_list_handles
void clear_list_handles(struct GNUNET_MESSENGER_ListHandles *handles)
Destroys remaining handles and clears the list.
Definition: gnunet-service-messenger_list_handles.c:41
gnunet_util_lib.h
GNUNET_HashCode
A 512-bit hashcode.
Definition: gnunet_common.h:284
GNUNET_MESSENGER_ListHandle
Definition: gnunet-service-messenger_list_handles.h:35
GNUNET_MESSENGER_ListHandle::next
struct GNUNET_MESSENGER_ListHandle * next
Definition: gnunet-service-messenger_list_handles.h:37
GNUNET_MESSENGER_ListHandle::prev
struct GNUNET_MESSENGER_ListHandle * prev
Definition: gnunet-service-messenger_list_handles.h:36
GNUNET_MESSENGER_ListHandle::handle
struct GNUNET_MESSENGER_SrvHandle * handle
Definition: gnunet-service-messenger_list_handles.h:39
GNUNET_MESSENGER_ListHandles
Definition: gnunet-service-messenger_list_handles.h:43
GNUNET_MESSENGER_ListHandles::tail
struct GNUNET_MESSENGER_ListHandle * tail
Definition: gnunet-service-messenger_list_handles.h:45
GNUNET_MESSENGER_ListHandles::head
struct GNUNET_MESSENGER_ListHandle * head
Definition: gnunet-service-messenger_list_handles.h:44
GNUNET_MESSENGER_SrvHandle
Definition: gnunet-service-messenger_handle.h:41