2 This file is part of GNUnet.
3 Copyright (C) 2009-2013 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 PURPROSE. 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.
22 * @file util/program.c
23 * @brief standard code for GNUnet startup and shutdown
24 * @author Christian Grothoff
28 #include "gnunet_util_lib.h"
29 #include "gnunet_resolver_service.h"
30 #include "gnunet_constants.h"
34 #define LOG(kind,...) GNUNET_log_from (kind, "util-program", __VA_ARGS__)
36 #define LOG_STRERROR_FILE(kind,syscall,filename) GNUNET_log_from_strerror_file (kind, "util-program", syscall, filename)
39 * Context for the command.
49 * Name of the configuration file used, can be NULL!
54 * Main function to run.
56 GNUNET_PROGRAM_Main task;
59 * Closure for @e task.
64 * Configuration to use.
66 const struct GNUNET_CONFIGURATION_Handle *cfg;
72 * task run when the scheduler shuts down
75 shutdown_task (void *cls)
78 GNUNET_SPEEDUP_stop_ ();
83 * Initial task called by the scheduler for each
84 * program. Runs the program-specific main task.
87 program_main (void *cls)
89 struct CommandContext *cc = cls;
91 GNUNET_SPEEDUP_start_(cc->cfg);
92 GNUNET_SCHEDULER_add_shutdown (&shutdown_task, NULL);
93 GNUNET_RESOLVER_connect (cc->cfg);
94 cc->task (cc->task_cls, cc->args, cc->cfgfile, cc->cfg);
99 * Compare function for 'qsort' to sort command-line arguments by the
102 * @param a1 first command line option
103 * @param a2 second command line option
106 cmd_sorter (const void *a1, const void *a2)
108 const struct GNUNET_GETOPT_CommandLineOption *c1 = a1;
109 const struct GNUNET_GETOPT_CommandLineOption *c2 = a2;
111 if (toupper ((unsigned char) c1->shortName) >
112 toupper ((unsigned char) c2->shortName))
114 if (toupper ((unsigned char) c1->shortName) <
115 toupper ((unsigned char) c2->shortName))
117 if (c1->shortName > c2->shortName)
119 if (c1->shortName < c2->shortName)
126 * Run a standard GNUnet command startup sequence (initialize loggers
127 * and configuration, parse options).
129 * @param argc number of command line arguments in @a argv
130 * @param argv command line arguments
131 * @param binaryName our expected name
132 * @param binaryHelp help text for the program
133 * @param options command line options
134 * @param task main function to run
135 * @param task_cls closure for @a task
136 * @param run_without_scheduler #GNUNET_NO start the scheduler, #GNUNET_YES do not
137 * start the scheduler just run the main task
138 * @return #GNUNET_SYSERR on error, #GNUNET_OK on success
141 GNUNET_PROGRAM_run2 (int argc, char *const *argv, const char *binaryName,
142 const char *binaryHelp,
143 const struct GNUNET_GETOPT_CommandLineOption *options,
144 GNUNET_PROGRAM_Main task, void *task_cls,
145 int run_without_scheduler)
147 struct CommandContext cc;
157 unsigned long long skew_offset;
158 unsigned long long skew_variance;
159 long long clock_offset;
160 struct GNUNET_CONFIGURATION_Handle *cfg;
162 struct GNUNET_GETOPT_CommandLineOption defoptions[] = {
163 GNUNET_GETOPT_option_cfgfile (&cc.cfgfile),
164 GNUNET_GETOPT_option_help (binaryHelp),
165 GNUNET_GETOPT_option_loglevel (&loglev),
166 GNUNET_GETOPT_option_logfile (&logfile),
167 GNUNET_GETOPT_option_version (PACKAGE_VERSION " " VCS_VERSION)
169 struct GNUNET_GETOPT_CommandLineOption *allopts;
175 gargs = getenv ("GNUNET_ARGS");
186 for (i = 0; i < argc; i++)
187 GNUNET_array_append (gargv, gargc, GNUNET_strdup (argv[i]));
188 cargs = GNUNET_strdup (gargs);
189 for (tok = strtok (cargs, " "); NULL != tok; tok = strtok (NULL, " "))
190 GNUNET_array_append (gargv, gargc, GNUNET_strdup (tok));
192 GNUNET_array_append (gargv, gargc, NULL);
193 argv = (char *const *) gargv;
196 memset (&cc, 0, sizeof (cc));
199 cc.task_cls = task_cls;
200 cc.cfg = cfg = GNUNET_CONFIGURATION_create ();
203 setlocale (LC_ALL, "");
204 path = GNUNET_OS_installation_get_path (GNUNET_OS_IPK_LOCALEDIR);
207 BINDTEXTDOMAIN ("GNUnet", path);
210 textdomain ("GNUnet");
213 while (NULL != options[cnt].name)
216 GNUNET_malloc ((cnt +
217 1) * sizeof (struct GNUNET_GETOPT_CommandLineOption) +
218 sizeof (defoptions));
219 GNUNET_memcpy (allopts, defoptions, sizeof (defoptions));
220 GNUNET_memcpy (&allopts
221 [sizeof (defoptions) /
222 sizeof (struct GNUNET_GETOPT_CommandLineOption)], options,
223 (cnt + 1) * sizeof (struct GNUNET_GETOPT_CommandLineOption));
224 cnt += sizeof (defoptions) / sizeof (struct GNUNET_GETOPT_CommandLineOption);
225 qsort (allopts, cnt, sizeof (struct GNUNET_GETOPT_CommandLineOption),
228 xdg = getenv ("XDG_CONFIG_HOME");
230 GNUNET_asprintf (&cfg_fn,
234 GNUNET_OS_project_data_get ()->config_file);
236 cfg_fn = GNUNET_strdup (GNUNET_OS_project_data_get ()->user_config_file);
237 lpfx = GNUNET_strdup (binaryName);
238 if (NULL != (spc = strstr (lpfx, " ")))
240 ret = GNUNET_GETOPT_run (binaryName, allopts, (unsigned int) argc, argv);
241 if ((GNUNET_OK > ret) ||
242 (GNUNET_OK != GNUNET_log_setup (lpfx, loglev, logfile)))
244 GNUNET_free (allopts);
248 if (NULL == cc.cfgfile)
249 cc.cfgfile = GNUNET_strdup (cfg_fn);
251 GNUNET_DISK_file_test (cc.cfgfile))
253 if (GNUNET_SYSERR == GNUNET_CONFIGURATION_load (cfg, cc.cfgfile))
255 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
256 _("Malformed configuration file `%s', exit ...\n"),
259 GNUNET_free (allopts);
266 if (0 != strcmp (cc.cfgfile, cfg_fn))
267 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
268 _("Could not access configuration file `%s'\n"),
270 if (GNUNET_SYSERR == GNUNET_CONFIGURATION_load (cfg, NULL))
272 GNUNET_log (GNUNET_ERROR_TYPE_ERROR,
273 _("Malformed configuration, exit ...\n"));
275 GNUNET_free (allopts);
280 GNUNET_free (allopts);
283 GNUNET_CONFIGURATION_get_value_number (cc.cfg, "testing", "skew_offset",
286 GNUNET_CONFIGURATION_get_value_number (cc.cfg, "testing",
287 "skew_variance", &skew_variance)))
289 clock_offset = skew_offset - skew_variance;
290 GNUNET_TIME_set_offset (clock_offset);
292 /* ARM needs to know which configuration file to use when starting
293 services. If we got a command-line option *and* if nothing is
294 specified in the configuration, remember the command-line option
295 in "cfg". This is typically really only having an effect if we
296 are running code in src/arm/, as obviously the rest of the code
297 has little business with ARM-specific options. */
299 GNUNET_CONFIGURATION_have_value (cfg,
303 GNUNET_CONFIGURATION_set_value_string (cfg,
309 cc.args = &argv[ret];
310 if (GNUNET_NO == run_without_scheduler)
312 GNUNET_SCHEDULER_run (&program_main, &cc);
316 GNUNET_RESOLVER_connect (cc.cfg);
317 cc.task (cc.task_cls, cc.args, cc.cfgfile, cc.cfg);
321 GNUNET_CONFIGURATION_destroy (cfg);
322 GNUNET_free_non_null (cc.cfgfile);
323 GNUNET_free (cfg_fn);
324 GNUNET_free_non_null (loglev);
325 GNUNET_free_non_null (logfile);
330 * Run a standard GNUnet command startup sequence (initialize loggers
331 * and configuration, parse options).
333 * @param argc number of command line arguments
334 * @param argv command line arguments
335 * @param binaryName our expected name
336 * @param binaryHelp help text for the program
337 * @param options command line options
338 * @param task main function to run
339 * @param task_cls closure for @a task
340 * @return #GNUNET_SYSERR on error, #GNUNET_OK on success
343 GNUNET_PROGRAM_run (int argc, char *const *argv,
344 const char *binaryName,
345 const char *binaryHelp,
346 const struct GNUNET_GETOPT_CommandLineOption *options,
347 GNUNET_PROGRAM_Main task,
350 return GNUNET_PROGRAM_run2 (argc, argv,
351 binaryName, binaryHelp,
358 /* end of program.c */