tool to dispatch URIs to the appropriate GNUnet helper process More...

#include "platform.h"
#include "gnunet_util_lib.h"

Include dependency graph for gnunet-uri.c:

Functions
static void	maint_child_death (void *cls)
	Task triggered whenever we receive a SIGCHLD (child process died) or when user presses CTRL-C. More...

static void	run (void cls, char const args, const char cfgfile, const struct GNUNET_CONFIGURATION_Handle *cfg)
	Main function that will be run by the scheduler. More...

static void	sighandler_child_death ()
	Signal handler called for SIGCHLD. More...

int	main (int argc, char const argv)
	The main function to handle gnunet://-URIs. More...

Variables
static long unsigned int	exit_code = 1
	Handler exit code. More...

static struct GNUNET_OS_Process *	p
	Helper process we started. More...

static struct GNUNET_DISK_PipeHandle *	sigpipe
	Pipe used to communicate shutdown via signal. More...

Detailed Description

tool to dispatch URIs to the appropriate GNUnet helper process

Author: Christian Grothoff

Definition in file gnunet-uri.c.

Function Documentation

◆ maint_child_death()

static void maint_child_death ( void * cls )

static

Task triggered whenever we receive a SIGCHLD (child process died) or when user presses CTRL-C.

Parameters

cls	closure, NULL

Definition at line 52 of file gnunet-uri.c.

References exit_code, GNUNET_break, GNUNET_OK, GNUNET_OS_process_destroy(), GNUNET_OS_PROCESS_EXITED, GNUNET_OS_process_kill(), GNUNET_OS_process_status(), GNUNET_TERM_SIG, and type.

Referenced by run().

 {
   enum GNUNET_OS_ProcessStatusType type;
 
   (void) cls;
   if ((GNUNET_OK != GNUNET_OS_process_status (p, &type, &exit_code)) ||
       (type != GNUNET_OS_PROCESS_EXITED))
     GNUNET_break (0 == GNUNET_OS_process_kill (p, GNUNET_TERM_SIG));
   GNUNET_OS_process_destroy (p);
 }

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 *	cfg
	)

static

Main function that will be run by the scheduler.

Parameters

cls	closure
args	remaining command-line arguments
cfgfile	name of the configuration file used (for saving, can be NULL!)
cfg	configuration

Definition at line 73 of file gnunet-uri.c.

References _, GNUNET_CONFIGURATION_get_value_string(), GNUNET_DISK_PIPE_END_READ, GNUNET_DISK_pipe_handle(), GNUNET_free, GNUNET_NO, GNUNET_OK, GNUNET_OS_start_process(), GNUNET_SCHEDULER_add_read_file(), GNUNET_SCHEDULER_cancel(), GNUNET_strndup, GNUNET_TIME_UNIT_FOREVER_REL, maint_child_death(), subsystem, and uri.

Referenced by main().

 {
   const char *uri;
   const char *slash;
   char *subsystem;
   char *program;
   struct GNUNET_SCHEDULER_Task *rt;
 
   (void) cls;
   (void) cfgfile;
   if (NULL == (uri = args[0]))
   {
     fprintf (stderr, _ ("No URI specified on command line\n"));
     return;
   }
   if (0 != strncasecmp ("gnunet://", uri, strlen ("gnunet://")))
   {
     fprintf (stderr,
              _ ("Invalid URI: does not start with `%s'\n"),
              "gnunet://");
     return;
   }
   uri += strlen ("gnunet://");
   if (NULL == (slash = strchr (uri, '/')))
   {
     fprintf (stderr, _ ("Invalid URI: fails to specify subsystem\n"));
     return;
   }
   subsystem = GNUNET_strndup (uri, slash - uri);
   if (GNUNET_OK !=
       GNUNET_CONFIGURATION_get_value_string (cfg, "uri", subsystem, &program))
   {
     fprintf (stderr, _ ("No handler known for subsystem `%s'\n"), subsystem);
     GNUNET_free (subsystem);
     return;
   }
   GNUNET_free (subsystem);
   rt = GNUNET_SCHEDULER_add_read_file (
     GNUNET_TIME_UNIT_FOREVER_REL,
     GNUNET_DISK_pipe_handle (sigpipe, GNUNET_DISK_PIPE_END_READ),
     &maint_child_death,
     NULL);
   p = GNUNET_OS_start_process (GNUNET_NO,
                                0,
                                NULL,
                                NULL,
                                NULL,
                                program,
                                program,
                                args[0],
                                NULL);
   GNUNET_free (program);
   if (NULL == p)
     GNUNET_SCHEDULER_cancel (rt);
 }

Here is the call graph for this function:

Here is the caller graph for this function:

◆ sighandler_child_death()

static void sighandler_child_death ( )

static

Signal handler called for SIGCHLD.

Triggers the respective handler by writing to the trigger pipe.

Definition at line 138 of file gnunet-uri.c.

References GNUNET_break, GNUNET_DISK_file_write(), GNUNET_DISK_PIPE_END_WRITE, and GNUNET_DISK_pipe_handle().

Referenced by main().

 {
   static char c;
   int old_errno = errno; /* back-up errno */
 
   GNUNET_break (
     1 ==
     GNUNET_DISK_file_write (GNUNET_DISK_pipe_handle (sigpipe,
                                                      GNUNET_DISK_PIPE_END_WRITE),
                             &c,
                             sizeof (c)));
   errno = old_errno; /* restore errno */
 }

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 to handle gnunet://-URIs.

Parameters

argc	number of arguments from the command line
argv	command line arguments

Returns: 0 ok, 1 on error

Definition at line 161 of file gnunet-uri.c.

References exit_code, gettext_noop, GNUNET_assert, GNUNET_DISK_pipe(), GNUNET_DISK_pipe_close(), GNUNET_free, GNUNET_GETOPT_OPTION_END, GNUNET_NO, GNUNET_OK, GNUNET_PROGRAM_run(), GNUNET_SIGCHLD, GNUNET_SIGNAL_handler_install(), GNUNET_SIGNAL_handler_uninstall(), GNUNET_STRINGS_get_utf8_args(), ret, run(), and sighandler_child_death().

 {
   static const struct GNUNET_GETOPT_CommandLineOption options[] = {
     GNUNET_GETOPT_OPTION_END};
   struct GNUNET_SIGNAL_Context *shc_chld;
   int ret;
 
   if (GNUNET_OK != GNUNET_STRINGS_get_utf8_args (argc, argv, &argc, &argv))
     return 2;
   sigpipe = GNUNET_DISK_pipe (GNUNET_NO, GNUNET_NO, GNUNET_NO, GNUNET_NO);
   GNUNET_assert (sigpipe != NULL);
   shc_chld =
     GNUNET_SIGNAL_handler_install (GNUNET_SIGCHLD, &sighandler_child_death);
   ret = GNUNET_PROGRAM_run (argc,
                             argv,
                             "gnunet-uri URI",
                             gettext_noop (
                               "Perform default-actions for GNUnet URIs"),
                             options,
                             &run,
                             NULL);
   GNUNET_SIGNAL_handler_uninstall (shc_chld);
   shc_chld = NULL;
   GNUNET_DISK_pipe_close (sigpipe);
   sigpipe = NULL;
   GNUNET_free ((void *) argv);
   return ((GNUNET_OK == ret) && (0 == exit_code)) ? 0 : 1;
 }