GNUnet  0.17.6
Macros | Functions | Variables
gnunet-dht-get.c File Reference

search for data in DHT More...

#include "platform.h"
#include "gnunet_dht_service.h"
Include dependency graph for gnunet-dht-get.c:

Go to the source code of this file.

Macros

#define LOG(kind, ...)   GNUNET_log_from (kind, "dht-clients", __VA_ARGS__)
 

Functions

static void cleanup_task (void *cls)
 Task run to clean up on shutdown. More...
 
static void timeout_task (void *cls)
 Task run on timeout. More...
 
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. More...
 
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. More...
 
int main (int argc, char *const *argv)
 Entry point for gnunet-dht-get. More...
 

Variables

static unsigned int query_type
 The type of the query. More...
 
static unsigned int replication = 5
 Desired replication level. More...
 
static char * query_key
 The key for the query. More...
 
static struct GNUNET_TIME_Relative timeout_request = { 60000 }
 User supplied timeout value. More...
 
static unsigned int verbose
 Be verbose. More...
 
static int demultixplex_everywhere
 Use DHT demultixplex_everywhere. More...
 
static int record_route
 Use GNUNET_DHT_RO_RECORD_ROUTE. More...
 
static struct GNUNET_DHT_Handledht_handle
 Handle to the DHT. More...
 
static const struct GNUNET_CONFIGURATION_Handlecfg
 Global handle of the configuration. More...
 
static struct GNUNET_DHT_GetHandleget_handle
 Handle for the get request. More...
 
static unsigned int result_count
 Count of results found. More...
 
static int ret
 Global status value. More...
 
static struct GNUNET_SCHEDULER_Tasktt
 Task scheduled to handle timeout. More...
 

Detailed Description

search for data in DHT

Author
Christian Grothoff
Nathan Evans

Definition in file gnunet-dht-get.c.

Macro Definition Documentation

◆ LOG

#define LOG (   kind,
  ... 
)    GNUNET_log_from (kind, "dht-clients", __VA_ARGS__)

Definition at line 29 of file gnunet-dht-get.c.

Function Documentation

◆ cleanup_task()

static void cleanup_task ( void *  cls)
static

Task run to clean up on shutdown.

Parameters
clsunused

Definition at line 102 of file gnunet-dht-get.c.

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 }
static struct GNUNET_DHT_Handle * dht_handle
Handle to the DHT.
static struct GNUNET_SCHEDULER_Task * tt
Task scheduled to handle timeout.
static struct GNUNET_DHT_GetHandle * get_handle
Handle for the get request.
void GNUNET_DHT_get_stop(struct GNUNET_DHT_GetHandle *get_handle)
Stop async DHT-get.
Definition: dht_api.c:1237
void GNUNET_DHT_disconnect(struct GNUNET_DHT_Handle *handle)
Shutdown connection with the DHT service.
Definition: dht_api.c:1062
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:957

References dht_handle, get_handle, GNUNET_DHT_disconnect(), GNUNET_DHT_get_stop(), GNUNET_SCHEDULER_cancel(), and tt.

Referenced by run().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ timeout_task()

static void timeout_task ( void *  cls)
static

Task run on timeout.

Triggers shutdown.

Parameters
clsunused

Definition at line 128 of file gnunet-dht-get.c.

129 {
130  tt = NULL;
132 }
void GNUNET_SCHEDULER_shutdown(void)
Request the shutdown of a scheduler.
Definition: scheduler.c:533

References GNUNET_SCHEDULER_shutdown(), and tt.

Referenced by run().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ get_result_iterator()

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 
)
static

Iterator called on each result obtained for a DHT operation that expects a reply.

Parameters
clsclosure
expwhen will this value expire
keykey of the result
trunc_peerpeer at which the path was truncated, or NULL if not
get_pathpeers on reply path (or NULL if not recorded)
get_path_lengthnumber of entries in get_path
put_pathpeers on the PUT path (or NULL if not recorded)
put_path_lengthnumber of entries in get_path
typetype of the result
sizenumber of bytes in data
datapointer to the result data

Definition at line 152 of file gnunet-dht-get.c.

163 {
164  fprintf (stdout,
166  ? _ ("Result %d, type %d:\n%.*s\n")
167  : _ ("Result %d, type %d:\n"),
168  result_count,
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 }
static unsigned int verbose
Be verbose.
static unsigned int result_count
Count of results found.
static const struct GNUNET_CONFIGURATION_Handle * cfg
Global handle of the configuration.
static int record_route
Use GNUNET_DHT_RO_RECORD_ROUTE.
uint32_t data
The data value.
static struct GNUNET_PeerIdentity my_identity
Identity of this peer.
@ GNUNET_BLOCK_TYPE_TEST
Block for testing.
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.
unsigned int GNUNET_DHT_verify_path(const void *data, size_t data_size, struct GNUNET_TIME_Absolute exp_time, const struct GNUNET_PeerIdentity *bpid, 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:1353
@ GNUNET_OK
Definition: gnunet_common.h:99
const char * GNUNET_i2s(const struct GNUNET_PeerIdentity *pid)
Convert a peer identity 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.
static unsigned int size
Size of the "table".
Definition: peer.c:67
#define _(String)
GNU gettext support macro.
Definition: platform.h:177
The identity of the host (wraps the signing key of the peer).
enum GNUNET_TESTBED_UnderlayLinkModelType type
the type of this model

References _, cfg, data, GNUNET_BLOCK_TYPE_TEST, GNUNET_break, GNUNET_CRYPTO_get_peer_identity(), GNUNET_DHT_verify_path(), GNUNET_i2s(), GNUNET_OK, my_identity, record_route, result_count, size, type, and verbose.

Referenced by run().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ run()

static void run ( void *  cls,
char *const *  args,
const char *  cfgfile,
const struct GNUNET_CONFIGURATION_Handle c 
)
static

Main function that will be run by the scheduler.

Parameters
clsclosure
argsremaining command-line arguments
cfgfilename of the configuration file used (for saving, can be NULL!)
cconfiguration

Definition at line 225 of file gnunet-dht-get.c.

229 {
230  struct GNUNET_HashCode key;
231  enum GNUNET_DHT_RouteOption ro;
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"),
257  GNUNET_h2s_full (&key));
260  ro = GNUNET_DHT_RO_NONE;
263  if (record_route)
266  query_type,
267  &key,
268  replication,
269  ro,
270  NULL,
271  0,
273  NULL);
274 }
static unsigned int query_type
The type of the query.
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 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 unsigned int replication
Desired replication level.
static int demultixplex_everywhere
Use DHT demultixplex_everywhere.
struct GNUNET_HashCode key
The key used in the DHT.
@ GNUNET_BLOCK_TYPE_ANY
Identifier for any block.
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:1039
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:1164
@ 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...
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
const char * GNUNET_h2s_full(const struct GNUNET_HashCode *hc)
Convert a hash value to a string (for printing debug messages).
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:1316
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:1254
A 512-bit hashcode.

References _, cfg, cleanup_task(), demultixplex_everywhere, dht_handle, get_handle, get_result_iterator(), GNUNET_BLOCK_TYPE_ANY, GNUNET_BLOCK_TYPE_TEST, GNUNET_CRYPTO_hash(), GNUNET_DHT_connect(), GNUNET_DHT_get_start(), GNUNET_DHT_RO_DEMULTIPLEX_EVERYWHERE, GNUNET_DHT_RO_NONE, GNUNET_DHT_RO_RECORD_ROUTE, GNUNET_h2s_full(), GNUNET_SCHEDULER_add_delayed(), GNUNET_SCHEDULER_add_shutdown(), key, query_key, query_type, record_route, replication, ret, timeout_request, timeout_task(), tt, and verbose.

Referenced by main().

Here is the call graph for this function:
Here is the caller graph for this function:

◆ main()

int main ( int  argc,
char *const *  argv 
)

Entry point for gnunet-dht-get.

Parameters
argcnumber of arguments from the command line
argvcommand line arguments
Returns
0 ok, 1 on error

Definition at line 285 of file gnunet-dht-get.c.

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?"),
316  &timeout_request),
318  'x',
319  "demultiplex",
320  gettext_noop (
321  "use DHT's demultiplex everywhere option"),
325  };
326 
327 
328  if (GNUNET_OK !=
329  GNUNET_STRINGS_get_utf8_args (argc, argv,
330  &argc, &argv))
331  return 2;
332  return (GNUNET_OK ==
334  argc,
335  argv,
336  "gnunet-dht-get",
337  gettext_noop (
338  "Issue a GET request to the GNUnet DHT, prints results."),
339  options,
340  &run,
341  NULL))
342  ? ret
343  : 1;
344 }
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:69
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.
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.
enum GNUNET_GenericReturnValue GNUNET_PROGRAM_run(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:399
enum GNUNET_GenericReturnValue GNUNET_STRINGS_get_utf8_args(int argc, char *const *argv, int *u8argc, char *const **u8argv)
Returns utf-8 encoded arguments.
Definition: strings.c:1223
Definition of a command line option.

References demultixplex_everywhere, gettext_noop, GNUNET_GETOPT_OPTION_END, GNUNET_GETOPT_option_flag(), GNUNET_GETOPT_option_relative_time(), GNUNET_GETOPT_option_string(), GNUNET_GETOPT_option_uint(), GNUNET_GETOPT_option_verbose(), GNUNET_OK, GNUNET_PROGRAM_run(), GNUNET_STRINGS_get_utf8_args(), options, query_key, query_type, record_route, replication, ret, run(), timeout_request, and verbose.

Here is the call graph for this function:

Variable Documentation

◆ query_type

unsigned int query_type
static

The type of the query.

Definition at line 33 of file gnunet-dht-get.c.

Referenced by main(), and run().

◆ replication

unsigned int replication = 5
static

Desired replication level.

Definition at line 38 of file gnunet-dht-get.c.

Referenced by main(), and run().

◆ query_key

char* query_key
static

The key for the query.

Definition at line 43 of file gnunet-dht-get.c.

Referenced by main(), and run().

◆ timeout_request

struct GNUNET_TIME_Relative timeout_request = { 60000 }
static

User supplied timeout value.

Definition at line 43 of file gnunet-dht-get.c.

Referenced by main(), and run().

◆ verbose

unsigned int verbose
static

Be verbose.

Definition at line 53 of file gnunet-dht-get.c.

Referenced by get_result_iterator(), main(), and run().

◆ demultixplex_everywhere

int demultixplex_everywhere
static

Use DHT demultixplex_everywhere.

Definition at line 58 of file gnunet-dht-get.c.

Referenced by main(), and run().

◆ record_route

int record_route
static

Use GNUNET_DHT_RO_RECORD_ROUTE.

Definition at line 63 of file gnunet-dht-get.c.

Referenced by get_result_iterator(), main(), and run().

◆ dht_handle

struct GNUNET_DHT_Handle* dht_handle
static

Handle to the DHT.

Definition at line 68 of file gnunet-dht-get.c.

Referenced by cleanup_task(), and run().

◆ cfg

const struct GNUNET_CONFIGURATION_Handle* cfg
static

Global handle of the configuration.

Definition at line 73 of file gnunet-dht-get.c.

Referenced by get_result_iterator(), and run().

◆ get_handle

struct GNUNET_DHT_GetHandle* get_handle
static

Handle for the get request.

Definition at line 78 of file gnunet-dht-get.c.

Referenced by cleanup_task(), get_result_iterator(), GNUNET_DHT_get_filter_known_results(), GNUNET_DHT_get_stop(), and run().

◆ result_count

unsigned int result_count
static

Count of results found.

Definition at line 83 of file gnunet-dht-get.c.

Referenced by get_result_iterator().

◆ ret

int ret
static

Global status value.

Definition at line 88 of file gnunet-dht-get.c.

Referenced by main(), and run().

◆ tt

struct GNUNET_SCHEDULER_Task* tt
static

Task scheduled to handle timeout.

Definition at line 93 of file gnunet-dht-get.c.

Referenced by cleanup_task(), run(), and timeout_task().