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

Include dependency graph for getopt_helpers.c:

Data Structures
struct	Base32Context
	Closure for set_base32(). More...

Macros
#define	LOG(kind, ...) GNUNET_log_from (kind, "util-getopt", __VA_ARGS__)

#define	BORDER 29
	At what offset does the help text start? More...

Functions
static enum GNUNET_GenericReturnValue	print_version (struct GNUNET_GETOPT_CommandLineProcessorContext ctx, void scls, const char option, const char value)
	Print out program version (implements –version). More...

struct GNUNET_GETOPT_CommandLineOption	GNUNET_GETOPT_option_version (const char *version)
	Define the option to print the version of the application (-v option) More...

static enum GNUNET_GenericReturnValue	format_help (struct GNUNET_GETOPT_CommandLineProcessorContext ctx, void scls, const char option, const char value)
	Print out details on command line options (implements –help). More...

struct GNUNET_GETOPT_CommandLineOption	GNUNET_GETOPT_option_help (const struct GNUNET_OS_ProjectData pd, const char about)
	Defining the option to print the command line help text (-h option). More...

static enum GNUNET_GenericReturnValue	increment_value (struct GNUNET_GETOPT_CommandLineProcessorContext ctx, void scls, const char option, const char value)
	Set an option of type 'unsigned int' from the command line. More...

struct GNUNET_GETOPT_CommandLineOption	GNUNET_GETOPT_option_increment_uint (char shortName, const char name, const char description, unsigned int *val)
	Increment val each time the option flag is given by one. More...

struct GNUNET_GETOPT_CommandLineOption	GNUNET_GETOPT_option_verbose (unsigned int *level)
	Define the '-V' verbosity option. More...

static enum GNUNET_GenericReturnValue	set_one (struct GNUNET_GETOPT_CommandLineProcessorContext ctx, void scls, const char option, const char value)
	Set an option of type 'int' from the command line to 1 if the given option is present. More...

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. More...

static enum GNUNET_GenericReturnValue	set_string (struct GNUNET_GETOPT_CommandLineProcessorContext ctx, void scls, const char option, const char value)
	Set an option of type 'char *' from the command line. More...

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. More...

struct GNUNET_GETOPT_CommandLineOption	GNUNET_GETOPT_option_loglevel (char **level)
	Define the '-L' log level option. More...

static enum GNUNET_GenericReturnValue	set_filename (struct GNUNET_GETOPT_CommandLineProcessorContext ctx, void scls, const char option, const char value)
	Set an option of type 'char *' from the command line with filename expansion a la GNUNET_STRINGS_filename_expand(). More...

struct GNUNET_GETOPT_CommandLineOption	GNUNET_GETOPT_option_filename (char shortName, const char name, const char argumentHelp, const char description, char *str)
	Allow user to specify a filename (automatically path expanded). More...

struct GNUNET_GETOPT_CommandLineOption	GNUNET_GETOPT_option_logfile (char **logfn)
	Allow user to specify log file name (-l option) More...

struct GNUNET_GETOPT_CommandLineOption	GNUNET_GETOPT_option_cfgfile (char **fn)
	Allow user to specify configuration file name (-c option) More...

static enum GNUNET_GenericReturnValue	set_ulong (struct GNUNET_GETOPT_CommandLineProcessorContext ctx, void scls, const char option, const char value)
	Set an option of type 'unsigned long long' from the command line. More...

struct GNUNET_GETOPT_CommandLineOption	GNUNET_GETOPT_option_ulong (char shortName, const char name, const char argumentHelp, const char description, unsigned long long val)
	Allow user to specify an `unsigned long long`. More...

static enum GNUNET_GenericReturnValue	set_timetravel_time (struct GNUNET_GETOPT_CommandLineProcessorContext ctx, void scls, const char option, const char value)
	Set an option of type 'struct GNUNET_TIME_Relative' from the command line. More...

struct GNUNET_GETOPT_CommandLineOption	GNUNET_GETOPT_option_timetravel (char shortName, const char *name)
	Allow user to specify a `long long` with an offset to add to the current system time to construct the time seen by the application. More...

static enum GNUNET_GenericReturnValue	set_relative_time (struct GNUNET_GETOPT_CommandLineProcessorContext ctx, void scls, const char option, const char value)
	Set an option of type 'struct GNUNET_TIME_Relative' from the command line. More...

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). More...

static enum GNUNET_GenericReturnValue	set_absolute_time (struct GNUNET_GETOPT_CommandLineProcessorContext ctx, void scls, const char option, const char value)
	Set an option of type 'struct GNUNET_TIME_Absolute' from the command line. More...

struct GNUNET_GETOPT_CommandLineOption	GNUNET_GETOPT_option_absolute_time (char shortName, const char name, const char argumentHelp, const char description, struct GNUNET_TIME_Absolute val)
	Allow user to specify a `struct GNUNET_TIME_Absolute` (using human-readable "fancy" time). More...

static enum GNUNET_GenericReturnValue	set_timestamp (struct GNUNET_GETOPT_CommandLineProcessorContext ctx, void scls, const char option, const char value)
	Set an option of type 'struct GNUNET_TIME_Timestamp' from the command line. More...

struct GNUNET_GETOPT_CommandLineOption	GNUNET_GETOPT_option_timestamp (char shortName, const char name, const char argumentHelp, const char description, struct GNUNET_TIME_Timestamp val)
	Allow user to specify a `struct GNUNET_TIME_Timestamp` (using human-readable "fancy" time). More...

static enum GNUNET_GenericReturnValue	set_uint (struct GNUNET_GETOPT_CommandLineProcessorContext ctx, void scls, const char option, const char value)
	Set an option of type 'unsigned int' from the command line. More...

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`. More...

static enum GNUNET_GenericReturnValue	set_uint16 (struct GNUNET_GETOPT_CommandLineProcessorContext ctx, void scls, const char option, const char value)
	Set an option of type 'uint16_t' from the command line. More...

struct GNUNET_GETOPT_CommandLineOption	GNUNET_GETOPT_option_uint16 (char shortName, const char name, const char argumentHelp, const char description, uint16_t val)
	Allow user to specify an uint16_t. More...

static enum GNUNET_GenericReturnValue	set_base32 (struct GNUNET_GETOPT_CommandLineProcessorContext ctx, void scls, const char option, const char value)
	Set an option of type 'unsigned int' from the command line. More...

static void	free_bc (void *cls)
	Helper function to clean up after GNUNET_GETOPT_option_base32_fixed_size. More...

struct GNUNET_GETOPT_CommandLineOption	GNUNET_GETOPT_option_base32_fixed_size (char shortName, const char name, const char argumentHelp, const char description, void val, size_t val_size)
	Allow user to specify a binary value using Crockford Base32 encoding. More...

struct GNUNET_GETOPT_CommandLineOption	GNUNET_GETOPT_option_mandatory (struct GNUNET_GETOPT_CommandLineOption opt)
	Make the given option mandatory. More...

struct GNUNET_GETOPT_CommandLineOption	GNUNET_GETOPT_option_exclusive (struct GNUNET_GETOPT_CommandLineOption opt)
	Make the given option mutually exclusive with other options. More...

Macro Definition Documentation

◆ LOG

#define LOG	(	kind,
		...
	)	GNUNET_log_from (kind, "util-getopt", __VA_ARGS__)

Definition at line 30 of file getopt_helpers.c.

◆ BORDER

#define BORDER 29

At what offset does the help text start?

Definition at line 79 of file getopt_helpers.c.

Function Documentation

◆ print_version()

static enum GNUNET_GenericReturnValue print_version	(	struct GNUNET_GETOPT_CommandLineProcessorContext *	ctx,
		void *	scls,
		const char *	option,
		const char *	value
	)

static

Print out program version (implements –version).

Parameters

ctx	command line processing context
scls	additional closure (points to version string)
option	name of the option
value	not used (NULL)

Returns: GNUNET_NO (do not continue, not an error)

Definition at line 43 of file getopt_helpers.c.

{
  const char *version = scls;
 
  (void) option;
  (void) value;
  printf ("%s v%s\n",
          ctx->binaryName,
          version);
  return GNUNET_NO;
}

References ctx, GNUNET_NO, and value.

Referenced by GNUNET_GETOPT_option_version().

Here is the caller graph for this function:

◆ format_help()

static enum GNUNET_GenericReturnValue format_help	(	struct GNUNET_GETOPT_CommandLineProcessorContext *	ctx,
		void *	scls,
		const char *	option,
		const char *	value
	)

static

Print out details on command line options (implements –help).

Parameters

ctx	command line processing context
scls	additional closure (points to about text)
option	name of the option
value	not used (NULL)

Returns: GNUNET_NO (do not continue, not an error)

Definition at line 91 of file getopt_helpers.c.

{
  const struct GNUNET_OS_ProjectData *pd = scls;
  const char *about = NULL;
  size_t slen;
  unsigned int i;
  int j;
  size_t ml;
  size_t p;
  char *scp;
  const char *trans;
  const struct GNUNET_GETOPT_CommandLineOption *opt;
 
  (void) option;
  (void) value;
  opt = ctx->allOptions;
  for (i=0; NULL != opt[i].description; i++)
  {
    /* we hacked the about argument into our own argumentHelp! */
    if ('h' == opt[i].shortName)
      about = opt[i].argumentHelp;
  }
  if (NULL != about)
  {
    printf ("%s\n%s\n",
            ctx->binaryOptions,
            gettext (about));
    printf (_ (
              "Arguments mandatory for long options are also mandatory for short options.\n"));
  }
  for (i=0; NULL != opt[i].description; i++)
  {
    if (opt[i].shortName == '\0')
      printf ("      ");
    else
      printf ("  -%c, ", opt[i].shortName);
    printf ("--%s", opt[i].name);
    slen = 8 + strlen (opt[i].name);
    if ( (NULL != opt[i].argumentHelp) &&
         ('h' != opt[i].shortName) )
    {
      printf ("=%s", opt[i].argumentHelp);
      slen += 1 + strlen (opt[i].argumentHelp);
    }
    if (slen > BORDER)
    {
      printf ("\n%*s", BORDER, "");
      slen = BORDER;
    }
    if (slen < BORDER)
    {
      printf ("%*s", (int) (BORDER - slen), "");
      slen = BORDER;
    }
    if (0 < strlen (opt[i].description))
      trans = gettext (opt[i].description);
    else
      trans = "";
    ml = strlen (trans);
    p = 0;
OUTER:
    while (ml - p > 78 - slen)
    {
      for (j = p + 78 - slen; j > (int) p; j--)
      {
        if (isspace ((unsigned char) trans[j]))
        {
          scp = GNUNET_malloc (j - p + 1);
          GNUNET_memcpy (scp, &trans[p], j - p);
          scp[j - p] = '\0';
          printf ("%s\n%*s", scp, BORDER + 2, "");
          GNUNET_free (scp);
          p = j + 1;
          slen = BORDER + 2;
          goto OUTER;
        }
      }
      /* could not find space to break line */
      scp = GNUNET_malloc (78 - slen + 1);
      GNUNET_memcpy (scp, &trans[p], 78 - slen);
      scp[78 - slen] = '\0';
      printf ("%s\n%*s", scp, BORDER + 2, "");
      GNUNET_free (scp);
      slen = BORDER + 2;
      p = p + 78 - slen;
    }
    /* print rest */
    if (p < ml)
      printf ("%s\n", &trans[p]);
    if (strlen (trans) == 0)
      printf ("\n");
  }
  printf ("\n"
          "Report bugs to %s.\n"
          "Home page: %s\n",
          pd->bug_email,
          pd->homepage);
 
  if (0 != pd->is_gnu)
    printf ("General help using GNU software: http://www.gnu.org/gethelp/\n");
 
  return GNUNET_NO;
}

References _, GNUNET_GETOPT_CommandLineOption::argumentHelp, BORDER, GNUNET_OS_ProjectData::bug_email, ctx, GNUNET_GETOPT_CommandLineOption::description, gettext, GNUNET_free, GNUNET_malloc, GNUNET_memcpy, GNUNET_NO, GNUNET_OS_ProjectData::homepage, GNUNET_OS_ProjectData::is_gnu, name, p, GNUNET_GETOPT_CommandLineOption::shortName, and value.

Referenced by GNUNET_GETOPT_option_help().

Here is the caller graph for this function:

◆ increment_value()

static enum GNUNET_GenericReturnValue increment_value	(	struct GNUNET_GETOPT_CommandLineProcessorContext *	ctx,
		void *	scls,
		const char *	option,
		const char *	value
	)

static

Set an option of type 'unsigned int' from the command line.

Each time the option flag is given, the value is incremented by one. A pointer to this function should be passed as part of the 'struct GNUNET_GETOPT_CommandLineOption' array to initialize options of this type. It should be followed by a pointer to a value of type 'int'.

Parameters

ctx	command line processing context
scls	additional closure (will point to the 'unsigned int')
option	name of the option
value	not used (NULL)

Returns: GNUNET_OK

Definition at line 233 of file getopt_helpers.c.

{
  unsigned int *val = scls;
 
  (void) ctx;
  (void) option;
  (void) value;
  (*val)++;
  return GNUNET_OK;
}

References ctx, GNUNET_OK, GNUNET_GETOPT_CommandLineOption::scls, and value.

Referenced by GNUNET_GETOPT_option_increment_uint(), and GNUNET_GETOPT_option_verbose().

Here is the caller graph for this function:

◆ set_one()

static enum GNUNET_GenericReturnValue set_one	(	struct GNUNET_GETOPT_CommandLineProcessorContext *	ctx,
		void *	scls,
		const char *	option,
		const char *	value
	)

static

Set an option of type 'int' from the command line to 1 if the given option is present.

A pointer to this function should be passed as part of the 'struct GNUNET_GETOPT_CommandLineOption' array to initialize options of this type. It should be followed by a pointer to a value of type 'int'.

Parameters

ctx	command line processing context
scls	additional closure (will point to the 'int')
option	name of the option
value	not used (NULL)

Returns: GNUNET_OK

Definition at line 297 of file getopt_helpers.c.

{
  int *val = scls;
 
  (void) ctx;
  (void) option;
  (void) value;
  *val = 1;
  return GNUNET_OK;
}

References ctx, GNUNET_OK, GNUNET_GETOPT_CommandLineOption::scls, and value.

Referenced by GNUNET_GETOPT_option_flag().

Here is the caller graph for this function:

◆ set_string()

static enum GNUNET_GenericReturnValue set_string	(	struct GNUNET_GETOPT_CommandLineProcessorContext *	ctx,
		void *	scls,
		const char *	option,
		const char *	value
	)

static

Set an option of type 'char *' from the command line.

A pointer to this function should be passed as part of the 'struct GNUNET_GETOPT_CommandLineOption' array to initialize options of this type. It should be followed by a pointer to a value of type 'char *', which will be allocated with the requested string.

Parameters

ctx	command line processing context
scls	additional closure (will point to the 'char *', which will be allocated)
option	name of the option
value	actual value of the option (a string)

Returns: GNUNET_OK

Definition at line 345 of file getopt_helpers.c.

{
  char **val = scls;
 
  (void) ctx;
  (void) option;
  GNUNET_assert (NULL != value);
  GNUNET_free (*val);
  *val = GNUNET_strdup (value);
  return GNUNET_OK;
}

References ctx, GNUNET_assert, GNUNET_free, GNUNET_OK, GNUNET_strdup, GNUNET_GETOPT_CommandLineOption::scls, and value.

Referenced by GNUNET_GETOPT_option_loglevel(), and GNUNET_GETOPT_option_string().

Here is the caller graph for this function:

◆ set_filename()

static enum GNUNET_GenericReturnValue set_filename	(	struct GNUNET_GETOPT_CommandLineProcessorContext *	ctx,
		void *	scls,
		const char *	option,
		const char *	value
	)

static

Set an option of type 'char *' from the command line with filename expansion a la GNUNET_STRINGS_filename_expand().

Parameters

ctx	command line processing context
scls	additional closure (will point to the `char *`, which will be allocated)
option	name of the option
value	actual value of the option (a string)

Returns: GNUNET_OK

Definition at line 411 of file getopt_helpers.c.

{
  char **val = scls;
 
  (void) ctx;
  (void) option;
  GNUNET_assert (NULL != value);
  GNUNET_free (*val);
  *val = GNUNET_STRINGS_filename_expand (value);
  return GNUNET_OK;
}

References ctx, GNUNET_assert, GNUNET_free, GNUNET_OK, GNUNET_STRINGS_filename_expand(), GNUNET_GETOPT_CommandLineOption::scls, and value.

Referenced by GNUNET_GETOPT_option_cfgfile(), GNUNET_GETOPT_option_filename(), and GNUNET_GETOPT_option_logfile().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ set_ulong()

static enum GNUNET_GenericReturnValue set_ulong	(	struct GNUNET_GETOPT_CommandLineProcessorContext *	ctx,
		void *	scls,
		const char *	option,
		const char *	value
	)

static

Set an option of type 'unsigned long long' from the command line.

A pointer to this function should be passed as part of the 'struct GNUNET_GETOPT_CommandLineOption' array to initialize options of this type. It should be followed by a pointer to a value of type 'unsigned long long'.

Parameters

ctx	command line processing context
scls	additional closure (will point to the 'unsigned long long')
option	name of the option
value	actual value of the option as a string.

Returns: GNUNET_OK if parsing the value worked

Definition at line 497 of file getopt_helpers.c.

{
  unsigned long long *val = scls;
  char dummy[2];
 
  (void) ctx;
  if (1 != sscanf (value, "%llu%1s", val, dummy))
  {
    fprintf (stderr,
             _ ("You must pass a number to the `%s' option.\n"),
             option);
    return GNUNET_SYSERR;
  }
  return GNUNET_OK;
}

References _, ctx, dummy, GNUNET_OK, GNUNET_SYSERR, GNUNET_GETOPT_CommandLineOption::scls, and value.

Referenced by GNUNET_GETOPT_option_ulong().

Here is the caller graph for this function:

◆ set_timetravel_time()

static enum GNUNET_GenericReturnValue set_timetravel_time	(	struct GNUNET_GETOPT_CommandLineProcessorContext *	ctx,
		void *	scls,
		const char *	option,
		const char *	value
	)

static

Set an option of type 'struct GNUNET_TIME_Relative' from the command line.

A pointer to this function should be passed as part of the 'struct GNUNET_GETOPT_CommandLineOption' array to initialize options of this type. It should be followed by a pointer to a value of type 'struct GNUNET_TIME_Relative'.

Parameters

ctx	command line processing context
scls	additional closure (will point to the 'struct GNUNET_TIME_Relative')
option	name of the option
value	actual value of the option as a string.

Returns: GNUNET_OK if parsing the value worked

Definition at line 552 of file getopt_helpers.c.

{
  long long delta;
  long long minus;
  struct GNUNET_TIME_Relative rt;
 
  (void) scls;
  (void) ctx;
  while (isspace (value[0]))
    value++;
  minus = 1;
  if (value[0] == '-')
  {
    minus = -1;
    value++;
  }
  else if (value[0] == '+')
  {
    value++;
  }
  if (GNUNET_OK !=
      GNUNET_STRINGS_fancy_time_to_relative (value,
                                             &rt))
  {
    fprintf (stderr,
             _ (
               "You must pass a relative time (optionally with sign) to the `%s' option.\n"),
             option);
    return GNUNET_SYSERR;
  }
  if (rt.rel_value_us > LLONG_MAX)
  {
    fprintf (stderr,
             _ ("Value given for time travel `%s' option is too big.\n"),
             option);
    return GNUNET_SYSERR;
  }
  delta = (long long) rt.rel_value_us;
  delta *= minus;
  GNUNET_TIME_set_offset (delta);
  return GNUNET_OK;
}

References _, ctx, delta, GNUNET_OK, GNUNET_STRINGS_fancy_time_to_relative(), GNUNET_SYSERR, GNUNET_TIME_set_offset(), GNUNET_TIME_Relative::rel_value_us, and value.

Referenced by GNUNET_GETOPT_option_timetravel().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ set_relative_time()

static enum GNUNET_GenericReturnValue set_relative_time	(	struct GNUNET_GETOPT_CommandLineProcessorContext *	ctx,
		void *	scls,
		const char *	option,
		const char *	value
	)

static

Set an option of type 'struct GNUNET_TIME_Relative' from the command line.

A pointer to this function should be passed as part of the 'struct GNUNET_GETOPT_CommandLineOption' array to initialize options of this type. It should be followed by a pointer to a value of type 'struct GNUNET_TIME_Relative'.

Parameters

ctx	command line processing context
scls	additional closure (will point to the 'struct GNUNET_TIME_Relative')
option	name of the option
value	actual value of the option as a string.

Returns: GNUNET_OK if parsing the value worked

Definition at line 631 of file getopt_helpers.c.

{
  struct GNUNET_TIME_Relative *val = scls;
 
  (void) ctx;
  if (GNUNET_OK != GNUNET_STRINGS_fancy_time_to_relative (value, val))
  {
    fprintf (stderr,
             _ ("You must pass relative time to the `%s' option.\n"),
             option);
    return GNUNET_SYSERR;
  }
  return GNUNET_OK;
}

References _, ctx, GNUNET_OK, GNUNET_STRINGS_fancy_time_to_relative(), GNUNET_SYSERR, and value.

Referenced by GNUNET_GETOPT_option_relative_time().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ set_absolute_time()

static enum GNUNET_GenericReturnValue set_absolute_time	(	struct GNUNET_GETOPT_CommandLineProcessorContext *	ctx,
		void *	scls,
		const char *	option,
		const char *	value
	)

static

Set an option of type 'struct GNUNET_TIME_Absolute' from the command line.

A pointer to this function should be passed as part of the 'struct GNUNET_GETOPT_CommandLineOption' array to initialize options of this type. It should be followed by a pointer to a value of type 'struct GNUNET_TIME_Absolute'.

Parameters

ctx	command line processing context
scls	additional closure (will point to the `struct GNUNET_TIME_Absolute`)
option	name of the option
value	actual value of the option as a string.

Returns: GNUNET_OK if parsing the value worked

Definition at line 685 of file getopt_helpers.c.

{
  struct GNUNET_TIME_Absolute *val = scls;
 
  (void) ctx;
  if (GNUNET_OK != GNUNET_STRINGS_fancy_time_to_absolute (value, val))
  {
    fprintf (stderr,
             _ ("You must pass absolute time to the `%s' option.\n"),
             option);
    return GNUNET_SYSERR;
  }
  return GNUNET_OK;
}

References _, ctx, GNUNET_OK, GNUNET_STRINGS_fancy_time_to_absolute(), GNUNET_SYSERR, and value.

Referenced by GNUNET_GETOPT_option_absolute_time().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ set_timestamp()

static enum GNUNET_GenericReturnValue set_timestamp	(	struct GNUNET_GETOPT_CommandLineProcessorContext *	ctx,
		void *	scls,
		const char *	option,
		const char *	value
	)

static

Set an option of type 'struct GNUNET_TIME_Timestamp' from the command line.

A pointer to this function should be passed as part of the 'struct GNUNET_GETOPT_CommandLineOption' array to initialize options of this type. It should be followed by a pointer to a value of type 'struct GNUNET_TIME_Absolute'.

Parameters

ctx	command line processing context
scls	additional closure (will point to the `struct GNUNET_TIME_Absolute`)
option	name of the option
value	actual value of the option as a string.

Returns: GNUNET_OK if parsing the value worked

Definition at line 739 of file getopt_helpers.c.

{
  struct GNUNET_TIME_Timestamp *t = scls;
  struct GNUNET_TIME_Absolute abs;
 
  (void) ctx;
  if (GNUNET_OK !=
      GNUNET_STRINGS_fancy_time_to_absolute (value,
                                             &abs))
  {
    fprintf (stderr,
             _ ("You must pass a timestamp to the `%s' option.\n"),
             option);
    return GNUNET_SYSERR;
  }
  if (0 != abs.abs_value_us % GNUNET_TIME_UNIT_SECONDS.rel_value_us)
  {
    fprintf (stderr,
             _ ("The maximum precision allowed for timestamps is seconds.\n"));
    return GNUNET_SYSERR;
  }
  t->abs_time = abs;
  return GNUNET_OK;
}

References _, GNUNET_TIME_Absolute::abs_value_us, ctx, GNUNET_OK, GNUNET_STRINGS_fancy_time_to_absolute(), GNUNET_SYSERR, GNUNET_TIME_UNIT_SECONDS, t, and value.

Referenced by GNUNET_GETOPT_option_timestamp().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ set_uint()

static enum GNUNET_GenericReturnValue set_uint	(	struct GNUNET_GETOPT_CommandLineProcessorContext *	ctx,
		void *	scls,
		const char *	option,
		const char *	value
	)

static

Set an option of type 'unsigned int' from the command line.

A pointer to this function should be passed as part of the 'struct GNUNET_GETOPT_CommandLineOption' array to initialize options of this type. It should be followed by a pointer to a value of type 'unsigned int'.

Parameters

ctx	command line processing context
scls	additional closure (will point to the 'unsigned int')
option	name of the option
value	actual value of the option as a string.

Returns: GNUNET_OK if parsing the value worked

Definition at line 803 of file getopt_helpers.c.

{
  unsigned int *val = scls;
  char dummy[2];
 
  (void) ctx;
  if ('-' == *value)
  {
    fprintf (stderr,
             _ (
               "Your input for the '%s' option has to be a non negative number\n"),
             option);
    return GNUNET_SYSERR;
  }
  if (1 != sscanf (value, "%u%1s", val, dummy))
  {
    fprintf (stderr,
             _ ("You must pass a number to the `%s' option.\n"),
             option);
    return GNUNET_SYSERR;
  }
  return GNUNET_OK;
}

References _, ctx, dummy, GNUNET_OK, GNUNET_SYSERR, GNUNET_GETOPT_CommandLineOption::scls, and value.

Referenced by GNUNET_GETOPT_option_uint().

Here is the caller graph for this function:

◆ set_uint16()

static enum GNUNET_GenericReturnValue set_uint16	(	struct GNUNET_GETOPT_CommandLineProcessorContext *	ctx,
		void *	scls,
		const char *	option,
		const char *	value
	)

static

Set an option of type 'uint16_t' from the command line.

A pointer to this function should be passed as part of the 'struct GNUNET_GETOPT_CommandLineOption' array to initialize options of this type. It should be followed by a pointer to a value of type 'uint16_t'.

Parameters

ctx	command line processing context
scls	additional closure (will point to the 'unsigned int')
option	name of the option
value	actual value of the option as a string.

Returns: GNUNET_OK if parsing the value worked

Definition at line 866 of file getopt_helpers.c.

{
  uint16_t *val = scls;
  unsigned int v;
  char dummy[2];
 
  (void) ctx;
  if (1 != sscanf (value, "%u%1s", &v, dummy))
  {
    fprintf (stderr,
             _ ("You must pass a number to the `%s' option.\n"),
             option);
    return GNUNET_SYSERR;
  }
  if (v > UINT16_MAX)
  {
    fprintf (stderr,
             _ ("You must pass a number below %u to the `%s' option.\n"),
             (unsigned int) UINT16_MAX,
             option);
    return GNUNET_SYSERR;
  }
  *val = (uint16_t) v;
  return GNUNET_OK;
}

References _, ctx, dummy, GNUNET_OK, GNUNET_SYSERR, GNUNET_GETOPT_CommandLineOption::scls, and value.

Referenced by GNUNET_GETOPT_option_uint16().

Here is the caller graph for this function:

◆ set_base32()

static enum GNUNET_GenericReturnValue set_base32	(	struct GNUNET_GETOPT_CommandLineProcessorContext *	ctx,
		void *	scls,
		const char *	option,
		const char *	value
	)

static

Set an option of type 'unsigned int' from the command line.

A pointer to this function should be passed as part of the 'struct GNUNET_GETOPT_CommandLineOption' array to initialize options of this type. It should be followed by a pointer to a value of type 'unsigned int'.

Parameters

ctx	command line processing context
scls	additional closure (will point to the 'unsigned int')
option	name of the option
value	actual value of the option as a string.

Returns: GNUNET_OK if parsing the value worked

Definition at line 948 of file getopt_helpers.c.

{
  struct Base32Context *bc = scls;
 
  (void) ctx;
  if (GNUNET_OK != GNUNET_STRINGS_string_to_data (value,
                                                  strlen (value),
                                                  bc->val,
                                                  bc->val_size))
  {
    fprintf (
      stderr,
      _ (
        "Argument `%s' malformed. Expected base32 (Crockford) encoded value.\n")
      ,
      option);
    return GNUNET_SYSERR;
  }
  return GNUNET_OK;
}

References _, ctx, GNUNET_OK, GNUNET_STRINGS_string_to_data(), GNUNET_SYSERR, Base32Context::val, Base32Context::val_size, and value.

Referenced by GNUNET_GETOPT_option_base32_fixed_size().

Here is the call graph for this function:

Here is the caller graph for this function:

◆ free_bc()

static void free_bc ( void * cls )

static

Helper function to clean up after GNUNET_GETOPT_option_base32_fixed_size.

Parameters

cls	value to GNUNET_free()

Definition at line 980 of file getopt_helpers.c.

{
  GNUNET_free (cls);
}

References GNUNET_free.

Referenced by GNUNET_GETOPT_option_base32_fixed_size().

Here is the caller graph for this function:

Data Structures

Macros

Functions

Macro Definition Documentation

◆ LOG

◆ BORDER

Function Documentation

◆ print_version()

◆ format_help()

◆ increment_value()

◆ set_one()

◆ set_string()

◆ set_filename()

◆ set_ulong()

◆ set_timetravel_time()

◆ set_relative_time()

◆ set_absolute_time()

◆ set_timestamp()

◆ set_uint()

◆ set_uint16()

◆ set_base32()

◆ free_bc()