+(4.2.7p165) 2011/05/11 Released by Harlan Stenn <stenn@ntp.org>
* Convert snmp docs to mdoc format, which requires autogen 5.11.9.
* from 4.2.6p4-RC1: Require autogen 5.11.9.
(4.2.7p164) 2011/05/11 Released by Harlan Stenn <stenn@ntp.org>
/*
* EDIT THIS FILE WITH CAUTION (ntpd-opts.c)
*
- * It has been AutoGen-ed May 11, 2011 at 12:46:34 AM by AutoGen 5.11.9pre10
+ * It has been AutoGen-ed May 11, 2011 at 11:27:57 AM by AutoGen 5.11.9
* From the definitions ntpd-opts.def
* and the template file options
*
/* TRANSLATORS: choose the translation for option names wisely because you
cannot ever change your mind. */
static char const zCopyright[40] =
-"ntpd 4.2.7p164\n\
+"ntpd 4.2.7p165\n\
see html/copyright.html\n";
-static char const zCopyrightNotice[25] =
+static char const zLicenseDescrip[25] =
"see html/copyright.html\n";
extern tUsageProc optionUsage;
*/
static char const zPROGNAME[5] = "NTPD";
static char const zUsageTitle[133] =
-"ntpd - NTP daemon program - Ver. 4.2.7p164\n\
+"ntpd - NTP daemon program - Ver. 4.2.7p165\n\
USAGE: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
\t\t[ <server1> ... <serverN> ]\n";
#define zRcName NULL
+ OPTPROC_MISUSE ),
0, NULL, /* current option index, current option */
NULL, NULL, zPROGNAME,
- zRcName, zCopyright, zCopyrightNotice,
+ zRcName, zCopyright, zLicenseDescrip,
zFullVersion, apzHomeList, zUsageTitle,
zExplain, zDetail, optDesc,
zBugsAddr, /* address to send bugs to */
/*
* EDIT THIS FILE WITH CAUTION (ntpd-opts.h)
*
- * It has been AutoGen-ed May 11, 2011 at 12:46:34 AM by AutoGen 5.11.9pre10
+ * It has been AutoGen-ed May 11, 2011 at 11:27:56 AM by AutoGen 5.11.9
* From the definitions ntpd-opts.def
* and the template file options
*
} teOptIndex;
#define OPTION_CT 36
-#define NTPD_VERSION "4.2.7p164"
-#define NTPD_FULL_VERSION "ntpd 4.2.7p164"
+#define NTPD_VERSION "4.2.7p165"
+#define NTPD_FULL_VERSION "ntpd 4.2.7p165"
/*
* Interface defines for all options. Replace "n" with the UPPER_CASED
#
# EDIT THIS FILE WITH CAUTION (ntpd-opts.texi)
#
-# It has been AutoGen-ed May 11, 2011 at 12:47:08 AM by AutoGen 5.11.9pre10
+# It has been AutoGen-ed May 11, 2011 at 11:30:19 AM by AutoGen 5.11.9
# From the definitions ntpd-opts.def
# and the template file aginfo.tpl
@end ignore
@exampleindent 0
@example
-ntpd - NTP daemon program - Ver. 4.2.7p164
+ntpd - NTP daemon program - Ver. 4.2.7p165
USAGE: ntpd [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... \
[ <server1> ... <serverN> ]
Flg Arg Option-Name Description
-.TH NTPD 1 2011-05-11 "( 4.2.7p164)" "Programmer's Manual"
+.TH NTPD 1 2011-05-11 "( 4.2.7p165)" "Programmer's Manual"
.\" EDIT THIS FILE WITH CAUTION (ntpd.1)
.\"
-.\" It has been AutoGen-ed May 11, 2011 at 12:47:07 AM by AutoGen 5.11.9pre10
+.\" It has been AutoGen-ed May 11, 2011 at 11:30:18 AM by AutoGen 5.11.9
.\" From the definitions ntpd-opts.def
.\" and the template file agman1.tpl
.\"
/*
* EDIT THIS FILE WITH CAUTION (ntpdc-opts.c)
*
- * It has been AutoGen-ed May 11, 2011 at 12:47:16 AM by AutoGen 5.11.9pre10
+ * It has been AutoGen-ed May 11, 2011 at 11:30:52 AM by AutoGen 5.11.9
* From the definitions ntpdc-opts.def
* and the template file options
*
/* TRANSLATORS: choose the translation for option names wisely because you
cannot ever change your mind. */
static char const zCopyright[41] =
-"ntpdc 4.2.7p164\n\
+"ntpdc 4.2.7p165\n\
see html/copyright.html\n";
-static char const zCopyrightNotice[25] =
+static char const zLicenseDescrip[25] =
"see html/copyright.html\n";
extern tUsageProc optionUsage;
*/
static char const zPROGNAME[6] = "NTPDC";
static char const zUsageTitle[129] =
-"ntpdc - vendor-specific NTP query program - Ver. 4.2.7p164\n\
+"ntpdc - vendor-specific NTP query program - Ver. 4.2.7p165\n\
USAGE: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n";
static char const zRcName[7] = ".ntprc";
static char const * const apzHomeList[3] = {
+ OPTPROC_MISUSE ),
0, NULL, /* current option index, current option */
NULL, NULL, zPROGNAME,
- zRcName, zCopyright, zCopyrightNotice,
+ zRcName, zCopyright, zLicenseDescrip,
zFullVersion, apzHomeList, zUsageTitle,
zExplain, zDetail, optDesc,
zBugsAddr, /* address to send bugs to */
/*
* EDIT THIS FILE WITH CAUTION (ntpdc-opts.h)
*
- * It has been AutoGen-ed May 11, 2011 at 12:47:16 AM by AutoGen 5.11.9pre10
+ * It has been AutoGen-ed May 11, 2011 at 11:30:52 AM by AutoGen 5.11.9
* From the definitions ntpdc-opts.def
* and the template file options
*
} teOptIndex;
#define OPTION_CT 15
-#define NTPDC_VERSION "4.2.7p164"
-#define NTPDC_FULL_VERSION "ntpdc 4.2.7p164"
+#define NTPDC_VERSION "4.2.7p165"
+#define NTPDC_FULL_VERSION "ntpdc 4.2.7p165"
/*
* Interface defines for all options. Replace "n" with the UPPER_CASED
#
# EDIT THIS FILE WITH CAUTION (ntpdc-opts.texi)
#
-# It has been AutoGen-ed May 11, 2011 at 12:47:27 AM by AutoGen 5.11.9pre10
+# It has been AutoGen-ed May 11, 2011 at 11:31:26 AM by AutoGen 5.11.9
# From the definitions ntpdc-opts.def
# and the template file aginfo.tpl
@end ignore
@exampleindent 0
@example
-ntpdc - vendor-specific NTP query program - Ver. 4.2.7p164
+ntpdc - vendor-specific NTP query program - Ver. 4.2.7p165
USAGE: ntpdc [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [ host ...]
Flg Arg Option-Name Description
-4 no ipv4 Force IPv4 DNS name resolution
-.TH NTPDC 1 2011-05-11 "( 4.2.7p164)" "Programmer's Manual"
+.TH NTPDC 1 2011-05-11 "( 4.2.7p165)" "Programmer's Manual"
.\" EDIT THIS FILE WITH CAUTION (ntpdc.1)
.\"
-.\" It has been AutoGen-ed May 11, 2011 at 12:47:27 AM by AutoGen 5.11.9pre10
+.\" It has been AutoGen-ed May 11, 2011 at 11:31:25 AM by AutoGen 5.11.9
.\" From the definitions ntpdc-opts.def
.\" and the template file agman1.tpl
.\"
/*
* EDIT THIS FILE WITH CAUTION (ntpq-opts.c)
*
- * It has been AutoGen-ed May 11, 2011 at 12:47:28 AM by AutoGen 5.11.9pre10
+ * It has been AutoGen-ed May 11, 2011 at 11:31:29 AM by AutoGen 5.11.9
* From the definitions ntpq-opts.def
* and the template file options
*
/* TRANSLATORS: choose the translation for option names wisely because you
cannot ever change your mind. */
static char const zCopyright[40] =
-"ntpq 4.2.7p164\n\
+"ntpq 4.2.7p165\n\
see html/copyright.html\n";
-static char const zCopyrightNotice[25] =
+static char const zLicenseDescrip[25] =
"see html/copyright.html\n";
extern tUsageProc optionUsage;
*/
static char const zPROGNAME[5] = "NTPQ";
static char const zUsageTitle[121] =
-"ntpq - standard NTP query program - Ver. 4.2.7p164\n\
+"ntpq - standard NTP query program - Ver. 4.2.7p165\n\
USAGE: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n";
static char const zRcName[7] = ".ntprc";
static char const * const apzHomeList[3] = {
+ OPTPROC_MISUSE ),
0, NULL, /* current option index, current option */
NULL, NULL, zPROGNAME,
- zRcName, zCopyright, zCopyrightNotice,
+ zRcName, zCopyright, zLicenseDescrip,
zFullVersion, apzHomeList, zUsageTitle,
zExplain, zDetail, optDesc,
zBugsAddr, /* address to send bugs to */
/*
* EDIT THIS FILE WITH CAUTION (ntpq-opts.h)
*
- * It has been AutoGen-ed May 11, 2011 at 12:47:28 AM by AutoGen 5.11.9pre10
+ * It has been AutoGen-ed May 11, 2011 at 11:31:28 AM by AutoGen 5.11.9
* From the definitions ntpq-opts.def
* and the template file options
*
} teOptIndex;
#define OPTION_CT 14
-#define NTPQ_VERSION "4.2.7p164"
-#define NTPQ_FULL_VERSION "ntpq 4.2.7p164"
+#define NTPQ_VERSION "4.2.7p165"
+#define NTPQ_FULL_VERSION "ntpq 4.2.7p165"
/*
* Interface defines for all options. Replace "n" with the UPPER_CASED
#
# EDIT THIS FILE WITH CAUTION (ntpq-opts.texi)
#
-# It has been AutoGen-ed May 11, 2011 at 12:47:42 AM by AutoGen 5.11.9pre10
+# It has been AutoGen-ed May 11, 2011 at 11:32:13 AM by AutoGen 5.11.9
# From the definitions ntpq-opts.def
# and the template file aginfo.tpl
@end ignore
@exampleindent 0
@example
-ntpq - standard NTP query program - Ver. 4.2.7p164
+ntpq - standard NTP query program - Ver. 4.2.7p165
USAGE: ntpq [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [ host ...]
Flg Arg Option-Name Description
-4 no ipv4 Force IPv4 DNS name resolution
-.TH NTPQ 1 2011-05-11 "( 4.2.7p164)" "Programmer's Manual"
+.TH NTPQ 1 2011-05-11 "( 4.2.7p165)" "Programmer's Manual"
.\" EDIT THIS FILE WITH CAUTION (ntpq.1)
.\"
-.\" It has been AutoGen-ed May 11, 2011 at 12:47:42 AM by AutoGen 5.11.9pre10
+.\" It has been AutoGen-ed May 11, 2011 at 11:32:11 AM by AutoGen 5.11.9
.\" From the definitions ntpq-opts.def
.\" and the template file agman1.tpl
.\"
/*
* EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.c)
*
- * It has been AutoGen-ed May 11, 2011 at 12:47:43 AM by AutoGen 5.11.9pre10
+ * It has been AutoGen-ed May 11, 2011 at 11:32:14 AM by AutoGen 5.11.9
* From the definitions ntpsnmpd-opts.def
* and the template file options
*
/* TRANSLATORS: choose the translation for option names wisely because you
cannot ever change your mind. */
static char const zCopyright[44] =
-"ntpsnmpd 4.2.7p164\n\
+"ntpsnmpd 4.2.7p165\n\
see html/copyright.html\n";
-static char const zCopyrightNotice[25] =
+static char const zLicenseDescrip[25] =
"see html/copyright.html\n";
extern tUsageProc optionUsage;
*/
static char const zPROGNAME[9] = "NTPSNMPD";
static char const zUsageTitle[105] =
-"ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p164\n\
+"ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p165\n\
USAGE: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n";
static char const zRcName[7] = ".ntprc";
static char const * const apzHomeList[3] = {
+ OPTPROC_MISUSE ),
0, NULL, /* current option index, current option */
NULL, NULL, zPROGNAME,
- zRcName, zCopyright, zCopyrightNotice,
+ zRcName, zCopyright, zLicenseDescrip,
zFullVersion, apzHomeList, zUsageTitle,
zExplain, zDetail, optDesc,
zBugsAddr, /* address to send bugs to */
/*
* EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.h)
*
- * It has been AutoGen-ed May 11, 2011 at 12:47:42 AM by AutoGen 5.11.9pre10
+ * It has been AutoGen-ed May 11, 2011 at 11:32:14 AM by AutoGen 5.11.9
* From the definitions ntpsnmpd-opts.def
* and the template file options
*
} teOptIndex;
#define OPTION_CT 8
-#define NTPSNMPD_VERSION "4.2.7p164"
-#define NTPSNMPD_FULL_VERSION "ntpsnmpd 4.2.7p164"
+#define NTPSNMPD_VERSION "4.2.7p165"
+#define NTPSNMPD_FULL_VERSION "ntpsnmpd 4.2.7p165"
/*
* Interface defines for all options. Replace "n" with the UPPER_CASED
#
# EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.texi)
#
-# It has been AutoGen-ed May 11, 2011 at 12:47:48 AM by AutoGen 5.11.9pre10
+# It has been AutoGen-ed May 11, 2011 at 11:32:36 AM by AutoGen 5.11.9
# From the definitions ntpsnmpd-opts.def
# and the template file aginfo.tpl
@end ignore
@exampleindent 0
@example
-ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p164
+ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.7p165
USAGE: ntpsnmpd [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
Flg Arg Option-Name Description
-n no nofork Do not fork
-.TH NTPSNMPD 1 2011-05-11 "( 4.2.7p164)" "Programmer's Manual"
+.TH NTPSNMPD 1 2011-05-11 "( 4.2.7p165)" "Programmer's Manual"
.\" EDIT THIS FILE WITH CAUTION (ntpsnmpd.1)
.\"
-.\" It has been AutoGen-ed May 11, 2011 at 12:47:48 AM by AutoGen 5.11.9pre10
+.\" It has been AutoGen-ed May 11, 2011 at 11:32:34 AM by AutoGen 5.11.9
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agman1.tpl
.\"
# - Numeric values increment
# - empty 'increments' to 1
# - NEW 'increments' to empty
-point=164
+point=165
### betapoint is normally modified by script.
# ntp-stable Beta number (betapoint)
/*
* EDIT THIS FILE WITH CAUTION (sntp-opts.c)
*
- * It has been AutoGen-ed May 11, 2011 at 12:43:30 AM by AutoGen 5.11.9pre10
+ * It has been AutoGen-ed May 11, 2011 at 11:08:32 AM by AutoGen 5.11.9
* From the definitions sntp-opts.def
* and the template file options
*
/* TRANSLATORS: choose the translation for option names wisely because you
cannot ever change your mind. */
static char const zCopyright[40] =
-"sntp 4.2.7p164\n\
+"sntp 4.2.7p165\n\
see html/copyright.html\n";
-static char const zCopyrightNotice[25] =
+static char const zLicenseDescrip[25] =
"see html/copyright.html\n";
extern tUsageProc optionUsage;
# define NULL 0
#endif
-/*
- * Debug_Level option description:
- */
-static char const zDebug_LevelText[] =
- "Increase output debug message level";
-static char const zDebug_Level_NAME[] = "DEBUG_LEVEL";
-static char const zDebug_Level_Name[] = "debug-level";
-#define DEBUG_LEVEL_FLAGS (OPTST_DISABLED)
-
-/*
- * Set_Debug_Level option description:
- */
-static char const zSet_Debug_LevelText[] =
- "Set the output debug message level";
-static char const zSet_Debug_Level_NAME[] = "SET_DEBUG_LEVEL";
-static char const zSet_Debug_Level_Name[] = "set-debug-level";
-#define SET_DEBUG_LEVEL_FLAGS (OPTST_DISABLED \
- | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
-
/*
* Ipv4 option description with
* "Must also have options" and "Incompatible options":
#define CONCURRENT_FLAGS (OPTST_DISABLED | OPTST_STACKED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
+/*
+ * Debug_Level option description:
+ */
+static char const zDebug_LevelText[] =
+ "Increase output debug message level";
+static char const zDebug_Level_NAME[] = "DEBUG_LEVEL";
+static char const zDebug_Level_Name[] = "debug-level";
+#define DEBUG_LEVEL_FLAGS (OPTST_DISABLED)
+
+/*
+ * Set_Debug_Level option description:
+ */
+static char const zSet_Debug_LevelText[] =
+ "Set the output debug message level";
+static char const zSet_Debug_Level_NAME[] = "SET_DEBUG_LEVEL";
+static char const zSet_Debug_Level_Name[] = "set-debug-level";
+#define SET_DEBUG_LEVEL_FLAGS (OPTST_DISABLED \
+ | OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
+
/*
* Headspace option description:
*/
* Define the Sntp Option Descriptions.
*/
static tOptDesc optDesc[OPTION_CT] = {
- { /* entry idx, value */ 0, VALUE_OPT_DEBUG_LEVEL,
- /* equiv idx, value */ 0, VALUE_OPT_DEBUG_LEVEL,
- /* equivalenced to */ NO_EQUIVALENT,
- /* min, max, act ct */ 0, NOLIMIT, 0,
- /* opt state flags */ DEBUG_LEVEL_FLAGS, 0,
- /* last opt argumnt */ { NULL },
- /* arg list/cookie */ NULL,
- /* must/cannot opts */ NULL, NULL,
- /* option proc */ NULL,
- /* desc, NAME, name */ zDebug_LevelText, zDebug_Level_NAME, zDebug_Level_Name,
- /* disablement strs */ NULL, NULL },
-
- { /* entry idx, value */ 1, VALUE_OPT_SET_DEBUG_LEVEL,
- /* equiv idx, value */ 1, VALUE_OPT_SET_DEBUG_LEVEL,
- /* equivalenced to */ NO_EQUIVALENT,
- /* min, max, act ct */ 0, NOLIMIT, 0,
- /* opt state flags */ SET_DEBUG_LEVEL_FLAGS, 0,
- /* last opt argumnt */ { NULL },
- /* arg list/cookie */ NULL,
- /* must/cannot opts */ NULL, NULL,
- /* option proc */ SET_DEBUG_LEVEL_OPT_PROC,
- /* desc, NAME, name */ zSet_Debug_LevelText, zSet_Debug_Level_NAME, zSet_Debug_Level_Name,
- /* disablement strs */ NULL, NULL },
-
- { /* entry idx, value */ 2, VALUE_OPT_IPV4,
- /* equiv idx, value */ 2, VALUE_OPT_IPV4,
+ { /* entry idx, value */ 0, VALUE_OPT_IPV4,
+ /* equiv idx, value */ 0, VALUE_OPT_IPV4,
/* equivalenced to */ NO_EQUIVALENT,
/* min, max, act ct */ 0, 1, 0,
/* opt state flags */ IPV4_FLAGS, 0,
/* desc, NAME, name */ zIpv4Text, zIpv4_NAME, zIpv4_Name,
/* disablement strs */ NULL, NULL },
- { /* entry idx, value */ 3, VALUE_OPT_IPV6,
- /* equiv idx, value */ 3, VALUE_OPT_IPV6,
+ { /* entry idx, value */ 1, VALUE_OPT_IPV6,
+ /* equiv idx, value */ 1, VALUE_OPT_IPV6,
/* equivalenced to */ NO_EQUIVALENT,
/* min, max, act ct */ 0, 1, 0,
/* opt state flags */ IPV6_FLAGS, 0,
/* desc, NAME, name */ zIpv6Text, zIpv6_NAME, zIpv6_Name,
/* disablement strs */ NULL, NULL },
- { /* entry idx, value */ 4, VALUE_OPT_AUTHENTICATION,
- /* equiv idx, value */ 4, VALUE_OPT_AUTHENTICATION,
+ { /* entry idx, value */ 2, VALUE_OPT_AUTHENTICATION,
+ /* equiv idx, value */ 2, VALUE_OPT_AUTHENTICATION,
/* equivalenced to */ NO_EQUIVALENT,
/* min, max, act ct */ 0, 1, 0,
/* opt state flags */ AUTHENTICATION_FLAGS, 0,
/* desc, NAME, name */ zAuthenticationText, zAuthentication_NAME, zAuthentication_Name,
/* disablement strs */ NULL, NULL },
- { /* entry idx, value */ 5, VALUE_OPT_BCTIMEOUT,
- /* equiv idx, value */ 5, VALUE_OPT_BCTIMEOUT,
+ { /* entry idx, value */ 3, VALUE_OPT_BCTIMEOUT,
+ /* equiv idx, value */ 3, VALUE_OPT_BCTIMEOUT,
/* equivalenced to */ NO_EQUIVALENT,
/* min, max, act ct */ 0, 1, 0,
/* opt state flags */ BCTIMEOUT_FLAGS, 0,
/* desc, NAME, name */ zBctimeoutText, zBctimeout_NAME, zBctimeout_Name,
/* disablement strs */ NULL, NULL },
- { /* entry idx, value */ 6, VALUE_OPT_BROADCAST,
- /* equiv idx, value */ 6, VALUE_OPT_BROADCAST,
+ { /* entry idx, value */ 4, VALUE_OPT_BROADCAST,
+ /* equiv idx, value */ 4, VALUE_OPT_BROADCAST,
/* equivalenced to */ NO_EQUIVALENT,
/* min, max, act ct */ 0, NOLIMIT, 0,
/* opt state flags */ BROADCAST_FLAGS, 0,
/* desc, NAME, name */ zBroadcastText, zBroadcast_NAME, zBroadcast_Name,
/* disablement strs */ NULL, NULL },
- { /* entry idx, value */ 7, VALUE_OPT_CONCURRENT,
- /* equiv idx, value */ 7, VALUE_OPT_CONCURRENT,
+ { /* entry idx, value */ 5, VALUE_OPT_CONCURRENT,
+ /* equiv idx, value */ 5, VALUE_OPT_CONCURRENT,
/* equivalenced to */ NO_EQUIVALENT,
/* min, max, act ct */ 0, NOLIMIT, 0,
/* opt state flags */ CONCURRENT_FLAGS, 0,
/* desc, NAME, name */ zConcurrentText, zConcurrent_NAME, zConcurrent_Name,
/* disablement strs */ NULL, NULL },
+ { /* entry idx, value */ 6, VALUE_OPT_DEBUG_LEVEL,
+ /* equiv idx, value */ 6, VALUE_OPT_DEBUG_LEVEL,
+ /* equivalenced to */ NO_EQUIVALENT,
+ /* min, max, act ct */ 0, NOLIMIT, 0,
+ /* opt state flags */ DEBUG_LEVEL_FLAGS, 0,
+ /* last opt argumnt */ { NULL },
+ /* arg list/cookie */ NULL,
+ /* must/cannot opts */ NULL, NULL,
+ /* option proc */ NULL,
+ /* desc, NAME, name */ zDebug_LevelText, zDebug_Level_NAME, zDebug_Level_Name,
+ /* disablement strs */ NULL, NULL },
+
+ { /* entry idx, value */ 7, VALUE_OPT_SET_DEBUG_LEVEL,
+ /* equiv idx, value */ 7, VALUE_OPT_SET_DEBUG_LEVEL,
+ /* equivalenced to */ NO_EQUIVALENT,
+ /* min, max, act ct */ 0, NOLIMIT, 0,
+ /* opt state flags */ SET_DEBUG_LEVEL_FLAGS, 0,
+ /* last opt argumnt */ { NULL },
+ /* arg list/cookie */ NULL,
+ /* must/cannot opts */ NULL, NULL,
+ /* option proc */ SET_DEBUG_LEVEL_OPT_PROC,
+ /* desc, NAME, name */ zSet_Debug_LevelText, zSet_Debug_Level_NAME, zSet_Debug_Level_Name,
+ /* disablement strs */ NULL, NULL },
+
{ /* entry idx, value */ 8, VALUE_OPT_HEADSPACE,
/* equiv idx, value */ 8, VALUE_OPT_HEADSPACE,
/* equivalenced to */ NO_EQUIVALENT,
*/
static char const zPROGNAME[5] = "SNTP";
static char const zUsageTitle[154] =
-"sntp - standard Simple Network Time Protocol program - Ver. 4.2.7p164\n\
+"sntp - standard Simple Network Time Protocol program - Ver. 4.2.7p165\n\
USAGE: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
\t\t[ hostname-or-IP ...]\n";
static char const zRcName[7] = ".ntprc";
+ OPTPROC_MISUSE ),
0, NULL, /* current option index, current option */
NULL, NULL, zPROGNAME,
- zRcName, zCopyright, zCopyrightNotice,
+ zRcName, zCopyright, zLicenseDescrip,
zFullVersion, apzHomeList, zUsageTitle,
zExplain, zDetail, optDesc,
zBugsAddr, /* address to send bugs to */
/*
* EDIT THIS FILE WITH CAUTION (sntp-opts.h)
*
- * It has been AutoGen-ed May 11, 2011 at 12:43:30 AM by AutoGen 5.11.9pre10
+ * It has been AutoGen-ed May 11, 2011 at 11:08:32 AM by AutoGen 5.11.9
* From the definitions sntp-opts.def
* and the template file options
*
* Enumeration of each option:
*/
typedef enum {
- INDEX_OPT_DEBUG_LEVEL = 0,
- INDEX_OPT_SET_DEBUG_LEVEL = 1,
- INDEX_OPT_IPV4 = 2,
- INDEX_OPT_IPV6 = 3,
- INDEX_OPT_AUTHENTICATION = 4,
- INDEX_OPT_BCTIMEOUT = 5,
- INDEX_OPT_BROADCAST = 6,
- INDEX_OPT_CONCURRENT = 7,
+ INDEX_OPT_IPV4 = 0,
+ INDEX_OPT_IPV6 = 1,
+ INDEX_OPT_AUTHENTICATION = 2,
+ INDEX_OPT_BCTIMEOUT = 3,
+ INDEX_OPT_BROADCAST = 4,
+ INDEX_OPT_CONCURRENT = 5,
+ INDEX_OPT_DEBUG_LEVEL = 6,
+ INDEX_OPT_SET_DEBUG_LEVEL = 7,
INDEX_OPT_HEADSPACE = 8,
INDEX_OPT_KOD = 9,
INDEX_OPT_KEYFILE = 10,
} teOptIndex;
#define OPTION_CT 24
-#define SNTP_VERSION "4.2.7p164"
-#define SNTP_FULL_VERSION "sntp 4.2.7p164"
+#define SNTP_VERSION "4.2.7p165"
+#define SNTP_FULL_VERSION "sntp 4.2.7p165"
/*
* Interface defines for all options. Replace "n" with the UPPER_CASED
* option name (as in the teOptIndex enumeration above).
- * e.g. HAVE_OPT(DEBUG_LEVEL)
+ * e.g. HAVE_OPT(IPV4)
*/
#define DESC(n) (sntpOptions.pOptDesc[INDEX_OPT_## n])
#define HAVE_OPT(n) (! UNUSED_OPT(& DESC(n)))
* Make sure there are no #define name conflicts with the option names
*/
#ifndef NO_OPTION_NAME_WARNINGS
-# ifdef DEBUG_LEVEL
-# warning undefining DEBUG_LEVEL due to option name conflict
-# undef DEBUG_LEVEL
-# endif
-# ifdef SET_DEBUG_LEVEL
-# warning undefining SET_DEBUG_LEVEL due to option name conflict
-# undef SET_DEBUG_LEVEL
-# endif
# ifdef IPV4
# warning undefining IPV4 due to option name conflict
# undef IPV4
# warning undefining CONCURRENT due to option name conflict
# undef CONCURRENT
# endif
+# ifdef DEBUG_LEVEL
+# warning undefining DEBUG_LEVEL due to option name conflict
+# undef DEBUG_LEVEL
+# endif
+# ifdef SET_DEBUG_LEVEL
+# warning undefining SET_DEBUG_LEVEL due to option name conflict
+# undef SET_DEBUG_LEVEL
+# endif
# ifdef HEADSPACE
# warning undefining HEADSPACE due to option name conflict
# undef HEADSPACE
# undef WAIT
# endif
#else /* NO_OPTION_NAME_WARNINGS */
-# undef DEBUG_LEVEL
-# undef SET_DEBUG_LEVEL
# undef IPV4
# undef IPV6
# undef AUTHENTICATION
# undef BCTIMEOUT
# undef BROADCAST
# undef CONCURRENT
+# undef DEBUG_LEVEL
+# undef SET_DEBUG_LEVEL
# undef HEADSPACE
# undef KOD
# undef KEYFILE
*
* Interface defines for specific options.
*/
-#define VALUE_OPT_DEBUG_LEVEL 'd'
-#define VALUE_OPT_SET_DEBUG_LEVEL 'D'
#define VALUE_OPT_IPV4 '4'
#define VALUE_OPT_IPV6 '6'
#define VALUE_OPT_AUTHENTICATION 'a'
#define OPT_VALUE_BCTIMEOUT (DESC(BCTIMEOUT).optArg.argInt)
#define VALUE_OPT_BROADCAST 'b'
#define VALUE_OPT_CONCURRENT 'c'
+#define VALUE_OPT_DEBUG_LEVEL 'd'
+#define VALUE_OPT_SET_DEBUG_LEVEL 'D'
#define VALUE_OPT_HEADSPACE 'h'
#define OPT_VALUE_HEADSPACE (DESC(HEADSPACE).optArg.argInt)
#
# EDIT THIS FILE WITH CAUTION (sntp-opts.texi)
#
-# It has been AutoGen-ed May 11, 2011 at 12:48:09 AM by AutoGen 5.11.9pre10
+# It has been AutoGen-ed May 11, 2011 at 07:29:02 PM by AutoGen 5.11.9
# From the definitions sntp-opts.def
# and the template file aginfo.tpl
@end ignore
@exampleindent 0
@example
-sntp - standard Simple Network Time Protocol program - Ver. 4.2.7p164
+sntp - standard Simple Network Time Protocol program - Ver. 4.2.7p165
USAGE: sntp [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... \
[ hostname-or-IP ...]
Flg Arg Option-Name Description
- -d no debug-level Increase output debug message level
- - may appear multiple times
- -D Str set-debug-level Set the output debug message level
- - may appear multiple times
-4 no ipv4 Force IPv4 DNS name resolution
- prohibits these options:
ipv6
- may appear multiple times
-c Str concurrent Concurrent query all IPs returned for host-name
- may appear multiple times
+ -d no debug-level Increase output debug message level
+ - may appear multiple times
+ -D Str set-debug-level Set the output debug message level
+ - may appear multiple times
-h Num headspace The gap (in milliseconds) between time requests
-K Fil kod KoD history filename
-k Fil keyfile Look in this file for the key specified with -a
@cindex sntp-authentication
This is the ``enable authentication with the key auth-keynumber'' option.
-This option enables authentication using the key specified in this option's argument.
-The argument of this option is the keyid, a number specified in the keyfile as this
-key's identifier. See the keyfile option (-k) for more details.
+This option enables authentication using the key specified in this
+option's argument. The argument of this option is the keyid, a
+number specified in the keyfile as this key's identifier. See the
+keyfile option (-k) for more details.
@node sntp bctimeout
@subsection bctimeout option (-B)
Requests from an NTP "client" to a "server" should never be sent
more rapidly than one every 2 seconds. By default, any IPs returned
as part of a DNS lookup are assumed to be for a single instance of
-ntpd, and therefore sntp will send queries to these IPs one after
+ntpd, and therefore sntp will send queries to these IPs one after
another, with a 2-second gap in between each query.
-The -c or --concurrent flag says that any IPs returned for the
-DNS lookup of the supplied host-name are on different machines,
-so we can send concurrent queries.
+The -c or --concurrent flag says that any IPs returned for the DNS
+lookup of the supplied host-name are on different machines, so we
+can send concurrent queries.
@node sntp debug-level
@subsection debug-level option (-d)
@cindex sntp-keyfile
This is the ``look in this file for the key specified with -a'' option.
-This option specifies the keyfile. SNTP will search for the key specified with -a keyno in this
+This option specifies the keyfile.
+SNTP will search for the key specified with -a keyno in this
file. Key files follow the following format:
keyid keytype key
@cindex sntp-kod
This is the ``kod history filename'' option.
-Specifies the filename to be used for the persistent history of KoD
+Specifies the filename to be used for the persistent history of KoD
responses received from servers. The default is
-/var/db/ntp-kod.
+/var/db/ntp-kod .
@node sntp ntpversion
@subsection ntpversion option (-o)
@cindex sntp-steplimit
This is the ``adjustments less than steplimit msec will be slewed.'' option.
-If the time adjustment is less than steplimit milliseconds, slew the amount using adjtime(). Otherwise, step the correction using settimeofday().
+If the time adjustment is less than steplimit milliseconds, slew the
+amount using adjtime(). Otherwise, step the correction using
+settimeofday().
@node sntp uctimeout
@subsection uctimeout option (-u)
@cindex sntp-usereservedport
This is the ``use the ntp reserved port (port 123)'' option.
-Use port 123, which is reserved for NTP, for our network communications.
+Use port 123, which is reserved for NTP, for our network
+communications.
@node sntp wait
@subsection wait option
-.TH sntp 1 "11 May 2011" "4.2.7p164" "User Commands"
-.\"
-.\" EDIT THIS FILE WITH CAUTION (sntp.man)
+.Dd May 11 2011
+.Dt SNTP 1 User Commands
+.Os SunOS 5.10
+.\" EDIT THIS FILE WITH CAUTION (sntp-opts.mdoc)
.\"
-.\" It has been AutoGen-ed May 11, 2011 at 12:48:08 AM by AutoGen 5.11.9pre10
+.\" It has been AutoGen-ed May 11, 2011 at 07:29:01 PM by AutoGen 5.11.9
.\" From the definitions sntp-opts.def
-.\" and the template file agman-cmd.tpl
-.\"
-.SH NAME
-sntp \- standard Simple Network Time Protocol program
-.SH SYNOPSIS
-.B sntp
+.\" and the template file agmdoc-cmd.tpl
+.Sh NAME
+.Nm sntp
+.Nd standard Simple Network Time Protocol program.Sh SYNOPSIS
+.Nm SNTP
.\" Mixture of short (flag) options and long options
-.RB [ \-\fIflag\fP " [\fIvalue\fP]]... [" \-\-\fIopt\-name\fP " [[=| ]\fIvalue\fP]]..." [ hostname-or-IP ...]
-.PP
-.SH DESCRIPTION
-.I sntp
+.Op Fl flags
+.Op Fl flag Ar value
+.Op Fl \-option-name Ar value[ hostname-or-IP ...]
+.Pp
+.Sh DESCRIPTION
+.Nm
can be used as a SNTP client to query a NTP or SNTP server and either display
the time or set the local system's time (given suitable privilege). It can be
run as an interactive command or in a
-.I cron
+.Ic cron
job.
NTP (the Network Time Protocol) and SNTP (the Simple Network Time Protocol)
are defined and described by RFC 5905.
.PP
The default is to write the estimated correct local date and time (i.e. not
-UTC) to the standard output in a format like
-.BR "'1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 secs'" ,
+UTC) to the standard output in a format like:
+.Ic "'1996-10-15 20:17:25.123 (+0800) +4.567 +/- 0.089 secs'"
where the
-.B "'(+0800)'"
+.Ic "'(+0800)'"
means that to get to UTC from the reported local time one must
add 8 hours and 0 minutes,
and the
-.B "'+4.567 +/- 0.089 secs'"
+.Ic "'+4.567 +/- 0.089 secs'"
indicates the local clock is 4.567 seconds behind the correct time
(so 4.567 seconds must be added to the local clock to get it to be correct),
-and the time of
+and the date/time of
'1996-10-15 20:17:25.123'
is believed to be correct to within
+/- 0.089
seconds.
-.SH OPTIONS
-.TP
-.BR \-d ", " -\-debug\-level
-Increase output debug message level.
-This option may appear an unlimited number of times.
-.sp
-Increase the debugging message output level.
-.TP
-.BR \-D " \fIstring\fP, " \-\-set\-debug\-level "=" \fIstring\fP
-Set the output debug message level.
-This option may appear an unlimited number of times.
-.sp
-Set the output debugging level. Can be supplied multiple times,
-but each overrides the previous value(s).
-.TP
-.BR \-4 ", " -\-ipv4
+.Sh OPTIONS
+.Bl -tag
+.It \-4 ", " -\-ipv4
Force IPv4 DNS name resolution.
This option must not appear in combination with any of the following options:
ipv6.
.sp
Force DNS resolution of following host names on the command line
to the IPv4 namespace.
-.TP
-.BR \-6 ", " -\-ipv6
+.It \-6 ", " -\-ipv6
Force IPv6 DNS name resolution.
This option must not appear in combination with any of the following options:
ipv4.
.sp
Force DNS resolution of following host names on the command line
to the IPv6 namespace.
-.TP
-.BR \-a " \fIauth\-keynumber\fP, " \-\-authentication "=" \fIauth\-keynumber\fP
+.It \-a " \fIauth\-keynumber\fP, " \-\-authentication "=" \fIauth\-keynumber\fP
Enable authentication with the key auth-keynumber.
This option takes an integer number as its argument.
.sp
-This option enables authentication using the key specified in this option's argument.
-The argument of this option is the keyid, a number specified in the keyfile as this
-key's identifier. See the keyfile option (-k) for more details.
-.TP
-.BR \-B " \fIseconds\fP, " \-\-bctimeout "=" \fIseconds\fP
+This option enables authentication using the key specified in this
+option's argument. The argument of this option is the keyid, a
+number specified in the keyfile as this key's identifier. See the
+keyfile option (-k) for more details.
+.It \-B " \fIseconds\fP, " \-\-bctimeout "=" \fIseconds\fP
The number of seconds to wait for broadcasts.
This option takes an integer number as its argument.
-The default \fIseconds\fP for this option is:
+The default \fIseconds\fP for this option is:
.ti +4
68
.sp
When waiting for a broadcast packet SNTP will wait the number
of seconds specified before giving up. Default 68 seconds.
-.TP
-.BR \-b " \fIbroadcast\-address\fP, " \-\-broadcast "=" \fIbroadcast\-address\fP
+.It \-b " \fIbroadcast\-address\fP, " \-\-broadcast "=" \fIbroadcast\-address\fP
Listen to the address specified for broadcast time sync.
This option may appear an unlimited number of times.
.sp
If specified SNTP will listen to the specified address
for NTP broadcasts. The default maximum wait time,
68 seconds, can be modified with -B.
-.TP
-.BR \-c " \fIhost\-name\fP, " \-\-concurrent "=" \fIhost\-name\fP
+.It \-c " \fIhost\-name\fP, " \-\-concurrent "=" \fIhost\-name\fP
Concurrent query all IPs returned for host-name.
This option may appear an unlimited number of times.
.sp
Requests from an NTP "client" to a "server" should never be sent
more rapidly than one every 2 seconds. By default, any IPs returned
as part of a DNS lookup are assumed to be for a single instance of
-ntpd, and therefore sntp will send queries to these IPs one after
+ntpd, and therefore sntp will send queries to these IPs one after
another, with a 2-second gap in between each query.
-The -c or --concurrent flag says that any IPs returned for the
-DNS lookup of the supplied host-name are on different machines,
-so we can send concurrent queries.
-.TP
-.BR \-h " \fImilliseconds\fP, " \-\-headspace "=" \fImilliseconds\fP
+The -c or --concurrent flag says that any IPs returned for the DNS
+lookup of the supplied host-name are on different machines, so we
+can send concurrent queries.
+.It \-d ", " -\-debug\-level
+Increase output debug message level.
+This option may appear an unlimited number of times.
+.sp
+Increase the debugging message output level.
+.It \-D " \fIstring\fP, " \-\-set\-debug\-level "=" \fIstring\fP
+Set the output debug message level.
+This option may appear an unlimited number of times.
+.sp
+Set the output debugging level. Can be supplied multiple times,
+but each overrides the previous value(s).
+.It \-h " \fImilliseconds\fP, " \-\-headspace "=" \fImilliseconds\fP
The gap (in milliseconds) between time requests.
This option takes an integer number as its argument.
-The default \fImilliseconds\fP for this option is:
+The default \fImilliseconds\fP for this option is:
.ti +4
10
.sp
separate the queries we send out by the specified number of
milliseconds.
Default 10 milliseconds.
-.TP
-.BR \-K " \fIfile\-name\fP, " \-\-kod "=" \fIfile\-name\fP
+.It \-K " \fIfile\-name\fP, " \-\-kod "=" \fIfile\-name\fP
KoD history filename.
-The default \fIfile\-name\fP for this option is:
+The default \fIfile\-name\fP for this option is:
.ti +4
/var/db/ntp-kod
.sp
-Specifies the filename to be used for the persistent history of KoD
+Specifies the filename to be used for the persistent history of KoD
responses received from servers. The default is
-/var/db/ntp-kod.
-.TP
-.BR \-k " \fIfile\-name\fP, " \-\-keyfile "=" \fIfile\-name\fP
+/var/db/ntp-kod .
+.It \-k " \fIfile\-name\fP, " \-\-keyfile "=" \fIfile\-name\fP
Look in this file for the key specified with -a.
.sp
-This option specifies the keyfile. SNTP will search for the key specified with -a keyno in this
+This option specifies the keyfile.
+SNTP will search for the key specified with -a keyno in this
file. Key files follow the following format:
keyid keytype key
Where keyid is a number identifying this key
A Key in a 1-to-8 character ASCII string.
M Key in a 1-to-8 character ASCII string using the MD5 authentication scheme.
For more information see ntp.keys(5).
-.TP
-.BR \-l " \fIfile\-name\fP, " \-\-filelog "=" \fIfile\-name\fP
+.It \-l " \fIfile\-name\fP, " \-\-filelog "=" \fIfile\-name\fP
Log to specified logfile.
.sp
This option causes the client to write log messages to the specified
logfile.
-.TP
-.BR \-M " \fInumber\fP, " \-\-steplimit "=" \fInumber\fP
+.It \-M " \fInumber\fP, " \-\-steplimit "=" \fInumber\fP
Adjustments less than steplimit msec will be slewed..
This option takes an integer number as its argument.
-The value of \fInumber\fP is constrained to being:
+The value of \fInumber\fP is constrained to being:
.in +4
.nf
.na
.fi
.in -4
.sp
-If the time adjustment is less than steplimit milliseconds, slew the amount using adjtime(). Otherwise, step the correction using settimeofday().
-.TP
-.BR \-o " \fInumber\fP, " \-\-ntpversion "=" \fInumber\fP
+If the time adjustment is less than steplimit milliseconds, slew the
+amount using adjtime(). Otherwise, step the correction using
+settimeofday().
+.It \-o " \fInumber\fP, " \-\-ntpversion "=" \fInumber\fP
Send <int> as our NTP version.
This option takes an integer number as its argument.
-The value of \fInumber\fP is constrained to being:
+The value of \fInumber\fP is constrained to being:
.in +4
.nf
.na
in the range 0 through 7
.fi
.in -4
-The default \fInumber\fP for this option is:
+The default \fInumber\fP for this option is:
.ti +4
4
.sp
When sending requests to a remote server, tell them we are running
NTP protocol version <ntpversion> .
-.TP
-.BR \-r ", " -\-usereservedport
+.It \-r ", " -\-usereservedport
Use the NTP Reserved Port (port 123).
.sp
-Use port 123, which is reserved for NTP, for our network communications.
-.TP
-.BR \-S ", " -\-step
+Use port 123, which is reserved for NTP, for our network
+communications.
+.It \-S ", " -\-step
OK to 'step' the time with settimeofday().
.sp
-.TP
-.BR \-s ", " -\-slew
+.It \-s ", " -\-slew
OK to 'slew' the time with adjtime().
.sp
-.TP
-.BR \-u " \fIseconds\fP, " \-\-uctimeout "=" \fIseconds\fP
+.It \-u " \fIseconds\fP, " \-\-uctimeout "=" \fIseconds\fP
The number of seconds to wait for unicast responses.
This option takes an integer number as its argument.
-The default \fIseconds\fP for this option is:
+The default \fIseconds\fP for this option is:
.ti +4
5
.sp
When waiting for a unicast reply, SNTP will wait the number
of seconds specified before giving up. Default 5 seconds.
-.TP
-.BR \-\-wait, " \fB\-\-no\-wait\fP"
+.It \-\-wait, " \fB\-\-no\-wait\fP"
Wait for pending replies (if not setting the time).
-The \fIno\-wait\fP form will disable the option.
+The \fIno\-wait\fP form will disable the option.
This option is enabled by default.
.sp
If we are not setting the time, wait for all pending responses.
-.TP
-.BR \-? , " \-\-help"
+.It \-? , " \-\-help"
Display usage information and exit.
-.TP
-.BR \-! , " \-\-more-help"
+.It \-! , " \-\-more-help"
Pass the extended usage information through a pager.
-.TP
-.BR \-> " [\fIrcfile\fP]," " \-\-save-opts" "[=\fIrcfile\fP]"
-Save the option state to \fIrcfile\fP. The default is the \fIlast\fP
-configuration file listed in the \fBOPTION PRESETS\fP section, below.
-.TP
-.BR \-< " \fIrcfile\fP," " \-\-load-opts" "=\fIrcfile\fP," " \-\-no-load-opts"
-Load options from \fIrcfile\fP.
-The \fIno-load-opts\fP form will disable the loading
-of earlier RC/INI files. \fI\-\-no-load-opts\fP is handled early,
+.It \-> " [\fIrcfile\fP]," " \-\-save-opts" "[=\fIrcfile\fP]"
+Save the option state to \fIrcfile\fP. The default is the \fIlast\fP
+configuration file listed in the \fBOPTION PRESETS\fP section, below.
+.It \-< " \fIrcfile\fP," " \-\-load-opts" "=\fIrcfile\fP," " \-\-no-load-opts"
+Load options from \fIrcfile\fP.
+The \fIno-load-opts\fP form will disable the loading
+of earlier RC/INI files. \fI\-\-no-load-opts\fP is handled early,
out of order.
-.TP
-.BR \- " [{\fIv|c|n\fP}]," " \-\-version" "[=\fI{v|c|n}\fP]"
+.It \- " [{\fIv|c|n\fP}]," " \-\-version" "[=\fI{v|c|n}\fP]"
Output version of program and exit. The default mode is `v', a simple
version. The `c' mode will print copyright information and `n' will
print the full copyright notice.
-.SH "OPTION PRESETS"
-Any option that is not marked as \fInot presettable\fP may be preset
+.El
+.Sh "OPTION PRESETS"
+Any option that is not marked as \fInot presettable\fP may be preset
by loading values from configuration ("RC" or ".INI") file(s) and values from
environment variables named:
.nf
- \fBSNTP_<option-name>\fP or \fBSNTP\fP
+ \fBSNTP_<option-name>\fP or \fBSNTP\fP
.fi
.ad
The environmental presets take precedence (are processed later than)
the configuration files.
-The \fIhomerc\fP files are "\fI$HOME\fP", and "\fI.\fP".
-If any of these are directories, then the file \fI.ntprc\fP
+The \fIhomerc\fP files are "\fI$HOME\fP", and "\fI.\fP".
+If any of these are directories, then the file \fI.ntprc\fP
is searched for within those directories.
-.SH "EXIT STATUS"
+.Sh "EXIT STATUS"
One of the following exit values will be returned:
-.TP
-.BR 0
+.Bl -tag
+.It 0
Successful program execution.
-.TP
-.BR 1
+.It 1
The operation failed or the command syntax was not valid.
-.SH ENVIRONMENT
-See \fBOPTION PRESETS\fP for configuration environment variables.
-.SH FILES
-See \fBOPTION PRESETS\fP for configuration files.
-.SH AUTHOR
+.El
+.Sh USAGE
+The simplest use of this program is as an unprivileged command to check the
+current time and error in the local clock. For example:
+.Bl -tag
+.It
+.El
+.Nm sntp ntpserver.somewhere
+With suitable privilege, it can be run as a command or in a
+.Em cron
+job to reset the local clock from a reliable server, like the
+.Em ntpdate
+and
+.Em rdate
+commands. For example:
+.Bl -tag
+.It
+.El
+.Nm sntp -a ntpserver.somewhere
+The program returns a zero exit
+status for success, and a non-zero one otherwise.
+Please report bugs to http://bugs.ntp.org .
+.Sh ENVIRONMENT
+See \fBOPTION PRESETS\fP for configuration environment variables.
+.Sh FILES
+See \fBOPTION PRESETS\fP for configuration files.
+.Sh AUTHOR
David L. Mills and/or others
.br
Please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
-.PP
+.Pp
.nf
.na
see html/copyright.html
.fi
.ad
-.PP
-This manual page was \fIAutoGen\fP-erated from the \fBsntp\fP
+.Pp
+This manual page was \fIAutoGen\fP-erated from the \fBsntp\fP
option definitions.
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.7p116 of <code>sntp</code>.
+ <p>This document applies to version 4.2.7p165 of <code>sntp</code>.
<p>The program implements the SNTP protocol as defined by RFC 5905, the NTPv4
IETF specification.
<p><a name="index-sntp-usage-3"></a>
This is the automatically generated usage text for sntp:
-<pre class="example">sntp - standard Simple Network Time Protocol program - Ver. 4.2.7p164
+<pre class="example">sntp - standard Simple Network Time Protocol program - Ver. 4.2.7p165
USAGE: sntp [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \
[ hostname-or-IP ...]
Flg Arg Option-Name Description
- -d no debug-level Increase output debug message level
- - may appear multiple times
- -D Str set-debug-level Set the output debug message level
- - may appear multiple times
-4 no ipv4 Force IPv4 DNS name resolution
- prohibits these options:
ipv6
- may appear multiple times
-c Str concurrent Concurrent query all IPs returned for host-name
- may appear multiple times
+ -d no debug-level Increase output debug message level
+ - may appear multiple times
+ -D Str set-debug-level Set the output debug message level
+ - may appear multiple times
-h Num headspace The gap (in milliseconds) between time requests
-K Fil kod KoD history filename
-k Fil keyfile Look in this file for the key specified with -a
<p><a name="index-sntp_002dauthentication-4"></a>
This is the “enable authentication with the key auth-keynumber” option.
-This option enables authentication using the key specified in this option's argument.
-The argument of this option is the keyid, a number specified in the keyfile as this
-key's identifier. See the keyfile option (-k) for more details.
+This option enables authentication using the key specified in this
+option's argument. The argument of this option is the keyid, a
+number specified in the keyfile as this key's identifier. See the
+keyfile option (-k) for more details.
<div class="node">
<p><hr>
<p>Requests from an NTP "client" to a "server" should never be sent
more rapidly than one every 2 seconds. By default, any IPs returned
as part of a DNS lookup are assumed to be for a single instance of
-ntpd, and therefore sntp will send queries to these IPs one after
+ntpd, and therefore sntp will send queries to these IPs one after
another, with a 2-second gap in between each query.
- <p>The -c or –concurrent flag says that any IPs returned for the
-DNS lookup of the supplied host-name are on different machines,
-so we can send concurrent queries.
+ <p>The -c or –concurrent flag says that any IPs returned for the DNS
+lookup of the supplied host-name are on different machines, so we
+can send concurrent queries.
<div class="node">
<p><hr>
<p><a name="index-sntp_002dkeyfile-13"></a>
This is the “look in this file for the key specified with -a” option.
-This option specifies the keyfile. SNTP will search for the key specified with -a keyno in this
+This option specifies the keyfile.
+SNTP will search for the key specified with -a keyno in this
file. Key files follow the following format:
<p>keyid keytype key
<p><a name="index-sntp_002dkod-14"></a>
This is the “kod history filename” option.
-Specifies the filename to be used for the persistent history of KoD
+Specifies the filename to be used for the persistent history of KoD
responses received from servers. The default is
-/var/db/ntp-kod.
+/var/db/ntp-kod .
<div class="node">
<p><hr>
<p><a name="index-sntp_002dsteplimit-19"></a>
This is the “adjustments less than steplimit msec will be slewed.” option.
-If the time adjustment is less than steplimit milliseconds, slew the amount using adjtime(). Otherwise, step the correction using settimeofday().
+If the time adjustment is less than steplimit milliseconds, slew the
+amount using adjtime(). Otherwise, step the correction using
+settimeofday().
<div class="node">
<p><hr>
<p><a name="index-sntp_002dusereservedport-21"></a>
This is the “use the ntp reserved port (port 123)” option.
-Use port 123, which is reserved for NTP, for our network communications.
+Use port 123, which is reserved for NTP, for our network
+communications.
<div class="node">
<p><hr>
/*
* EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.c)
*
- * It has been AutoGen-ed May 11, 2011 at 12:47:49 AM by AutoGen 5.11.9pre10
+ * It has been AutoGen-ed May 11, 2011 at 11:32:43 AM by AutoGen 5.11.9
* From the definitions ntp-keygen-opts.def
* and the template file options
*
/* TRANSLATORS: choose the translation for option names wisely because you
cannot ever change your mind. */
static char const zCopyright[52] =
-"ntp-keygen (ntp) 4.2.7p164\n\
+"ntp-keygen (ntp) 4.2.7p165\n\
see html/copyright.html\n";
-static char const zCopyrightNotice[25] =
+static char const zLicenseDescrip[25] =
"see html/copyright.html\n";
extern tUsageProc optionUsage;
*/
static char const zPROGNAME[11] = "NTP_KEYGEN";
static char const zUsageTitle[116] =
-"ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p164\n\
+"ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p165\n\
USAGE: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n";
static char const zRcName[7] = ".ntprc";
static char const * const apzHomeList[3] = {
+ OPTPROC_MISUSE ),
0, NULL, /* current option index, current option */
NULL, NULL, zPROGNAME,
- zRcName, zCopyright, zCopyrightNotice,
+ zRcName, zCopyright, zLicenseDescrip,
zFullVersion, apzHomeList, zUsageTitle,
zExplain, zDetail, optDesc,
zBugsAddr, /* address to send bugs to */
/*
* EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.h)
*
- * It has been AutoGen-ed May 11, 2011 at 12:47:49 AM by AutoGen 5.11.9pre10
+ * It has been AutoGen-ed May 11, 2011 at 11:32:42 AM by AutoGen 5.11.9
* From the definitions ntp-keygen-opts.def
* and the template file options
*
} teOptIndex;
#define OPTION_CT 24
-#define NTP_KEYGEN_VERSION "4.2.7p164"
-#define NTP_KEYGEN_FULL_VERSION "ntp-keygen (ntp) 4.2.7p164"
+#define NTP_KEYGEN_VERSION "4.2.7p165"
+#define NTP_KEYGEN_FULL_VERSION "ntp-keygen (ntp) 4.2.7p165"
/*
* Interface defines for all options. Replace "n" with the UPPER_CASED
#
# EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.texi)
#
-# It has been AutoGen-ed May 11, 2011 at 12:48:00 AM by AutoGen 5.11.9pre10
+# It has been AutoGen-ed May 11, 2011 at 11:33:08 AM by AutoGen 5.11.9
# From the definitions ntp-keygen-opts.def
# and the template file aginfo.tpl
@end ignore
@exampleindent 0
@example
-ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p164
+ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.7p165
USAGE: ntp-keygen [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
Flg Arg Option-Name Description
-c Str certificate certificate scheme
-.TH NTP-KEYGEN 1 2011-05-11 "(ntp 4.2.7p164)" "Programmer's Manual"
+.TH NTP-KEYGEN 1 2011-05-11 "(ntp 4.2.7p165)" "Programmer's Manual"
.\" EDIT THIS FILE WITH CAUTION (ntp-keygen.1)
.\"
-.\" It has been AutoGen-ed May 11, 2011 at 12:47:59 AM by AutoGen 5.11.9pre10
+.\" It has been AutoGen-ed May 11, 2011 at 11:33:06 AM by AutoGen 5.11.9
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agman1.tpl
.\"