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;
 }