2 This file is part of GNUnet.
3 Copyright (C) 2001, 2002, 2004, 2005, 2006, 2007, 2009 GNUnet e.V.
5 GNUnet is free software; you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published
7 by the Free Software Foundation; either version 3, or (at your
8 option) any later version.
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 General Public License for more details.
15 You should have received a copy of the GNU General Public License
16 along with GNUnet; see the file COPYING. If not, write to the
17 Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
18 Boston, MA 02110-1301, USA.
21 * @file dht/gnunet-dht-get.c
22 * @brief search for data in DHT
23 * @author Christian Grothoff
24 * @author Nathan Evans
27 #include "gnunet_dht_service.h"
29 #define LOG(kind,...) GNUNET_log_from (kind, "dht-clients",__VA_ARGS__)
31 * The type of the query
33 static unsigned int query_type;
36 * Desired replication level
38 static unsigned int replication = 5;
41 * The key for the query
43 static char *query_key;
46 * User supplied timeout value
48 static struct GNUNET_TIME_Relative timeout_request = { 60000 };
56 * Use DHT demultixplex_everywhere
58 static int demultixplex_everywhere;
63 static struct GNUNET_DHT_Handle *dht_handle;
66 * Global handle of the configuration
68 static const struct GNUNET_CONFIGURATION_Handle *cfg;
71 * Handle for the get request
73 static struct GNUNET_DHT_GetHandle *get_handle;
76 * Count of results found
78 static unsigned int result_count;
86 * Task scheduled to handle timeout.
88 static struct GNUNET_SCHEDULER_Task *tt;
92 * Task run to clean up on shutdown.
97 cleanup_task (void *cls)
99 if (NULL != get_handle)
101 GNUNET_DHT_get_stop (get_handle);
104 if (NULL != dht_handle)
106 GNUNET_DHT_disconnect (dht_handle);
111 GNUNET_SCHEDULER_cancel (tt);
118 * Task run on timeout. Triggers shutdown.
123 timeout_task (void *cls)
126 GNUNET_SCHEDULER_shutdown ();
131 * Iterator called on each result obtained for a DHT
132 * operation that expects a reply
135 * @param exp when will this value expire
136 * @param key key of the result
137 * @param get_path peers on reply path (or NULL if not recorded)
138 * @param get_path_length number of entries in get_path
139 * @param put_path peers on the PUT path (or NULL if not recorded)
140 * @param put_path_length number of entries in get_path
141 * @param type type of the result
142 * @param size number of bytes in data
143 * @param data pointer to the result data
146 get_result_iterator (void *cls, struct GNUNET_TIME_Absolute exp,
147 const struct GNUNET_HashCode * key,
148 const struct GNUNET_PeerIdentity *get_path,
149 unsigned int get_path_length,
150 const struct GNUNET_PeerIdentity *put_path,
151 unsigned int put_path_length,
152 enum GNUNET_BLOCK_Type type,
157 _("Result %d, type %d:\n%.*s\n"),
166 for (unsigned int i=0;i<get_path_length;i++)
170 GNUNET_i2s (&get_path[i]));
173 for (unsigned int i=0;i<put_path_length;i++)
177 GNUNET_i2s (&put_path[i]));
186 * Main function that will be run by the scheduler.
189 * @param args remaining command-line arguments
190 * @param cfgfile name of the configuration file used (for saving, can be NULL!)
191 * @param c configuration
194 run (void *cls, char *const *args, const char *cfgfile,
195 const struct GNUNET_CONFIGURATION_Handle *c)
197 struct GNUNET_HashCode key;
202 if (NULL == query_key)
204 FPRINTF (stderr, "%s", _("Must provide key for DHT GET!\n"));
208 if (NULL == (dht_handle = GNUNET_DHT_connect (cfg, 1)))
210 FPRINTF (stderr, "%s", _("Failed to connect to DHT service!\n"));
214 if (query_type == GNUNET_BLOCK_TYPE_ANY) /* Type of data not set */
215 query_type = GNUNET_BLOCK_TYPE_TEST;
216 GNUNET_CRYPTO_hash (query_key, strlen (query_key), &key);
218 FPRINTF (stderr, "%s `%s' \n", _("Issueing DHT GET with key"), GNUNET_h2s_full (&key));
219 GNUNET_SCHEDULER_add_shutdown (&cleanup_task, NULL);
220 tt = GNUNET_SCHEDULER_add_delayed (timeout_request,
221 &timeout_task, NULL);
223 GNUNET_DHT_get_start (dht_handle, query_type, &key, replication,
224 (demultixplex_everywhere) ? GNUNET_DHT_RO_DEMULTIPLEX_EVERYWHERE : GNUNET_DHT_RO_NONE,
225 NULL, 0, &get_result_iterator, NULL);
231 * gnunet-dht-get command line options
233 static struct GNUNET_GETOPT_CommandLineOption options[] = {
235 gettext_noop ("the query key"),
236 1, &GNUNET_GETOPT_set_string, &query_key},
237 {'r', "replication", "LEVEL",
238 gettext_noop ("how many parallel requests (replicas) to create"),
239 1, &GNUNET_GETOPT_set_uint, &replication},
240 {'t', "type", "TYPE",
241 gettext_noop ("the type of data to look for"),
242 1, &GNUNET_GETOPT_set_uint, &query_type},
243 {'T', "timeout", "TIMEOUT",
244 gettext_noop ("how long to execute this query before giving up?"),
245 1, &GNUNET_GETOPT_set_relative_time, &timeout_request},
246 {'x', "demultiplex", NULL,
247 gettext_noop ("use DHT's demultiplex everywhere option"),
248 0, &GNUNET_GETOPT_set_one, &demultixplex_everywhere},
249 {'V', "verbose", NULL,
250 gettext_noop ("be verbose (print progress information)"),
251 0, &GNUNET_GETOPT_set_one, &verbose},
252 GNUNET_GETOPT_OPTION_END
257 * Entry point for gnunet-dht-get
259 * @param argc number of arguments from the command line
260 * @param argv command line arguments
261 * @return 0 ok, 1 on error
264 main (int argc, char *const *argv)
266 if (GNUNET_OK != GNUNET_STRINGS_get_utf8_args (argc, argv, &argc, &argv))
269 GNUNET_PROGRAM_run (argc, argv, "gnunet-dht-get",
271 ("Issue a GET request to the GNUnet DHT, prints results."),
272 options, &run, NULL)) ? ret : 1;
275 /* end of gnunet-dht-get.c */