GNUnet  0.11.x
Functions | Variables
gnunet-gns.c File Reference

binary version of gnunet-gns-import.sh (for OSes that have no POSIX shell). More...

#include "platform.h"
#include <gnunet_util_lib.h>
#include <gnunet_dnsparser_lib.h>
#include <gnunet_gnsrecord_lib.h>
#include <gnunet_namestore_service.h>
#include <gnunet_gns_service.h>
Include dependency graph for gnunet-gns.c:

Go to the source code of this file.

Functions

static void do_shutdown (void *cls)
 Task run on shutdown. More...
 
static void do_timeout (void *cls)
 Task to run on timeout. More...
 
static void process_lookup_result (void *cls, int was_gns, uint32_t rd_count, const struct GNUNET_GNSRECORD_Data *rd)
 Function called with the result of a GNS lookup. More...
 
static void run (void *cls, char *const *args, const char *cfgfile, const struct GNUNET_CONFIGURATION_Handle *c)
 Main function that will be run. More...
 
int main (int argc, char *const *argv)
 The main function for gnunet-gns. More...
 

Variables

static const struct GNUNET_CONFIGURATION_Handlecfg
 Configuration we are using. More...
 
static struct GNUNET_GNS_Handlegns
 Handle to GNS service. More...
 
static char * lookup_name
 GNS name to lookup. More...
 
static char * lookup_type
 record type to look up (-t option) More...
 
static int raw
 raw output More...
 
static uint32_t rtype
 Desired record type. More...
 
static struct GNUNET_TIME_Relative timeout
 Timeout for lookup. More...
 
static struct GNUNET_SCHEDULER_Taskto_task
 Timeout task. More...
 
static struct GNUNET_GNS_LookupWithTldRequestlr
 Handle to lookup request. More...
 
static int global_ret
 Global return value. More...
 

Detailed Description

binary version of gnunet-gns-import.sh (for OSes that have no POSIX shell).

command line tool to access distributed GNS

Author
LRN
Christian Grothoff

Definition in file gnunet-gns.c.

Function Documentation

◆ do_shutdown()

static void do_shutdown ( void *  cls)
static

Task run on shutdown.

Cleans up everything.

Parameters
clsunused

Definition at line 93 of file gnunet-gns.c.

References GNUNET_GNS_disconnect(), GNUNET_GNS_lookup_with_tld_cancel(), and GNUNET_SCHEDULER_cancel().

Referenced by run().

94 {
95  (void) cls;
96  if (NULL != to_task)
97  {
99  to_task = NULL;
100  }
101  if (NULL != lr)
102  {
104  lr = NULL;
105  }
106  if (NULL != gns)
107  {
109  gns = NULL;
110  }
111 }
static struct GNUNET_GNS_LookupWithTldRequest * lr
Handle to lookup request.
Definition: gnunet-gns.c:75
void * GNUNET_GNS_lookup_with_tld_cancel(struct GNUNET_GNS_LookupWithTldRequest *ltr)
Cancel pending lookup request.
Definition: gns_tld_api.c:329
static struct GNUNET_GNS_Handle * gns
Handle to GNS service.
Definition: gnunet-gns.c:40
void GNUNET_GNS_disconnect(struct GNUNET_GNS_Handle *handle)
Shutdown connection with the GNS service.
Definition: gns_api.c:284
static struct GNUNET_SCHEDULER_Task * to_task
Timeout task.
Definition: gnunet-gns.c:70
void * GNUNET_SCHEDULER_cancel(struct GNUNET_SCHEDULER_Task *task)
Cancel the task with the specified identifier.
Definition: scheduler.c:966
Here is the call graph for this function:
Here is the caller graph for this function:

◆ do_timeout()

static void do_timeout ( void *  cls)
static

Task to run on timeout.

Parameters
clsunused

Definition at line 120 of file gnunet-gns.c.

References global_ret, and GNUNET_SCHEDULER_shutdown().

Referenced by run().

121 {
122  to_task = NULL;
123  global_ret = 3; // Timeout
125 }
void GNUNET_SCHEDULER_shutdown(void)
Request the shutdown of a scheduler.
Definition: scheduler.c:526
static struct GNUNET_SCHEDULER_Task * to_task
Timeout task.
Definition: gnunet-gns.c:70
static int global_ret
Global return value.
Definition: gnunet-gns.c:84
Here is the call graph for this function:
Here is the caller graph for this function:

◆ process_lookup_result()

static void process_lookup_result ( void *  cls,
int  was_gns,
uint32_t  rd_count,
const struct GNUNET_GNSRECORD_Data rd 
)
static

Function called with the result of a GNS lookup.

Parameters
clsthe 'const char *' name that was resolved
was_gnsGNUNET_NO if TLD did not indicate use of GNS
rd_countnumber of records returned
rdarray of rd_count records with the results

Definition at line 137 of file gnunet-gns.c.

References data, data_size, global_ret, GNUNET_free, GNUNET_GNSRECORD_number_to_typename(), GNUNET_GNSRECORD_TYPE_ANY, GNUNET_GNSRECORD_value_to_string(), GNUNET_NO, GNUNET_SCHEDULER_shutdown(), name, raw, and rtype.

Referenced by run().

141 {
142  const char *name = cls;
143  const char *typename;
144  char *string_val;
145 
146  lr = NULL;
147  if (GNUNET_NO == was_gns)
148  {
149  global_ret = 4; /* not for GNS */
151  return;
152  }
153  if (! raw)
154  {
155  if (0 == rd_count)
156  printf ("No results.\n");
157  else
158  printf ("%s:\n", name);
159  }
160  for (uint32_t i = 0; i < rd_count; i++)
161  {
162  if ((rd[i].record_type != rtype) && (GNUNET_GNSRECORD_TYPE_ANY != rtype))
163  continue;
164  typename = GNUNET_GNSRECORD_number_to_typename (rd[i].record_type);
165  string_val = GNUNET_GNSRECORD_value_to_string (rd[i].record_type,
166  rd[i].data,
167  rd[i].data_size);
168  if (NULL == string_val)
169  {
170  fprintf (stderr,
171  "Record %u of type %d malformed, skipping\n",
172  (unsigned int) i,
173  (int) rd[i].record_type);
174  continue;
175  }
176  if (raw)
177  printf ("%s\n", string_val);
178  else
179  printf ("Got `%s' record: %s\n", typename, string_val);
180  GNUNET_free (string_val);
181  }
183 }
static int raw
raw output
Definition: gnunet-gns.c:55
static struct GNUNET_GNS_LookupWithTldRequest * lr
Handle to lookup request.
Definition: gnunet-gns.c:75
static size_t data_size
Number of bytes in data.
Definition: gnunet-abd.c:187
#define GNUNET_GNSRECORD_TYPE_ANY
Record type indicating any record/&#39;*&#39;.
#define GNUNET_NO
Definition: gnunet_common.h:78
void GNUNET_SCHEDULER_shutdown(void)
Request the shutdown of a scheduler.
Definition: scheduler.c:526
const char * name
uint32_t data
The data value.
char * GNUNET_GNSRECORD_value_to_string(uint32_t type, const void *data, size_t data_size)
Convert the &#39;value&#39; of a record to a string.
Definition: gnsrecord.c:143
const char * GNUNET_GNSRECORD_number_to_typename(uint32_t type)
Convert a type number (i.e.
Definition: gnsrecord.c:231
static uint32_t rtype
Desired record type.
Definition: gnunet-gns.c:60
#define GNUNET_free(ptr)
Wrapper around free.
static int global_ret
Global return value.
Definition: gnunet-gns.c:84
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.

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

Definition at line 195 of file gnunet-gns.c.

References _, do_shutdown(), do_timeout(), global_ret, GNUNET_CLIENT_test(), GNUNET_DNSPARSER_check_name(), GNUNET_DNSPARSER_TYPE_A, GNUNET_ERROR_TYPE_WARNING, GNUNET_GNS_connect(), GNUNET_GNS_LO_DEFAULT, GNUNET_GNS_lookup_with_tld(), GNUNET_GNSRECORD_TYPE_ANY, GNUNET_GNSRECORD_typename_to_number(), GNUNET_log, GNUNET_OK, GNUNET_SCHEDULER_add_delayed(), GNUNET_SCHEDULER_add_shutdown(), GNUNET_SCHEDULER_shutdown(), GNUNET_YES, lookup_name, lookup_type, process_lookup_result(), rtype, and timeout.

Referenced by main().

199 {
200  (void) cls;
201  (void) args;
202  (void) cfgfile;
203 
204  cfg = c;
205  to_task = NULL;
206  {
207  char *colon;
208 
209  if (NULL != (colon = strchr (lookup_name, ':')))
210  *colon = '\0';
211  }
213  {
214  fprintf (stderr,
215  _ ("`%s' is not a valid domain name\n"),
216  lookup_name);
217  global_ret = 3;
218  return;
219  }
220  if (GNUNET_YES !=
222  "arm"))
223  {
225  _ ("Cannot resolve using GNS: GNUnet peer not running\n"));
226  global_ret = 2;
227  return;
228  }
230  &do_timeout,
231  NULL);
233  if (NULL == gns)
234  {
235  fprintf (stderr,
236  _ ("Failed to connect to GNS\n"));
237  global_ret = 2;
238  return;
239  }
241  NULL);
242  if (NULL != lookup_type)
244  else
246  if (UINT32_MAX == rtype)
247  {
248  fprintf (stderr,
249  _ ("Invalid typename specified, assuming `ANY'\n"));
251  }
253  lookup_name,
254  rtype,
257  lookup_name);
258  if (NULL == lr)
259  {
260  global_ret = 2;
262  return;
263  }
264 }
static struct GNUNET_GNS_LookupWithTldRequest * lr
Handle to lookup request.
Definition: gnunet-gns.c:75
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, or when GNUNET_SCHEDULER_shutdown() is being invoked.
Definition: scheduler.c:1300
uint32_t GNUNET_GNSRECORD_typename_to_number(const char *dns_typename)
Convert a type name (i.e.
Definition: gnsrecord.c:204
#define GNUNET_GNSRECORD_TYPE_ANY
Record type indicating any record/&#39;*&#39;.
struct GNUNET_GNS_LookupWithTldRequest * GNUNET_GNS_lookup_with_tld(struct GNUNET_GNS_Handle *handle, const char *name, uint32_t type, enum GNUNET_GNS_LocalOptions options, GNUNET_GNS_LookupResultProcessor2 proc, void *proc_cls)
Perform an asynchronous lookup operation on the GNS, determining the zone using the TLD of the given ...
Definition: gns_tld_api.c:241
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
void GNUNET_SCHEDULER_shutdown(void)
Request the shutdown of a scheduler.
Definition: scheduler.c:526
#define _(String)
GNU gettext support macro.
Definition: platform.h:181
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:1253
static struct GNUNET_TIME_Relative timeout
Timeout for lookup.
Definition: gnunet-gns.c:65
static struct GNUNET_GNS_Handle * gns
Handle to GNS service.
Definition: gnunet-gns.c:40
struct GNUNET_GNS_Handle * GNUNET_GNS_connect(const struct GNUNET_CONFIGURATION_Handle *cfg)
Initialize the connection with the GNS service.
Definition: gns_api.c:262
static struct GNUNET_SCHEDULER_Task * to_task
Timeout task.
Definition: gnunet-gns.c:70
int GNUNET_CLIENT_test(const struct GNUNET_CONFIGURATION_Handle *cfg, const char *service_name)
Test if the port or UNIXPATH of the given service_name is in use and thus (most likely) the respectiv...
Definition: client.c:892
static void do_shutdown(void *cls)
Task run on shutdown.
Definition: gnunet-gns.c:93
static void do_timeout(void *cls)
Task to run on timeout.
Definition: gnunet-gns.c:120
int GNUNET_DNSPARSER_check_name(const char *name)
Check if a hostname in UTF-8 format can be coded into valid IDNA.
Definition: dnsparser.c:79
static char * lookup_name
GNS name to lookup.
Definition: gnunet-gns.c:45
static void process_lookup_result(void *cls, int was_gns, uint32_t rd_count, const struct GNUNET_GNSRECORD_Data *rd)
Function called with the result of a GNS lookup.
Definition: gnunet-gns.c:137
#define GNUNET_log(kind,...)
#define GNUNET_YES
Definition: gnunet_common.h:77
static const struct GNUNET_CONFIGURATION_Handle * cfg
Configuration we are using.
Definition: gnunet-gns.c:35
Defaults, look in cache, then in DHT.
static uint32_t rtype
Desired record type.
Definition: gnunet-gns.c:60
#define GNUNET_DNSPARSER_TYPE_A
static char * lookup_type
record type to look up (-t option)
Definition: gnunet-gns.c:50
static int global_ret
Global return value.
Definition: gnunet-gns.c:84
Here is the call graph for this function:
Here is the caller graph for this function:

◆ main()

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

The main function for gnunet-gns.

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

Definition at line 275 of file gnunet-gns.c.

References _, gettext_noop, global_ret, GNUNET_free, GNUNET_GETOPT_OPTION_END, GNUNET_GETOPT_option_flag(), GNUNET_GETOPT_option_mandatory(), GNUNET_GETOPT_option_relative_time(), GNUNET_GETOPT_option_string(), GNUNET_log_setup(), GNUNET_OK, GNUNET_PROGRAM_run(), GNUNET_STRINGS_get_utf8_args(), GNUNET_TIME_UNIT_FOREVER_REL, lookup_name, lookup_type, raw, ret, run(), and timeout.

276 {
281  "lookup",
282  "NAME",
283  gettext_noop (
284  "Lookup a record for the given name"),
285  &lookup_name)),
287  "type",
288  "TYPE",
289  gettext_noop (
290  "Specify the type of the record to lookup"),
291  &lookup_type),
293  "timeout",
294  "TIMEOUT",
295  gettext_noop (
296  "Specify a timeout for the lookup"),
297  &timeout),
299  "raw",
300  gettext_noop ("No unneeded output"),
301  &raw),
303  int ret;
304 
305  if (GNUNET_OK !=
306  GNUNET_STRINGS_get_utf8_args (argc, argv,
307  &argc, &argv))
308  return 2;
309 
310  GNUNET_log_setup ("gnunet-gns", "WARNING", NULL);
311  ret = GNUNET_PROGRAM_run (argc,
312  argv,
313  "gnunet-gns",
314  _ ("GNUnet GNS resolver tool"),
315  options,
316  &run,
317  NULL);
318  GNUNET_free ((void *) argv);
319  if (GNUNET_OK != ret)
320  return 1;
321  return global_ret;
322 }
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)...
static void run(void *cls, char *const *args, const char *cfgfile, const struct GNUNET_CONFIGURATION_Handle *c)
Main function that will be run.
Definition: gnunet-gns.c:195
static int raw
raw output
Definition: gnunet-gns.c:55
struct GNUNET_GETOPT_CommandLineOption options[]
Definition: 002.c:5
int GNUNET_STRINGS_get_utf8_args(int argc, char *const *argv, int *u8argc, char *const **u8argv)
Returns utf-8 encoded arguments.
Definition: strings.c:1438
static int ret
Return value of the commandline.
Definition: gnunet-abd.c:81
#define GNUNET_OK
Named constants for return values.
Definition: gnunet_common.h:75
Definition of a command line option.
struct GNUNET_GETOPT_CommandLineOption GNUNET_GETOPT_OPTION_END
Definition: 002.c:13
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.
#define _(String)
GNU gettext support macro.
Definition: platform.h:181
static struct GNUNET_TIME_Relative timeout
Timeout for lookup.
Definition: gnunet-gns.c:65
#define GNUNET_TIME_UNIT_FOREVER_REL
Constant used to specify "forever".
struct GNUNET_GETOPT_CommandLineOption GNUNET_GETOPT_option_mandatory(struct GNUNET_GETOPT_CommandLineOption opt)
Make the given option mandatory.
static char * lookup_name
GNS name to lookup.
Definition: gnunet-gns.c:45
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.
int 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, parse options).
Definition: program.c:367
int GNUNET_log_setup(const char *comp, const char *loglevel, const char *logfile)
Setup logging.
#define GNUNET_free(ptr)
Wrapper around free.
static char * lookup_type
record type to look up (-t option)
Definition: gnunet-gns.c:50
#define gettext_noop(String)
Definition: gettext.h:69
static int global_ret
Global return value.
Definition: gnunet-gns.c:84
Here is the call graph for this function:

Variable Documentation

◆ cfg

const struct GNUNET_CONFIGURATION_Handle* cfg
static

Configuration we are using.

Definition at line 35 of file gnunet-gns.c.

◆ gns

struct GNUNET_GNS_Handle* gns
static

Handle to GNS service.

Definition at line 40 of file gnunet-gns.c.

◆ lookup_name

char* lookup_name
static

GNS name to lookup.

(-u option)

Definition at line 45 of file gnunet-gns.c.

Referenced by main(), and run().

◆ lookup_type

char* lookup_type
static

record type to look up (-t option)

Definition at line 50 of file gnunet-gns.c.

Referenced by main(), and run().

◆ raw

int raw
static

◆ rtype

uint32_t rtype
static

Desired record type.

Definition at line 60 of file gnunet-gns.c.

Referenced by process_lookup_result(), and run().

◆ timeout

struct GNUNET_TIME_Relative timeout
static

Timeout for lookup.

Definition at line 65 of file gnunet-gns.c.

Referenced by main(), and run().

◆ to_task

struct GNUNET_SCHEDULER_Task* to_task
static

Timeout task.

Definition at line 70 of file gnunet-gns.c.

◆ lr

Handle to lookup request.

Definition at line 75 of file gnunet-gns.c.

Referenced by db_read_whitelist(), GNUNET_GNS_lookup(), and handle_result().

◆ global_ret

int global_ret
static

Global return value.

0 on success (default), 1 on internal failures 2 on launch failure, 4 if the name is not a GNS-supported TLD,

Definition at line 84 of file gnunet-gns.c.

Referenced by do_timeout(), main(), process_lookup_result(), and run().