+(4.2.7p358) 2013/02/27 Released by Harlan Stenn <stenn@ntp.org>
* Upgrade to autogen-5.17.3pre4 and libopts-38.0.13.
* [Bug 2357] sntp/libopts/usage.c on NetBSD needs -lintl.
(4.2.7p357) 2013/02/22 Released by Harlan Stenn <stenn@ntp.org>
#
# EDIT THIS FILE WITH CAUTION (invoke-ntp.conf.texi)
#
-# It has been AutoGen-ed February 22, 2013 at 03:28:04 AM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed February 27, 2013 at 11:37:01 AM by AutoGen 5.17.3.pre2
# From the definitions ntp.conf.def
# and the template file agtexi-file.tpl
@end ignore
#
# EDIT THIS FILE WITH CAUTION (invoke-ntp.keys.texi)
#
-# It has been AutoGen-ed February 22, 2013 at 03:28:05 AM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed February 27, 2013 at 11:37:03 AM by AutoGen 5.17.3.pre2
# From the definitions ntp.keys.def
# and the template file agtexi-file.tpl
@end ignore
#
# EDIT THIS FILE WITH CAUTION (invoke-ntpd.texi)
#
-# It has been AutoGen-ed February 21, 2013 at 10:46:22 PM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed February 27, 2013 at 11:37:04 AM by AutoGen 5.17.3.pre2
# From the definitions ntpd-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-ntpd - NTP daemon program - Ver. 4.2.7p357
+ntpd - NTP daemon program - Ver. 4.2.7p358
Usage: ntpd [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... \
[ <server1> ... <serverN> ]
Flg Arg Option-Name Description
-.TH ntp.conf 5man "22 Feb 2013" "4.2.7p357" "File Formats"
+.TH ntp.conf 5man "27 Feb 2013" "4.2.7p358" "File Formats"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp.man)
.\"
-.\" It has been AutoGen-ed February 22, 2013 at 03:27:50 AM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:36:47 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntp.conf.def
.\" and the template file agman-cmd.tpl
.\"
.PP
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
This document was derived from FreeBSD.
.PP
This manual page was \fIAutoGen\fP-erated from the \fBntp.conf\fP
-.Dd February 21 2013
+.Dd February 27 2013
.Dt NTP_CONF 5mdoc File Formats
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp.mdoc)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:46:24 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:37:07 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntp.conf.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
.Pp
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
This document was derived from FreeBSD.
.Pp
This manual page was \fIAutoGen\fP\-erated from the \fBntp.conf\fP
<p>This document describes the configuration file for the NTP Project's
<code>ntpd</code> program.
- <p>This document applies to version 4.2.7p357 of <code>ntp.conf</code>.
+ <p>This document applies to version 4.2.7p358 of <code>ntp.conf</code>.
<ul class="menu">
<li><a accesskey="1" href="#ntp_002econf-Description">ntp.conf Description</a>
-.TH ntp.conf 5 "22 Feb 2013" "4.2.7p357" "File Formats"
+.TH ntp.conf 5 "27 Feb 2013" "4.2.7p358" "File Formats"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp.man)
.\"
-.\" It has been AutoGen-ed February 22, 2013 at 03:27:50 AM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:36:47 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntp.conf.def
.\" and the template file agman-cmd.tpl
.\"
.PP
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
This document was derived from FreeBSD.
.PP
This manual page was \fIAutoGen\fP-erated from the \fBntp.conf\fP
-.Dd February 21 2013
+.Dd February 27 2013
.Dt NTP_CONF 5 File Formats
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp.mdoc)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:46:24 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:37:07 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntp.conf.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
.Pp
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
This document was derived from FreeBSD.
.Pp
This manual page was \fIAutoGen\fP\-erated from the \fBntp.conf\fP
-.TH ntp.keys 5man "22 Feb 2013" "4.2.7p357" "File Formats"
+.TH ntp.keys 5man "27 Feb 2013" "4.2.7p358" "File Formats"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp.man)
.\"
-.\" It has been AutoGen-ed February 22, 2013 at 03:27:55 AM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:36:52 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntp.keys.def
.\" and the template file agman-file.tpl
.\"
.SH "BUGS"
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
This document was derived from FreeBSD.
.PP
This manual page was \fIAutoGen\fP-erated from the \fBntp.keys\fP
-.Dd February 21 2013
+.Dd February 27 2013
.Dt NTP_KEYS 5mdoc File Formats
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp.mdoc)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:46:28 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:37:10 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntp.keys.def
.\" and the template file agmdoc-file.tpl
.Sh NAME
.Sh "BUGS"
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
This document was derived from FreeBSD.
.Pp
This manual page was \fIAutoGen\fP\-erated from the \fBntp.keys\fP
<p>This document describes the symmetric key file for the NTP Project's
<code>ntpd</code> program.
- <p>This document applies to version 4.2.7p357 of <code>ntp.keys</code>.
+ <p>This document applies to version 4.2.7p358 of <code>ntp.keys</code>.
<div class="shortcontents">
<h2>Short Contents</h2>
-.TH ntp.keys 5 "22 Feb 2013" "4.2.7p357" "File Formats"
+.TH ntp.keys 5 "27 Feb 2013" "4.2.7p358" "File Formats"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp.man)
.\"
-.\" It has been AutoGen-ed February 22, 2013 at 03:27:55 AM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:36:52 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntp.keys.def
.\" and the template file agman-file.tpl
.\"
.SH "BUGS"
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
This document was derived from FreeBSD.
.PP
This manual page was \fIAutoGen\fP-erated from the \fBntp.keys\fP
-.Dd February 21 2013
+.Dd February 27 2013
.Dt NTP_KEYS 5 File Formats
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp.mdoc)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:46:28 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:37:10 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntp.keys.def
.\" and the template file agmdoc-file.tpl
.Sh NAME
.Sh "BUGS"
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
This document was derived from FreeBSD.
.Pp
This manual page was \fIAutoGen\fP\-erated from the \fBntp.keys\fP
/*
* EDIT THIS FILE WITH CAUTION (ntpd-opts.c)
*
- * It has been AutoGen-ed February 22, 2013 at 03:25:41 AM by AutoGen 5.17.2pre17
+ * It has been AutoGen-ed February 27, 2013 at 11:34:31 AM by AutoGen 5.17.3.pre2
* From the definitions ntpd-opts.def
* and the template file options
*
# define NULL 0
#endif
-/*
- * ntpd option static const strings
+/**
+ * static const strings for ntpd options
*/
static char const ntpd_opt_strs[2986] =
-/* 0 */ "ntpd 4.2.7p357\n"
+/* 0 */ "ntpd 4.2.7p358\n"
"Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n"
"This is free software. It is licensed for use, modification and\n"
"redistribution under the terms of the NTP License, copies of which\n"
/* 2753 */ "output version information and exit\0"
/* 2789 */ "version\0"
/* 2797 */ "NTPD\0"
-/* 2802 */ "ntpd - NTP daemon program - Ver. 4.2.7p357\n"
+/* 2802 */ "ntpd - NTP daemon program - Ver. 4.2.7p358\n"
"Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n"
"\t\t[ <server1> ... <serverN> ]\n\0"
/* 2935 */ "http://bugs.ntp.org, bugs@ntp.org\0"
/* 2969 */ "\n\0"
-/* 2971 */ "ntpd 4.2.7p357";
+/* 2971 */ "ntpd 4.2.7p358";
-/*
+/**
* ipv4 option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the ipv4 option */
#define IPV4_DESC (ntpd_opt_strs+954)
+/** Upper-cased name for the ipv4 option */
#define IPV4_NAME (ntpd_opt_strs+985)
+/** Name string for the ipv4 option */
#define IPV4_name (ntpd_opt_strs+990)
+/** Other options that appear in conjunction with the ipv4 option */
static int const aIpv4CantList[] = {
INDEX_OPT_IPV6, NO_EQUIVALENT };
+/** Compiled in flag settings for the ipv4 option */
#define IPV4_FLAGS (OPTST_DISABLED)
-/*
+/**
* ipv6 option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the ipv6 option */
#define IPV6_DESC (ntpd_opt_strs+995)
+/** Upper-cased name for the ipv6 option */
#define IPV6_NAME (ntpd_opt_strs+1026)
+/** Name string for the ipv6 option */
#define IPV6_name (ntpd_opt_strs+1031)
+/** Other options that appear in conjunction with the ipv6 option */
static int const aIpv6CantList[] = {
INDEX_OPT_IPV4, NO_EQUIVALENT };
+/** Compiled in flag settings for the ipv6 option */
#define IPV6_FLAGS (OPTST_DISABLED)
-/*
+/**
* authreq option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the authreq option */
#define AUTHREQ_DESC (ntpd_opt_strs+1036)
+/** Upper-cased name for the authreq option */
#define AUTHREQ_NAME (ntpd_opt_strs+1066)
+/** Name string for the authreq option */
#define AUTHREQ_name (ntpd_opt_strs+1074)
+/** Other options that appear in conjunction with the authreq option */
static int const aAuthreqCantList[] = {
INDEX_OPT_AUTHNOREQ, NO_EQUIVALENT };
+/** Compiled in flag settings for the authreq option */
#define AUTHREQ_FLAGS (OPTST_DISABLED)
-/*
+/**
* authnoreq option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the authnoreq option */
#define AUTHNOREQ_DESC (ntpd_opt_strs+1082)
+/** Upper-cased name for the authnoreq option */
#define AUTHNOREQ_NAME (ntpd_opt_strs+1119)
+/** Name string for the authnoreq option */
#define AUTHNOREQ_name (ntpd_opt_strs+1129)
+/** Other options that appear in conjunction with the authnoreq option */
static int const aAuthnoreqCantList[] = {
INDEX_OPT_AUTHREQ, NO_EQUIVALENT };
+/** Compiled in flag settings for the authnoreq option */
#define AUTHNOREQ_FLAGS (OPTST_DISABLED)
-/*
+/**
* bcastsync option description:
*/
+/** Descriptive text for the bcastsync option */
#define BCASTSYNC_DESC (ntpd_opt_strs+1139)
+/** Upper-cased name for the bcastsync option */
#define BCASTSYNC_NAME (ntpd_opt_strs+1177)
+/** Name string for the bcastsync option */
#define BCASTSYNC_name (ntpd_opt_strs+1187)
+/** Compiled in flag settings for the bcastsync option */
#define BCASTSYNC_FLAGS (OPTST_DISABLED)
-/*
+/**
* configfile option description:
*/
+/** Descriptive text for the configfile option */
#define CONFIGFILE_DESC (ntpd_opt_strs+1197)
+/** Upper-cased name for the configfile option */
#define CONFIGFILE_NAME (ntpd_opt_strs+1221)
+/** Name string for the configfile option */
#define CONFIGFILE_name (ntpd_opt_strs+1232)
+/** Compiled in flag settings for the configfile option */
#define CONFIGFILE_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
-/*
+/**
* debug-level option description:
*/
+/** Descriptive text for the debug-level option */
#define DEBUG_LEVEL_DESC (ntpd_opt_strs+1243)
+/** Upper-cased name for the debug-level option */
#define DEBUG_LEVEL_NAME (ntpd_opt_strs+1274)
+/** Name string for the debug-level option */
#define DEBUG_LEVEL_name (ntpd_opt_strs+1286)
+/** Compiled in flag settings for the debug-level option */
#define DEBUG_LEVEL_FLAGS (OPTST_DISABLED)
-/*
+/**
* set-debug-level option description:
*/
+/** Descriptive text for the set-debug-level option */
#define SET_DEBUG_LEVEL_DESC (ntpd_opt_strs+1298)
+/** Upper-cased name for the set-debug-level option */
#define SET_DEBUG_LEVEL_NAME (ntpd_opt_strs+1328)
+/** Name string for the set-debug-level option */
#define SET_DEBUG_LEVEL_name (ntpd_opt_strs+1344)
+/** Compiled in flag settings for the set-debug-level option */
#define SET_DEBUG_LEVEL_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
-/*
+/**
* driftfile option description:
*/
+/** Descriptive text for the driftfile option */
#define DRIFTFILE_DESC (ntpd_opt_strs+1360)
+/** Upper-cased name for the driftfile option */
#define DRIFTFILE_NAME (ntpd_opt_strs+1386)
+/** Name string for the driftfile option */
#define DRIFTFILE_name (ntpd_opt_strs+1396)
+/** Compiled in flag settings for the driftfile option */
#define DRIFTFILE_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
-/*
+/**
* panicgate option description:
*/
+/** Descriptive text for the panicgate option */
#define PANICGATE_DESC (ntpd_opt_strs+1406)
+/** Upper-cased name for the panicgate option */
#define PANICGATE_NAME (ntpd_opt_strs+1443)
+/** Name string for the panicgate option */
#define PANICGATE_name (ntpd_opt_strs+1453)
+/** Compiled in flag settings for the panicgate option */
#define PANICGATE_FLAGS (OPTST_DISABLED)
-/*
+/**
* jaildir option description:
*/
#ifdef HAVE_DROPROOT
+/** Descriptive text for the jaildir option */
#define JAILDIR_DESC (ntpd_opt_strs+1463)
+/** Upper-cased name for the jaildir option */
#define JAILDIR_NAME (ntpd_opt_strs+1478)
+/** Name string for the jaildir option */
#define JAILDIR_name (ntpd_opt_strs+1486)
+/** Compiled in flag settings for the jaildir option */
#define JAILDIR_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
#else /* disable jaildir */
#define JAILDIR_FLAGS (OPTST_OMITTED | OPTST_NO_INIT)
#define JAILDIR_NAME NULL
+/** Descriptive text for the jaildir option */
#define JAILDIR_DESC (ntpd_opt_strs+1494)
#define JAILDIR_name (ntpd_opt_strs+1486)
#endif /* HAVE_DROPROOT */
-/*
+/**
* interface option description:
*/
+/** Descriptive text for the interface option */
#define INTERFACE_DESC (ntpd_opt_strs+1548)
+/** Upper-cased name for the interface option */
#define INTERFACE_NAME (ntpd_opt_strs+1587)
+/** Name string for the interface option */
#define INTERFACE_name (ntpd_opt_strs+1597)
+/** Compiled in flag settings for the interface option */
#define INTERFACE_FLAGS (OPTST_DISABLED | OPTST_STACKED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
-/*
+/**
* keyfile option description:
*/
+/** Descriptive text for the keyfile option */
#define KEYFILE_DESC (ntpd_opt_strs+1607)
+/** Upper-cased name for the keyfile option */
#define KEYFILE_NAME (ntpd_opt_strs+1630)
+/** Name string for the keyfile option */
#define KEYFILE_name (ntpd_opt_strs+1638)
+/** Compiled in flag settings for the keyfile option */
#define KEYFILE_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
-/*
+/**
* logfile option description:
*/
+/** Descriptive text for the logfile option */
#define LOGFILE_DESC (ntpd_opt_strs+1646)
+/** Upper-cased name for the logfile option */
#define LOGFILE_NAME (ntpd_opt_strs+1667)
+/** Name string for the logfile option */
#define LOGFILE_name (ntpd_opt_strs+1675)
+/** Compiled in flag settings for the logfile option */
#define LOGFILE_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
-/*
+/**
* novirtualips option description:
*/
+/** Descriptive text for the novirtualips option */
#define NOVIRTUALIPS_DESC (ntpd_opt_strs+1683)
+/** Upper-cased name for the novirtualips option */
#define NOVIRTUALIPS_NAME (ntpd_opt_strs+1719)
+/** Name string for the novirtualips option */
#define NOVIRTUALIPS_name (ntpd_opt_strs+1732)
+/** Compiled in flag settings for the novirtualips option */
#define NOVIRTUALIPS_FLAGS (OPTST_DISABLED)
-/*
+/**
* modifymmtimer option description:
*/
#ifdef SYS_WINNT
+/** Descriptive text for the modifymmtimer option */
#define MODIFYMMTIMER_DESC (ntpd_opt_strs+1745)
+/** Upper-cased name for the modifymmtimer option */
#define MODIFYMMTIMER_NAME (ntpd_opt_strs+1784)
+/** Name string for the modifymmtimer option */
#define MODIFYMMTIMER_name (ntpd_opt_strs+1798)
+/** Compiled in flag settings for the modifymmtimer option */
#define MODIFYMMTIMER_FLAGS (OPTST_DISABLED)
#else /* disable modifymmtimer */
#define MODIFYMMTIMER_name NULL
#endif /* SYS_WINNT */
-/*
+/**
* nofork option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the nofork option */
#define NOFORK_DESC (ntpd_opt_strs+1812)
+/** Upper-cased name for the nofork option */
#define NOFORK_NAME (ntpd_opt_strs+1824)
+/** Name string for the nofork option */
#define NOFORK_name (ntpd_opt_strs+1831)
+/** Other options that appear in conjunction with the nofork option */
static int const aNoforkCantList[] = {
INDEX_OPT_WAIT_SYNC, NO_EQUIVALENT };
+/** Compiled in flag settings for the nofork option */
#define NOFORK_FLAGS (OPTST_DISABLED)
-/*
+/**
* nice option description:
*/
+/** Descriptive text for the nice option */
#define NICE_DESC (ntpd_opt_strs+1838)
+/** Upper-cased name for the nice option */
#define NICE_NAME (ntpd_opt_strs+1859)
+/** Name string for the nice option */
#define NICE_name (ntpd_opt_strs+1864)
+/** Compiled in flag settings for the nice option */
#define NICE_FLAGS (OPTST_DISABLED)
-/*
+/**
* pidfile option description:
*/
+/** Descriptive text for the pidfile option */
#define PIDFILE_DESC (ntpd_opt_strs+1869)
+/** Upper-cased name for the pidfile option */
#define PIDFILE_NAME (ntpd_opt_strs+1890)
+/** Name string for the pidfile option */
#define PIDFILE_name (ntpd_opt_strs+1898)
+/** Compiled in flag settings for the pidfile option */
#define PIDFILE_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
-/*
+/**
* priority option description:
*/
+/** Descriptive text for the priority option */
#define PRIORITY_DESC (ntpd_opt_strs+1906)
+/** Upper-cased name for the priority option */
#define PRIORITY_NAME (ntpd_opt_strs+1923)
+/** Name string for the priority option */
#define PRIORITY_name (ntpd_opt_strs+1932)
+/** Compiled in flag settings for the priority option */
#define PRIORITY_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
-/*
+/**
* quit option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the quit option */
#define QUIT_DESC (ntpd_opt_strs+1941)
+/** Upper-cased name for the quit option */
#define QUIT_NAME (ntpd_opt_strs+1963)
+/** Name string for the quit option */
#define QUIT_name (ntpd_opt_strs+1968)
+/** Other options that appear in conjunction with the quit option */
static int const aQuitCantList[] = {
INDEX_OPT_SAVECONFIGQUIT,
INDEX_OPT_WAIT_SYNC, NO_EQUIVALENT };
+/** Compiled in flag settings for the quit option */
#define QUIT_FLAGS (OPTST_DISABLED)
-/*
+/**
* propagationdelay option description:
*/
+/** Descriptive text for the propagationdelay option */
#define PROPAGATIONDELAY_DESC (ntpd_opt_strs+1973)
+/** Upper-cased name for the propagationdelay option */
#define PROPAGATIONDELAY_NAME (ntpd_opt_strs+2001)
+/** Name string for the propagationdelay option */
#define PROPAGATIONDELAY_name (ntpd_opt_strs+2018)
+/** Compiled in flag settings for the propagationdelay option */
#define PROPAGATIONDELAY_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
-/*
+/**
* saveconfigquit option description with
* "Must also have options" and "Incompatible options":
*/
#ifdef SAVECONFIG
+/** Descriptive text for the saveconfigquit option */
#define SAVECONFIGQUIT_DESC (ntpd_opt_strs+2035)
+/** Upper-cased name for the saveconfigquit option */
#define SAVECONFIGQUIT_NAME (ntpd_opt_strs+2070)
+/** Name string for the saveconfigquit option */
#define SAVECONFIGQUIT_name (ntpd_opt_strs+2085)
+/** Other options that appear in conjunction with the saveconfigquit option */
static int const aSaveconfigquitCantList[] = {
INDEX_OPT_QUIT,
INDEX_OPT_WAIT_SYNC, NO_EQUIVALENT };
+/** Compiled in flag settings for the saveconfigquit option */
#define SAVECONFIGQUIT_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
#define SAVECONFIGQUIT_name NULL
#endif /* SAVECONFIG */
-/*
+/**
* statsdir option description:
*/
+/** Descriptive text for the statsdir option */
#define STATSDIR_DESC (ntpd_opt_strs+2100)
+/** Upper-cased name for the statsdir option */
#define STATSDIR_NAME (ntpd_opt_strs+2125)
+/** Name string for the statsdir option */
#define STATSDIR_name (ntpd_opt_strs+2134)
+/** Compiled in flag settings for the statsdir option */
#define STATSDIR_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
-/*
+/**
* trustedkey option description:
*/
+/** Descriptive text for the trustedkey option */
#define TRUSTEDKEY_DESC (ntpd_opt_strs+2143)
+/** Upper-cased name for the trustedkey option */
#define TRUSTEDKEY_NAME (ntpd_opt_strs+2162)
+/** Name string for the trustedkey option */
#define TRUSTEDKEY_name (ntpd_opt_strs+2173)
+/** Compiled in flag settings for the trustedkey option */
#define TRUSTEDKEY_FLAGS (OPTST_DISABLED | OPTST_STACKED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
-/*
+/**
* user option description:
*/
#ifdef HAVE_DROPROOT
+/** Descriptive text for the user option */
#define USER_DESC (ntpd_opt_strs+2184)
+/** Upper-cased name for the user option */
#define USER_NAME (ntpd_opt_strs+2218)
+/** Name string for the user option */
#define USER_name (ntpd_opt_strs+2223)
+/** Compiled in flag settings for the user option */
#define USER_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
#else /* disable user */
#define USER_FLAGS (OPTST_OMITTED | OPTST_NO_INIT)
#define USER_NAME NULL
+/** Descriptive text for the user option */
#define USER_DESC (ntpd_opt_strs+1494)
#define USER_name (ntpd_opt_strs+2223)
#endif /* HAVE_DROPROOT */
-/*
+/**
* updateinterval option description:
*/
+/** Descriptive text for the updateinterval option */
#define UPDATEINTERVAL_DESC (ntpd_opt_strs+2228)
+/** Upper-cased name for the updateinterval option */
#define UPDATEINTERVAL_NAME (ntpd_opt_strs+2292)
+/** Name string for the updateinterval option */
#define UPDATEINTERVAL_name (ntpd_opt_strs+2307)
+/** Compiled in flag settings for the updateinterval option */
#define UPDATEINTERVAL_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
-/*
+/**
* var option description:
*/
+/** Descriptive text for the var option */
#define VAR_DESC (ntpd_opt_strs+2322)
+/** Upper-cased name for the var option */
#define VAR_NAME (ntpd_opt_strs+2352)
+/** Name string for the var option */
#define VAR_name (ntpd_opt_strs+2356)
+/** Compiled in flag settings for the var option */
#define VAR_FLAGS (OPTST_DISABLED | OPTST_STACKED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
-/*
+/**
* dvar option description:
*/
+/** Descriptive text for the dvar option */
#define DVAR_DESC (ntpd_opt_strs+2360)
+/** Upper-cased name for the dvar option */
#define DVAR_NAME (ntpd_opt_strs+2394)
+/** Name string for the dvar option */
#define DVAR_name (ntpd_opt_strs+2399)
+/** Compiled in flag settings for the dvar option */
#define DVAR_FLAGS (OPTST_DISABLED | OPTST_STACKED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
-/*
+/**
* wait-sync option description with
* "Must also have options" and "Incompatible options":
*/
#ifdef HAVE_WORKING_FORK
+/** Descriptive text for the wait-sync option */
#define WAIT_SYNC_DESC (ntpd_opt_strs+2404)
+/** Upper-cased name for the wait-sync option */
#define WAIT_SYNC_NAME (ntpd_opt_strs+2441)
+/** Name string for the wait-sync option */
#define WAIT_SYNC_name (ntpd_opt_strs+2451)
+/** Other options that appear in conjunction with the wait-sync option */
static int const aWait_SyncCantList[] = {
INDEX_OPT_NOFORK,
INDEX_OPT_QUIT,
INDEX_OPT_SAVECONFIGQUIT, NO_EQUIVALENT };
+/** Compiled in flag settings for the wait-sync option */
#define WAIT_SYNC_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
#define WAIT_SYNC_name NULL
#endif /* HAVE_WORKING_FORK */
-/*
+/**
* slew option description:
*/
+/** Descriptive text for the slew option */
#define SLEW_DESC (ntpd_opt_strs+2461)
+/** Upper-cased name for the slew option */
#define SLEW_NAME (ntpd_opt_strs+2484)
+/** Name string for the slew option */
#define SLEW_name (ntpd_opt_strs+2489)
+/** Compiled in flag settings for the slew option */
#define SLEW_FLAGS (OPTST_DISABLED)
-/*
+/**
* usepcc option description:
*/
#ifdef SYS_WINNT
+/** Descriptive text for the usepcc option */
#define USEPCC_DESC (ntpd_opt_strs+2494)
+/** Upper-cased name for the usepcc option */
#define USEPCC_NAME (ntpd_opt_strs+2531)
+/** Name string for the usepcc option */
#define USEPCC_name (ntpd_opt_strs+2538)
+/** Compiled in flag settings for the usepcc option */
#define USEPCC_FLAGS (OPTST_DISABLED)
#else /* disable usepcc */
#define USEPCC_name NULL
#endif /* SYS_WINNT */
-/*
+/**
* pccfreq option description:
*/
#ifdef SYS_WINNT
+/** Descriptive text for the pccfreq option */
#define PCCFREQ_DESC (ntpd_opt_strs+2545)
+/** Upper-cased name for the pccfreq option */
#define PCCFREQ_NAME (ntpd_opt_strs+2588)
+/** Name string for the pccfreq option */
#define PCCFREQ_name (ntpd_opt_strs+2596)
+/** Compiled in flag settings for the pccfreq option */
#define PCCFREQ_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
#define PCCFREQ_name NULL
#endif /* SYS_WINNT */
-/*
+/**
* mdns option description:
*/
#ifdef HAVE_DNSREGISTRATION
+/** Descriptive text for the mdns option */
#define MDNS_DESC (ntpd_opt_strs+2604)
+/** Upper-cased name for the mdns option */
#define MDNS_NAME (ntpd_opt_strs+2639)
+/** Name string for the mdns option */
#define MDNS_name (ntpd_opt_strs+2644)
+/** Compiled in flag settings for the mdns option */
#define MDNS_FLAGS (OPTST_DISABLED)
#else /* disable mdns */
#endif
#define VER_DESC (ntpd_opt_strs+2753)
#define VER_name (ntpd_opt_strs+2789)
-/*
+/**
* Declare option callback procedures
*/
#if defined(TEST_NTPD_OPTS)
static tOptProc
doOptDebug_Level, doUsageOpt;
-/*
+/**
* #define map the "normal" callout procs
*/
#define DEBUG_LEVEL_OPT_PROC doOptDebug_Level
};
-/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
- *
- * Define the ntpd Option Environment
- */
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/** Reference to the upper cased version of ntpd. */
#define zPROGNAME (ntpd_opt_strs+2797)
+/** Reference to the title line for ntpd usage. */
#define zUsageTitle (ntpd_opt_strs+2802)
+/** There is no ntpd configuration file. */
#define zRcName NULL
+/** There are no directories to search for ntpd config files. */
#define apzHomeList NULL
+/** The ntpd program bug email address. */
#define zBugsAddr (ntpd_opt_strs+2935)
+/** Clarification/explanation of what ntpd does. */
#define zExplain (ntpd_opt_strs+2969)
+/** Extra detail explaining what ntpd does. */
#define zDetail (NULL)
+/** The full version string for ntpd. */
#define zFullVersion (ntpd_opt_strs+2971)
-/* extracted from optcode.tlib near line 364 */
+/* extracted from optcode.tlib near line 371 */
#if defined(ENABLE_NLS)
# define OPTPROC_BASE OPTPROC_TRANSLATE
/**
* The callout function that invokes the optionUsage function.
*
- * @param pOptions the AutoOpts option description structure
- * @param pOptDesc the descriptor for the "help" (usage) option.
+ * @param[in] pOptions the AutoOpts option description structure
+ * @param[in] pOptDesc the descriptor for the "help" (usage) option.
* @noreturn
*/
static void
/**
* Code to handle the debug-level option.
*
- * @param pOptions the ntpd options data structure
- * @param pOptDesc the option descriptor for this option.
+ * @param[in] pOptions the ntpd options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
*/
static void
doOptDebug_Level(tOptions* pOptions, tOptDesc* pOptDesc)
* Generated main procedure. This will emit text that a Bourne shell can
* process to handle its command line arguments.
*
- * @param argc argument count
- * @param argv argument vector
+ * @param[in] argc argument count
+ * @param[in] argv argument vector
* @returns program exit code
*/
int
#ifndef WITH_PACKAGER
# define ntpd_packager_info NULL
#else
+/** Packager information for ntpd. */
static char const ntpd_packager_info[] =
"Packaged by " WITH_PACKAGER
};
#if ENABLE_NLS
-/*
+/**
* This code is designed to translate translatable option text for the
* ntpd program. These translations happen upon entry
* to optionProcess().
#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:
translate option names.
*/
/* referenced via ntpdOptions.pzCopyright */
- puts(_("ntpd 4.2.7p357\n\
+ puts(_("ntpd 4.2.7p358\n\
Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n\
This is free software. It is licensed for use, modification and\n\
redistribution under the terms of the NTP License, copies of which\n\
puts(_("output version information and exit"));
/* referenced via ntpdOptions.pzUsageTitle */
- puts(_("ntpd - NTP daemon program - Ver. 4.2.7p357\n\
+ puts(_("ntpd - NTP daemon program - Ver. 4.2.7p358\n\
Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
\t\t[ <server1> ... <serverN> ]\n"));
puts(_("\n"));
/* referenced via ntpdOptions.pzFullVersion */
- puts(_("ntpd 4.2.7p357"));
+ puts(_("ntpd 4.2.7p358"));
/* referenced via ntpdOptions.pzFullUsage */
puts(_("<<<NOT-FOUND>>>"));
puts(_("could not locate the 'help' option"));
#line 351 "../autoopts.c"
puts(_("optionProcess() was called with invalid data"));
-#line 770 "../usage.c"
+#line 783 "../usage.c"
puts(_("invalid argument type specified"));
#line 589 "../find.c"
puts(_("defaulted to option with optional arg"));
puts(_(" or an integer from %d through %d\n"));
#line 164 "../enum.c"
puts(_(" or an integer from %d through %d\n"));
-#line 769 "../usage.c"
+#line 782 "../usage.c"
puts(_("%s error: invalid option descriptor for %s\n"));
-#line 1097 "../usage.c"
+#line 1110 "../usage.c"
puts(_("%s error: invalid option descriptor for %s\n"));
#line 379 "../find.c"
puts(_("%s: invalid option name: %s\n"));
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'"));
+ "\t'%s' and '%s'."));
#line 94 "../check.c"
puts(_("%s error: The %s option is required\n"));
#line 623 "../find.c"
#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"));
+ 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(_("standard output"));
#line 451 "../usage.c"
puts(_("standard output"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
puts(_("standard output"));
#line 175 "../version.c"
puts(_("standard output"));
puts(_("standard error"));
#line 451 "../usage.c"
puts(_("standard error"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
puts(_("standard error"));
#line 175 "../version.c"
puts(_("standard error"));
puts(_("write"));
#line 450 "../usage.c"
puts(_("write"));
-#line 646 "../usage.c"
+#line 659 "../usage.c"
puts(_("write"));
#line 174 "../version.c"
puts(_("write"));
/* END-LIBOPTS-MESSAGES */
/* USAGE-TEXT: */
-#line 895 "../usage.c"
+#line 908 "../usage.c"
puts(_("\t\t\t\t- an alternate for '%s'\n"));
-#line 1164 "../usage.c"
+#line 1177 "../usage.c"
puts(_("Version, usage and configuration options:"));
-#line 946 "../usage.c"
+#line 959 "../usage.c"
puts(_("\t\t\t\t- default option for unnamed options\n"));
-#line 859 "../usage.c"
+#line 872 "../usage.c"
puts(_("\t\t\t\t- disabled as '--%s'\n"));
-#line 1133 "../usage.c"
+#line 1146 "../usage.c"
puts(_(" --- %-14s %s\n"));
-#line 1131 "../usage.c"
+#line 1144 "../usage.c"
puts(_("This option has been disabled"));
-#line 886 "../usage.c"
+#line 899 "../usage.c"
puts(_("\t\t\t\t- enabled by default\n"));
#line 40 "../alias.c"
puts(_("%s error: only "));
-#line 1208 "../usage.c"
+#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"));
"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 919 "../usage.c"
+#line 932 "../usage.c"
puts(_("\t\t\t\t- is a set membership option\n"));
-#line 940 "../usage.c"
+#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 926 "../usage.c"
+#line 939 "../usage.c"
puts(_("\t\t\t\t- may appear multiple times\n"));
-#line 913 "../usage.c"
+#line 926 "../usage.c"
puts(_("\t\t\t\t- may not be preset\n"));
-#line 1323 "../usage.c"
+#line 1336 "../usage.c"
puts(_(" Arg Option-Name Description\n"));
-#line 1259 "../usage.c"
+#line 1272 "../usage.c"
puts(_(" Flg Arg Option-Name Description\n"));
-#line 1317 "../usage.c"
+#line 1330 "../usage.c"
puts(_(" Flg Arg Option-Name Description\n"));
-#line 1318 "../usage.c"
+#line 1331 "../usage.c"
puts(_(" %3s %s"));
-#line 1324 "../usage.c"
+#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 993 "../usage.c"
+#line 1006 "../usage.c"
puts(_(" - reading file %s"));
#line 445 "../usage.c"
puts(_("\n"
#line 129 "../version.c"
puts(_("\n"
"please send bug reports to: <%s>\n"));
-#line 925 "../usage.c"
+#line 938 "../usage.c"
puts(_("\t\t\t\t- may NOT appear - preset only\n"));
-#line 965 "../usage.c"
+#line 978 "../usage.c"
puts(_("\n"
"The following option preset mechanisms are supported:\n"));
-#line 1206 "../usage.c"
+#line 1219 "../usage.c"
puts(_("\n"
"The following option preset mechanisms are supported:\n"));
-#line 704 "../usage.c"
+#line 717 "../usage.c"
puts(_("prohibits these options:\n"));
-#line 699 "../usage.c"
+#line 712 "../usage.c"
puts(_("prohibits the option '%s'\n"));
#line 81 "../numeric.c"
puts(_("%s%ld to %ld"));
puts(_("%sless than or equal to %ld"));
#line 426 "../usage.c"
puts(_("Operands and options may be intermixed. They will be reordered.\n"));
-#line 674 "../usage.c"
+#line 687 "../usage.c"
puts(_("requires the option '%s'\n"));
-#line 677 "../usage.c"
+#line 690 "../usage.c"
puts(_("requires these options:\n"));
-#line 1335 "../usage.c"
+#line 1348 "../usage.c"
puts(_(" Arg Option-Name Req? Description\n"));
-#line 1329 "../usage.c"
+#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 932 "../usage.c"
+#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 1168 "../usage.c"
+#line 1181 "../usage.c"
puts(_("The next option supports vendor supported extra options:"));
-#line 795 "../usage.c"
+#line 808 "../usage.c"
puts(_("These additional options are:"));
/* END-USAGE-TEXT */
}
/*
* EDIT THIS FILE WITH CAUTION (ntpd-opts.h)
*
- * It has been AutoGen-ed February 22, 2013 at 03:25:39 AM by AutoGen 5.17.2pre17
+ * It has been AutoGen-ed February 27, 2013 at 11:34:30 AM by AutoGen 5.17.3.pre2
* From the definitions ntpd-opts.def
* and the template file options
*
* representations about the suitability this software for any purpose. It
* is provided "as is" without express or implied warranty.
*/
-/*
+/**
* This file contains the programmatic interface to the Automated
* Options generated for the ntpd program.
* These macros are documented in the AutoGen info file in the
#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
Choke Me.
#endif
-/*
- * Enumeration of each option:
+/**
+ * Enumeration of each option type for ntpd
*/
typedef enum {
INDEX_OPT_IPV4 = 0,
INDEX_OPT_HELP = 35,
INDEX_OPT_MORE_HELP = 36
} teOptIndex;
-
+/** count of all options for ntpd */
#define OPTION_CT 37
-#define NTPD_VERSION "4.2.7p357"
-#define NTPD_FULL_VERSION "ntpd 4.2.7p357"
+/** ntpd version */
+#define NTPD_VERSION "4.2.7p358"
+/** Full ntpd version text */
+#define NTPD_FULL_VERSION "ntpd 4.2.7p358"
-/*
+/**
* Interface defines for all options. Replace "n" with the UPPER_CASED
* option name (as in the teOptIndex enumeration above).
* e.g. HAVE_OPT(IPV4)
*/
#define DESC(n) (ntpdOptions.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 ntpd exit codes
*/
typedef enum {
NTPD_EXIT_USAGE_ERROR = 64,
NTPD_EXIT_LIBOPTS_FAILURE = 70
} ntpd_exit_code_t;
-/*
+/** @} */
+/**
* Make sure there are no #define name conflicts with the option names
*/
#ifndef NO_OPTION_NAME_WARNINGS
# undef MDNS
#endif /* NO_OPTION_NAME_WARNINGS */
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
* Interface defines for specific options.
+ * @{
*/
#define VALUE_OPT_IPV4 '4'
#define VALUE_OPT_IPV6 '6'
#define VALUE_OPT_USEPCC 31
#define VALUE_OPT_PCCFREQ 32
#define VALUE_OPT_MDNS 'm'
+/** option flag (value) for " (get "val-name") " option */
#define VALUE_OPT_HELP '?'
+/** 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 INDEX_OPT_VERSION
/*
* Interface defines not associated with particular options
ntpdOptions.pzCurOpt = NULL)
#define START_OPT RESTART_OPT(1)
#define USAGE(c) (*ntpdOptions.pUsageProc)(&ntpdOptions, c)
-/* extracted from opthead.tlib near line 498 */
+/* extracted from opthead.tlib near line 538 */
#ifdef __cplusplus
extern "C" {
-.TH ntpd 1ntpdman "22 Feb 2013" "4.2.7p357" "User Commands"
+.TH ntpd 1ntpdman "27 Feb 2013" "4.2.7p358" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntpd-opts.man)
.\"
-.\" It has been AutoGen-ed February 22, 2013 at 03:27:59 AM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:36:56 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntpd-opts.def
.\" and the template file agman-cmd.tpl
.\"
.PP
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
Portions of this document came from FreeBSD.
.PP
This manual page was \fIAutoGen\fP-erated from the \fBntpd\fP
-.Dd February 21 2013
+.Dd February 27 2013
.Dt NTPD 1ntpdmdoc User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntpd-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:46:30 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:37:12 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntpd-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
.Pp
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
Portions of this document came from FreeBSD.
.Pp
This manual page was \fIAutoGen\fP\-erated from the \fBntpd\fP
symmetric and broadcast modes, and with both symmetric-key and public-key
cryptography.
- <p>This document applies to version 4.2.7p357 of <code>ntpd</code>.
+ <p>This document applies to version 4.2.7p358 of <code>ntpd</code>.
<ul class="menu">
<li><a accesskey="1" href="#ntpd-Description">ntpd Description</a>: Description
used to select the program, defaulting to <span class="file">more</span>. Both will exit
with a status code of 0.
-<pre class="example">ntpd - NTP daemon program - Ver. 4.2.7p356
+<pre class="example">ntpd - NTP daemon program - Ver. 4.2.7p357
Usage: ntpd [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \
[ <server1> ... <serverN> ]
Flg Arg Option-Name Description
-.TH ntpd @NTPD_MS@ "22 Feb 2013" "4.2.7p357" "User Commands"
+.TH ntpd @NTPD_MS@ "27 Feb 2013" "4.2.7p358" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntpd-opts.man)
.\"
-.\" It has been AutoGen-ed February 22, 2013 at 03:27:59 AM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:36:56 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntpd-opts.def
.\" and the template file agman-cmd.tpl
.\"
.PP
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
Portions of this document came from FreeBSD.
.PP
This manual page was \fIAutoGen\fP-erated from the \fBntpd\fP
-.Dd February 21 2013
+.Dd February 27 2013
.Dt NTPD @NTPD_MS@ User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntpd-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:46:30 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:37:12 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntpd-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
.Pp
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
Portions of this document came from FreeBSD.
.Pp
This manual page was \fIAutoGen\fP\-erated from the \fBntpd\fP
#
# EDIT THIS FILE WITH CAUTION (invoke-ntpdc.texi)
#
-# It has been AutoGen-ed February 21, 2013 at 10:46:57 PM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed February 27, 2013 at 11:37:41 AM by AutoGen 5.17.3.pre2
# From the definitions ntpdc-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p357
+ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p358
Usage: ntpdc [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [ host ...]
Flg Arg Option-Name Description
-4 no ipv4 Force IPv4 DNS name resolution
/*
* EDIT THIS FILE WITH CAUTION (ntpdc-opts.c)
*
- * It has been AutoGen-ed February 21, 2013 at 10:46:41 PM by AutoGen 5.17.2pre17
+ * It has been AutoGen-ed February 27, 2013 at 11:37:25 AM by AutoGen 5.17.3.pre2
* From the definitions ntpdc-opts.def
* and the template file options
*
# define NULL 0
#endif
-/*
- * ntpdc option static const strings
+/**
+ * static const strings for ntpdc options
*/
static char const ntpdc_opt_strs[1861] =
-/* 0 */ "ntpdc 4.2.7p357\n"
+/* 0 */ "ntpdc 4.2.7p358\n"
"Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n"
"This is free software. It is licensed for use, modification and\n"
"redistribution under the terms of the NTP License, copies of which\n"
/* 1640 */ "no-load-opts\0"
/* 1653 */ "no\0"
/* 1656 */ "NTPDC\0"
-/* 1662 */ "ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p357\n"
+/* 1662 */ "ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p358\n"
"Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n\0"
/* 1794 */ "$HOME\0"
/* 1800 */ ".\0"
/* 1802 */ ".ntprc\0"
/* 1809 */ "http://bugs.ntp.org, bugs@ntp.org\0"
/* 1843 */ "\n\0"
-/* 1845 */ "ntpdc 4.2.7p357";
+/* 1845 */ "ntpdc 4.2.7p358";
-/*
+/**
* ipv4 option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the ipv4 option */
#define IPV4_DESC (ntpdc_opt_strs+955)
+/** Upper-cased name for the ipv4 option */
#define IPV4_NAME (ntpdc_opt_strs+986)
+/** Name string for the ipv4 option */
#define IPV4_name (ntpdc_opt_strs+991)
+/** Other options that appear in conjunction with the ipv4 option */
static int const aIpv4CantList[] = {
INDEX_OPT_IPV6, NO_EQUIVALENT };
+/** Compiled in flag settings for the ipv4 option */
#define IPV4_FLAGS (OPTST_DISABLED)
-/*
+/**
* ipv6 option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the ipv6 option */
#define IPV6_DESC (ntpdc_opt_strs+996)
+/** Upper-cased name for the ipv6 option */
#define IPV6_NAME (ntpdc_opt_strs+1027)
+/** Name string for the ipv6 option */
#define IPV6_name (ntpdc_opt_strs+1032)
+/** Other options that appear in conjunction with the ipv6 option */
static int const aIpv6CantList[] = {
INDEX_OPT_IPV4, NO_EQUIVALENT };
+/** Compiled in flag settings for the ipv6 option */
#define IPV6_FLAGS (OPTST_DISABLED)
-/*
+/**
* command option description:
*/
+/** Descriptive text for the command option */
#define COMMAND_DESC (ntpdc_opt_strs+1037)
+/** Upper-cased name for the command option */
#define COMMAND_NAME (ntpdc_opt_strs+1060)
+/** Name string for the command option */
#define COMMAND_name (ntpdc_opt_strs+1068)
+/** Compiled in flag settings for the command option */
#define COMMAND_FLAGS (OPTST_DISABLED | OPTST_STACKED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
-/*
+/**
* debug-level option description:
*/
+/** Descriptive text for the debug-level option */
#define DEBUG_LEVEL_DESC (ntpdc_opt_strs+1076)
+/** Upper-cased name for the debug-level option */
#define DEBUG_LEVEL_NAME (ntpdc_opt_strs+1107)
+/** Name string for the debug-level option */
#define DEBUG_LEVEL_name (ntpdc_opt_strs+1119)
+/** Compiled in flag settings for the debug-level option */
#define DEBUG_LEVEL_FLAGS (OPTST_DISABLED)
-/*
+/**
* set-debug-level option description:
*/
+/** Descriptive text for the set-debug-level option */
#define SET_DEBUG_LEVEL_DESC (ntpdc_opt_strs+1131)
+/** Upper-cased name for the set-debug-level option */
#define SET_DEBUG_LEVEL_NAME (ntpdc_opt_strs+1161)
+/** Name string for the set-debug-level option */
#define SET_DEBUG_LEVEL_name (ntpdc_opt_strs+1177)
+/** Compiled in flag settings for the set-debug-level option */
#define SET_DEBUG_LEVEL_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
-/*
+/**
* interactive option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the interactive option */
#define INTERACTIVE_DESC (ntpdc_opt_strs+1193)
+/** Upper-cased name for the interactive option */
#define INTERACTIVE_NAME (ntpdc_opt_strs+1235)
+/** Name string for the interactive option */
#define INTERACTIVE_name (ntpdc_opt_strs+1247)
+/** Other options that appear in conjunction with the interactive option */
static int const aInteractiveCantList[] = {
INDEX_OPT_COMMAND,
INDEX_OPT_LISTPEERS,
INDEX_OPT_PEERS,
INDEX_OPT_SHOWPEERS, NO_EQUIVALENT };
+/** Compiled in flag settings for the interactive option */
#define INTERACTIVE_FLAGS (OPTST_DISABLED)
-/*
+/**
* listpeers option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the listpeers option */
#define LISTPEERS_DESC (ntpdc_opt_strs+1259)
+/** Upper-cased name for the listpeers option */
#define LISTPEERS_NAME (ntpdc_opt_strs+1285)
+/** Name string for the listpeers option */
#define LISTPEERS_name (ntpdc_opt_strs+1295)
+/** Other options that appear in conjunction with the listpeers option */
static int const aListpeersCantList[] = {
INDEX_OPT_COMMAND, NO_EQUIVALENT };
+/** Compiled in flag settings for the listpeers option */
#define LISTPEERS_FLAGS (OPTST_DISABLED)
-/*
+/**
* numeric option description:
*/
+/** Descriptive text for the numeric option */
#define NUMERIC_DESC (ntpdc_opt_strs+1305)
+/** Upper-cased name for the numeric option */
#define NUMERIC_NAME (ntpdc_opt_strs+1328)
+/** Name string for the numeric option */
#define NUMERIC_name (ntpdc_opt_strs+1336)
+/** Compiled in flag settings for the numeric option */
#define NUMERIC_FLAGS (OPTST_DISABLED)
-/*
+/**
* peers option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the peers option */
#define PEERS_DESC (ntpdc_opt_strs+1259)
+/** Upper-cased name for the peers option */
#define PEERS_NAME (ntpdc_opt_strs+1344)
+/** Name string for the peers option */
#define PEERS_name (ntpdc_opt_strs+1350)
+/** Other options that appear in conjunction with the peers option */
static int const aPeersCantList[] = {
INDEX_OPT_COMMAND, NO_EQUIVALENT };
+/** Compiled in flag settings for the peers option */
#define PEERS_FLAGS (OPTST_DISABLED)
-/*
+/**
* showpeers option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the showpeers option */
#define SHOWPEERS_DESC (ntpdc_opt_strs+1356)
+/** Upper-cased name for the showpeers option */
#define SHOWPEERS_NAME (ntpdc_opt_strs+1381)
+/** Name string for the showpeers option */
#define SHOWPEERS_name (ntpdc_opt_strs+1391)
+/** Other options that appear in conjunction with the showpeers option */
static int const aShowpeersCantList[] = {
INDEX_OPT_COMMAND, NO_EQUIVALENT };
+/** Compiled in flag settings for the showpeers option */
#define SHOWPEERS_FLAGS (OPTST_DISABLED)
/*
#define NO_LOAD_OPTS_name (ntpdc_opt_strs+1640)
#define LOAD_OPTS_pfx (ntpdc_opt_strs+1653)
#define LOAD_OPTS_name (NO_LOAD_OPTS_name + 3)
-/*
+/**
* Declare option callback procedures
*/
#if defined(TEST_NTPDC_OPTS)
static tOptProc
doOptDebug_Level, doUsageOpt;
-/*
+/**
* #define map the "normal" callout procs
*/
#define DEBUG_LEVEL_OPT_PROC doOptDebug_Level
};
-/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
- *
- * Define the ntpdc Option Environment
- */
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/** Reference to the upper cased version of ntpdc. */
#define zPROGNAME (ntpdc_opt_strs+1656)
+/** Reference to the title line for ntpdc usage. */
#define zUsageTitle (ntpdc_opt_strs+1662)
+/** ntpdc configuration file name. */
#define zRcName (ntpdc_opt_strs+1802)
+/** Directories to search for ntpdc config files. */
static char const * const apzHomeList[3] = {
ntpdc_opt_strs+1794,
ntpdc_opt_strs+1800,
NULL };
+/** The ntpdc program bug email address. */
#define zBugsAddr (ntpdc_opt_strs+1809)
+/** Clarification/explanation of what ntpdc does. */
#define zExplain (ntpdc_opt_strs+1843)
+/** Extra detail explaining what ntpdc does. */
#define zDetail (NULL)
+/** The full version string for ntpdc. */
#define zFullVersion (ntpdc_opt_strs+1845)
-/* extracted from optcode.tlib near line 364 */
+/* extracted from optcode.tlib near line 371 */
#if defined(ENABLE_NLS)
# define OPTPROC_BASE OPTPROC_TRANSLATE
/**
* The callout function that invokes the optionUsage function.
*
- * @param pOptions the AutoOpts option description structure
- * @param pOptDesc the descriptor for the "help" (usage) option.
+ * @param[in] pOptions the AutoOpts option description structure
+ * @param[in] pOptDesc the descriptor for the "help" (usage) option.
* @noreturn
*/
static void
/**
* Code to handle the debug-level option.
*
- * @param pOptions the ntpdc options data structure
- * @param pOptDesc the option descriptor for this option.
+ * @param[in] pOptions the ntpdc options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
*/
static void
doOptDebug_Level(tOptions* pOptions, tOptDesc* pOptDesc)
* Generated main procedure. This will emit text that a Bourne shell can
* process to handle its command line arguments.
*
- * @param argc argument count
- * @param argv argument vector
+ * @param[in] argc argument count
+ * @param[in] argv argument vector
* @returns program exit code
*/
int
#ifndef WITH_PACKAGER
# define ntpdc_packager_info NULL
#else
+/** Packager information for ntpdc. */
static char const ntpdc_packager_info[] =
"Packaged by " WITH_PACKAGER
};
#if ENABLE_NLS
-/*
+/**
* This code is designed to translate translatable option text for the
* ntpdc program. These translations happen upon entry
* to optionProcess().
#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:
translate option names.
*/
/* referenced via ntpdcOptions.pzCopyright */
- puts(_("ntpdc 4.2.7p357\n\
+ puts(_("ntpdc 4.2.7p358\n\
Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n\
This is free software. It is licensed for use, modification and\n\
redistribution under the terms of the NTP License, copies of which\n\
puts(_("load options from a config file"));
/* referenced via ntpdcOptions.pzUsageTitle */
- puts(_("ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p357\n\
+ puts(_("ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p358\n\
Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
/* referenced via ntpdcOptions.pzExplain */
puts(_("\n"));
/* referenced via ntpdcOptions.pzFullVersion */
- puts(_("ntpdc 4.2.7p357"));
+ puts(_("ntpdc 4.2.7p358"));
/* referenced via ntpdcOptions.pzFullUsage */
puts(_("<<<NOT-FOUND>>>"));
puts(_("could not locate the 'help' option"));
#line 351 "../autoopts.c"
puts(_("optionProcess() was called with invalid data"));
-#line 770 "../usage.c"
+#line 783 "../usage.c"
puts(_("invalid argument type specified"));
#line 589 "../find.c"
puts(_("defaulted to option with optional arg"));
puts(_(" or an integer from %d through %d\n"));
#line 164 "../enum.c"
puts(_(" or an integer from %d through %d\n"));
-#line 769 "../usage.c"
+#line 782 "../usage.c"
puts(_("%s error: invalid option descriptor for %s\n"));
-#line 1097 "../usage.c"
+#line 1110 "../usage.c"
puts(_("%s error: invalid option descriptor for %s\n"));
#line 379 "../find.c"
puts(_("%s: invalid option name: %s\n"));
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'"));
+ "\t'%s' and '%s'."));
#line 94 "../check.c"
puts(_("%s error: The %s option is required\n"));
#line 623 "../find.c"
#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"));
+ 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(_("standard output"));
#line 451 "../usage.c"
puts(_("standard output"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
puts(_("standard output"));
#line 175 "../version.c"
puts(_("standard output"));
puts(_("standard error"));
#line 451 "../usage.c"
puts(_("standard error"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
puts(_("standard error"));
#line 175 "../version.c"
puts(_("standard error"));
puts(_("write"));
#line 450 "../usage.c"
puts(_("write"));
-#line 646 "../usage.c"
+#line 659 "../usage.c"
puts(_("write"));
#line 174 "../version.c"
puts(_("write"));
/* END-LIBOPTS-MESSAGES */
/* USAGE-TEXT: */
-#line 895 "../usage.c"
+#line 908 "../usage.c"
puts(_("\t\t\t\t- an alternate for '%s'\n"));
-#line 1164 "../usage.c"
+#line 1177 "../usage.c"
puts(_("Version, usage and configuration options:"));
-#line 946 "../usage.c"
+#line 959 "../usage.c"
puts(_("\t\t\t\t- default option for unnamed options\n"));
-#line 859 "../usage.c"
+#line 872 "../usage.c"
puts(_("\t\t\t\t- disabled as '--%s'\n"));
-#line 1133 "../usage.c"
+#line 1146 "../usage.c"
puts(_(" --- %-14s %s\n"));
-#line 1131 "../usage.c"
+#line 1144 "../usage.c"
puts(_("This option has been disabled"));
-#line 886 "../usage.c"
+#line 899 "../usage.c"
puts(_("\t\t\t\t- enabled by default\n"));
#line 40 "../alias.c"
puts(_("%s error: only "));
-#line 1208 "../usage.c"
+#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"));
"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 919 "../usage.c"
+#line 932 "../usage.c"
puts(_("\t\t\t\t- is a set membership option\n"));
-#line 940 "../usage.c"
+#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 926 "../usage.c"
+#line 939 "../usage.c"
puts(_("\t\t\t\t- may appear multiple times\n"));
-#line 913 "../usage.c"
+#line 926 "../usage.c"
puts(_("\t\t\t\t- may not be preset\n"));
-#line 1323 "../usage.c"
+#line 1336 "../usage.c"
puts(_(" Arg Option-Name Description\n"));
-#line 1259 "../usage.c"
+#line 1272 "../usage.c"
puts(_(" Flg Arg Option-Name Description\n"));
-#line 1317 "../usage.c"
+#line 1330 "../usage.c"
puts(_(" Flg Arg Option-Name Description\n"));
-#line 1318 "../usage.c"
+#line 1331 "../usage.c"
puts(_(" %3s %s"));
-#line 1324 "../usage.c"
+#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 993 "../usage.c"
+#line 1006 "../usage.c"
puts(_(" - reading file %s"));
#line 445 "../usage.c"
puts(_("\n"
#line 129 "../version.c"
puts(_("\n"
"please send bug reports to: <%s>\n"));
-#line 925 "../usage.c"
+#line 938 "../usage.c"
puts(_("\t\t\t\t- may NOT appear - preset only\n"));
-#line 965 "../usage.c"
+#line 978 "../usage.c"
puts(_("\n"
"The following option preset mechanisms are supported:\n"));
-#line 1206 "../usage.c"
+#line 1219 "../usage.c"
puts(_("\n"
"The following option preset mechanisms are supported:\n"));
-#line 704 "../usage.c"
+#line 717 "../usage.c"
puts(_("prohibits these options:\n"));
-#line 699 "../usage.c"
+#line 712 "../usage.c"
puts(_("prohibits the option '%s'\n"));
#line 81 "../numeric.c"
puts(_("%s%ld to %ld"));
puts(_("%sless than or equal to %ld"));
#line 426 "../usage.c"
puts(_("Operands and options may be intermixed. They will be reordered.\n"));
-#line 674 "../usage.c"
+#line 687 "../usage.c"
puts(_("requires the option '%s'\n"));
-#line 677 "../usage.c"
+#line 690 "../usage.c"
puts(_("requires these options:\n"));
-#line 1335 "../usage.c"
+#line 1348 "../usage.c"
puts(_(" Arg Option-Name Req? Description\n"));
-#line 1329 "../usage.c"
+#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 932 "../usage.c"
+#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 1168 "../usage.c"
+#line 1181 "../usage.c"
puts(_("The next option supports vendor supported extra options:"));
-#line 795 "../usage.c"
+#line 808 "../usage.c"
puts(_("These additional options are:"));
/* END-USAGE-TEXT */
}
/*
* EDIT THIS FILE WITH CAUTION (ntpdc-opts.h)
*
- * It has been AutoGen-ed February 21, 2013 at 10:46:41 PM by AutoGen 5.17.2pre17
+ * It has been AutoGen-ed February 27, 2013 at 11:37:25 AM by AutoGen 5.17.3.pre2
* From the definitions ntpdc-opts.def
* and the template file options
*
* representations about the suitability this software for any purpose. It
* is provided "as is" without express or implied warranty.
*/
-/*
+/**
* This file contains the programmatic interface to the Automated
* Options generated for the ntpdc program.
* These macros are documented in the AutoGen info file in the
#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
Choke Me.
#endif
-/*
- * Enumeration of each option:
+/**
+ * Enumeration of each option type for ntpdc
*/
typedef enum {
INDEX_OPT_IPV4 = 0,
INDEX_OPT_SAVE_OPTS = 13,
INDEX_OPT_LOAD_OPTS = 14
} teOptIndex;
-
+/** count of all options for ntpdc */
#define OPTION_CT 15
-#define NTPDC_VERSION "4.2.7p357"
-#define NTPDC_FULL_VERSION "ntpdc 4.2.7p357"
+/** ntpdc version */
+#define NTPDC_VERSION "4.2.7p358"
+/** Full ntpdc version text */
+#define NTPDC_FULL_VERSION "ntpdc 4.2.7p358"
-/*
+/**
* Interface defines for all options. Replace "n" with the UPPER_CASED
* option name (as in the teOptIndex enumeration above).
* e.g. HAVE_OPT(IPV4)
*/
#define DESC(n) (ntpdcOptions.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 ntpdc exit codes
*/
typedef enum {
NTPDC_EXIT_NO_CONFIG_INPUT = 66,
NTPDC_EXIT_LIBOPTS_FAILURE = 70
} ntpdc_exit_code_t;
-/*
+/** @} */
+/**
* Make sure there are no #define name conflicts with the option names
*/
#ifndef NO_OPTION_NAME_WARNINGS
# undef SHOWPEERS
#endif /* NO_OPTION_NAME_WARNINGS */
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
* Interface defines for specific options.
+ * @{
*/
#define VALUE_OPT_IPV4 '4'
#define VALUE_OPT_IPV6 '6'
#define VALUE_OPT_NUMERIC 'n'
#define VALUE_OPT_PEERS 'p'
#define VALUE_OPT_SHOWPEERS 's'
+/** option flag (value) for " (get "val-name") " option */
#define VALUE_OPT_HELP '?'
+/** 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 INDEX_OPT_VERSION
+/** option flag (value) for " (get "val-name") " option */
#define VALUE_OPT_SAVE_OPTS '>'
+/** option flag (value) for " (get "val-name") " option */
#define VALUE_OPT_LOAD_OPTS '<'
#define SET_OPT_SAVE_OPTS(a) STMTS( \
DESC(SAVE_OPTS).fOptState &= OPTST_PERSISTENT_MASK; \
ntpdcOptions.pzCurOpt = NULL)
#define START_OPT RESTART_OPT(1)
#define USAGE(c) (*ntpdcOptions.pUsageProc)(&ntpdcOptions, c)
-/* extracted from opthead.tlib near line 498 */
+/* extracted from opthead.tlib near line 538 */
#ifdef __cplusplus
extern "C" {
-.TH ntpdc 1ntpdcman "21 Feb 2013" "4.2.7p357" "User Commands"
+.TH ntpdc 1ntpdcman "27 Feb 2013" "4.2.7p358" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntpdc-opts.man)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:46:52 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:37:37 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntpdc-opts.def
.\" and the template file agman-cmd.tpl
.\"
-.Dd February 21 2013
+.Dd February 27 2013
.Dt NTPDC 1ntpdcmdoc User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntpdc-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:46:59 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:37:43 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntpdc-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
clock. Run as root, it can correct the system clock to this offset as
well. It can be run as an interactive command or from a cron job.
- <p>This document applies to version 4.2.7p357 of <code>ntpdc</code>.
+ <p>This document applies to version 4.2.7p358 of <code>ntpdc</code>.
<p>The program implements the SNTP protocol as defined by RFC 5905, the NTPv4
IETF specification.
used to select the program, defaulting to <span class="file">more</span>. Both will exit
with a status code of 0.
-<pre class="example">ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p357
+<pre class="example">ntpdc - vendor-specific NTPD control program - Ver. 4.2.7p358
Usage: ntpdc [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]
Flg Arg Option-Name Description
-4 no ipv4 Force IPv4 DNS name resolution
-.TH ntpdc @NTPDC_MS@ "21 Feb 2013" "4.2.7p357" "User Commands"
+.TH ntpdc @NTPDC_MS@ "27 Feb 2013" "4.2.7p358" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntpdc-opts.man)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:46:52 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:37:37 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntpdc-opts.def
.\" and the template file agman-cmd.tpl
.\"
-.Dd February 21 2013
+.Dd February 27 2013
.Dt NTPDC @NTPDC_MS@ User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntpdc-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:46:59 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:37:43 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntpdc-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-ntpq.texi)
#
-# It has been AutoGen-ed February 21, 2013 at 10:47:28 PM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed February 27, 2013 at 11:38:12 AM by AutoGen 5.17.3.pre2
# From the definitions ntpq-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-ntpq - standard NTP query program - Ver. 4.2.7p357
+ntpq - standard NTP query program - Ver. 4.2.7p358
Usage: ntpq [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [ host ...]
Flg Arg Option-Name Description
-4 no ipv4 Force IPv4 DNS name resolution
/*
* EDIT THIS FILE WITH CAUTION (ntpq-opts.c)
*
- * It has been AutoGen-ed February 21, 2013 at 10:47:02 PM by AutoGen 5.17.2pre17
+ * It has been AutoGen-ed February 27, 2013 at 11:37:46 AM by AutoGen 5.17.3.pre2
* From the definitions ntpq-opts.def
* and the template file options
*
# define NULL 0
#endif
-/*
- * ntpq option static const strings
+/**
+ * static const strings for ntpq options
*/
static char const ntpq_opt_strs[1833] =
-/* 0 */ "ntpq 4.2.7p357\n"
+/* 0 */ "ntpq 4.2.7p358\n"
"Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n"
"This is free software. It is licensed for use, modification and\n"
"redistribution under the terms of the NTP License, copies of which\n"
/* 1627 */ "no-load-opts\0"
/* 1640 */ "no\0"
/* 1643 */ "NTPQ\0"
-/* 1648 */ "ntpq - standard NTP query program - Ver. 4.2.7p357\n"
+/* 1648 */ "ntpq - standard NTP query program - Ver. 4.2.7p358\n"
"Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n\0"
/* 1769 */ "$HOME\0"
/* 1775 */ ".\0"
/* 1777 */ ".ntprc\0"
/* 1784 */ "http://bugs.ntp.org, bugs@ntp.org\0"
-/* 1818 */ "ntpq 4.2.7p357";
+/* 1818 */ "ntpq 4.2.7p358";
-/*
+/**
* ipv4 option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the ipv4 option */
#define IPV4_DESC (ntpq_opt_strs+954)
+/** Upper-cased name for the ipv4 option */
#define IPV4_NAME (ntpq_opt_strs+985)
+/** Name string for the ipv4 option */
#define IPV4_name (ntpq_opt_strs+990)
+/** Other options that appear in conjunction with the ipv4 option */
static int const aIpv4CantList[] = {
INDEX_OPT_IPV6, NO_EQUIVALENT };
+/** Compiled in flag settings for the ipv4 option */
#define IPV4_FLAGS (OPTST_DISABLED)
-/*
+/**
* ipv6 option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the ipv6 option */
#define IPV6_DESC (ntpq_opt_strs+995)
+/** Upper-cased name for the ipv6 option */
#define IPV6_NAME (ntpq_opt_strs+1026)
+/** Name string for the ipv6 option */
#define IPV6_name (ntpq_opt_strs+1031)
+/** Other options that appear in conjunction with the ipv6 option */
static int const aIpv6CantList[] = {
INDEX_OPT_IPV4, NO_EQUIVALENT };
+/** Compiled in flag settings for the ipv6 option */
#define IPV6_FLAGS (OPTST_DISABLED)
-/*
+/**
* command option description:
*/
+/** Descriptive text for the command option */
#define COMMAND_DESC (ntpq_opt_strs+1036)
+/** Upper-cased name for the command option */
#define COMMAND_NAME (ntpq_opt_strs+1059)
+/** Name string for the command option */
#define COMMAND_name (ntpq_opt_strs+1067)
+/** Compiled in flag settings for the command option */
#define COMMAND_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
-/*
+/**
* debug-level option description:
*/
+/** Descriptive text for the debug-level option */
#define DEBUG_LEVEL_DESC (ntpq_opt_strs+1075)
+/** Upper-cased name for the debug-level option */
#define DEBUG_LEVEL_NAME (ntpq_opt_strs+1106)
+/** Name string for the debug-level option */
#define DEBUG_LEVEL_name (ntpq_opt_strs+1118)
+/** Compiled in flag settings for the debug-level option */
#define DEBUG_LEVEL_FLAGS (OPTST_DISABLED)
-/*
+/**
* set-debug-level option description:
*/
+/** Descriptive text for the set-debug-level option */
#define SET_DEBUG_LEVEL_DESC (ntpq_opt_strs+1130)
+/** Upper-cased name for the set-debug-level option */
#define SET_DEBUG_LEVEL_NAME (ntpq_opt_strs+1160)
+/** Name string for the set-debug-level option */
#define SET_DEBUG_LEVEL_name (ntpq_opt_strs+1176)
+/** Compiled in flag settings for the set-debug-level option */
#define SET_DEBUG_LEVEL_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
-/*
+/**
* peers option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the peers option */
#define PEERS_DESC (ntpq_opt_strs+1192)
+/** Upper-cased name for the peers option */
#define PEERS_NAME (ntpq_opt_strs+1218)
+/** Name string for the peers option */
#define PEERS_name (ntpq_opt_strs+1224)
+/** Other options that appear in conjunction with the peers option */
static int const aPeersCantList[] = {
INDEX_OPT_INTERACTIVE, NO_EQUIVALENT };
+/** Compiled in flag settings for the peers option */
#define PEERS_FLAGS (OPTST_DISABLED)
-/*
+/**
* interactive option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the interactive option */
#define INTERACTIVE_DESC (ntpq_opt_strs+1230)
+/** Upper-cased name for the interactive option */
#define INTERACTIVE_NAME (ntpq_opt_strs+1272)
+/** Name string for the interactive option */
#define INTERACTIVE_name (ntpq_opt_strs+1284)
+/** Other options that appear in conjunction with the interactive option */
static int const aInteractiveCantList[] = {
INDEX_OPT_COMMAND,
INDEX_OPT_PEERS, NO_EQUIVALENT };
+/** Compiled in flag settings for the interactive option */
#define INTERACTIVE_FLAGS (OPTST_DISABLED)
-/*
+/**
* numeric option description:
*/
+/** Descriptive text for the numeric option */
#define NUMERIC_DESC (ntpq_opt_strs+1296)
+/** Upper-cased name for the numeric option */
#define NUMERIC_NAME (ntpq_opt_strs+1319)
+/** Name string for the numeric option */
#define NUMERIC_name (ntpq_opt_strs+1327)
+/** Compiled in flag settings for the numeric option */
#define NUMERIC_FLAGS (OPTST_DISABLED)
-/*
+/**
* old-rv option description:
*/
+/** Descriptive text for the old-rv option */
#define OLD_RV_DESC (ntpq_opt_strs+1335)
+/** Upper-cased name for the old-rv option */
#define OLD_RV_NAME (ntpq_opt_strs+1374)
+/** Name string for the old-rv option */
#define OLD_RV_name (ntpq_opt_strs+1381)
+/** Compiled in flag settings for the old-rv option */
#define OLD_RV_FLAGS (OPTST_DISABLED)
/*
#define NO_LOAD_OPTS_name (ntpq_opt_strs+1627)
#define LOAD_OPTS_pfx (ntpq_opt_strs+1640)
#define LOAD_OPTS_name (NO_LOAD_OPTS_name + 3)
-/*
+/**
* Declare option callback procedures
*/
#if defined(TEST_NTPQ_OPTS)
static tOptProc
doOptDebug_Level, doUsageOpt;
-/*
+/**
* #define map the "normal" callout procs
*/
#define COMMAND_OPT_PROC ntpq_custom_opt_handler
};
-/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
- *
- * Define the ntpq Option Environment
- */
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/** Reference to the upper cased version of ntpq. */
#define zPROGNAME (ntpq_opt_strs+1643)
+/** Reference to the title line for ntpq usage. */
#define zUsageTitle (ntpq_opt_strs+1648)
+/** ntpq configuration file name. */
#define zRcName (ntpq_opt_strs+1777)
+/** Directories to search for ntpq config files. */
static char const * const apzHomeList[3] = {
ntpq_opt_strs+1769,
ntpq_opt_strs+1775,
NULL };
+/** The ntpq program bug email address. */
#define zBugsAddr (ntpq_opt_strs+1784)
+/** Clarification/explanation of what ntpq does. */
#define zExplain (NULL)
+/** Extra detail explaining what ntpq does. */
#define zDetail (NULL)
+/** The full version string for ntpq. */
#define zFullVersion (ntpq_opt_strs+1818)
-/* extracted from optcode.tlib near line 364 */
+/* extracted from optcode.tlib near line 371 */
#if defined(ENABLE_NLS)
# define OPTPROC_BASE OPTPROC_TRANSLATE
/**
* The callout function that invokes the optionUsage function.
*
- * @param pOptions the AutoOpts option description structure
- * @param pOptDesc the descriptor for the "help" (usage) option.
+ * @param[in] pOptions the AutoOpts option description structure
+ * @param[in] pOptDesc the descriptor for the "help" (usage) option.
* @noreturn
*/
static void
/**
* Code to handle the debug-level option.
*
- * @param pOptions the ntpq options data structure
- * @param pOptDesc the option descriptor for this option.
+ * @param[in] pOptions the ntpq options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
*/
static void
doOptDebug_Level(tOptions* pOptions, tOptDesc* pOptDesc)
* Generated main procedure. This will emit text that a Bourne shell can
* process to handle its command line arguments.
*
- * @param argc argument count
- * @param argv argument vector
+ * @param[in] argc argument count
+ * @param[in] argv argument vector
* @returns program exit code
*/
int
#ifndef WITH_PACKAGER
# define ntpq_packager_info NULL
#else
+/** Packager information for ntpq. */
static char const ntpq_packager_info[] =
"Packaged by " WITH_PACKAGER
};
#if ENABLE_NLS
-/*
+/**
* This code is designed to translate translatable option text for the
* ntpq program. These translations happen upon entry
* to optionProcess().
#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:
translate option names.
*/
/* referenced via ntpqOptions.pzCopyright */
- puts(_("ntpq 4.2.7p357\n\
+ puts(_("ntpq 4.2.7p358\n\
Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n\
This is free software. It is licensed for use, modification and\n\
redistribution under the terms of the NTP License, copies of which\n\
puts(_("load options from a config file"));
/* referenced via ntpqOptions.pzUsageTitle */
- puts(_("ntpq - standard NTP query program - Ver. 4.2.7p357\n\
+ puts(_("ntpq - standard NTP query program - Ver. 4.2.7p358\n\
Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
/* referenced via ntpqOptions.pzFullVersion */
- puts(_("ntpq 4.2.7p357"));
+ puts(_("ntpq 4.2.7p358"));
/* referenced via ntpqOptions.pzFullUsage */
puts(_("<<<NOT-FOUND>>>"));
puts(_("could not locate the 'help' option"));
#line 351 "../autoopts.c"
puts(_("optionProcess() was called with invalid data"));
-#line 770 "../usage.c"
+#line 783 "../usage.c"
puts(_("invalid argument type specified"));
#line 589 "../find.c"
puts(_("defaulted to option with optional arg"));
puts(_(" or an integer from %d through %d\n"));
#line 164 "../enum.c"
puts(_(" or an integer from %d through %d\n"));
-#line 769 "../usage.c"
+#line 782 "../usage.c"
puts(_("%s error: invalid option descriptor for %s\n"));
-#line 1097 "../usage.c"
+#line 1110 "../usage.c"
puts(_("%s error: invalid option descriptor for %s\n"));
#line 379 "../find.c"
puts(_("%s: invalid option name: %s\n"));
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'"));
+ "\t'%s' and '%s'."));
#line 94 "../check.c"
puts(_("%s error: The %s option is required\n"));
#line 623 "../find.c"
#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"));
+ 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(_("standard output"));
#line 451 "../usage.c"
puts(_("standard output"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
puts(_("standard output"));
#line 175 "../version.c"
puts(_("standard output"));
puts(_("standard error"));
#line 451 "../usage.c"
puts(_("standard error"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
puts(_("standard error"));
#line 175 "../version.c"
puts(_("standard error"));
puts(_("write"));
#line 450 "../usage.c"
puts(_("write"));
-#line 646 "../usage.c"
+#line 659 "../usage.c"
puts(_("write"));
#line 174 "../version.c"
puts(_("write"));
/* END-LIBOPTS-MESSAGES */
/* USAGE-TEXT: */
-#line 895 "../usage.c"
+#line 908 "../usage.c"
puts(_("\t\t\t\t- an alternate for '%s'\n"));
-#line 1164 "../usage.c"
+#line 1177 "../usage.c"
puts(_("Version, usage and configuration options:"));
-#line 946 "../usage.c"
+#line 959 "../usage.c"
puts(_("\t\t\t\t- default option for unnamed options\n"));
-#line 859 "../usage.c"
+#line 872 "../usage.c"
puts(_("\t\t\t\t- disabled as '--%s'\n"));
-#line 1133 "../usage.c"
+#line 1146 "../usage.c"
puts(_(" --- %-14s %s\n"));
-#line 1131 "../usage.c"
+#line 1144 "../usage.c"
puts(_("This option has been disabled"));
-#line 886 "../usage.c"
+#line 899 "../usage.c"
puts(_("\t\t\t\t- enabled by default\n"));
#line 40 "../alias.c"
puts(_("%s error: only "));
-#line 1208 "../usage.c"
+#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"));
"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 919 "../usage.c"
+#line 932 "../usage.c"
puts(_("\t\t\t\t- is a set membership option\n"));
-#line 940 "../usage.c"
+#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 926 "../usage.c"
+#line 939 "../usage.c"
puts(_("\t\t\t\t- may appear multiple times\n"));
-#line 913 "../usage.c"
+#line 926 "../usage.c"
puts(_("\t\t\t\t- may not be preset\n"));
-#line 1323 "../usage.c"
+#line 1336 "../usage.c"
puts(_(" Arg Option-Name Description\n"));
-#line 1259 "../usage.c"
+#line 1272 "../usage.c"
puts(_(" Flg Arg Option-Name Description\n"));
-#line 1317 "../usage.c"
+#line 1330 "../usage.c"
puts(_(" Flg Arg Option-Name Description\n"));
-#line 1318 "../usage.c"
+#line 1331 "../usage.c"
puts(_(" %3s %s"));
-#line 1324 "../usage.c"
+#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 993 "../usage.c"
+#line 1006 "../usage.c"
puts(_(" - reading file %s"));
#line 445 "../usage.c"
puts(_("\n"
#line 129 "../version.c"
puts(_("\n"
"please send bug reports to: <%s>\n"));
-#line 925 "../usage.c"
+#line 938 "../usage.c"
puts(_("\t\t\t\t- may NOT appear - preset only\n"));
-#line 965 "../usage.c"
+#line 978 "../usage.c"
puts(_("\n"
"The following option preset mechanisms are supported:\n"));
-#line 1206 "../usage.c"
+#line 1219 "../usage.c"
puts(_("\n"
"The following option preset mechanisms are supported:\n"));
-#line 704 "../usage.c"
+#line 717 "../usage.c"
puts(_("prohibits these options:\n"));
-#line 699 "../usage.c"
+#line 712 "../usage.c"
puts(_("prohibits the option '%s'\n"));
#line 81 "../numeric.c"
puts(_("%s%ld to %ld"));
puts(_("%sless than or equal to %ld"));
#line 426 "../usage.c"
puts(_("Operands and options may be intermixed. They will be reordered.\n"));
-#line 674 "../usage.c"
+#line 687 "../usage.c"
puts(_("requires the option '%s'\n"));
-#line 677 "../usage.c"
+#line 690 "../usage.c"
puts(_("requires these options:\n"));
-#line 1335 "../usage.c"
+#line 1348 "../usage.c"
puts(_(" Arg Option-Name Req? Description\n"));
-#line 1329 "../usage.c"
+#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 932 "../usage.c"
+#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 1168 "../usage.c"
+#line 1181 "../usage.c"
puts(_("The next option supports vendor supported extra options:"));
-#line 795 "../usage.c"
+#line 808 "../usage.c"
puts(_("These additional options are:"));
/* END-USAGE-TEXT */
}
/*
* EDIT THIS FILE WITH CAUTION (ntpq-opts.h)
*
- * It has been AutoGen-ed February 21, 2013 at 10:47:01 PM by AutoGen 5.17.2pre17
+ * It has been AutoGen-ed February 27, 2013 at 11:37:45 AM by AutoGen 5.17.3.pre2
* From the definitions ntpq-opts.def
* and the template file options
*
* representations about the suitability this software for any purpose. It
* is provided "as is" without express or implied warranty.
*/
-/*
+/**
* This file contains the programmatic interface to the Automated
* Options generated for the ntpq program.
* These macros are documented in the AutoGen info file in the
#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
Choke Me.
#endif
-/*
- * Enumeration of each option:
+/**
+ * Enumeration of each option type for ntpq
*/
typedef enum {
INDEX_OPT_IPV4 = 0,
INDEX_OPT_SAVE_OPTS = 12,
INDEX_OPT_LOAD_OPTS = 13
} teOptIndex;
-
+/** count of all options for ntpq */
#define OPTION_CT 14
-#define NTPQ_VERSION "4.2.7p357"
-#define NTPQ_FULL_VERSION "ntpq 4.2.7p357"
+/** ntpq version */
+#define NTPQ_VERSION "4.2.7p358"
+/** Full ntpq version text */
+#define NTPQ_FULL_VERSION "ntpq 4.2.7p358"
-/*
+/**
* Interface defines for all options. Replace "n" with the UPPER_CASED
* option name (as in the teOptIndex enumeration above).
* e.g. HAVE_OPT(IPV4)
*/
#define DESC(n) (ntpqOptions.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 ntpq exit codes
*/
typedef enum {
NTPQ_EXIT_NO_CONFIG_INPUT = 66,
NTPQ_EXIT_LIBOPTS_FAILURE = 70
} ntpq_exit_code_t;
-/*
+/** @} */
+/**
* Make sure there are no #define name conflicts with the option names
*/
#ifndef NO_OPTION_NAME_WARNINGS
# undef OLD_RV
#endif /* NO_OPTION_NAME_WARNINGS */
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
* Interface defines for specific options.
+ * @{
*/
#define VALUE_OPT_IPV4 '4'
#define VALUE_OPT_IPV6 '6'
#define VALUE_OPT_INTERACTIVE 'i'
#define VALUE_OPT_NUMERIC 'n'
#define VALUE_OPT_OLD_RV 8
+/** option flag (value) for " (get "val-name") " option */
#define VALUE_OPT_HELP '?'
+/** 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 INDEX_OPT_VERSION
+/** option flag (value) for " (get "val-name") " option */
#define VALUE_OPT_SAVE_OPTS '>'
+/** option flag (value) for " (get "val-name") " option */
#define VALUE_OPT_LOAD_OPTS '<'
#define SET_OPT_SAVE_OPTS(a) STMTS( \
DESC(SAVE_OPTS).fOptState &= OPTST_PERSISTENT_MASK; \
ntpqOptions.pzCurOpt = NULL)
#define START_OPT RESTART_OPT(1)
#define USAGE(c) (*ntpqOptions.pUsageProc)(&ntpqOptions, c)
-/* extracted from opthead.tlib near line 498 */
+/* extracted from opthead.tlib near line 538 */
#ifdef __cplusplus
extern "C" {
-.TH ntpq 1ntpqman "21 Feb 2013" "4.2.7p357" "User Commands"
+.TH ntpq 1ntpqman "27 Feb 2013" "4.2.7p358" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntpq-opts.man)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:47:24 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:38:08 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntpq-opts.def
.\" and the template file agman-cmd.tpl
.\"
-.Dd February 21 2013
+.Dd February 27 2013
.Dt NTPQ 1ntpqmdoc User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntpq-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:47:30 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:38:14 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntpq-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
and determine the performance of
<code>ntpd</code>, the NTP daemon.
- <p>This document applies to version 4.2.7p357 of <code>ntpq</code>.
+ <p>This document applies to version 4.2.7p358 of <code>ntpq</code>.
<ul class="menu">
<li><a accesskey="1" href="#ntpq-Description">ntpq Description</a>
used to select the program, defaulting to <span class="file">more</span>. Both will exit
with a status code of 0.
-<pre class="example">ntpq - standard NTP query program - Ver. 4.2.7p356
+<pre class="example">ntpq - standard NTP query program - Ver. 4.2.7p357
Usage: ntpq [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]
Flg Arg Option-Name Description
-4 no ipv4 Force IPv4 DNS name resolution
-.TH ntpq @NTPQ_MS@ "21 Feb 2013" "4.2.7p357" "User Commands"
+.TH ntpq @NTPQ_MS@ "27 Feb 2013" "4.2.7p358" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntpq-opts.man)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:47:24 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:38:08 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntpq-opts.def
.\" and the template file agman-cmd.tpl
.\"
-.Dd February 21 2013
+.Dd February 27 2013
.Dt NTPQ @NTPQ_MS@ User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntpq-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:47:30 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:38:14 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntpq-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-ntpsnmpd.texi)
#
-# It has been AutoGen-ed February 21, 2013 at 10:47:46 PM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed February 27, 2013 at 11:38:29 AM by AutoGen 5.17.3.pre2
# From the definitions ntpsnmpd-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p357
+ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p358
Usage: ntpsnmpd [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
Flg Arg Option-Name Description
-n no nofork Do not fork
/*
* EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.c)
*
- * It has been AutoGen-ed February 21, 2013 at 10:47:32 PM by AutoGen 5.17.2pre17
+ * It has been AutoGen-ed February 27, 2013 at 11:38:16 AM by AutoGen 5.17.3.pre2
* From the definitions ntpsnmpd-opts.def
* and the template file options
*
# define NULL 0
#endif
-/*
- * ntpsnmpd option static const strings
+/**
+ * static const strings for ntpsnmpd options
*/
static char const ntpsnmpd_opt_strs[1560] =
-/* 0 */ "ntpsnmpd 4.2.7p357\n"
+/* 0 */ "ntpsnmpd 4.2.7p358\n"
"Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n"
"This is free software. It is licensed for use, modification and\n"
"redistribution under the terms of the NTP License, copies of which\n"
/* 1360 */ "no-load-opts\0"
/* 1373 */ "no\0"
/* 1376 */ "NTPSNMPD\0"
-/* 1385 */ "ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p357\n"
+/* 1385 */ "ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p358\n"
"Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n\0"
/* 1490 */ "$HOME\0"
/* 1496 */ ".\0"
/* 1498 */ ".ntprc\0"
/* 1505 */ "http://bugs.ntp.org, bugs@ntp.org\0"
/* 1539 */ "\n\0"
-/* 1541 */ "ntpsnmpd 4.2.7p357";
+/* 1541 */ "ntpsnmpd 4.2.7p358";
-/*
+/**
* nofork option description:
*/
+/** Descriptive text for the nofork option */
#define NOFORK_DESC (ntpsnmpd_opt_strs+958)
+/** Upper-cased name for the nofork option */
#define NOFORK_NAME (ntpsnmpd_opt_strs+970)
+/** Name string for the nofork option */
#define NOFORK_name (ntpsnmpd_opt_strs+977)
+/** Compiled in flag settings for the nofork option */
#define NOFORK_FLAGS (OPTST_DISABLED)
-/*
+/**
* syslog option description:
*/
+/** Descriptive text for the syslog option */
#define SYSLOG_DESC (ntpsnmpd_opt_strs+984)
+/** Upper-cased name for the syslog option */
#define SYSLOG_NAME (ntpsnmpd_opt_strs+1000)
+/** Name string for the syslog option */
#define SYSLOG_name (ntpsnmpd_opt_strs+1007)
+/** Compiled in flag settings for the syslog option */
#define SYSLOG_FLAGS (OPTST_DISABLED)
-/*
+/**
* agentXSocket option description:
*/
+/** Descriptive text for the agentXSocket option */
#define AGENTXSOCKET_DESC (ntpsnmpd_opt_strs+1014)
+/** Upper-cased name for the agentXSocket option */
#define AGENTXSOCKET_NAME (ntpsnmpd_opt_strs+1071)
+/** Name string for the agentXSocket option */
#define AGENTXSOCKET_name (ntpsnmpd_opt_strs+1084)
+/** The compiled in default value for the agentXSocket option argument */
#define AGENTXSOCKET_DFT_ARG (ntpsnmpd_opt_strs+1097)
+/** Compiled in flag settings for the agentXSocket option */
#define AGENTXSOCKET_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
#define NO_LOAD_OPTS_name (ntpsnmpd_opt_strs+1360)
#define LOAD_OPTS_pfx (ntpsnmpd_opt_strs+1373)
#define LOAD_OPTS_name (NO_LOAD_OPTS_name + 3)
-/*
+/**
* Declare option callback procedures
*/
#if defined(TEST_NTPSNMPD_OPTS)
};
-/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
- *
- * Define the ntpsnmpd Option Environment
- */
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/** Reference to the upper cased version of ntpsnmpd. */
#define zPROGNAME (ntpsnmpd_opt_strs+1376)
+/** Reference to the title line for ntpsnmpd usage. */
#define zUsageTitle (ntpsnmpd_opt_strs+1385)
+/** ntpsnmpd configuration file name. */
#define zRcName (ntpsnmpd_opt_strs+1498)
+/** Directories to search for ntpsnmpd config files. */
static char const * const apzHomeList[3] = {
ntpsnmpd_opt_strs+1490,
ntpsnmpd_opt_strs+1496,
NULL };
+/** The ntpsnmpd program bug email address. */
#define zBugsAddr (ntpsnmpd_opt_strs+1505)
+/** Clarification/explanation of what ntpsnmpd does. */
#define zExplain (ntpsnmpd_opt_strs+1539)
+/** Extra detail explaining what ntpsnmpd does. */
#define zDetail (NULL)
+/** The full version string for ntpsnmpd. */
#define zFullVersion (ntpsnmpd_opt_strs+1541)
-/* extracted from optcode.tlib near line 364 */
+/* extracted from optcode.tlib near line 371 */
#if defined(ENABLE_NLS)
# define OPTPROC_BASE OPTPROC_TRANSLATE
/**
* The callout function that invokes the optionUsage function.
*
- * @param pOptions the AutoOpts option description structure
- * @param pOptDesc the descriptor for the "help" (usage) option.
+ * @param[in] pOptions the AutoOpts option description structure
+ * @param[in] pOptDesc the descriptor for the "help" (usage) option.
* @noreturn
*/
static void
* Generated main procedure. This will emit text that a Bourne shell can
* process to handle its command line arguments.
*
- * @param argc argument count
- * @param argv argument vector
+ * @param[in] argc argument count
+ * @param[in] argv argument vector
* @returns program exit code
*/
int
#ifndef WITH_PACKAGER
# define ntpsnmpd_packager_info NULL
#else
+/** Packager information for ntpsnmpd. */
static char const ntpsnmpd_packager_info[] =
"Packaged by " WITH_PACKAGER
};
#if ENABLE_NLS
-/*
+/**
* This code is designed to translate translatable option text for the
* ntpsnmpd program. These translations happen upon entry
* to optionProcess().
#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:
translate option names.
*/
/* referenced via ntpsnmpdOptions.pzCopyright */
- puts(_("ntpsnmpd 4.2.7p357\n\
+ puts(_("ntpsnmpd 4.2.7p358\n\
Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n\
This is free software. It is licensed for use, modification and\n\
redistribution under the terms of the NTP License, copies of which\n\
puts(_("load options from a config file"));
/* referenced via ntpsnmpdOptions.pzUsageTitle */
- puts(_("ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p357\n\
+ puts(_("ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p358\n\
Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
/* referenced via ntpsnmpdOptions.pzExplain */
puts(_("\n"));
/* referenced via ntpsnmpdOptions.pzFullVersion */
- puts(_("ntpsnmpd 4.2.7p357"));
+ puts(_("ntpsnmpd 4.2.7p358"));
/* referenced via ntpsnmpdOptions.pzFullUsage */
puts(_("<<<NOT-FOUND>>>"));
puts(_("could not locate the 'help' option"));
#line 351 "../autoopts.c"
puts(_("optionProcess() was called with invalid data"));
-#line 770 "../usage.c"
+#line 783 "../usage.c"
puts(_("invalid argument type specified"));
#line 589 "../find.c"
puts(_("defaulted to option with optional arg"));
puts(_(" or an integer from %d through %d\n"));
#line 164 "../enum.c"
puts(_(" or an integer from %d through %d\n"));
-#line 769 "../usage.c"
+#line 782 "../usage.c"
puts(_("%s error: invalid option descriptor for %s\n"));
-#line 1097 "../usage.c"
+#line 1110 "../usage.c"
puts(_("%s error: invalid option descriptor for %s\n"));
#line 379 "../find.c"
puts(_("%s: invalid option name: %s\n"));
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'"));
+ "\t'%s' and '%s'."));
#line 94 "../check.c"
puts(_("%s error: The %s option is required\n"));
#line 623 "../find.c"
#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"));
+ 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(_("standard output"));
#line 451 "../usage.c"
puts(_("standard output"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
puts(_("standard output"));
#line 175 "../version.c"
puts(_("standard output"));
puts(_("standard error"));
#line 451 "../usage.c"
puts(_("standard error"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
puts(_("standard error"));
#line 175 "../version.c"
puts(_("standard error"));
puts(_("write"));
#line 450 "../usage.c"
puts(_("write"));
-#line 646 "../usage.c"
+#line 659 "../usage.c"
puts(_("write"));
#line 174 "../version.c"
puts(_("write"));
/* END-LIBOPTS-MESSAGES */
/* USAGE-TEXT: */
-#line 895 "../usage.c"
+#line 908 "../usage.c"
puts(_("\t\t\t\t- an alternate for '%s'\n"));
-#line 1164 "../usage.c"
+#line 1177 "../usage.c"
puts(_("Version, usage and configuration options:"));
-#line 946 "../usage.c"
+#line 959 "../usage.c"
puts(_("\t\t\t\t- default option for unnamed options\n"));
-#line 859 "../usage.c"
+#line 872 "../usage.c"
puts(_("\t\t\t\t- disabled as '--%s'\n"));
-#line 1133 "../usage.c"
+#line 1146 "../usage.c"
puts(_(" --- %-14s %s\n"));
-#line 1131 "../usage.c"
+#line 1144 "../usage.c"
puts(_("This option has been disabled"));
-#line 886 "../usage.c"
+#line 899 "../usage.c"
puts(_("\t\t\t\t- enabled by default\n"));
#line 40 "../alias.c"
puts(_("%s error: only "));
-#line 1208 "../usage.c"
+#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"));
"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 919 "../usage.c"
+#line 932 "../usage.c"
puts(_("\t\t\t\t- is a set membership option\n"));
-#line 940 "../usage.c"
+#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 926 "../usage.c"
+#line 939 "../usage.c"
puts(_("\t\t\t\t- may appear multiple times\n"));
-#line 913 "../usage.c"
+#line 926 "../usage.c"
puts(_("\t\t\t\t- may not be preset\n"));
-#line 1323 "../usage.c"
+#line 1336 "../usage.c"
puts(_(" Arg Option-Name Description\n"));
-#line 1259 "../usage.c"
+#line 1272 "../usage.c"
puts(_(" Flg Arg Option-Name Description\n"));
-#line 1317 "../usage.c"
+#line 1330 "../usage.c"
puts(_(" Flg Arg Option-Name Description\n"));
-#line 1318 "../usage.c"
+#line 1331 "../usage.c"
puts(_(" %3s %s"));
-#line 1324 "../usage.c"
+#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 993 "../usage.c"
+#line 1006 "../usage.c"
puts(_(" - reading file %s"));
#line 445 "../usage.c"
puts(_("\n"
#line 129 "../version.c"
puts(_("\n"
"please send bug reports to: <%s>\n"));
-#line 925 "../usage.c"
+#line 938 "../usage.c"
puts(_("\t\t\t\t- may NOT appear - preset only\n"));
-#line 965 "../usage.c"
+#line 978 "../usage.c"
puts(_("\n"
"The following option preset mechanisms are supported:\n"));
-#line 1206 "../usage.c"
+#line 1219 "../usage.c"
puts(_("\n"
"The following option preset mechanisms are supported:\n"));
-#line 704 "../usage.c"
+#line 717 "../usage.c"
puts(_("prohibits these options:\n"));
-#line 699 "../usage.c"
+#line 712 "../usage.c"
puts(_("prohibits the option '%s'\n"));
#line 81 "../numeric.c"
puts(_("%s%ld to %ld"));
puts(_("%sless than or equal to %ld"));
#line 426 "../usage.c"
puts(_("Operands and options may be intermixed. They will be reordered.\n"));
-#line 674 "../usage.c"
+#line 687 "../usage.c"
puts(_("requires the option '%s'\n"));
-#line 677 "../usage.c"
+#line 690 "../usage.c"
puts(_("requires these options:\n"));
-#line 1335 "../usage.c"
+#line 1348 "../usage.c"
puts(_(" Arg Option-Name Req? Description\n"));
-#line 1329 "../usage.c"
+#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 932 "../usage.c"
+#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 1168 "../usage.c"
+#line 1181 "../usage.c"
puts(_("The next option supports vendor supported extra options:"));
-#line 795 "../usage.c"
+#line 808 "../usage.c"
puts(_("These additional options are:"));
/* END-USAGE-TEXT */
}
/*
* EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.h)
*
- * It has been AutoGen-ed February 21, 2013 at 10:47:32 PM by AutoGen 5.17.2pre17
+ * It has been AutoGen-ed February 27, 2013 at 11:38:16 AM by AutoGen 5.17.3.pre2
* From the definitions ntpsnmpd-opts.def
* and the template file options
*
* representations about the suitability this software for any purpose. It
* is provided "as is" without express or implied warranty.
*/
-/*
+/**
* This file contains the programmatic interface to the Automated
* Options generated for the ntpsnmpd program.
* These macros are documented in the AutoGen info file in the
#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
Choke Me.
#endif
-/*
- * Enumeration of each option:
+/**
+ * Enumeration of each option type for ntpsnmpd
*/
typedef enum {
INDEX_OPT_NOFORK = 0,
INDEX_OPT_SAVE_OPTS = 6,
INDEX_OPT_LOAD_OPTS = 7
} teOptIndex;
-
+/** count of all options for ntpsnmpd */
#define OPTION_CT 8
-#define NTPSNMPD_VERSION "4.2.7p357"
-#define NTPSNMPD_FULL_VERSION "ntpsnmpd 4.2.7p357"
+/** ntpsnmpd version */
+#define NTPSNMPD_VERSION "4.2.7p358"
+/** Full ntpsnmpd version text */
+#define NTPSNMPD_FULL_VERSION "ntpsnmpd 4.2.7p358"
-/*
+/**
* Interface defines for all options. Replace "n" with the UPPER_CASED
* option name (as in the teOptIndex enumeration above).
* e.g. HAVE_OPT(NOFORK)
*/
#define DESC(n) (ntpsnmpdOptions.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 ntpsnmpd exit codes
*/
typedef enum {
NTPSNMPD_EXIT_NO_CONFIG_INPUT = 66,
NTPSNMPD_EXIT_LIBOPTS_FAILURE = 70
} ntpsnmpd_exit_code_t;
-/*
+/** @} */
+/**
* Make sure there are no #define name conflicts with the option names
*/
#ifndef NO_OPTION_NAME_WARNINGS
# undef AGENTXSOCKET
#endif /* NO_OPTION_NAME_WARNINGS */
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
* Interface defines for specific options.
+ * @{
*/
#define VALUE_OPT_NOFORK 'n'
#define VALUE_OPT_SYSLOG 'p'
#define VALUE_OPT_AGENTXSOCKET 2
+/** option flag (value) for " (get "val-name") " option */
#define VALUE_OPT_HELP '?'
+/** 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 INDEX_OPT_VERSION
+/** option flag (value) for " (get "val-name") " option */
#define VALUE_OPT_SAVE_OPTS '>'
+/** option flag (value) for " (get "val-name") " option */
#define VALUE_OPT_LOAD_OPTS '<'
#define SET_OPT_SAVE_OPTS(a) STMTS( \
DESC(SAVE_OPTS).fOptState &= OPTST_PERSISTENT_MASK; \
ntpsnmpdOptions.pzCurOpt = NULL)
#define START_OPT RESTART_OPT(1)
#define USAGE(c) (*ntpsnmpdOptions.pUsageProc)(&ntpsnmpdOptions, c)
-/* extracted from opthead.tlib near line 498 */
+/* extracted from opthead.tlib near line 538 */
#ifdef __cplusplus
extern "C" {
-.TH ntpsnmpd 1ntpsnmpdman "21 Feb 2013" "4.2.7p357" "User Commands"
+.TH ntpsnmpd 1ntpsnmpdman "27 Feb 2013" "4.2.7p358" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.man)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:47:42 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:38:25 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agman-cmd.tpl
.\"
.BR Li ntpEntTimeDistance
please fill me in...
.PP
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
.PP
This manual page was \fIAutoGen\fP-erated from the \fBntpsnmpd\fP
option definitions.
-.Dd February 21 2013
+.Dd February 27 2013
.Dt NTPSNMPD 1ntpsnmpdmdoc User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:47:48 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:38:31 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
please fill me in...
.El
.Pp
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
.Pp
This manual page was \fIAutoGen\fP\-erated from the \fBntpsnmpd\fP
option definitions.
<p>The <code>ntpsnmpd</code> utility program is used to monitor NTP daemon <code>ntpd</code>
operations and determine performance. It uses the standard NTP mode 6 control
- <p>This document applies to version 4.2.7p357 of <code>ntpsnmpd</code>.
+ <p>This document applies to version 4.2.7p358 of <code>ntpsnmpd</code>.
<ul class="menu">
<li><a accesskey="1" href="#ntpsnmpd-Description">ntpsnmpd Description</a>: Description
-.TH ntpsnmpd @NTPSNMPD_MS@ "21 Feb 2013" "4.2.7p357" "User Commands"
+.TH ntpsnmpd @NTPSNMPD_MS@ "27 Feb 2013" "4.2.7p358" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.man)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:47:42 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:38:25 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agman-cmd.tpl
.\"
.BR Li ntpEntTimeDistance
please fill me in...
.PP
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
.PP
This manual page was \fIAutoGen\fP-erated from the \fBntpsnmpd\fP
option definitions.
-.Dd February 21 2013
+.Dd February 27 2013
.Dt NTPSNMPD @NTPSNMPD_MS@ User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:47:48 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:38:31 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
please fill me in...
.El
.Pp
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
.Pp
This manual page was \fIAutoGen\fP\-erated from the \fBntpsnmpd\fP
option definitions.
# - Numeric values increment
# - empty 'increments' to 1
# - NEW 'increments' to empty
-point=357
+point=358
### betapoint is normally modified by script.
# ntp-stable Beta number (betapoint)
#
# EDIT THIS FILE WITH CAUTION (invoke-ntp-wait.texi)
#
-# It has been AutoGen-ed February 22, 2013 at 03:24:10 AM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed February 27, 2013 at 11:32:23 AM by AutoGen 5.17.3.pre2
# From the definitions ntp-wait-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
-.TH ntp-wait 1ntp-waitman "22 Feb 2013" "ntp (4.2.7p357)" "User Commands"
+.TH ntp-wait 1ntp-waitman "27 Feb 2013" "ntp (4.2.7p358)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp-wait-opts.man)
.\"
-.\" It has been AutoGen-ed February 22, 2013 at 03:24:06 AM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:32:19 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntp-wait-opts.def
.\" and the template file agman-cmd.tpl
.\"
.SH "BUGS"
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
.PP
This manual page was \fIAutoGen\fP-erated from the \fBntp-wait\fP
option definitions.
-.Dd February 22 2013
+.Dd February 27 2013
.Dt NTP_WAIT 1ntp-waitmdoc User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp-wait-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 22, 2013 at 03:24:12 AM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:32:26 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntp-wait-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
.Sh "BUGS"
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
.Pp
This manual page was \fIAutoGen\fP\-erated from the \fBntp\-wait\fP
option definitions.
and only then start any applicaitons (like database servers) that require
accurate and stable time.
- <p>This document applies to version 4.2.7p357 of <code>ntp-wait</code>.
+ <p>This document applies to version 4.2.7p358 of <code>ntp-wait</code>.
<div class="shortcontents">
<h2>Short Contents</h2>
-.TH ntp-wait @NTP_WAIT_MS@ "22 Feb 2013" "ntp (4.2.7p357)" "User Commands"
+.TH ntp-wait @NTP_WAIT_MS@ "27 Feb 2013" "ntp (4.2.7p358)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp-wait-opts.man)
.\"
-.\" It has been AutoGen-ed February 22, 2013 at 03:24:06 AM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:32:19 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntp-wait-opts.def
.\" and the template file agman-cmd.tpl
.\"
.SH "BUGS"
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
.PP
This manual page was \fIAutoGen\fP-erated from the \fBntp-wait\fP
option definitions.
-.Dd February 22 2013
+.Dd February 27 2013
.Dt NTP_WAIT @NTP_WAIT_MS@ User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp-wait-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 22, 2013 at 03:24:12 AM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:32:26 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntp-wait-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
.Sh "BUGS"
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
.Pp
This manual page was \fIAutoGen\fP\-erated from the \fBntp\-wait\fP
option definitions.
#
# EDIT THIS FILE WITH CAUTION (invoke-sntp.texi)
#
-# It has been AutoGen-ed February 21, 2013 at 10:48:40 PM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed February 27, 2013 at 11:39:32 AM by AutoGen 5.17.3.pre2
# From the definitions sntp-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p357
+sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p358
Usage: sntp [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... \
[ hostname-or-IP ...]
Flg Arg Option-Name Description
- reading file ./.ntprc
- examining environment variables named SNTP_*
-please send bug reports to: <http://bugs.ntp.org, bugs@@ntp.org>
+Please send bug reports to: <http://bugs.ntp.org, bugs@@ntp.org>
@end example
@exampleindent 4
/*
* EDIT THIS FILE WITH CAUTION (sntp-opts.c)
*
- * It has been AutoGen-ed February 22, 2013 at 03:21:03 AM by AutoGen 5.17.2pre17
+ * It has been AutoGen-ed February 27, 2013 at 11:25:07 AM by AutoGen 5.17.3.pre2
* From the definitions sntp-opts.def
* and the template file options
*
# define NULL 0
#endif
-/*
- * sntp option static const strings
+/**
+ * static const strings for sntp options
*/
static char const sntp_opt_strs[2499] =
-/* 0 */ "sntp 4.2.7p357\n"
+/* 0 */ "sntp 4.2.7p358\n"
"Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n"
"This is free software. It is licensed for use, modification and\n"
"redistribution under the terms of the NTP License, copies of which\n"
/* 2244 */ "LOAD_OPTS\0"
/* 2254 */ "no-load-opts\0"
/* 2267 */ "SNTP\0"
-/* 2272 */ "sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p357\n"
+/* 2272 */ "sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p358\n"
"Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n"
"\t\t[ hostname-or-IP ...]\n\0"
/* 2433 */ "$HOME\0"
/* 2441 */ ".ntprc\0"
/* 2448 */ "http://bugs.ntp.org, bugs@ntp.org\0"
/* 2482 */ "\n\0"
-/* 2484 */ "sntp 4.2.7p357";
+/* 2484 */ "sntp 4.2.7p358";
-/*
+/**
* ipv4 option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the ipv4 option */
#define IPV4_DESC (sntp_opt_strs+954)
+/** Upper-cased name for the ipv4 option */
#define IPV4_NAME (sntp_opt_strs+985)
+/** Name string for the ipv4 option */
#define IPV4_name (sntp_opt_strs+990)
+/** Other options that appear in conjunction with the ipv4 option */
static int const aIpv4CantList[] = {
INDEX_OPT_IPV6, NO_EQUIVALENT };
+/** Compiled in flag settings for the ipv4 option */
#define IPV4_FLAGS (OPTST_DISABLED)
-/*
+/**
* ipv6 option description with
* "Must also have options" and "Incompatible options":
*/
+/** Descriptive text for the ipv6 option */
#define IPV6_DESC (sntp_opt_strs+995)
+/** Upper-cased name for the ipv6 option */
#define IPV6_NAME (sntp_opt_strs+1026)
+/** Name string for the ipv6 option */
#define IPV6_name (sntp_opt_strs+1031)
+/** Other options that appear in conjunction with the ipv6 option */
static int const aIpv6CantList[] = {
INDEX_OPT_IPV4, NO_EQUIVALENT };
+/** Compiled in flag settings for the ipv6 option */
#define IPV6_FLAGS (OPTST_DISABLED)
-/*
+/**
* authentication option description:
*/
+/** Descriptive text for the authentication option */
#define AUTHENTICATION_DESC (sntp_opt_strs+1036)
+/** Upper-cased name for the authentication option */
#define AUTHENTICATION_NAME (sntp_opt_strs+1086)
+/** Name string for the authentication option */
#define AUTHENTICATION_name (sntp_opt_strs+1101)
+/** Compiled in flag settings for the authentication option */
#define AUTHENTICATION_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
-/*
+/**
* broadcast option description:
*/
+/** Descriptive text for the broadcast option */
#define BROADCAST_DESC (sntp_opt_strs+1116)
+/** Upper-cased name for the broadcast option */
#define BROADCAST_NAME (sntp_opt_strs+1172)
+/** Name string for the broadcast option */
#define BROADCAST_name (sntp_opt_strs+1182)
+/** Compiled in flag settings for the broadcast option */
#define BROADCAST_FLAGS (OPTST_DISABLED | OPTST_STACKED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
-/*
+/**
* concurrent option description:
*/
+/** Descriptive text for the concurrent option */
#define CONCURRENT_DESC (sntp_opt_strs+1192)
+/** Upper-cased name for the concurrent option */
#define CONCURRENT_NAME (sntp_opt_strs+1242)
+/** Name string for the concurrent option */
#define CONCURRENT_name (sntp_opt_strs+1253)
+/** Compiled in flag settings for the concurrent option */
#define CONCURRENT_FLAGS (OPTST_DISABLED | OPTST_STACKED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
-/*
+/**
* debug-level option description:
*/
+/** Descriptive text for the debug-level option */
#define DEBUG_LEVEL_DESC (sntp_opt_strs+1264)
+/** Upper-cased name for the debug-level option */
#define DEBUG_LEVEL_NAME (sntp_opt_strs+1295)
+/** Name string for the debug-level option */
#define DEBUG_LEVEL_name (sntp_opt_strs+1307)
+/** Compiled in flag settings for the debug-level option */
#define DEBUG_LEVEL_FLAGS (OPTST_DISABLED)
-/*
+/**
* set-debug-level option description:
*/
+/** Descriptive text for the set-debug-level option */
#define SET_DEBUG_LEVEL_DESC (sntp_opt_strs+1319)
+/** Upper-cased name for the set-debug-level option */
#define SET_DEBUG_LEVEL_NAME (sntp_opt_strs+1349)
+/** Name string for the set-debug-level option */
#define SET_DEBUG_LEVEL_name (sntp_opt_strs+1365)
+/** Compiled in flag settings for the set-debug-level option */
#define SET_DEBUG_LEVEL_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
-/*
+/**
* gap option description:
*/
+/** Descriptive text for the gap option */
#define GAP_DESC (sntp_opt_strs+1381)
+/** Upper-cased name for the gap option */
#define GAP_NAME (sntp_opt_strs+1429)
+/** Name string for the gap option */
#define GAP_name (sntp_opt_strs+1433)
+/** The compiled in default value for the gap option argument */
#define GAP_DFT_ARG ((char const*)50)
+/** Compiled in flag settings for the gap option */
#define GAP_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
-/*
+/**
* kod option description:
*/
+/** Descriptive text for the kod option */
#define KOD_DESC (sntp_opt_strs+1437)
+/** Upper-cased name for the kod option */
#define KOD_NAME (sntp_opt_strs+1458)
+/** Name string for the kod option */
#define KOD_name (sntp_opt_strs+1462)
+/** The compiled in default value for the kod option argument */
#define KOD_DFT_ARG (sntp_opt_strs+1466)
+/** Compiled in flag settings for the kod option */
#define KOD_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_FILE))
-/*
+/**
* keyfile option description:
*/
+/** Descriptive text for the keyfile option */
#define KEYFILE_DESC (sntp_opt_strs+1482)
+/** Upper-cased name for the keyfile option */
#define KEYFILE_NAME (sntp_opt_strs+1530)
+/** Name string for the keyfile option */
#define KEYFILE_name (sntp_opt_strs+1538)
+/** Compiled in flag settings for the keyfile option */
#define KEYFILE_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_FILE))
-/*
+/**
* logfile option description:
*/
+/** Descriptive text for the logfile option */
#define LOGFILE_DESC (sntp_opt_strs+1546)
+/** Upper-cased name for the logfile option */
#define LOGFILE_NAME (sntp_opt_strs+1571)
+/** Name string for the logfile option */
#define LOGFILE_name (sntp_opt_strs+1579)
+/** Compiled in flag settings for the logfile option */
#define LOGFILE_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_FILE))
-/*
+/**
* steplimit option description:
*/
+/** Descriptive text for the steplimit option */
#define STEPLIMIT_DESC (sntp_opt_strs+1587)
+/** Upper-cased name for the steplimit option */
#define STEPLIMIT_NAME (sntp_opt_strs+1639)
+/** Name string for the steplimit option */
#define STEPLIMIT_name (sntp_opt_strs+1649)
+/** Compiled in flag settings for the steplimit option */
#define STEPLIMIT_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
-/*
+/**
* ntpversion option description:
*/
+/** Descriptive text for the ntpversion option */
#define NTPVERSION_DESC (sntp_opt_strs+1659)
+/** Upper-cased name for the ntpversion option */
#define NTPVERSION_NAME (sntp_opt_strs+1696)
+/** Name string for the ntpversion option */
#define NTPVERSION_name (sntp_opt_strs+1707)
+/** The compiled in default value for the ntpversion option argument */
#define NTPVERSION_DFT_ARG ((char const*)4)
+/** Compiled in flag settings for the ntpversion option */
#define NTPVERSION_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
-/*
+/**
* usereservedport option description:
*/
+/** Descriptive text for the usereservedport option */
#define USERESERVEDPORT_DESC (sntp_opt_strs+1718)
+/** Upper-cased name for the usereservedport option */
#define USERESERVEDPORT_NAME (sntp_opt_strs+1755)
+/** Name string for the usereservedport option */
#define USERESERVEDPORT_name (sntp_opt_strs+1771)
+/** Compiled in flag settings for the usereservedport option */
#define USERESERVEDPORT_FLAGS (OPTST_DISABLED)
-/*
+/**
* step option description:
*/
+/** Descriptive text for the step option */
#define STEP_DESC (sntp_opt_strs+1787)
+/** Upper-cased name for the step option */
#define STEP_NAME (sntp_opt_strs+1830)
+/** Name string for the step option */
#define STEP_name (sntp_opt_strs+1835)
+/** Compiled in flag settings for the step option */
#define STEP_FLAGS (OPTST_DISABLED)
-/*
+/**
* slew option description:
*/
+/** Descriptive text for the slew option */
#define SLEW_DESC (sntp_opt_strs+1840)
+/** Upper-cased name for the slew option */
#define SLEW_NAME (sntp_opt_strs+1878)
+/** Name string for the slew option */
#define SLEW_name (sntp_opt_strs+1883)
+/** Compiled in flag settings for the slew option */
#define SLEW_FLAGS (OPTST_DISABLED)
-/*
+/**
* timeout option description:
*/
+/** Descriptive text for the timeout option */
#define TIMEOUT_DESC (sntp_opt_strs+1888)
+/** Upper-cased name for the timeout option */
#define TIMEOUT_NAME (sntp_opt_strs+1932)
+/** Name string for the timeout option */
#define TIMEOUT_name (sntp_opt_strs+1940)
+/** The compiled in default value for the timeout option argument */
#define TIMEOUT_DFT_ARG ((char const*)5)
+/** Compiled in flag settings for the timeout option */
#define TIMEOUT_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
-/*
+/**
* wait option description:
*/
+/** Descriptive text for the wait option */
#define WAIT_DESC (sntp_opt_strs+1948)
+/** Upper-cased name for the wait option */
#define WAIT_NAME (sntp_opt_strs+1999)
+/** disablement name for the wait option */
#define NOT_WAIT_name (sntp_opt_strs+2004)
+/** disablement prefix for the wait option */
#define NOT_WAIT_PFX (sntp_opt_strs+2012)
+/** Name string for the wait option */
#define WAIT_name (NOT_WAIT_name + 3)
+/** Compiled in flag settings for the wait option */
#define WAIT_FLAGS (OPTST_INITENABLED)
/*
#define NO_LOAD_OPTS_name (sntp_opt_strs+2254)
#define LOAD_OPTS_pfx (sntp_opt_strs+2012)
#define LOAD_OPTS_name (NO_LOAD_OPTS_name + 3)
-/*
+/**
* Declare option callback procedures
*/
#if defined(TEST_SNTP_OPTS)
doOptDebug_Level, doOptKeyfile, doOptKod, doOptLogfile,
doOptNtpversion, doOptSteplimit, doUsageOpt;
-/*
+/**
* #define map the "normal" callout procs
*/
#define DEBUG_LEVEL_OPT_PROC doOptDebug_Level
};
-/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
- *
- * Define the sntp Option Environment
- */
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/** Reference to the upper cased version of sntp. */
#define zPROGNAME (sntp_opt_strs+2267)
+/** Reference to the title line for sntp usage. */
#define zUsageTitle (sntp_opt_strs+2272)
+/** sntp configuration file name. */
#define zRcName (sntp_opt_strs+2441)
+/** Directories to search for sntp config files. */
static char const * const apzHomeList[3] = {
sntp_opt_strs+2433,
sntp_opt_strs+2439,
NULL };
+/** The sntp program bug email address. */
#define zBugsAddr (sntp_opt_strs+2448)
+/** Clarification/explanation of what sntp does. */
#define zExplain (sntp_opt_strs+2482)
+/** Extra detail explaining what sntp does. */
#define zDetail (NULL)
+/** The full version string for sntp. */
#define zFullVersion (sntp_opt_strs+2484)
-/* extracted from optcode.tlib near line 364 */
+/* extracted from optcode.tlib near line 371 */
#if defined(ENABLE_NLS)
# define OPTPROC_BASE OPTPROC_TRANSLATE
/**
* The callout function that invokes the optionUsage function.
*
- * @param pOptions the AutoOpts option description structure
- * @param pOptDesc the descriptor for the "help" (usage) option.
+ * @param[in] pOptions the AutoOpts option description structure
+ * @param[in] pOptDesc the descriptor for the "help" (usage) option.
* @noreturn
*/
static void
/**
* Code to handle the debug-level option.
*
- * @param pOptions the sntp options data structure
- * @param pOptDesc the option descriptor for this option.
+ * @param[in] pOptions the sntp options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
*/
static void
doOptDebug_Level(tOptions* pOptions, tOptDesc* pOptDesc)
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/**
* Code to handle the kod option.
- *
- * @param pOptions the sntp options data structure
- * @param pOptDesc the option descriptor for this option.
+ * Specifies the filename to be used for the persistent history of KoD
+ * responses received from servers.
+ * @param[in] pOptions the sntp options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
*/
static void
doOptKod(tOptions* pOptions, tOptDesc* pOptDesc)
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/**
* Code to handle the keyfile option.
- *
- * @param pOptions the sntp options data structure
- * @param pOptDesc the option descriptor for this option.
+ * This option specifies the keyfile.
+ * @code{sntp} will search for the key specified with @option{-a}
+ * @file{keyno} in this file. See @command{ntp.keys(5)} for more
+ * information.
+ * @param[in] pOptions the sntp options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
*/
static void
doOptKeyfile(tOptions* pOptions, tOptDesc* pOptDesc)
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/**
* Code to handle the logfile option.
- *
- * @param pOptions the sntp options data structure
- * @param pOptDesc the option descriptor for this option.
+ * This option causes the client to write log messages to the specified
+ * @file{logfile}.
+ * @param[in] pOptions the sntp options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
*/
static void
doOptLogfile(tOptions* pOptions, tOptDesc* pOptDesc)
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/**
* Code to handle the steplimit option.
- *
- * @param pOptions the sntp options data structure
- * @param pOptDesc the option descriptor for this option.
+ * If the time adjustment is less than @file{steplimit} milliseconds,
+ * slew the amount using @command{adjtime(2)}. Otherwise, step the
+ * correction using @command{settimeofday(2)}.
+ * @param[in] pOptions the sntp options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
*/
static void
doOptSteplimit(tOptions* pOptions, tOptDesc* pOptDesc)
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/**
* Code to handle the ntpversion option.
- *
- * @param pOptions the sntp options data structure
- * @param pOptDesc the option descriptor for this option.
+ * When sending requests to a remote server, tell them we are running
+ * NTP protocol version @file{ntpversion} .
+ * @param[in] pOptions the sntp options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
*/
static void
doOptNtpversion(tOptions* pOptions, tOptDesc* pOptDesc)
* Generated main procedure. This will emit text that a Bourne shell can
* process to handle its command line arguments.
*
- * @param argc argument count
- * @param argv argument vector
+ * @param[in] argc argument count
+ * @param[in] argv argument vector
* @returns program exit code
*/
int
#ifndef WITH_PACKAGER
# define sntp_packager_info NULL
#else
+/** Packager information for sntp. */
static char const sntp_packager_info[] =
"Packaged by " WITH_PACKAGER
};
#if ENABLE_NLS
-/*
+/**
* This code is designed to translate translatable option text for the
* sntp program. These translations happen upon entry
* to optionProcess().
#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:
translate option names.
*/
/* referenced via sntpOptions.pzCopyright */
- puts(_("sntp 4.2.7p357\n\
+ puts(_("sntp 4.2.7p358\n\
Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n\
This is free software. It is licensed for use, modification and\n\
redistribution under the terms of the NTP License, copies of which\n\
puts(_("load options from a config file"));
/* referenced via sntpOptions.pzUsageTitle */
- puts(_("sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p357\n\
+ puts(_("sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p358\n\
Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
\t\t[ hostname-or-IP ...]\n"));
puts(_("\n"));
/* referenced via sntpOptions.pzFullVersion */
- puts(_("sntp 4.2.7p357"));
+ puts(_("sntp 4.2.7p358"));
/* referenced via sntpOptions.pzFullUsage */
puts(_("<<<NOT-FOUND>>>"));
puts(_("could not locate the 'help' option"));
#line 351 "../autoopts.c"
puts(_("optionProcess() was called with invalid data"));
-#line 770 "../usage.c"
+#line 783 "../usage.c"
puts(_("invalid argument type specified"));
#line 589 "../find.c"
puts(_("defaulted to option with optional arg"));
puts(_(" or an integer from %d through %d\n"));
#line 164 "../enum.c"
puts(_(" or an integer from %d through %d\n"));
-#line 769 "../usage.c"
+#line 782 "../usage.c"
puts(_("%s error: invalid option descriptor for %s\n"));
-#line 1097 "../usage.c"
+#line 1110 "../usage.c"
puts(_("%s error: invalid option descriptor for %s\n"));
#line 379 "../find.c"
puts(_("%s: invalid option name: %s\n"));
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'"));
+ "\t'%s' and '%s'."));
#line 94 "../check.c"
puts(_("%s error: The %s option is required\n"));
#line 623 "../find.c"
#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"));
+ 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(_("standard output"));
#line 451 "../usage.c"
puts(_("standard output"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
puts(_("standard output"));
#line 175 "../version.c"
puts(_("standard output"));
puts(_("standard error"));
#line 451 "../usage.c"
puts(_("standard error"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
puts(_("standard error"));
#line 175 "../version.c"
puts(_("standard error"));
puts(_("write"));
#line 450 "../usage.c"
puts(_("write"));
-#line 646 "../usage.c"
+#line 659 "../usage.c"
puts(_("write"));
#line 174 "../version.c"
puts(_("write"));
/* END-LIBOPTS-MESSAGES */
/* USAGE-TEXT: */
-#line 895 "../usage.c"
+#line 908 "../usage.c"
puts(_("\t\t\t\t- an alternate for '%s'\n"));
-#line 1164 "../usage.c"
+#line 1177 "../usage.c"
puts(_("Version, usage and configuration options:"));
-#line 946 "../usage.c"
+#line 959 "../usage.c"
puts(_("\t\t\t\t- default option for unnamed options\n"));
-#line 859 "../usage.c"
+#line 872 "../usage.c"
puts(_("\t\t\t\t- disabled as '--%s'\n"));
-#line 1133 "../usage.c"
+#line 1146 "../usage.c"
puts(_(" --- %-14s %s\n"));
-#line 1131 "../usage.c"
+#line 1144 "../usage.c"
puts(_("This option has been disabled"));
-#line 886 "../usage.c"
+#line 899 "../usage.c"
puts(_("\t\t\t\t- enabled by default\n"));
#line 40 "../alias.c"
puts(_("%s error: only "));
-#line 1208 "../usage.c"
+#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"));
"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 919 "../usage.c"
+#line 932 "../usage.c"
puts(_("\t\t\t\t- is a set membership option\n"));
-#line 940 "../usage.c"
+#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 926 "../usage.c"
+#line 939 "../usage.c"
puts(_("\t\t\t\t- may appear multiple times\n"));
-#line 913 "../usage.c"
+#line 926 "../usage.c"
puts(_("\t\t\t\t- may not be preset\n"));
-#line 1323 "../usage.c"
+#line 1336 "../usage.c"
puts(_(" Arg Option-Name Description\n"));
-#line 1259 "../usage.c"
+#line 1272 "../usage.c"
puts(_(" Flg Arg Option-Name Description\n"));
-#line 1317 "../usage.c"
+#line 1330 "../usage.c"
puts(_(" Flg Arg Option-Name Description\n"));
-#line 1318 "../usage.c"
+#line 1331 "../usage.c"
puts(_(" %3s %s"));
-#line 1324 "../usage.c"
+#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 993 "../usage.c"
+#line 1006 "../usage.c"
puts(_(" - reading file %s"));
#line 445 "../usage.c"
puts(_("\n"
#line 129 "../version.c"
puts(_("\n"
"please send bug reports to: <%s>\n"));
-#line 925 "../usage.c"
+#line 938 "../usage.c"
puts(_("\t\t\t\t- may NOT appear - preset only\n"));
-#line 965 "../usage.c"
+#line 978 "../usage.c"
puts(_("\n"
"The following option preset mechanisms are supported:\n"));
-#line 1206 "../usage.c"
+#line 1219 "../usage.c"
puts(_("\n"
"The following option preset mechanisms are supported:\n"));
-#line 704 "../usage.c"
+#line 717 "../usage.c"
puts(_("prohibits these options:\n"));
-#line 699 "../usage.c"
+#line 712 "../usage.c"
puts(_("prohibits the option '%s'\n"));
#line 81 "../numeric.c"
puts(_("%s%ld to %ld"));
puts(_("%sless than or equal to %ld"));
#line 426 "../usage.c"
puts(_("Operands and options may be intermixed. They will be reordered.\n"));
-#line 674 "../usage.c"
+#line 687 "../usage.c"
puts(_("requires the option '%s'\n"));
-#line 677 "../usage.c"
+#line 690 "../usage.c"
puts(_("requires these options:\n"));
-#line 1335 "../usage.c"
+#line 1348 "../usage.c"
puts(_(" Arg Option-Name Req? Description\n"));
-#line 1329 "../usage.c"
+#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 932 "../usage.c"
+#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 1168 "../usage.c"
+#line 1181 "../usage.c"
puts(_("The next option supports vendor supported extra options:"));
-#line 795 "../usage.c"
+#line 808 "../usage.c"
puts(_("These additional options are:"));
/* END-USAGE-TEXT */
}
/*
* EDIT THIS FILE WITH CAUTION (sntp-opts.h)
*
- * It has been AutoGen-ed February 22, 2013 at 03:21:02 AM by AutoGen 5.17.2pre17
+ * It has been AutoGen-ed February 27, 2013 at 11:25:02 AM by AutoGen 5.17.3.pre2
* From the definitions sntp-opts.def
* and the template file options
*
* representations about the suitability this software for any purpose. It
* is provided "as is" without express or implied warranty.
*/
-/*
+/**
* This file contains the programmatic interface to the Automated
* Options generated for the sntp program.
* These macros are documented in the AutoGen info file in the
#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
Choke Me.
#endif
-/*
- * Enumeration of each option:
+/**
+ * Enumeration of each option type for sntp
*/
typedef enum {
INDEX_OPT_IPV4 = 0,
INDEX_OPT_SAVE_OPTS = 21,
INDEX_OPT_LOAD_OPTS = 22
} teOptIndex;
-
+/** count of all options for sntp */
#define OPTION_CT 23
-#define SNTP_VERSION "4.2.7p357"
-#define SNTP_FULL_VERSION "sntp 4.2.7p357"
+/** sntp version */
+#define SNTP_VERSION "4.2.7p358"
+/** Full sntp version text */
+#define SNTP_FULL_VERSION "sntp 4.2.7p358"
-/*
+/**
* Interface defines for all options. Replace "n" with the UPPER_CASED
* option name (as in the teOptIndex enumeration above).
* e.g. HAVE_OPT(IPV4)
*/
#define DESC(n) (sntpOptions.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 sntp exit codes
*/
typedef enum {
SNTP_EXIT_NO_CONFIG_INPUT = 66,
SNTP_EXIT_LIBOPTS_FAILURE = 70
} sntp_exit_code_t;
-/*
+/** @} */
+/**
* Make sure there are no #define name conflicts with the option names
*/
#ifndef NO_OPTION_NAME_WARNINGS
# undef WAIT
#endif /* NO_OPTION_NAME_WARNINGS */
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
* Interface defines for specific options.
+ * @{
*/
#define VALUE_OPT_IPV4 '4'
#define VALUE_OPT_IPV6 '6'
DESC(WAIT).fOptState &= OPTST_PERSISTENT_MASK; \
DESC(WAIT).fOptState |= OPTST_SET | OPTST_DISABLED; \
DESC(WAIT).optArg.argString = NULL )
+/** option flag (value) for " (get "val-name") " option */
#define VALUE_OPT_HELP '?'
+/** 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 INDEX_OPT_VERSION
+/** option flag (value) for " (get "val-name") " option */
#define VALUE_OPT_SAVE_OPTS '>'
+/** option flag (value) for " (get "val-name") " option */
#define VALUE_OPT_LOAD_OPTS '<'
#define SET_OPT_SAVE_OPTS(a) STMTS( \
DESC(SAVE_OPTS).fOptState &= OPTST_PERSISTENT_MASK; \
sntpOptions.pzCurOpt = NULL)
#define START_OPT RESTART_OPT(1)
#define USAGE(c) (*sntpOptions.pUsageProc)(&sntpOptions, c)
-/* extracted from opthead.tlib near line 498 */
+/* extracted from opthead.tlib near line 538 */
#ifdef __cplusplus
extern "C" {
-.TH sntp 1sntpman "21 Feb 2013" "4.2.7p357" "User Commands"
+.TH sntp 1sntpman "27 Feb 2013" "4.2.7p358" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (sntp-opts.man)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:48:36 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:39:28 AM by AutoGen 5.17.3.pre2
.\" From the definitions sntp-opts.def
.\" and the template file agman-cmd.tpl
.\"
.SH "BUGS"
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.SH NOTES
-This document corresponds to version 4.2.7p357 of
+This document corresponds to version 4.2.7p358 of
.B .
.PP
This manual page was \fIAutoGen\fP-erated from the \fBsntp\fP
-.Dd February 21 2013
+.Dd February 27 2013
.Dt SNTP 1sntpmdoc User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (sntp-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:48:42 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:39:34 AM by AutoGen 5.17.3.pre2
.\" From the definitions sntp-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
.Sh "BUGS"
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.Sh NOTES
-This document corresponds to version 4.2.7p357 of
+This document corresponds to version 4.2.7p358 of
.Nm .
.Pp
This manual page was \fIAutoGen\fP\-erated from the \fBsntp\fP
clock. Run as root, it can correct the system clock to this offset as
well. It can be run as an interactive command or from a cron job.
- <p>This document applies to version 4.2.7p357 of <code>sntp</code>.
+ <p>This document applies to version 4.2.7p358 of <code>sntp</code>.
<p>The program implements the SNTP protocol as defined by RFC 5905, the NTPv4
IETF specification.
used to select the program, defaulting to <span class="file">more</span>. Both will exit
with a status code of 0.
-<pre class="example">sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p357
+<pre class="example">sntp - standard Simple Network Time Protocol client program - Ver. 4.2.7p358
Usage: sntp [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \
[ hostname-or-IP ...]
Flg Arg Option-Name Description
- reading file ./.ntprc
- examining environment variables named SNTP_*
-please send bug reports to: <http://bugs.ntp.org, bugs@ntp.org>
+Please send bug reports to: <http://bugs.ntp.org, bugs@ntp.org>
</pre>
<div class="node">
<p><hr>
-.TH sntp @SNTP_MS@ "21 Feb 2013" "4.2.7p357" "User Commands"
+.TH sntp @SNTP_MS@ "27 Feb 2013" "4.2.7p358" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (sntp-opts.man)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:48:36 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:39:28 AM by AutoGen 5.17.3.pre2
.\" From the definitions sntp-opts.def
.\" and the template file agman-cmd.tpl
.\"
.SH "BUGS"
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.SH NOTES
-This document corresponds to version 4.2.7p357 of
+This document corresponds to version 4.2.7p358 of
.B .
.PP
This manual page was \fIAutoGen\fP-erated from the \fBsntp\fP
-.Dd February 21 2013
+.Dd February 27 2013
.Dt SNTP @SNTP_MS@ User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (sntp-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:48:42 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:39:34 AM by AutoGen 5.17.3.pre2
.\" From the definitions sntp-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
.Sh "BUGS"
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.Sh NOTES
-This document corresponds to version 4.2.7p357 of
+This document corresponds to version 4.2.7p358 of
.Nm .
.Pp
This manual page was \fIAutoGen\fP\-erated from the \fBsntp\fP
#
# EDIT THIS FILE WITH CAUTION (invoke-ntp-keygen.texi)
#
-# It has been AutoGen-ed February 21, 2013 at 10:48:14 PM by AutoGen 5.17.2pre17
+# It has been AutoGen-ed February 27, 2013 at 11:38:55 AM by AutoGen 5.17.3.pre2
# From the definitions ntp-keygen-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p357
+ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p358
Usage: ntp-keygen [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
Flg Arg Option-Name Description
-b Num imbits identity modulus bits
/*
* EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.c)
*
- * It has been AutoGen-ed February 21, 2013 at 10:47:55 PM by AutoGen 5.17.2pre17
+ * It has been AutoGen-ed February 27, 2013 at 11:38:35 AM by AutoGen 5.17.3.pre2
* From the definitions ntp-keygen-opts.def
* and the template file options
*
# define NULL 0
#endif
-/*
- * ntp-keygen option static const strings
+/**
+ * static const strings for ntp-keygen options
*/
static char const ntp_keygen_opt_strs[2357] =
-/* 0 */ "ntp-keygen (ntp) 4.2.7p357\n"
+/* 0 */ "ntp-keygen (ntp) 4.2.7p358\n"
"Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n"
"This is free software. It is licensed for use, modification and\n"
"redistribution under the terms of the NTP License, copies of which\n"
/* 2136 */ "no-load-opts\0"
/* 2149 */ "no\0"
/* 2152 */ "NTP_KEYGEN\0"
-/* 2163 */ "ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p357\n"
+/* 2163 */ "ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p358\n"
"Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n\0"
/* 2279 */ "$HOME\0"
/* 2285 */ ".\0"
/* 2287 */ ".ntprc\0"
/* 2294 */ "http://bugs.ntp.org, bugs@ntp.org\0"
/* 2328 */ "\n\0"
-/* 2330 */ "ntp-keygen (ntp) 4.2.7p357";
+/* 2330 */ "ntp-keygen (ntp) 4.2.7p358";
-/*
+/**
* imbits option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the imbits option */
#define IMBITS_DESC (ntp_keygen_opt_strs+966)
+/** Upper-cased name for the imbits option */
#define IMBITS_NAME (ntp_keygen_opt_strs+988)
+/** Name string for the imbits option */
#define IMBITS_name (ntp_keygen_opt_strs+995)
+/** Compiled in flag settings for the imbits option */
#define IMBITS_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
#define IMBITS_name NULL
#endif /* AUTOKEY */
-/*
+/**
* certificate option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the certificate option */
#define CERTIFICATE_DESC (ntp_keygen_opt_strs+1002)
+/** Upper-cased name for the certificate option */
#define CERTIFICATE_NAME (ntp_keygen_opt_strs+1021)
+/** Name string for the certificate option */
#define CERTIFICATE_name (ntp_keygen_opt_strs+1033)
+/** Compiled in flag settings for the certificate option */
#define CERTIFICATE_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
#define CERTIFICATE_name NULL
#endif /* AUTOKEY */
-/*
+/**
* cipher option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the cipher option */
#define CIPHER_DESC (ntp_keygen_opt_strs+1045)
+/** Upper-cased name for the cipher option */
#define CIPHER_NAME (ntp_keygen_opt_strs+1063)
+/** Name string for the cipher option */
#define CIPHER_name (ntp_keygen_opt_strs+1070)
+/** Compiled in flag settings for the cipher option */
#define CIPHER_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
#define CIPHER_name NULL
#endif /* AUTOKEY */
-/*
+/**
* debug-level option description:
*/
+/** Descriptive text for the debug-level option */
#define DEBUG_LEVEL_DESC (ntp_keygen_opt_strs+1077)
+/** Upper-cased name for the debug-level option */
#define DEBUG_LEVEL_NAME (ntp_keygen_opt_strs+1108)
+/** Name string for the debug-level option */
#define DEBUG_LEVEL_name (ntp_keygen_opt_strs+1120)
+/** Compiled in flag settings for the debug-level option */
#define DEBUG_LEVEL_FLAGS (OPTST_DISABLED)
-/*
+/**
* set-debug-level option description:
*/
+/** Descriptive text for the set-debug-level option */
#define SET_DEBUG_LEVEL_DESC (ntp_keygen_opt_strs+1132)
+/** Upper-cased name for the set-debug-level option */
#define SET_DEBUG_LEVEL_NAME (ntp_keygen_opt_strs+1162)
+/** Name string for the set-debug-level option */
#define SET_DEBUG_LEVEL_name (ntp_keygen_opt_strs+1178)
+/** Compiled in flag settings for the set-debug-level option */
#define SET_DEBUG_LEVEL_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
-/*
+/**
* id-key option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the id-key option */
#define ID_KEY_DESC (ntp_keygen_opt_strs+1194)
+/** Upper-cased name for the id-key option */
#define ID_KEY_NAME (ntp_keygen_opt_strs+1224)
+/** Name string for the id-key option */
#define ID_KEY_name (ntp_keygen_opt_strs+1231)
+/** Compiled in flag settings for the id-key option */
#define ID_KEY_FLAGS (OPTST_DISABLED)
#else /* disable id-key */
#define ID_KEY_name NULL
#endif /* AUTOKEY */
-/*
+/**
* gq-params option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the gq-params option */
#define GQ_PARAMS_DESC (ntp_keygen_opt_strs+1238)
+/** Upper-cased name for the gq-params option */
#define GQ_PARAMS_NAME (ntp_keygen_opt_strs+1270)
+/** Name string for the gq-params option */
#define GQ_PARAMS_name (ntp_keygen_opt_strs+1280)
+/** Compiled in flag settings for the gq-params option */
#define GQ_PARAMS_FLAGS (OPTST_DISABLED)
#else /* disable gq-params */
#define GQ_PARAMS_name NULL
#endif /* AUTOKEY */
-/*
+/**
* host-key option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the host-key option */
#define HOST_KEY_DESC (ntp_keygen_opt_strs+1290)
+/** Upper-cased name for the host-key option */
#define HOST_KEY_NAME (ntp_keygen_opt_strs+1312)
+/** Name string for the host-key option */
#define HOST_KEY_name (ntp_keygen_opt_strs+1321)
+/** Compiled in flag settings for the host-key option */
#define HOST_KEY_FLAGS (OPTST_DISABLED)
#else /* disable host-key */
#define HOST_KEY_name NULL
#endif /* AUTOKEY */
-/*
+/**
* iffkey option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the iffkey option */
#define IFFKEY_DESC (ntp_keygen_opt_strs+1330)
+/** Upper-cased name for the iffkey option */
#define IFFKEY_NAME (ntp_keygen_opt_strs+1354)
+/** Name string for the iffkey option */
#define IFFKEY_name (ntp_keygen_opt_strs+1361)
+/** Compiled in flag settings for the iffkey option */
#define IFFKEY_FLAGS (OPTST_DISABLED)
#else /* disable iffkey */
#define IFFKEY_name NULL
#endif /* AUTOKEY */
-/*
+/**
* ident option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the ident option */
#define IDENT_DESC (ntp_keygen_opt_strs+1368)
+/** Upper-cased name for the ident option */
#define IDENT_NAME (ntp_keygen_opt_strs+1391)
+/** Name string for the ident option */
#define IDENT_name (ntp_keygen_opt_strs+1397)
+/** Compiled in flag settings for the ident option */
#define IDENT_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
#define IDENT_name NULL
#endif /* AUTOKEY */
-/*
+/**
* lifetime option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the lifetime option */
#define LIFETIME_DESC (ntp_keygen_opt_strs+1403)
+/** Upper-cased name for the lifetime option */
#define LIFETIME_NAME (ntp_keygen_opt_strs+1428)
+/** Name string for the lifetime option */
#define LIFETIME_name (ntp_keygen_opt_strs+1437)
+/** Compiled in flag settings for the lifetime option */
#define LIFETIME_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
#define LIFETIME_name NULL
#endif /* AUTOKEY */
-/*
+/**
* md5key option description:
*/
+/** Descriptive text for the md5key option */
#define MD5KEY_DESC (ntp_keygen_opt_strs+1446)
+/** Upper-cased name for the md5key option */
#define MD5KEY_NAME (ntp_keygen_opt_strs+1464)
+/** Name string for the md5key option */
#define MD5KEY_name (ntp_keygen_opt_strs+1471)
+/** Compiled in flag settings for the md5key option */
#define MD5KEY_FLAGS (OPTST_DISABLED)
-/*
+/**
* modulus option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the modulus option */
#define MODULUS_DESC (ntp_keygen_opt_strs+1478)
+/** Upper-cased name for the modulus option */
#define MODULUS_NAME (ntp_keygen_opt_strs+1486)
+/** Name string for the modulus option */
#define MODULUS_name (ntp_keygen_opt_strs+1478)
+/** Compiled in flag settings for the modulus option */
#define MODULUS_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
#define MODULUS_name NULL
#endif /* AUTOKEY */
-/*
+/**
* pvt-cert option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the pvt-cert option */
#define PVT_CERT_DESC (ntp_keygen_opt_strs+1494)
+/** Upper-cased name for the pvt-cert option */
#define PVT_CERT_NAME (ntp_keygen_opt_strs+1526)
+/** Name string for the pvt-cert option */
#define PVT_CERT_name (ntp_keygen_opt_strs+1535)
+/** Compiled in flag settings for the pvt-cert option */
#define PVT_CERT_FLAGS (OPTST_DISABLED)
#else /* disable pvt-cert */
#define PVT_CERT_name NULL
#endif /* AUTOKEY */
-/*
+/**
* pvt-passwd option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the pvt-passwd option */
#define PVT_PASSWD_DESC (ntp_keygen_opt_strs+1544)
+/** Upper-cased name for the pvt-passwd option */
#define PVT_PASSWD_NAME (ntp_keygen_opt_strs+1568)
+/** Name string for the pvt-passwd option */
#define PVT_PASSWD_name (ntp_keygen_opt_strs+1579)
+/** Compiled in flag settings for the pvt-passwd option */
#define PVT_PASSWD_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
#define PVT_PASSWD_name NULL
#endif /* AUTOKEY */
-/*
+/**
* get-pvt-passwd option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the get-pvt-passwd option */
#define GET_PVT_PASSWD_DESC (ntp_keygen_opt_strs+1590)
+/** Upper-cased name for the get-pvt-passwd option */
#define GET_PVT_PASSWD_NAME (ntp_keygen_opt_strs+1613)
+/** Name string for the get-pvt-passwd option */
#define GET_PVT_PASSWD_name (ntp_keygen_opt_strs+1628)
+/** Compiled in flag settings for the get-pvt-passwd option */
#define GET_PVT_PASSWD_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
#define GET_PVT_PASSWD_name NULL
#endif /* AUTOKEY */
-/*
+/**
* sign-key option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the sign-key option */
#define SIGN_KEY_DESC (ntp_keygen_opt_strs+1643)
+/** Upper-cased name for the sign-key option */
#define SIGN_KEY_NAME (ntp_keygen_opt_strs+1674)
+/** Name string for the sign-key option */
#define SIGN_KEY_name (ntp_keygen_opt_strs+1683)
+/** Compiled in flag settings for the sign-key option */
#define SIGN_KEY_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
#define SIGN_KEY_name NULL
#endif /* AUTOKEY */
-/*
+/**
* subject-name option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the subject-name option */
#define SUBJECT_NAME_DESC (ntp_keygen_opt_strs+1692)
+/** Upper-cased name for the subject-name option */
#define SUBJECT_NAME_NAME (ntp_keygen_opt_strs+1727)
+/** Name string for the subject-name option */
#define SUBJECT_NAME_name (ntp_keygen_opt_strs+1740)
+/** Compiled in flag settings for the subject-name option */
#define SUBJECT_NAME_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
#define SUBJECT_NAME_name NULL
#endif /* AUTOKEY */
-/*
+/**
* trusted-cert option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the trusted-cert option */
#define TRUSTED_CERT_DESC (ntp_keygen_opt_strs+1753)
+/** Upper-cased name for the trusted-cert option */
#define TRUSTED_CERT_NAME (ntp_keygen_opt_strs+1785)
+/** Name string for the trusted-cert option */
#define TRUSTED_CERT_name (ntp_keygen_opt_strs+1798)
+/** Compiled in flag settings for the trusted-cert option */
#define TRUSTED_CERT_FLAGS (OPTST_DISABLED)
#else /* disable trusted-cert */
#define TRUSTED_CERT_name NULL
#endif /* AUTOKEY */
-/*
+/**
* mv-params option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the mv-params option */
#define MV_PARAMS_DESC (ntp_keygen_opt_strs+1811)
+/** Upper-cased name for the mv-params option */
#define MV_PARAMS_NAME (ntp_keygen_opt_strs+1840)
+/** Name string for the mv-params option */
#define MV_PARAMS_name (ntp_keygen_opt_strs+1850)
+/** Compiled in flag settings for the mv-params option */
#define MV_PARAMS_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
#define MV_PARAMS_name NULL
#endif /* AUTOKEY */
-/*
+/**
* mv-keys option description:
*/
#ifdef AUTOKEY
+/** Descriptive text for the mv-keys option */
#define MV_KEYS_DESC (ntp_keygen_opt_strs+1860)
+/** Upper-cased name for the mv-keys option */
#define MV_KEYS_NAME (ntp_keygen_opt_strs+1881)
+/** Name string for the mv-keys option */
#define MV_KEYS_name (ntp_keygen_opt_strs+1889)
+/** Compiled in flag settings for the mv-keys option */
#define MV_KEYS_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_NUMERIC))
#define NO_LOAD_OPTS_name (ntp_keygen_opt_strs+2136)
#define LOAD_OPTS_pfx (ntp_keygen_opt_strs+2149)
#define LOAD_OPTS_name (NO_LOAD_OPTS_name + 3)
-/*
+/**
* Declare option callback procedures
*/
#ifdef AUTOKEY
static tOptProc
doOptDebug_Level, doUsageOpt;
-/*
+/**
* #define map the "normal" callout procs
*/
#define DEBUG_LEVEL_OPT_PROC doOptDebug_Level
};
-/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *
- *
- * Define the ntp-keygen Option Environment
- */
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/** Reference to the upper cased version of ntp-keygen. */
#define zPROGNAME (ntp_keygen_opt_strs+2152)
+/** Reference to the title line for ntp-keygen usage. */
#define zUsageTitle (ntp_keygen_opt_strs+2163)
+/** ntp-keygen configuration file name. */
#define zRcName (ntp_keygen_opt_strs+2287)
+/** Directories to search for ntp-keygen config files. */
static char const * const apzHomeList[3] = {
ntp_keygen_opt_strs+2279,
ntp_keygen_opt_strs+2285,
NULL };
+/** The ntp-keygen program bug email address. */
#define zBugsAddr (ntp_keygen_opt_strs+2294)
+/** Clarification/explanation of what ntp-keygen does. */
#define zExplain (ntp_keygen_opt_strs+2328)
+/** Extra detail explaining what ntp-keygen does. */
#define zDetail (NULL)
+/** The full version string for ntp-keygen. */
#define zFullVersion (ntp_keygen_opt_strs+2330)
-/* extracted from optcode.tlib near line 364 */
+/* extracted from optcode.tlib near line 371 */
#if defined(ENABLE_NLS)
# define OPTPROC_BASE OPTPROC_TRANSLATE
/**
* The callout function that invokes the optionUsage function.
*
- * @param pOptions the AutoOpts option description structure
- * @param pOptDesc the descriptor for the "help" (usage) option.
+ * @param[in] pOptions the AutoOpts option description structure
+ * @param[in] pOptDesc the descriptor for the "help" (usage) option.
* @noreturn
*/
static void
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/**
* Code to handle the imbits option, when AUTOKEY is #define-d.
- *
- * @param pOptions the ntp-keygen options data structure
- * @param pOptDesc the option descriptor for this option.
+ * The number of bits in the identity modulus. The default is 256.
+ * @param[in] pOptions the ntp-keygen options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
*/
#ifdef AUTOKEY
static void
/**
* Code to handle the debug-level option.
*
- * @param pOptions the ntp-keygen options data structure
- * @param pOptDesc the option descriptor for this option.
+ * @param[in] pOptions the ntp-keygen options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
*/
static void
doOptDebug_Level(tOptions* pOptions, tOptDesc* pOptDesc)
/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
/**
* Code to handle the modulus option, when AUTOKEY is #define-d.
- *
- * @param pOptions the ntp-keygen options data structure
- * @param pOptDesc the option descriptor for this option.
+ * The number of bits in the prime modulus. The default is 512.
+ * @param[in] pOptions the ntp-keygen options data structure
+ * @param[in,out] pOptDesc the option descriptor for this option.
*/
#ifdef AUTOKEY
static void
* Generated main procedure. This will emit text that a Bourne shell can
* process to handle its command line arguments.
*
- * @param argc argument count
- * @param argv argument vector
+ * @param[in] argc argument count
+ * @param[in] argv argument vector
* @returns program exit code
*/
int
#ifndef WITH_PACKAGER
# define ntp_keygen_packager_info NULL
#else
+/** Packager information for ntp-keygen. */
static char const ntp_keygen_packager_info[] =
"Packaged by " WITH_PACKAGER
};
#if ENABLE_NLS
-/*
+/**
* This code is designed to translate translatable option text for the
* ntp-keygen program. These translations happen upon entry
* to optionProcess().
#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:
translate option names.
*/
/* referenced via ntp_keygenOptions.pzCopyright */
- puts(_("ntp-keygen (ntp) 4.2.7p357\n\
+ puts(_("ntp-keygen (ntp) 4.2.7p358\n\
Copyright (C) 1970-2013 The University of Delaware, all rights reserved.\n\
This is free software. It is licensed for use, modification and\n\
redistribution under the terms of the NTP License, copies of which\n\
puts(_("load options from a config file"));
/* referenced via ntp_keygenOptions.pzUsageTitle */
- puts(_("ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p357\n\
+ puts(_("ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p358\n\
Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
/* referenced via ntp_keygenOptions.pzExplain */
puts(_("\n"));
/* referenced via ntp_keygenOptions.pzFullVersion */
- puts(_("ntp-keygen (ntp) 4.2.7p357"));
+ puts(_("ntp-keygen (ntp) 4.2.7p358"));
/* referenced via ntp_keygenOptions.pzFullUsage */
puts(_("<<<NOT-FOUND>>>"));
puts(_("could not locate the 'help' option"));
#line 351 "../autoopts.c"
puts(_("optionProcess() was called with invalid data"));
-#line 770 "../usage.c"
+#line 783 "../usage.c"
puts(_("invalid argument type specified"));
#line 589 "../find.c"
puts(_("defaulted to option with optional arg"));
puts(_(" or an integer from %d through %d\n"));
#line 164 "../enum.c"
puts(_(" or an integer from %d through %d\n"));
-#line 769 "../usage.c"
+#line 782 "../usage.c"
puts(_("%s error: invalid option descriptor for %s\n"));
-#line 1097 "../usage.c"
+#line 1110 "../usage.c"
puts(_("%s error: invalid option descriptor for %s\n"));
#line 379 "../find.c"
puts(_("%s: invalid option name: %s\n"));
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'"));
+ "\t'%s' and '%s'."));
#line 94 "../check.c"
puts(_("%s error: The %s option is required\n"));
#line 623 "../find.c"
#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"));
+ 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(_("standard output"));
#line 451 "../usage.c"
puts(_("standard output"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
puts(_("standard output"));
#line 175 "../version.c"
puts(_("standard output"));
puts(_("standard error"));
#line 451 "../usage.c"
puts(_("standard error"));
-#line 647 "../usage.c"
+#line 660 "../usage.c"
puts(_("standard error"));
#line 175 "../version.c"
puts(_("standard error"));
puts(_("write"));
#line 450 "../usage.c"
puts(_("write"));
-#line 646 "../usage.c"
+#line 659 "../usage.c"
puts(_("write"));
#line 174 "../version.c"
puts(_("write"));
/* END-LIBOPTS-MESSAGES */
/* USAGE-TEXT: */
-#line 895 "../usage.c"
+#line 908 "../usage.c"
puts(_("\t\t\t\t- an alternate for '%s'\n"));
-#line 1164 "../usage.c"
+#line 1177 "../usage.c"
puts(_("Version, usage and configuration options:"));
-#line 946 "../usage.c"
+#line 959 "../usage.c"
puts(_("\t\t\t\t- default option for unnamed options\n"));
-#line 859 "../usage.c"
+#line 872 "../usage.c"
puts(_("\t\t\t\t- disabled as '--%s'\n"));
-#line 1133 "../usage.c"
+#line 1146 "../usage.c"
puts(_(" --- %-14s %s\n"));
-#line 1131 "../usage.c"
+#line 1144 "../usage.c"
puts(_("This option has been disabled"));
-#line 886 "../usage.c"
+#line 899 "../usage.c"
puts(_("\t\t\t\t- enabled by default\n"));
#line 40 "../alias.c"
puts(_("%s error: only "));
-#line 1208 "../usage.c"
+#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"));
"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 919 "../usage.c"
+#line 932 "../usage.c"
puts(_("\t\t\t\t- is a set membership option\n"));
-#line 940 "../usage.c"
+#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 926 "../usage.c"
+#line 939 "../usage.c"
puts(_("\t\t\t\t- may appear multiple times\n"));
-#line 913 "../usage.c"
+#line 926 "../usage.c"
puts(_("\t\t\t\t- may not be preset\n"));
-#line 1323 "../usage.c"
+#line 1336 "../usage.c"
puts(_(" Arg Option-Name Description\n"));
-#line 1259 "../usage.c"
+#line 1272 "../usage.c"
puts(_(" Flg Arg Option-Name Description\n"));
-#line 1317 "../usage.c"
+#line 1330 "../usage.c"
puts(_(" Flg Arg Option-Name Description\n"));
-#line 1318 "../usage.c"
+#line 1331 "../usage.c"
puts(_(" %3s %s"));
-#line 1324 "../usage.c"
+#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 993 "../usage.c"
+#line 1006 "../usage.c"
puts(_(" - reading file %s"));
#line 445 "../usage.c"
puts(_("\n"
#line 129 "../version.c"
puts(_("\n"
"please send bug reports to: <%s>\n"));
-#line 925 "../usage.c"
+#line 938 "../usage.c"
puts(_("\t\t\t\t- may NOT appear - preset only\n"));
-#line 965 "../usage.c"
+#line 978 "../usage.c"
puts(_("\n"
"The following option preset mechanisms are supported:\n"));
-#line 1206 "../usage.c"
+#line 1219 "../usage.c"
puts(_("\n"
"The following option preset mechanisms are supported:\n"));
-#line 704 "../usage.c"
+#line 717 "../usage.c"
puts(_("prohibits these options:\n"));
-#line 699 "../usage.c"
+#line 712 "../usage.c"
puts(_("prohibits the option '%s'\n"));
#line 81 "../numeric.c"
puts(_("%s%ld to %ld"));
puts(_("%sless than or equal to %ld"));
#line 426 "../usage.c"
puts(_("Operands and options may be intermixed. They will be reordered.\n"));
-#line 674 "../usage.c"
+#line 687 "../usage.c"
puts(_("requires the option '%s'\n"));
-#line 677 "../usage.c"
+#line 690 "../usage.c"
puts(_("requires these options:\n"));
-#line 1335 "../usage.c"
+#line 1348 "../usage.c"
puts(_(" Arg Option-Name Req? Description\n"));
-#line 1329 "../usage.c"
+#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 932 "../usage.c"
+#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 1168 "../usage.c"
+#line 1181 "../usage.c"
puts(_("The next option supports vendor supported extra options:"));
-#line 795 "../usage.c"
+#line 808 "../usage.c"
puts(_("These additional options are:"));
/* END-USAGE-TEXT */
}
/*
* EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.h)
*
- * It has been AutoGen-ed February 21, 2013 at 10:47:54 PM by AutoGen 5.17.2pre17
+ * It has been AutoGen-ed February 27, 2013 at 11:38:35 AM by AutoGen 5.17.3.pre2
* From the definitions ntp-keygen-opts.def
* and the template file options
*
* representations about the suitability this software for any purpose. It
* is provided "as is" without express or implied warranty.
*/
-/*
+/**
* This file contains the programmatic interface to the Automated
* Options generated for the ntp-keygen program.
* These macros are documented in the AutoGen info file in the
#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
Choke Me.
#endif
-/*
- * Enumeration of each option:
+/**
+ * Enumeration of each option type for ntp-keygen
*/
typedef enum {
INDEX_OPT_IMBITS = 0,
INDEX_OPT_SAVE_OPTS = 24,
INDEX_OPT_LOAD_OPTS = 25
} teOptIndex;
-
+/** count of all options for ntp-keygen */
#define OPTION_CT 26
-#define NTP_KEYGEN_VERSION "4.2.7p357"
-#define NTP_KEYGEN_FULL_VERSION "ntp-keygen (ntp) 4.2.7p357"
+/** ntp-keygen version */
+#define NTP_KEYGEN_VERSION "4.2.7p358"
+/** Full ntp-keygen version text */
+#define NTP_KEYGEN_FULL_VERSION "ntp-keygen (ntp) 4.2.7p358"
-/*
+/**
* Interface defines for all options. Replace "n" with the UPPER_CASED
* option name (as in the teOptIndex enumeration above).
* e.g. HAVE_OPT(IMBITS)
*/
#define DESC(n) (ntp_keygenOptions.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 ntp-keygen exit codes
*/
typedef enum {
NTP_KEYGEN_EXIT_NO_CONFIG_INPUT = 66,
NTP_KEYGEN_EXIT_LIBOPTS_FAILURE = 70
} ntp_keygen_exit_code_t;
-/*
+/** @} */
+/**
* Make sure there are no #define name conflicts with the option names
*/
#ifndef NO_OPTION_NAME_WARNINGS
# undef MV_KEYS
#endif /* NO_OPTION_NAME_WARNINGS */
-/* * * * * *
- *
+/* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * */
+/**
* Interface defines for specific options.
+ * @{
*/
#define VALUE_OPT_IMBITS 'b'
#ifdef AUTOKEY
#ifdef AUTOKEY
#define OPT_VALUE_MV_KEYS (DESC(MV_KEYS).optArg.argInt)
#endif /* AUTOKEY */
+/** option flag (value) for " (get "val-name") " option */
#define VALUE_OPT_HELP '?'
+/** 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 INDEX_OPT_VERSION
+/** option flag (value) for " (get "val-name") " option */
#define VALUE_OPT_SAVE_OPTS '>'
+/** option flag (value) for " (get "val-name") " option */
#define VALUE_OPT_LOAD_OPTS '<'
#define SET_OPT_SAVE_OPTS(a) STMTS( \
DESC(SAVE_OPTS).fOptState &= OPTST_PERSISTENT_MASK; \
ntp_keygenOptions.pzCurOpt = NULL)
#define START_OPT RESTART_OPT(1)
#define USAGE(c) (*ntp_keygenOptions.pUsageProc)(&ntp_keygenOptions, c)
-/* extracted from opthead.tlib near line 498 */
+/* extracted from opthead.tlib near line 538 */
#ifdef __cplusplus
extern "C" {
-.TH ntp-keygen 1ntp-keygenman "21 Feb 2013" "ntp (4.2.7p357)" "User Commands"
+.TH ntp-keygen 1ntp-keygenman "27 Feb 2013" "ntp (4.2.7p358)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.man)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:48:09 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:38:50 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agman-cmd.tpl
.\"
.PP
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
Portions of this document came from FreeBSD.
.PP
This manual page was \fIAutoGen\fP-erated from the \fBntp-keygen\fP
-.Dd February 21 2013
+.Dd February 27 2013
.Dt NTP_KEYGEN 1ntp-keygenmdoc User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:48:16 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:38:57 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
.Pp
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
Portions of this document came from FreeBSD.
.Pp
This manual page was \fIAutoGen\fP\-erated from the \fBntp\-keygen\fP
printable ASCII format so they can be embedded as MIME attachments in
mail to other sites.
- <p>This document applies to version 4.2.7p357 of <code>ntp-keygen</code>.
+ <p>This document applies to version 4.2.7p358 of <code>ntp-keygen</code>.
<div class="node">
<p><hr>
used to select the program, defaulting to <span class="file">more</span>. Both will exit
with a status code of 0.
-<pre class="example">ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p356
+<pre class="example">ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p357
Usage: ntp-keygen [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
Flg Arg Option-Name Description
-b Num imbits identity modulus bits
-.TH ntp-keygen @NTP_KEYGEN_MS@ "21 Feb 2013" "ntp (4.2.7p357)" "User Commands"
+.TH ntp-keygen @NTP_KEYGEN_MS@ "27 Feb 2013" "ntp (4.2.7p358)" "User Commands"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.man)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:48:09 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:38:50 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agman-cmd.tpl
.\"
.PP
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.SH NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
Portions of this document came from FreeBSD.
.PP
This manual page was \fIAutoGen\fP-erated from the \fBntp-keygen\fP
-.Dd February 21 2013
+.Dd February 27 2013
.Dt NTP_KEYGEN @NTP_KEYGEN_MS@ User Commands
.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 21, 2013 at 10:48:16 PM by AutoGen 5.17.2pre17
+.\" It has been AutoGen-ed February 27, 2013 at 11:38:57 AM by AutoGen 5.17.3.pre2
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
.Pp
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
.Sh NOTES
-This document corresponds to version 4.2.7p357 of NTP.
+This document corresponds to version 4.2.7p358 of NTP.
Portions of this document came from FreeBSD.
.Pp
This manual page was \fIAutoGen\fP\-erated from the \fBntp\-keygen\fP