GNUnet  0.17.6
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--2022 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 
30 void
32 {
33  GNUNET_assert(handles);
34 
35  handles->head = NULL;
36  handles->tail = NULL;
37 }
38 
39 void
41 {
42  GNUNET_assert(handles);
43 
44  while (handles->head)
45  {
46  struct GNUNET_MESSENGER_ListHandle *element = handles->head;
47 
48  GNUNET_CONTAINER_DLL_remove(handles->head, handles->tail, element);
49  destroy_srv_handle (element->handle);
50  GNUNET_free(element);
51  }
52 
53  handles->head = NULL;
54  handles->tail = NULL;
55 }
56 
57 void
60 {
61  GNUNET_assert((handles) && (handle));
62 
64 
65  element->handle = handle;
66 
67  GNUNET_CONTAINER_DLL_insert_tail(handles->head, handles->tail, element);
68 }
69 
70 int
73 {
74  GNUNET_assert((handles) && (handle));
75 
76  struct GNUNET_MESSENGER_ListHandle *element;
77 
78  for (element = handles->head; element; element = element->next)
79  if (element->handle == handle)
80  break;
81 
82  if (!element)
83  return GNUNET_NO;
84 
85  GNUNET_CONTAINER_DLL_remove(handles->head, handles->tail, element);
86  GNUNET_free(element);
87 
88  return GNUNET_YES;
89 }
90 
93  const struct GNUNET_HashCode *key)
94 {
95  GNUNET_assert((handles) && (key));
96 
97  struct GNUNET_MESSENGER_ListHandle *element;
98 
99  for (element = handles->head; element; element = element->next)
101  return element->handle;
102 
103  return NULL;
104 }
struct GNUNET_HashCode key
The key used in the DHT.
static struct GNUNET_DNS_Handle * handle
Handle to transport service.
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.
void destroy_srv_handle(struct GNUNET_MESSENGER_SrvHandle *handle)
Destroys a handle and frees its memory fully.
GNUnet MESSENGER service.
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.
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...
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...
void clear_list_handles(struct GNUNET_MESSENGER_ListHandles *handles)
Destroys remaining handles and clears the list.
#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_YES
@ GNUNET_NO
Definition: gnunet_common.h:98
#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