summaryrefslogtreecommitdiff
path: root/src/include/gnunet_transport_address_service.h
blob: b33a11411c01451289dc4b3181a9d3155692c7d1 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
/*
     This file is part of GNUnet.
     Copyright (C) 2009-2018 GNUnet e.V.

     GNUnet is free software: you can redistribute it and/or modify it
     under the terms of the GNU Affero General Public License as published
     by the Free Software Foundation, either version 3 of the License,
     or (at your option) any later version.

     GNUnet is distributed in the hope that it will be useful, but
     WITHOUT ANY WARRANTY; without even the implied warranty of
     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
     Affero General Public License for more details.

     You should have received a copy of the GNU Affero General Public License
     along with this program.  If not, see <http://www.gnu.org/licenses/>.

     SPDX-License-Identifier: AGPL3.0-or-later
*/

/**
 * @author Christian Grothoff
 *
 * @deprecated NOTE: we may want to drop this API and
 *  only keep the gnunet_transport_application_service.h in the future!
 *
 * @file
 * Provide addresses to transport for validation
 *
 * @defgroup transport TRANSPORT service
 * Low-level communication with other peers
 *
 * @see [Documentation](https://gnunet.org/transport-service)
 *
 * @{
 */

#ifndef GNUNET_TRANSPORT_ADDRESS_SERVICE_H
#define GNUNET_TRANSPORT_ADDRESS_SERVICE_H

#ifdef __cplusplus
extern "C" {
#if 0 /* keep Emacsens' auto-indent happy */
}
#endif
#endif

#include "gnunet_util_lib.h"
#include "gnunet_nt_lib.h"

/**
 * Version number of the transport address API.
 */
#define GNUNET_TRANSPORT_ADDRESS_VERSION 0x00000000


/**
 * Opaque handle to the transport service for communicators.
 */
struct GNUNET_TRANSPORT_AddressHandle;


/**
 * Connect to the transport service.
 *
 * @param cfg configuration to use
 * @return NULL on error
 */
struct GNUNET_TRANSPORT_AddressHandle *
GNUNET_TRANSPORT_address_connect (
  const struct GNUNET_CONFIGURATION_Handle *cfg);


/**
 * Disconnect from the transport service.
 *
 * @param ch handle returned from connect
 */
void
GNUNET_TRANSPORT_address_disconnect (struct GNUNET_TRANSPORT_AddressHandle *ch);


/**
 * The client has learned about a possible address for peer @a pid
 * (i.e. via broadcast, multicast, DHT, ...).  The transport service
 * should consider validating it. Note that the plugin is NOT expected
 * to have verified the signature, the transport service must decide
 * whether to check the signature.
 *
 * While the notification is sent to @a ch asynchronously, this API
 * does not return a handle as the delivery of addresses is simply
 * unreliable, and if @a ch is down, the data provided will simply be
 * lost.
 *
 * @param ch communicator handle
 * @param pid peer the address is for
 * @param raw raw address data
 * @param raw_size number of bytes in @a raw
 */
void
GNUNET_TRANSPORT_address_try (struct GNUNET_TRANSPORT_AddressHandle *ch,
                              const struct GNUNET_PeerIdentity *pid,
                              const void *raw,
                              const size_t raw_size);


#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
#ifdef __cplusplus
}
#endif

/* ifndef GNUNET_TRANSPORT_ADDRESS_SERVICE_H */
#endif

/** @} */ /* end of group */

/* end of gnunet_transport_address_service.h */