aboutsummaryrefslogtreecommitdiff
path: root/src
diff options
context:
space:
mode:
authorChristian Grothoff <christian@grothoff.org>2019-02-13 00:54:43 +0100
committerChristian Grothoff <christian@grothoff.org>2019-02-13 00:54:43 +0100
commita8d06e45c04df151594cf34ce7a17743465fa8db (patch)
tree4a29499ba46e49678719bf0fd2eaabfb150d17a5 /src
parentd8a11aace3ade81eebb0dd3f5b22fb85a536114a (diff)
downloadgnunet-a8d06e45c04df151594cf34ce7a17743465fa8db.tar.gz
gnunet-a8d06e45c04df151594cf34ce7a17743465fa8db.zip
dv service is dead
Diffstat (limited to 'src')
-rw-r--r--src/include/Makefile.am1
-rw-r--r--src/include/gnunet_dv_service.h166
2 files changed, 0 insertions, 167 deletions
diff --git a/src/include/Makefile.am b/src/include/Makefile.am
index bb7749629..6b930178f 100644
--- a/src/include/Makefile.am
+++ b/src/include/Makefile.am
@@ -59,7 +59,6 @@ gnunetinclude_HEADERS = \
59 gnunet_dnsparser_lib.h \ 59 gnunet_dnsparser_lib.h \
60 gnunet_dnsstub_lib.h \ 60 gnunet_dnsstub_lib.h \
61 gnunet_dns_service.h \ 61 gnunet_dns_service.h \
62 gnunet_dv_service.h \
63 gnunet_fragmentation_lib.h \ 62 gnunet_fragmentation_lib.h \
64 gnunet_friends_lib.h \ 63 gnunet_friends_lib.h \
65 gnunet_fs_service.h \ 64 gnunet_fs_service.h \
diff --git a/src/include/gnunet_dv_service.h b/src/include/gnunet_dv_service.h
deleted file mode 100644
index 334912773..000000000
--- a/src/include/gnunet_dv_service.h
+++ /dev/null
@@ -1,166 +0,0 @@
1/*
2 This file is part of GNUnet.
3 Copyright (C) 2013, 2016 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*/
20
21/**
22 * @author Christian Grothoff
23 *
24 * @file
25 * DV service API (should only be used by the DV plugin)
26 *
27 * @defgroup dv DV service
28 * Distance Vector routing
29 *
30 * The DV service API should only be used by the DV plugin.
31 * @{
32 */
33#ifndef GNUNET_SERVICE_DV_H
34#define GNUNET_SERVICE_DV_H
35
36#include "gnunet_util_lib.h"
37#include "gnunet_ats_service.h"
38
39/**
40 * Signature of a function to be called if DV
41 * starts to be able to talk to a peer.
42 *
43 * @param cls closure
44 * @param peer newly connected peer
45 * @param distance distance to the peer
46 * @param network the peer is located in
47 */
48typedef void
49(*GNUNET_DV_ConnectCallback)(void *cls,
50 const struct GNUNET_PeerIdentity *peer,
51 uint32_t distance,
52 enum GNUNET_NetworkType network);
53
54
55/**
56 * Signature of a function to be called if DV
57 * distance to a peer is changed.
58 *
59 * @param cls closure
60 * @param peer connected peer
61 * @param distance new distance to the peer
62 * @param network this network will be used to reach the next hop
63 */
64typedef void
65(*GNUNET_DV_DistanceChangedCallback)(void *cls,
66 const struct GNUNET_PeerIdentity *peer,
67 uint32_t distance,
68 enum GNUNET_NetworkType network);
69
70
71/**
72 * Signature of a function to be called if DV
73 * is no longer able to talk to a peer.
74 *
75 * @param cls closure
76 * @param peer peer that disconnected
77 */
78typedef void
79(*GNUNET_DV_DisconnectCallback)(void *cls,
80 const struct GNUNET_PeerIdentity *peer);
81
82
83/**
84 * Signature of a function to be called if DV
85 * receives a message for this peer.
86 *
87 * @param cls closure
88 * @param sender sender of the message
89 * @param distance how far did the message travel
90 * @param msg actual message payload
91 */
92typedef void
93(*GNUNET_DV_MessageReceivedCallback)(void *cls,
94 const struct GNUNET_PeerIdentity *sender,
95 uint32_t distance,
96 const struct GNUNET_MessageHeader *msg);
97
98
99/**
100 * Signature of a function called once the delivery of a
101 * message has been successful.
102 *
103 * @param cls closure
104 */
105typedef void
106(*GNUNET_DV_MessageSentCallback)(void *cls);
107
108
109/**
110 * Handle to the DV service.
111 */
112struct GNUNET_DV_ServiceHandle;
113
114
115/**
116 * Connect to the DV service.
117 *
118 * @param cfg configuration
119 * @param cls closure for callbacks
120 * @param connect_cb function to call on connects
121 * @param distance_cb function to call if distances change
122 * @param disconnect_cb function to call on disconnects
123 * @param message_cb function to call if we receive messages
124 * @return handle to access the service
125 */
126struct GNUNET_DV_ServiceHandle *
127GNUNET_DV_service_connect (const struct GNUNET_CONFIGURATION_Handle *cfg,
128 void *cls,
129 GNUNET_DV_ConnectCallback connect_cb,
130 GNUNET_DV_DistanceChangedCallback distance_cb,
131 GNUNET_DV_DisconnectCallback disconnect_cb,
132 GNUNET_DV_MessageReceivedCallback message_cb);
133
134
135/**
136 * Disconnect from DV service.
137 *
138 * @param sh service handle
139 */
140void
141GNUNET_DV_service_disconnect (struct GNUNET_DV_ServiceHandle *sh);
142
143
144/**
145 * Handle for a send operation.
146 */
147struct GNUNET_DV_TransmitHandle;
148
149
150/**
151 * Send a message via DV service.
152 *
153 * @param sh service handle
154 * @param target intended recpient
155 * @param msg message payload
156 * @return handle to cancel the operation
157 */
158void
159GNUNET_DV_send (struct GNUNET_DV_ServiceHandle *sh,
160 const struct GNUNET_PeerIdentity *target,
161 const struct GNUNET_MessageHeader *msg);
162
163
164#endif
165
166/** @} */ /* end of group */