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
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
|
/*
This file is part of GNUnet.
(C) 2013 Christian Grothoff (and other contributing authors)
GNUnet is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published
by the Free Software Foundation; either version 3, 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
General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNUnet; see the file COPYING. If not, write to the
Free Software Foundation, Inc., 59 Temple Place - Suite 330,
Boston, MA 02111-1307, USA.
*/
/**
* @file mesh/gnunet-service-mesh_peer.h
* @brief mesh service; dealing with remote peers
* @author Bartlomiej Polot
*
* All functions in this file should use the prefix GMP (Gnunet Mesh Peer)
*/
#ifndef GNUNET_SERVICE_MESH_PEER_H
#define GNUNET_SERVICE_MESH_PEER_H
#ifdef __cplusplus
extern "C"
{
#if 0 /* keep Emacsens' auto-indent happy */
}
#endif
#endif
#include "platform.h"
#include "gnunet_util_lib.h"
#include "gnunet-service-mesh_connection.h"
/**
* Struct containing all information regarding a given peer
*/
struct MeshPeer;
/******************************************************************************/
/******************************** API ***********************************/
/******************************************************************************/
/**
* Initialize peer subsystem.
*
* @param c Configuration.
*/
void
GMP_init (const struct GNUNET_CONFIGURATION_Handle *c);
/**
* Shut down the peer subsystem.
*/
void
GMP_shutdown (void);
/**
* @brief Queue and pass message to core when possible.
*
* @param cls Closure (@c type dependant). It will be used by queue_send to
* build the message to be sent if not already prebuilt.
* @param type Type of the message, 0 for a raw message.
* @param size Size of the message.
* @param c Connection this message belongs to (cannot be NULL).
* @param ch Channel this message belongs to, if applicable (otherwise NULL).
* @param fwd Is this a message going root->dest? (FWD ACK are NOT FWD!)
*/
void
GMP_queue_add (void *cls, uint16_t type, size_t size,
struct MeshConnection *c,
struct MeshChannel *ch,
int fwd);
/**
* Set tunnel.
*
* @param peer Peer.
* @param t Tunnel.
*/
void
GMP_set_tunnel (struct MeshPeer *peer, struct MeshTunnel3 *t);
/**
* Check whether there is a direct (core level) connection to peer.
*
* @param peer Peer to check.
*
* @return GNUNET_YES if there is a direct connection.
*/
int
GMP_is_neighbor (const struct MeshPeer *peer);
/**
* Add a connection to a neighboring peer.
*
* Store that the peer is the first hop of the connection in one
* direction and that on peer disconnect the connection must be
* notified and destroyed, for it will no longer be valid.
*
* @param peer Peer to add connection to.
* @param c Connection to add.
*
* @return GNUNET_OK on success.
*/
int
GMP_add_connection (struct MeshPeer *peer, struct MeshConnection *c);
int
GMP_remove_connection (struct MeshPeer *peer, struct MeshConnection *c);
/**
* Get the Full ID of a peer.
*
* @param peer Peer to get from.
*
* @return Full ID of peer.
*/
struct GNUNET_PeerIdentity *
GMP_get_id (const struct MeshPeer *peer);
/**
* Get the Short ID of a peer.
*
* @param peer Peer to get from.
*
* @return Short ID of peer.
*/
GNUNET_PEER_Id
GMP_get_short_id (const struct MeshPeer *peer);
/**
* Get the static string for a peer ID.
*
* @param peer Peer.
*
* @return Static string for it's ID.
*/
const char *
GMP_2s (const struct MeshPeer *peer);
#if 0 /* keep Emacsens' auto-indent happy */
{
#endif
#ifdef __cplusplus
}
#endif
/* ifndef GNUNET_MESH_SERVICE_PEER_H */
#endif
/* end of gnunet-mesh-service_peer.h */
|
