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
|
/*
This file is part of GNUnet.
(C) 2009, 2010, 2011 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 dht/gnunet-service-xdht_neighbours.h
* @brief GNUnet DHT routing code
* @author Supriti Singh
*/
#ifndef GNUNET_SERVICE_XDHT_NEIGHBOURS_H
#define GNUNET_SERVICE_XDHT_NEIGHBOURS_H
#include "gnunet_util_lib.h"
#include "gnunet_block_lib.h"
#include "gnunet_dht_service.h"
/** FIXME: by default I keep current_source, and destination as my own id.
* in case we find a finger then we update current_source in the
* find_successor message.
* Construct a Put message and send it to target_peer.
* @param key Key for the content
* @param data Content to store
* @param data_size Size of content @a data in bytes
* @param block_type Type of the block
* @param options Routing options
* @param desired_replication_level Desired replication count
* @param expiration_time When does the content expire
* @param current_destination
* @param current_source
* @param target_peer Peer to which this message will be forwarded.
* @param hop_count Number of hops traversed so far.
* @param put_path_length Total number of peers in @a put_path
* @param put_path Number of peers traversed so far
*/
void
GDS_NEIGHBOURS_send_put (const struct GNUNET_HashCode *key,
const void *data, size_t data_size,
enum GNUNET_BLOCK_Type block_type,
enum GNUNET_DHT_RouteOption options,
uint32_t desired_replication_level,
struct GNUNET_TIME_Absolute expiration_time,
struct GNUNET_PeerIdentity current_destination,
struct GNUNET_PeerIdentity current_source,
struct GNUNET_PeerIdentity *target_peer,
uint32_t hop_count,
uint32_t put_path_length,
struct GNUNET_PeerIdentity *put_path);
/** FIXME: by default I keep current_source, and destination as my own id.
* in case we find a finger then we update current_source in the
* find_successor message.
* Construct a Get message and send it to target_peer.
* @param key Key for the content
* @param data Content to store
* @param data_size Size of content @a data in bytes
* @param block_type Type of the block
* @param options Routing options
* @param desired_replication_level Desired replication count
* @param expiration_time When does the content expire
* @param current_destination
* @param current_source
* @param target_peer Peer to which this message will be forwarded.
* @param hop_count Number of hops traversed so far.
* @param put_path_length Total number of peers in @a put_path
* @param put_path Number of peers traversed so far
*/
void
GDS_NEIGHBOURS_send_get (const struct GNUNET_HashCode *key,
enum GNUNET_BLOCK_Type block_type,
enum GNUNET_DHT_RouteOption options,
uint32_t desired_replication_level,
struct GNUNET_PeerIdentity current_destination,
struct GNUNET_PeerIdentity current_source,
struct GNUNET_PeerIdentity *target_peer,
uint32_t hop_count,
uint32_t get_path_length,
struct GNUNET_PeerIdentity *get_path);
/**
* Send the get result to requesting client.
* @param expiration When will this result expire?
* @param key Key of the requested data.
* @param put_path_length Number of peers in @a put_path
* @param put_path Path taken to put the data at its stored location.
* @param type Block type
* @param data_size Size of the @a data
* @param data Payload to store
* @param get_path Path taken to reach to the location of the key.
* @param get_path_length Number of peers in @a get_path
* @param current_get_path_index Index in get_path
* @param next_hop Next peer to forward the message to.
* @param source_peer Peer which has the data for the key.
*/
/* FIXME: Remove redundant arguments
* 1.remove get_path_index from message and just look up into the get path
for your location and get the next peer.
* 2. Remove next_hop, source_peer */
void
GDS_NEIGHBOURS_send_get_result (struct GNUNET_TIME_Absolute expiration,
const struct GNUNET_HashCode *key,
unsigned int put_path_length,
const struct GNUNET_PeerIdentity *put_path,
enum GNUNET_BLOCK_Type type, size_t data_size,
const void *data,
struct GNUNET_PeerIdentity *get_path,
unsigned int get_path_length,
struct GNUNET_PeerIdentity *next_hop,
struct GNUNET_PeerIdentity *source_peer);
/**
* Initialize neighbours subsystem.
*
* @return #GNUNET_OK on success,
* #GNUNET_SYSERR on error
*/
int
GDS_NEIGHBOURS_init (void);
/**
* Shutdown neighbours subsystem.
*/
void
GDS_NEIGHBOURS_done (void);
/**
* Get my identity
*
* @return my identity
*/
struct GNUNET_PeerIdentity
GDS_NEIGHBOURS_get_my_id (void);
#endif
|
