1 /* $NetBSD: ntpsnmpd-opts.c,v 1.15 2024/08/18 20:47:19 christos Exp $ */ 2 3 /* 4 * EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.c) 5 * 6 * It has been AutoGen-ed May 25, 2024 at 12:04:35 AM by AutoGen 5.18.16 7 * From the definitions ntpsnmpd-opts.def 8 * and the template file options 9 * 10 * Generated from AutoOpts 42:1:17 templates. 11 * 12 * AutoOpts is a copyrighted work. This source file is not encumbered 13 * by AutoOpts licensing, but is provided under the licensing terms chosen 14 * by the ntpsnmpd author or copyright holder. AutoOpts is 15 * licensed under the terms of the LGPL. The redistributable library 16 * (``libopts'') is licensed under the terms of either the LGPL or, at the 17 * users discretion, the BSD license. See the AutoOpts and/or libopts sources 18 * for details. 19 * 20 * The ntpsnmpd program is copyrighted and licensed 21 * under the following terms: 22 * 23 * Copyright (C) 1992-2024 The University of Delaware and Network Time Foundation, all rights reserved. 24 * This is free software. It is licensed for use, modification and 25 * redistribution under the terms of the NTP License, copies of which 26 * can be seen at: 27 * <http://ntp.org/license> 28 * <http://opensource.org/licenses/ntp-license.php> 29 * 30 * Permission to use, copy, modify, and distribute this software and its 31 * documentation for any purpose with or without fee is hereby granted, 32 * provided that the above copyright notice appears in all copies and that 33 * both the copyright notice and this permission notice appear in 34 * supporting documentation, and that the name The University of Delaware not be used in 35 * advertising or publicity pertaining to distribution of the software 36 * without specific, written prior permission. The University of Delaware and Network Time Foundation makes no 37 * representations about the suitability this software for any purpose. It 38 * is provided "as is" without express or implied warranty. 39 */ 40 41 #ifndef __doxygen__ 42 #define OPTION_CODE_COMPILE 1 43 #include "ntpsnmpd-opts.h" 44 #include <sys/types.h> 45 #include <sys/stat.h> 46 47 #include <errno.h> 48 #include <fcntl.h> 49 #include <limits.h> 50 #include <stdio.h> 51 #include <stdlib.h> 52 #include <string.h> 53 #include <unistd.h> 54 55 #ifdef __cplusplus 56 extern "C" { 57 #endif 58 extern FILE * option_usage_fp; 59 #define zCopyright (ntpsnmpd_opt_strs+0) 60 #define zLicenseDescrip (ntpsnmpd_opt_strs+345) 61 62 63 #ifndef NULL 64 # define NULL 0 65 #endif 66 67 /** 68 * static const strings for ntpsnmpd options 69 */ 70 static char const ntpsnmpd_opt_strs[1614] = 71 /* 0 */ "ntpsnmpd 4.2.8p18\n" 72 "Copyright (C) 1992-2024 The University of Delaware and Network Time Foundation, all rights reserved.\n" 73 "This is free software. It is licensed for use, modification and\n" 74 "redistribution under the terms of the NTP License, copies of which\n" 75 "can be seen at:\n" 76 " <http://ntp.org/license>\n" 77 " <http://opensource.org/licenses/ntp-license.php>\n\0" 78 /* 345 */ "Permission to use, copy, modify, and distribute this software and its\n" 79 "documentation for any purpose with or without fee is hereby granted,\n" 80 "provided that the above copyright notice appears in all copies and that\n" 81 "both the copyright notice and this permission notice appear in supporting\n" 82 "documentation, and that the name The University of Delaware not be used in\n" 83 "advertising or publicity pertaining to distribution of the software without\n" 84 "specific, written prior permission. The University of Delaware and Network\n" 85 "Time Foundation makes no representations about the suitability this\n" 86 "software for any purpose. It is provided \"as is\" without express or\n" 87 "implied warranty.\n\0" 88 /* 1013 */ "Do not fork\0" 89 /* 1025 */ "NOFORK\0" 90 /* 1032 */ "nofork\0" 91 /* 1039 */ "Log to syslog()\0" 92 /* 1055 */ "SYSLOG\0" 93 /* 1062 */ "syslog\0" 94 /* 1069 */ "The socket address ntpsnmpd uses to connect to net-snmpd\0" 95 /* 1126 */ "AGENTXSOCKET\0" 96 /* 1139 */ "agentxsocket\0" 97 /* 1152 */ "unix:/var/agentx/master\0" 98 /* 1176 */ "display extended usage information and exit\0" 99 /* 1220 */ "help\0" 100 /* 1225 */ "extended usage information passed thru pager\0" 101 /* 1270 */ "more-help\0" 102 /* 1280 */ "output version information and exit\0" 103 /* 1316 */ "version\0" 104 /* 1324 */ "save the option state to a config file\0" 105 /* 1363 */ "save-opts\0" 106 /* 1373 */ "load options from a config file\0" 107 /* 1405 */ "LOAD_OPTS\0" 108 /* 1415 */ "no-load-opts\0" 109 /* 1428 */ "no\0" 110 /* 1431 */ "NTPSNMPD\0" 111 /* 1440 */ "ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.8p18\n" 112 "Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n\0" 113 /* 1544 */ "$HOME\0" 114 /* 1550 */ ".\0" 115 /* 1552 */ ".ntprc\0" 116 /* 1559 */ "https://bugs.ntp.org, bugs (at) ntp.org\0" 117 /* 1594 */ "\n\0" 118 /* 1596 */ "ntpsnmpd 4.2.8p18"; 119 120 /** 121 * nofork option description: 122 */ 123 /** Descriptive text for the nofork option */ 124 #define NOFORK_DESC (ntpsnmpd_opt_strs+1013) 125 /** Upper-cased name for the nofork option */ 126 #define NOFORK_NAME (ntpsnmpd_opt_strs+1025) 127 /** Name string for the nofork option */ 128 #define NOFORK_name (ntpsnmpd_opt_strs+1032) 129 /** Compiled in flag settings for the nofork option */ 130 #define NOFORK_FLAGS (OPTST_DISABLED) 131 132 /** 133 * syslog option description: 134 */ 135 /** Descriptive text for the syslog option */ 136 #define SYSLOG_DESC (ntpsnmpd_opt_strs+1039) 137 /** Upper-cased name for the syslog option */ 138 #define SYSLOG_NAME (ntpsnmpd_opt_strs+1055) 139 /** Name string for the syslog option */ 140 #define SYSLOG_name (ntpsnmpd_opt_strs+1062) 141 /** Compiled in flag settings for the syslog option */ 142 #define SYSLOG_FLAGS (OPTST_DISABLED) 143 144 /** 145 * agentXSocket option description: 146 */ 147 /** Descriptive text for the agentXSocket option */ 148 #define AGENTXSOCKET_DESC (ntpsnmpd_opt_strs+1069) 149 /** Upper-cased name for the agentXSocket option */ 150 #define AGENTXSOCKET_NAME (ntpsnmpd_opt_strs+1126) 151 /** Name string for the agentXSocket option */ 152 #define AGENTXSOCKET_name (ntpsnmpd_opt_strs+1139) 153 /** The compiled in default value for the agentXSocket option argument */ 154 #define AGENTXSOCKET_DFT_ARG (ntpsnmpd_opt_strs+1152) 155 /** Compiled in flag settings for the agentXSocket option */ 156 #define AGENTXSOCKET_FLAGS (OPTST_DISABLED \ 157 | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING)) 158 159 /* 160 * Help/More_Help/Version option descriptions: 161 */ 162 #define HELP_DESC (ntpsnmpd_opt_strs+1176) 163 #define HELP_name (ntpsnmpd_opt_strs+1220) 164 #ifdef HAVE_WORKING_FORK 165 #define MORE_HELP_DESC (ntpsnmpd_opt_strs+1225) 166 #define MORE_HELP_name (ntpsnmpd_opt_strs+1270) 167 #define MORE_HELP_FLAGS (OPTST_IMM | OPTST_NO_INIT) 168 #else 169 #define MORE_HELP_DESC HELP_DESC 170 #define MORE_HELP_name HELP_name 171 #define MORE_HELP_FLAGS (OPTST_OMITTED | OPTST_NO_INIT) 172 #endif 173 #ifdef NO_OPTIONAL_OPT_ARGS 174 # define VER_FLAGS (OPTST_IMM | OPTST_NO_INIT) 175 #else 176 # define VER_FLAGS (OPTST_SET_ARGTYPE(OPARG_TYPE_STRING) | \ 177 OPTST_ARG_OPTIONAL | OPTST_IMM | OPTST_NO_INIT) 178 #endif 179 #define VER_DESC (ntpsnmpd_opt_strs+1280) 180 #define VER_name (ntpsnmpd_opt_strs+1316) 181 #define SAVE_OPTS_DESC (ntpsnmpd_opt_strs+1324) 182 #define SAVE_OPTS_name (ntpsnmpd_opt_strs+1363) 183 #define LOAD_OPTS_DESC (ntpsnmpd_opt_strs+1373) 184 #define LOAD_OPTS_NAME (ntpsnmpd_opt_strs+1405) 185 #define NO_LOAD_OPTS_name (ntpsnmpd_opt_strs+1415) 186 #define LOAD_OPTS_pfx (ntpsnmpd_opt_strs+1428) 187 #define LOAD_OPTS_name (NO_LOAD_OPTS_name + 3) 188 /** 189 * Declare option callback procedures 190 */ 191 extern tOptProc 192 ntpOptionPrintVersion, optionBooleanVal, optionNestedVal, 193 optionNumericVal, optionPagedUsage, optionResetOpt, 194 optionStackArg, optionTimeDate, optionTimeVal, 195 optionUnstackArg, optionVendorOption; 196 static tOptProc 197 doUsageOpt; 198 #define VER_PROC ntpOptionPrintVersion 199 200 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ 201 /** 202 * Define the ntpsnmpd Option Descriptions. 203 * This is an array of OPTION_CT entries, one for each 204 * option that the ntpsnmpd program responds to. 205 */ 206 static tOptDesc optDesc[OPTION_CT] = { 207 { /* entry idx, value */ 0, VALUE_OPT_NOFORK, 208 /* equiv idx, value */ 0, VALUE_OPT_NOFORK, 209 /* equivalenced to */ NO_EQUIVALENT, 210 /* min, max, act ct */ 0, 1, 0, 211 /* opt state flags */ NOFORK_FLAGS, 0, 212 /* last opt argumnt */ { NULL }, /* --nofork */ 213 /* arg list/cookie */ NULL, 214 /* must/cannot opts */ NULL, NULL, 215 /* option proc */ NULL, 216 /* desc, NAME, name */ NOFORK_DESC, NOFORK_NAME, NOFORK_name, 217 /* disablement strs */ NULL, NULL }, 218 219 { /* entry idx, value */ 1, VALUE_OPT_SYSLOG, 220 /* equiv idx, value */ 1, VALUE_OPT_SYSLOG, 221 /* equivalenced to */ NO_EQUIVALENT, 222 /* min, max, act ct */ 0, 1, 0, 223 /* opt state flags */ SYSLOG_FLAGS, 0, 224 /* last opt argumnt */ { NULL }, /* --syslog */ 225 /* arg list/cookie */ NULL, 226 /* must/cannot opts */ NULL, NULL, 227 /* option proc */ NULL, 228 /* desc, NAME, name */ SYSLOG_DESC, SYSLOG_NAME, SYSLOG_name, 229 /* disablement strs */ NULL, NULL }, 230 231 { /* entry idx, value */ 2, VALUE_OPT_AGENTXSOCKET, 232 /* equiv idx, value */ 2, VALUE_OPT_AGENTXSOCKET, 233 /* equivalenced to */ NO_EQUIVALENT, 234 /* min, max, act ct */ 0, 1, 0, 235 /* opt state flags */ AGENTXSOCKET_FLAGS, 0, 236 /* last opt argumnt */ { AGENTXSOCKET_DFT_ARG }, 237 /* arg list/cookie */ NULL, 238 /* must/cannot opts */ NULL, NULL, 239 /* option proc */ NULL, 240 /* desc, NAME, name */ AGENTXSOCKET_DESC, AGENTXSOCKET_NAME, AGENTXSOCKET_name, 241 /* disablement strs */ NULL, NULL }, 242 243 { /* entry idx, value */ INDEX_OPT_VERSION, VALUE_OPT_VERSION, 244 /* equiv idx value */ NO_EQUIVALENT, VALUE_OPT_VERSION, 245 /* equivalenced to */ NO_EQUIVALENT, 246 /* min, max, act ct */ 0, 1, 0, 247 /* opt state flags */ VER_FLAGS, AOUSE_VERSION, 248 /* last opt argumnt */ { NULL }, 249 /* arg list/cookie */ NULL, 250 /* must/cannot opts */ NULL, NULL, 251 /* option proc */ VER_PROC, 252 /* desc, NAME, name */ VER_DESC, NULL, VER_name, 253 /* disablement strs */ NULL, NULL }, 254 255 256 257 { /* entry idx, value */ INDEX_OPT_HELP, VALUE_OPT_HELP, 258 /* equiv idx value */ NO_EQUIVALENT, VALUE_OPT_HELP, 259 /* equivalenced to */ NO_EQUIVALENT, 260 /* min, max, act ct */ 0, 1, 0, 261 /* opt state flags */ OPTST_IMM | OPTST_NO_INIT, AOUSE_HELP, 262 /* last opt argumnt */ { NULL }, 263 /* arg list/cookie */ NULL, 264 /* must/cannot opts */ NULL, NULL, 265 /* option proc */ doUsageOpt, 266 /* desc, NAME, name */ HELP_DESC, NULL, HELP_name, 267 /* disablement strs */ NULL, NULL }, 268 269 { /* entry idx, value */ INDEX_OPT_MORE_HELP, VALUE_OPT_MORE_HELP, 270 /* equiv idx value */ NO_EQUIVALENT, VALUE_OPT_MORE_HELP, 271 /* equivalenced to */ NO_EQUIVALENT, 272 /* min, max, act ct */ 0, 1, 0, 273 /* opt state flags */ MORE_HELP_FLAGS, AOUSE_MORE_HELP, 274 /* last opt argumnt */ { NULL }, 275 /* arg list/cookie */ NULL, 276 /* must/cannot opts */ NULL, NULL, 277 /* option proc */ optionPagedUsage, 278 /* desc, NAME, name */ MORE_HELP_DESC, NULL, MORE_HELP_name, 279 /* disablement strs */ NULL, NULL }, 280 281 { /* entry idx, value */ INDEX_OPT_SAVE_OPTS, VALUE_OPT_SAVE_OPTS, 282 /* equiv idx value */ NO_EQUIVALENT, VALUE_OPT_SAVE_OPTS, 283 /* equivalenced to */ NO_EQUIVALENT, 284 /* min, max, act ct */ 0, 1, 0, 285 /* opt state flags */ OPTST_SET_ARGTYPE(OPARG_TYPE_STRING) 286 | OPTST_ARG_OPTIONAL | OPTST_NO_INIT, AOUSE_SAVE_OPTS, 287 /* last opt argumnt */ { NULL }, 288 /* arg list/cookie */ NULL, 289 /* must/cannot opts */ NULL, NULL, 290 /* option proc */ NULL, 291 /* desc, NAME, name */ SAVE_OPTS_DESC, NULL, SAVE_OPTS_name, 292 /* disablement strs */ NULL, NULL }, 293 294 { /* entry idx, value */ INDEX_OPT_LOAD_OPTS, VALUE_OPT_LOAD_OPTS, 295 /* equiv idx value */ NO_EQUIVALENT, VALUE_OPT_LOAD_OPTS, 296 /* equivalenced to */ NO_EQUIVALENT, 297 /* min, max, act ct */ 0, NOLIMIT, 0, 298 /* opt state flags */ OPTST_SET_ARGTYPE(OPARG_TYPE_STRING) 299 | OPTST_DISABLE_IMM, AOUSE_LOAD_OPTS, 300 /* last opt argumnt */ { NULL }, 301 /* arg list/cookie */ NULL, 302 /* must/cannot opts */ NULL, NULL, 303 /* option proc */ optionLoadOpt, 304 /* desc, NAME, name */ LOAD_OPTS_DESC, LOAD_OPTS_NAME, LOAD_OPTS_name, 305 /* disablement strs */ NO_LOAD_OPTS_name, LOAD_OPTS_pfx } 306 }; 307 308 309 /* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */ 310 /** Reference to the upper cased version of ntpsnmpd. */ 311 #define zPROGNAME (ntpsnmpd_opt_strs+1431) 312 /** Reference to the title line for ntpsnmpd usage. */ 313 #define zUsageTitle (ntpsnmpd_opt_strs+1440) 314 /** ntpsnmpd configuration file name. */ 315 #define zRcName (ntpsnmpd_opt_strs+1552) 316 /** Directories to search for ntpsnmpd config files. */ 317 static char const * const apzHomeList[3] = { 318 ntpsnmpd_opt_strs+1544, 319 ntpsnmpd_opt_strs+1550, 320 NULL }; 321 /** The ntpsnmpd program bug email address. */ 322 #define zBugsAddr (ntpsnmpd_opt_strs+1559) 323 /** Clarification/explanation of what ntpsnmpd does. */ 324 #define zExplain (ntpsnmpd_opt_strs+1594) 325 /** Extra detail explaining what ntpsnmpd does. */ 326 #define zDetail (NULL) 327 /** The full version string for ntpsnmpd. */ 328 #define zFullVersion (ntpsnmpd_opt_strs+1596) 329 /* extracted from optcode.tlib near line 342 */ 330 331 #if defined(ENABLE_NLS) 332 # define OPTPROC_BASE OPTPROC_TRANSLATE 333 static tOptionXlateProc translate_option_strings; 334 #else 335 # define OPTPROC_BASE OPTPROC_NONE 336 # define translate_option_strings NULL 337 #endif /* ENABLE_NLS */ 338 339 #define ntpsnmpd_full_usage (NULL) 340 #define ntpsnmpd_short_usage (NULL) 341 342 #endif /* not defined __doxygen__ */ 343 344 /* 345 * Create the static procedure(s) declared above. 346 */ 347 /** 348 * The callout function that invokes the optionUsage function. 349 * 350 * @param[in] opts the AutoOpts option description structure 351 * @param[in] od the descriptor for the "help" (usage) option. 352 * @noreturn 353 */ 354 static void 355 doUsageOpt(tOptions * opts, tOptDesc * od) 356 { 357 int ex_code; 358 ex_code = NTPSNMPD_EXIT_SUCCESS; 359 optionUsage(&ntpsnmpdOptions, ex_code); 360 /* NOTREACHED */ 361 exit(NTPSNMPD_EXIT_FAILURE); 362 (void)opts; 363 (void)od; 364 } 365 /* extracted from optmain.tlib near line 1250 */ 366 367 /** 368 * The directory containing the data associated with ntpsnmpd. 369 */ 370 #ifndef PKGDATADIR 371 # define PKGDATADIR "" 372 #endif 373 374 /** 375 * Information about the person or institution that packaged ntpsnmpd 376 * for the current distribution. 377 */ 378 #ifndef WITH_PACKAGER 379 # define ntpsnmpd_packager_info NULL 380 #else 381 /** Packager information for ntpsnmpd. */ 382 static char const ntpsnmpd_packager_info[] = 383 "Packaged by " WITH_PACKAGER 384 385 # ifdef WITH_PACKAGER_VERSION 386 " ("WITH_PACKAGER_VERSION")" 387 # endif 388 389 # ifdef WITH_PACKAGER_BUG_REPORTS 390 "\nReport ntpsnmpd bugs to " WITH_PACKAGER_BUG_REPORTS 391 # endif 392 "\n"; 393 #endif 394 #ifndef __doxygen__ 395 396 #endif /* __doxygen__ */ 397 /** 398 * The option definitions for ntpsnmpd. The one structure that 399 * binds them all. 400 */ 401 tOptions ntpsnmpdOptions = { 402 OPTIONS_STRUCT_VERSION, 403 0, NULL, /* original argc + argv */ 404 ( OPTPROC_BASE 405 + OPTPROC_ERRSTOP 406 + OPTPROC_SHORTOPT 407 + OPTPROC_LONGOPT 408 + OPTPROC_NO_REQ_OPT 409 + OPTPROC_ENVIRON 410 + OPTPROC_NO_ARGS 411 + OPTPROC_MISUSE ), 412 0, NULL, /* current option index, current option */ 413 NULL, NULL, zPROGNAME, 414 zRcName, zCopyright, zLicenseDescrip, 415 zFullVersion, apzHomeList, zUsageTitle, 416 zExplain, zDetail, optDesc, 417 zBugsAddr, /* address to send bugs to */ 418 NULL, NULL, /* extensions/saved state */ 419 optionUsage, /* usage procedure */ 420 translate_option_strings, /* translation procedure */ 421 /* 422 * Indexes to special options 423 */ 424 { INDEX_OPT_MORE_HELP, /* more-help option index */ 425 INDEX_OPT_SAVE_OPTS, /* save option index */ 426 NO_EQUIVALENT, /* '-#' option index */ 427 NO_EQUIVALENT /* index of default opt */ 428 }, 429 8 /* full option count */, 3 /* user option count */, 430 ntpsnmpd_full_usage, ntpsnmpd_short_usage, 431 NULL, NULL, 432 PKGDATADIR, ntpsnmpd_packager_info 433 }; 434 435 #if ENABLE_NLS 436 /** 437 * This code is designed to translate translatable option text for the 438 * ntpsnmpd program. These translations happen upon entry 439 * to optionProcess(). 440 */ 441 #include <stdio.h> 442 #include <stdlib.h> 443 #include <string.h> 444 #include <unistd.h> 445 #ifdef HAVE_DCGETTEXT 446 # include <gettext.h> 447 #endif 448 #include <autoopts/usage-txt.h> 449 450 static char * AO_gettext(char const * pz); 451 static void coerce_it(void ** s); 452 453 /** 454 * AutoGen specific wrapper function for gettext. It relies on the macro _() 455 * to convert from English to the target language, then strdup-duplicates the 456 * result string. It tries the "libopts" domain first, then whatever has been 457 * set via the \a textdomain(3) call. 458 * 459 * @param[in] pz the input text used as a lookup key. 460 * @returns the translated text (if there is one), 461 * or the original text (if not). 462 */ 463 static char * 464 AO_gettext(char const * pz) 465 { 466 char * res; 467 if (pz == NULL) 468 return NULL; 469 #ifdef HAVE_DCGETTEXT 470 /* 471 * While processing the option_xlateable_txt data, try to use the 472 * "libopts" domain. Once we switch to the option descriptor data, 473 * do *not* use that domain. 474 */ 475 if (option_xlateable_txt.field_ct != 0) { 476 res = dgettext("libopts", pz); 477 if (res == pz) 478 res = (char *)VOIDP(_(pz)); 479 } else 480 res = (char *)VOIDP(_(pz)); 481 #else 482 res = (char *)VOIDP(_(pz)); 483 #endif 484 if (res == pz) 485 return res; 486 res = strdup(res); 487 if (res == NULL) { 488 fputs(_("No memory for duping translated strings\n"), stderr); 489 exit(NTPSNMPD_EXIT_FAILURE); 490 } 491 return res; 492 } 493 494 /** 495 * All the pointers we use are marked "* const", but they are stored in 496 * writable memory. Coerce the mutability and set the pointer. 497 */ 498 static void coerce_it(void ** s) { *s = AO_gettext(*s); 499 } 500 501 /** 502 * Translate all the translatable strings in the ntpsnmpdOptions 503 * structure defined above. This is done only once. 504 */ 505 static void 506 translate_option_strings(void) 507 { 508 tOptions * const opts = &ntpsnmpdOptions; 509 510 /* 511 * Guard against re-translation. It won't work. The strings will have 512 * been changed by the first pass through this code. One shot only. 513 */ 514 if (option_xlateable_txt.field_ct != 0) { 515 /* 516 * Do the translations. The first pointer follows the field count 517 * field. The field count field is the size of a pointer. 518 */ 519 char ** ppz = (char**)VOIDP(&(option_xlateable_txt)); 520 int ix = option_xlateable_txt.field_ct; 521 522 do { 523 ppz++; /* skip over field_ct */ 524 *ppz = AO_gettext(*ppz); 525 } while (--ix > 0); 526 /* prevent re-translation and disable "libopts" domain lookup */ 527 option_xlateable_txt.field_ct = 0; 528 529 coerce_it(VOIDP(&(opts->pzCopyright))); 530 coerce_it(VOIDP(&(opts->pzCopyNotice))); 531 coerce_it(VOIDP(&(opts->pzFullVersion))); 532 coerce_it(VOIDP(&(opts->pzUsageTitle))); 533 coerce_it(VOIDP(&(opts->pzExplain))); 534 coerce_it(VOIDP(&(opts->pzDetail))); 535 { 536 tOptDesc * od = opts->pOptDesc; 537 for (ix = opts->optCt; ix > 0; ix--, od++) 538 coerce_it(VOIDP(&(od->pzText))); 539 } 540 } 541 } 542 #endif /* ENABLE_NLS */ 543 544 #ifdef DO_NOT_COMPILE_THIS_CODE_IT_IS_FOR_GETTEXT 545 /** I18N function strictly for xgettext. Do not compile. */ 546 static void bogus_function(void) { 547 /* TRANSLATORS: 548 549 The following dummy function was crated solely so that xgettext can 550 extract the correct strings. These strings are actually referenced 551 by a field name in the ntpsnmpdOptions structure noted in the 552 comments below. The literal text is defined in ntpsnmpd_opt_strs. 553 554 NOTE: the strings below are segmented with respect to the source string 555 ntpsnmpd_opt_strs. The strings above are handed off for translation 556 at run time a paragraph at a time. Consequently, they are presented here 557 for translation a paragraph at a time. 558 559 ALSO: often the description for an option will reference another option 560 by name. These are set off with apostrophe quotes (I hope). Do not 561 translate option names. 562 */ 563 /* referenced via ntpsnmpdOptions.pzCopyright */ 564 puts(_("ntpsnmpd 4.2.8p18\n\ 565 Copyright (C) 1992-2024 The University of Delaware and Network Time Foundation, all rights reserved.\n\ 566 This is free software. It is licensed for use, modification and\n\ 567 redistribution under the terms of the NTP License, copies of which\n\ 568 can be seen at:\n")); 569 puts(_(" <http://ntp.org/license>\n\ 570 <http://opensource.org/licenses/ntp-license.php>\n")); 571 572 /* referenced via ntpsnmpdOptions.pzCopyNotice */ 573 puts(_("Permission to use, copy, modify, and distribute this software and its\n\ 574 documentation for any purpose with or without fee is hereby granted,\n\ 575 provided that the above copyright notice appears in all copies and that\n\ 576 both the copyright notice and this permission notice appear in supporting\n\ 577 documentation, and that the name The University of Delaware not be used in\n\ 578 advertising or publicity pertaining to distribution of the software without\n\ 579 specific, written prior permission. The University of Delaware and Network\n\ 580 Time Foundation makes no representations about the suitability this\n\ 581 software for any purpose. It is provided \"as is\" without express or\n\ 582 implied warranty.\n")); 583 584 /* referenced via ntpsnmpdOptions.pOptDesc->pzText */ 585 puts(_("Do not fork")); 586 587 /* referenced via ntpsnmpdOptions.pOptDesc->pzText */ 588 puts(_("Log to syslog()")); 589 590 /* referenced via ntpsnmpdOptions.pOptDesc->pzText */ 591 puts(_("The socket address ntpsnmpd uses to connect to net-snmpd")); 592 593 /* referenced via ntpsnmpdOptions.pOptDesc->pzText */ 594 puts(_("display extended usage information and exit")); 595 596 /* referenced via ntpsnmpdOptions.pOptDesc->pzText */ 597 puts(_("extended usage information passed thru pager")); 598 599 /* referenced via ntpsnmpdOptions.pOptDesc->pzText */ 600 puts(_("output version information and exit")); 601 602 /* referenced via ntpsnmpdOptions.pOptDesc->pzText */ 603 puts(_("save the option state to a config file")); 604 605 /* referenced via ntpsnmpdOptions.pOptDesc->pzText */ 606 puts(_("load options from a config file")); 607 608 /* referenced via ntpsnmpdOptions.pzUsageTitle */ 609 puts(_("ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.8p18\n\ 610 Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n")); 611 612 /* referenced via ntpsnmpdOptions.pzExplain */ 613 puts(_("\n")); 614 615 /* referenced via ntpsnmpdOptions.pzFullVersion */ 616 puts(_("ntpsnmpd 4.2.8p18")); 617 618 /* referenced via ntpsnmpdOptions.pzFullUsage */ 619 puts(_("<<<NOT-FOUND>>>")); 620 621 /* referenced via ntpsnmpdOptions.pzShortUsage */ 622 puts(_("<<<NOT-FOUND>>>")); 623 /* LIBOPTS-MESSAGES: */ 624 #line 67 "../autoopts.c" 625 puts(_("allocation of %d bytes failed\n")); 626 #line 89 "../autoopts.c" 627 puts(_("allocation of %d bytes failed\n")); 628 #line 48 "../init.c" 629 puts(_("AutoOpts function called without option descriptor\n")); 630 #line 81 "../init.c" 631 puts(_("\tThis exceeds the compiled library version: ")); 632 #line 79 "../init.c" 633 puts(_("Automated Options Processing Error!\n" 634 "\t%s called AutoOpts function with structure version %d:%d:%d.\n")); 635 #line 78 "../autoopts.c" 636 puts(_("realloc of %d bytes at 0x%p failed\n")); 637 #line 83 "../init.c" 638 puts(_("\tThis is less than the minimum library version: ")); 639 #line 121 "../version.c" 640 puts(_("Automated Options version %s\n" 641 "\tCopyright (C) 1999-2017 by Bruce Korb - all rights reserved\n")); 642 #line 49 "../makeshell.c" 643 puts(_("(AutoOpts bug): %s.\n")); 644 #line 90 "../reset.c" 645 puts(_("optionResetOpt() called, but reset-option not configured")); 646 #line 241 "../usage.c" 647 puts(_("could not locate the 'help' option")); 648 #line 330 "../autoopts.c" 649 puts(_("optionProcess() was called with invalid data")); 650 #line 697 "../usage.c" 651 puts(_("invalid argument type specified")); 652 #line 568 "../find.c" 653 puts(_("defaulted to option with optional arg")); 654 #line 76 "../alias.c" 655 puts(_("aliasing option is out of range.")); 656 #line 210 "../enum.c" 657 puts(_("%s error: the keyword '%s' is ambiguous for %s\n")); 658 #line 78 "../find.c" 659 puts(_(" The following options match:\n")); 660 #line 263 "../find.c" 661 puts(_("%s: ambiguous option name: %s (matches %d options)\n")); 662 #line 161 "../check.c" 663 puts(_("%s: Command line arguments required\n")); 664 #line 43 "../alias.c" 665 puts(_("%d %s%s options allowed\n")); 666 #line 56 "../makeshell.c" 667 puts(_("%s error %d (%s) calling %s for '%s'\n")); 668 #line 268 "../makeshell.c" 669 puts(_("interprocess pipe")); 670 #line 171 "../version.c" 671 puts(_("error: version option argument '%c' invalid. Use:\n" 672 "\t'v' - version only\n" 673 "\t'c' - version and copyright\n" 674 "\t'n' - version and full copyright notice\n")); 675 #line 58 "../check.c" 676 puts(_("%s error: the '%s' and '%s' options conflict\n")); 677 #line 187 "../find.c" 678 puts(_("%s: The '%s' option has been disabled.")); 679 #line 400 "../find.c" 680 puts(_("%s: The '%s' option has been disabled.")); 681 #line 38 "../alias.c" 682 puts(_("-equivalence")); 683 #line 439 "../find.c" 684 puts(_("%s: illegal option -- %c\n")); 685 #line 110 "../reset.c" 686 puts(_("%s: illegal option -- %c\n")); 687 #line 241 "../find.c" 688 puts(_("%s: illegal option -- %s\n")); 689 #line 740 "../find.c" 690 puts(_("%s: illegal option -- %s\n")); 691 #line 118 "../reset.c" 692 puts(_("%s: illegal option -- %s\n")); 693 #line 305 "../find.c" 694 puts(_("%s: unknown vendor extension option -- %s\n")); 695 #line 135 "../enum.c" 696 puts(_(" or an integer from %d through %d\n")); 697 #line 145 "../enum.c" 698 puts(_(" or an integer from %d through %d\n")); 699 #line 696 "../usage.c" 700 puts(_("%s error: invalid option descriptor for %s\n")); 701 #line 1030 "../usage.c" 702 puts(_("%s error: invalid option descriptor for %s\n")); 703 #line 355 "../find.c" 704 puts(_("%s: invalid option name: %s\n")); 705 #line 497 "../find.c" 706 puts(_("%s: The '%s' option requires an argument.\n")); 707 #line 150 "../autoopts.c" 708 puts(_("(AutoOpts bug): Equivalenced option '%s' was equivalenced to both\n" 709 "\t'%s' and '%s'.")); 710 #line 94 "../check.c" 711 puts(_("%s error: The %s option is required\n")); 712 #line 602 "../find.c" 713 puts(_("%s: The '%s' option cannot have an argument.\n")); 714 #line 151 "../check.c" 715 puts(_("%s: Command line arguments are not allowed.\n")); 716 #line 568 "../save.c" 717 puts(_("error %d (%s) creating %s\n")); 718 #line 210 "../enum.c" 719 puts(_("%s error: '%s' does not match any %s keywords.\n")); 720 #line 93 "../reset.c" 721 puts(_("%s error: The '%s' option requires an argument.\n")); 722 #line 122 "../save.c" 723 puts(_("error %d (%s) stat-ing %s\n")); 724 #line 175 "../save.c" 725 puts(_("error %d (%s) stat-ing %s\n")); 726 #line 143 "../restore.c" 727 puts(_("%s error: no saved option state\n")); 728 #line 225 "../autoopts.c" 729 puts(_("'%s' is not a command line option.\n")); 730 #line 113 "../time.c" 731 puts(_("%s error: '%s' is not a recognizable date/time.\n")); 732 #line 50 "../time.c" 733 puts(_("%s error: '%s' is not a recognizable time duration.\n")); 734 #line 92 "../check.c" 735 puts(_("%s error: The %s option must appear %d times.\n")); 736 #line 165 "../numeric.c" 737 puts(_("%s error: '%s' is not a recognizable number.\n")); 738 #line 176 "../enum.c" 739 puts(_("%s error: %s exceeds %s keyword count\n")); 740 #line 279 "../usage.c" 741 puts(_("Try '%s %s' for more information.\n")); 742 #line 45 "../alias.c" 743 puts(_("one %s%s option allowed\n")); 744 #line 170 "../makeshell.c" 745 puts(_("standard output")); 746 #line 905 "../makeshell.c" 747 puts(_("standard output")); 748 #line 223 "../usage.c" 749 puts(_("standard output")); 750 #line 364 "../usage.c" 751 puts(_("standard output")); 752 #line 574 "../usage.c" 753 puts(_("standard output")); 754 #line 178 "../version.c" 755 puts(_("standard output")); 756 #line 223 "../usage.c" 757 puts(_("standard error")); 758 #line 364 "../usage.c" 759 puts(_("standard error")); 760 #line 574 "../usage.c" 761 puts(_("standard error")); 762 #line 178 "../version.c" 763 puts(_("standard error")); 764 #line 170 "../makeshell.c" 765 puts(_("write")); 766 #line 905 "../makeshell.c" 767 puts(_("write")); 768 #line 222 "../usage.c" 769 puts(_("write")); 770 #line 363 "../usage.c" 771 puts(_("write")); 772 #line 573 "../usage.c" 773 puts(_("write")); 774 #line 177 "../version.c" 775 puts(_("write")); 776 #line 60 "../numeric.c" 777 puts(_("%s error: %s option value %ld is out of range.\n")); 778 #line 44 "../check.c" 779 puts(_("%s error: %s option requires the %s option\n")); 780 #line 121 "../save.c" 781 puts(_("%s warning: cannot save options - %s not regular file\n")); 782 #line 174 "../save.c" 783 puts(_("%s warning: cannot save options - %s not regular file\n")); 784 #line 193 "../save.c" 785 puts(_("%s warning: cannot save options - %s not regular file\n")); 786 #line 567 "../save.c" 787 puts(_("%s warning: cannot save options - %s not regular file\n")); 788 /* END-LIBOPTS-MESSAGES */ 789 790 /* USAGE-TEXT: */ 791 #line 822 "../usage.c" 792 puts(_("\t\t\t\t- an alternate for '%s'\n")); 793 #line 1097 "../usage.c" 794 puts(_("Version, usage and configuration options:")); 795 #line 873 "../usage.c" 796 puts(_("\t\t\t\t- default option for unnamed options\n")); 797 #line 786 "../usage.c" 798 puts(_("\t\t\t\t- disabled as '--%s'\n")); 799 #line 1066 "../usage.c" 800 puts(_(" --- %-14s %s\n")); 801 #line 1064 "../usage.c" 802 puts(_("This option has been disabled")); 803 #line 813 "../usage.c" 804 puts(_("\t\t\t\t- enabled by default\n")); 805 #line 40 "../alias.c" 806 puts(_("%s error: only ")); 807 #line 1143 "../usage.c" 808 puts(_(" - examining environment variables named %s_*\n")); 809 #line 168 "../file.c" 810 puts(_("\t\t\t\t- file must not pre-exist\n")); 811 #line 172 "../file.c" 812 puts(_("\t\t\t\t- file must pre-exist\n")); 813 #line 329 "../usage.c" 814 puts(_("Options are specified by doubled hyphens and their name or by a single\n" 815 "hyphen and the flag character.\n")); 816 #line 882 "../makeshell.c" 817 puts(_("\n" 818 "= = = = = = = =\n\n" 819 "This incarnation of genshell will produce\n" 820 "a shell script to parse the options for %s:\n\n")); 821 #line 142 "../enum.c" 822 puts(_(" or an integer mask with any of the lower %d bits set\n")); 823 #line 846 "../usage.c" 824 puts(_("\t\t\t\t- is a set membership option\n")); 825 #line 867 "../usage.c" 826 puts(_("\t\t\t\t- must appear between %d and %d times\n")); 827 #line 331 "../usage.c" 828 puts(_("Options are specified by single or double hyphens and their name.\n")); 829 #line 853 "../usage.c" 830 puts(_("\t\t\t\t- may appear multiple times\n")); 831 #line 840 "../usage.c" 832 puts(_("\t\t\t\t- may not be preset\n")); 833 #line 1258 "../usage.c" 834 puts(_(" Arg Option-Name Description\n")); 835 #line 1194 "../usage.c" 836 puts(_(" Flg Arg Option-Name Description\n")); 837 #line 1252 "../usage.c" 838 puts(_(" Flg Arg Option-Name Description\n")); 839 #line 1253 "../usage.c" 840 puts(_(" %3s %s")); 841 #line 1259 "../usage.c" 842 puts(_(" %3s %s")); 843 #line 336 "../usage.c" 844 puts(_("The '-#<number>' option may omit the hash char\n")); 845 #line 332 "../usage.c" 846 puts(_("All arguments are named options.\n")); 847 #line 920 "../usage.c" 848 puts(_(" - reading file %s")); 849 #line 358 "../usage.c" 850 puts(_("\n" 851 "Please send bug reports to: <%s>\n")); 852 #line 100 "../version.c" 853 puts(_("\n" 854 "Please send bug reports to: <%s>\n")); 855 #line 129 "../version.c" 856 puts(_("\n" 857 "Please send bug reports to: <%s>\n")); 858 #line 852 "../usage.c" 859 puts(_("\t\t\t\t- may NOT appear - preset only\n")); 860 #line 893 "../usage.c" 861 puts(_("\n" 862 "The following option preset mechanisms are supported:\n")); 863 #line 1141 "../usage.c" 864 puts(_("\n" 865 "The following option preset mechanisms are supported:\n")); 866 #line 631 "../usage.c" 867 puts(_("prohibits these options:\n")); 868 #line 626 "../usage.c" 869 puts(_("prohibits the option '%s'\n")); 870 #line 81 "../numeric.c" 871 puts(_("%s%ld to %ld")); 872 #line 79 "../numeric.c" 873 puts(_("%sgreater than or equal to %ld")); 874 #line 75 "../numeric.c" 875 puts(_("%s%ld exactly")); 876 #line 68 "../numeric.c" 877 puts(_("%sit must lie in one of the ranges:\n")); 878 #line 68 "../numeric.c" 879 puts(_("%sit must be in the range:\n")); 880 #line 88 "../numeric.c" 881 puts(_(", or\n")); 882 #line 66 "../numeric.c" 883 puts(_("%sis scalable with a suffix: k/K/m/M/g/G/t/T\n")); 884 #line 77 "../numeric.c" 885 puts(_("%sless than or equal to %ld")); 886 #line 339 "../usage.c" 887 puts(_("Operands and options may be intermixed. They will be reordered.\n")); 888 #line 601 "../usage.c" 889 puts(_("requires the option '%s'\n")); 890 #line 604 "../usage.c" 891 puts(_("requires these options:\n")); 892 #line 1270 "../usage.c" 893 puts(_(" Arg Option-Name Req? Description\n")); 894 #line 1264 "../usage.c" 895 puts(_(" Flg Arg Option-Name Req? Description\n")); 896 #line 143 "../enum.c" 897 puts(_("or you may use a numeric representation. Preceding these with a '!'\n" 898 "will clear the bits, specifying 'none' will clear all bits, and 'all'\n" 899 "will set them all. Multiple entries may be passed as an option\n" 900 "argument list.\n")); 901 #line 859 "../usage.c" 902 puts(_("\t\t\t\t- may appear up to %d times\n")); 903 #line 52 "../enum.c" 904 puts(_("The valid \"%s\" option keywords are:\n")); 905 #line 1101 "../usage.c" 906 puts(_("The next option supports vendor supported extra options:")); 907 #line 722 "../usage.c" 908 puts(_("These additional options are:")); 909 /* END-USAGE-TEXT */ 910 } 911 #endif /* uncompilable code */ 912 #ifdef __cplusplus 913 } 914 #endif 915 /* ntpsnmpd-opts.c ends here */ 916