GNUnet  0.20.0
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  */
26 #include "platform.h"
28 
30 
31 void
33 {
34  GNUNET_assert(handles);
35 
36  handles->head = NULL;
37  handles->tail = NULL;
38 }
39 
40 void
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 void
61 {
62  GNUNET_assert((handles) && (handle));
63 
65 
66  element->handle = handle;
67 
68  GNUNET_CONTAINER_DLL_insert_tail(handles->head, handles->tail, element);
69 }
70 
71 int
74 {
75  GNUNET_assert((handles) && (handle));
76 
77  struct GNUNET_MESSENGER_ListHandle *element;
78 
79  for (element = handles->head; element; element = element->next)
80  if (element->handle == handle)
81  break;
82 
83  if (!element)
84  return GNUNET_NO;
85 
86  GNUNET_CONTAINER_DLL_remove(handles->head, handles->tail, element);
87  GNUNET_free(element);
88 
89  return GNUNET_YES;
90 }
91 
94  const struct GNUNET_HashCode *key)
95 {
96  GNUNET_assert((handles) && (key));
97 
98  struct GNUNET_MESSENGER_ListHandle *element;
99 
100  for (element = handles->head; element; element = element->next)
102  return element->handle;
103 
104  return NULL;
105 }
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
#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