/*
* EDIT THIS FILE WITH CAUTION (sntp-opts.c)
*
- * It has been AutoGen-ed August 4, 2011 at 04:46:05 AM by AutoGen 5.12
+ * It has been AutoGen-ed August 4, 2011 at 03:43:18 PM by AutoGen 5.11.10pre10
* From the definitions sntp-opts.def
* and the template file options
*
static char const zSyslog_Name[] = "syslog";
static const int
aSyslogCantList[] = {
- INDEX_OPT_FILELOG, NO_EQUIVALENT };
+ INDEX_OPT_LOGFILE, NO_EQUIVALENT };
#define SYSLOG_FLAGS (OPTST_DISABLED)
/*
- * Filelog option description with
+ * Logfile option description with
* "Must also have options" and "Incompatible options":
*/
-static char const zFilelogText[] =
+static char const zLogfileText[] =
"Log to specified logfile";
-static char const zFilelog_NAME[] = "FILELOG";
-static char const zFilelog_Name[] = "filelog";
+static char const zLogfile_NAME[] = "LOGFILE";
+static char const zLogfile_Name[] = "logfile";
static const int
- aFilelogCantList[] = {
+ aLogfileCantList[] = {
INDEX_OPT_SYSLOG, NO_EQUIVALENT };
-#define FILELOG_FLAGS (OPTST_DISABLED \
+#define LOGFILE_FLAGS (OPTST_DISABLED \
| OPTST_SET_ARGTYPE(OPARG_TYPE_STRING))
/*
/* desc, NAME, name */ zSyslogText, zSyslog_NAME, zSyslog_Name,
/* disablement strs */ NULL, NULL },
- { /* entry idx, value */ 5, VALUE_OPT_FILELOG,
- /* equiv idx, value */ 5, VALUE_OPT_FILELOG,
+ { /* entry idx, value */ 5, VALUE_OPT_LOGFILE,
+ /* equiv idx, value */ 5, VALUE_OPT_LOGFILE,
/* equivalenced to */ NO_EQUIVALENT,
/* min, max, act ct */ 0, 1, 0,
- /* opt state flags */ FILELOG_FLAGS, 0,
+ /* opt state flags */ LOGFILE_FLAGS, 0,
/* last opt argumnt */ { NULL },
/* arg list/cookie */ NULL,
- /* must/cannot opts */ NULL, aFilelogCantList,
+ /* must/cannot opts */ NULL, aLogfileCantList,
/* option proc */ NULL,
- /* desc, NAME, name */ zFilelogText, zFilelog_NAME, zFilelog_Name,
+ /* desc, NAME, name */ zLogfileText, zLogfile_NAME, zLogfile_Name,
/* disablement strs */ NULL, NULL },
{ /* entry idx, value */ 6, VALUE_OPT_SETTOD,
* Define the Sntp Option Environment
*/
static char const zPROGNAME[5] = "SNTP";
-static char const zUsageTitle[125] =
-"sntp - standard SNTP program - Ver. 4.2.6p4-RC2\n\
-USAGE: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... hostname-or-IP ...\n";
+static char const zUsageTitle[156] =
+"sntp - standard Simple Network Time Protocol program - Ver. 4.2.6p4-RC2\n\
+USAGE: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
+\t\t[ hostname-or-IP ...]\n";
static char const zRcName[7] = ".ntprc";
static char const * const apzHomeList[3] = {
"$HOME",
NTP or SNTP server and either display the time or set the local system's\n\
time (given suitable privilege).\n\n\
It can be run interactively from the command line or as a cron job.\n\n\
-NTP and SNTP are defined by RFC 5905, which obsoletes RFC 4330 and RFC\n\
-1305.\n";
+NTP and SNTP are defined by RFC 5905, which obsoletes RFC 4330 and\n\
+RFC 1305.\n";
static char const zFullVersion[] = SNTP_FULL_VERSION;
/* extracted from optcode.tlib near line 515 */
+ OPTPROC_LONGOPT
+ OPTPROC_NO_REQ_OPT
+ OPTPROC_ENVIRON
- + OPTPROC_ARGS_REQ
+ OPTPROC_MISUSE ),
0, NULL, /* current option index, current option */
NULL, NULL, zPROGNAME,
@node sntp Invocation
@section Invoking sntp
@pindex sntp
-@cindex standard SNTP program
+@cindex standard Simple Network Time Protocol program
@ignore
#
# EDIT THIS FILE WITH CAUTION (sntp-opts.texi)
#
-# It has been AutoGen-ed August 4, 2011 at 04:46:31 AM by AutoGen 5.12
+# It has been AutoGen-ed August 4, 2011 at 03:43:21 PM by AutoGen 5.11.10pre10
# From the definitions sntp-opts.def
# and the template file aginfo.tpl
@end ignore
* sntp adjtime:: adjtime option (-j)
* sntp authentication:: authentication option (-a)
* sntp broadcast:: broadcast option (-b)
-* sntp filelog:: filelog option (-l)
* sntp ipv4:: ipv4 option (-4)
* sntp ipv6:: ipv6 option (-6)
* sntp keyfile:: keyfile option (-k)
* sntp kod:: kod option (-K)
+* sntp logfile:: logfile option (-l)
* sntp normalverbose:: normalverbose option (-d)
* sntp settod:: settod option (-s)
* sntp syslog:: syslog option (-p)
@exampleindent 0
@example
-sntp - standard SNTP program - Ver. 4.2.6p4-RC2
-USAGE: sntp [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... hostname-or-IP ...
+sntp - standard Simple Network Time Protocol program - Ver. 4.2.6p4-RC2
+USAGE: sntp [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... \
+ [ hostname-or-IP ...]
Flg Arg Option-Name Description
-4 no ipv4 Force IPv4 DNS name resolution
- prohibits these options:
-K Str kod KoD history filename
-p no syslog Logging with syslog
- prohibits these options:
- filelog
- -l Str filelog Log to specified logfile
+ logfile
+ -l Str logfile Log to specified logfile
- prohibits these options:
syslog
-s no settod Set (step) the time with settimeofday()
It can be run interactively from the command line or as a cron job.
-NTP and SNTP are defined by RFC 5905, which obsoletes RFC 4330 and RFC
-1305.
+NTP and SNTP are defined by RFC 5905, which obsoletes RFC 4330 and
+RFC 1305.
please send bug reports to: http://bugs.ntp.org, bugs@@ntp.org
@end example
for NTP broadcasts. The default maximum wait time,
68 seconds, can be modified with -t.
-@node sntp filelog
-@subsection filelog option (-l)
-@cindex sntp-filelog
-
-This is the ``log to specified logfile'' option.
-
-This option has some usage constraints. It:
-@itemize @bullet
-@item
-must not appear in combination with any of the following options:
-syslog.
-@end itemize
-
-This option causes the client to write log messages to the specified
-logfile.
-
@node sntp ipv4
@subsection ipv4 option (-4)
@cindex sntp-ipv4
ipv6.
@end itemize
-Force DNS resolution of following host names on the command line
+Force DNS resolution of the following host names on the command line
to the IPv4 namespace.
@node sntp ipv6
ipv4.
@end itemize
-Force DNS resolution of following host names on the command line
+Force DNS resolution of the following host names on the command line
to the IPv6 namespace.
@node sntp keyfile
@cindex sntp-kod
This is the ``kod history filename'' option.
-Modifies the filename to be used to persist the history of KoD
+Specifies the filename to be used to persist the history of KoD
responses received from servers. The default is
/var/db/ntp-kod.
+@node sntp logfile
+@subsection logfile option (-l)
+@cindex sntp-logfile
+
+This is the ``log to specified logfile'' option.
+
+This option has some usage constraints. It:
+@itemize @bullet
+@item
+must not appear in combination with any of the following options:
+syslog.
+@end itemize
+
+This option causes the client to write log messages to the specified
+logfile.
+
@node sntp normalverbose
@subsection normalverbose option (-d)
@cindex sntp-normalverbose
@itemize @bullet
@item
must not appear in combination with any of the following options:
-filelog.
+logfile.
@end itemize
When this option is set all logging will be done using syslog.
<title>Sntp User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Sntp User's Manual">
-<meta name="generator" content="makeinfo 4.7">
+<meta name="generator" content="makeinfo 4.13">
<link title="Top" rel="top" href="#Top">
<link href="http://www.gnu.org/software/texinfo/" rel="generator-home" title="Texinfo Homepage">
<meta http-equiv="Content-Style-Type" content="text/css">
pre.smallformat { font-family:inherit; font-size:smaller }
pre.smallexample { font-size:smaller }
pre.smalllisp { font-size:smaller }
- span.sc { font-variant:small-caps }
- span.roman { font-family: serif; font-weight: normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family:serif; font-weight:normal; }
+ span.sansserif { font-family:sans-serif; font-weight:normal; }
--></style>
</head>
<body>
<h1 class="settitle">Sntp User's Manual</h1>
<div class="node">
+<a name="Top"></a>
<p><hr>
-
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#sntp-Description">sntp Description</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-Description">sntp Description</a>,
Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-<br>
+
</div>
<h2 class="unnumbered">Simple Network Time Protocol User Manual</h2>
</ul>
<div class="node">
-<p><hr>
<a name="sntp-Description"></a>
-<br>
+<p><hr>
+
+
</div>
<!-- node-name, next, previous, up -->
error bound of the system clock relative to the server clock.
<div class="node">
-<p><hr>
<a name="sntp-Invocation"></a>
-<br>
+<p><hr>
+
+
</div>
<h3 class="section">Invoking sntp</h3>
-<p><a name="index-sntp-1"></a><a name="index-standard-SNTP-program-2"></a>
+<p><a name="index-sntp-1"></a><a name="index-standard-Simple-Network-Time-Protocol-program-2"></a>
<code>sntp</code>
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
seconds.
<p>This section was generated by <strong>AutoGen</strong>,
-the aginfo template and the option descriptions for the <span class="command">sntp</span> program. It documents the <span class="command">sntp</span> usage text and option meanings.
+the aginfo template and the option descriptions for the <samp><span class="command">sntp</span></samp> program. It documents the <samp><span class="command">sntp</span></samp> usage text and option meanings.
<p>This software is released under a specialized copyright license.
<li><a accesskey="2" href="#sntp-adjtime">sntp adjtime</a>: adjtime option (-j)
<li><a accesskey="3" href="#sntp-authentication">sntp authentication</a>: authentication option (-a)
<li><a accesskey="4" href="#sntp-broadcast">sntp broadcast</a>: broadcast option (-b)
-<li><a accesskey="5" href="#sntp-filelog">sntp filelog</a>: filelog option (-l)
-<li><a accesskey="6" href="#sntp-ipv4">sntp ipv4</a>: ipv4 option (-4)
-<li><a accesskey="7" href="#sntp-ipv6">sntp ipv6</a>: ipv6 option (-6)
-<li><a accesskey="8" href="#sntp-keyfile">sntp keyfile</a>: keyfile option (-k)
-<li><a accesskey="9" href="#sntp-kod">sntp kod</a>: kod option (-K)
+<li><a accesskey="5" href="#sntp-ipv4">sntp ipv4</a>: ipv4 option (-4)
+<li><a accesskey="6" href="#sntp-ipv6">sntp ipv6</a>: ipv6 option (-6)
+<li><a accesskey="7" href="#sntp-keyfile">sntp keyfile</a>: keyfile option (-k)
+<li><a accesskey="8" href="#sntp-kod">sntp kod</a>: kod option (-K)
+<li><a accesskey="9" href="#sntp-logfile">sntp logfile</a>: logfile option (-l)
<li><a href="#sntp-normalverbose">sntp normalverbose</a>: normalverbose option (-d)
<li><a href="#sntp-settod">sntp settod</a>: settod option (-s)
<li><a href="#sntp-syslog">sntp syslog</a>: syslog option (-p)
</ul>
<div class="node">
+<a name="sntp-usage"></a>
<p><hr>
-
<a name="sntp-usage"></a>Next: <a rel="next" accesskey="n" href="#sntp-adjtime">sntp adjtime</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-adjtime">sntp adjtime</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-<br>
+
</div>
<h4 class="subsection">sntp usage help (-?)</h4>
<p><a name="index-sntp-usage-3"></a>
This is the automatically generated usage text for sntp:
-<pre class="example">sntp - standard SNTP program - Ver. 4.2.6p4-RC2
-USAGE: sntp [ -<flag> [<val>] | --<name>[{=| }<val>] ]... hostname-or-IP ...
+<pre class="example">sntp - standard Simple Network Time Protocol program - Ver. 4.2.6p4-RC2
+USAGE: sntp [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \
+ [ hostname-or-IP ...]
Flg Arg Option-Name Description
-4 no ipv4 Force IPv4 DNS name resolution
- prohibits these options:
-K Str kod KoD history filename
-p no syslog Logging with syslog
- prohibits these options:
- filelog
- -l Str filelog Log to specified logfile
+ logfile
+ -l Str logfile Log to specified logfile
- prohibits these options:
syslog
-s no settod Set (step) the time with settimeofday()
It can be run interactively from the command line or as a cron job.
-NTP and SNTP are defined by RFC 5905, which obsoletes RFC 4330 and RFC
-1305.
+NTP and SNTP are defined by RFC 5905, which obsoletes RFC 4330 and
+RFC 1305.
please send bug reports to: http://bugs.ntp.org, bugs@ntp.org
</pre>
<div class="node">
+<a name="sntp-adjtime"></a>
<p><hr>
-
<a name="sntp-adjtime"></a>Next: <a rel="next" accesskey="n" href="#sntp-authentication">sntp authentication</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-authentication">sntp authentication</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-usage">sntp usage</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-<br>
+
</div>
<h4 class="subsection">adjtime option (-j)</h4>
</ul>
<div class="node">
+<a name="sntp-authentication"></a>
<p><hr>
-
<a name="sntp-authentication"></a>Next: <a rel="next" accesskey="n" href="#sntp-broadcast">sntp broadcast</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-broadcast">sntp broadcast</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-adjtime">sntp adjtime</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-<br>
+
</div>
<h4 class="subsection">authentication option (-a)</h4>
key's identifier. See the keyfile option (-k) for more details.
<div class="node">
+<a name="sntp-broadcast"></a>
<p><hr>
-<a name="sntp-broadcast"></a>Next: <a rel="next" accesskey="n" href="#sntp-filelog">sntp filelog</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-ipv4">sntp ipv4</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-authentication">sntp authentication</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-<br>
+
</div>
<h4 class="subsection">broadcast option (-b)</h4>
68 seconds, can be modified with -t.
<div class="node">
+<a name="sntp-ipv4"></a>
<p><hr>
-<a name="sntp-filelog"></a>Next: <a rel="next" accesskey="n" href="#sntp-ipv4">sntp ipv4</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-ipv6">sntp ipv6</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-broadcast">sntp broadcast</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-<br>
-</div>
-
-<h4 class="subsection">filelog option (-l)</h4>
-<p><a name="index-sntp_002dfilelog-7"></a>
-This is the “log to specified logfile” option.
-
- <p>This option has some usage constraints. It:
- <ul>
-<li>must not appear in combination with any of the following options:
-syslog.
-</ul>
-
- <p>This option causes the client to write log messages to the specified
-logfile.
-
-<div class="node">
-<p><hr>
-<a name="sntp-ipv4"></a>Next: <a rel="next" accesskey="n" href="#sntp-ipv6">sntp ipv6</a>,
-Previous: <a rel="previous" accesskey="p" href="#sntp-filelog">sntp filelog</a>,
-Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-<br>
</div>
<h4 class="subsection">ipv4 option (-4)</h4>
-<p><a name="index-sntp_002dipv4-8"></a>
+<p><a name="index-sntp_002dipv4-7"></a>
This is the “force ipv4 dns name resolution” option.
<p>This option has some usage constraints. It:
ipv6.
</ul>
- <p>Force DNS resolution of following host names on the command line
+ <p>Force DNS resolution of the following host names on the command line
to the IPv4 namespace.
<div class="node">
+<a name="sntp-ipv6"></a>
<p><hr>
-
<a name="sntp-ipv6"></a>Next: <a rel="next" accesskey="n" href="#sntp-keyfile">sntp keyfile</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-keyfile">sntp keyfile</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-ipv4">sntp ipv4</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-<br>
+
</div>
<h4 class="subsection">ipv6 option (-6)</h4>
-<p><a name="index-sntp_002dipv6-9"></a>
+<p><a name="index-sntp_002dipv6-8"></a>
This is the “force ipv6 dns name resolution” option.
<p>This option has some usage constraints. It:
ipv4.
</ul>
- <p>Force DNS resolution of following host names on the command line
+ <p>Force DNS resolution of the following host names on the command line
to the IPv6 namespace.
<div class="node">
+<a name="sntp-keyfile"></a>
<p><hr>
-
<a name="sntp-keyfile"></a>Next: <a rel="next" accesskey="n" href="#sntp-kod">sntp kod</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-kod">sntp kod</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-ipv6">sntp ipv6</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-<br>
+
</div>
<h4 class="subsection">keyfile option (-k)</h4>
-<p><a name="index-sntp_002dkeyfile-10"></a>
+<p><a name="index-sntp_002dkeyfile-9"></a>
This is the “specify a keyfile. sntp will 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
file. Key files follow the following format:
<p>For more information see ntp.keys(5).
<div class="node">
+<a name="sntp-kod"></a>
<p><hr>
-<a name="sntp-kod"></a>Next: <a rel="next" accesskey="n" href="#sntp-normalverbose">sntp normalverbose</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-logfile">sntp logfile</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-keyfile">sntp keyfile</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-<br>
+
</div>
<h4 class="subsection">kod option (-K)</h4>
-<p><a name="index-sntp_002dkod-11"></a>
+<p><a name="index-sntp_002dkod-10"></a>
This is the “kod history filename” option.
-Modifies the filename to be used to persist the history of KoD
+Specifies the filename to be used to persist the history of KoD
responses received from servers. The default is
/var/db/ntp-kod.
<div class="node">
+<a name="sntp-logfile"></a>
<p><hr>
-<a name="sntp-normalverbose"></a>Next: <a rel="next" accesskey="n" href="#sntp-settod">sntp settod</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-normalverbose">sntp normalverbose</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-kod">sntp kod</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-<br>
+
+</div>
+
+<h4 class="subsection">logfile option (-l)</h4>
+
+<p><a name="index-sntp_002dlogfile-11"></a>
+This is the “log to specified logfile” option.
+
+ <p>This option has some usage constraints. It:
+ <ul>
+<li>must not appear in combination with any of the following options:
+syslog.
+</ul>
+
+ <p>This option causes the client to write log messages to the specified
+logfile.
+
+<div class="node">
+<a name="sntp-normalverbose"></a>
+<p><hr>
+Next: <a rel="next" accesskey="n" href="#sntp-settod">sntp settod</a>,
+Previous: <a rel="previous" accesskey="p" href="#sntp-logfile">sntp logfile</a>,
+Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
+
</div>
<h4 class="subsection">normalverbose option (-d)</h4>
suspected problem with the server, network or the source.
<div class="node">
+<a name="sntp-settod"></a>
<p><hr>
-
<a name="sntp-settod"></a>Next: <a rel="next" accesskey="n" href="#sntp-syslog">sntp syslog</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-syslog">sntp syslog</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-normalverbose">sntp normalverbose</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-<br>
+
</div>
<h4 class="subsection">settod option (-s)</h4>
</ul>
<div class="node">
+<a name="sntp-syslog"></a>
<p><hr>
-
<a name="sntp-syslog"></a>Next: <a rel="next" accesskey="n" href="#sntp-timeout">sntp timeout</a>,
+Next: <a rel="next" accesskey="n" href="#sntp-timeout">sntp timeout</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-settod">sntp settod</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-<br>
+
</div>
<h4 class="subsection">syslog option (-p)</h4>
<p>This option has some usage constraints. It:
<ul>
<li>must not appear in combination with any of the following options:
-filelog.
+logfile.
</ul>
<p>When this option is set all logging will be done using syslog.
<div class="node">
+<a name="sntp-timeout"></a>
<p><hr>
-
<a name="sntp-timeout"></a>Previous: <a rel="previous" accesskey="p" href="#sntp-syslog">sntp syslog</a>,
+Previous: <a rel="previous" accesskey="p" href="#sntp-syslog">sntp syslog</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-<br>
+
</div>
<h4 class="subsection">timeout option (-t)</h4>
of seconds specified before giving up. Default 68 seconds.
<div class="node">
-<p><hr>
<a name="Usage"></a>
-<br>
+<p><hr>
+
+
</div>
<!-- node-name, next, previous, up -->
projects / thirdparty / ntp.git / commitdiff
