---
+(4.2.8p12) 2018/08/14 Released by Harlan Stenn <stenn@ntp.org>
* [Sec 3505] CVE-2018-12327 - Arbitrary Code Execution Vulnerability
- fixed stack buffer overflow in the openhost() command-line call
#
# EDIT THIS FILE WITH CAUTION (invoke-ntp.conf.texi)
#
-# It has been AutoGen-ed July 24, 2018 at 09:13:24 AM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:29:07 AM by AutoGen 5.18.5
# 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 July 24, 2018 at 07:23:49 AM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:29:10 AM by AutoGen 5.18.5
# 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 27, 2018 at 05:14:39 PM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:29:12 AM by AutoGen 5.18.5
# 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.8p11
+ntpd - NTP daemon program - Ver. 4.2.8p12
Usage: ntpd [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... \
[ <server1> ... <serverN> ]
Flg Arg Option-Name Description
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntp.conf 5man "24 Jul 2018" "4.2.8p11" "File Formats"
+.TH ntp.conf 5man "14 Aug 2018" "4.2.8p12" "File Formats"
.\"
-.\" EDIT THIS FILE WITH CAUTION (in-mem file)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-2caiQA/ag-bdaaPA)
.\"
-.\" It has been AutoGen-ed July 24, 2018 at 09:13:25 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:28:54 AM by AutoGen 5.18.5
.\" From the definitions ntp.conf.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd July 24 2018
+.Dd August 14 2018
.Dt NTP_CONF 5mdoc File Formats
.Os
.\" EDIT THIS FILE WITH CAUTION (ntp.mdoc)
.\"
-.\" It has been AutoGen-ed July 24, 2018 at 09:13:21 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:29:15 AM by AutoGen 5.18.5
.\" From the definitions ntp.conf.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<title>NTP Configuration File User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="NTP Configuration File User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<h1 class="settitle">NTP Configuration File User's Manual</h1>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002econf-Description">ntp.conf Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntp_002econf-Description">ntp.conf 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">NTP's Configuration File User Manual</h2>
<p>This document describes the configuration file for the NTP Project's
<code>ntpd</code> program.
- <p>This document applies to version 4.2.8p11 of <code>ntp.conf</code>.
+ <p>This document applies to version 4.2.8p12 of <code>ntp.conf</code>.
<div class="shortcontents">
<h2>Short Contents</h2>
</ul>
<div class="node">
-<a name="ntp.conf-Description"></a>
-<a name="ntp_002econf-Description"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#Top">Top</a>,
+
<a name="ntp_002econf-Description"></a>Previous: <a rel="previous" accesskey="p" href="#Top">Top</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
by default <code>ntp.conf</code>.
<div class="node">
-<a name="ntp.conf-Notes"></a>
-<a name="ntp_002econf-Notes"></a>
<p><hr>
-
-
+<a name="ntp_002econf-Notes"></a>
+<br>
</div>
<h3 class="section">Notes about ntp.conf</h3>
daemon in order to specify the synchronization sources,
modes and other related information.
Usually, it is installed in the
-<samp><span class="file">/etc</span></samp>
+<span class="file">/etc</span>
directory,
but could be installed elsewhere
(see the daemon's
<span class="sc">unix</span>
configuration files.
Comments begin with a
-‘#’
+#
character and extend to the end of the line;
blank lines are ignored.
Configuration commands consist of an initial keyword
page
(available as part of the HTML documentation
provided in
-<samp><span class="file">/usr/share/doc/ntp</span></samp>)
+<span class="file">/usr/share/doc/ntp</span>)
contains an extended discussion of these options.
In addition to the discussion of general
<a href="#Configuration-Options">Configuration Options</a>,
<code>manycastclient</code>
commands.
<div class="node">
-<a name="Configuration-Support"></a>
<p><hr>
-
-
+<a name="Configuration-Support"></a>
+<br>
</div>
<h4 class="subsection">Configuration Support</h4>
<code>ntpdc(1ntpdcmdoc)</code>,
IPv6 addresses are automatically generated.
IPv6 addresses can be identified by the presence of colons
-“:”
+:
in the address field.
IPv6 addresses can be used almost everywhere where
IPv4 addresses can be used,
page
(available as part of the HTML documentation
provided in
-<samp><span class="file">/usr/share/doc/ntp</span></samp>).
+<span class="file">/usr/share/doc/ntp</span>).
<dl>
<dt><code>pool</code><dd>For type s addresses, this command mobilizes a persistent
client mode association with a number of remote servers.
page
(available as part of the HTML documentation
provided in
-<samp><span class="file">/usr/share/doc/ntp</span></samp>)
+<span class="file">/usr/share/doc/ntp</span>)
for further information.
<br><dt><code>true</code><dd>Forces the association to always survive the selection and clustering algorithms.
This option should almost certainly
is 5.
</dl>
<div class="node">
-<a name="Authentication-Support"></a>
<p><hr>
-
-
+<a name="Authentication-Support"></a>
+<br>
</div>
<h4 class="subsection">Authentication Support</h4>
Keys and
related information are specified in a key
file, usually called
-<samp><span class="file">ntp.keys</span></samp>,
+<span class="file">ntp.keys</span>,
which must be distributed and stored using
secure means beyond the scope of the NTP protocol itself.
Besides the keys used
in the
<code>keysdir</code>
command or default
-<samp><span class="file">/usr/local/etc</span></samp>.
+<span class="file">/usr/local/etc</span>.
Following are the subcommands:
<dl>
<dt><code>cert</code> <kbd>file</kbd><dd>Specifies the location of the required host public certificate file.
This overrides the link
-<samp><span class="file">ntpkey_cert_</span></samp><kbd>hostname</kbd>
+<span class="file">ntpkey_cert_</span><kbd>hostname</kbd>
in the keys directory.
<br><dt><code>gqpar</code> <kbd>file</kbd><dd>Specifies the location of the optional GQ parameters file.
This
overrides the link
-<samp><span class="file">ntpkey_gq_</span></samp><kbd>hostname</kbd>
+<span class="file">ntpkey_gq_</span><kbd>hostname</kbd>
in the keys directory.
<br><dt><code>host</code> <kbd>file</kbd><dd>Specifies the location of the required host key file.
This overrides
the link
-<samp><span class="file">ntpkey_key_</span></samp><kbd>hostname</kbd>
+<span class="file">ntpkey_key_</span><kbd>hostname</kbd>
in the keys directory.
<br><dt><code>iffpar</code> <kbd>file</kbd><dd>Specifies the location of the optional IFF parameters file.
This overrides the link
-<samp><span class="file">ntpkey_iff_</span></samp><kbd>hostname</kbd>
+<span class="file">ntpkey_iff_</span><kbd>hostname</kbd>
in the keys directory.
<br><dt><code>leap</code> <kbd>file</kbd><dd>Specifies the location of the optional leapsecond file.
This overrides the link
-<samp><span class="file">ntpkey_leap</span></samp>
+<span class="file">ntpkey_leap</span>
in the keys directory.
<br><dt><code>mvpar</code> <kbd>file</kbd><dd>Specifies the location of the optional MV parameters file.
This overrides the link
-<samp><span class="file">ntpkey_mv_</span></samp><kbd>hostname</kbd>
+<span class="file">ntpkey_mv_</span><kbd>hostname</kbd>
in the keys directory.
<br><dt><code>pw</code> <kbd>password</kbd><dd>Specifies the password to decrypt files containing private keys and
identity parameters.
<br><dt><code>sign</code> <kbd>file</kbd><dd>Specifies the location of the optional sign key file.
This overrides
the link
-<samp><span class="file">ntpkey_sign_</span></samp><kbd>hostname</kbd>
+<span class="file">ntpkey_sign_</span><kbd>hostname</kbd>
in the keys directory.
If this file is
not found, the host key is also the sign key.
<br><dt><code>keysdir</code> <kbd>path</kbd><dd>This command specifies the default directory path for
cryptographic keys, parameters and certificates.
The default is
-<samp><span class="file">/usr/local/etc/</span></samp>.
+<span class="file">/usr/local/etc/</span>.
<br><dt><code>requestkey</code> <kbd>key</kbd><dd>Specifies the key identifier to use with the
<code>ntpdc(1ntpdcmdoc)</code>
utility program, which uses a
The identity key is missing, corrupt or bogus.
</dl>
<div class="node">
-<a name="Monitoring-Support"></a>
<p><hr>
-
-
+<a name="Monitoring-Support"></a>
+<br>
</div>
<h4 class="subsection">Monitoring Support</h4>
supported.
Statistic files are managed using file generation sets
and scripts in the
-<samp><span class="file">./scripts</span></samp>
+<span class="file">./scripts</span>
directory of the source code distribution.
Using
these facilities and
received from a clock driver appends a line of the following form to
the file generation set named
<code>clockstats</code>:
-<pre class="verbatim"> 49213 525.624 127.127.4.1 93 226 00:08:29.606 D
+<pre class="verbatim">
+ 49213 525.624 127.127.4.1 93 226 00:08:29.606 D
</pre>
<p>The first two fields show the date (Modified Julian Day) and time
Each message received by the protocol module appends a line of the
following form to the file generation set named
<code>cryptostats</code>:
-<pre class="verbatim"> 49213 525.624 127.127.4.1 message
+<pre class="verbatim">
+ 49213 525.624 127.127.4.1 message
</pre>
<p>The first two fields show the date (Modified Julian Day) and time
update of the local clock outputs a line of the following form to
the file generation set named
<code>loopstats</code>:
-<pre class="verbatim"> 50935 75440.031 0.000006019 13.778190 0.000351733 0.0133806
+<pre class="verbatim">
+ 50935 75440.031 0.000006019 13.778190 0.000351733 0.0133806
</pre>
<p>The first two fields show the date (Modified Julian Day) and
line of the following form to the current element of a file
generation set named
<code>peerstats</code>:
-<pre class="verbatim"> 48773 10847.650 127.127.4.1 9714 -0.001605376 0.000000000 0.001424877 0.000958674
+<pre class="verbatim">
+ 48773 10847.650 127.127.4.1 9714 -0.001605376 0.000000000 0.001424877 0.000958674
</pre>
<p>The first two fields show the date (Modified Julian Day) and
received from a peer or clock driver appends a line of the
following form to the file generation set named
<code>rawstats</code>:
-<pre class="verbatim"> 50928 2132.543 128.4.1.1 128.4.1.20 3102453281.584327000 3102453281.58622800031 02453332.540806000 3102453332.541458000
+<pre class="verbatim">
+ 50928 2132.543 128.4.1.1 128.4.1.20 3102453281.584327000 3102453281.58622800031 02453332.540806000 3102453332.541458000
</pre>
<p>The first two fields show the date (Modified Julian Day) and
hour a line of the following form is appended to the file generation
set named
<code>sysstats</code>:
-<pre class="verbatim"> 50928 2132.543 36000 81965 0 9546 56 71793 512 540 10 147
+<pre class="verbatim">
+ 50928 2132.543 36000 81965 0 9546 56 71793 512 540 10 147
</pre>
<p>The first two fields show the date (Modified Julian Day) and time
option explained above.
<br><dt><code>filename</code><dd>This string is directly concatenated to the prefix mentioned
above (no intervening
-‘/’).
+/).
This can be modified using
the file argument to the
<kbd>filegen</kbd>
statement.
No
-<samp><span class="file">..</span></samp>
+<span class="file">..</span>
elements are
allowed in this component to prevent filenames referring to
parts outside the filesystem hierarchy denoted by
<code>ntpd(1ntpdmdoc)</code>
server incarnations.
The set member filename is built by appending a
-‘.’
+.
to concatenated
<kbd>prefix</kbd>
and
defined as the period between 00:00 and 24:00 UTC.
The file set
member suffix consists of a
-‘.’
+.
and a day specification in
the form
<code>YYYYMMdd</code>.
</dl>
</dl>
<div class="node">
-<a name="Access-Control-Support"></a>
<p><hr>
-
-
+<a name="Access-Control-Support"></a>
+<br>
</div>
<h4 class="subsection">Access Control Support</h4>
page
(available as part of the HTML documentation
provided in
-<samp><span class="file">/usr/share/doc/ntp</span></samp>).
+<span class="file">/usr/share/doc/ntp</span>).
<p>The restriction facility was implemented in conformance
with the access policies for the original NSFnet backbone
even if they come from an authenticated source.
Note that the ability to use a symmetric key for authentication may be restricted to
one or more IPs or subnets via the third field of the
-<samp><span class="file">ntp.keys</span></samp>
+<span class="file">ntp.keys</span>
file.
This restriction is not enabled by default,
to maintain backward compatability.
NTP server is unrestricted).
</dl>
<div class="node">
-<a name="Automatic-NTP-Configuration-Options"></a>
<p><hr>
-
-
+<a name="Automatic-NTP-Configuration-Options"></a>
+<br>
</div>
<h4 class="subsection">Automatic NTP Configuration Options</h4>
multiples of 32 starting at 31.
</dl>
<div class="node">
-<a name="Reference-Clock-Support"></a>
<p><hr>
-
-
+<a name="Reference-Clock-Support"></a>
+<br>
</div>
<h4 class="subsection">Reference Clock Support</h4>
page
(available as part of the HTML documentation
provided in
-<samp><span class="file">/usr/share/doc/ntp</span></samp>).
+<span class="file">/usr/share/doc/ntp</span>).
Additional information can be found in the pages linked
there, including the
"Debugging Hints for Reference Clock Drivers"
pages
(available as part of the HTML documentation
provided in
-<samp><span class="file">/usr/share/doc/ntp</span></samp>).
+<span class="file">/usr/share/doc/ntp</span>).
In addition, support for a PPS
signal is available as described in the
"Pulse-per-second (PPS) Signal Interfacing"
page
(available as part of the HTML documentation
provided in
-<samp><span class="file">/usr/share/doc/ntp</span></samp>).
+<span class="file">/usr/share/doc/ntp</span>).
Many
drivers support special line discipline/streams modules which can
significantly improve the accuracy using the driver.
page
(available as part of the HTML documentation
provided in
-<samp><span class="file">/usr/share/doc/ntp</span></samp>).
+<span class="file">/usr/share/doc/ntp</span>).
<p>A reference clock will generally (though not always) be a radio
timecode receiver which is synchronized to a source of standard
"Mitigation Rules and the prefer Keyword"
(available as part of the HTML documentation
provided in
-<samp><span class="file">/usr/share/doc/ntp</span></samp>)
+<span class="file">/usr/share/doc/ntp</span>)
page.
The
<code>minpoll</code>
page
(available as part of the HTML documentation
provided in
-<samp><span class="file">/usr/share/doc/ntp</span></samp>)
+<span class="file">/usr/share/doc/ntp</span>)
for further information.
<br><dt><code>mode</code> <kbd>int</kbd><dd>Specifies a mode number which is interpreted in a
device-specific fashion.
page
(available as part of the HTML documentation
provided in
-<samp><span class="file">/usr/share/doc/ntp</span></samp>).
+<span class="file">/usr/share/doc/ntp</span>).
<br><dt><code>time2</code> <kbd>secs</kbd><dd>Specifies a fixed-point decimal number in seconds, which is
interpreted in a driver-dependent way.
See the descriptions of
page
(available as part of the HTML documentation
provided in
-<samp><span class="file">/usr/share/doc/ntp</span></samp> <samp><span class="file">).</span></samp>
+<span class="file">/usr/share/doc/ntp</span> <span class="file">).</span>
<br><dt><code>stratum</code> <kbd>int</kbd><dd>Specifies the stratum number assigned to the driver, an integer
between 0 and 15.
This number overrides the default stratum number
</dl>
</dl>
<div class="node">
-<a name="Miscellaneous-Options"></a>
<p><hr>
-
-
+<a name="Miscellaneous-Options"></a>
+<br>
</div>
<h4 class="subsection">Miscellaneous Options</h4>
All
<kbd>configkeyword</kbd>
keywords can be prefixed with
-‘=’,
-‘+’
+=,
++
and
-‘-’,
+-,
where
-‘=’
+=
sets the
<code>syslog(3)</code>
priority mask,
-‘+’
++
adds and
-‘-’
+-
removes
messages.
<code>syslog(3)</code>
messages of the respective message class.
Thus, a minimal log configuration
could look like this:
-<pre class="verbatim"> logconfig =syncstatus +sysevents
+<pre class="verbatim">
+ logconfig =syncstatus +sysevents
</pre>
<p>This would just list the synchronizations state of
and the major system events.
For a simple reference server, the
following minimum message configuration could be useful:
-<pre class="verbatim"> logconfig =syncall +clockall
+<pre class="verbatim">
+ logconfig =syncall +clockall
</pre>
<p>This configuration will list all clock information and
</ul>
<div class="node">
-<a name="ntp.conf-Files"></a>
-<a name="ntp_002econf-Files"></a>
<p><hr>
-
-
+<a name="ntp_002econf-Files"></a>
+<br>
</div>
<h4 class="subsection">ntp.conf Files</h4>
<dl>
-<dt><samp><span class="file">/etc/ntp.conf</span></samp><dd>the default name of the configuration file
-<br><dt><samp><span class="file">ntp.keys</span></samp><dd>private MD5 keys
-<br><dt><samp><span class="file">ntpkey</span></samp><dd>RSA private key
-<br><dt><samp><span class="file">ntpkey_</span></samp><kbd>host</kbd><dd>RSA public key
-<br><dt><samp><span class="file">ntp_dh</span></samp><dd>Diffie-Hellman agreement parameters
+<dt><span class="file">/etc/ntp.conf</span><dd>the default name of the configuration file
+<br><dt><span class="file">ntp.keys</span><dd>private MD5 keys
+<br><dt><span class="file">ntpkey</span><dd>RSA private key
+<br><dt><span class="file">ntpkey_</span><kbd>host</kbd><dd>RSA public key
+<br><dt><span class="file">ntp_dh</span><dd>Diffie-Hellman agreement parameters
</dl>
<div class="node">
-<a name="ntp.conf-See-Also"></a>
-<a name="ntp_002econf-See-Also"></a>
<p><hr>
-
-
+<a name="ntp_002econf-See-Also"></a>
+<br>
</div>
<h4 class="subsection">ntp.conf See Also</h4>
at
<code>http://www.ntp.org/</code>.
A snapshot of this documentation is available in HTML format in
-<samp><span class="file">/usr/share/doc/ntp</span></samp>.
+<span class="file">/usr/share/doc/ntp</span>.
<br>
<p><br>
David L. Mills, <em>Network Time Protocol (Version 4)</em>, RFC5905
<div class="node">
-<a name="ntp.conf-Bugs"></a>
-<a name="ntp_002econf-Bugs"></a>
<p><hr>
-
-
+<a name="ntp_002econf-Bugs"></a>
+<br>
</div>
<h4 class="subsection">ntp.conf Bugs</h4>
detected.
<p>The
-<samp><span class="file">ntpkey_</span></samp><kbd>host</kbd>
+<span class="file">ntpkey_</span><kbd>host</kbd>
files are really digital
certificates.
These should be obtained via secure directory
services when they become universally available.
<div class="node">
-<a name="ntp.conf-Notes"></a>
-<a name="ntp_002econf-Notes"></a>
<p><hr>
-
-
+<a name="ntp_002econf-Notes"></a>
+<br>
</div>
<h4 class="subsection">ntp.conf Notes</h4>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntp.conf 5 "24 Jul 2018" "4.2.8p11" "File Formats"
+.TH ntp.conf 5 "14 Aug 2018" "4.2.8p12" "File Formats"
.\"
-.\" EDIT THIS FILE WITH CAUTION (in-mem file)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-2caiQA/ag-bdaaPA)
.\"
-.\" It has been AutoGen-ed July 24, 2018 at 09:13:25 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:28:54 AM by AutoGen 5.18.5
.\" From the definitions ntp.conf.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd July 24 2018
+.Dd August 14 2018
.Dt NTP_CONF 5 File Formats
.Os
.\" EDIT THIS FILE WITH CAUTION (ntp.mdoc)
.\"
-.\" It has been AutoGen-ed July 24, 2018 at 09:13:21 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:29:15 AM by AutoGen 5.18.5
.\" From the definitions ntp.conf.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
-.TH ntp.keys 5man "24 Jul 2018" "4.2.8p11" "File Formats"
+.TH ntp.keys 5man "14 Aug 2018" "4.2.8p12" "File Formats"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp.man)
.\"
-.\" It has been AutoGen-ed July 24, 2018 at 07:23:51 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:28:59 AM by AutoGen 5.18.5
.\" From the definitions ntp.keys.def
.\" and the template file agman-file.tpl
.Sh NAME
-.Dd July 24 2018
+.Dd August 14 2018
.Dt NTP_KEYS 5mdoc File Formats
-.Os Linux 3.2.0-4-686-pae
+.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp.mdoc)
.\"
-.\" It has been AutoGen-ed July 24, 2018 at 07:23:46 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:29:18 AM by AutoGen 5.18.5
.\" From the definitions ntp.keys.def
.\" and the template file agmdoc-file.tpl
.Sh NAME
<title>NTP Symmetric Key</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="NTP Symmetric Key">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<h1 class="settitle">NTP Symmetric Key</h1>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002ekeys-Description">ntp.keys Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntp_002ekeys-Description">ntp.keys 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">NTP's Symmetric Key File User Manual</h2>
<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.8p11 of <code>ntp.keys</code>.
+ <p>This document applies to version 4.2.8p12 of <code>ntp.keys</code>.
<div class="shortcontents">
<h2>Short Contents</h2>
</ul>
<div class="node">
-<a name="ntp.keys-Description"></a>
-<a name="ntp_002ekeys-Description"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#Top">Top</a>,
+
<a name="ntp_002ekeys-Description"></a>Previous: <a rel="previous" accesskey="p" href="#Top">Top</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
be specified in a configuration file, by default <code>/etc/ntp.keys</code>.
<div class="node">
-<a name="ntp.keys-Notes"></a>
-<a name="ntp_002ekeys-Notes"></a>
<p><hr>
-
-
+<a name="ntp_002ekeys-Notes"></a>
+<br>
</div>
<h3 class="section">Notes about ntp.keys</h3>
</ul>
<div class="node">
-<a name="ntp.keys-Files"></a>
-<a name="ntp_002ekeys-Files"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002ekeys-See-Also">ntp.keys See Also</a>,
+
<a name="ntp_002ekeys-Files"></a>Next: <a rel="next" accesskey="n" href="#ntp_002ekeys-See-Also">ntp.keys See Also</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002ekeys-Notes">ntp.keys Notes</a>
-
+<br>
</div>
<h4 class="subsection">ntp.keys Files</h4>
<dl>
-<dt><samp><span class="file">/etc/ntp.keys</span></samp><dd>the default name of the configuration file
+<dt><span class="file">/etc/ntp.keys</span><dd>the default name of the configuration file
</dl>
<div class="node">
-<a name="ntp.keys-See-Also"></a>
-<a name="ntp_002ekeys-See-Also"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002ekeys-Notes">ntp.keys Notes</a>,
+
<a name="ntp_002ekeys-See-Also"></a>Next: <a rel="next" accesskey="n" href="#ntp_002ekeys-Notes">ntp.keys Notes</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002ekeys-Files">ntp.keys Files</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002ekeys-Notes">ntp.keys Notes</a>
-
+<br>
</div>
<h4 class="subsection">ntp.keys See Also</h4>
<code>ntpdc(1ntpdcmdoc)</code>,
<code>sntp(1sntpmdoc)</code>
<div class="node">
-<a name="ntp.keys-Notes"></a>
-<a name="ntp_002ekeys-Notes"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntp_002ekeys-See-Also">ntp.keys See Also</a>,
+
<a name="ntp_002ekeys-Notes"></a>Previous: <a rel="previous" accesskey="p" href="#ntp_002ekeys-See-Also">ntp.keys See Also</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002ekeys-Notes">ntp.keys Notes</a>
-
+<br>
</div>
<h4 class="subsection">ntp.keys Notes</h4>
-.TH ntp.keys 5 "24 Jul 2018" "4.2.8p11" "File Formats"
+.TH ntp.keys 5 "14 Aug 2018" "4.2.8p12" "File Formats"
.\"
.\" EDIT THIS FILE WITH CAUTION (ntp.man)
.\"
-.\" It has been AutoGen-ed July 24, 2018 at 07:23:51 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:28:59 AM by AutoGen 5.18.5
.\" From the definitions ntp.keys.def
.\" and the template file agman-file.tpl
.Sh NAME
-.Dd July 24 2018
+.Dd August 14 2018
.Dt NTP_KEYS 5 File Formats
-.Os Linux 3.2.0-4-686-pae
+.Os SunOS 5.10
.\" EDIT THIS FILE WITH CAUTION (ntp.mdoc)
.\"
-.\" It has been AutoGen-ed July 24, 2018 at 07:23:46 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:29:18 AM by AutoGen 5.18.5
.\" From the definitions ntp.keys.def
.\" and the template file agmdoc-file.tpl
.Sh NAME
/*
* EDIT THIS FILE WITH CAUTION (ntpd-opts.c)
*
- * It has been AutoGen-ed February 27, 2018 at 05:13:19 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed August 14, 2018 at 08:27:45 AM by AutoGen 5.18.5
* From the definitions ntpd-opts.def
* and the template file options
*
* static const strings for ntpd options
*/
static char const ntpd_opt_strs[3132] =
-/* 0 */ "ntpd 4.2.8p11\n"
+/* 0 */ "ntpd 4.2.8p12\n"
"Copyright (C) 1992-2017 The University of Delaware and Network Time Foundation, 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"
/* 2901 */ "output version information and exit\0"
/* 2937 */ "version\0"
/* 2945 */ "NTPD\0"
-/* 2950 */ "ntpd - NTP daemon program - Ver. 4.2.8p11\n"
+/* 2950 */ "ntpd - NTP daemon program - Ver. 4.2.8p12\n"
"Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n"
"\t\t[ <server1> ... <serverN> ]\n\0"
/* 3082 */ "http://bugs.ntp.org, bugs@ntp.org\0"
/* 3116 */ "\n\0"
-/* 3118 */ "ntpd 4.2.8p11";
+/* 3118 */ "ntpd 4.2.8p12";
/**
* ipv4 option description with
translate option names.
*/
/* referenced via ntpdOptions.pzCopyright */
- puts(_("ntpd 4.2.8p11\n\
+ puts(_("ntpd 4.2.8p12\n\
Copyright (C) 1992-2017 The University of Delaware and Network Time Foundation, 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.8p11\n\
+ puts(_("ntpd - NTP daemon program - Ver. 4.2.8p12\n\
Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
\t\t[ <server1> ... <serverN> ]\n"));
puts(_("\n"));
/* referenced via ntpdOptions.pzFullVersion */
- puts(_("ntpd 4.2.8p11"));
+ puts(_("ntpd 4.2.8p12"));
/* referenced via ntpdOptions.pzFullUsage */
puts(_("<<<NOT-FOUND>>>"));
/*
* EDIT THIS FILE WITH CAUTION (ntpd-opts.h)
*
- * It has been AutoGen-ed February 27, 2018 at 05:13:17 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed August 14, 2018 at 08:27:44 AM by AutoGen 5.18.5
* From the definitions ntpd-opts.def
* and the template file options
*
/** count of all options for ntpd */
#define OPTION_CT 38
/** ntpd version */
-#define NTPD_VERSION "4.2.8p11"
+#define NTPD_VERSION "4.2.8p12"
/** Full ntpd version text */
-#define NTPD_FULL_VERSION "ntpd 4.2.8p11"
+#define NTPD_FULL_VERSION "ntpd 4.2.8p12"
/**
* Interface defines for all options. Replace "n" with the UPPER_CASED
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpd 1ntpdman "27 Feb 2018" "4.2.8p11" "User Commands"
+.TH ntpd 1ntpdman "14 Aug 2018" "4.2.8p12" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-Ffa4WQ/ag-RfaWVQ)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-jbaWTB/ag-ubaOSB)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:14:30 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:29:02 AM by AutoGen 5.18.5
.\" From the definitions ntpd-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt NTPD 1ntpdmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpd-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:14:47 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:29:20 AM by AutoGen 5.18.5
.\" From the definitions ntpd-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<title>ntpd: Network Time Protocol (NTP) Daemon User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="ntpd: Network Time Protocol (NTP) Daemon User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<h1 class="settitle">ntpd: Network Time Protocol (NTP) Daemon User's Manual</h1>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-Description">ntpd Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Description">ntpd 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">ntpd: Network Time Protocol (NTP) Daemon User Manual</h2>
symmetric and broadcast modes, and with both symmetric-key and public-key
cryptography.
- <p>This document applies to version 4.2.8p11 of <code>ntpd</code>.
+ <p>This document applies to version 4.2.8p12 of <code>ntpd</code>.
<ul class="menu">
<li><a accesskey="1" href="#ntpd-Description">ntpd Description</a>: Description
</ul>
<div class="node">
-<a name="ntpd-Description"></a>
<p><hr>
-
-
+<a name="ntpd-Description"></a>
+<br>
</div>
<!-- node-name, next, previous, up -->
the daemon times out and exits without setting the clock.
<div class="node">
-<a name="ntpd-Invocation"></a>
<p><hr>
-
-
+<a name="ntpd-Invocation"></a>
+<br>
</div>
<h3 class="section">Invoking ntpd</h3>
This software is released under the NTP license, <http://ntp.org/license>.
<ul class="menu">
-<li><a accesskey="1" href="#ntpd-usage">ntpd usage</a>: ntpd help/usage (<samp><span class="option">--help</span></samp>)
+<li><a accesskey="1" href="#ntpd-usage">ntpd usage</a>: ntpd help/usage (<span class="option">--help</span>)
<li><a accesskey="2" href="#ntpd-ipv4">ntpd ipv4</a>: ipv4 option (-4)
<li><a accesskey="3" href="#ntpd-ipv6">ntpd ipv6</a>: ipv6 option (-6)
<li><a accesskey="4" href="#ntpd-authreq">ntpd authreq</a>: authreq option (-a)
</ul>
<div class="node">
-<a name="ntpd-usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-ipv4">ntpd ipv4</a>,
+
<a name="ntpd-usage"></a>Next: <a rel="next" accesskey="n" href="#ntpd-ipv4">ntpd ipv4</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
-<h4 class="subsection">ntpd help/usage (<samp><span class="option">--help</span></samp>)</h4>
+<h4 class="subsection">ntpd help/usage (<span class="option">--help</span>)</h4>
<p><a name="index-ntpd-help-3"></a>
This is the automatically generated usage text for ntpd.
<p>The text printed is the same whether selected with the <code>help</code> option
-(<samp><span class="option">--help</span></samp>) or the <code>more-help</code> option (<samp><span class="option">--more-help</span></samp>). <code>more-help</code> will print
+(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
the usage text by passing it through a pager program.
<code>more-help</code> is disabled on platforms without a working
<code>fork(2)</code> function. The <code>PAGER</code> environment variable is
-used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
+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.8p11
Please send bug reports to: <http://bugs.ntp.org, bugs@ntp.org>
</pre>
<div class="node">
-<a name="ntpd-ipv4"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-ipv6">ntpd ipv6</a>,
+
<a name="ntpd-ipv4"></a>Next: <a rel="next" accesskey="n" href="#ntpd-ipv6">ntpd ipv6</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-usage">ntpd usage</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ipv4 option (-4)</h4>
<p>Force DNS resolution of following host names on the command line
to the IPv4 namespace.
<div class="node">
-<a name="ntpd-ipv6"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-authreq">ntpd authreq</a>,
+
<a name="ntpd-ipv6"></a>Next: <a rel="next" accesskey="n" href="#ntpd-authreq">ntpd authreq</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-ipv4">ntpd ipv4</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ipv6 option (-6)</h4>
<p>Force DNS resolution of following host names on the command line
to the IPv6 namespace.
<div class="node">
-<a name="ntpd-authreq"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-authnoreq">ntpd authnoreq</a>,
+
<a name="ntpd-authreq"></a>Next: <a rel="next" accesskey="n" href="#ntpd-authnoreq">ntpd authnoreq</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-ipv6">ntpd ipv6</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">authreq option (-a)</h4>
multicast client and symmetric passive associations.
This is the default.
<div class="node">
-<a name="ntpd-authnoreq"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-configfile">ntpd configfile</a>,
+
<a name="ntpd-authnoreq"></a>Next: <a rel="next" accesskey="n" href="#ntpd-configfile">ntpd configfile</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-authreq">ntpd authreq</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">authnoreq option (-A)</h4>
multicast client and symmetric passive associations.
This is almost never a good idea.
<div class="node">
-<a name="ntpd-configfile"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-driftfile">ntpd driftfile</a>,
+
<a name="ntpd-configfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-driftfile">ntpd driftfile</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-authnoreq">ntpd authnoreq</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">configfile option (-c)</h4>
This is the “configuration file name” option.
This option takes a string argument.
The name and path of the configuration file,
-<samp><span class="file">/etc/ntp.conf</span></samp>
+<span class="file">/etc/ntp.conf</span>
by default.
<div class="node">
-<a name="ntpd-driftfile"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-panicgate">ntpd panicgate</a>,
+
<a name="ntpd-driftfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-panicgate">ntpd panicgate</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-configfile">ntpd configfile</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">driftfile option (-f)</h4>
This is the “frequency drift file name” option.
This option takes a string argument.
The name and path of the frequency file,
-<samp><span class="file">/etc/ntp.drift</span></samp>
+<span class="file">/etc/ntp.drift</span>
by default.
This is the same operation as the
<code>driftfile</code> <kbd>driftfile</kbd>
configuration specification in the
-<samp><span class="file">/etc/ntp.conf</span></samp>
+<span class="file">/etc/ntp.conf</span>
file.
<div class="node">
-<a name="ntpd-panicgate"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-force_002dstep_002donce">ntpd force-step-once</a>,
+
<a name="ntpd-panicgate"></a>Next: <a rel="next" accesskey="n" href="#ntpd-force_002dstep_002donce">ntpd force-step-once</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-driftfile">ntpd driftfile</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">panicgate option (-g)</h4>
<code>tinker</code>
configuration file directive for other options.
<div class="node">
-<a name="ntpd-force-step-once"></a>
-<a name="ntpd-force_002dstep_002donce"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-jaildir">ntpd jaildir</a>,
+
<a name="ntpd-force_002dstep_002donce"></a>Next: <a rel="next" accesskey="n" href="#ntpd-jaildir">ntpd jaildir</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-panicgate">ntpd panicgate</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">force-step-once option (-G)</h4>
applications requiring monotonic time are running.
See the <code>tinker</code> configuration file directive for other options.
<div class="node">
-<a name="ntpd-jaildir"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-interface">ntpd interface</a>,
+
<a name="ntpd-jaildir"></a>Next: <a rel="next" accesskey="n" href="#ntpd-interface">ntpd interface</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-force_002dstep_002donce">ntpd force-step-once</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">jaildir option (-i)</h4>
<code>--enable-clockctl</code>) or Linux (configure with
<code>--enable-linuxcaps</code>) or Solaris (configure with <code>--enable-solarisprivs</code>).
<div class="node">
-<a name="ntpd-interface"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-keyfile">ntpd keyfile</a>,
+
<a name="ntpd-interface"></a>Next: <a rel="next" accesskey="n" href="#ntpd-keyfile">ntpd keyfile</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-jaildir">ntpd jaildir</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">interface option (-I)</h4>
<p><a name="index-ntpd_002dinterface-13"></a>
This is the “listen on an interface name or address” option.
-This option takes a string argument <samp><span class="file">iface</span></samp>.
+This option takes a string argument <span class="file">iface</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
This option is deprecated. Please consider using the configuration file
<code>interface</code> command, which is more versatile.
<div class="node">
-<a name="ntpd-keyfile"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-logfile">ntpd logfile</a>,
+
<a name="ntpd-keyfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-logfile">ntpd logfile</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-interface">ntpd interface</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">keyfile option (-k)</h4>
This is the “path to symmetric keys” option.
This option takes a string argument.
Specify the name and path of the symmetric key file.
-<samp><span class="file">/etc/ntp.keys</span></samp>
+<span class="file">/etc/ntp.keys</span>
is the default.
This is the same operation as the
<code>keys</code> <kbd>keyfile</kbd>
configuration file directive.
<div class="node">
-<a name="ntpd-logfile"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-novirtualips">ntpd novirtualips</a>,
+
<a name="ntpd-logfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-novirtualips">ntpd novirtualips</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-keyfile">ntpd keyfile</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">logfile option (-l)</h4>
<code>logfile</code> <kbd>logfile</kbd>
configuration file directive.
<div class="node">
-<a name="ntpd-novirtualips"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-modifymmtimer">ntpd modifymmtimer</a>,
+
<a name="ntpd-novirtualips"></a>Next: <a rel="next" accesskey="n" href="#ntpd-modifymmtimer">ntpd modifymmtimer</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-logfile">ntpd logfile</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">novirtualips option (-L)</h4>
consider using the configuration file <code>interface</code> command, which
is more versatile.
<div class="node">
-<a name="ntpd-modifymmtimer"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-nice">ntpd nice</a>,
+
<a name="ntpd-modifymmtimer"></a>Next: <a rel="next" accesskey="n" href="#ntpd-nice">ntpd nice</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-novirtualips">ntpd novirtualips</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">modifymmtimer option (-M)</h4>
ensures the resolution does not change while ntpd is running,
avoiding timekeeping glitches associated with changes.
<div class="node">
-<a name="ntpd-nice"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-pidfile">ntpd pidfile</a>,
+
<a name="ntpd-nice"></a>Next: <a rel="next" accesskey="n" href="#ntpd-pidfile">ntpd pidfile</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-modifymmtimer">ntpd modifymmtimer</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">nice option (-N)</h4>
<code>ntpd</code>
at the highest priority.
<div class="node">
-<a name="ntpd-pidfile"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-priority">ntpd priority</a>,
+
<a name="ntpd-pidfile"></a>Next: <a rel="next" accesskey="n" href="#ntpd-priority">ntpd priority</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-nice">ntpd nice</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">pidfile option (-p)</h4>
<code>pidfile</code> <kbd>pidfile</kbd>
configuration file directive.
<div class="node">
-<a name="ntpd-priority"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-quit">ntpd quit</a>,
+
<a name="ntpd-priority"></a>Next: <a rel="next" accesskey="n" href="#ntpd-quit">ntpd quit</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-pidfile">ntpd pidfile</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">priority option (-P)</h4>
<code>sched_setscheduler(SCHED_FIFO)</code>
priority.
<div class="node">
-<a name="ntpd-quit"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-propagationdelay">ntpd propagationdelay</a>,
+
<a name="ntpd-quit"></a>Next: <a rel="next" accesskey="n" href="#ntpd-propagationdelay">ntpd propagationdelay</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-priority">ntpd priority</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">quit option (-q)</h4>
options can be used with this option.
Note: The kernel time discipline is disabled with this option.
<div class="node">
-<a name="ntpd-propagationdelay"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-saveconfigquit">ntpd saveconfigquit</a>,
+
<a name="ntpd-propagationdelay"></a>Next: <a rel="next" accesskey="n" href="#ntpd-saveconfigquit">ntpd saveconfigquit</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-quit">ntpd quit</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">propagationdelay option (-r)</h4>
This option takes a string argument.
Specify the default propagation delay from the broadcast/multicast server to this client. This is necessary only if the delay cannot be computed automatically by the protocol.
<div class="node">
-<a name="ntpd-saveconfigquit"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-statsdir">ntpd statsdir</a>,
+
<a name="ntpd-saveconfigquit"></a>Next: <a rel="next" accesskey="n" href="#ntpd-statsdir">ntpd statsdir</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-propagationdelay">ntpd propagationdelay</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">saveconfigquit option</h4>
equivalent to the given filename and exit. This option was
designed for automated testing.
<div class="node">
-<a name="ntpd-statsdir"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-trustedkey">ntpd trustedkey</a>,
+
<a name="ntpd-statsdir"></a>Next: <a rel="next" accesskey="n" href="#ntpd-trustedkey">ntpd trustedkey</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-saveconfigquit">ntpd saveconfigquit</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">statsdir option (-s)</h4>
<code>statsdir</code> <kbd>statsdir</kbd>
configuration file directive.
<div class="node">
-<a name="ntpd-trustedkey"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-user">ntpd user</a>,
+
<a name="ntpd-trustedkey"></a>Next: <a rel="next" accesskey="n" href="#ntpd-user">ntpd user</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-statsdir">ntpd statsdir</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">trustedkey option (-t)</h4>
<p><a name="index-ntpd_002dtrustedkey-25"></a>
This is the “trusted key number” option.
-This option takes a string argument <samp><span class="file">tkey</span></samp>.
+This option takes a string argument <span class="file">tkey</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
<p>Add the specified key number to the trusted key list.
<div class="node">
-<a name="ntpd-user"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-updateinterval">ntpd updateinterval</a>,
+
<a name="ntpd-user"></a>Next: <a rel="next" accesskey="n" href="#ntpd-updateinterval">ntpd updateinterval</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-trustedkey">ntpd trustedkey</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">user option (-u)</h4>
<code>--enable-clockctl</code>) or Linux (configure with
<code>--enable-linuxcaps</code>) or Solaris (configure with <code>--enable-solarisprivs</code>).
<div class="node">
-<a name="ntpd-updateinterval"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-wait_002dsync">ntpd wait-sync</a>,
+
<a name="ntpd-updateinterval"></a>Next: <a rel="next" accesskey="n" href="#ntpd-wait_002dsync">ntpd wait-sync</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-user">ntpd user</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">updateinterval option (-U)</h4>
has been detected by the system.
Use 0 to disable scanning. 60 seconds is the minimum time between scans.
<div class="node">
-<a name="ntpd-wait-sync"></a>
-<a name="ntpd-wait_002dsync"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-slew">ntpd slew</a>,
+
<a name="ntpd-wait_002dsync"></a>Next: <a rel="next" accesskey="n" href="#ntpd-slew">ntpd slew</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-updateinterval">ntpd updateinterval</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">wait-sync option (-w)</h4>
This provides the option for a script starting <code>ntpd</code> to easily
wait for the first set of the clock before proceeding.
<div class="node">
-<a name="ntpd-slew"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-usepcc">ntpd usepcc</a>,
+
<a name="ntpd-slew"></a>Next: <a rel="next" accesskey="n" href="#ntpd-usepcc">ntpd usepcc</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-wait_002dsync">ntpd wait-sync</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">slew option (-x)</h4>
configuration file directive for other options.
Note: The kernel time discipline is disabled with this option.
<div class="node">
-<a name="ntpd-usepcc"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-pccfreq">ntpd pccfreq</a>,
+
<a name="ntpd-usepcc"></a>Next: <a rel="next" accesskey="n" href="#ntpd-pccfreq">ntpd pccfreq</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-slew">ntpd slew</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">usepcc option</h4>
they have the same frequency, the CPU counter (RDTSC on x86) is
used directly, saving the overhead of a system call.
<div class="node">
-<a name="ntpd-pccfreq"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-mdns">ntpd mdns</a>,
+
<a name="ntpd-pccfreq"></a>Next: <a rel="next" accesskey="n" href="#ntpd-mdns">ntpd mdns</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-usepcc">ntpd usepcc</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">pccfreq option</h4>
The CPU counter (RDTSC on x86) is used unconditionally with the
given frequency (in Hz).
<div class="node">
-<a name="ntpd-mdns"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-config">ntpd config</a>,
+
<a name="ntpd-mdns"></a>Next: <a rel="next" accesskey="n" href="#ntpd-config">ntpd config</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-pccfreq">ntpd pccfreq</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">mdns option (-m)</h4>
the server to be discovered via mDNS client lookup.
<div class="node">
-<a name="ntpd-config"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-exit-status">ntpd exit status</a>,
+
<a name="ntpd-config"></a>Next: <a rel="next" accesskey="n" href="#ntpd-exit-status">ntpd exit status</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-mdns">ntpd mdns</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">presetting/configuring ntpd</h4>
Only the first letter of the argument is examined:
<dl>
-<dt>‘<samp><span class="samp">version</span></samp>’<dd>Only print the version. This is the default.
-<br><dt>‘<samp><span class="samp">copyright</span></samp>’<dd>Name the copyright usage licensing terms.
-<br><dt>‘<samp><span class="samp">verbose</span></samp>’<dd>Print the full copyright usage licensing terms.
+<dt><span class="samp">version</span><dd>Only print the version. This is the default.
+<br><dt><span class="samp">copyright</span><dd>Name the copyright usage licensing terms.
+<br><dt><span class="samp">verbose</span><dd>Print the full copyright usage licensing terms.
</dl>
<div class="node">
-<a name="ntpd-exit-status"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-Usage">ntpd Usage</a>,
+
<a name="ntpd-exit-status"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Usage">ntpd Usage</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-config">ntpd config</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpd exit status</h4>
<p>One of the following exit values will be returned:
<dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
+<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution.
+<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid.
</dl>
<div class="node">
-<a name="ntpd-Usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-Files">ntpd Files</a>,
+
<a name="ntpd-Usage"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Files">ntpd Files</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-exit-status">ntpd exit status</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpd Usage</h4>
<div class="node">
-<a name="ntpd-Files"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-See-Also">ntpd See Also</a>,
+
<a name="ntpd-Files"></a>Next: <a rel="next" accesskey="n" href="#ntpd-See-Also">ntpd See Also</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-Usage">ntpd Usage</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpd Files</h4>
<div class="node">
-<a name="ntpd-See-Also"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-Bugs">ntpd Bugs</a>,
+
<a name="ntpd-See-Also"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Bugs">ntpd Bugs</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-Files">ntpd Files</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpd See Also</h4>
<div class="node">
-<a name="ntpd-Bugs"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpd-Notes">ntpd Notes</a>,
+
<a name="ntpd-Bugs"></a>Next: <a rel="next" accesskey="n" href="#ntpd-Notes">ntpd Notes</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpd-See-Also">ntpd See Also</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpd Bugs</h4>
<div class="node">
-<a name="ntpd-Notes"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntpd-Bugs">ntpd Bugs</a>,
+
<a name="ntpd-Notes"></a>Previous: <a rel="previous" accesskey="p" href="#ntpd-Bugs">ntpd Bugs</a>,
Up: <a rel="up" accesskey="u" href="#ntpd-Invocation">ntpd Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpd Notes</h4>
<div class="node">
-<a name="Usage"></a>
<p><hr>
-
-
+<a name="Usage"></a>
+<br>
</div>
<!-- node-name, next, previous, up -->
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpd @NTPD_MS@ "27 Feb 2018" "4.2.8p11" "User Commands"
+.TH ntpd @NTPD_MS@ "14 Aug 2018" "4.2.8p12" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-Ffa4WQ/ag-RfaWVQ)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-jbaWTB/ag-ubaOSB)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:14:30 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:29:02 AM by AutoGen 5.18.5
.\" From the definitions ntpd-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt NTPD @NTPD_MS@ User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpd-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:14:47 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:29:20 AM by AutoGen 5.18.5
.\" From the definitions ntpd-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-ntpdc.texi)
#
-# It has been AutoGen-ed February 27, 2018 at 05:15:06 PM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:29:40 AM by AutoGen 5.18.5
# 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.8p11
+ntpdc - vendor-specific NTPD control program - Ver. 4.2.8p12
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 27, 2018 at 05:14:56 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed August 14, 2018 at 08:29:29 AM by AutoGen 5.18.5
* From the definitions ntpdc-opts.def
* and the template file options
*
* static const strings for ntpdc options
*/
static char const ntpdc_opt_strs[1914] =
-/* 0 */ "ntpdc 4.2.8p11\n"
+/* 0 */ "ntpdc 4.2.8p12\n"
"Copyright (C) 1992-2017 The University of Delaware and Network Time Foundation, 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"
/* 1695 */ "no-load-opts\0"
/* 1708 */ "no\0"
/* 1711 */ "NTPDC\0"
-/* 1717 */ "ntpdc - vendor-specific NTPD control program - Ver. 4.2.8p11\n"
+/* 1717 */ "ntpdc - vendor-specific NTPD control program - Ver. 4.2.8p12\n"
"Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n\0"
/* 1848 */ "$HOME\0"
/* 1854 */ ".\0"
/* 1856 */ ".ntprc\0"
/* 1863 */ "http://bugs.ntp.org, bugs@ntp.org\0"
/* 1897 */ "\n\0"
-/* 1899 */ "ntpdc 4.2.8p11";
+/* 1899 */ "ntpdc 4.2.8p12";
/**
* ipv4 option description with
translate option names.
*/
/* referenced via ntpdcOptions.pzCopyright */
- puts(_("ntpdc 4.2.8p11\n\
+ puts(_("ntpdc 4.2.8p12\n\
Copyright (C) 1992-2017 The University of Delaware and Network Time Foundation, 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.8p11\n\
+ puts(_("ntpdc - vendor-specific NTPD control program - Ver. 4.2.8p12\n\
Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
/* referenced via ntpdcOptions.pzExplain */
puts(_("\n"));
/* referenced via ntpdcOptions.pzFullVersion */
- puts(_("ntpdc 4.2.8p11"));
+ puts(_("ntpdc 4.2.8p12"));
/* referenced via ntpdcOptions.pzFullUsage */
puts(_("<<<NOT-FOUND>>>"));
/*
* EDIT THIS FILE WITH CAUTION (ntpdc-opts.h)
*
- * It has been AutoGen-ed February 27, 2018 at 05:14:56 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed August 14, 2018 at 08:29:28 AM by AutoGen 5.18.5
* From the definitions ntpdc-opts.def
* and the template file options
*
/** count of all options for ntpdc */
#define OPTION_CT 15
/** ntpdc version */
-#define NTPDC_VERSION "4.2.8p11"
+#define NTPDC_VERSION "4.2.8p12"
/** Full ntpdc version text */
-#define NTPDC_FULL_VERSION "ntpdc 4.2.8p11"
+#define NTPDC_FULL_VERSION "ntpdc 4.2.8p12"
/**
* Interface defines for all options. Replace "n" with the UPPER_CASED
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpdc 1ntpdcman "27 Feb 2018" "4.2.8p11" "User Commands"
+.TH ntpdc 1ntpdcman "14 Aug 2018" "4.2.8p12" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-MnaqKS/ag-YnaiJS)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-uwaqJD/ag-GwaiID)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:15:03 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:29:36 AM by AutoGen 5.18.5
.\" From the definitions ntpdc-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt NTPDC 1ntpdcmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpdc-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:15:09 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:29:43 AM by AutoGen 5.18.5
.\" From the definitions ntpdc-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<title>ntpdc: NTPD Control User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="ntpdc: NTPD Control User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<h1 class="settitle">ntpdc: NTPD Control User's Manual</h1>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-Description">ntpdc Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-Description">ntpdc 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">ntpdc: NTPD Control User Manual</h2>
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.8p11 of <code>ntpdc</code>.
+ <p>This document applies to version 4.2.8p12 of <code>ntpdc</code>.
<p>The program implements the SNTP protocol as defined by RFC 5905, the NTPv4
IETF specification.
</ul>
<div class="node">
-<a name="ntpdc-Description"></a>
<p><hr>
-
-
+<a name="ntpdc-Description"></a>
+<br>
</div>
<!-- node-name, next, previous, up -->
error bound of the system clock relative to the server clock.
<div class="node">
-<a name="ntpdc-Invocation"></a>
<p><hr>
-
-
+<a name="ntpdc-Invocation"></a>
+<br>
</div>
<h3 class="section">Invoking ntpdc</h3>
This software is released under the NTP license, <http://ntp.org/license>.
<ul class="menu">
-<li><a accesskey="1" href="#ntpdc-usage">ntpdc usage</a>: ntpdc help/usage (<samp><span class="option">--help</span></samp>)
+<li><a accesskey="1" href="#ntpdc-usage">ntpdc usage</a>: ntpdc help/usage (<span class="option">--help</span>)
<li><a accesskey="2" href="#ntpdc-ipv4">ntpdc ipv4</a>: ipv4 option (-4)
<li><a accesskey="3" href="#ntpdc-ipv6">ntpdc ipv6</a>: ipv6 option (-6)
<li><a accesskey="4" href="#ntpdc-command">ntpdc command</a>: command option (-c)
</ul>
<div class="node">
-<a name="ntpdc-usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-ipv4">ntpdc ipv4</a>,
+
<a name="ntpdc-usage"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-ipv4">ntpdc ipv4</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
-<h4 class="subsection">ntpdc help/usage (<samp><span class="option">--help</span></samp>)</h4>
+<h4 class="subsection">ntpdc help/usage (<span class="option">--help</span>)</h4>
<p><a name="index-ntpdc-help-3"></a>
This is the automatically generated usage text for ntpdc.
<p>The text printed is the same whether selected with the <code>help</code> option
-(<samp><span class="option">--help</span></samp>) or the <code>more-help</code> option (<samp><span class="option">--more-help</span></samp>). <code>more-help</code> will print
+(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
the usage text by passing it through a pager program.
<code>more-help</code> is disabled on platforms without a working
<code>fork(2)</code> function. The <code>PAGER</code> environment variable is
-used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
+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.8p11
+<pre class="example">ntpdc - vendor-specific NTPD control program - Ver. 4.2.8p12
Usage: ntpdc [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]
Flg Arg Option-Name Description
-4 no ipv4 Force IPv4 DNS name resolution
Please send bug reports to: <http://bugs.ntp.org, bugs@ntp.org>
</pre>
<div class="node">
-<a name="ntpdc-ipv4"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-ipv6">ntpdc ipv6</a>,
+
<a name="ntpdc-ipv4"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-ipv6">ntpdc ipv6</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-usage">ntpdc usage</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ipv4 option (-4)</h4>
<p>Force DNS resolution of following host names on the command line
to the IPv4 namespace.
<div class="node">
-<a name="ntpdc-ipv6"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-command">ntpdc command</a>,
+
<a name="ntpdc-ipv6"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-command">ntpdc command</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-ipv4">ntpdc ipv4</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ipv6 option (-6)</h4>
<p>Force DNS resolution of following host names on the command line
to the IPv6 namespace.
<div class="node">
-<a name="ntpdc-command"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-interactive">ntpdc interactive</a>,
+
<a name="ntpdc-command"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-interactive">ntpdc interactive</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-ipv6">ntpdc ipv6</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">command option (-c)</h4>
<p><a name="index-ntpdc_002dcommand-6"></a>
This is the “run a command and exit” option.
-This option takes a string argument <samp><span class="file">cmd</span></samp>.
+This option takes a string argument <span class="file">cmd</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
and is added to the list of commands to be executed on the specified
host(s).
<div class="node">
-<a name="ntpdc-interactive"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-listpeers">ntpdc listpeers</a>,
+
<a name="ntpdc-interactive"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-listpeers">ntpdc listpeers</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-command">ntpdc command</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">interactive option (-i)</h4>
<p>Force ntpq to operate in interactive mode. Prompts will be written
to the standard output and commands read from the standard input.
<div class="node">
-<a name="ntpdc-listpeers"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-numeric">ntpdc numeric</a>,
+
<a name="ntpdc-listpeers"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-numeric">ntpdc numeric</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-interactive">ntpdc interactive</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">listpeers option (-l)</h4>
<p>Print a list of the peers known to the server as well as a summary of
their state. This is equivalent to the 'listpeers' interactive command.
<div class="node">
-<a name="ntpdc-numeric"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-peers">ntpdc peers</a>,
+
<a name="ntpdc-numeric"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-peers">ntpdc peers</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-listpeers">ntpdc listpeers</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">numeric option (-n)</h4>
Output all host addresses in dotted-quad numeric format rather than
converting to the canonical host names.
<div class="node">
-<a name="ntpdc-peers"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-showpeers">ntpdc showpeers</a>,
+
<a name="ntpdc-peers"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-showpeers">ntpdc showpeers</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-numeric">ntpdc numeric</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">peers option (-p)</h4>
<p>Print a list of the peers known to the server as well as a summary
of their state. This is equivalent to the 'peers' interactive command.
<div class="node">
-<a name="ntpdc-showpeers"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-config">ntpdc config</a>,
+
<a name="ntpdc-showpeers"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-config">ntpdc config</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-peers">ntpdc peers</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">showpeers option (-s)</h4>
of their state. This is equivalent to the 'dmpeers' interactive command.
<div class="node">
-<a name="ntpdc-config"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-exit-status">ntpdc exit status</a>,
+
<a name="ntpdc-config"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-exit-status">ntpdc exit status</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-showpeers">ntpdc showpeers</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">presetting/configuring ntpdc</h4>
<li>$PWD
</ul>
The environment variables <code>HOME</code>, and <code>PWD</code>
-are expanded and replaced when <samp><span class="file">ntpdc</span></samp> runs.
+are expanded and replaced when <span class="file">ntpdc</span> runs.
For any of these that are plain files, they are simply processed.
-For any that are directories, then a file named <samp><span class="file">.ntprc</span></samp> is searched for
+For any that are directories, then a file named <span class="file">.ntprc</span> is searched for
within that directory and processed.
<p>Configuration files may be in a wide variety of formats.
Only the first letter of the argument is examined:
<dl>
-<dt>‘<samp><span class="samp">version</span></samp>’<dd>Only print the version. This is the default.
-<br><dt>‘<samp><span class="samp">copyright</span></samp>’<dd>Name the copyright usage licensing terms.
-<br><dt>‘<samp><span class="samp">verbose</span></samp>’<dd>Print the full copyright usage licensing terms.
+<dt><span class="samp">version</span><dd>Only print the version. This is the default.
+<br><dt><span class="samp">copyright</span><dd>Name the copyright usage licensing terms.
+<br><dt><span class="samp">verbose</span><dd>Print the full copyright usage licensing terms.
</dl>
<div class="node">
-<a name="ntpdc-exit-status"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-Usage">ntpdc Usage</a>,
+
<a name="ntpdc-exit-status"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-Usage">ntpdc Usage</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-config">ntpdc config</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpdc exit status</h4>
<p>One of the following exit values will be returned:
<dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
-<br><dt>‘<samp><span class="samp">66 (EX_NOINPUT)</span></samp>’<dd>A specified configuration file could not be loaded.
-<br><dt>‘<samp><span class="samp">70 (EX_SOFTWARE)</span></samp>’<dd>libopts had an internal operational error. Please report
+<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution.
+<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid.
+<br><dt><span class="samp">66 (EX_NOINPUT)</span><dd>A specified configuration file could not be loaded.
+<br><dt><span class="samp">70 (EX_SOFTWARE)</span><dd>libopts had an internal operational error. Please report
it to autogen-users@lists.sourceforge.net. Thank you.
</dl>
<div class="node">
-<a name="ntpdc-Usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-See-Also">ntpdc See Also</a>,
+
<a name="ntpdc-Usage"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-See-Also">ntpdc See Also</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-exit-status">ntpdc exit status</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpdc Usage</h4>
<div class="node">
-<a name="ntpdc-See-Also"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-Authors">ntpdc Authors</a>,
+
<a name="ntpdc-See-Also"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-Authors">ntpdc Authors</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-Usage">ntpdc Usage</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpdc See Also</h4>
<div class="node">
-<a name="ntpdc-Authors"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpdc-Bugs">ntpdc Bugs</a>,
+
<a name="ntpdc-Authors"></a>Next: <a rel="next" accesskey="n" href="#ntpdc-Bugs">ntpdc Bugs</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpdc-See-Also">ntpdc See Also</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpdc Authors</h4>
<div class="node">
-<a name="ntpdc-Bugs"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntpdc-Authors">ntpdc Authors</a>,
+
<a name="ntpdc-Bugs"></a>Previous: <a rel="previous" accesskey="p" href="#ntpdc-Authors">ntpdc Authors</a>,
Up: <a rel="up" accesskey="u" href="#ntpdc-Invocation">ntpdc Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpdc Bugs</h4>
<div class="node">
-<a name="Usage"></a>
<p><hr>
-
-
+<a name="Usage"></a>
+<br>
</div>
<!-- node-name, next, previous, up -->
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpdc @NTPDC_MS@ "27 Feb 2018" "4.2.8p11" "User Commands"
+.TH ntpdc @NTPDC_MS@ "14 Aug 2018" "4.2.8p12" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-MnaqKS/ag-YnaiJS)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-uwaqJD/ag-GwaiID)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:15:03 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:29:36 AM by AutoGen 5.18.5
.\" From the definitions ntpdc-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt NTPDC @NTPDC_MS@ User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpdc-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:15:09 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:29:43 AM by AutoGen 5.18.5
.\" 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 27, 2018 at 05:15:26 PM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:30:02 AM by AutoGen 5.18.5
# 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.8p11
+ntpq - standard NTP query program - Ver. 4.2.8p12
Usage: ntpq [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [ host ...]
Flg Arg Option-Name Description
-4 no ipv4 Force IPv4 name resolution
/*
* EDIT THIS FILE WITH CAUTION (ntpq-opts.c)
*
- * It has been AutoGen-ed February 27, 2018 at 05:15:12 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed August 14, 2018 at 08:29:47 AM by AutoGen 5.18.5
* From the definitions ntpq-opts.def
* and the template file options
*
* static const strings for ntpq options
*/
static char const ntpq_opt_strs[1977] =
-/* 0 */ "ntpq 4.2.8p11\n"
+/* 0 */ "ntpq 4.2.8p12\n"
"Copyright (C) 1992-2017 The University of Delaware and Network Time Foundation, 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"
/* 1768 */ "no-load-opts\0"
/* 1781 */ "no\0"
/* 1784 */ "NTPQ\0"
-/* 1789 */ "ntpq - standard NTP query program - Ver. 4.2.8p11\n"
+/* 1789 */ "ntpq - standard NTP query program - Ver. 4.2.8p12\n"
"Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n\0"
/* 1909 */ "$HOME\0"
/* 1915 */ ".\0"
/* 1917 */ ".ntprc\0"
/* 1924 */ "http://bugs.ntp.org, bugs@ntp.org\0"
-/* 1958 */ "ntpq 4.2.8p11\0"
+/* 1958 */ "ntpq 4.2.8p12\0"
/* 1972 */ "hash";
/**
translate option names.
*/
/* referenced via ntpqOptions.pzCopyright */
- puts(_("ntpq 4.2.8p11\n\
+ puts(_("ntpq 4.2.8p12\n\
Copyright (C) 1992-2017 The University of Delaware and Network Time Foundation, 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.8p11\n\
+ puts(_("ntpq - standard NTP query program - Ver. 4.2.8p12\n\
Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [ host ...]\n"));
/* referenced via ntpqOptions.pzFullVersion */
- puts(_("ntpq 4.2.8p11"));
+ puts(_("ntpq 4.2.8p12"));
/* referenced via ntpqOptions.pzFullUsage */
puts(_("<<<NOT-FOUND>>>"));
/*
* EDIT THIS FILE WITH CAUTION (ntpq-opts.h)
*
- * It has been AutoGen-ed February 27, 2018 at 05:15:12 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed August 14, 2018 at 08:29:47 AM by AutoGen 5.18.5
* From the definitions ntpq-opts.def
* and the template file options
*
/** count of all options for ntpq */
#define OPTION_CT 16
/** ntpq version */
-#define NTPQ_VERSION "4.2.8p11"
+#define NTPQ_VERSION "4.2.8p12"
/** Full ntpq version text */
-#define NTPQ_FULL_VERSION "ntpq 4.2.8p11"
+#define NTPQ_FULL_VERSION "ntpq 4.2.8p12"
/**
* Interface defines for all options. Replace "n" with the UPPER_CASED
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpq 1ntpqman "27 Feb 2018" "4.2.8p11" "User Commands"
+.TH ntpq 1ntpqman "14 Aug 2018" "4.2.8p12" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-D4aGRT/ag-Q4ayQT)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-_XaWRE/ag-lYaOQE)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:15:22 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:29:58 AM by AutoGen 5.18.5
.\" From the definitions ntpq-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt NTPQ 1ntpqmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpq-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:15:28 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:30:05 AM by AutoGen 5.18.5
.\" From the definitions ntpq-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<title>ntpq: Network Time Protocol Query User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="ntpq: Network Time Protocol Query User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpq-Description">ntpq Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpq-Description">ntpq 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">ntpq: Network Time Protocol Query User Manual</h2>
and determine the performance of
<code>ntpd</code>, the NTP daemon.
- <p>This document applies to version 4.2.8p11 of <code>ntpq</code>.
+ <p>This document applies to version 4.2.8p12 of <code>ntpq</code>.
<ul class="menu">
<li><a accesskey="1" href="#ntpq-Description">ntpq Description</a>
</ul>
<div class="node">
-<a name="ntpq-Description"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Usage">Usage</a>,
+
<a name="ntpq-Description"></a>Next: <a rel="next" accesskey="n" href="#Usage">Usage</a>,
Previous: <a rel="previous" accesskey="p" href="#Top">Top</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
<p>For examples and usage, see the <a href="debug.html">NTP Debugging Techniques</a> page.
<div class="node">
-<a name="ntpq-Invocation"></a>
<p><hr>
-
-
+<a name="ntpq-Invocation"></a>
+<br>
</div>
<h3 class="section">Invoking ntpq</h3>
<code>-6</code>
qualifier forces resolution to the IPv6 namespace.
For examples and usage, see the
-“NTP Debugging Techniques”
+NTP Debugging Techniques
page.
<p>Specifying a
These are described following.
<dl>
<dt><code>?</code> <code>[</code><kbd>command</kbd><code>]</code><br><dt><code>help</code> <code>[</code><kbd>command</kbd><code>]</code><dd>A
-‘?’
+?
by itself will print a list of all the commands
known to
<code>ntpq</code>
A
-‘?’
+?
followed by a command name will print function and usage
information about the command.
<br><dt><code>addvars</code> <kbd>name</kbd><code>[=</code><kbd>value</kbd><code>]</code><code>[,...]</code><br><dt><code>rmvars</code> <kbd>name</kbd><code>[,...]</code><br><dt><code>clearvars</code><br><dt><code>showvars</code><dd>The arguments to this command consist of a list of
<code>ntpq</code>
could not decode completely are
marked with a trailing
-‘?’.
+?.
<br><dt><code>debug</code> <code>[more|less|off]</code><dd>With no argument, displays the current debug level.
Otherwise, the debugging level is changed as indicated.
<br><dt><code>delay</code> <code>[</code><kbd>milliseconds</kbd><code>]</code><dd>Specify a time interval to be added to timestamps included in
<dl>
<dt><code>apeers</code><dd>Display a list of peers in the form:
<pre class="example"> [tally]remote refid assid st t when pool reach delay offset jitter
-</pre>
+ </pre>
<p>where the output is just like the
<code>peers</code>
command except that the
is displayed in hex format and the association number is also displayed.
<br><dt><code>associations</code><dd>Display a list of mobilized associations in the form:
<pre class="example"> ind assid status conf reach auth condition last_event cnt
-</pre>
+ </pre>
<dl>
<dt>Sy Variable Ta Sy Description<br><dt><code>ind</code> <code>Ta</code> <code>index</code> <code>on</code> <code>this</code> <code>list</code><br><dt><code>assid</code> <code>Ta</code> <code>association</code> <code>id</code><br><dt><code>status</code> <code>Ta</code> <code>peer</code> <code>status</code> <code>word</code><br><dt><code>conf</code> <code>Ta</code> <code>yes</code>: <code>No</code> <code>persistent,</code> <code>no</code>: <code>No</code> <code>ephemeral</code><br><dt><code>reach</code> <code>Ta</code> <code>yes</code>: <code>No</code> <code>reachable,</code> <code>no</code>: <code>No</code> <code>unreachable</code><br><dt><code>auth</code> <code>Ta</code> <code>ok</code>, <code>yes</code>, <code>bad</code> <code>No</code> <code>and</code> <code>none</code><br><dt><code>condition</code> <code>Ta</code> <code>selection</code> <code>status</code> <code>(see</code> <code>the</code> <code>select</code> <code>No</code> <code>field</code> <code>of</code> <code>the</code> <code>peer</code> <code>status</code> <code>word)</code><br><dt><code>last_event</code> <code>Ta</code> <code>event</code> <code>report</code> <code>(see</code> <code>the</code> <code>event</code> <code>No</code> <code>field</code> <code>of</code> <code>the</code> <code>peer</code> <code>status</code> <code>word)</code><br><dt><code>cnt</code> <code>Ta</code> <code>event</code> <code>count</code> <code>(see</code> <code>the</code> <code>count</code> <code>No</code> <code>field</code> <code>of</code> <code>the</code> <code>peer</code> <code>status</code> <code>word)</code><dd></dl>
<br><dt><code>authinfo</code><dd>Display the authentication statistics counters:
<code>count</code>,
<code>lstint</code>,
or any of those preceded by
-‘-’
+-
to reverse the sort order.
The output columns are:
<dl>
except that it uses previously stored data rather than making a new query.
<br><dt><code>peers</code><dd>Display a list of peers in the form:
<pre class="example"> [tally]remote refid st t when pool reach delay offset jitter
-</pre>
+ </pre>
<dl>
<dt>Variable<dd>Description
<br><dt><code>[tally]</code><dd>single-character code indicating current value of the
multicast server
<br><dt><code>when</code><dd>time in seconds, minutes, hours, or days since the last packet
was received, or
-‘-’
+-
if a packet has never been received
<br><dt><code>poll</code><dd>poll interval (s)
<br><dt><code>reach</code><dd>reach shift register (octal)
<code>date(1)</code>
format specifiers to substitute the current date and time, for
example,
- <pre class="example"> <code>saveconfig</code> <samp><span class="file">ntp-%Y%m%d-%H%M%S.conf</span></samp>.
-</pre>
+ <pre class="example"> <code>saveconfig</code> <span class="file">ntp-%Y%m%d-%H%M%S.conf</span>.
+ </pre>
<p>The filename used is stored in system variable
<code>savedconfig</code>.
Authentication is required.
This software is released under the NTP license, <http://ntp.org/license>.
<ul class="menu">
-<li><a accesskey="1" href="#ntpq-usage">ntpq usage</a>: ntpq help/usage (<samp><span class="option">--help</span></samp>)
+<li><a accesskey="1" href="#ntpq-usage">ntpq usage</a>: ntpq help/usage (<span class="option">--help</span>)
<li><a accesskey="2" href="#ntpq-ipv4">ntpq ipv4</a>: ipv4 option (-4)
<li><a accesskey="3" href="#ntpq-ipv6">ntpq ipv6</a>: ipv6 option (-6)
<li><a accesskey="4" href="#ntpq-command">ntpq command</a>: command option (-c)
</ul>
<div class="node">
-<a name="ntpq-usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpq-ipv4">ntpq ipv4</a>,
+
<a name="ntpq-usage"></a>Next: <a rel="next" accesskey="n" href="#ntpq-ipv4">ntpq ipv4</a>,
Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a>
-
+<br>
</div>
-<h4 class="subsection">ntpq help/usage (<samp><span class="option">--help</span></samp>)</h4>
+<h4 class="subsection">ntpq help/usage (<span class="option">--help</span>)</h4>
<p><a name="index-ntpq-help-3"></a>
This is the automatically generated usage text for ntpq.
<p>The text printed is the same whether selected with the <code>help</code> option
-(<samp><span class="option">--help</span></samp>) or the <code>more-help</code> option (<samp><span class="option">--more-help</span></samp>). <code>more-help</code> will print
+(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
the usage text by passing it through a pager program.
<code>more-help</code> is disabled on platforms without a working
<code>fork(2)</code> function. The <code>PAGER</code> environment variable is
-used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
+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.8p11
Please send bug reports to: <http://bugs.ntp.org, bugs@ntp.org>
</pre>
<div class="node">
-<a name="ntpq-ipv4"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpq-ipv6">ntpq ipv6</a>,
+
<a name="ntpq-ipv4"></a>Next: <a rel="next" accesskey="n" href="#ntpq-ipv6">ntpq ipv6</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpq-usage">ntpq usage</a>,
Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ipv4 option (-4)</h4>
<p>Force resolution of following host names on the command line
to the IPv4 namespace.
<div class="node">
-<a name="ntpq-ipv6"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpq-command">ntpq command</a>,
+
<a name="ntpq-ipv6"></a>Next: <a rel="next" accesskey="n" href="#ntpq-command">ntpq command</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpq-ipv4">ntpq ipv4</a>,
Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ipv6 option (-6)</h4>
<p>Force resolution of following host names on the command line
to the IPv6 namespace.
<div class="node">
-<a name="ntpq-command"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpq-interactive">ntpq interactive</a>,
+
<a name="ntpq-command"></a>Next: <a rel="next" accesskey="n" href="#ntpq-interactive">ntpq interactive</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpq-ipv6">ntpq ipv6</a>,
Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a>
-
+<br>
</div>
<h4 class="subsection">command option (-c)</h4>
<p><a name="index-ntpq_002dcommand-6"></a>
This is the “run a command and exit” option.
-This option takes a string argument <samp><span class="file">cmd</span></samp>.
+This option takes a string argument <span class="file">cmd</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
and is added to the list of commands to be executed on the specified
host(s).
<div class="node">
-<a name="ntpq-interactive"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpq-numeric">ntpq numeric</a>,
+
<a name="ntpq-interactive"></a>Next: <a rel="next" accesskey="n" href="#ntpq-numeric">ntpq numeric</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpq-command">ntpq command</a>,
Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a>
-
+<br>
</div>
<h4 class="subsection">interactive option (-i)</h4>
Prompts will be written to the standard output and
commands read from the standard input.
<div class="node">
-<a name="ntpq-numeric"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpq-old_002drv">ntpq old-rv</a>,
+
<a name="ntpq-numeric"></a>Next: <a rel="next" accesskey="n" href="#ntpq-old_002drv">ntpq old-rv</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpq-interactive">ntpq interactive</a>,
Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a>
-
+<br>
</div>
<h4 class="subsection">numeric option (-n)</h4>
Output all host addresses in dotted-quad numeric format rather than
converting to the canonical host names.
<div class="node">
-<a name="ntpq-old-rv"></a>
-<a name="ntpq-old_002drv"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpq-peers">ntpq peers</a>,
+
<a name="ntpq-old_002drv"></a>Next: <a rel="next" accesskey="n" href="#ntpq-peers">ntpq peers</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpq-numeric">ntpq numeric</a>,
Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a>
-
+<br>
</div>
<h4 class="subsection">old-rv option</h4>
preset this option in a script will enable both older and
newer <code>ntpq</code> to behave identically in this regard.
<div class="node">
-<a name="ntpq-peers"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpq-refid">ntpq refid</a>,
+
<a name="ntpq-peers"></a>Next: <a rel="next" accesskey="n" href="#ntpq-refid">ntpq refid</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpq-old_002drv">ntpq old-rv</a>,
Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a>
-
+<br>
</div>
<h4 class="subsection">peers option (-p)</h4>
<p>Print a list of the peers known to the server as well as a summary
of their state. This is equivalent to the 'peers' interactive command.
<div class="node">
-<a name="ntpq-refid"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpq-wide">ntpq wide</a>,
+
<a name="ntpq-refid"></a>Next: <a rel="next" accesskey="n" href="#ntpq-wide">ntpq wide</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpq-peers">ntpq peers</a>,
Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a>
-
+<br>
</div>
<h4 class="subsection">refid option (-r)</h4>
The argument sets an enumeration value that can be tested by comparing the option value macro (OPT_VALUE_REFID).
The available keywords are:
<pre class="example"> hash ipv4
-</pre>
+ </pre>
<p>or their numeric equivalent.</ul>
<p>Set the default display format for S2+ refids.
<div class="node">
-<a name="ntpq-wide"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpq-config">ntpq config</a>,
+
<a name="ntpq-wide"></a>Next: <a rel="next" accesskey="n" href="#ntpq-config">ntpq config</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpq-refid">ntpq refid</a>,
Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a>
-
+<br>
</div>
<h4 class="subsection">wide option (-w)</h4>
and continue the data display properly indented on the next line.
<div class="node">
-<a name="ntpq-config"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpq-exit-status">ntpq exit status</a>,
+
<a name="ntpq-config"></a>Next: <a rel="next" accesskey="n" href="#ntpq-exit-status">ntpq exit status</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpq-wide">ntpq wide</a>,
Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a>
-
+<br>
</div>
<h4 class="subsection">presetting/configuring ntpq</h4>
<li>$PWD
</ul>
The environment variables <code>HOME</code>, and <code>PWD</code>
-are expanded and replaced when <samp><span class="file">ntpq</span></samp> runs.
+are expanded and replaced when <span class="file">ntpq</span> runs.
For any of these that are plain files, they are simply processed.
-For any that are directories, then a file named <samp><span class="file">.ntprc</span></samp> is searched for
+For any that are directories, then a file named <span class="file">.ntprc</span> is searched for
within that directory and processed.
<p>Configuration files may be in a wide variety of formats.
Only the first letter of the argument is examined:
<dl>
-<dt>‘<samp><span class="samp">version</span></samp>’<dd>Only print the version. This is the default.
-<br><dt>‘<samp><span class="samp">copyright</span></samp>’<dd>Name the copyright usage licensing terms.
-<br><dt>‘<samp><span class="samp">verbose</span></samp>’<dd>Print the full copyright usage licensing terms.
+<dt><span class="samp">version</span><dd>Only print the version. This is the default.
+<br><dt><span class="samp">copyright</span><dd>Name the copyright usage licensing terms.
+<br><dt><span class="samp">verbose</span><dd>Print the full copyright usage licensing terms.
</dl>
<div class="node">
-<a name="ntpq-exit-status"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntpq-config">ntpq config</a>,
+
<a name="ntpq-exit-status"></a>Previous: <a rel="previous" accesskey="p" href="#ntpq-config">ntpq config</a>,
Up: <a rel="up" accesskey="u" href="#ntpq-Invocation">ntpq Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpq exit status</h4>
<p>One of the following exit values will be returned:
<dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
-<br><dt>‘<samp><span class="samp">66 (EX_NOINPUT)</span></samp>’<dd>A specified configuration file could not be loaded.
-<br><dt>‘<samp><span class="samp">70 (EX_SOFTWARE)</span></samp>’<dd>libopts had an internal operational error. Please report
+<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution.
+<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid.
+<br><dt><span class="samp">66 (EX_NOINPUT)</span><dd>A specified configuration file could not be loaded.
+<br><dt><span class="samp">70 (EX_SOFTWARE)</span><dd>libopts had an internal operational error. Please report
it to autogen-users@lists.sourceforge.net. Thank you.
</dl>
<div class="node">
-<a name="Usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Internal-Commands">Internal Commands</a>,
+
<a name="Usage"></a>Next: <a rel="next" accesskey="n" href="#Internal-Commands">Internal Commands</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpq-Description">ntpq Description</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
<br></td></tr></table>
<div class="node">
-<a name="Internal-Commands"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Control-Message-Commands">Control Message Commands</a>,
+
<a name="Internal-Commands"></a>Next: <a rel="next" accesskey="n" href="#Control-Message-Commands">Control Message Commands</a>,
Previous: <a rel="previous" accesskey="p" href="#Usage">Usage</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
<p>Interactive format commands consist of a keyword followed by zero to four arguments. Only enough characters of the full keyword to uniquely identify the command need be typed. The output of a command is normally sent to the standard output, but optionally the output of individual commands may be sent to a file by appending a <code>></code>, followed by a file name, to the command line. A number of interactive format commands are executed entirely within the <code>ntpq</code> program itself and do not result in NTP mode-6 requests being sent to a server. These are described following.
<dl>
-<dt><code><a name="help"></a>? [</code><kbd>command_keyword</kbd><code>]</code><dt><code>help [</code><kbd>command_keyword</kbd><code>]</code><dd>A <code>?</code> by itself will print a list of all the command keywords known to <code>ntpq</code>. A <code>?</code> followed by a command keyword will print function and usage information about the command.
+<dt><code><a name="help"></a> ? [</code><kbd>command_keyword</kbd><code>]</code><dt><code>help [</code><kbd>command_keyword</kbd><code>]</code><dd>A <code>?</code> by itself will print a list of all the command keywords known to <code>ntpq</code>. A <code>?</code> followed by a command keyword will print function and usage information about the command.
- <br><dt><code><a name="addvars"></a>>addvars </code><kbd>name</kbd><code> [ = </code><kbd>value</kbd><code>] [...]</code><dt><code>rmvars </code><kbd>name</kbd><code> [...]</code><dt><code>clearvars</dt></code><dd>The arguments to these commands consist of a list of items of the form
+ <br><dt><code><a name="addvars"></a> >addvars </code><kbd>name</kbd><code> [ = </code><kbd>value</kbd><code>] [...]</code><dt><code>rmvars </code><kbd>name</kbd><code> [...]</code><dt><code>clearvars</dt></code><dd>The arguments to these commands consist of a list of items of the form
<kbd>name</kbd><code> = </code><kbd>value</kbd>, where the <code>= </code><kbd>value</kbd> is ignored,
and can be omitted in read requests.
<code>ntpq</code> maintains an internal list in which data to be included
from the list,
while the <code>clearlist</code> command removes all variables from the list.
- <br><dt><code><a name="cooked"></a>cooked</code><dd>Display server messages in prettyprint format.
+ <br><dt><code><a name="cooked"></a> cooked</code><dd>Display server messages in prettyprint format.
- <br><dt><code><a name="debug"></a>debug more | less | off</code><dd>Turns internal query program debugging on and off.
+ <br><dt><code><a name="debug"></a> debug more | less | off</code><dd>Turns internal query program debugging on and off.
- <br><dt><code><a name="delay"></a>delay </code><kbd>milliseconds</kbd><dd>Specify a time interval to be added to timestamps included in requests which require authentication. This is used to enable (unreliable) server reconfiguration over long delay network paths or between machines whose clocks are unsynchronized. Actually the server does not now require timestamps in authenticated requests, so this command may be obsolete.
+ <br><dt><code><a name="delay"></a> delay </code><kbd>milliseconds</kbd><dd>Specify a time interval to be added to timestamps included in requests which require authentication. This is used to enable (unreliable) server reconfiguration over long delay network paths or between machines whose clocks are unsynchronized. Actually the server does not now require timestamps in authenticated requests, so this command may be obsolete.
- <br><dt><code><a name="host"></a>host </code><kbd>name</kbd><dd>Set the host to which future queries will be sent.
+ <br><dt><code><a name="host"></a> host </code><kbd>name</kbd><dd>Set the host to which future queries will be sent.
The name may be either a DNS name or a numeric address.
- <br><dt><code><a name="hostnames"></a>hostnames [yes | no]</code><dd>If <code>yes</code> is specified, host names are printed in information displays.
+ <br><dt><code><a name="hostnames"></a> hostnames [yes | no]</code><dd>If <code>yes</code> is specified, host names are printed in information displays.
If <code>no</code> is specified, numeric addresses are printed instead.
The default is <code>yes</code>,
unless modified using the command line <code>-n</code> switch.
- <br><dt><code><a name="keyid"></a>keyid </code><kbd>keyid</kbd><dd>This command specifies the key number to be used
+ <br><dt><code><a name="keyid"></a> keyid </code><kbd>keyid</kbd><dd>This command specifies the key number to be used
to authenticate configuration requests.
This must correspond to a key ID configured in <code>ntp.conf</code> for this purpose.
- <br><dt><code><a name="keytype"></a>keytype</code><dd>Specify the digest algorithm to use for authenticated requests,
+ <br><dt><code><a name="keytype"></a> keytype</code><dd>Specify the digest algorithm to use for authenticated requests,
with default <code>MD5</code>.
If the OpenSSL library is installed,
digest can be be any message digest algorithm supported by the library.
The current selections are: <code>AES128CMAC</code>, <code>MD2</code>, <code>MD4</code>, <code>MD5</code>, <code>MDC2</code>, <code>RIPEMD160</code>, <code>SHA</code> and <code>SHA1</code>.
- <br><dt><code><a name="ntpversion"></a>ntpversion 1 | 2 | 3 | 4</code><dd>Sets the NTP version number which <code>ntpq</code> claims in packets.
+ <br><dt><code><a name="ntpversion"></a> ntpversion 1 | 2 | 3 | 4</code><dd>Sets the NTP version number which <code>ntpq</code> claims in packets.
Defaults to 2.
Note that mode-6 control messages (and modes, for that matter)
didn't exist in NTP version 1.
- <br><dt><code><a name="passwd"></a>passwd</code><dd>This command prompts for a password to authenticate requests.
+ <br><dt><code><a name="passwd"></a> passwd</code><dd>This command prompts for a password to authenticate requests.
The password must correspond to the key ID configured in <code>ntp.conf</code> for this purpose.
- <br><dt><code><a name="quit"></a>quit</code><dd>Exit <code>ntpq</code>.
+ <br><dt><code><a name="quit"></a> quit</code><dd>Exit <code>ntpq</code>.
- <br><dt><code><a name="raw"></a>raw</code><dd>Display server messages as received and without reformatting.
+ <br><dt><code><a name="raw"></a> raw</code><dd>Display server messages as received and without reformatting.
- <br><dt><code><a name="timeout"></a>timeout </code><kbd>milliseconds</kbd><dd>Specify a timeout period for responses to server queries.
+ <br><dt><code><a name="timeout"></a> timeout </code><kbd>milliseconds</kbd><dd>Specify a timeout period for responses to server queries.
The default is about 5000 milliseconds.
Note that since <code>ntpq</code> retries each query once after a timeout
the total waiting time for a timeout will be twice the timeout value set.
</dl>
<div class="node">
-<a name="Control-Message-Commands"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Status-Words-and-Kiss-Codes">Status Words and Kiss Codes</a>,
+
<a name="Control-Message-Commands"></a>Next: <a rel="next" accesskey="n" href="#Status-Words-and-Kiss-Codes">Status Words and Kiss Codes</a>,
Previous: <a rel="previous" accesskey="p" href="#Internal-Commands">Internal Commands</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
<br></td></tr></table>
- <br><dt><code><a name="cv"></a>clockvar </code><kbd>assocID</kbd><code> [</code><kbd>name</kbd><code> [ = </code><kbd>value</kbd><code> [...]] [...]]</code><dt><code>cv </code><kbd>assocID</kbd><code> [</code><kbd>name</kbd><code> [ = </code><kbd>value</kbd><code> [...] ][...]]</code><dd>Display a list of <a href="#clock">clock variables</a> for those associations supporting a reference clock.
+ <br><dt><code><a name="cv"></a>
clockvar </code><kbd>assocID</kbd><code> [</code><kbd>name</kbd><code> [ = </code><kbd>value</kbd><code> [...]] [...]]</code><dt><code>cv </code><kbd>assocID</kbd><code> [</code><kbd>name</kbd><code> [ = </code><kbd>value</kbd><code> [...] ][...]]</code><dd>Display a list of <a href="#clock">clock variables</a> for those associations supporting a reference clock.
- <br><dt><code><a name="g_t_003aconfig"></a>:config [...]</code><dd>Send the remainder of the command line, including whitespace, to the server
+ <br><dt><code><a name="_003aconfig"></a> :config [...]</code><dd>Send the remainder of the command line, including whitespace, to the server
as a run-time configuration command in the same format
as the configuration file.
This command is experimental until further notice and clarification.
Authentication is of course required.
- <br><dt><code><a name="config_002dfrom_002dfile"></a>config-from-file </code><kbd>filename</kbd><dd>Send the each line of <kbd>filename</kbd> to the server as
+ <br><dt><code><a name="config_002dfrom_002dfile"></a> config-from-file </code><kbd>filename</kbd><dd>Send the each line of <kbd>filename</kbd> to the server as
run-time configuration commands in the same format as the configuration file.
This command is experimental until further notice and clarification.
Authentication is required.
- <br><dt><code><a name="ifstats"></a>ifstats</code><dd>Display statistics for each local network address.
+ <br><dt><code><a name="ifstats"></a> ifstats</code><dd>Display statistics for each local network address.
Authentication is required.
- <br><dt><code><a name="iostats"></a>iostats</code><dd>Display network and reference clock I/O statistics.
+ <br><dt><code><a name="iostats"></a> iostats</code><dd>Display network and reference clock I/O statistics.
- <br><dt><code><a name="kerninfo"></a>kerninfo</code><dd>Display kernel loop and PPS statistics.
+ <br><dt><code><a name="kerninfo"></a> kerninfo</code><dd>Display kernel loop and PPS statistics.
As with other ntpq output, times are in milliseconds.
The precision value displayed is in milliseconds as well,
unlike the precision system variable.
- <br><dt><code><a name="lassoc"></a>lassociations</code><dd>Perform the same function as the associations command,
+ <br><dt><code><a name="lassoc"></a> lassociations</code><dd>Perform the same function as the associations command,
except display mobilized and unmobilized associations.
- <br><dt><code><a name="monstats"></a>monstats</code><dd>Display monitor facility statistics.
+ <br><dt><code><a name="monstats"></a> monstats</code><dd>Display monitor facility statistics.
- <br><dt><code><a name="mrulist"></a>mrulist [limited | kod | mincount=</code><kbd>count</kbd><code> | laddr=</code><kbd>localaddr</kbd><code> | sort=</code><kbd>sortorder</kbd><code> | resany=</code><kbd>hexmask</kbd><code> | resall=</code><kbd>hexmask</kbd><code>]</code><dd>Obtain and print traffic counts collected and maintained by
+ <br><dt><code><a name="mrulist"></a> mrulist [limited | kod | mincount=</code><kbd>count</kbd><code> | laddr=</code><kbd>localaddr</kbd><code> | sort=</code><kbd>sortorder</kbd><code> | resany=</code><kbd>hexmask</kbd><code> | resall=</code><kbd>hexmask</kbd><code>]</code><dd>Obtain and print traffic counts collected and maintained by
the monitor facility.
With the exception of <code>sort=</code><kbd>sortorder</kbd>,
the options filter the list returned by <code>ntpd</code>.
<br></td></tr></table>
- <br><dt><code><a name="mreadvar"></a>mreadvar </code><kbd>assocID</kbd> <kbd>assocID</kbd><code> [ </code><kbd>variable_name</kbd><code> [ = </code><kbd>value</kbd><code>[ ... ]</code><dt><code><a name="mrv"></a>mrv </code><kbd>assocID</kbd> <kbd>assocID</kbd><code> [ </code><kbd>variable_name</kbd><code> [ = </code><kbd>value</kbd><code>[ ... ]</code><dd>Perform the same function as the <code>readvar</code> command,
+ <br><dt><code><a name="mreadvar"></a> mreadvar </code><kbd>assocID</kbd> <kbd>assocID</kbd><code> [ </code><kbd>variable_name</kbd><code> [ = </code><kbd>value</kbd><code>[ ... ]</code><dt><code><a name="mrv"></a> mrv </code><kbd>assocID</kbd> <kbd>assocID</kbd><code> [ </code><kbd>variable_name</kbd><code> [ = </code><kbd>value</kbd><code>[ ... ]</code><dd>Perform the same function as the <code>readvar</code> command,
except for a range of association IDs.
This range is determined from the association list cached by
the most recent <code>associations</code> command.
- <br><dt><code><a name="passoc"></a>passociations</code><dd>Perform the same function as the <code>associations command</code>, except that
+ <br><dt><code><a name="passoc"></a> passociations</code><dd>Perform the same function as the <code>associations command</code>, except that
it uses previously stored data rather than making a new query.
- <br><dt><code><a name="pe"></a>peers</code><dd>Display a list of peers in the form:
+ <br><dt><code><a name="pe"></a> peers</code><dd>Display a list of peers in the form:
<br>
<code>[tally]remote refid st t when pool reach delay offset jitter</code>
<br></td></tr></table>
- <br><dt><code><a name="rv"></a>readvar </code><kbd>assocID</kbd> <kbd>name</kbd><code> [ = </code><kbd>value</kbd><code> ] [,...]</code><dt><code>rv </code><kbd>assocID</kbd><code> [ </code><kbd>name</kbd><code> ] [,...]</code><dd>Display the specified variables.
+ <br><dt><code><a name="rv"></a> readvar </code><kbd>assocID</kbd> <kbd>name</kbd><code> [ = </code><kbd>value</kbd><code> ] [,...]</code><dt><code>rv </code><kbd>assocID</kbd><code> [ </code><kbd>name</kbd><code> ] [,...]</code><dd>Display the specified variables.
If <kbd>assocID</kbd> is zero,
the variables are from the <a href="#system">system variables</a> name space,
otherwise they are from the <a href="#peer">peer variables</a> name space.
where YYYY is the year, MM the month of year, DD the day of month and
TTTT the time of day.
- <br><dt><code><a name="saveconfig"></a>saveconfig </code><kbd>filename</kbd><dd>Write the current configuration, including any runtime modifications
+ <br><dt><code><a name="saveconfig"></a> saveconfig </code><kbd>filename</kbd><dd>Write the current configuration, including any runtime modifications
given with <code>:config</code> or <code>config-from-file</code>,
to the ntpd host's file <kbd>filename</kbd>.
This command will be rejected by the server unless
The filename used is stored in system variable <code>savedconfig</code>.
Authentication is required.
- <br><dt><code><a name="writevar"></a>writevar </code><kbd>assocID</kbd> <kbd>name</kbd><code> = </code><kbd>value</kbd><code> [,...]</code><dd>Write the specified variables.
+ <br><dt><code><a name="writevar"></a> writevar </code><kbd>assocID</kbd> <kbd>name</kbd><code> = </code><kbd>value</kbd><code> [,...]</code><dd>Write the specified variables.
If the <kbd>assocID</kbd> is zero, the variables are from the
<a href="#system">system variables</a> name space, otherwise they are from the
<a href="#peer">peer variables</a> name space.
The <kbd>assocID</kbd> is required,
as the same name can occur in both spaces.
- <br><dt><code><a name="sysinfo"></a>sysinfo</code><dd>Display operational summary.
+ <br><dt><code><a name="sysinfo"></a> sysinfo</code><dd>Display operational summary.
- <br><dt><code><a name="sysstats"></a>sysstats</code><dd>Print statistics counters maintained in the protocol module.
+ <br><dt><code><a name="sysstats"></a> sysstats</code><dd>Print statistics counters maintained in the protocol module.
</dl>
<div class="node">
-<a name="Status-Words-and-Kiss-Codes"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#System-Variables">System Variables</a>,
+
<a name="Status-Words-and-Kiss-Codes"></a>Next: <a rel="next" accesskey="n" href="#System-Variables">System Variables</a>,
Previous: <a rel="previous" accesskey="p" href="#Control-Message-Commands">Control Message Commands</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
in the reference identifier field in various billboards.
<div class="node">
-<a name="System-Variables"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Peer-Variables">Peer Variables</a>,
+
<a name="System-Variables"></a>Next: <a rel="next" accesskey="n" href="#Peer-Variables">Peer Variables</a>,
Previous: <a rel="previous" accesskey="p" href="#Status-Words-and-Kiss-Codes">Status Words and Kiss Codes</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
<br></td></tr></table>
<div class="node">
-<a name="Peer-Variables"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Clock-Variables">Clock Variables</a>,
+
<a name="Peer-Variables"></a>Next: <a rel="next" accesskey="n" href="#Clock-Variables">Clock Variables</a>,
Previous: <a rel="previous" accesskey="p" href="#System-Variables">System Variables</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
<br></td></tr></table>
<div class="node">
-<a name="Clock-Variables"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#Peer-Variables">Peer Variables</a>,
+
<a name="Clock-Variables"></a>Previous: <a rel="previous" accesskey="p" href="#Peer-Variables">Peer Variables</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpq @NTPQ_MS@ "27 Feb 2018" "4.2.8p11" "User Commands"
+.TH ntpq @NTPQ_MS@ "14 Aug 2018" "4.2.8p12" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-D4aGRT/ag-Q4ayQT)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-_XaWRE/ag-lYaOQE)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:15:22 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:29:58 AM by AutoGen 5.18.5
.\" From the definitions ntpq-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt NTPQ @NTPQ_MS@ User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpq-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:15:28 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:30:05 AM by AutoGen 5.18.5
.\" 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 27, 2018 at 05:15:36 PM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:30:14 AM by AutoGen 5.18.5
# From the definitions ntpsnmpd-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
/*
* EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.c)
*
- * It has been AutoGen-ed February 27, 2018 at 05:15:31 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed August 14, 2018 at 08:30:08 AM by AutoGen 5.18.5
* From the definitions ntpsnmpd-opts.def
* and the template file options
*
* static const strings for ntpsnmpd options
*/
static char const ntpsnmpd_opt_strs[1613] =
-/* 0 */ "ntpsnmpd 4.2.8p11\n"
+/* 0 */ "ntpsnmpd 4.2.8p12\n"
"Copyright (C) 1992-2017 The University of Delaware and Network Time Foundation, 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"
/* 1415 */ "no-load-opts\0"
/* 1428 */ "no\0"
/* 1431 */ "NTPSNMPD\0"
-/* 1440 */ "ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.8p11\n"
+/* 1440 */ "ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.8p12\n"
"Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n\0"
/* 1544 */ "$HOME\0"
/* 1550 */ ".\0"
/* 1552 */ ".ntprc\0"
/* 1559 */ "http://bugs.ntp.org, bugs@ntp.org\0"
/* 1593 */ "\n\0"
-/* 1595 */ "ntpsnmpd 4.2.8p11";
+/* 1595 */ "ntpsnmpd 4.2.8p12";
/**
* nofork option description:
translate option names.
*/
/* referenced via ntpsnmpdOptions.pzCopyright */
- puts(_("ntpsnmpd 4.2.8p11\n\
+ puts(_("ntpsnmpd 4.2.8p12\n\
Copyright (C) 1992-2017 The University of Delaware and Network Time Foundation, 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.8p11\n\
+ puts(_("ntpsnmpd - NTP SNMP MIB agent - Ver. 4.2.8p12\n\
Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n"));
/* referenced via ntpsnmpdOptions.pzExplain */
puts(_("\n"));
/* referenced via ntpsnmpdOptions.pzFullVersion */
- puts(_("ntpsnmpd 4.2.8p11"));
+ puts(_("ntpsnmpd 4.2.8p12"));
/* referenced via ntpsnmpdOptions.pzFullUsage */
puts(_("<<<NOT-FOUND>>>"));
/*
* EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.h)
*
- * It has been AutoGen-ed February 27, 2018 at 05:15:31 PM by AutoGen 5.18.5
+ * It has been AutoGen-ed August 14, 2018 at 08:30:08 AM by AutoGen 5.18.5
* From the definitions ntpsnmpd-opts.def
* and the template file options
*
/** count of all options for ntpsnmpd */
#define OPTION_CT 8
/** ntpsnmpd version */
-#define NTPSNMPD_VERSION "4.2.8p11"
+#define NTPSNMPD_VERSION "4.2.8p12"
/** Full ntpsnmpd version text */
-#define NTPSNMPD_FULL_VERSION "ntpsnmpd 4.2.8p11"
+#define NTPSNMPD_FULL_VERSION "ntpsnmpd 4.2.8p12"
/**
* Interface defines for all options. Replace "n" with the UPPER_CASED
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpsnmpd 1ntpsnmpdman "27 Feb 2018" "4.2.8p11" "User Commands"
+.TH ntpsnmpd 1ntpsnmpdman "14 Aug 2018" "4.2.8p12" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-_Ia4FU/ag-lJaWEU)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-vVaOGF/ag-HVaGFF)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:15:33 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:30:10 AM by AutoGen 5.18.5
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt NTPSNMPD 1ntpsnmpdmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:15:39 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:30:16 AM by AutoGen 5.18.5
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<title>ntpsnmpd: Network Time Protocol SNMP Daemon User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="ntpsnmpd: Network Time Protocol SNMP Daemon User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpsnmpd-Description">ntpsnmpd Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpsnmpd-Description">ntpsnmpd 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">ntpsnmpd: Network Time Protocol Query User Manual</h2>
<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.8p11 of <code>ntpsnmpd</code>.
+ <p>This document applies to version 4.2.8p12 of <code>ntpsnmpd</code>.
<ul class="menu">
<li><a accesskey="1" href="#ntpsnmpd-Description">ntpsnmpd Description</a>: Description
</ul>
<div class="node">
-<a name="ntpsnmpd-Description"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Usage">Usage</a>,
+
<a name="ntpsnmpd-Description"></a>Next: <a rel="next" accesskey="n" href="#Usage">Usage</a>,
Previous: <a rel="previous" accesskey="p" href="#Top">Top</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
<p>The <code>ntpsnmpd</code> utility program provides an SNMP MIB agent for <code>ntpd</code>.
<div class="node">
-<a name="Usage"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntpsnmpd-Description">ntpsnmpd Description</a>,
+
<a name="Usage"></a>Previous: <a rel="previous" accesskey="p" href="#ntpsnmpd-Description">ntpsnmpd Description</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpsnmpd @NTPSNMPD_MS@ "27 Feb 2018" "4.2.8p11" "User Commands"
+.TH ntpsnmpd @NTPSNMPD_MS@ "14 Aug 2018" "4.2.8p12" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-_Ia4FU/ag-lJaWEU)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-vVaOGF/ag-HVaGFF)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:15:33 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:30:10 AM by AutoGen 5.18.5
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt NTPSNMPD @NTPSNMPD_MS@ User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpsnmpd-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:15:39 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:30:16 AM by AutoGen 5.18.5
.\" From the definitions ntpsnmpd-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
# - Numeric values increment
# - empty 'increments' to 1
# - NEW 'increments' to empty
-point=11
+point=12
### betapoint is normally modified by script.
# ntp-stable Beta number (betapoint)
# - - prerelease is emptied
# else (not in RC)
# - rcpoint is empty and unused (for now).
-rcpoint=GO
+rcpoint=
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH calc_tickadj 1calc_tickadjman "27 Feb 2018" "ntp (4.2.8p11)" "User Commands"
+.TH calc_tickadj 1calc_tickadjman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-mfaiQP/ag-zfaqPP)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-98aG9a/ag-j9aG8a)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:49:40 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:08:53 AM by AutoGen 5.18.5
.\" From the definitions calc_tickadj-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt CALC_TICKADJ 1calc_tickadjmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (calc_tickadj-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:49:43 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:08:56 AM by AutoGen 5.18.5
.\" From the definitions calc_tickadj-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<h2 class="unnumbered">calc_tickadj User's Manual</h2>
<p>This document describes the use of the NTP Project's <code>calc_tickadj</code> program.
-This document applies to version 4.2.8p11 of <code>calc_tickadj</code>.
+This document applies to version 4.2.8p12 of <code>calc_tickadj</code>.
<div class="shortcontents">
<h2>Short Contents</h2>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH calc_tickadj 1calc_tickadjman "27 Feb 2018" "ntp (4.2.8p11)" "User Commands"
+.TH calc_tickadj 1calc_tickadjman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-mfaiQP/ag-zfaqPP)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-98aG9a/ag-j9aG8a)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:49:40 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:08:53 AM by AutoGen 5.18.5
.\" From the definitions calc_tickadj-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt CALC_TICKADJ 1calc_tickadjmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (calc_tickadj-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:49:43 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:08:56 AM by AutoGen 5.18.5
.\" From the definitions calc_tickadj-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-calc_tickadj.texi)
#
-# It has been AutoGen-ed February 27, 2018 at 10:49:45 AM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:08:59 AM by AutoGen 5.18.5
# From the definitions calc_tickadj-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
#
# EDIT THIS FILE WITH CAUTION (invoke-plot_summary.texi)
#
-# It has been AutoGen-ed February 27, 2018 at 04:55:58 PM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:09:41 AM by AutoGen 5.18.5
# From the definitions plot_summary-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-plot_summary - plot statistics generated by summary script - Ver. 4.2.8p11
+plot_summary - plot statistics generated by summary script - Ver. 4.2.8p12
USAGE: plot_summary [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
--directory=str Where the summary files are
#
# EDIT THIS FILE WITH CAUTION (invoke-summary.texi)
#
-# It has been AutoGen-ed February 27, 2018 at 04:56:04 PM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:09:47 AM by AutoGen 5.18.5
# From the definitions summary-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-summary - compute various stastics from NTP stat files - Ver. 4.2.8p11
+summary - compute various stastics from NTP stat files - Ver. 4.2.8p12
USAGE: summary [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
--directory=str Directory containing stat files
#
# EDIT THIS FILE WITH CAUTION (invoke-ntp-wait.texi)
#
-# It has been AutoGen-ed February 27, 2018 at 10:49:53 AM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:09:07 AM by AutoGen 5.18.5
# From the definitions ntp-wait-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p11
+ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p12
USAGE: ntp-wait [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]...
-n, --tries=num Number of times to check ntpd
# EDIT THIS FILE WITH CAUTION (ntp-wait-opts)
#
-# It has been AutoGen-ed February 27, 2018 at 10:49:48 AM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:09:02 AM by AutoGen 5.18.5
# From the definitions ntp-wait-opts.def
# and the template file perlopt
'help|?', 'more-help'));
$usage = <<'USAGE';
-ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p11
+ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p12
USAGE: ntp-wait [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
-n, --tries=num Number of times to check ntpd
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntp-wait 1ntp-waitman "27 Feb 2018" "ntp (4.2.8p11)" "User Commands"
+.TH ntp-wait 1ntp-waitman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-tuay0Q/ag-GuaGZQ)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-GBaimc/ag-SBaqlc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:49:50 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:04 AM by AutoGen 5.18.5
.\" From the definitions ntp-wait-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt NTP_WAIT 1ntp-waitmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntp-wait-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:49:55 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:10 AM by AutoGen 5.18.5
.\" From the definitions ntp-wait-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<title>Ntp-wait User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Ntp-wait User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<h1 class="settitle">Ntp-wait User's Manual</h1>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Description">ntp-wait Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Description">ntp-wait Description</a>,
Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-
+<br>
</div>
<p>This document describes the use of the NTP Project's <code>ntp-wait</code> program.
and only then start any applicaitons (like database servers) that require
accurate and stable time.
- <p>This document applies to version 4.2.8p11 of <code>ntp-wait</code>.
+ <p>This document applies to version 4.2.8p12 of <code>ntp-wait</code>.
<div class="shortcontents">
<h2>Short Contents</h2>
</ul>
<div class="node">
-<a name="ntp-wait-Invocation"></a>
-<a name="ntp_002dwait-Invocation"></a>
<p><hr>
-
-
+<a name="ntp_002dwait-Invocation"></a>
+<br>
</div>
<h3 class="section">0.1 Invoking ntp-wait</h3>
using the <code>agtexi-cmd</code> template and the option descriptions for the <code>ntp-wait</code> program.
<ul class="menu">
-<li><a accesskey="1" href="#ntp_002dwait-usage">ntp-wait usage</a>: ntp-wait help/usage (<samp><span class="option">--help</span></samp>)
+<li><a accesskey="1" href="#ntp_002dwait-usage">ntp-wait usage</a>: ntp-wait help/usage (<span class="option">--help</span>)
<li><a accesskey="2" href="#ntp_002dwait-tries">ntp-wait tries</a>: tries option (-n)
<li><a accesskey="3" href="#ntp_002dwait-sleep">ntp-wait sleep</a>: sleep option (-s)
<li><a accesskey="4" href="#ntp_002dwait-verbose">ntp-wait verbose</a>: verbose option (-v)
</ul>
<div class="node">
-<a name="ntp-wait-usage"></a>
-<a name="ntp_002dwait-usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait-tries">ntp-wait tries</a>,
+
<a name="ntp_002dwait-usage"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-tries">ntp-wait tries</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>
-
+<br>
</div>
-<h4 class="subsection">0.1.1 ntp-wait help/usage (<samp><span class="option">--help</span></samp>)</h4>
+<h4 class="subsection">0.1.1 ntp-wait help/usage (<span class="option">--help</span>)</h4>
<p><a name="index-ntp_002dwait-help-3"></a>
This is the automatically generated usage text for ntp-wait.
<p>The text printed is the same whether selected with the <code>help</code> option
-(<samp><span class="option">--help</span></samp>) or the <code>more-help</code> option (<samp><span class="option">--more-help</span></samp>). <code>more-help</code> will print
+(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
the usage text by passing it through a pager program.
<code>more-help</code> is disabled on platforms without a working
<code>fork(2)</code> function. The <code>PAGER</code> environment variable is
-used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
+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-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p11
+<pre class="example">ntp-wait - Wait for ntpd to stabilize the system clock - Ver. 4.2.8p12
USAGE: ntp-wait [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
-n, --tries=num Number of times to check ntpd
hyphen and the flag character.
</pre>
<div class="node">
-<a name="ntp-wait-tries"></a>
-<a name="ntp_002dwait-tries"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait-sleep">ntp-wait sleep</a>,
+
<a name="ntp_002dwait-tries"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-sleep">ntp-wait sleep</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-usage">ntp-wait usage</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.2 tries option (-n)</h4>
The maximum number of times we will check <code>ntpd</code> to see if
it has been able to synchronize and stabilize the system clock.
<div class="node">
-<a name="ntp-wait-sleep"></a>
-<a name="ntp_002dwait-sleep"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait-verbose">ntp-wait verbose</a>,
+
<a name="ntp_002dwait-sleep"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-verbose">ntp-wait verbose</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-tries">ntp-wait tries</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.3 sleep option (-s)</h4>
<p><a name="index-ntp_002dwait_002dsleep-5"></a>
This is the “how long to sleep between tries” option.
-This option takes a number argument <samp><span class="file">secs-between-tries</span></samp>.
- We will sleep for <samp><span class="file">secs-between-tries</span></samp> after each query
+This option takes a number argument <span class="file">secs-between-tries</span>.
+ We will sleep for <span class="file">secs-between-tries</span> after each query
of <code>ntpd</code> that returns "the time is not yet stable".
<div class="node">
-<a name="ntp-wait-verbose"></a>
-<a name="ntp_002dwait-verbose"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait-exit-status">ntp-wait exit status</a>,
+
<a name="ntp_002dwait-verbose"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-exit-status">ntp-wait exit status</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-sleep">ntp-wait sleep</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.4 verbose option (-v)</h4>
By default, <code>ntp-wait</code> is silent.
With this option, <code>ntp-wait</code> will provide status information.
<div class="node">
-<a name="ntp-wait-exit-status"></a>
-<a name="ntp_002dwait-exit-status"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Authors">ntp-wait Authors</a>,
+
<a name="ntp_002dwait-exit-status"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Authors">ntp-wait Authors</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-verbose">ntp-wait verbose</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.5 ntp-wait exit status</h4>
<p>One of the following exit values will be returned:
<dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
+<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution.
+<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid.
</dl>
<div class="node">
-<a name="ntp-wait-Authors"></a>
-<a name="ntp_002dwait-Authors"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Notes">ntp-wait Notes</a>,
+
<a name="ntp_002dwait-Authors"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dwait-Notes">ntp-wait Notes</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-exit-status">ntp-wait exit status</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.6 ntp-wait Authors</h4>
<div class="node">
-<a name="ntp-wait-Notes"></a>
-<a name="ntp_002dwait-Notes"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-Authors">ntp-wait Authors</a>,
+
<a name="ntp_002dwait-Notes"></a>Previous: <a rel="previous" accesskey="p" href="#ntp_002dwait-Authors">ntp-wait Authors</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dwait-Invocation">ntp-wait Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.7 ntp-wait Notes</h4>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntp-wait @NTP_WAIT_MS@ "27 Feb 2018" "ntp (4.2.8p11)" "User Commands"
+.TH ntp-wait @NTP_WAIT_MS@ "14 Aug 2018" "ntp (4.2.8p12)" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-tuay0Q/ag-GuaGZQ)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-GBaimc/ag-SBaqlc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:49:50 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:04 AM by AutoGen 5.18.5
.\" From the definitions ntp-wait-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt NTP_WAIT @NTP_WAIT_MS@ User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntp-wait-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:49:55 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:10 AM by AutoGen 5.18.5
.\" From the definitions ntp-wait-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-ntpsweep.texi)
#
-# It has been AutoGen-ed February 27, 2018 at 10:49:59 AM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:09:13 AM by AutoGen 5.18.5
# From the definitions ntpsweep-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p11
+ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p12
USAGE: ntpsweep [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [hostfile]
-l, --host-list=str Host to execute actions on
# EDIT THIS FILE WITH CAUTION (ntpsweep-opts)
#
-# It has been AutoGen-ed February 27, 2018 at 10:49:57 AM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:09:11 AM by AutoGen 5.18.5
# From the definitions ntpsweep-opts.def
# and the template file perlopt
'help|?', 'more-help'));
$usage = <<'USAGE';
-ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p11
+ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p12
USAGE: ntpsweep [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [hostfile]
-l, --host-list=str Host to execute actions on
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpsweep 1ntpsweepman "27 Feb 2018" "ntp (4.2.8p11)" "User Commands"
+.TH ntpsweep 1ntpsweepman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-cfaGaS/ag-pfaO_R)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-csaqyd/ag-psayxd)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:50:01 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:15 AM by AutoGen 5.18.5
.\" From the definitions ntpsweep-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt NTPSWEEP 1ntpsweepmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpsweep-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:50:04 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:18 AM by AutoGen 5.18.5
.\" From the definitions ntpsweep-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<title>ntpsweep User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="ntpsweep User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<h1 class="settitle">ntpsweep User's Manual</h1>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpsweep-Description">ntpsweep Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-Description">ntpsweep Description</a>,
Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-
+<br>
</div>
<p>This document describes the use of the NTP Project's <code>ntpsweep</code> program.
- <p>This document applies to version 4.2.8p11 of <code>ntpsweep</code>.
+ <p>This document applies to version 4.2.8p12 of <code>ntpsweep</code>.
<div class="shortcontents">
<h2>Short Contents</h2>
</ul>
<div class="node">
-<a name="ntpsweep-Invocation"></a>
<p><hr>
-
-
+<a name="ntpsweep-Invocation"></a>
+<br>
</div>
<h3 class="section">0.1 Invoking ntpsweep</h3>
using the <code>agtexi-cmd</code> template and the option descriptions for the <code>ntpsweep</code> program.
<ul class="menu">
-<li><a accesskey="1" href="#ntpsweep-usage">ntpsweep usage</a>: ntpsweep help/usage (<samp><span class="option">--help</span></samp>)
+<li><a accesskey="1" href="#ntpsweep-usage">ntpsweep usage</a>: ntpsweep help/usage (<span class="option">--help</span>)
<li><a accesskey="2" href="#ntpsweep-host_002dlist">ntpsweep host-list</a>: host-list option (-l)
<li><a accesskey="3" href="#ntpsweep-peers">ntpsweep peers</a>: peers option (-p)
<li><a accesskey="4" href="#ntpsweep-maxlevel">ntpsweep maxlevel</a>: maxlevel option (-m)
</ul>
<div class="node">
-<a name="ntpsweep-usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpsweep-host_002dlist">ntpsweep host-list</a>,
+
<a name="ntpsweep-usage"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-host_002dlist">ntpsweep host-list</a>,
Up: <a rel="up" accesskey="u" href="#ntpsweep-Invocation">ntpsweep Invocation</a>
-
+<br>
</div>
-<h4 class="subsection">0.1.1 ntpsweep help/usage (<samp><span class="option">--help</span></samp>)</h4>
+<h4 class="subsection">0.1.1 ntpsweep help/usage (<span class="option">--help</span>)</h4>
<p><a name="index-ntpsweep-help-3"></a>
This is the automatically generated usage text for ntpsweep.
<p>The text printed is the same whether selected with the <code>help</code> option
-(<samp><span class="option">--help</span></samp>) or the <code>more-help</code> option (<samp><span class="option">--more-help</span></samp>). <code>more-help</code> will print
+(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
the usage text by passing it through a pager program.
<code>more-help</code> is disabled on platforms without a working
<code>fork(2)</code> function. The <code>PAGER</code> environment variable is
-used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <span class="file">more</span>. Both will exit
with a status code of 0.
-<pre class="example">ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p11
+<pre class="example">ntpsweep - Print various informations about given ntp servers - Ver. 4.2.8p12
USAGE: ntpsweep [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [hostfile]
-l, --host-list=str Host to execute actions on
hyphen and the flag character.
</pre>
<div class="node">
-<a name="ntpsweep-host-list"></a>
-<a name="ntpsweep-host_002dlist"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpsweep-peers">ntpsweep peers</a>,
+
<a name="ntpsweep-host_002dlist"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-peers">ntpsweep peers</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpsweep-usage">ntpsweep usage</a>,
Up: <a rel="up" accesskey="u" href="#ntpsweep-Invocation">ntpsweep Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.2 host-list option (-l)</h4>
<p>Use this option to specify the host on which this script operates.
May appear multiple times.
<div class="node">
-<a name="ntpsweep-peers"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpsweep-maxlevel">ntpsweep maxlevel</a>,
+
<a name="ntpsweep-peers"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-maxlevel">ntpsweep maxlevel</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpsweep-host_002dlist">ntpsweep host-list</a>,
Up: <a rel="up" accesskey="u" href="#ntpsweep-Invocation">ntpsweep Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.3 peers option (-p)</h4>
<p><a name="index-ntpsweep_002dpeers-5"></a>
This is the “recursively list all peers a host synchronizes to” option.
-This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
+This option has no <span class="samp">doc</span> documentation.
<div class="node">
-<a name="ntpsweep-maxlevel"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpsweep-strip">ntpsweep strip</a>,
+
<a name="ntpsweep-maxlevel"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-strip">ntpsweep strip</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpsweep-peers">ntpsweep peers</a>,
Up: <a rel="up" accesskey="u" href="#ntpsweep-Invocation">ntpsweep Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.4 maxlevel option (-m)</h4>
<p><a name="index-ntpsweep_002dmaxlevel-6"></a>
This is the “traverse peers up to this level (4 is a reasonable number)” option.
This option takes a number argument.
-This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
+This option has no <span class="samp">doc</span> documentation.
<div class="node">
-<a name="ntpsweep-strip"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpsweep-host">ntpsweep host</a>,
+
<a name="ntpsweep-strip"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-host">ntpsweep host</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpsweep-maxlevel">ntpsweep maxlevel</a>,
Up: <a rel="up" accesskey="u" href="#ntpsweep-Invocation">ntpsweep Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.5 strip option (-s)</h4>
<p><a name="index-ntpsweep_002dstrip-7"></a>
This is the “strip this string from hostnames” option.
This option takes a string argument.
-This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
+This option has no <span class="samp">doc</span> documentation.
<div class="node">
-<a name="ntpsweep-host"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntpsweep-exit-status">ntpsweep exit status</a>,
+
<a name="ntpsweep-host"></a>Next: <a rel="next" accesskey="n" href="#ntpsweep-exit-status">ntpsweep exit status</a>,
Previous: <a rel="previous" accesskey="p" href="#ntpsweep-strip">ntpsweep strip</a>,
Up: <a rel="up" accesskey="u" href="#ntpsweep-Invocation">ntpsweep Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.6 host option (-h)</h4>
<p><a name="index-ntpsweep_002dhost-8"></a>
This is the “specify a single host” option.
This option takes a string argument.
-This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
+This option has no <span class="samp">doc</span> documentation.
<p><strong>NOTE</strong><strong>: THIS OPTION IS DEPRECATED</strong>
<div class="node">
-<a name="ntpsweep-exit-status"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntpsweep-host">ntpsweep host</a>,
+
<a name="ntpsweep-exit-status"></a>Previous: <a rel="previous" accesskey="p" href="#ntpsweep-host">ntpsweep host</a>,
Up: <a rel="up" accesskey="u" href="#ntpsweep-Invocation">ntpsweep Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.7 ntpsweep exit status</h4>
<p>One of the following exit values will be returned:
<dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
+<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution.
+<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid.
</dl>
</body></html>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntpsweep 1ntpsweepman "27 Feb 2018" "ntp (4.2.8p11)" "User Commands"
+.TH ntpsweep 1ntpsweepman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-cfaGaS/ag-pfaO_R)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-csaqyd/ag-psayxd)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:50:01 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:15 AM by AutoGen 5.18.5
.\" From the definitions ntpsweep-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt NTPSWEEP 1ntpsweepmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntpsweep-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:50:04 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:18 AM by AutoGen 5.18.5
.\" From the definitions ntpsweep-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-ntptrace.texi)
#
-# It has been AutoGen-ed February 27, 2018 at 10:50:11 AM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:09:25 AM by AutoGen 5.18.5
# From the definitions ntptrace-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
@exampleindent 0
@example
-ntptrace - Trace peers of an NTP server - Ver. 4.2.8p11
+ntptrace - Trace peers of an NTP server - Ver. 4.2.8p12
USAGE: ntptrace [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... [host]
-n, --numeric Print IP addresses instead of hostnames
# EDIT THIS FILE WITH CAUTION (ntptrace-opts)
#
-# It has been AutoGen-ed February 27, 2018 at 10:50:06 AM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:09:20 AM by AutoGen 5.18.5
# From the definitions ntptrace-opts.def
# and the template file perlopt
'help|?', 'more-help'));
$usage = <<'USAGE';
-ntptrace - Trace peers of an NTP server - Ver. 4.2.8p11
+ntptrace - Trace peers of an NTP server - Ver. 4.2.8p12
USAGE: ntptrace [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [host]
-n, --numeric Print IP addresses instead of hostnames
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntptrace 1ntptraceman "27 Feb 2018" "ntp (4.2.8p11)" "User Commands"
+.TH ntptrace 1ntptraceman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-wXa4cT/ag-JXaacT)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-n1aOAe/ag-B1aWze)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:50:08 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:22 AM by AutoGen 5.18.5
.\" From the definitions ntptrace-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt NTPTRACE 1ntptracemdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntptrace-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:50:13 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:27 AM by AutoGen 5.18.5
.\" From the definitions ntptrace-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<title>Ntptrace User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Ntptrace User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<h1 class="settitle">Ntptrace User's Manual</h1>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntptrace-Description">ntptrace Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#ntptrace-Description">ntptrace 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>
<p>This document describes the use of the NTP Project's <code>ntptrace</code> program.
-This document applies to version 4.2.8p11 of <code>ntptrace</code>.
+This document applies to version 4.2.8p12 of <code>ntptrace</code>.
<div class="shortcontents">
<h2>Short Contents</h2>
</ul>
<div class="node">
-<a name="ntptrace-Invocation"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntptrace-Description">ntptrace Description</a>,
+
<a name="ntptrace-Invocation"></a>Previous: <a rel="previous" accesskey="p" href="#ntptrace-Description">ntptrace Description</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<h3 class="section">Invoking ntptrace</h3>
using the <code>agtexi-cmd</code> template and the option descriptions for the <code>ntptrace</code> program.
<ul class="menu">
-<li><a accesskey="1" href="#ntptrace-usage">ntptrace usage</a>: ntptrace help/usage (<samp><span class="option">--help</span></samp>)
+<li><a accesskey="1" href="#ntptrace-usage">ntptrace usage</a>: ntptrace help/usage (<span class="option">--help</span>)
<li><a accesskey="2" href="#ntptrace-numeric">ntptrace numeric</a>: numeric option (-n)
<li><a accesskey="3" href="#ntptrace-max_002dhosts">ntptrace max-hosts</a>: max-hosts option (-m)
<li><a accesskey="4" href="#ntptrace-host">ntptrace host</a>: host option (-r)
</ul>
<div class="node">
-<a name="ntptrace-usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntptrace-numeric">ntptrace numeric</a>,
+
<a name="ntptrace-usage"></a>Next: <a rel="next" accesskey="n" href="#ntptrace-numeric">ntptrace numeric</a>,
Up: <a rel="up" accesskey="u" href="#ntptrace-Invocation">ntptrace Invocation</a>
-
+<br>
</div>
-<h4 class="subsection">ntptrace help/usage (<samp><span class="option">--help</span></samp>)</h4>
+<h4 class="subsection">ntptrace help/usage (<span class="option">--help</span>)</h4>
<p><a name="index-ntptrace-help-3"></a>
This is the automatically generated usage text for ntptrace.
<p>The text printed is the same whether selected with the <code>help</code> option
-(<samp><span class="option">--help</span></samp>) or the <code>more-help</code> option (<samp><span class="option">--more-help</span></samp>). <code>more-help</code> will print
+(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
the usage text by passing it through a pager program.
<code>more-help</code> is disabled on platforms without a working
<code>fork(2)</code> function. The <code>PAGER</code> environment variable is
-used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <span class="file">more</span>. Both will exit
with a status code of 0.
-<pre class="example">ntptrace - Trace peers of an NTP server - Ver. 4.2.8p11
+<pre class="example">ntptrace - Trace peers of an NTP server - Ver. 4.2.8p12
USAGE: ntptrace [ -<flag> [<val>] | --<name>[{=| }<val>] ]... [host]
-n, --numeric Print IP addresses instead of hostnames
hyphen and the flag character.
</pre>
<div class="node">
-<a name="ntptrace-numeric"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntptrace-max_002dhosts">ntptrace max-hosts</a>,
+
<a name="ntptrace-numeric"></a>Next: <a rel="next" accesskey="n" href="#ntptrace-max_002dhosts">ntptrace max-hosts</a>,
Previous: <a rel="previous" accesskey="p" href="#ntptrace-usage">ntptrace usage</a>,
Up: <a rel="up" accesskey="u" href="#ntptrace-Invocation">ntptrace Invocation</a>
-
+<br>
</div>
<h4 class="subsection">numeric option (-n)</h4>
Output hosts as dotted-quad numeric format rather than converting to
the canonical host names.
<div class="node">
-<a name="ntptrace-max-hosts"></a>
-<a name="ntptrace-max_002dhosts"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntptrace-host">ntptrace host</a>,
+
<a name="ntptrace-max_002dhosts"></a>Next: <a rel="next" accesskey="n" href="#ntptrace-host">ntptrace host</a>,
Previous: <a rel="previous" accesskey="p" href="#ntptrace-numeric">ntptrace numeric</a>,
Up: <a rel="up" accesskey="u" href="#ntptrace-Invocation">ntptrace Invocation</a>
-
+<br>
</div>
<h4 class="subsection">max-hosts option (-m)</h4>
<p><a name="index-ntptrace_002dmax_002dhosts-5"></a>
This is the “maximum number of peers to trace” option.
This option takes a number argument.
-This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
+This option has no <span class="samp">doc</span> documentation.
<div class="node">
-<a name="ntptrace-host"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntptrace-exit-status">ntptrace exit status</a>,
+
<a name="ntptrace-host"></a>Next: <a rel="next" accesskey="n" href="#ntptrace-exit-status">ntptrace exit status</a>,
Previous: <a rel="previous" accesskey="p" href="#ntptrace-max_002dhosts">ntptrace max-hosts</a>,
Up: <a rel="up" accesskey="u" href="#ntptrace-Invocation">ntptrace Invocation</a>
-
+<br>
</div>
<h4 class="subsection">host option (-r)</h4>
<p><a name="index-ntptrace_002dhost-6"></a>
This is the “single remote host” option.
This option takes a string argument.
-This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
+This option has no <span class="samp">doc</span> documentation.
<div class="node">
-<a name="ntptrace-exit-status"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntptrace-host">ntptrace host</a>,
+
<a name="ntptrace-exit-status"></a>Previous: <a rel="previous" accesskey="p" href="#ntptrace-host">ntptrace host</a>,
Up: <a rel="up" accesskey="u" href="#ntptrace-Invocation">ntptrace Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntptrace exit status</h4>
<p>One of the following exit values will be returned:
<dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
+<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution.
+<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid.
</dl>
</body></html>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntptrace @NTPTRACE_MS@ "27 Feb 2018" "ntp (4.2.8p11)" "User Commands"
+.TH ntptrace @NTPTRACE_MS@ "14 Aug 2018" "ntp (4.2.8p12)" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-wXa4cT/ag-JXaacT)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-n1aOAe/ag-B1aWze)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:50:08 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:22 AM by AutoGen 5.18.5
.\" From the definitions ntptrace-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt NTPTRACE @NTPTRACE_MS@ User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntptrace-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:50:13 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:27 AM by AutoGen 5.18.5
.\" From the definitions ntptrace-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
# EDIT THIS FILE WITH CAUTION (plot_summary-opts)
#
-# It has been AutoGen-ed February 27, 2018 at 04:55:55 PM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:09:38 AM by AutoGen 5.18.5
# From the definitions plot_summary-opts.def
# and the template file perlopt
'help|?', 'more-help'));
$usage = <<'USAGE';
-plot_summary - plot statistics generated by summary script - Ver. 4.2.8p11
+plot_summary - plot statistics generated by summary script - Ver. 4.2.8p12
USAGE: plot_summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
--directory=str Where the summary files are
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH plot_summary 1plot_summaryman "27 Feb 2018" "ntp (4.2.8p11)" "User Commands"
+.TH plot_summary 1plot_summaryman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-NpayvG/ag-0paGuG)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-_gaOWg/ag-lhaWVg)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 04:56:00 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:43 AM by AutoGen 5.18.5
.\" From the definitions plot_summary-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt PLOT_SUMMARY 1plot_summarymdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (plot_summary-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 04:56:02 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:45 AM by AutoGen 5.18.5
.\" From the definitions plot_summary-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<title>Plot_summary User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Plot_summary User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<h1 class="settitle">Plot_summary User's Manual</h1>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#plot_005fsummary-Description">plot_summary Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-Description">plot_summary 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">Plot_summary User Manual</h2>
<p>This document describes the use of the NTP Project's <code>plot_summary</code> program.
-This document applies to version 4.2.8p11 of <code>plot_summary</code>.
+This document applies to version 4.2.8p12 of <code>plot_summary</code>.
<div class="shortcontents">
<h2>Short Contents</h2>
</ul>
<div class="node">
-<a name="plot_summary-Invocation"></a>
-<a name="plot_005fsummary-Invocation"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-Description">plot_summary Description</a>,
+
<a name="plot_005fsummary-Invocation"></a>Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-Description">plot_summary Description</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<h3 class="section">Invoking plot_summary</h3>
using the <code>agtexi-cmd</code> template and the option descriptions for the <code>plot_summary</code> program.
<ul class="menu">
-<li><a accesskey="1" href="#plot_005fsummary-usage">plot_summary usage</a>: plot_summary help/usage (<samp><span class="option">--help</span></samp>)
+<li><a accesskey="1" href="#plot_005fsummary-usage">plot_summary usage</a>: plot_summary help/usage (<span class="option">--help</span>)
<li><a accesskey="2" href="#plot_005fsummary-directory">plot_summary directory</a>: directory option
<li><a accesskey="3" href="#plot_005fsummary-identifier">plot_summary identifier</a>: identifier option
<li><a accesskey="4" href="#plot_005fsummary-peer">plot_summary peer</a>: peer option
</ul>
<div class="node">
-<a name="plot_summary-usage"></a>
-<a name="plot_005fsummary-usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#plot_005fsummary-directory">plot_summary directory</a>,
+
<a name="plot_005fsummary-usage"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-directory">plot_summary directory</a>,
Up: <a rel="up" accesskey="u" href="#plot_005fsummary-Invocation">plot_summary Invocation</a>
-
+<br>
</div>
-<h4 class="subsection">plot_summary help/usage (<samp><span class="option">--help</span></samp>)</h4>
+<h4 class="subsection">plot_summary help/usage (<span class="option">--help</span>)</h4>
<p><a name="index-plot_005fsummary-help-3"></a>
This is the automatically generated usage text for plot_summary.
<p>The text printed is the same whether selected with the <code>help</code> option
-(<samp><span class="option">--help</span></samp>) or the <code>more-help</code> option (<samp><span class="option">--more-help</span></samp>). <code>more-help</code> will print
+(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
the usage text by passing it through a pager program.
<code>more-help</code> is disabled on platforms without a working
<code>fork(2)</code> function. The <code>PAGER</code> environment variable is
-used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <span class="file">more</span>. Both will exit
with a status code of 0.
-<pre class="example">plot_summary - plot statistics generated by summary script - Ver. 4.2.8p11
+<pre class="example">plot_summary - plot statistics generated by summary script - Ver. 4.2.8p12
USAGE: plot_summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
--directory=str Where the summary files are
hyphen and the flag character.
</pre>
<div class="node">
-<a name="plot_summary-directory"></a>
-<a name="plot_005fsummary-directory"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#plot_005fsummary-identifier">plot_summary identifier</a>,
+
<a name="plot_005fsummary-directory"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-identifier">plot_summary identifier</a>,
Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-usage">plot_summary usage</a>,
Up: <a rel="up" accesskey="u" href="#plot_005fsummary-Invocation">plot_summary Invocation</a>
-
+<br>
</div>
<h4 class="subsection">directory option</h4>
The directory where the <code>plot_summary</code> will search for the
*_summary files generated by <code>summary</code> script.
<div class="node">
-<a name="plot_summary-identifier"></a>
-<a name="plot_005fsummary-identifier"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#plot_005fsummary-peer">plot_summary peer</a>,
+
<a name="plot_005fsummary-identifier"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-peer">plot_summary peer</a>,
Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-directory">plot_summary directory</a>,
Up: <a rel="up" accesskey="u" href="#plot_005fsummary-Invocation">plot_summary Invocation</a>
-
+<br>
</div>
<h4 class="subsection">identifier option</h4>
Where does the plotted data come from, default to string "host" plus
current hostname
<div class="node">
-<a name="plot_summary-peer"></a>
-<a name="plot_005fsummary-peer"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#plot_005fsummary-plot_002dterm">plot_summary plot-term</a>,
+
<a name="plot_005fsummary-peer"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-plot_002dterm">plot_summary plot-term</a>,
Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-identifier">plot_summary identifier</a>,
Up: <a rel="up" accesskey="u" href="#plot_005fsummary-Invocation">plot_summary Invocation</a>
-
+<br>
</div>
<h4 class="subsection">peer option</h4>
<p>By default the peer_summary plots are not generated. Use this option to
specify list of peers if you want to generate plots for them.
<div class="node">
-<a name="plot_summary-plot-term"></a>
-<a name="plot_005fsummary-plot_002dterm"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#plot_005fsummary-output_002dfile">plot_summary output-file</a>,
+
<a name="plot_005fsummary-plot_002dterm"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-output_002dfile">plot_summary output-file</a>,
Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-peer">plot_summary peer</a>,
Up: <a rel="up" accesskey="u" href="#plot_005fsummary-Invocation">plot_summary Invocation</a>
-
+<br>
</div>
<h4 class="subsection">plot-term option</h4>
<code>dumb</code> is it's not'. See output from -e "set
terminal") for the list of available options.
<div class="node">
-<a name="plot_summary-output-file"></a>
-<a name="plot_005fsummary-output_002dfile"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#plot_005fsummary-exit-status">plot_summary exit status</a>,
+
<a name="plot_005fsummary-output_002dfile"></a>Next: <a rel="next" accesskey="n" href="#plot_005fsummary-exit-status">plot_summary exit status</a>,
Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-plot_002dterm">plot_summary plot-term</a>,
Up: <a rel="up" accesskey="u" href="#plot_005fsummary-Invocation">plot_summary Invocation</a>
-
+<br>
</div>
<h4 class="subsection">output-file option</h4>
This option takes a str argument.
Output file for <code>gnuplot</code>, default to stdout.
<div class="node">
-<a name="plot_summary-exit-status"></a>
-<a name="plot_005fsummary-exit-status"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-output_002dfile">plot_summary output-file</a>,
+
<a name="plot_005fsummary-exit-status"></a>Previous: <a rel="previous" accesskey="p" href="#plot_005fsummary-output_002dfile">plot_summary output-file</a>,
Up: <a rel="up" accesskey="u" href="#plot_005fsummary-Invocation">plot_summary Invocation</a>
-
+<br>
</div>
<h4 class="subsection">plot_summary exit status</h4>
<p>One of the following exit values will be returned:
<dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
+<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution.
+<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid.
</dl>
</body></html>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH plot_summary 1plot_summaryman "27 Feb 2018" "ntp (4.2.8p11)" "User Commands"
+.TH plot_summary 1plot_summaryman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-NpayvG/ag-0paGuG)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-_gaOWg/ag-lhaWVg)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 04:56:00 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:43 AM by AutoGen 5.18.5
.\" From the definitions plot_summary-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt PLOT_SUMMARY 1plot_summarymdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (plot_summary-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 04:56:02 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:45 AM by AutoGen 5.18.5
.\" From the definitions plot_summary-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
# EDIT THIS FILE WITH CAUTION (summary-opts)
#
-# It has been AutoGen-ed February 27, 2018 at 04:55:57 PM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:09:40 AM by AutoGen 5.18.5
# From the definitions summary-opts.def
# and the template file perlopt
'help|?', 'more-help'));
$usage = <<'USAGE';
-summary - compute various stastics from NTP stat files - Ver. 4.2.8p11
+summary - compute various stastics from NTP stat files - Ver. 4.2.8p12
USAGE: summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
--directory=str Directory containing stat files
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH summary 1summaryman "27 Feb 2018" "ntp (4.2.8p11)" "User Commands"
+.TH summary 1summaryman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-AMaaJG/ag-NMaiIG)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-tCaq.g/ag-FCay9g)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 04:56:06 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:49 AM by AutoGen 5.18.5
.\" From the definitions summary-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt SUMMARY 1summarymdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (summary-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 04:56:08 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:51 AM by AutoGen 5.18.5
.\" From the definitions summary-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<title>Summary User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Summary User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<h1 class="settitle">Summary User's Manual</h1>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#summary-Description">summary Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#summary-Description">summary 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">Summary User Manual</h2>
<p>This document describes the use of the NTP Project's <code>summary</code> program.
-This document applies to version 4.2.8p11 of <code>summary</code>.
+This document applies to version 4.2.8p12 of <code>summary</code>.
<div class="shortcontents">
<h2>Short Contents</h2>
</ul>
<div class="node">
-<a name="summary-Invocation"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#summary-Description">summary Description</a>,
+
<a name="summary-Invocation"></a>Previous: <a rel="previous" accesskey="p" href="#summary-Description">summary Description</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<h3 class="section">Invoking summary</h3>
using the <code>agtexi-cmd</code> template and the option descriptions for the <code>summary</code> program.
<ul class="menu">
-<li><a accesskey="1" href="#summary-usage">summary usage</a>: summary help/usage (<samp><span class="option">--help</span></samp>)
+<li><a accesskey="1" href="#summary-usage">summary usage</a>: summary help/usage (<span class="option">--help</span>)
<li><a accesskey="2" href="#summary-directory">summary directory</a>: directory option
<li><a accesskey="3" href="#summary-end_002ddate">summary end-date</a>: end-date option
<li><a accesskey="4" href="#summary-output_002ddirectory">summary output-directory</a>: output-directory option
</ul>
<div class="node">
-<a name="summary-usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#summary-directory">summary directory</a>,
+
<a name="summary-usage"></a>Next: <a rel="next" accesskey="n" href="#summary-directory">summary directory</a>,
Up: <a rel="up" accesskey="u" href="#summary-Invocation">summary Invocation</a>
-
+<br>
</div>
-<h4 class="subsection">summary help/usage (<samp><span class="option">--help</span></samp>)</h4>
+<h4 class="subsection">summary help/usage (<span class="option">--help</span>)</h4>
<p><a name="index-summary-help-3"></a>
This is the automatically generated usage text for summary.
<p>The text printed is the same whether selected with the <code>help</code> option
-(<samp><span class="option">--help</span></samp>) or the <code>more-help</code> option (<samp><span class="option">--more-help</span></samp>). <code>more-help</code> will print
+(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
the usage text by passing it through a pager program.
<code>more-help</code> is disabled on platforms without a working
<code>fork(2)</code> function. The <code>PAGER</code> environment variable is
-used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <span class="file">more</span>. Both will exit
with a status code of 0.
-<pre class="example">summary - compute various stastics from NTP stat files - Ver. 4.2.8p11
+<pre class="example">summary - compute various stastics from NTP stat files - Ver. 4.2.8p12
USAGE: summary [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
--directory=str Directory containing stat files
hyphen and the flag character.
</pre>
<div class="node">
-<a name="summary-directory"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#summary-end_002ddate">summary end-date</a>,
+
<a name="summary-directory"></a>Next: <a rel="next" accesskey="n" href="#summary-end_002ddate">summary end-date</a>,
Previous: <a rel="previous" accesskey="p" href="#summary-usage">summary usage</a>,
Up: <a rel="up" accesskey="u" href="#summary-Invocation">summary Invocation</a>
-
+<br>
</div>
<h4 class="subsection">directory option</h4>
The directory where <code>ntpd</code> will search for .stat files generated
by <code>ntpd</code>.
<div class="node">
-<a name="summary-end-date"></a>
-<a name="summary-end_002ddate"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#summary-output_002ddirectory">summary output-directory</a>,
+
<a name="summary-end_002ddate"></a>Next: <a rel="next" accesskey="n" href="#summary-output_002ddirectory">summary output-directory</a>,
Previous: <a rel="previous" accesskey="p" href="#summary-directory">summary directory</a>,
Up: <a rel="up" accesskey="u" href="#summary-Invocation">summary Invocation</a>
-
+<br>
</div>
<h4 class="subsection">end-date option</h4>
option. Defaults to today minus one day (Use <code>date -u +%Y%m%d</code>)
to get the timestamp.
<div class="node">
-<a name="summary-output-directory"></a>
-<a name="summary-output_002ddirectory"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#summary-start_002ddate">summary start-date</a>,
+
<a name="summary-output_002ddirectory"></a>Next: <a rel="next" accesskey="n" href="#summary-start_002ddate">summary start-date</a>,
Previous: <a rel="previous" accesskey="p" href="#summary-end_002ddate">summary end-date</a>,
Up: <a rel="up" accesskey="u" href="#summary-Invocation">summary Invocation</a>
-
+<br>
</div>
<h4 class="subsection">output-directory option</h4>
This option takes a str argument.
The output directory <code>summary</code> will write all output files to.
<div class="node">
-<a name="summary-start-date"></a>
-<a name="summary-start_002ddate"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#summary-exit-status">summary exit status</a>,
+
<a name="summary-start_002ddate"></a>Next: <a rel="next" accesskey="n" href="#summary-exit-status">summary exit status</a>,
Previous: <a rel="previous" accesskey="p" href="#summary-output_002ddirectory">summary output-directory</a>,
Up: <a rel="up" accesskey="u" href="#summary-Invocation">summary Invocation</a>
-
+<br>
</div>
<h4 class="subsection">start-date option</h4>
Process all files with the date suffix more or equal to value of
this option. Defaults to 197000101.
<div class="node">
-<a name="summary-exit-status"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#summary-start_002ddate">summary start-date</a>,
+
<a name="summary-exit-status"></a>Previous: <a rel="previous" accesskey="p" href="#summary-start_002ddate">summary start-date</a>,
Up: <a rel="up" accesskey="u" href="#summary-Invocation">summary Invocation</a>
-
+<br>
</div>
<h4 class="subsection">summary exit status</h4>
<p>One of the following exit values will be returned:
<dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
+<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution.
+<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid.
</dl>
</body></html>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH summary 1summaryman "27 Feb 2018" "ntp (4.2.8p11)" "User Commands"
+.TH summary 1summaryman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-AMaaJG/ag-NMaiIG)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-tCaq.g/ag-FCay9g)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 04:56:06 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:49 AM by AutoGen 5.18.5
.\" From the definitions summary-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt SUMMARY 1summarymdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (summary-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 04:56:08 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:51 AM by AutoGen 5.18.5
.\" From the definitions summary-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-update-leap.texi)
#
-# It has been AutoGen-ed February 27, 2018 at 04:55:50 PM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:09:32 AM by AutoGen 5.18.5
# From the definitions update-leap-opts.def
# and the template file agtexi-cmd.tpl
@end ignore
# EDIT THIS FILE WITH CAUTION (update-leap-opts)
#
-# It has been AutoGen-ed February 27, 2018 at 04:32:15 PM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:09:38 AM by AutoGen 5.18.5
# From the definitions update-leap-opts.def
# and the template file perlopt
'help|?', 'more-help'));
$usage = <<'USAGE';
-update-leap - leap-seconds file manager/updater - Ver. 4.2.8p11
+update-leap - leap-seconds file manager/updater - Ver. 4.2.8p12
USAGE: update-leap [ -<flag> [<val>] | --<name>[{=| }<val>] ]...
-s, --source-url=str The URL of the master copy of the leapseconds file
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH update-leap 1update-leapman "27 Feb 2018" "ntp (4.2.8p11)" "User Commands"
+.TH update-leap 1update-leapman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-cKaOWT/ag-pKaWVT)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-4Iayif/ag-fJaGhf)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:50:15 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:29 AM by AutoGen 5.18.5
.\" From the definitions update-leap-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt UPDATE_LEAP 1update-leapmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (update-leap-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 04:55:53 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:36 AM by AutoGen 5.18.5
.\" From the definitions update-leap-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<title>update-leap User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="update-leap User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<h1 class="settitle">update-leap User's Manual</h1>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#update_002dleap-Description">update-leap Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-Description">update-leap Description</a>,
Previous: <a rel="previous" accesskey="p" href="#dir">(dir)</a>,
Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-
+<br>
</div>
<p>This document describes the use of the NTP Project's <code>update-leap</code> program.
- <p>This document applies to version 4.2.8p11 of <code>update-leap</code>.
+ <p>This document applies to version 4.2.8p12 of <code>update-leap</code>.
<div class="shortcontents">
<h2>Short Contents</h2>
</ul>
<div class="node">
-<a name="update-leap-Invocation"></a>
-<a name="update_002dleap-Invocation"></a>
<p><hr>
-
-
+<a name="update_002dleap-Invocation"></a>
+<br>
</div>
<h3 class="section">0.1 Invoking update-leap</h3>
using the <code>agtexi-cmd</code> template and the option descriptions for the <code>update-leap</code> program.
<ul class="menu">
-<li><a accesskey="1" href="#update_002dleap-usage">update-leap usage</a>: update-leap help/usage (<samp><span class="option">--help</span></samp>)
+<li><a accesskey="1" href="#update_002dleap-usage">update-leap usage</a>: update-leap help/usage (<span class="option">--help</span>)
<li><a accesskey="2" href="#update_002dleap-source_002durl">update-leap source-url</a>: source-url option (-s)
<li><a accesskey="3" href="#update_002dleap-ipv4">update-leap ipv4</a>: ipv4 option (-4)
<li><a accesskey="4" href="#update_002dleap-destination">update-leap destination</a>: destination option (-d)
</ul>
<div class="node">
-<a name="update-leap-usage"></a>
-<a name="update_002dleap-usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#update_002dleap-source_002durl">update-leap source-url</a>,
+
<a name="update_002dleap-usage"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-source_002durl">update-leap source-url</a>,
Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a>
-
+<br>
</div>
-<h4 class="subsection">0.1.1 update-leap help/usage (<samp><span class="option">--help</span></samp>)</h4>
+<h4 class="subsection">0.1.1 update-leap help/usage (<span class="option">--help</span>)</h4>
<p><a name="index-update_002dleap-help-3"></a>
This is the automatically generated usage text for update-leap.
<p>The text printed is the same whether selected with the <code>help</code> option
-(<samp><span class="option">--help</span></samp>) or the <code>more-help</code> option (<samp><span class="option">--more-help</span></samp>). <code>more-help</code> will print
+(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
the usage text by passing it through a pager program.
<code>more-help</code> is disabled on platforms without a working
<code>fork(2)</code> function. The <code>PAGER</code> environment variable is
-used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
+used to select the program, defaulting to <span class="file">more</span>. Both will exit
with a status code of 0.
<pre class="example">
Version: 1.004
</pre>
<div class="node">
-<a name="update-leap-source-url"></a>
-<a name="update_002dleap-source_002durl"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#update_002dleap-ipv4">update-leap ipv4</a>,
+
<a name="update_002dleap-source_002durl"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-ipv4">update-leap ipv4</a>,
Previous: <a rel="previous" accesskey="p" href="#update_002dleap-usage">update-leap usage</a>,
Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.2 source-url option (-s)</h4>
Specify the URL of the master copy to download
$LEAPSRC
<div class="node">
-<a name="update-leap-ipv4"></a>
-<a name="update_002dleap-ipv4"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#update_002dleap-destination">update-leap destination</a>,
+
<a name="update_002dleap-ipv4"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-destination">update-leap destination</a>,
Previous: <a rel="previous" accesskey="p" href="#update_002dleap-source_002durl">update-leap source-url</a>,
Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.3 ipv4 option (-4)</h4>
doc = <<- _EndOfDoc_
Prefer IPv4 or IPv6 (as specified) addresses, but use either.
<div class="node">
-<a name="update-leap-destination"></a>
-<a name="update_002dleap-destination"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#update_002dleap-expiration">update-leap expiration</a>,
+
<a name="update_002dleap-destination"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-expiration">update-leap expiration</a>,
Previous: <a rel="previous" accesskey="p" href="#update_002dleap-ipv4">update-leap ipv4</a>,
Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.4 destination option (-d)</h4>
<p><a name="index-update_002dleap_002ddestination-6"></a>
This is the “filename on the local system” option.
-This option takes a string argument <samp><span class="file">float</span></samp>.
+This option takes a string argument <span class="file">float</span>.
The name to use to store the leapfile on the local system.
$LEAPFILE
<div class="node">
-<a name="update-leap-expiration"></a>
-<a name="update_002dleap-expiration"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#update_002dleap-ntp_002dconf_002dfile">update-leap ntp-conf-file</a>,
+
<a name="update_002dleap-expiration"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-ntp_002dconf_002dfile">update-leap ntp-conf-file</a>,
Previous: <a rel="previous" accesskey="p" href="#update_002dleap-destination">update-leap destination</a>,
Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.5 expiration option (-e)</h4>
imply more frequent refreshes.
"$PREFETCH"
<div class="node">
-<a name="update-leap-ntp-conf-file"></a>
-<a name="update_002dleap-ntp_002dconf_002dfile"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#update_002dleap-force_002dupdate">update-leap force-update</a>,
+
<a name="update_002dleap-ntp_002dconf_002dfile"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-force_002dupdate">update-leap force-update</a>,
Previous: <a rel="previous" accesskey="p" href="#update_002dleap-expiration">update-leap expiration</a>,
Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.6 ntp-conf-file option (-f)</h4>
present and to default leapfile)
/etc/ntp.conf
<div class="node">
-<a name="update-leap-force-update"></a>
-<a name="update_002dleap-force_002dupdate"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#update_002dleap-exit-status">update-leap exit status</a>,
+
<a name="update_002dleap-force_002dupdate"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-exit-status">update-leap exit status</a>,
Previous: <a rel="previous" accesskey="p" href="#update_002dleap-ntp_002dconf_002dfile">update-leap ntp-conf-file</a>,
Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.7 force-update option (-F)</h4>
This is the “force update of the leapfile” option.
Force update even if current file is OK and not close to expiring.
<div class="node">
-<a name="update-leap-exit-status"></a>
-<a name="update_002dleap-exit-status"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#update_002dleap-Usage">update-leap Usage</a>,
+
<a name="update_002dleap-exit-status"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-Usage">update-leap Usage</a>,
Previous: <a rel="previous" accesskey="p" href="#update_002dleap-force_002dupdate">update-leap force-update</a>,
Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.8 update-leap exit status</h4>
<p>One of the following exit values will be returned:
<dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
+<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution.
+<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid.
</dl>
<div class="node">
-<a name="update-leap-Usage"></a>
-<a name="update_002dleap-Usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#update_002dleap-Authors">update-leap Authors</a>,
+
<a name="update_002dleap-Usage"></a>Next: <a rel="next" accesskey="n" href="#update_002dleap-Authors">update-leap Authors</a>,
Previous: <a rel="previous" accesskey="p" href="#update_002dleap-exit-status">update-leap exit status</a>,
Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.9 update-leap Usage</h4>
<div class="node">
-<a name="update-leap-Authors"></a>
-<a name="update_002dleap-Authors"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#update_002dleap-Usage">update-leap Usage</a>,
+
<a name="update_002dleap-Authors"></a>Previous: <a rel="previous" accesskey="p" href="#update_002dleap-Usage">update-leap Usage</a>,
Up: <a rel="up" accesskey="u" href="#update_002dleap-Invocation">update-leap Invocation</a>
-
+<br>
</div>
<h4 class="subsection">0.1.10 update-leap Authors</h4>
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH update-leap 1update-leapman "27 Feb 2018" "ntp (4.2.8p11)" "User Commands"
+.TH update-leap 1update-leapman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-cKaOWT/ag-pKaWVT)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-4Iayif/ag-fJaGhf)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 10:50:15 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:29 AM by AutoGen 5.18.5
.\" From the definitions update-leap-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt UPDATE_LEAP 1update-leapmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (update-leap-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 04:55:53 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:09:36 AM by AutoGen 5.18.5
.\" From the definitions update-leap-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-sntp.texi)
#
-# It has been AutoGen-ed February 27, 2018 at 05:13:11 PM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:27:37 AM by AutoGen 5.18.5
# 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.7p245
-USAGE: sntp [ -<flag> [<val>] | --<name>[@{=| @}<val>] ]... \
+sntp - standard Simple Network Time Protocol client program - Ver. 4.2.8p12
+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:
- ipv6
+ - prohibits the option 'ipv6'
-6 no ipv6 Force IPv6 DNS name resolution
- - prohibits these options:
- ipv4
- -a Num authentication Enable authentication with the key @@var@{auth-keynumber@}
- -B Num bctimeout The number of seconds to wait for broadcasts
+ - prohibits the option 'ipv4'
+ -a Num authentication Enable authentication with the key auth-keynumber
-b Str broadcast Listen to the address specified for broadcast time sync
- may appear multiple times
-c Str concurrent Concurrently query all IPs returned for host-name
- may appear multiple times
-d no debug-level Increase debug verbosity level
- may appear multiple times
- -D Str set-debug-level Set the debug verbosity level
+ -D Num set-debug-level Set the debug verbosity level
- may appear multiple times
-g Num gap 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 @@option@{-a@}
+ -k Fil keyfile Look in this file for the key specified with -a
-l Fil logfile Log to specified logfile
- -M Num steplimit Adjustments less than @@var@{steplimit@} msec will be slewed
- - It must be in the range:
+ -M Num steplimit Adjustments less than steplimit msec will be slewed
+ - it must be in the range:
greater than or equal to 0
- -o Num ntpversion Send @@var@{int@} as our NTP version
- - It must be in the range:
+ -o Num ntpversion Send int as our NTP protocol version
+ - it must be in the range:
0 to 7
-r no usereservedport Use the NTP Reserved Port (port 123)
- -S no step OK to 'step' the time with @@command@{settimeofday(2)@}
- -s no slew OK to 'slew' the time with @@command@{adjtime(2)@}
- -u Num uctimeout The number of seconds to wait for unicast responses
+ -S no step OK to 'step' the time with settimeofday(2)
+ -s no slew OK to 'slew' the time with adjtime(2)
+ -t Num timeout The number of seconds to wait for responses
no wait Wait for pending replies (if not setting the time)
- - disabled as --no-wait
+ - disabled as '--no-wait'
- enabled by default
- opt version Output version information and exit
- -? no help Display extended usage information and exit
- -! no more-help Extended usage information passed thru pager
- -> opt save-opts Save the option state to a config file
- -< Str load-opts Load options from a config file
- - disabled as --no-load-opts
+ opt version output version information and exit
+ -? no help display extended usage information and exit
+ -! no more-help extended usage information passed thru pager
+ -> opt save-opts save the option state to a config file
+ -< Str load-opts load options from a config file
+ - disabled as '--no-load-opts'
- may appear multiple times
Options are specified by doubled hyphens and their name or by a single
hyphen and the flag character.
-
The following option preset mechanisms are supported:
- reading file $HOME/.ntprc
- 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 27, 2018 at 10:25:32 AM by AutoGen 5.18.5
+ * It has been AutoGen-ed August 14, 2018 at 08:01:13 AM by AutoGen 5.18.5
* From the definitions sntp-opts.def
* and the template file options
*
* static const strings for sntp options
*/
static char const sntp_opt_strs[2566] =
-/* 0 */ "sntp 4.2.8p11\n"
+/* 0 */ "sntp 4.2.8p12\n"
"Copyright (C) 1992-2017 The University of Delaware and Network Time Foundation, 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"
/* 2313 */ "LOAD_OPTS\0"
/* 2323 */ "no-load-opts\0"
/* 2336 */ "SNTP\0"
-/* 2341 */ "sntp - standard Simple Network Time Protocol client program - Ver. 4.2.8p11\n"
+/* 2341 */ "sntp - standard Simple Network Time Protocol client program - Ver. 4.2.8p12\n"
"Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n"
"\t\t[ hostname-or-IP ...]\n\0"
/* 2501 */ "$HOME\0"
/* 2509 */ ".ntprc\0"
/* 2516 */ "http://bugs.ntp.org, bugs@ntp.org\0"
/* 2550 */ "\n\0"
-/* 2552 */ "sntp 4.2.8p11";
+/* 2552 */ "sntp 4.2.8p12";
/**
* ipv4 option description with
translate option names.
*/
/* referenced via sntpOptions.pzCopyright */
- puts(_("sntp 4.2.8p11\n\
+ puts(_("sntp 4.2.8p12\n\
Copyright (C) 1992-2017 The University of Delaware and Network Time Foundation, 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.8p11\n\
+ puts(_("sntp - standard Simple Network Time Protocol client program - Ver. 4.2.8p12\n\
Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \\\n\
\t\t[ hostname-or-IP ...]\n"));
puts(_("\n"));
/* referenced via sntpOptions.pzFullVersion */
- puts(_("sntp 4.2.8p11"));
+ puts(_("sntp 4.2.8p12"));
/* referenced via sntpOptions.pzFullUsage */
puts(_("<<<NOT-FOUND>>>"));
/*
* EDIT THIS FILE WITH CAUTION (sntp-opts.h)
*
- * It has been AutoGen-ed February 27, 2018 at 10:25:31 AM by AutoGen 5.18.5
+ * It has been AutoGen-ed August 14, 2018 at 08:01:13 AM by AutoGen 5.18.5
* From the definitions sntp-opts.def
* and the template file options
*
/** count of all options for sntp */
#define OPTION_CT 23
/** sntp version */
-#define SNTP_VERSION "4.2.8p11"
+#define SNTP_VERSION "4.2.8p12"
/** Full sntp version text */
-#define SNTP_FULL_VERSION "sntp 4.2.8p11"
+#define SNTP_FULL_VERSION "sntp 4.2.8p12"
/**
* Interface defines for all options. Replace "n" with the UPPER_CASED
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH sntp 1sntpman "27 Feb 2018" "4.2.8p11" "User Commands"
+.TH sntp 1sntpman "14 Aug 2018" "4.2.8p12" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-eaayfN/ag-qaaqeN)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-7ray4x/ag-hsaq3x)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:13:07 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:27:33 AM by AutoGen 5.18.5
.\" From the definitions sntp-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt SNTP 1sntpmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (sntp-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:13:14 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:27:40 AM by AutoGen 5.18.5
.\" From the definitions sntp-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<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.13">
+<meta name="generator" content="makeinfo 4.7">
<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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<h1 class="settitle">Sntp User's Manual</h1>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-Description">sntp Description</a>,
+
<a name="Top"></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>
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.8p11 of <code>sntp</code>.
+ <p>This document applies to version 4.2.8p12 of <code>sntp</code>.
<p>The program implements the SNTP protocol as defined by RFC 5905, the NTPv4
IETF specification.
</ul>
<div class="node">
-<a name="sntp-Description"></a>
<p><hr>
-
-
+<a name="sntp-Description"></a>
+<br>
</div>
<!-- node-name, next, previous, up -->
error bound of the system clock relative to the server clock.
<div class="node">
-<a name="sntp-Invocation"></a>
<p><hr>
-
-
+<a name="sntp-Invocation"></a>
+<br>
</div>
<h3 class="section">Invoking sntp</h3>
This software is released under the NTP license, <http://ntp.org/license>.
<ul class="menu">
-<li><a accesskey="1" href="#sntp-usage">sntp usage</a>: sntp help/usage (<samp><span class="option">--help</span></samp>)
+<li><a accesskey="1" href="#sntp-usage">sntp usage</a>: sntp help/usage (<span class="option">--help</span>)
<li><a accesskey="2" href="#sntp-ipv4">sntp ipv4</a>: ipv4 option (-4)
<li><a accesskey="3" href="#sntp-ipv6">sntp ipv6</a>: ipv6 option (-6)
<li><a accesskey="4" href="#sntp-authentication">sntp authentication</a>: authentication option (-a)
</ul>
<div class="node">
-<a name="sntp-usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-ipv4">sntp ipv4</a>,
+
<a name="sntp-usage"></a>Next: <a rel="next" accesskey="n" href="#sntp-ipv4">sntp ipv4</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-
+<br>
</div>
-<h4 class="subsection">sntp help/usage (<samp><span class="option">--help</span></samp>)</h4>
+<h4 class="subsection">sntp help/usage (<span class="option">--help</span>)</h4>
<p><a name="index-sntp-help-3"></a>
This is the automatically generated usage text for sntp.
<p>The text printed is the same whether selected with the <code>help</code> option
-(<samp><span class="option">--help</span></samp>) or the <code>more-help</code> option (<samp><span class="option">--more-help</span></samp>). <code>more-help</code> will print
+(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
the usage text by passing it through a pager program.
<code>more-help</code> is disabled on platforms without a working
<code>fork(2)</code> function. The <code>PAGER</code> environment variable is
-used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
+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.7p245
-USAGE: sntp [ -<flag> [<val>] | --<name>[{=| }<val>] ]... \
+<pre class="example">sntp - standard Simple Network Time Protocol client program - Ver. 4.2.8p12
+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:
- ipv6
+ - prohibits the option 'ipv6'
-6 no ipv6 Force IPv6 DNS name resolution
- - prohibits these options:
- ipv4
- -a Num authentication Enable authentication with the key @var{auth-keynumber}
- -B Num bctimeout The number of seconds to wait for broadcasts
+ - prohibits the option 'ipv4'
+ -a Num authentication Enable authentication with the key auth-keynumber
-b Str broadcast Listen to the address specified for broadcast time sync
- may appear multiple times
-c Str concurrent Concurrently query all IPs returned for host-name
- may appear multiple times
-d no debug-level Increase debug verbosity level
- may appear multiple times
- -D Str set-debug-level Set the debug verbosity level
+ -D Num set-debug-level Set the debug verbosity level
- may appear multiple times
-g Num gap 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 @option{-a}
+ -k Fil keyfile Look in this file for the key specified with -a
-l Fil logfile Log to specified logfile
- -M Num steplimit Adjustments less than @var{steplimit} msec will be slewed
- - It must be in the range:
+ -M Num steplimit Adjustments less than steplimit msec will be slewed
+ - it must be in the range:
greater than or equal to 0
- -o Num ntpversion Send @var{int} as our NTP version
- - It must be in the range:
+ -o Num ntpversion Send int as our NTP protocol version
+ - it must be in the range:
0 to 7
-r no usereservedport Use the NTP Reserved Port (port 123)
- -S no step OK to 'step' the time with @command{settimeofday(2)}
- -s no slew OK to 'slew' the time with @command{adjtime(2)}
- -u Num uctimeout The number of seconds to wait for unicast responses
+ -S no step OK to 'step' the time with settimeofday(2)
+ -s no slew OK to 'slew' the time with adjtime(2)
+ -t Num timeout The number of seconds to wait for responses
no wait Wait for pending replies (if not setting the time)
- - disabled as --no-wait
+ - disabled as '--no-wait'
- enabled by default
- opt version Output version information and exit
- -? no help Display extended usage information and exit
- -! no more-help Extended usage information passed thru pager
- -> opt save-opts Save the option state to a config file
- -< Str load-opts Load options from a config file
- - disabled as --no-load-opts
+ opt version output version information and exit
+ -? no help display extended usage information and exit
+ -! no more-help extended usage information passed thru pager
+ -> opt save-opts save the option state to a config file
+ -< Str load-opts load options from a config file
+ - disabled as '--no-load-opts'
- may appear multiple times
Options are specified by doubled hyphens and their name or by a single
hyphen and the flag character.
-
The following option preset mechanisms are supported:
- reading file $HOME/.ntprc
- 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">
-<a name="sntp-ipv4"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-ipv6">sntp ipv6</a>,
+
<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-usage">sntp usage</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ipv4 option (-4)</h4>
<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>
-Next: <a rel="next" accesskey="n" href="#sntp-authentication">sntp authentication</a>,
+
<a name="sntp-ipv6"></a>Next: <a rel="next" accesskey="n" href="#sntp-authentication">sntp authentication</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>Force DNS resolution of the following host names on the command line
to the IPv6 namespace.
<div class="node">
-<a name="sntp-authentication"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-broadcast">sntp broadcast</a>,
+
<a name="sntp-authentication"></a>Next: <a rel="next" accesskey="n" href="#sntp-broadcast">sntp broadcast</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">authentication option (-a)</h4>
<p><a name="index-sntp_002dauthentication-6"></a>
This is the “enable authentication with the key <var>auth-keynumber</var>” option.
-This option takes a number argument <samp><span class="file">auth-keynumber</span></samp>.
+This option takes a number argument <span class="file">auth-keynumber</span>.
Enable authentication using the key specified in this option's
-argument. The argument of this option is the <samp><span class="option">keyid</span></samp>, a
-number specified in the <samp><span class="option">keyfile</span></samp> as this key's identifier.
-See the <samp><span class="option">keyfile</span></samp> option (<samp><span class="option">-k</span></samp>) for more details.
+argument. The argument of this option is the <span class="option">keyid</span>, a
+number specified in the <span class="option">keyfile</span> as this key's identifier.
+See the <span class="option">keyfile</span> option (<span class="option">-k</span>) for more details.
<div class="node">
-<a name="sntp-broadcast"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-concurrent">sntp concurrent</a>,
+
<a name="sntp-broadcast"></a>Next: <a rel="next" accesskey="n" href="#sntp-concurrent">sntp concurrent</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>
<p><a name="index-sntp_002dbroadcast-7"></a>
This is the “listen to the address specified for broadcast time sync” option.
-This option takes a string argument <samp><span class="file">broadcast-address</span></samp>.
+This option takes a string argument <span class="file">broadcast-address</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
<p>If specified <code>sntp</code> will listen to the specified address
for NTP broadcasts. The default maximum wait time
-can (and probably should) be modified with <samp><span class="option">-t</span></samp>.
+can (and probably should) be modified with <span class="option">-t</span>.
<div class="node">
-<a name="sntp-concurrent"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-gap">sntp gap</a>,
+
<a name="sntp-concurrent"></a>Next: <a rel="next" accesskey="n" href="#sntp-gap">sntp gap</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">concurrent option (-c)</h4>
<p><a name="index-sntp_002dconcurrent-8"></a>
This is the “concurrently query all ips returned for host-name” option.
-This option takes a string argument <samp><span class="file">host-name</span></samp>.
+This option takes a string argument <span class="file">host-name</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
<code>ntpd</code>, and therefore <code>sntp</code> will send queries to these IPs
one after another, with a 2-second gap in between each query.
- <p>The <samp><span class="option">-c</span></samp> or <samp><span class="option">--concurrent</span></samp> flag says that any IPs
+ <p>The <span class="option">-c</span> or <span class="option">--concurrent</span> 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">
-<a name="sntp-gap"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-kod">sntp kod</a>,
+
<a name="sntp-gap"></a>Next: <a rel="next" accesskey="n" href="#sntp-kod">sntp kod</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-concurrent">sntp concurrent</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-
+<br>
</div>
<h4 class="subsection">gap option (-g)</h4>
<p><a name="index-sntp_002dgap-9"></a>
This is the “the gap (in milliseconds) between time requests” option.
-This option takes a number argument <samp><span class="file">milliseconds</span></samp>.
+This option takes a number argument <span class="file">milliseconds</span>.
Since we're only going to use the first valid response we get and
there is benefit to specifying a good number of servers to query,
separate the queries we send out by the specified number of
milliseconds.
<div class="node">
-<a name="sntp-kod"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-keyfile">sntp keyfile</a>,
+
<a name="sntp-kod"></a>Next: <a rel="next" accesskey="n" href="#sntp-keyfile">sntp keyfile</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-gap">sntp gap</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-10"></a>
This is the “kod history filename” option.
-This option takes a file argument <samp><span class="file">file-name</span></samp>.
+This option takes a file argument <span class="file">file-name</span>.
Specifies the filename to be used for the persistent history of KoD
responses received from servers. If the file does not exist, a
warning message will be displayed. The file will not be created.
<div class="node">
-<a name="sntp-keyfile"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-logfile">sntp logfile</a>,
+
<a name="sntp-keyfile"></a>Next: <a rel="next" accesskey="n" href="#sntp-logfile">sntp logfile</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">keyfile option (-k)</h4>
<p><a name="index-sntp_002dkeyfile-11"></a>
-This is the “look in this file for the key specified with <samp><span class="option">-a</span></samp>” option.
-This option takes a file argument <samp><span class="file">file-name</span></samp>.
+This is the “look in this file for the key specified with <span class="option">-a</span>” option.
+This option takes a file argument <span class="file">file-name</span>.
This option specifies the keyfile.
-<code>sntp</code> will search for the key specified with <samp><span class="option">-a</span></samp>
-<samp><span class="file">keyno</span></samp> in this file. See <samp><span class="command">ntp.keys(5)</span></samp> for more
+<code>sntp</code> will search for the key specified with <span class="option">-a</span>
+<span class="file">keyno</span> in this file. See <span class="command">ntp.keys(5)</span> for more
information.
<div class="node">
-<a name="sntp-logfile"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-steplimit">sntp steplimit</a>,
+
<a name="sntp-logfile"></a>Next: <a rel="next" accesskey="n" href="#sntp-steplimit">sntp steplimit</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">logfile option (-l)</h4>
<p><a name="index-sntp_002dlogfile-12"></a>
This is the “log to specified logfile” option.
-This option takes a file argument <samp><span class="file">file-name</span></samp>.
+This option takes a file argument <span class="file">file-name</span>.
This option causes the client to write log messages to the specified
-<samp><span class="file">logfile</span></samp>.
+<span class="file">logfile</span>.
<div class="node">
-<a name="sntp-steplimit"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-ntpversion">sntp ntpversion</a>,
+
<a name="sntp-steplimit"></a>Next: <a rel="next" accesskey="n" href="#sntp-ntpversion">sntp ntpversion</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>
-
+<br>
</div>
<h4 class="subsection">steplimit option (-M)</h4>
<p><a name="index-sntp_002dsteplimit-13"></a>
This is the “adjustments less than <var>steplimit</var> msec will be slewed” option.
This option takes a number argument.
-If the time adjustment is less than <samp><span class="file">steplimit</span></samp> milliseconds,
-slew the amount using <samp><span class="command">adjtime(2)</span></samp>. Otherwise, step the
-correction using <samp><span class="command">settimeofday(2)</span></samp>. The default value is 0,
+If the time adjustment is less than <span class="file">steplimit</span> milliseconds,
+slew the amount using <span class="command">adjtime(2)</span>. Otherwise, step the
+correction using <span class="command">settimeofday(2)</span>. The default value is 0,
which means all adjustments will be stepped. This is a feature, as
different situations demand different values.
<div class="node">
-<a name="sntp-ntpversion"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-usereservedport">sntp usereservedport</a>,
+
<a name="sntp-ntpversion"></a>Next: <a rel="next" accesskey="n" href="#sntp-usereservedport">sntp usereservedport</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-steplimit">sntp steplimit</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntpversion option (-o)</h4>
This is the “send <var>int</var> as our ntp protocol version” option.
This option takes a number argument.
When sending requests to a remote server, tell them we are running
-NTP protocol version <samp><span class="file">ntpversion</span></samp> .
+NTP protocol version <span class="file">ntpversion</span> .
<div class="node">
-<a name="sntp-usereservedport"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-timeout">sntp timeout</a>,
+
<a name="sntp-usereservedport"></a>Next: <a rel="next" accesskey="n" href="#sntp-timeout">sntp timeout</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-ntpversion">sntp ntpversion</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-
+<br>
</div>
<h4 class="subsection">usereservedport option (-r)</h4>
Use port 123, which is reserved for NTP, for our network
communications.
<div class="node">
-<a name="sntp-timeout"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-wait">sntp wait</a>,
+
<a name="sntp-timeout"></a>Next: <a rel="next" accesskey="n" href="#sntp-wait">sntp wait</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-usereservedport">sntp usereservedport</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-
+<br>
</div>
<h4 class="subsection">timeout option (-t)</h4>
<p><a name="index-sntp_002dtimeout-16"></a>
This is the “the number of seconds to wait for responses” option.
-This option takes a number argument <samp><span class="file">seconds</span></samp>.
+This option takes a number argument <span class="file">seconds</span>.
When waiting for a reply, <code>sntp</code> will wait the number
of seconds specified before giving up. The default should be
more than enough for a unicast response. If <code>sntp</code> is
only waiting for a broadcast response a longer timeout is
likely needed.
<div class="node">
-<a name="sntp-wait"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-config">sntp config</a>,
+
<a name="sntp-wait"></a>Next: <a rel="next" accesskey="n" href="#sntp-config">sntp config</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-timeout">sntp timeout</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-
+<br>
</div>
<h4 class="subsection">wait option</h4>
<p>If we are not setting the time, wait for all pending responses.
<div class="node">
-<a name="sntp-config"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-exit-status">sntp exit status</a>,
+
<a name="sntp-config"></a>Next: <a rel="next" accesskey="n" href="#sntp-exit-status">sntp exit status</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-wait">sntp wait</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-
+<br>
</div>
<h4 class="subsection">presetting/configuring sntp</h4>
<li>$PWD
</ul>
The environment variables <code>HOME</code>, and <code>PWD</code>
-are expanded and replaced when <samp><span class="file">sntp</span></samp> runs.
+are expanded and replaced when <span class="file">sntp</span> runs.
For any of these that are plain files, they are simply processed.
-For any that are directories, then a file named <samp><span class="file">.ntprc</span></samp> is searched for
+For any that are directories, then a file named <span class="file">.ntprc</span> is searched for
within that directory and processed.
<p>Configuration files may be in a wide variety of formats.
Only the first letter of the argument is examined:
<dl>
-<dt>‘<samp><span class="samp">version</span></samp>’<dd>Only print the version. This is the default.
-<br><dt>‘<samp><span class="samp">copyright</span></samp>’<dd>Name the copyright usage licensing terms.
-<br><dt>‘<samp><span class="samp">verbose</span></samp>’<dd>Print the full copyright usage licensing terms.
+<dt><span class="samp">version</span><dd>Only print the version. This is the default.
+<br><dt><span class="samp">copyright</span><dd>Name the copyright usage licensing terms.
+<br><dt><span class="samp">verbose</span><dd>Print the full copyright usage licensing terms.
</dl>
<div class="node">
-<a name="sntp-exit-status"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-Usage">sntp Usage</a>,
+
<a name="sntp-exit-status"></a>Next: <a rel="next" accesskey="n" href="#sntp-Usage">sntp Usage</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-config">sntp config</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-
+<br>
</div>
<h4 class="subsection">sntp exit status</h4>
<p>One of the following exit values will be returned:
<dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
-<br><dt>‘<samp><span class="samp">66 (EX_NOINPUT)</span></samp>’<dd>A specified configuration file could not be loaded.
-<br><dt>‘<samp><span class="samp">70 (EX_SOFTWARE)</span></samp>’<dd>libopts had an internal operational error. Please report
+<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution.
+<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid.
+<br><dt><span class="samp">66 (EX_NOINPUT)</span><dd>A specified configuration file could not be loaded.
+<br><dt><span class="samp">70 (EX_SOFTWARE)</span><dd>libopts had an internal operational error. Please report
it to autogen-users@lists.sourceforge.net. Thank you.
</dl>
<div class="node">
-<a name="sntp-Usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#sntp-Authors">sntp Authors</a>,
+
<a name="sntp-Usage"></a>Next: <a rel="next" accesskey="n" href="#sntp-Authors">sntp Authors</a>,
Previous: <a rel="previous" accesskey="p" href="#sntp-exit-status">sntp exit status</a>,
Up: <a rel="up" accesskey="u" href="#sntp-Invocation">sntp Invocation</a>
-
+<br>
</div>
<h4 class="subsection">sntp Usage</h4>
<div class="node">
-<a name="sntp-Authors"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#sntp-Usage">sntp Usage</a>,
+
<a name="sntp-Authors"></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">sntp Authors</h4>
<div class="node">
-<a name="Usage"></a>
<p><hr>
-
-
+<a name="Usage"></a>
+<br>
</div>
<!-- node-name, next, previous, up -->
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH sntp @SNTP_MS@ "27 Feb 2018" "4.2.8p11" "User Commands"
+.TH sntp @SNTP_MS@ "14 Aug 2018" "4.2.8p12" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-eaayfN/ag-qaaqeN)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-7ray4x/ag-hsaq3x)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:13:07 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:27:33 AM by AutoGen 5.18.5
.\" From the definitions sntp-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd February 27 2018
+.Dd August 14 2018
.Dt SNTP @SNTP_MS@ User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (sntp-opts.mdoc)
.\"
-.\" It has been AutoGen-ed February 27, 2018 at 05:13:14 PM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:27:40 AM by AutoGen 5.18.5
.\" From the definitions sntp-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
#
# EDIT THIS FILE WITH CAUTION (invoke-ntp-keygen.texi)
#
-# It has been AutoGen-ed July 24, 2018 at 07:24:01 AM by AutoGen 5.18.5
+# It has been AutoGen-ed August 14, 2018 at 08:30:35 AM by AutoGen 5.18.5
# 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.8p11
+ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.8p12
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 July 24, 2018 at 07:23:54 AM by AutoGen 5.18.5
+ * It has been AutoGen-ed August 14, 2018 at 08:30:21 AM by AutoGen 5.18.5
* From the definitions ntp-keygen-opts.def
* and the template file options
*
* static const strings for ntp-keygen options
*/
static char const ntp_keygen_opt_strs[2442] =
-/* 0 */ "ntp-keygen (ntp) 4.2.8p11\n"
+/* 0 */ "ntp-keygen (ntp) 4.2.8p12\n"
"Copyright (C) 1992-2017 The University of Delaware and Network Time Foundation, 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"
/* 2223 */ "no-load-opts\0"
/* 2236 */ "no\0"
/* 2239 */ "NTP_KEYGEN\0"
-/* 2250 */ "ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.8p11\n"
+/* 2250 */ "ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.8p12\n"
"Usage: %s [ -<flag> [<val>] | --<name>[{=| }<val>] ]...\n\0"
/* 2365 */ "$HOME\0"
/* 2371 */ ".\0"
/* 2373 */ ".ntprc\0"
/* 2380 */ "http://bugs.ntp.org, bugs@ntp.org\0"
/* 2414 */ "\n\0"
-/* 2416 */ "ntp-keygen (ntp) 4.2.8p11";
+/* 2416 */ "ntp-keygen (ntp) 4.2.8p12";
/**
* imbits option description:
translate option names.
*/
/* referenced via ntp_keygenOptions.pzCopyright */
- puts(_("ntp-keygen (ntp) 4.2.8p11\n\
+ puts(_("ntp-keygen (ntp) 4.2.8p12\n\
Copyright (C) 1992-2017 The University of Delaware and Network Time Foundation, 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.8p11\n\
+ puts(_("ntp-keygen (ntp) - Create a NTP host key - Ver. 4.2.8p12\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.8p11"));
+ puts(_("ntp-keygen (ntp) 4.2.8p12"));
/* referenced via ntp_keygenOptions.pzFullUsage */
puts(_("<<<NOT-FOUND>>>"));
/*
* EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.h)
*
- * It has been AutoGen-ed July 24, 2018 at 07:23:53 AM by AutoGen 5.18.5
+ * It has been AutoGen-ed August 14, 2018 at 08:30:20 AM by AutoGen 5.18.5
* From the definitions ntp-keygen-opts.def
* and the template file options
*
/** count of all options for ntp-keygen */
#define OPTION_CT 26
/** ntp-keygen version */
-#define NTP_KEYGEN_VERSION "4.2.8p11"
+#define NTP_KEYGEN_VERSION "4.2.8p12"
/** Full ntp-keygen version text */
-#define NTP_KEYGEN_FULL_VERSION "ntp-keygen (ntp) 4.2.8p11"
+#define NTP_KEYGEN_FULL_VERSION "ntp-keygen (ntp) 4.2.8p12"
/**
* Interface defines for all options. Replace "n" with the UPPER_CASED
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntp-keygen 1ntp-keygenman "24 Jul 2018" "ntp (4.2.8p11)" "User Commands"
+.TH ntp-keygen 1ntp-keygenman "14 Aug 2018" "ntp (4.2.8p12)" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (in-mem file)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-VYaG.G/ag-7Yay9G)
.\"
-.\" It has been AutoGen-ed July 24, 2018 at 07:24:02 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:30:31 AM by AutoGen 5.18.5
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd July 24 2018
+.Dd August 14 2018
.Dt NTP_KEYGEN 1ntp-keygenmdoc User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.mdoc)
.\"
-.\" It has been AutoGen-ed July 24, 2018 at 07:23:59 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:30:38 AM by AutoGen 5.18.5
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
<title>Ntp-keygen User's Manual</title>
<meta http-equiv="Content-Type" content="text/html">
<meta name="description" content="Ntp-keygen User's Manual">
-<meta name="generator" content="makeinfo 4.13">
+<meta name="generator" content="makeinfo 4.7">
<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.sansserif { font-family:sans-serif; font-weight:normal; }
+ span.sc { font-variant:small-caps }
+ span.roman { font-family: serif; font-weight: normal; }
--></style>
</head>
<body>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
-
+
<a name="Top"></a>Up: <a rel="up" accesskey="u" href="#dir">(dir)</a>
+<br>
</div>
<h2 class="unnumbered">Top</h2>
</ul>
<div class="node">
-<a name="Top"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Description">Description</a>,
+
<a name="Top"></a>Next: <a rel="next" accesskey="n" href="#Description">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">NTP Key Generation Program User Manual</h2>
printable ASCII format so they can be embedded as MIME attachments in
mail to other sites.
- <p>This document applies to version 4.2.8p11 of <code>ntp-keygen</code>.
+ <p>This document applies to version 4.2.8p12 of <code>ntp-keygen</code>.
<div class="node">
-<a name="Description"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Running-the-Program">Running the Program</a>,
+
<a name="Description"></a>Next: <a rel="next" accesskey="n" href="#Running-the-Program">Running the Program</a>,
Previous: <a rel="previous" accesskey="p" href="#Top">Top</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
as described in the <a href="#Cryptographic-Data-Files">Cryptographic Data Files</a> section below.
<div class="node">
-<a name="Running-the-Program"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Random-Seed-File">Random Seed File</a>,
+
<a name="Running-the-Program"></a>Next: <a rel="next" accesskey="n" href="#Random-Seed-File">Random Seed File</a>,
Previous: <a rel="previous" accesskey="p" href="#Description">Description</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
Autokey Public-Key Authentication page.
<div class="node">
-<a name="ntp-keygen-Invocation"></a>
-<a name="ntp_002dkeygen-Invocation"></a>
<p><hr>
-
-
+<a name="ntp_002dkeygen-Invocation"></a>
+<br>
</div>
<h3 class="section">Invoking ntp-keygen</h3>
used only by that host, although exceptions exist as noted later on
this page.
The symmetric keys file, normally called
-<samp><span class="file">ntp.keys</span></samp>,
+<span class="file">ntp.keys</span>,
is usually installed in
-<samp><span class="file">/etc</span></samp>.
+<span class="file">/etc</span>.
Other files and links are usually installed in
-<samp><span class="file">/usr/local/etc</span></samp>,
+<span class="file">/usr/local/etc</span>,
which is normally in a shared filesystem in
NFS-mounted networks and cannot be changed by shared clients.
In these cases, NFS clients can specify the files in another
directory such as
-<samp><span class="file">/etc</span></samp>
+<span class="file">/etc</span>
using the
<code>keysdir</code>
<code>ntpd(1ntpdmdoc)</code>
<p>This program directs commentary and error messages to the standard
error stream
-<samp><span class="file">stderr</span></samp>
+<span class="file">stderr</span>
and remote files to the standard output stream
-<samp><span class="file">stdout</span></samp>
+<span class="file">stdout</span>
where they can be piped to other applications or redirected to files.
The names used for generated files and links all begin with the
string
-<samp><span class="file">ntpkey*</span></samp>
+<span class="file">ntpkey*</span>
and include the file type, generating host and filestamp,
as described in the
<a href="#Cryptographic-Data-Files">Cryptographic Data Files</a>
The recommended procedure is change to the
<kbd>keys</kbd>
directory, usually
-<samp><span class="file">/usr/local/etc</span></samp>,
+<span class="file">/usr/local/etc</span>,
then run the program.
<p>To test and gain experience with Autokey concepts, log in as root and
change to the
<kbd>keys</kbd>
directory, usually
-<samp><span class="file">/usr/local/etc</span></samp>.
+<span class="file">/usr/local/etc</span>.
When run for the first time, or if all files with names beginning with
-<samp><span class="file">ntpkey*</span></samp>
+<span class="file">ntpkey*</span>
have been removed, use the
<code>ntp-keygen</code>
command without arguments to generate a default
command
to assume root may not work properly, since by default the OpenSSL library
looks for the random seed file
-<samp><span class="file">.rnd</span></samp>
+<span class="file">.rnd</span>
in the user home directory.
However, there should be only one
-<samp><span class="file">.rnd</span></samp>,
+<span class="file">.rnd</span>,
most conveniently
in the root directory, so it is convenient to define the
.Ev RANDFILE
environment variable used by the OpenSSL library as the path to
-<samp><span class="file">.rnd</span></samp>.
+<span class="file">.rnd</span>.
<p>Installing the keys as root might not work in NFS-mounted
shared file systems, as NFS clients may not be able to write
to the shared keys directory, even as root.
In this case, NFS clients can specify the files in another
directory such as
-<samp><span class="file">/etc</span></samp>
+<span class="file">/etc</span>
using the
<code>keysdir</code>
<code>ntpd(1ntpdmdoc)</code>
while the trusted name is used for the identity files.
<p>All files are installed by default in the keys directory
-<samp><span class="file">/usr/local/etc</span></samp>,
+<span class="file">/usr/local/etc</span>,
which is normally in a shared filesystem
in NFS-mounted networks.
The actual location of the keys directory
certificate should be re-generated.
<p>Additional information on trusted groups and identity schemes is on the
-“Autokey Public-Key Authentication”
+Autokey Public-Key Authentication
page.
<p>File names begin with the prefix
-<samp><span class="file">ntpkey</span></samp>_
+<span class="file">ntpkey</span>_
and end with the suffix
-<samp><span class="file">_</span></samp><kbd>hostname</kbd>. <kbd>filestamp</kbd>,
+<span class="file">_</span><kbd>hostname</kbd>. <kbd>filestamp</kbd>,
where
<kbd>hostname</kbd>
is the owner name, usually the string returned
This both guarantees uniqueness and simplifies maintenance
procedures, since all files can be quickly removed
by a
-<code>rm</code> <samp><span class="file">ntpkey*</span></samp>
+<code>rm</code> <span class="file">ntpkey*</span>
command or all files generated
at a specific time can be removed by a
-<code>rm</code> <samp><span class="file">*</span></samp><kbd>filestamp</kbd>
+<code>rm</code> <span class="file">*</span><kbd>filestamp</kbd>
command.
To further reduce the risk of misconfiguration,
the first two lines of a file contain the file name
<p>On each trusted host as root, change to the keys directory.
To insure a fresh fileset, remove all
-<samp><span class="file">ntpkey</span></samp>
+<span class="file">ntpkey</span>
files.
Then run
<code>ntp-keygen</code>
<code>-P</code>
<code>-p</code> <kbd>password</kbd>
to generate the host key file
-<samp><span class="file">ntpkey</span></samp>_ <code>RSA</code> <samp><span class="file">key_alice.</span></samp> <kbd>filestamp</kbd>
+<span class="file">ntpkey</span>_ <code>RSA</code> <span class="file">key_alice.</span> <kbd>filestamp</kbd>
and trusted private certificate file
-<samp><span class="file">ntpkey</span></samp>_ <code>RSA-MD5</code> <code>_</code> <samp><span class="file">cert_alice.</span></samp> <kbd>filestamp</kbd>,
+<span class="file">ntpkey</span>_ <code>RSA-MD5</code> <code>_</code> <span class="file">cert_alice.</span> <kbd>filestamp</kbd>,
and soft links.
Copy both files to all group hosts;
they replace the files which would be generated in other schemes.
On each host
<kbd>bob</kbd>
install a soft link from the generic name
-<samp><span class="file">ntpkey_host_</span></samp><kbd>bob</kbd>
+<span class="file">ntpkey_host_</span><kbd>bob</kbd>
to the host key file and soft link
-<samp><span class="file">ntpkey_cert_</span></samp><kbd>bob</kbd>
+<span class="file">ntpkey_cert_</span><kbd>bob</kbd>
to the private certificate file.
Note the generic links are on bob, but point to files generated
by trusted host alice.
<code>-I</code>
<code>-p</code> <kbd>password</kbd>
to produce her parameter file
-<samp><span class="file">ntpkey_IFFpar_alice.</span></samp><kbd>filestamp</kbd>,
+<span class="file">ntpkey_IFFpar_alice.</span><kbd>filestamp</kbd>,
which includes both server and client keys.
Copy this file to all group hosts that operate as both servers
and clients and install a soft link from the generic
-<samp><span class="file">ntpkey_iff_alice</span></samp>
+<span class="file">ntpkey_iff_alice</span>
to this file.
If there are no hosts restricted to operate only as clients,
there is nothing further to do.
and pipe the output to a file or email program.
Copy or email this file to all restricted clients.
On these clients install a soft link from the generic
-<samp><span class="file">ntpkey_iff_alice</span></samp>
+<span class="file">ntpkey_iff_alice</span>
to this file.
To further protect the integrity of the keys,
each file can be encrypted with a secret password.
<code>-G</code>
<code>-p</code> <kbd>password</kbd>
to produce her parameter file
-<samp><span class="file">ntpkey_GQpar_alice.</span></samp><kbd>filestamp</kbd>,
+<span class="file">ntpkey_GQpar_alice.</span><kbd>filestamp</kbd>,
which includes both server and client keys.
Copy this file to all group hosts and install a soft link
from the generic
-<samp><span class="file">ntpkey_gq_alice</span></samp>
+<span class="file">ntpkey_gq_alice</span>
to this file.
In addition, on each host
<kbd>bob</kbd>
install a soft link
from generic
-<samp><span class="file">ntpkey_gq_</span></samp><kbd>bob</kbd>
+<span class="file">ntpkey_gq_</span><kbd>bob</kbd>
to this file.
As the
<code>GQ</code>
<kbd>n</kbd>
is the number of revokable keys (typically 5) to produce
the parameter file
-<samp><span class="file">ntpkeys_MVpar_trish.</span></samp><kbd>filestamp</kbd>
+<span class="file">ntpkeys_MVpar_trish.</span><kbd>filestamp</kbd>
and client key files
-<samp><span class="file">ntpkeys_MVkey</span></samp><kbd>d</kbd> <kbd>_</kbd> <samp><span class="file">trish.</span></samp> <kbd>filestamp</kbd>
+<span class="file">ntpkeys_MVkey</span><kbd>d</kbd> <kbd>_</kbd> <span class="file">trish.</span> <kbd>filestamp</kbd>
where
<kbd>d</kbd>
is the key number (0 <
<kbd>n</kbd>).
Copy the parameter file to alice and install a soft link
from the generic
-<samp><span class="file">ntpkey_mv_alice</span></samp>
+<span class="file">ntpkey_mv_alice</span>
to this file.
Copy one of the client key files to alice for later distribution
to her clients.
since they all work the same way.
Alice copies the client key file to all of her clients.
On client bob install a soft link from generic
-<samp><span class="file">ntpkey_mvkey_bob</span></samp>
+<span class="file">ntpkey_mvkey_bob</span>
to the client key file.
As the
<code>MV</code>
<kbd>IFFkey</kbd> <kbd>or</kbd> <kbd>GQkey</kbd>
client keys file previously specified
as unencrypted data to the standard output stream
-<samp><span class="file">stdout</span></samp>.
+<span class="file">stdout</span>.
This is intended for automatic key distribution by email.
<br><dt><code>-G</code> <code>--gq-params</code><dd>Generate a new encrypted
<code>GQ</code>
or
<code>-s</code>
following an
-‘@’
+@
character, is also used in certificate subject and issuer names in the form
<kbd>host</kbd> <kbd>@</kbd> <kbd>group</kbd>
and should match the group specified via
<br><dt><code>-q</code> <code>--export-passwd</code>= <kbd>passwd</kbd><dd>Set the password for writing encrypted
<code>IFF</code>, <code>GQ</code> <code>and</code> <code>MV</code>
identity files redirected to
-<samp><span class="file">stdout</span></samp>
+<span class="file">stdout</span>
to
<kbd>passwd</kbd>.
In effect, these files are decrypted with the
<p>The entropy seed used by the OpenSSL library is contained in a file,
usually called
-<samp><span class="file">.rnd</span></samp>,
+<span class="file">.rnd</span>,
which must be available when starting the NTP daemon
or the
<code>ntp-keygen</code>
.Ev RANDFILE
environment variable is not present,
the library will look for the
-<samp><span class="file">.rnd</span></samp>
+<span class="file">.rnd</span>
file in the user home directory.
Since both the
<code>ntp-keygen</code>
program and
<code>ntpd(1ntpdmdoc)</code>
daemon must run as root, the logical place to put this file is in
-<samp><span class="file">/.rnd</span></samp>
+<span class="file">/.rnd</span>
or
-<samp><span class="file">/root/.rnd</span></samp>.
+<span class="file">/root/.rnd</span>.
If the file is not available or cannot be written,
the daemon exits with a message to the system log and the program
exits with a suitable error message.
<p>All file formats begin with two nonencrypted lines.
The first line contains the file name, including the generated host name
and filestamp, in the format
-<samp><span class="file">ntpkey_</span></samp><kbd>key</kbd> <kbd>_</kbd> <kbd>name</kbd>. <kbd>filestamp</kbd>,
+<span class="file">ntpkey_</span><kbd>key</kbd> <kbd>_</kbd> <kbd>name</kbd>. <kbd>filestamp</kbd>,
where
<kbd>key</kbd>
is the key or parameter type,
names in generated link names include only lower case characters.
The filestamp is not used in generated link names.
The second line contains the datestamp in conventional Unix
-<samp><span class="file">date</span></samp>
+<span class="file">date</span>
format.
Lines beginning with
-‘#’
+#
are considered comments and ignored by the
<code>ntp-keygen</code>
program and
printable ASCII text, preceded and followed by MIME content identifier lines.
<p>The format of the symmetric keys file, ordinarily named
-<samp><span class="file">ntp.keys</span></samp>,
+<span class="file">ntp.keys</span>,
is somewhat different than the other files in the interest of backward compatibility.
Ordinarily, the file is generated by this program, but it can be constructed
and edited using an ordinary text editor.
-<pre class="verbatim"># ntpkey_MD5key_bk.ntp.org.3595864945
+<pre class="verbatim">
+# ntpkey_MD5key_bk.ntp.org.3595864945
# Thu Dec 12 19:22:25 2013
1 MD5 L";Nw<\`.I<f4U0)247"i # MD5 key
which is a printable ASCII string 20 characters or less in length:
each character is chosen from the 93 printable characters
in the range 0x21 through 0x7e (
-‘’!
+!
through
-‘~’
+~
) excluding space and the
-‘#’
+#
character, and terminated by whitespace or a
-‘#’
+#
character.
An OpenSSL key consists of a hex-encoded ASCII string of 40 characters, which
is truncated as necessary.
<p>The
<code>ntp-keygen</code>
program generates a symmetric keys file
-<samp><span class="file">ntpkey_MD5key_</span></samp><kbd>hostname</kbd>. <kbd>filestamp</kbd>.
+<span class="file">ntpkey_MD5key_</span><kbd>hostname</kbd>. <kbd>filestamp</kbd>.
Since the file contains private shared keys,
it should be visible only to root and distributed by secure means
to other subnet hosts.
The NTP daemon loads the file
-<samp><span class="file">ntp.keys</span></samp>,
+<span class="file">ntp.keys</span>,
so
<code>ntp-keygen</code>
installs a soft link from this name to the generated file.
This software is released under the NTP license, <http://ntp.org/license>.
<ul class="menu">
-<li><a accesskey="1" href="#ntp_002dkeygen-usage">ntp-keygen usage</a>: ntp-keygen help/usage (<samp><span class="option">--help</span></samp>)
+<li><a accesskey="1" href="#ntp_002dkeygen-usage">ntp-keygen usage</a>: ntp-keygen help/usage (<span class="option">--help</span>)
<li><a accesskey="2" href="#ntp_002dkeygen-imbits">ntp-keygen imbits</a>: imbits option (-b)
<li><a accesskey="3" href="#ntp_002dkeygen-certificate">ntp-keygen certificate</a>: certificate option (-c)
<li><a accesskey="4" href="#ntp_002dkeygen-cipher">ntp-keygen cipher</a>: cipher option (-C)
</ul>
<div class="node">
-<a name="ntp-keygen-usage"></a>
-<a name="ntp_002dkeygen-usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-imbits">ntp-keygen imbits</a>,
+
<a name="ntp_002dkeygen-usage"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-imbits">ntp-keygen imbits</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
-<h4 class="subsection">ntp-keygen help/usage (<samp><span class="option">--help</span></samp>)</h4>
+<h4 class="subsection">ntp-keygen help/usage (<span class="option">--help</span>)</h4>
<p><a name="index-ntp_002dkeygen-help-3"></a>
This is the automatically generated usage text for ntp-keygen.
<p>The text printed is the same whether selected with the <code>help</code> option
-(<samp><span class="option">--help</span></samp>) or the <code>more-help</code> option (<samp><span class="option">--more-help</span></samp>). <code>more-help</code> will print
+(<span class="option">--help</span>) or the <code>more-help</code> option (<span class="option">--more-help</span>). <code>more-help</code> will print
the usage text by passing it through a pager program.
<code>more-help</code> is disabled on platforms without a working
<code>fork(2)</code> function. The <code>PAGER</code> environment variable is
-used to select the program, defaulting to <samp><span class="file">more</span></samp>. Both will exit
+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.8p11
Please send bug reports to: <http://bugs.ntp.org, bugs@ntp.org>
</pre>
<div class="node">
-<a name="ntp-keygen-imbits"></a>
-<a name="ntp_002dkeygen-imbits"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-certificate">ntp-keygen certificate</a>,
+
<a name="ntp_002dkeygen-imbits"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-certificate">ntp-keygen certificate</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-usage">ntp-keygen usage</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">imbits option (-b)</h4>
<p><a name="index-ntp_002dkeygen_002dimbits-4"></a>
This is the “identity modulus bits” option.
-This option takes a number argument <samp><span class="file">imbits</span></samp>.
+This option takes a number argument <span class="file">imbits</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
<p>The number of bits in the identity modulus. The default is 256.
<div class="node">
-<a name="ntp-keygen-certificate"></a>
-<a name="ntp_002dkeygen-certificate"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-cipher">ntp-keygen cipher</a>,
+
<a name="ntp_002dkeygen-certificate"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-cipher">ntp-keygen cipher</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-imbits">ntp-keygen imbits</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">certificate option (-c)</h4>
<p><a name="index-ntp_002dkeygen_002dcertificate-5"></a>
This is the “certificate scheme” option.
-This option takes a string argument <samp><span class="file">scheme</span></samp>.
+This option takes a string argument <span class="file">scheme</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
schemes must be used with a DSA sign key. The default without
this option is RSA-MD5.
<div class="node">
-<a name="ntp-keygen-cipher"></a>
-<a name="ntp_002dkeygen-cipher"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-id_002dkey">ntp-keygen id-key</a>,
+
<a name="ntp_002dkeygen-cipher"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-id_002dkey">ntp-keygen id-key</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-certificate">ntp-keygen certificate</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">cipher option (-C)</h4>
<p><a name="index-ntp_002dkeygen_002dcipher-6"></a>
This is the “privatekey cipher” option.
-This option takes a string argument <samp><span class="file">cipher</span></samp>.
+This option takes a string argument <span class="file">cipher</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
equivalent to "<code>-C des-ede3-cbc</code>". The openssl tool lists ciphers
available in "<code>openssl -h</code>" output.
<div class="node">
-<a name="ntp-keygen-id-key"></a>
-<a name="ntp_002dkeygen-id_002dkey"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-gq_002dparams">ntp-keygen gq-params</a>,
+
<a name="ntp_002dkeygen-id_002dkey"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-gq_002dparams">ntp-keygen gq-params</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-cipher">ntp-keygen cipher</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">id-key option (-e)</h4>
the standard output.
This is intended for automatic key distribution by email.
<div class="node">
-<a name="ntp-keygen-gq-params"></a>
-<a name="ntp_002dkeygen-gq_002dparams"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-host_002dkey">ntp-keygen host-key</a>,
+
<a name="ntp_002dkeygen-gq_002dparams"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-host_002dkey">ntp-keygen host-key</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-id_002dkey">ntp-keygen id-key</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">gq-params option (-G)</h4>
<p>Generate parameters and keys for the GQ identification scheme,
obsoleting any that may exist.
<div class="node">
-<a name="ntp-keygen-host-key"></a>
-<a name="ntp_002dkeygen-host_002dkey"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-iffkey">ntp-keygen iffkey</a>,
+
<a name="ntp_002dkeygen-host_002dkey"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-iffkey">ntp-keygen iffkey</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-gq_002dparams">ntp-keygen gq-params</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">host-key option (-H)</h4>
<p>Generate new host keys, obsoleting any that may exist.
<div class="node">
-<a name="ntp-keygen-iffkey"></a>
-<a name="ntp_002dkeygen-iffkey"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-ident">ntp-keygen ident</a>,
+
<a name="ntp_002dkeygen-iffkey"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-ident">ntp-keygen ident</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-host_002dkey">ntp-keygen host-key</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">iffkey option (-I)</h4>
<p>Generate parameters for the IFF identification scheme, obsoleting
any that may exist.
<div class="node">
-<a name="ntp-keygen-ident"></a>
-<a name="ntp_002dkeygen-ident"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-lifetime">ntp-keygen lifetime</a>,
+
<a name="ntp_002dkeygen-ident"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-lifetime">ntp-keygen lifetime</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-iffkey">ntp-keygen iffkey</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ident option (-i)</h4>
<p><a name="index-ntp_002dkeygen_002dident-11"></a>
This is the “set autokey group name” option.
-This option takes a string argument <samp><span class="file">group</span></samp>.
+This option takes a string argument <span class="file">group</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
'<code>crypto ident</code>' or '<code>server ident</code>' configuration in the
<code>ntpd</code> configuration file.
<div class="node">
-<a name="ntp-keygen-lifetime"></a>
-<a name="ntp_002dkeygen-lifetime"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-modulus">ntp-keygen modulus</a>,
+
<a name="ntp_002dkeygen-lifetime"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-modulus">ntp-keygen modulus</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-ident">ntp-keygen ident</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">lifetime option (-l)</h4>
<p><a name="index-ntp_002dkeygen_002dlifetime-12"></a>
This is the “set certificate lifetime” option.
-This option takes a number argument <samp><span class="file">lifetime</span></samp>.
+This option takes a number argument <span class="file">lifetime</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
<p>Set the certificate expiration to lifetime days from now.
<div class="node">
-<a name="ntp-keygen-modulus"></a>
-<a name="ntp_002dkeygen-modulus"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-md5key">ntp-keygen md5key</a>,
+
<a name="ntp_002dkeygen-modulus"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-md5key">ntp-keygen md5key</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-lifetime">ntp-keygen lifetime</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">modulus option (-m)</h4>
<p><a name="index-ntp_002dkeygen_002dmodulus-13"></a>
This is the “prime modulus” option.
-This option takes a number argument <samp><span class="file">modulus</span></samp>.
+This option takes a number argument <span class="file">modulus</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
<p>The number of bits in the prime modulus. The default is 512.
<div class="node">
-<a name="ntp-keygen-md5key"></a>
-<a name="ntp_002dkeygen-md5key"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-pvt_002dcert">ntp-keygen pvt-cert</a>,
+
<a name="ntp_002dkeygen-md5key"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-pvt_002dcert">ntp-keygen pvt-cert</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-modulus">ntp-keygen modulus</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">md5key option (-M)</h4>
This is the “generate symmetric keys” option.
Generate symmetric keys, obsoleting any that may exist.
<div class="node">
-<a name="ntp-keygen-pvt-cert"></a>
-<a name="ntp_002dkeygen-pvt_002dcert"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-password">ntp-keygen password</a>,
+
<a name="ntp_002dkeygen-pvt_002dcert"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-password">ntp-keygen password</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-md5key">ntp-keygen md5key</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">pvt-cert option (-P)</h4>
<p>Generate a private certificate. By default, the program generates
public certificates.
<div class="node">
-<a name="ntp-keygen-password"></a>
-<a name="ntp_002dkeygen-password"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-export_002dpasswd">ntp-keygen export-passwd</a>,
+
<a name="ntp_002dkeygen-password"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-export_002dpasswd">ntp-keygen export-passwd</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-pvt_002dcert">ntp-keygen pvt-cert</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">password option (-p)</h4>
<p><a name="index-ntp_002dkeygen_002dpassword-16"></a>
This is the “local private password” option.
-This option takes a string argument <samp><span class="file">passwd</span></samp>.
+This option takes a string argument <span class="file">passwd</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
configuration command. The default password is the local
hostname.
<div class="node">
-<a name="ntp-keygen-export-passwd"></a>
-<a name="ntp_002dkeygen-export_002dpasswd"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-subject_002dname">ntp-keygen subject-name</a>,
+
<a name="ntp_002dkeygen-export_002dpasswd"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-subject_002dname">ntp-keygen subject-name</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-password">ntp-keygen password</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">export-passwd option (-q)</h4>
<p><a name="index-ntp_002dkeygen_002dexport_002dpasswd-17"></a>
This is the “export iff or gq group keys with password” option.
-This option takes a string argument <samp><span class="file">passwd</span></samp>.
+This option takes a string argument <span class="file">passwd</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
"crypto pw password" configuration command. See also the option
–id-key (-e) for unencrypted exports.
<div class="node">
-<a name="ntp-keygen-subject-name"></a>
-<a name="ntp_002dkeygen-subject_002dname"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-sign_002dkey">ntp-keygen sign-key</a>,
+
<a name="ntp_002dkeygen-subject_002dname"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-sign_002dkey">ntp-keygen sign-key</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-export_002dpasswd">ntp-keygen export-passwd</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">subject-name option (-s)</h4>
<p><a name="index-ntp_002dkeygen_002dsubject_002dname-18"></a>
This is the “set host and optionally group name” option.
-This option takes a string argument <samp><span class="file">host@group</span></samp>.
+This option takes a string argument <span class="file">host@group</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
if not provided, the host name are also used in the file names
of IFF, GQ, and MV client parameter files.
<div class="node">
-<a name="ntp-keygen-sign-key"></a>
-<a name="ntp_002dkeygen-sign_002dkey"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-trusted_002dcert">ntp-keygen trusted-cert</a>,
+
<a name="ntp_002dkeygen-sign_002dkey"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-trusted_002dcert">ntp-keygen trusted-cert</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-subject_002dname">ntp-keygen subject-name</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">sign-key option (-S)</h4>
<p><a name="index-ntp_002dkeygen_002dsign_002dkey-19"></a>
This is the “generate sign key (rsa or dsa)” option.
-This option takes a string argument <samp><span class="file">sign</span></samp>.
+This option takes a string argument <span class="file">sign</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
that may exist. By default, the program uses the host key as the
sign key.
<div class="node">
-<a name="ntp-keygen-trusted-cert"></a>
-<a name="ntp_002dkeygen-trusted_002dcert"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-mv_002dparams">ntp-keygen mv-params</a>,
+
<a name="ntp_002dkeygen-trusted_002dcert"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-mv_002dparams">ntp-keygen mv-params</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-sign_002dkey">ntp-keygen sign-key</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">trusted-cert option (-T)</h4>
<p>Generate a trusted certificate. By default, the program generates
a non-trusted certificate.
<div class="node">
-<a name="ntp-keygen-mv-params"></a>
-<a name="ntp_002dkeygen-mv_002dparams"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-mv_002dkeys">ntp-keygen mv-keys</a>,
+
<a name="ntp_002dkeygen-mv_002dparams"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-mv_002dkeys">ntp-keygen mv-keys</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-trusted_002dcert">ntp-keygen trusted-cert</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">mv-params option (-V)</h4>
<p><a name="index-ntp_002dkeygen_002dmv_002dparams-21"></a>
This is the “generate <num> mv parameters” option.
-This option takes a number argument <samp><span class="file">num</span></samp>.
+This option takes a number argument <span class="file">num</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
<p>Generate parameters and keys for the Mu-Varadharajan (MV)
identification scheme.
<div class="node">
-<a name="ntp-keygen-mv-keys"></a>
-<a name="ntp_002dkeygen-mv_002dkeys"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-config">ntp-keygen config</a>,
+
<a name="ntp_002dkeygen-mv_002dkeys"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-config">ntp-keygen config</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-mv_002dparams">ntp-keygen mv-params</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">mv-keys option (-v)</h4>
<p><a name="index-ntp_002dkeygen_002dmv_002dkeys-22"></a>
This is the “update <num> mv keys” option.
-This option takes a number argument <samp><span class="file">num</span></samp>.
+This option takes a number argument <span class="file">num</span>.
<p class="noindent">This option has some usage constraints. It:
<ul>
<li>must be compiled in by defining <code>AUTOKEY</code> during the compilation.
</ul>
- <p>This option has no ‘<samp><span class="samp">doc</span></samp>’ documentation.
+ <p>This option has no <span class="samp">doc</span> documentation.
<div class="node">
-<a name="ntp-keygen-config"></a>
-<a name="ntp_002dkeygen-config"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-exit-status">ntp-keygen exit status</a>,
+
<a name="ntp_002dkeygen-config"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-exit-status">ntp-keygen exit status</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-mv_002dkeys">ntp-keygen mv-keys</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">presetting/configuring ntp-keygen</h4>
<li>$PWD
</ul>
The environment variables <code>HOME</code>, and <code>PWD</code>
-are expanded and replaced when <samp><span class="file">ntp-keygen</span></samp> runs.
+are expanded and replaced when <span class="file">ntp-keygen</span> runs.
For any of these that are plain files, they are simply processed.
-For any that are directories, then a file named <samp><span class="file">.ntprc</span></samp> is searched for
+For any that are directories, then a file named <span class="file">.ntprc</span> is searched for
within that directory and processed.
<p>Configuration files may be in a wide variety of formats.
Only the first letter of the argument is examined:
<dl>
-<dt>‘<samp><span class="samp">version</span></samp>’<dd>Only print the version. This is the default.
-<br><dt>‘<samp><span class="samp">copyright</span></samp>’<dd>Name the copyright usage licensing terms.
-<br><dt>‘<samp><span class="samp">verbose</span></samp>’<dd>Print the full copyright usage licensing terms.
+<dt><span class="samp">version</span><dd>Only print the version. This is the default.
+<br><dt><span class="samp">copyright</span><dd>Name the copyright usage licensing terms.
+<br><dt><span class="samp">verbose</span><dd>Print the full copyright usage licensing terms.
</dl>
<div class="node">
-<a name="ntp-keygen-exit-status"></a>
-<a name="ntp_002dkeygen-exit-status"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-Usage">ntp-keygen Usage</a>,
+
<a name="ntp_002dkeygen-exit-status"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-Usage">ntp-keygen Usage</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-config">ntp-keygen config</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntp-keygen exit status</h4>
<p>One of the following exit values will be returned:
<dl>
-<dt>‘<samp><span class="samp">0 (EXIT_SUCCESS)</span></samp>’<dd>Successful program execution.
-<br><dt>‘<samp><span class="samp">1 (EXIT_FAILURE)</span></samp>’<dd>The operation failed or the command syntax was not valid.
-<br><dt>‘<samp><span class="samp">66 (EX_NOINPUT)</span></samp>’<dd>A specified configuration file could not be loaded.
-<br><dt>‘<samp><span class="samp">70 (EX_SOFTWARE)</span></samp>’<dd>libopts had an internal operational error. Please report
+<dt><span class="samp">0 (EXIT_SUCCESS)</span><dd>Successful program execution.
+<br><dt><span class="samp">1 (EXIT_FAILURE)</span><dd>The operation failed or the command syntax was not valid.
+<br><dt><span class="samp">66 (EX_NOINPUT)</span><dd>A specified configuration file could not be loaded.
+<br><dt><span class="samp">70 (EX_SOFTWARE)</span><dd>libopts had an internal operational error. Please report
it to autogen-users@lists.sourceforge.net. Thank you.
</dl>
<div class="node">
-<a name="ntp-keygen-Usage"></a>
-<a name="ntp_002dkeygen-Usage"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-Notes">ntp-keygen Notes</a>,
+
<a name="ntp_002dkeygen-Usage"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-Notes">ntp-keygen Notes</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-exit-status">ntp-keygen exit status</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntp-keygen Usage</h4>
<div class="node">
-<a name="ntp-keygen-Notes"></a>
-<a name="ntp_002dkeygen-Notes"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-Bugs">ntp-keygen Bugs</a>,
+
<a name="ntp_002dkeygen-Notes"></a>Next: <a rel="next" accesskey="n" href="#ntp_002dkeygen-Bugs">ntp-keygen Bugs</a>,
Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-Usage">ntp-keygen Usage</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntp-keygen Notes</h4>
<div class="node">
-<a name="ntp-keygen-Bugs"></a>
-<a name="ntp_002dkeygen-Bugs"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-Notes">ntp-keygen Notes</a>,
+
<a name="ntp_002dkeygen-Bugs"></a>Previous: <a rel="previous" accesskey="p" href="#ntp_002dkeygen-Notes">ntp-keygen Notes</a>,
Up: <a rel="up" accesskey="u" href="#ntp_002dkeygen-Invocation">ntp-keygen Invocation</a>
-
+<br>
</div>
<h4 class="subsection">ntp-keygen Bugs</h4>
<div class="node">
-<a name="Random-Seed-File"></a>
<p><hr>
-Next: <a rel="next" accesskey="n" href="#Cryptographic-Data-Files">Cryptographic Data Files</a>,
+
<a name="Random-Seed-File"></a>Next: <a rel="next" accesskey="n" href="#Cryptographic-Data-Files">Cryptographic Data Files</a>,
Previous: <a rel="previous" accesskey="p" href="#Running-the-Program">Running the Program</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
with a message to the system log.
<div class="node">
-<a name="Cryptographic-Data-Files"></a>
<p><hr>
-Previous: <a rel="previous" accesskey="p" href="#Random-Seed-File">Random Seed File</a>,
+
<a name="Cryptographic-Data-Files"></a>Previous: <a rel="previous" accesskey="p" href="#Random-Seed-File">Random Seed File</a>,
Up: <a rel="up" accesskey="u" href="#Top">Top</a>
-
+<br>
</div>
<!-- node-name, next, previous, up -->
.ds B-Font B
.ds I-Font I
.ds R-Font R
-.TH ntp-keygen @NTP_KEYGEN_MS@ "24 Jul 2018" "ntp (4.2.8p11)" "User Commands"
+.TH ntp-keygen @NTP_KEYGEN_MS@ "14 Aug 2018" "ntp (4.2.8p12)" "User Commands"
.\"
-.\" EDIT THIS FILE WITH CAUTION (in-mem file)
+.\" EDIT THIS FILE WITH CAUTION (/tmp/.ag-VYaG.G/ag-7Yay9G)
.\"
-.\" It has been AutoGen-ed July 24, 2018 at 07:24:02 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:30:31 AM by AutoGen 5.18.5
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agman-cmd.tpl
.SH NAME
-.Dd July 24 2018
+.Dd August 14 2018
.Dt NTP_KEYGEN @NTP_KEYGEN_MS@ User Commands
.Os
.\" EDIT THIS FILE WITH CAUTION (ntp-keygen-opts.mdoc)
.\"
-.\" It has been AutoGen-ed July 24, 2018 at 07:23:59 AM by AutoGen 5.18.5
+.\" It has been AutoGen-ed August 14, 2018 at 08:30:38 AM by AutoGen 5.18.5
.\" From the definitions ntp-keygen-opts.def
.\" and the template file agmdoc-cmd.tpl
.Sh NAME
projects / thirdparty / ntp.git / commitdiff
