doc update

src/ocserv-args.c

@@ -1,12 +1,12 @@
 /*   -*- buffer-read-only: t -*- vi: set ro:
- *
+ *  
  *  DO NOT EDIT THIS FILE   (ocserv-args.c)
- *
- *  It has been AutoGen-ed  August  3, 2013 at 10:51:57 AM by AutoGen 5.17.3
+ *  
+ *  It has been AutoGen-ed  October  5, 2013 at 09:36:46 AM by AutoGen 5.17
  *  From the definitions    ocserv-args.def
  *  and the template file   options
  *
- * Generated from AutoOpts 38:0:13 templates.
+ * Generated from AutoOpts 37:0:12 templates.
  *
  *  AutoOpts is a copyrighted work.  This source file is not encumbered
  *  by AutoOpts licensing, but is provided under the licensing terms chosen
@@ -21,18 +21,18 @@
  *
  *  Copyright (C) 2013 Nikos Mavrogiannopoulos, all rights reserved.
  *  This is free software. It is licensed for use, modification and
- *  redistribution under the terms of the GNU General Public License,
- *  version 2 <http://gnu.org/licenses/gpl.html>
+ *  redistribution under the terms of the
+ *  GNU General Public License, version 2 <http://gnu.org/licenses/gpl.html>
  *
  *  ocserv is free software: you can redistribute it and/or modify it
  *  under the terms of version 2 of the GNU General Public License,
  *  as published by the Free Software Foundation.
- *
+ *  
  *  ocserv is distributed in the hope that it will be useful, but
  *  WITHOUT ANY WARRANTY; without even the implied warranty of
  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  *  See the GNU General Public License for more details.
- *
+ *  
  *  You should have received a copy of the GNU General Public License,
  *  version 2, along with this program.
  *  If not, see <http://www.gnu.org/licenses/>.
@@ -51,6 +51,9 @@
 extern "C" {
 #endif
 extern FILE * option_usage_fp;
+
+/* TRANSLATORS: choose the translation for option names wisely because you
+                cannot ever change your mind. */
 #define zCopyright      (ocserv_opt_strs+0)
 #define zLicenseDescrip (ocserv_opt_strs+254)
 
@@ -59,15 +62,15 @@ extern FILE * option_usage_fp;
 #  define NULL 0
 #endif
 
-/**
- *  static const strings for ocserv options
+/*
+ *  ocserv option static const strings
  */
-static char const ocserv_opt_strs[1819] =
-/*     0 */ "ocserv 0.1.5\n"
+static char const ocserv_opt_strs[1834] =
+/*     0 */ "ocserv 0.1.6\n"
             "Copyright (C) 2013 Nikos Mavrogiannopoulos, all rights reserved.\n"
             "This is free software. It is licensed for use, modification and\n"
-            "redistribution under the terms of the GNU General Public License,\n"
-            "version 2 <http://gnu.org/licenses/gpl.html>\n\0"
+            "redistribution under the terms of the\n"
+            "GNU General Public License, version 2 <http://gnu.org/licenses/gpl.html>\n\0"
 /*   254 */ "ocserv is free software: you can redistribute it and/or modify it under the\n"
             "terms of version 2 of the GNU General Public License, as published by the\n"
             "Free Software Foundation.\n\n"
@@ -89,74 +92,59 @@ static char const ocserv_opt_strs[1819] =
 /*   977 */ "Configuration file for the server\0"
 /*  1011 */ "CONFIG\0"
 /*  1018 */ "config\0"
-/*  1025 */ "display extended usage information and exit\0"
+/*  1025 */ "Display extended usage information and exit\0"
 /*  1069 */ "help\0"
-/*  1074 */ "extended usage information passed thru pager\0"
+/*  1074 */ "Extended usage information passed thru pager\0"
 /*  1119 */ "more-help\0"
-/*  1129 */ "output version information and exit\0"
+/*  1129 */ "Output version information and exit\0"
 /*  1165 */ "version\0"
 /*  1173 */ "OCSERV\0"
-/*  1180 */ "ocserv - OpenConnect server\n"
-            "Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n\0"
-/*  1266 */ "openconnect-devel@lists.infradead.org\0"
-/*  1304 */ "\n\0"
-/*  1306 */ "Openconnect VPN server (ocserv) is a VPN server compatible with the\n"
+/*  1180 */ "ocserv - OpenConnect server - Ver. 0.1.6\n"
+            "USAGE:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n\0"
+/*  1279 */ "openconnect-devel@lists.infradead.org\0"
+/*  1317 */ "\n\n\0"
+/*  1320 */ "\n"
+            "Openconnect VPN server (ocserv) is a VPN server compatible with the\n"
             "openconnect VPN client.  It follows the AnyConnect VPN protocol which is\n"
             "used by several CISCO routers.\n\n"
             "This server supports multiple authentication methods, including PAM and\n"
             "certificate authentication.  Authenticated users are assigned an\n"
             "unprivileged worker process and obtain a networking (tun) device and an IP\n"
             "from a configurable pool of addresses.\n\0"
-/*  1731 */ "ocserv 0.1.5\0"
-/*  1744 */ "Usage: ocserv [options] -c [config]\n"
+/*  1746 */ "ocserv 0.1.6\0"
+/*  1759 */ "Usage: ocserv [options] -c [config]\n"
             "ocserv --help for usage instructions.\n";
 
-/**
+/*
  *  foreground option description:
  */
-/** Descriptive text for the foreground option */
 #define FOREGROUND_DESC      (ocserv_opt_strs+809)
-/** Upper-cased name for the foreground option */
 #define FOREGROUND_NAME      (ocserv_opt_strs+837)
-/** Name string for the foreground option */
 #define FOREGROUND_name      (ocserv_opt_strs+848)
-/** Compiled in flag settings for the foreground option */
 #define FOREGROUND_FLAGS     (OPTST_DISABLED)
 
-/**
+/*
  *  tls-debug option description:
  */
-/** Descriptive text for the tls-debug option */
 #define TLS_DEBUG_DESC      (ocserv_opt_strs+859)
-/** Upper-cased name for the tls-debug option */
 #define TLS_DEBUG_NAME      (ocserv_opt_strs+900)
-/** Name string for the tls-debug option */
 #define TLS_DEBUG_name      (ocserv_opt_strs+910)
-/** Compiled in flag settings for the tls-debug option */
 #define TLS_DEBUG_FLAGS     (OPTST_DISABLED)
 
-/**
+/*
  *  debug option description:
  */
-/** Descriptive text for the debug option */
 #define DEBUG_DESC      (ocserv_opt_strs+920)
-/** Upper-cased name for the debug option */
 #define DEBUG_NAME      (ocserv_opt_strs+965)
-/** Name string for the debug option */
 #define DEBUG_name      (ocserv_opt_strs+971)
-/** Compiled in flag settings for the debug option */
 #define DEBUG_FLAGS     (OPTST_DISABLED)
 
-/**
+/*
  *  config option description:
  */
-/** Descriptive text for the config option */
 #define CONFIG_DESC      (ocserv_opt_strs+977)
-/** Upper-cased name for the config option */
 #define CONFIG_NAME      (ocserv_opt_strs+1011)
-/** Name string for the config option */
 #define CONFIG_name      (ocserv_opt_strs+1018)
-/** Compiled in flag settings for the config option */
 #define CONFIG_FLAGS     (OPTST_DISABLED \
         | OPTST_SET_ARGTYPE(OPARG_TYPE_FILE))
 
@@ -182,7 +170,7 @@ static char const ocserv_opt_strs[1819] =
 #endif
 #define VER_DESC        (ocserv_opt_strs+1129)
 #define VER_name        (ocserv_opt_strs+1165)
-/**
+/*
  *  Declare option callback procedures
  */
 extern tOptProc
@@ -253,7 +241,7 @@ static tOptDesc optDesc[OPTION_CT] = {
      /* equiv idx value  */ NO_EQUIVALENT, VALUE_OPT_VERSION,
      /* equivalenced to  */ NO_EQUIVALENT,
      /* min, max, act ct */ 0, 1, 0,
-     /* opt state flags  */ VER_FLAGS, AOUSE_VERSION,
+     /* opt state flags  */ VER_FLAGS, 0,
      /* last opt argumnt */ { NULL },
      /* arg list/cookie  */ NULL,
      /* must/cannot opts */ NULL, NULL,
@@ -267,7 +255,7 @@ static tOptDesc optDesc[OPTION_CT] = {
      /* equiv idx value  */ NO_EQUIVALENT, VALUE_OPT_HELP,
      /* equivalenced to  */ NO_EQUIVALENT,
      /* min, max, act ct */ 0, 1, 0,
-     /* opt state flags  */ OPTST_IMM | OPTST_NO_INIT, AOUSE_HELP,
+     /* opt state flags  */ OPTST_IMM | OPTST_NO_INIT, 0,
      /* last opt argumnt */ { NULL },
      /* arg list/cookie  */ NULL,
      /* must/cannot opts */ NULL, NULL,
@@ -279,7 +267,7 @@ static tOptDesc optDesc[OPTION_CT] = {
      /* equiv idx value  */ NO_EQUIVALENT, VALUE_OPT_MORE_HELP,
      /* equivalenced to  */ NO_EQUIVALENT,
      /* min, max, act ct */ 0, 1, 0,
-     /* opt state flags  */ MORE_HELP_FLAGS, AOUSE_MORE_HELP,
+     /* opt state flags  */ MORE_HELP_FLAGS, 0,
      /* last opt argumnt */ { NULL },
      /* arg list/cookie  */ NULL,
      /* must/cannot opts */ NULL,  NULL,
@@ -289,24 +277,19 @@ static tOptDesc optDesc[OPTION_CT] = {
 };
 
 
-/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
-/** Reference to the upper cased version of ocserv. */
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
+ *
+ *  Define the ocserv Option Environment
+ */
 #define zPROGNAME       (ocserv_opt_strs+1173)
-/** Reference to the title line for ocserv usage. */
 #define zUsageTitle     (ocserv_opt_strs+1180)
-/** There is no ocserv configuration file. */
 #define zRcName         NULL
-/** There are no directories to search for ocserv config files. */
 #define apzHomeList     NULL
-/** The ocserv program bug email address. */
-#define zBugsAddr       (ocserv_opt_strs+1266)
-/** Clarification/explanation of what ocserv does. */
-#define zExplain        (ocserv_opt_strs+1304)
-/** Extra detail explaining what ocserv does. */
-#define zDetail         (ocserv_opt_strs+1306)
-/** The full version string for ocserv. */
-#define zFullVersion    (ocserv_opt_strs+1731)
-/* extracted from optcode.tlib near line 371 */
+#define zBugsAddr       (ocserv_opt_strs+1279)
+#define zExplain        (ocserv_opt_strs+1317)
+#define zDetail         (ocserv_opt_strs+1320)
+#define zFullVersion    (ocserv_opt_strs+1746)
+/* extracted from optcode.tlib near line 353 */
 
 #if defined(ENABLE_NLS)
 # define OPTPROC_BASE OPTPROC_TRANSLATE | OPTPROC_NXLAT_OPT
@@ -316,8 +299,10 @@ static tOptDesc optDesc[OPTION_CT] = {
 # define translate_option_strings NULL
 #endif /* ENABLE_NLS */
 
+
 #define ocserv_full_usage (NULL)
-#define ocserv_short_usage (ocserv_opt_strs+1744)
+
+#define ocserv_short_usage (ocserv_opt_strs+1759)
 
 #endif /* not defined __doxygen__ */
 
@@ -327,8 +312,8 @@ static tOptDesc optDesc[OPTION_CT] = {
 /**
  * The callout function that invokes the optionUsage function.
  *
- * @param[in] pOptions the AutoOpts option description structure
- * @param[in] pOptDesc the descriptor for the "help" (usage) option.
+ * @param pOptions the AutoOpts option description structure
+ * @param pOptDesc the descriptor for the "help" (usage) option.
  * @noreturn
  */
 static void
@@ -344,8 +329,8 @@ doUsageOpt(tOptions * pOptions, tOptDesc * pOptDesc)
 /**
  * Code to handle the config option.
  *
- * @param[in] pOptions the ocserv options data structure
- * @param[in,out] pOptDesc the option descriptor for this option.
+ * @param pOptions the ocserv options data structure
+ * @param pOptDesc the option descriptor for this option.
  */
 static void
 doOptConfig(tOptions* pOptions, tOptDesc* pOptDesc)
@@ -363,7 +348,7 @@ doOptConfig(tOptions* pOptions, tOptDesc* pOptDesc)
      */
     optionFileCheck(pOptions, pOptDesc, type, mode);
 }
-/* extracted from optmain.tlib near line 1254 */
+/* extracted from optmain.tlib near line 1188 */
 
 /**
  * The directory containing the data associated with ocserv.
@@ -379,7 +364,6 @@ doOptConfig(tOptions* pOptions, tOptDesc* pOptDesc)
 #ifndef  WITH_PACKAGER
 # define ocserv_packager_info NULL
 #else
-/** Packager information for ocserv. */
 static char const ocserv_packager_info[] =
     "Packaged by " WITH_PACKAGER
 
@@ -434,11 +418,6 @@ tOptions ocservOptions = {
 };
 
 #if ENABLE_NLS
-/**
- * This code is designed to translate translatable option text for the
- * ocserv program.  These translations happen upon entry
- * to optionProcess().
- */
 #include <stdio.h>
 #include <stdlib.h>
 #include <string.h>
@@ -517,8 +496,9 @@ translate_option_strings(void)
          *  Do the translations.  The first pointer follows the field count
          *  field.  The field count field is the size of a pointer.
          */
-        char ** ppz = (char**)(void*)&(option_xlateable_txt);
-        int     ix  = option_xlateable_txt.field_ct;
+        tOptDesc * od = opts->pOptDesc;
+        char **    ppz = (char**)(void*)&(option_xlateable_txt);
+        int        ix  = option_xlateable_txt.field_ct;
 
         do {
             ppz++; /* skip over field_ct */
@@ -533,391 +513,28 @@ translate_option_strings(void)
         coerce_it((void*)&(opts->pzUsageTitle));
         coerce_it((void*)&(opts->pzExplain));
         coerce_it((void*)&(opts->pzDetail));
-        {
-            tOptDesc * od = opts->pOptDesc;
-            for (ix = opts->optCt; ix > 0; ix--, od++)
-                coerce_it((void*)&(od->pzText));
+        coerce_it((void*)&(opts->pzPackager));
+        coerce_it((void*)&(opts->pzShortUsage));
+
+        for (ix = opts->optCt; ix > 0; ix--, od++)
+            coerce_it((void*)&(od->pzText));
+    }
+
+    if ((opts->fOptSet & OPTPROC_NXLAT_OPT_CFG) == 0) {
+        tOptDesc * od = opts->pOptDesc;
+        int        ix;
+
+        for (ix = opts->optCt; ix > 0; ix--, od++) {
+            coerce_it((void*)&(od->pz_Name));
+            coerce_it((void*)&(od->pz_DisableName));
+            coerce_it((void*)&(od->pz_DisablePfx));
         }
+        ocservOptions.fOptSet |= OPTPROC_NXLAT_OPT_CFG | OPTPROC_NXLAT_OPT;
     }
 }
+
 #endif /* ENABLE_NLS */
 
-#ifdef DO_NOT_COMPILE_THIS_CODE_IT_IS_FOR_GETTEXT
-/** I18N function strictly for xgettext.  Do not compile. */
-static void bogus_function(void) {
-  /* TRANSLATORS:
-
-     The following dummy function was crated solely so that xgettext can extract
-     the correct strings.  These strings are actually referenced by a field name
-     in the ocservOptions structure noted in the comments below.  The
-     literal text is defined in ocserv_opt_strs.
-   
-     NOTE: the strings below are segmented with respect to the source string
-     ocserv_opt_strs.  The strings above are handed off for translation
-     at run time a paragraph at a time.  Consequently, they are presented here
-     for translation a paragraph at a time.
-   
-     ALSO: often the description for an option will reference another option
-     by name.  These are set off with apostrophe quotes (I hope).  Do not
-     translate option names.
-   */
-  /* referenced via ocservOptions.pzCopyright */
-  puts(_("ocserv 0.1.5\n\
-Copyright (C) 2013 Nikos Mavrogiannopoulos, all rights reserved.\n\
-This is free software. It is licensed for use, modification and\n\
-redistribution under the terms of the GNU General Public License,\n\
-version 2 <http://gnu.org/licenses/gpl.html>\n"));
-
-  /* referenced via ocservOptions.pzCopyNotice */
-  puts(_("ocserv is free software: you can redistribute it and/or modify it under the\n\
-terms of version 2 of the GNU General Public License, as published by the\n\
-Free Software Foundation.\n\n"));
-  puts(_("ocserv is distributed in the hope that it will be useful, but WITHOUT ANY\n\
-WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS\n\
-FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more\n\
-details.\n\n"));
-  puts(_("You should have received a copy of the GNU General Public License, version\n\
-2, along with this program.  If not, see <http://www.gnu.org/licenses/>.\n"));
-
-  /* referenced via ocservOptions.pOptDesc->pzText */
-  puts(_("Do not fork into background"));
-
-  /* referenced via ocservOptions.pOptDesc->pzText */
-  puts(_("Enable verbose TLS debugging information"));
-
-  /* referenced via ocservOptions.pOptDesc->pzText */
-  puts(_("Enable verbose network debugging information"));
-
-  /* referenced via ocservOptions.pOptDesc->pzText */
-  puts(_("Configuration file for the server"));
-
-  /* referenced via ocservOptions.pOptDesc->pzText */
-  puts(_("display extended usage information and exit"));
-
-  /* referenced via ocservOptions.pOptDesc->pzText */
-  puts(_("extended usage information passed thru pager"));
-
-  /* referenced via ocservOptions.pOptDesc->pzText */
-  puts(_("output version information and exit"));
-
-  /* referenced via ocservOptions.pzUsageTitle */
-  puts(_("ocserv - OpenConnect server\n\
-Usage:  %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
-
-  /* referenced via ocservOptions.pzExplain */
-  puts(_("\n"));
-
-  /* referenced via ocservOptions.pzDetail */
-  puts(_("Openconnect VPN server (ocserv) is a VPN server compatible with the\n\
-openconnect VPN client.  It follows the AnyConnect VPN protocol which is\n\
-used by several CISCO routers.\n\n"));
-  puts(_("This server supports multiple authentication methods, including PAM and\n\
-certificate authentication.  Authenticated users are assigned an\n\
-unprivileged worker process and obtain a networking (tun) device and an IP\n\
-from a configurable pool of addresses.\n"));
-
-  /* referenced via ocservOptions.pzFullVersion */
-  puts(_("ocserv 0.1.5"));
-
-  /* referenced via ocservOptions.pzFullUsage */
-  puts(_("<<<NOT-FOUND>>>"));
-
-  /* referenced via ocservOptions.pzShortUsage */
-  puts(_("Usage: ocserv [options] -c [config]\n\
-ocserv --help for usage instructions.\n"));
-  /* LIBOPTS-MESSAGES: */
-#line 60 "../autoopts.c"
-  puts(_("allocation of %d bytes failed\n"));
-#line 86 "../autoopts.c"
-  puts(_("allocation of %d bytes failed\n"));
-#line 53 "../init.c"
-  puts(_("AutoOpts function called without option descriptor\n"));
-#line 89 "../init.c"
-  puts(_("\tThis exceeds the compiled library version:  "));
-#line 87 "../init.c"
-  puts(_("Automated Options Processing Error!\n"
-       "\t%s called AutoOpts function with structure version %d:%d:%d.\n"));
-#line 73 "../autoopts.c"
-  puts(_("realloc of %d bytes at 0x%p failed\n"));
-#line 91 "../init.c"
-  puts(_("\tThis is less than the minimum library version:  "));
-#line 121 "../version.c"
-  puts(_("Automated Options version %s\n"
-       "\tCopyright (C) 1999-2013 by Bruce Korb - all rights reserved\n"));
-#line 310 "../usage.c"
-  puts(_("(AutoOpts bug):  %s.\n"));
-#line 90 "../reset.c"
-  puts(_("optionResetOpt() called, but reset-option not configured"));
-#line 329 "../usage.c"
-  puts(_("could not locate the 'help' option"));
-#line 351 "../autoopts.c"
-  puts(_("optionProcess() was called with invalid data"));
-#line 783 "../usage.c"
-  puts(_("invalid argument type specified"));
-#line 589 "../find.c"
-  puts(_("defaulted to option with optional arg"));
-#line 76 "../alias.c"
-  puts(_("aliasing option is out of range."));
-#line 229 "../enum.c"
-  puts(_("%s error:  the keyword '%s' is ambiguous for %s\n"));
-#line 108 "../find.c"
-  puts(_("  The following options match:\n"));
-#line 290 "../find.c"
-  puts(_("%s: ambiguous option name: %s (matches %d options)\n"));
-#line 161 "../check.c"
-  puts(_("%s: Command line arguments required\n"));
-#line 43 "../alias.c"
-  puts(_("%d %s%s options allowed\n"));
-#line 81 "../makeshell.c"
-  puts(_("%s error %d (%s) calling %s for '%s'\n"));
-#line 293 "../makeshell.c"
-  puts(_("interprocess pipe"));
-#line 168 "../version.c"
-  puts(_("error: version option argument '%c' invalid.  Use:\n"
-       "\t'v' - version only\n"
-       "\t'c' - version and copyright\n"
-       "\t'n' - version and full copyright notice\n"));
-#line 58 "../check.c"
-  puts(_("%s error:  the '%s' and '%s' options conflict\n"));
-#line 214 "../find.c"
-  puts(_("%s: The '%s' option has been disabled."));
-#line 421 "../find.c"
-  puts(_("%s: The '%s' option has been disabled."));
-#line 38 "../alias.c"
-  puts(_("-equivalence"));
-#line 460 "../find.c"
-  puts(_("%s: illegal option -- %c\n"));
-#line 110 "../reset.c"
-  puts(_("%s: illegal option -- %c\n"));
-#line 268 "../find.c"
-  puts(_("%s: illegal option -- %s\n"));
-#line 746 "../find.c"
-  puts(_("%s: illegal option -- %s\n"));
-#line 118 "../reset.c"
-  puts(_("%s: illegal option -- %s\n"));
-#line 332 "../find.c"
-  puts(_("%s: unknown vendor extension option -- %s\n"));
-#line 154 "../enum.c"
-  puts(_("  or an integer from %d through %d\n"));
-#line 164 "../enum.c"
-  puts(_("  or an integer from %d through %d\n"));
-#line 782 "../usage.c"
-  puts(_("%s error:  invalid option descriptor for %s\n"));
-#line 1110 "../usage.c"
-  puts(_("%s error:  invalid option descriptor for %s\n"));
-#line 379 "../find.c"
-  puts(_("%s: invalid option name: %s\n"));
-#line 518 "../find.c"
-  puts(_("%s: The '%s' option requires an argument.\n"));
-#line 171 "../autoopts.c"
-  puts(_("(AutoOpts bug):  Equivalenced option '%s' was equivalenced to both\n"
-       "\t'%s' and '%s'."));
-#line 94 "../check.c"
-  puts(_("%s error:  The %s option is required\n"));
-#line 623 "../find.c"
-  puts(_("%s: The '%s' option cannot have an argument.\n"));
-#line 151 "../check.c"
-  puts(_("%s: Command line arguments are not allowed.\n"));
-#line 531 "../save.c"
-  puts(_("error %d (%s) creating %s\n"));
-#line 229 "../enum.c"
-  puts(_("%s error:  '%s' does not match any %s keywords.\n"));
-#line 93 "../reset.c"
-  puts(_("%s error: The '%s' option requires an argument.\n"));
-#line 184 "../save.c"
-  puts(_("error %d (%s) stat-ing %s\n"));
-#line 238 "../save.c"
-  puts(_("error %d (%s) stat-ing %s\n"));
-#line 143 "../restore.c"
-  puts(_("%s error: no saved option state\n"));
-#line 246 "../autoopts.c"
-  puts(_("'%s' is not a command line option.\n"));
-#line 114 "../time.c"
-  puts(_("%s error:  '%s' is not a recognizable date/time.\n"));
-#line 132 "../save.c"
-  puts(_("'%s' not defined\n"));
-#line 53 "../time.c"
-  puts(_("%s error:  '%s' is not a recognizable time duration.\n"));
-#line 92 "../check.c"
-  puts(_("%s error:  The %s option must appear %d times.\n"));
-#line 157 "../numeric.c"
-  puts(_("%s error:  '%s' is not a recognizable number.\n"));
-#line 195 "../enum.c"
-  puts(_("%s error:  %s exceeds %s keyword count\n"));
-#line 366 "../usage.c"
-  puts(_("Try '%s %s' for more information.\n"));
-#line 45 "../alias.c"
-  puts(_("one %s%s option allowed\n"));
-#line 195 "../makeshell.c"
-  puts(_("standard output"));
-#line 930 "../makeshell.c"
-  puts(_("standard output"));
-#line 304 "../usage.c"
-  puts(_("standard output"));
-#line 451 "../usage.c"
-  puts(_("standard output"));
-#line 660 "../usage.c"
-  puts(_("standard output"));
-#line 175 "../version.c"
-  puts(_("standard output"));
-#line 304 "../usage.c"
-  puts(_("standard error"));
-#line 451 "../usage.c"
-  puts(_("standard error"));
-#line 660 "../usage.c"
-  puts(_("standard error"));
-#line 175 "../version.c"
-  puts(_("standard error"));
-#line 195 "../makeshell.c"
-  puts(_("write"));
-#line 930 "../makeshell.c"
-  puts(_("write"));
-#line 303 "../usage.c"
-  puts(_("write"));
-#line 450 "../usage.c"
-  puts(_("write"));
-#line 659 "../usage.c"
-  puts(_("write"));
-#line 174 "../version.c"
-  puts(_("write"));
-#line 60 "../numeric.c"
-  puts(_("%s error:  %s option value %ld is out of range.\n"));
-#line 44 "../check.c"
-  puts(_("%s error:  %s option requires the %s option\n"));
-#line 131 "../save.c"
-  puts(_("%s warning:  cannot save options - %s not regular file\n"));
-#line 183 "../save.c"
-  puts(_("%s warning:  cannot save options - %s not regular file\n"));
-#line 237 "../save.c"
-  puts(_("%s warning:  cannot save options - %s not regular file\n"));
-#line 256 "../save.c"
-  puts(_("%s warning:  cannot save options - %s not regular file\n"));
-#line 530 "../save.c"
-  puts(_("%s warning:  cannot save options - %s not regular file\n"));
-  /* END-LIBOPTS-MESSAGES */
-
-  /* USAGE-TEXT: */
-#line 908 "../usage.c"
-  puts(_("\t\t\t\t- an alternate for '%s'\n"));
-#line 1177 "../usage.c"
-  puts(_("Version, usage and configuration options:"));
-#line 959 "../usage.c"
-  puts(_("\t\t\t\t- default option for unnamed options\n"));
-#line 872 "../usage.c"
-  puts(_("\t\t\t\t- disabled as '--%s'\n"));
-#line 1146 "../usage.c"
-  puts(_(" --- %-14s %s\n"));
-#line 1144 "../usage.c"
-  puts(_("This option has been disabled"));
-#line 899 "../usage.c"
-  puts(_("\t\t\t\t- enabled by default\n"));
-#line 40 "../alias.c"
-  puts(_("%s error:  only "));
-#line 1221 "../usage.c"
-  puts(_(" - examining environment variables named %s_*\n"));
-#line 168 "../file.c"
-  puts(_("\t\t\t\t- file must not pre-exist\n"));
-#line 172 "../file.c"
-  puts(_("\t\t\t\t- file must pre-exist\n"));
-#line 416 "../usage.c"
-  puts(_("Options are specified by doubled hyphens and their name or by a single\n"
-       "hyphen and the flag character.\n"));
-#line 908 "../makeshell.c"
-  puts(_("\n"
-       "= = = = = = = =\n\n"
-       "This incarnation of genshell will produce\n"
-       "a shell script to parse the options for %s:\n\n"));
-#line 161 "../enum.c"
-  puts(_("  or an integer mask with any of the lower %d bits set\n"));
-#line 932 "../usage.c"
-  puts(_("\t\t\t\t- is a set membership option\n"));
-#line 953 "../usage.c"
-  puts(_("\t\t\t\t- must appear between %d and %d times\n"));
-#line 418 "../usage.c"
-  puts(_("Options are specified by single or double hyphens and their name.\n"));
-#line 939 "../usage.c"
-  puts(_("\t\t\t\t- may appear multiple times\n"));
-#line 926 "../usage.c"
-  puts(_("\t\t\t\t- may not be preset\n"));
-#line 1336 "../usage.c"
-  puts(_("   Arg Option-Name    Description\n"));
-#line 1272 "../usage.c"
-  puts(_("  Flg Arg Option-Name    Description\n"));
-#line 1330 "../usage.c"
-  puts(_("  Flg Arg Option-Name    Description\n"));
-#line 1331 "../usage.c"
-  puts(_(" %3s %s"));
-#line 1337 "../usage.c"
-  puts(_(" %3s %s"));
-#line 423 "../usage.c"
-  puts(_("The '-#<number>' option may omit the hash char\n"));
-#line 419 "../usage.c"
-  puts(_("All arguments are named options.\n"));
-#line 1006 "../usage.c"
-  puts(_(" - reading file %s"));
-#line 445 "../usage.c"
-  puts(_("\n"
-       "Please send bug reports to:  <%s>\n"));
-#line 100 "../version.c"
-  puts(_("\n"
-       "Please send bug reports to:  <%s>\n"));
-#line 129 "../version.c"
-  puts(_("\n"
-       "Please send bug reports to:  <%s>\n"));
-#line 938 "../usage.c"
-  puts(_("\t\t\t\t- may NOT appear - preset only\n"));
-#line 978 "../usage.c"
-  puts(_("\n"
-       "The following option preset mechanisms are supported:\n"));
-#line 1219 "../usage.c"
-  puts(_("\n"
-       "The following option preset mechanisms are supported:\n"));
-#line 717 "../usage.c"
-  puts(_("prohibits these options:\n"));
-#line 712 "../usage.c"
-  puts(_("prohibits the option '%s'\n"));
-#line 81 "../numeric.c"
-  puts(_("%s%ld to %ld"));
-#line 79 "../numeric.c"
-  puts(_("%sgreater than or equal to %ld"));
-#line 75 "../numeric.c"
-  puts(_("%s%ld exactly"));
-#line 68 "../numeric.c"
-  puts(_("%sit must lie in one of the ranges:\n"));
-#line 68 "../numeric.c"
-  puts(_("%sit must be in the range:\n"));
-#line 88 "../numeric.c"
-  puts(_(", or\n"));
-#line 66 "../numeric.c"
-  puts(_("%sis scalable with a suffix: k/K/m/M/g/G/t/T\n"));
-#line 77 "../numeric.c"
-  puts(_("%sless than or equal to %ld"));
-#line 426 "../usage.c"
-  puts(_("Operands and options may be intermixed.  They will be reordered.\n"));
-#line 687 "../usage.c"
-  puts(_("requires the option '%s'\n"));
-#line 690 "../usage.c"
-  puts(_("requires these options:\n"));
-#line 1348 "../usage.c"
-  puts(_("   Arg Option-Name   Req?  Description\n"));
-#line 1342 "../usage.c"
-  puts(_("  Flg Arg Option-Name   Req?  Description\n"));
-#line 162 "../enum.c"
-  puts(_("or you may use a numeric representation.  Preceding these with a '!'\n"
-       "will clear the bits, specifying 'none' will clear all bits, and 'all'\n"
-       "will set them all.  Multiple entries may be passed as an option\n"
-       "argument list.\n"));
-#line 945 "../usage.c"
-  puts(_("\t\t\t\t- may appear up to %d times\n"));
-#line 72 "../enum.c"
-  puts(_("The valid \"%s\" option keywords are:\n"));
-#line 1181 "../usage.c"
-  puts(_("The next option supports vendor supported extra options:"));
-#line 808 "../usage.c"
-  puts(_("These additional options are:"));
-  /* END-USAGE-TEXT */
-}
-#endif /* uncompilable code */
 #ifdef  __cplusplus
 }
 #endif

src/ocserv-args.def

@@ -237,7 +237,7 @@ ipv4-dns = 192.168.1.2
 #ipv4-nbns = 192.168.1.3
 
 # The same, but for IPv6.
-#ipv6-address = 
+#ipv6-network = 
 #ipv6-mask = 
 #ipv6-dns = 
 #ipv6-nbns = 

src/ocserv-args.h

@@ -1,12 +1,12 @@
 /*   -*- buffer-read-only: t -*- vi: set ro:
- *
+ *  
  *  DO NOT EDIT THIS FILE   (ocserv-args.h)
- *
- *  It has been AutoGen-ed  August  3, 2013 at 10:51:57 AM by AutoGen 5.17.3
+ *  
+ *  It has been AutoGen-ed  October  5, 2013 at 09:36:46 AM by AutoGen 5.17
  *  From the definitions    ocserv-args.def
  *  and the template file   options
  *
- * Generated from AutoOpts 38:0:13 templates.
+ * Generated from AutoOpts 37:0:12 templates.
  *
  *  AutoOpts is a copyrighted work.  This header file is not encumbered
  *  by AutoOpts licensing, but is provided under the licensing terms chosen
@@ -21,23 +21,23 @@
  *
  *  Copyright (C) 2013 Nikos Mavrogiannopoulos, all rights reserved.
  *  This is free software. It is licensed for use, modification and
- *  redistribution under the terms of the GNU General Public License,
- *  version 2 <http://gnu.org/licenses/gpl.html>
+ *  redistribution under the terms of the
+ *  GNU General Public License, version 2 <http://gnu.org/licenses/gpl.html>
  *
  *  ocserv is free software: you can redistribute it and/or modify it
  *  under the terms of version 2 of the GNU General Public License,
  *  as published by the Free Software Foundation.
- *
+ *  
  *  ocserv is distributed in the hope that it will be useful, but
  *  WITHOUT ANY WARRANTY; without even the implied warranty of
  *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  *  See the GNU General Public License for more details.
- *
+ *  
  *  You should have received a copy of the GNU General Public License,
  *  version 2, along with this program.
  *  If not, see <http://www.gnu.org/licenses/>.
  */
-/**
+/*
  *  This file contains the programmatic interface to the Automated
  *  Options generated for the ocserv program.
  *  These macros are documented in the AutoGen info file in the
@@ -48,22 +48,22 @@
 #include "config.h"
 #include <autoopts/options.h>
 
-/**
+/*
  *  Ensure that the library used for compiling this generated header is at
  *  least as new as the version current when the header template was released
  *  (not counting patch version increments).  Also ensure that the oldest
  *  tolerable version is at least as old as what was current when the header
  *  template was released.
  */
-#define AO_TEMPLATE_VERSION 155648
+#define AO_TEMPLATE_VERSION 151552
 #if (AO_TEMPLATE_VERSION < OPTIONS_MINIMUM_VERSION) \
  || (AO_TEMPLATE_VERSION > OPTIONS_STRUCT_VERSION)
 # error option template version mismatches autoopts/options.h header
   Choke Me.
 #endif
 
-/**
- *  Enumeration of each option type for ocserv
+/*
+ *  Enumeration of each option:
  */
 typedef enum {
     INDEX_OPT_FOREGROUND  =  0,
@@ -74,51 +74,34 @@ typedef enum {
     INDEX_OPT_HELP        =  5,
     INDEX_OPT_MORE_HELP   =  6
 } teOptIndex;
-/** count of all options for ocserv */
-#define OPTION_CT    7
-/** ocserv version */
-#define OCSERV_VERSION       "0.1.5"
-/** Full ocserv version text */
-#define OCSERV_FULL_VERSION  "ocserv 0.1.5"
 
-/**
+#define OPTION_CT    7
+#define OCSERV_VERSION       "0.1.6"
+#define OCSERV_FULL_VERSION  "ocserv 0.1.6"
+
+/*
  *  Interface defines for all options.  Replace "n" with the UPPER_CASED
  *  option name (as in the teOptIndex enumeration above).
  *  e.g. HAVE_OPT(FOREGROUND)
  */
 #define         DESC(n) (ocservOptions.pOptDesc[INDEX_OPT_## n])
-/** 'true' if an option has been specified in any way */
 #define     HAVE_OPT(n) (! UNUSED_OPT(& DESC(n)))
-/** The string argument to an option. The argument type must be "string". */
 #define      OPT_ARG(n) (DESC(n).optArg.argString)
-/** Mask the option state revealing how an option was specified.
- *  It will be one and only one of \a OPTST_SET, \a OPTST_PRESET,
- * \a OPTST_DEFINED, \a OPTST_RESET or zero.
- */
 #define    STATE_OPT(n) (DESC(n).fOptState & OPTST_SET_MASK)
-/** Count of option's occurrances *on the command line*. */
 #define    COUNT_OPT(n) (DESC(n).optOccCt)
-/** mask of \a OPTST_SET and \a OPTST_DEFINED. */
 #define    ISSEL_OPT(n) (SELECTED_OPT(&DESC(n)))
-/** 'true' if \a HAVE_OPT would yield 'false'. */
 #define ISUNUSED_OPT(n) (UNUSED_OPT(& DESC(n)))
-/** 'true' if OPTST_DISABLED bit not set. */
 #define  ENABLED_OPT(n) (! DISABLED_OPT(& DESC(n)))
-/** number of stacked option arguments.
- *  Valid only for stacked option arguments. */
 #define  STACKCT_OPT(n) (((tArgList*)(DESC(n).optCookie))->useCt)
-/** stacked argument vector.
- *  Valid only for stacked option arguments. */
 #define STACKLST_OPT(n) (((tArgList*)(DESC(n).optCookie))->apzArgs)
-/** Reset an option. */
 #define    CLEAR_OPT(n) STMTS( \
                 DESC(n).fOptState &= OPTST_PERSISTENT_MASK;   \
                 if ((DESC(n).fOptState & OPTST_INITENABLED) == 0) \
                     DESC(n).fOptState |= OPTST_DISABLED; \
                 DESC(n).optCookie = NULL )
 
-/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
-/**
+/* * * * * *
+ *
  *  Enumeration of ocserv exit codes
  */
 typedef enum {
@@ -127,20 +110,16 @@ typedef enum {
     OCSERV_EXIT_USAGE_ERROR         = 64,
     OCSERV_EXIT_LIBOPTS_FAILURE     = 70
 } ocserv_exit_code_t;
-/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
-/**
+/* * * * * *
+ *
  *  Interface defines for specific options.
- * @{
  */
 #define VALUE_OPT_FOREGROUND     'f'
 #define VALUE_OPT_TLS_DEBUG      1
 #define VALUE_OPT_DEBUG          'd'
 #define VALUE_OPT_CONFIG         'c'
-/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_HELP          'h'
-/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_MORE_HELP     '!'
-/** option flag (value) for " (get "val-name") " option */
 #define VALUE_OPT_VERSION       'v'
 /*
  *  Interface defines not associated with particular options
@@ -152,7 +131,7 @@ typedef enum {
                 ocservOptions.pzCurOpt  = NULL)
 #define START_OPT       RESTART_OPT(1)
 #define USAGE(c)        (*ocservOptions.pUsageProc)(&ocservOptions, c)
-/* extracted from opthead.tlib near line 538 */
+/* extracted from opthead.tlib near line 497 */
 
 #ifdef  __cplusplus
 extern "C" {