GNUnet 0.22.2
gnunet-dht-get.c
Go to the documentation of this file.
1/*
2 This file is part of GNUnet.
3 Copyright (C) 2001, 2002, 2004, 2005, 2006, 2007, 2009, 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"
27#include "gnunet_dht_service.h"
28
29#define LOG(kind, ...) GNUNET_log_from (kind, "dht-clients", __VA_ARGS__)
33static unsigned int query_type;
34
38static unsigned int replication = 5;
39
43static char *query_key;
44
48static struct GNUNET_TIME_Relative timeout_request = { 60000 };
49
53static unsigned int verbose;
54
59
63static int record_route;
64
69
73static const struct GNUNET_CONFIGURATION_Handle *cfg;
74
79
83static unsigned int result_count;
84
88static int ret;
89
94
95
101static void
102cleanup_task (void *cls)
103{
104 if (NULL != get_handle)
105 {
107 get_handle = NULL;
108 }
109 if (NULL != dht_handle)
110 {
112 dht_handle = NULL;
113 }
114 if (NULL != tt)
115 {
117 tt = NULL;
118 }
119}
120
121
127static void
128timeout_task (void *cls)
129{
130 tt = NULL;
132}
133
134
151static void
153 struct GNUNET_TIME_Absolute exp,
154 const struct GNUNET_HashCode *key,
155 const struct GNUNET_PeerIdentity *trunc_peer,
156 const struct GNUNET_DHT_PathElement *get_path,
157 unsigned int get_path_length,
158 const struct GNUNET_DHT_PathElement *put_path,
159 unsigned int put_path_length,
161 size_t size,
162 const void *data)
163{
164 fprintf (stdout,
166 ? _ ("Result %d, type %d:\n%.*s\n")
167 : _ ("Result %d, type %d:\n"),
169 type,
170 (int) size,
171 (char *) data);
172 if (record_route && verbose)
173 {
174 {
176
179 &my_identity));
180 GNUNET_break (0 ==
182 size,
183 exp,
184 trunc_peer,
185 put_path,
186 put_path_length,
187 get_path,
188 get_path_length,
189 &my_identity));
190 }
191 fprintf (stdout,
192 " GET path: ");
193 for (unsigned int i = 0; i < get_path_length; i++)
194 fprintf (stdout,
195 "%s%s",
196 (0 == i) ? "" : "-",
197 GNUNET_i2s (&get_path[i].pred));
198 fprintf (stdout,
199 "\n PUT path: ");
200 for (unsigned int i = 0; i < put_path_length; i++)
201 fprintf (stdout,
202 "%s%s",
203 (0 == i) ? "" : "-",
204 GNUNET_i2s (&put_path[i].pred));
205 if (NULL != trunc_peer)
206 fprintf (stdout,
207 "!%s",
208 GNUNET_i2s (trunc_peer));
209 fprintf (stdout,
210 "\n");
211 }
212 result_count++;
213}
214
215
224static void
225run (void *cls,
226 char *const *args,
227 const char *cfgfile,
228 const struct GNUNET_CONFIGURATION_Handle *c)
229{
230 struct GNUNET_HashCode key;
232
233 cfg = c;
234 if (NULL == query_key)
235 {
236 fprintf (stderr,
237 "%s",
238 _ ("Must provide key for DHT GET!\n"));
239 ret = 1;
240 return;
241 }
242 if (NULL == (dht_handle = GNUNET_DHT_connect (cfg, 1)))
243 {
244 fprintf (stderr,
245 "%s",
246 _ ("Failed to connect to DHT service!\n"));
247 ret = 1;
248 return;
249 }
250 if (query_type == GNUNET_BLOCK_TYPE_ANY) /* Type of data not set */
253 if (verbose)
254 fprintf (stderr,
255 "%s `%s' \n",
256 _ ("Issuing DHT GET with key"),
263 if (record_route)
267 &key,
269 ro,
270 NULL,
271 0,
273 NULL);
274}
275
276
284int
285main (int argc, char *const *argv)
286{
289 'k',
290 "key",
291 "KEY",
292 gettext_noop ("the query key"),
293 &query_key),
295 'r',
296 "replication",
297 "LEVEL",
298 gettext_noop ("how many parallel requests (replicas) to create"),
299 &replication),
301 'R',
302 "record",
303 gettext_noop ("use DHT's record route option"),
304 &record_route),
306 't',
307 "type",
308 "TYPE",
309 gettext_noop ("the type of data to look for"),
310 &query_type),
312 'T',
313 "timeout",
314 "TIMEOUT",
315 gettext_noop ("how long to execute this query before giving up?"),
318 'x',
319 "demultiplex",
321 "use DHT's demultiplex everywhere option"),
325 };
326
327
328 ret = (GNUNET_OK ==
331 argc,
332 argv,
333 "gnunet-dht-get",
335 "Issue a GET request to the GNUnet DHT, prints results."),
336 options,
337 &run,
338 NULL))
339 ? ret
340 : 1;
341 return ret;
342}
343
344
345/* end of gnunet-dht-get.c */
struct GNUNET_GETOPT_CommandLineOption GNUNET_GETOPT_OPTION_END
Definition: 002.c:13
struct GNUNET_GETOPT_CommandLineOption options[]
Definition: 002.c:5
#define gettext_noop(String)
Definition: gettext.h:74
struct GNUNET_PeerIdentity my_identity
Our peer identity.
static unsigned int query_type
The type of the query.
static unsigned int verbose
Be verbose.
static struct GNUNET_TIME_Relative timeout_request
User supplied timeout value.
static void get_result_iterator(void *cls, struct GNUNET_TIME_Absolute exp, const struct GNUNET_HashCode *key, const struct GNUNET_PeerIdentity *trunc_peer, const struct GNUNET_DHT_PathElement *get_path, unsigned int get_path_length, const struct GNUNET_DHT_PathElement *put_path, unsigned int put_path_length, enum GNUNET_BLOCK_Type type, size_t size, const void *data)
Iterator called on each result obtained for a DHT operation that expects a reply.
static void timeout_task(void *cls)
Task run on timeout.
static unsigned int result_count
Count of results found.
static const struct GNUNET_CONFIGURATION_Handle * cfg
Global handle of the configuration.
static void cleanup_task(void *cls)
Task run to clean up on shutdown.
static int ret
Global status value.
static char * query_key
The key for the query.
static struct GNUNET_DHT_Handle * dht_handle
Handle to the DHT.
static struct GNUNET_SCHEDULER_Task * tt
Task scheduled to handle timeout.
static void run(void *cls, char *const *args, const char *cfgfile, const struct GNUNET_CONFIGURATION_Handle *c)
Main function that will be run by the scheduler.
static unsigned int replication
Desired replication level.
static struct GNUNET_DHT_GetHandle * get_handle
Handle for the get request.
static int demultixplex_everywhere
Use DHT demultixplex_everywhere.
int main(int argc, char *const *argv)
Entry point for gnunet-dht-get.
static int record_route
Use GNUNET_DHT_RO_RECORD_ROUTE.
static char * data
The data to insert into the dht.
struct GNUNET_HashCode key
The key used in the DHT.
static uint32_t type
Type string converted to DNS type value.
GNUNET_BLOCK_Type
WARNING: This header is generated! In order to add DHT block types, you must register them in GANA,...
@ GNUNET_BLOCK_TYPE_TEST
Block for testing.
@ GNUNET_BLOCK_TYPE_ANY
Identifier for any block.
API to the DHT service.
enum GNUNET_GenericReturnValue GNUNET_CRYPTO_get_peer_identity(const struct GNUNET_CONFIGURATION_Handle *cfg, struct GNUNET_PeerIdentity *dst)
Retrieve the identity of the host's peer.
GNUNET_DHT_RouteOption
Options for routing.
struct GNUNET_DHT_Handle * GNUNET_DHT_connect(const struct GNUNET_CONFIGURATION_Handle *cfg, unsigned int ht_len)
Initialize the connection with the DHT service.
Definition: dht_api.c:1030
void GNUNET_DHT_get_stop(struct GNUNET_DHT_GetHandle *get_handle)
Stop async DHT-get.
Definition: dht_api.c:1233
struct GNUNET_DHT_GetHandle * GNUNET_DHT_get_start(struct GNUNET_DHT_Handle *handle, enum GNUNET_BLOCK_Type type, const struct GNUNET_HashCode *key, uint32_t desired_replication_level, enum GNUNET_DHT_RouteOption options, const void *xquery, size_t xquery_size, GNUNET_DHT_GetIterator iter, void *iter_cls)
Perform an asynchronous GET operation on the DHT identified.
Definition: dht_api.c:1160
void GNUNET_DHT_disconnect(struct GNUNET_DHT_Handle *handle)
Shutdown connection with the DHT service.
Definition: dht_api.c:1053
unsigned int GNUNET_DHT_verify_path(const void *data, size_t data_size, struct GNUNET_TIME_Absolute exp_time, const struct GNUNET_PeerIdentity *trunc_peer, const struct GNUNET_DHT_PathElement *put_path, unsigned int put_path_len, const struct GNUNET_DHT_PathElement *get_path, unsigned int get_path_len, const struct GNUNET_PeerIdentity *me)
Verify signatures on a path consisting of put_path and get_path in reverse order (starting at the las...
Definition: dht_api.c:1349
@ GNUNET_DHT_RO_NONE
Default.
@ GNUNET_DHT_RO_RECORD_ROUTE
We should keep track of the route that the message took in the P2P network.
@ GNUNET_DHT_RO_DEMULTIPLEX_EVERYWHERE
Each peer along the way should process the request (otherwise only peers locally closest to the key w...
struct GNUNET_GETOPT_CommandLineOption GNUNET_GETOPT_option_uint(char shortName, const char *name, const char *argumentHelp, const char *description, unsigned int *val)
Allow user to specify an unsigned int.
struct GNUNET_GETOPT_CommandLineOption GNUNET_GETOPT_option_relative_time(char shortName, const char *name, const char *argumentHelp, const char *description, struct GNUNET_TIME_Relative *val)
Allow user to specify a struct GNUNET_TIME_Relative (using human-readable "fancy" time).
struct GNUNET_GETOPT_CommandLineOption GNUNET_GETOPT_option_verbose(unsigned int *level)
Define the '-V' verbosity option.
struct GNUNET_GETOPT_CommandLineOption GNUNET_GETOPT_option_flag(char shortName, const char *name, const char *description, int *val)
Allow user to specify a flag (which internally means setting an integer to 1/GNUNET_YES/GNUNET_OK.
struct GNUNET_GETOPT_CommandLineOption GNUNET_GETOPT_option_string(char shortName, const char *name, const char *argumentHelp, const char *description, char **str)
Allow user to specify a string.
void GNUNET_CRYPTO_hash(const void *block, size_t size, struct GNUNET_HashCode *ret)
Compute hash of a given block.
Definition: crypto_hash.c:41
@ GNUNET_OK
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity to a string (for printing debug messages).
const char * GNUNET_h2s_full(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
#define GNUNET_break(cond)
Use this for internal assertion violations that are not fatal (can be handled) but should not occur.
const struct GNUNET_OS_ProjectData * GNUNET_OS_project_data_gnunet(void)
Return default project data used by 'libgnunetutil' for GNUnet.
enum GNUNET_GenericReturnValue GNUNET_PROGRAM_run(const struct GNUNET_OS_ProjectData *pd, int argc, char *const *argv, const char *binaryName, const char *binaryHelp, const struct GNUNET_GETOPT_CommandLineOption *options, GNUNET_PROGRAM_Main task, void *task_cls)
Run a standard GNUnet command startup sequence (initialize loggers and configuration,...
Definition: program.c:407
void GNUNET_SCHEDULER_shutdown(void)
Request the shutdown of a scheduler.
Definition: scheduler.c:567
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_shutdown(GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run on shutdown, that is when a CTRL-C signal is received,...
Definition: scheduler.c:1339
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:980
struct GNUNET_SCHEDULER_Task * GNUNET_SCHEDULER_add_delayed(struct GNUNET_TIME_Relative delay, GNUNET_SCHEDULER_TaskCallback task, void *task_cls)
Schedule a new task to be run with a specified delay.
Definition: scheduler.c:1277
static unsigned int size
Size of the "table".
Definition: peer.c:68
#define _(String)
GNU gettext support macro.
Definition: platform.h:179
Handle to a GET request.
Definition: dht_api.c:79
Connection to the DHT service.
Definition: dht_api.c:235
A (signed) path tracking a block's flow through the DHT is represented by an array of path elements,...
Definition of a command line option.
A 512-bit hashcode.
The identity of the host (wraps the signing key of the peer).
Entry in list of pending tasks.
Definition: scheduler.c:136
Time for absolute times used by GNUnet, in microseconds.
Time for relative time used by GNUnet, in microseconds.